@spec create(
  map(),
  keyword()
) :: {:ok, map()} | {:error, Marqeta.Error.t()}

Creates a new user transition.

Returns {:ok, map()} on success, {:error, %Marqeta.Error{}} on failure.

@spec create!(
  map(),
  keyword()
) :: map()

Creates a new user transition. Raises Marqeta.Error on failure.

@spec get(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, Marqeta.Error.t()}

Retrieves a user transition by token.

Returns {:ok, map()} on success, {:error, %Marqeta.Error{}} on failure.

@spec get!(
  String.t(),
  keyword()
) :: map()

Retrieves a user transition by token. Raises Marqeta.Error on failure.

@spec list(
  map(),
  keyword()
) :: {:ok, map()} | {:error, Marqeta.Error.t()}

Lists user transition resources.

Accepts standard Marqeta pagination params: count, start_index, sort_by, sort_order, fields.

Use stream/2 to lazily iterate all pages automatically.

@spec list!(
  map(),
  keyword()
) :: map()

Lists user transition resources. Raises Marqeta.Error on failure.

@spec list_by_user(String.t(), map(), keyword()) ::
  {:ok, map()} | {:error, Marqeta.Error.t()}

Lists all state transitions for a user.

@spec stream(
  map(),
  keyword()
) :: Enumerable.t()

Returns a lazy Stream that auto-paginates user transition resources.