Returns a specification to start this module under a supervisor.

See Supervisor.

@spec get_capabilities(binary()) :: map() | nil

Get plugin capabilities.

@spec get_capabilities_new(binary()) :: LemonChannels.Capabilities.t() | nil

Get plugin capabilities in the new format.

Returns the parsed capability map — %{capability_type => %Capability{}}, as produced by LemonChannels.Capabilities.from_legacy/1 — or nil if the plugin is not registered. Despite the module name, LemonChannels.Capabilities.t/0 is a map, not a struct.

@spec get_meta(binary()) :: map() | nil

Get plugin metadata.

@spec get_plugin(binary()) :: module() | nil

Get a plugin by ID.

@spec list() :: [{binary(), map()}]

List adapters with metadata for status UIs.

Returns a list of {channel_id, info} tuples.

@spec list_plugins() :: [module()]

List all registered plugins.

@spec logout(binary()) :: :ok | {:error, :not_found} | {:error, term()}

Stop and unregister a channel adapter by channel_id.

@spec register(module()) :: :ok | {:error, term()}

Register a channel plugin.

@spec status() :: %{configured: [binary()], connected: [binary()]}

Summarize configured/connected channel adapters.

@spec supports?(binary(), atom()) :: boolean()

Query if a plugin supports a specific capability.

Examples

Registry.supports?("telegram", :attachments)
# => true

Registry.supports?("xmtp", :rich_blocks)
# => false

@spec supports_feature?(binary(), atom(), atom()) :: boolean()

Query if a plugin supports a specific feature within a capability.

Examples

Registry.supports_feature?("telegram", :rich_blocks, :markdown)
# => true

Registry.supports_feature?("discord", :rich_blocks, :buttons)
# => false

@spec unregister(binary()) :: :ok

Unregister a channel plugin.

@spec validate(binary(), atom(), map()) :: :ok | {:error, term()}

Validates a capability request for a plugin.

Examples

Registry.validate("telegram", :attachments, %{size: 5_000_000, mime_type: "image/png"})
# => :ok

Registry.validate("xmtp", :attachments, %{size: 1_000})
# => {:error, :capability_not_supported}