shardwire 1.0.0 → 1.2.0

package/README.md

@@ -1,25 +1,28 @@
 # Shardwire
 
-Discord events and bot actions, streamed to your app over a single WebSocket bridge.
+[![npm version](https://img.shields.io/npm/v/shardwire)](https://www.npmjs.com/package/shardwire)
+[![npm downloads](https://img.shields.io/npm/dm/shardwire)](https://www.npmjs.com/package/shardwire)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.18-339933)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
-Shardwire runs your bot connection, listens to Discord, and exposes a clean app-facing API for:
+Discord-first bridge for streaming bot events to external apps and executing bot actions over one WebSocket connection.
 
-- subscribing to Discord events
-- replying to interactions
-- sending and editing messages
-- moderation actions like ban, kick, and role changes
+Shardwire is built for a common architecture: your Discord bot runs in one process, while your web app, backend API, worker, or dashboard runs in another.
 
-It is designed for one common setup:
+## Why Shardwire
 
-> your Discord bot lives in one process, while your web app, backend, or worker lives somewhere else
+- **Discord-first API**: no generic command bus wiring required.
+- **App-friendly payloads**: receive normalized JSON payloads instead of live `discord.js` objects.
+- **Built-in actions**: send messages, reply to interactions, moderate members, and more from your app process.
+- **Scoped permissions**: restrict each app secret to specific events and actions.
+- **Capability-aware runtime**: apps can inspect what they are allowed to subscribe to and invoke.
 
-## Why Shardwire
+## Requirements
 
-- **Discord-first**: no generic command bus or event map setup
-- **Token-first**: start the bot bridge with `token`, `intents`, and `server`
-- **App-friendly payloads**: normalized JSON, not live `discord.js` objects
-- **Built-in actions**: call `app.actions.sendMessage(...)`, `app.actions.replyToInteraction(...)`, and more
-- **Scoped secrets**: optionally limit which apps can subscribe to which events or invoke which actions
+- Node.js `>=18.18`
+- A Discord bot token (`DISCORD_TOKEN`)
+- At least one shared bridge secret (`SHARDWIRE_SECRET`)
+- Discord gateway intents that match the events you want
 
 ## Install
 
@@ -29,14 +32,14 @@ npm install shardwire
 
 ## Quick Start
 
-### 1. Start the bot bridge
+### 1) Start the bot bridge process
 
 ```ts
 import { createBotBridge } from "shardwire";
 
 const bridge = createBotBridge({
   token: process.env.DISCORD_TOKEN!,
-  intents: ["Guilds", "GuildMessages", "MessageContent", "GuildMembers"],
+  intents: ["Guilds", "GuildMessages", "GuildMessageReactions", "MessageContent", "GuildMembers"],
   server: {
     port: 3001,
     secrets: [process.env.SHARDWIRE_SECRET!],
@@ -44,9 +47,10 @@ const bridge = createBotBridge({
 });
 
 await bridge.ready();
+console.log("Bot bridge listening on ws://127.0.0.1:3001/shardwire");
 ```
 
-### 2. Connect from your app
+### 2) Connect from your app process
 
 ```ts
 import { connectBotBridge } from "shardwire";
@@ -68,24 +72,12 @@ app.on("messageCreate", ({ message }) => {
 await app.ready();
 ```
 
-### 2.5 Filter subscriptions when you need less noise
-
-```ts
-app.on(
-  "messageCreate",
-  ({ message }) => {
-    console.log("Only channel 123:", message.content);
-  },
-  { channelId: "123456789012345678" },
-);
-```
-
-### 3. Call built-in bot actions
+### 3) Call bot actions from your app
 
 ```ts
 const result = await app.actions.sendMessage({
   channelId: "123456789012345678",
-  content: "Hello from the app side",
+  content: "Hello from app side",
 });
 
 if (!result.ok) {
@@ -93,43 +85,80 @@ if (!result.ok) {
 }
 ```
 
+### 4) Filter subscriptions when needed
+
+```ts
+app.on(
+  "messageCreate",
+  ({ message }) => {
+    console.log("Only this channel:", message.content);
+  },
+  { channelId: "123456789012345678" },
+);
+```
+
 ## Built-In Events
 
-Shardwire currently exposes these bot-side events:
+Apps subscribe to events with `app.on(...)`. The bridge forwards only what each app subscribes to.
 
 - `ready`
 - `interactionCreate`
 - `messageCreate`
 - `messageUpdate`
 - `messageDelete`
+- `messageReactionAdd`
+- `messageReactionRemove`
+- `guildCreate`
+- `guildDelete`
 - `guildMemberAdd`
 - `guildMemberRemove`
+- `guildMemberUpdate`
+- `threadCreate`
+- `threadUpdate`
+- `threadDelete`
 
-Subscriptions are app-driven. The bot bridge does not need per-event setup. Your app subscribes by calling `app.on(...)`, and the host only forwards the events that app is listening to.
-
-Optional filters can narrow delivery by:
+Supported filters:
 
 - `guildId`
 - `channelId`
 - `userId`
-- `commandName` for `interactionCreate`
+- `commandName` (for `interactionCreate`)
+- `customId` (for `interactionCreate`)
+- `interactionKind` (for `interactionCreate`)
+
+### Intent Notes
+
+- `ready` and `interactionCreate`: no specific event intent requirement
+- `messageCreate`, `messageUpdate`, `messageDelete`: `GuildMessages`
+- `messageReactionAdd`, `messageReactionRemove`: `GuildMessageReactions`
+- `guildCreate`, `guildDelete`, `threadCreate`, `threadUpdate`, `threadDelete`: `Guilds`
+- `guildMemberAdd`, `guildMemberRemove`, `guildMemberUpdate`: `GuildMembers`
 
 ## Built-In Actions
 
-`app.actions.*` currently includes:
+`app.actions.*` includes:
 
 - `sendMessage`
 - `editMessage`
 - `deleteMessage`
 - `replyToInteraction`
 - `deferInteraction`
+- `deferUpdateInteraction`
 - `followUpInteraction`
+- `editInteractionReply`
+- `deleteInteractionReply`
+- `updateInteraction`
+- `showModal`
+- `fetchMessage`
+- `fetchMember`
 - `banMember`
 - `kickMember`
 - `addMemberRole`
 - `removeMemberRole`
+- `addMessageReaction`
+- `removeOwnMessageReaction`
 
-Every action returns an `ActionResult<T>`:
+All actions return:
 
 ```ts
 type ActionResult<T> =
@@ -137,9 +166,34 @@ type ActionResult<T> =
   | { ok: false; requestId: string; ts: number; error: { code: string; message: string; details?: unknown } };
 ```
 
+### Idempotency for safe retries
+
+You can provide an `idempotencyKey` in action options to dedupe repeated requests on the same connection:
+
+```ts
+await app.actions.sendMessage(
+  { channelId: "123456789012345678", content: "Hello once" },
+  { idempotencyKey: "notify:order:123" },
+);
+```
+
+### App-side action metrics
+
+```ts
+const app = connectBotBridge({
+  url: "ws://127.0.0.1:3001/shardwire",
+  secret: process.env.SHARDWIRE_SECRET!,
+  metrics: {
+    onActionComplete(meta) {
+      console.log(meta.name, meta.durationMs, meta.ok, meta.errorCode);
+    },
+  },
+});
+```
+
 ## Secret Scopes
 
-Use a plain string secret for full access:
+Use a plain string secret for full event/action access:
 
 ```ts
 server: {
@@ -148,7 +202,7 @@ server: {
 }
 ```
 
-Or scope a secret to specific events and actions:
+Use a scoped secret to limit what an app can do:
 
 ```ts
 server: {
@@ -166,35 +220,58 @@ server: {
 }
 ```
 
-On the app side, you can inspect what the connection is allowed to do:
+Inspect negotiated capabilities in the app:
 
 ```ts
 const capabilities = app.capabilities();
 console.log(capabilities.events, capabilities.actions);
 ```
 
+## Run the Included Examples
+
+In two terminals:
+
+```bash
+# terminal 1
+DISCORD_TOKEN=your-token SHARDWIRE_SECRET=dev-secret npm run example:bot
+```
+
+```bash
+# terminal 2
+SHARDWIRE_SECRET=dev-secret npm run example:app
+```
+
+Examples:
+
+- Bot bridge: `examples/bot-basic.ts`
+- App client: `examples/app-basic.ts`
+
 ## Public API
 
 ```ts
 import { createBotBridge, connectBotBridge } from "shardwire";
 ```
 
-Main exports:
+Main exports include:
 
 - `createBotBridge(options)`
 - `connectBotBridge(options)`
 - `BridgeCapabilityError`
 - bot/app option types
-- normalized event payload types like `BridgeMessage`, `BridgeInteraction`, and `BridgeGuildMember`
-- action payload/result types
+- normalized event payload types (for example `BridgeMessage`, `BridgeInteraction`, `BridgeGuildMember`)
+- action payload and result types
+
+## Security and Transport Notes
+
+- Use `wss://` for non-loopback deployments.
+- `ws://` is only accepted for loopback hosts (`127.0.0.1`, `localhost`, `::1`).
+- Event availability depends on enabled intents and secret scope.
+- For vulnerability reporting and security policy, see [`SECURITY.md`](./SECURITY.md).
 
-## Notes
+## Contributing
 
-- Non-loopback app connections should use `wss://`
-- `discord.js` is used internally by the default runtime, but apps interact with Shardwire through Shardwire's own JSON payloads
-- Event availability depends on the intents you enable for the bot bridge
+Issues and pull requests are welcome: [github.com/unloopedmido/shardwire](https://github.com/unloopedmido/shardwire).
 
-## Examples
+## License
 
-- Bot: [examples/bot-basic.ts](./examples/bot-basic.ts)
-- App: [examples/app-basic.ts](./examples/app-basic.ts)
+MIT - see [`LICENSE`](./LICENSE).

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import { Snowflake, APIEmbed, APIAllowedMentions } from 'discord-api-types/v10';
+import { Snowflake, APIEmbed, APIAllowedMentions, APIActionRowComponent, APIComponentInMessageActionRow, APITextInputComponent } from 'discord-api-types/v10';
+import { GatewayIntentBits } from 'discord.js';
 
 type Unsubscribe = () => void;
 interface ShardwireLogger {
@@ -7,7 +8,7 @@ interface ShardwireLogger {
     warn?: (message: string, meta?: Record<string, unknown>) => void;
     error?: (message: string, meta?: Record<string, unknown>) => void;
 }
-type BotIntentName = "Guilds" | "GuildMembers" | "GuildMessages" | "MessageContent";
+type BotIntentName = keyof typeof GatewayIntentBits;
 interface BridgeUser {
     id: Snowflake;
     username: string;
@@ -41,6 +42,23 @@ interface BridgeGuildMember {
     pending?: boolean;
     communicationDisabledUntil?: string | null;
 }
+/** Normalized guild snapshot for `guildCreate` / `guildDelete` events. */
+interface BridgeGuild {
+    id: Snowflake;
+    name: string;
+    icon?: string | null;
+    ownerId?: Snowflake;
+}
+/** Normalized thread channel snapshot for thread lifecycle events. */
+interface BridgeThread {
+    id: Snowflake;
+    guildId: Snowflake;
+    parentId: Snowflake | null;
+    name: string;
+    type: number;
+    archived?: boolean;
+    locked?: boolean;
+}
 interface BridgeMessage {
     id: Snowflake;
     channelId: Snowflake;
@@ -52,6 +70,8 @@ interface BridgeMessage {
     editedAt?: string | null;
     attachments: BridgeAttachment[];
     embeds: APIEmbed[];
+    /** Message component rows (JSON-serializable API shape). */
+    components?: APIActionRowComponent<APIComponentInMessageActionRow>[];
     reference?: BridgeMessageReference;
 }
 interface BridgeDeletedMessage {
@@ -60,6 +80,18 @@ interface BridgeDeletedMessage {
     guildId?: Snowflake;
     deletedAt: string;
 }
+interface BridgeReactionEmoji {
+    id?: Snowflake;
+    name?: string | null;
+    animated?: boolean;
+}
+interface BridgeMessageReaction {
+    messageId: Snowflake;
+    channelId: Snowflake;
+    guildId?: Snowflake;
+    user?: BridgeUser;
+    emoji: BridgeReactionEmoji;
+}
 type BridgeInteractionKind = "chatInput" | "contextMenu" | "button" | "stringSelect" | "userSelect" | "roleSelect" | "mentionableSelect" | "channelSelect" | "modalSubmit" | "unknown";
 interface BridgeInteraction {
     id: Snowflake;
@@ -78,6 +110,7 @@ interface BridgeInteraction {
 }
 interface EventEnvelopeBase {
     receivedAt: number;
+    /** Populated when the bot runs under `ShardingManager` (multi-shard). */
     shardId?: number;
 }
 interface ReadyEventPayload extends EventEnvelopeBase {
@@ -102,20 +135,58 @@ interface GuildMemberAddEventPayload extends EventEnvelopeBase {
 interface GuildMemberRemoveEventPayload extends EventEnvelopeBase {
     member: BridgeGuildMember;
 }
+interface GuildMemberUpdateEventPayload extends EventEnvelopeBase {
+    oldMember?: BridgeGuildMember;
+    member: BridgeGuildMember;
+}
+interface GuildCreateEventPayload extends EventEnvelopeBase {
+    guild: BridgeGuild;
+}
+interface GuildDeleteEventPayload extends EventEnvelopeBase {
+    guild: BridgeGuild;
+}
+interface ThreadCreateEventPayload extends EventEnvelopeBase {
+    thread: BridgeThread;
+}
+interface ThreadUpdateEventPayload extends EventEnvelopeBase {
+    oldThread?: BridgeThread;
+    thread: BridgeThread;
+}
+interface ThreadDeleteEventPayload extends EventEnvelopeBase {
+    thread: BridgeThread;
+}
+interface MessageReactionAddEventPayload extends EventEnvelopeBase {
+    reaction: BridgeMessageReaction;
+}
+interface MessageReactionRemoveEventPayload extends EventEnvelopeBase {
+    reaction: BridgeMessageReaction;
+}
 interface BotEventPayloadMap {
     ready: ReadyEventPayload;
     interactionCreate: InteractionCreateEventPayload;
     messageCreate: MessageCreateEventPayload;
     messageUpdate: MessageUpdateEventPayload;
     messageDelete: MessageDeleteEventPayload;
+    messageReactionAdd: MessageReactionAddEventPayload;
+    messageReactionRemove: MessageReactionRemoveEventPayload;
+    guildCreate: GuildCreateEventPayload;
+    guildDelete: GuildDeleteEventPayload;
     guildMemberAdd: GuildMemberAddEventPayload;
     guildMemberRemove: GuildMemberRemoveEventPayload;
+    guildMemberUpdate: GuildMemberUpdateEventPayload;
+    threadCreate: ThreadCreateEventPayload;
+    threadUpdate: ThreadUpdateEventPayload;
+    threadDelete: ThreadDeleteEventPayload;
 }
 type BotEventName = keyof BotEventPayloadMap;
 interface BridgeMessageInput {
     content?: string;
     embeds?: APIEmbed[];
     allowedMentions?: APIAllowedMentions;
+    components?: APIActionRowComponent<APIComponentInMessageActionRow>[];
+    /** Bitfield compatible with `MessageFlags` from discord.js / Discord API. */
+    flags?: number;
+    stickerIds?: Snowflake[];
 }
 interface SendMessageActionPayload extends BridgeMessageInput {
     channelId: Snowflake;
@@ -140,6 +211,32 @@ interface FollowUpInteractionActionPayload extends BridgeMessageInput {
     interactionId: Snowflake;
     ephemeral?: boolean;
 }
+interface DeferUpdateInteractionActionPayload {
+    interactionId: Snowflake;
+}
+interface EditInteractionReplyActionPayload extends BridgeMessageInput {
+    interactionId: Snowflake;
+}
+interface DeleteInteractionReplyActionPayload {
+    interactionId: Snowflake;
+}
+interface UpdateInteractionActionPayload extends BridgeMessageInput {
+    interactionId: Snowflake;
+}
+interface ShowModalActionPayload {
+    interactionId: Snowflake;
+    title: string;
+    customId: string;
+    components: APIActionRowComponent<APITextInputComponent>[];
+}
+interface FetchMessageActionPayload {
+    channelId: Snowflake;
+    messageId: Snowflake;
+}
+interface FetchMemberActionPayload {
+    guildId: Snowflake;
+    userId: Snowflake;
+}
 interface BanMemberActionPayload {
     guildId: Snowflake;
     userId: Snowflake;
@@ -163,17 +260,36 @@ interface RemoveMemberRoleActionPayload {
     roleId: Snowflake;
     reason?: string;
 }
+interface AddMessageReactionActionPayload {
+    channelId: Snowflake;
+    messageId: Snowflake;
+    emoji: string;
+}
+interface RemoveOwnMessageReactionActionPayload {
+    channelId: Snowflake;
+    messageId: Snowflake;
+    emoji: string;
+}
 interface BotActionPayloadMap {
     sendMessage: SendMessageActionPayload;
     editMessage: EditMessageActionPayload;
     deleteMessage: DeleteMessageActionPayload;
     replyToInteraction: ReplyToInteractionActionPayload;
     deferInteraction: DeferInteractionActionPayload;
+    deferUpdateInteraction: DeferUpdateInteractionActionPayload;
     followUpInteraction: FollowUpInteractionActionPayload;
+    editInteractionReply: EditInteractionReplyActionPayload;
+    deleteInteractionReply: DeleteInteractionReplyActionPayload;
+    updateInteraction: UpdateInteractionActionPayload;
+    showModal: ShowModalActionPayload;
+    fetchMessage: FetchMessageActionPayload;
+    fetchMember: FetchMemberActionPayload;
     banMember: BanMemberActionPayload;
     kickMember: KickMemberActionPayload;
     addMemberRole: AddMemberRoleActionPayload;
     removeMemberRole: RemoveMemberRoleActionPayload;
+    addMessageReaction: AddMessageReactionActionPayload;
+    removeOwnMessageReaction: RemoveOwnMessageReactionActionPayload;
 }
 interface DeleteMessageActionResult {
     deleted: true;
@@ -184,21 +300,47 @@ interface DeferInteractionActionResult {
     deferred: true;
     interactionId: Snowflake;
 }
+interface DeferUpdateInteractionActionResult {
+    deferred: true;
+    interactionId: Snowflake;
+}
+interface DeleteInteractionReplyActionResult {
+    deleted: true;
+    interactionId: Snowflake;
+}
+interface ShowModalActionResult {
+    shown: true;
+    interactionId: Snowflake;
+}
 interface MemberModerationActionResult {
     guildId: Snowflake;
     userId: Snowflake;
 }
+interface MessageReactionActionResult {
+    messageId: Snowflake;
+    channelId: Snowflake;
+    emoji: string;
+}
 interface BotActionResultDataMap {
     sendMessage: BridgeMessage;
     editMessage: BridgeMessage;
     deleteMessage: DeleteMessageActionResult;
     replyToInteraction: BridgeMessage;
     deferInteraction: DeferInteractionActionResult;
+    deferUpdateInteraction: DeferUpdateInteractionActionResult;
     followUpInteraction: BridgeMessage;
+    editInteractionReply: BridgeMessage;
+    deleteInteractionReply: DeleteInteractionReplyActionResult;
+    updateInteraction: BridgeMessage;
+    showModal: ShowModalActionResult;
+    fetchMessage: BridgeMessage;
+    fetchMember: BridgeGuildMember;
     banMember: MemberModerationActionResult;
     kickMember: MemberModerationActionResult;
     addMemberRole: BridgeGuildMember;
     removeMemberRole: BridgeGuildMember;
+    addMessageReaction: MessageReactionActionResult;
+    removeOwnMessageReaction: MessageReactionActionResult;
 }
 type BotActionName = keyof BotActionPayloadMap;
 interface BridgeCapabilities {
@@ -210,6 +352,10 @@ interface EventSubscriptionFilter {
     channelId?: Snowflake | readonly Snowflake[];
     userId?: Snowflake | readonly Snowflake[];
     commandName?: string | readonly string[];
+    /** Matches `BridgeInteraction.customId` when present (components, modals). */
+    customId?: string | readonly string[];
+    /** Matches `BridgeInteraction.kind`. */
+    interactionKind?: BridgeInteractionKind | readonly BridgeInteractionKind[];
 }
 interface EventSubscription<K extends BotEventName = BotEventName> {
     name: K;
@@ -225,6 +371,14 @@ interface ScopedSecretConfig {
     allow?: SecretPermissions;
 }
 type BotBridgeSecret = string | ScopedSecretConfig;
+/** Structured Discord / transport context for failed actions (machine-readable). */
+interface ActionErrorDetails {
+    discordStatus?: number;
+    discordCode?: number;
+    /** When true, callers may retry with backoff (e.g. rate limits). */
+    retryable?: boolean;
+    [key: string]: unknown;
+}
 interface BotBridgeOptions {
     token: string;
     intents: readonly BotIntentName[];
@@ -235,9 +389,24 @@ interface BotBridgeOptions {
         heartbeatMs?: number;
         maxPayloadBytes?: number;
         secrets: readonly BotBridgeSecret[];
+        /** Reject new TCP connections when authenticated client count reaches this cap (default: unlimited). */
+        maxConnections?: number;
+        /** Max concurrent action executions per bot process (default: 32). */
+        maxConcurrentActions?: number;
+        /** When the queue is full, fail fast with `SERVICE_UNAVAILABLE` (default: 5000). */
+        actionQueueTimeoutMs?: number;
     };
     logger?: ShardwireLogger;
 }
+interface AppBridgeMetricsHooks {
+    onActionComplete?: (meta: {
+        name: BotActionName;
+        requestId: string;
+        durationMs: number;
+        ok: boolean;
+        errorCode?: string;
+    }) => void;
+}
 interface AppBridgeOptions {
     url: string;
     secret: string;
@@ -251,11 +420,12 @@ interface AppBridgeOptions {
     };
     requestTimeoutMs?: number;
     logger?: ShardwireLogger;
+    metrics?: AppBridgeMetricsHooks;
 }
 interface ActionError {
-    code: "UNAUTHORIZED" | "TIMEOUT" | "DISCONNECTED" | "FORBIDDEN" | "NOT_FOUND" | "INVALID_REQUEST" | "INTERNAL_ERROR";
+    code: "UNAUTHORIZED" | "TIMEOUT" | "DISCONNECTED" | "FORBIDDEN" | "NOT_FOUND" | "INVALID_REQUEST" | "INTERNAL_ERROR" | "SERVICE_UNAVAILABLE";
     message: string;
-    details?: unknown;
+    details?: ActionErrorDetails | unknown;
 }
 interface ActionSuccess<T> {
     ok: true;
@@ -276,11 +446,14 @@ declare class BridgeCapabilityError extends Error {
     constructor(kind: "event" | "action", name: string, message?: string);
 }
 type EventHandler<K extends BotEventName> = (payload: BotEventPayloadMap[K]) => void;
+type AppBridgeActionInvokeOptions = {
+    timeoutMs?: number;
+    requestId?: string;
+    /** When set, duplicate keys within TTL return the first result (best-effort idempotency). */
+    idempotencyKey?: string;
+};
 type AppBridgeActions = {
-    [K in BotActionName]: (payload: BotActionPayloadMap[K], options?: {
-        timeoutMs?: number;
-        requestId?: string;
-    }) => Promise<ActionResult<BotActionResultDataMap[K]>>;
+    [K in BotActionName]: (payload: BotActionPayloadMap[K], options?: AppBridgeActionInvokeOptions) => Promise<ActionResult<BotActionResultDataMap[K]>>;
 };
 interface BotBridge {
     ready(): Promise<void>;
@@ -305,4 +478,4 @@ declare function createBotBridge(options: BotBridgeOptions): BotBridge;
 
 declare function connectBotBridge(options: AppBridgeOptions): AppBridge;
 
-export { type ActionError, type ActionFailure, type ActionResult, type ActionSuccess, type AddMemberRoleActionPayload, type AppBridge, type AppBridgeActions, type AppBridgeOptions, type BanMemberActionPayload, type BotActionName, type BotActionPayloadMap, type BotActionResultDataMap, type BotBridge, type BotBridgeOptions, type BotBridgeSecret, type BotEventName, type BotEventPayloadMap, type BotIntentName, type BridgeAttachment, type BridgeCapabilities, BridgeCapabilityError, type BridgeDeletedMessage, type BridgeGuildMember, type BridgeInteraction, type BridgeInteractionKind, type BridgeMessage, type BridgeMessageInput, type BridgeMessageReference, type BridgeUser, type DeferInteractionActionPayload, type DeleteMessageActionPayload, type EditMessageActionPayload, type EventEnvelopeBase, type EventHandler, type EventSubscription, type EventSubscriptionFilter, type FollowUpInteractionActionPayload, type GuildMemberAddEventPayload, type GuildMemberRemoveEventPayload, type InteractionCreateEventPayload, type KickMemberActionPayload, type MessageCreateEventPayload, type MessageDeleteEventPayload, type MessageUpdateEventPayload, type ReadyEventPayload, type RemoveMemberRoleActionPayload, type ReplyToInteractionActionPayload, type ScopedSecretConfig, type SecretPermissions, type SendMessageActionPayload, type ShardwireLogger, type Unsubscribe, connectBotBridge, createBotBridge };
+export { type ActionError, type ActionErrorDetails, type ActionFailure, type ActionResult, type ActionSuccess, type AddMemberRoleActionPayload, type AddMessageReactionActionPayload, type AppBridge, type AppBridgeActionInvokeOptions, type AppBridgeActions, type AppBridgeMetricsHooks, type AppBridgeOptions, type BanMemberActionPayload, type BotActionName, type BotActionPayloadMap, type BotActionResultDataMap, type BotBridge, type BotBridgeOptions, type BotBridgeSecret, type BotEventName, type BotEventPayloadMap, type BotIntentName, type BridgeAttachment, type BridgeCapabilities, BridgeCapabilityError, type BridgeDeletedMessage, type BridgeGuild, type BridgeGuildMember, type BridgeInteraction, type BridgeInteractionKind, type BridgeMessage, type BridgeMessageInput, type BridgeMessageReaction, type BridgeMessageReference, type BridgeReactionEmoji, type BridgeThread, type BridgeUser, type DeferInteractionActionPayload, type DeferInteractionActionResult, type DeferUpdateInteractionActionPayload, type DeferUpdateInteractionActionResult, type DeleteInteractionReplyActionPayload, type DeleteInteractionReplyActionResult, type DeleteMessageActionPayload, type DeleteMessageActionResult, type EditInteractionReplyActionPayload, type EditMessageActionPayload, type EventEnvelopeBase, type EventHandler, type EventSubscription, type EventSubscriptionFilter, type FetchMemberActionPayload, type FetchMessageActionPayload, type FollowUpInteractionActionPayload, type GuildCreateEventPayload, type GuildDeleteEventPayload, type GuildMemberAddEventPayload, type GuildMemberRemoveEventPayload, type GuildMemberUpdateEventPayload, type InteractionCreateEventPayload, type KickMemberActionPayload, type MemberModerationActionResult, type MessageCreateEventPayload, type MessageDeleteEventPayload, type MessageReactionActionResult, type MessageReactionAddEventPayload, type MessageReactionRemoveEventPayload, type MessageUpdateEventPayload, type ReadyEventPayload, type RemoveMemberRoleActionPayload, type RemoveOwnMessageReactionActionPayload, type ReplyToInteractionActionPayload, type ScopedSecretConfig, type SecretPermissions, type SendMessageActionPayload, type ShardwireLogger, type ShowModalActionPayload, type ShowModalActionResult, type ThreadCreateEventPayload, type ThreadDeleteEventPayload, type ThreadUpdateEventPayload, type Unsubscribe, type UpdateInteractionActionPayload, connectBotBridge, createBotBridge };