@spec create_processor_token(
  PlaidEx.Config.t(),
  String.t(),
  String.t(),
  String.t(),
  keyword()
) ::
  {:ok, %{processor_token: String.t()}} | {:error, PlaidEx.Error.t()}

Creates a processor token for a partner processor (Dwolla, Stripe, etc.).

@spec create_public_token(PlaidEx.Config.t(), String.t(), keyword()) ::
  {:ok, %{public_token: String.t()}} | {:error, PlaidEx.Error.t()}

Creates a public token from an access token (for reinitializing Link in update mode).

@spec exchange_public_token(PlaidEx.Config.t(), String.t(), keyword()) ::
  {:ok, PlaidEx.Schemas.AccessToken.t()} | {:error, PlaidEx.Error.t()}

Exchanges a Link public_token for an access_token.

The public_token is returned by the Plaid Link SDK after the user successfully completes the Link flow. It is short-lived (30 minutes) and single-use. Exchange it immediately.

Store the returned access_token permanently — it does not expire unless the user revokes access or the item enters error state.

@spec get(PlaidEx.Config.t(), String.t(), keyword()) ::
  {:ok, %{item: PlaidEx.Schemas.Item.t(), status: map()}}
  | {:error, PlaidEx.Error.t()}

Retrieves metadata about an Item and its available products.

@spec invalidate_access_token(PlaidEx.Config.t(), String.t(), keyword()) ::
  {:ok, %{new_access_token: String.t()}} | {:error, PlaidEx.Error.t()}

Invalidates an access token and returns a new one. Use for token rotation.

@spec remove(PlaidEx.Config.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, PlaidEx.Error.t()}

Removes an Item. Revokes the access token and disconnects all linked accounts.

@spec update_webhook(PlaidEx.Config.t(), String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, PlaidEx.Error.t()}

Updates the webhook URL for an Item.