# `Pluggy.Connect.Kino`
[🔗](https://github.com/fellipessanha/pluggy_ai_ex/blob/main/lib/pluggy/connect/kino.ex#L2)

Pluggy Connect widget for Livebook using `Kino.JS.Live`.

Renders the Pluggy Connect widget inline in a Livebook cell and
pushes the connected item data back to Elixir when the user
completes the connection flow.

## Usage

With a client (generates the connect token automatically):

    {:ok, client} = Pluggy.Client.new("client_id", "client_secret")
    widget = Pluggy.Connect.Kino.new(client, include_sandbox: true)

Or with an existing connect token:

    {:ok, token} = Pluggy.Client.connect_token(client)
    widget = Pluggy.Connect.Kino.new(token, include_sandbox: true)

After the user connects a bank account in the widget:

    item = Pluggy.Connect.Kino.await_item(widget)

Requires the `:kino` dependency.

# `await_item`

Blocks until the user completes the widget connection and returns the item data.

# `new`

Creates a new Pluggy Connect widget.

## Options

  * `:include_sandbox` — show sandbox connectors (default `false`)

## Examples

    widget = Pluggy.Connect.Kino.new(client)
    widget = Pluggy.Connect.Kino.new(client, include_sandbox: true)
    widget = Pluggy.Connect.Kino.new("connect_token_string")

---

*Consult [api-reference.md](api-reference.md) for complete listing*