@spec delete_ingress_subscription(String.t(), String.t(), keyword()) ::
  {:ok, map()} | {:error, term()}

Deletes the Telegram webhook ingress subscription for a messaging bridge.

@spec ensure_ingress_subscription(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, term()}

Ensures Telegram webhook ingress for a messaging bridge.

Telegram supports one webhook per bot token, so the subscription id is deterministic for the bridge and maps to the bot's current webhook.

@spec extension_capabilities() :: map()

Returns Telegram extension capability statuses for features outside core adapter contract.

@spec fetch_media(String.t() | map(), keyword() | map()) ::
  {:ok, binary()} | {:error, term()}

Fetches the bytes behind an inbound media reference.

Accepts a raw Telegram file id, a telegram://file/<file_id> reference, or a normalized media value carrying either form — the telegram:// scheme is minted here, so it is resolved here rather than by the caller.

@spec list_ingress_subscriptions(
  String.t(),
  keyword()
) :: {:ok, [map()]} | {:error, term()}

Lists the Telegram webhook ingress subscription for a messaging bridge.