shardwire 1.1.0 → 1.3.0

package/README.md

@@ -30,43 +30,49 @@ Shardwire is built for a common architecture: your Discord bot runs in one proce
 npm install shardwire
 ```
 
+## Documentation
+
+- [Deployment (TLS, nginx, limits, shutdown)](./docs/deployment.md)
+- [Troubleshooting (auth, capabilities, action errors)](./docs/troubleshooting.md)
+- [Patterns (moderation, interactions, multi-secret)](./docs/patterns.md)
+
 ## Quick Start
 
 ### 1) Start the bot bridge process
 
 ```ts
-import { createBotBridge } from "shardwire";
+import { createBotBridge } from 'shardwire';
 
 const bridge = createBotBridge({
-  token: process.env.DISCORD_TOKEN!,
-  intents: ["Guilds", "GuildMessages", "GuildMessageReactions", "MessageContent", "GuildMembers"],
-  server: {
-    port: 3001,
-    secrets: [process.env.SHARDWIRE_SECRET!],
-  },
+	token: process.env.DISCORD_TOKEN!,
+	intents: ['Guilds', 'GuildMessages', 'GuildMessageReactions', 'MessageContent', 'GuildMembers'],
+	server: {
+		port: 3001,
+		secrets: [process.env.SHARDWIRE_SECRET!],
+	},
 });
 
 await bridge.ready();
-console.log("Bot bridge listening on ws://127.0.0.1:3001/shardwire");
+console.log('Bot bridge listening on ws://127.0.0.1:3001/shardwire');
 ```
 
 ### 2) Connect from your app process
 
 ```ts
-import { connectBotBridge } from "shardwire";
+import { connectBotBridge } from 'shardwire';
 
 const app = connectBotBridge({
-  url: "ws://127.0.0.1:3001/shardwire",
-  secret: process.env.SHARDWIRE_SECRET!,
-  appName: "dashboard",
+	url: 'ws://127.0.0.1:3001/shardwire',
+	secret: process.env.SHARDWIRE_SECRET!,
+	appName: 'dashboard',
 });
 
-app.on("ready", ({ user }) => {
-  console.log("Bot ready as", user.username);
+app.on('ready', ({ user }) => {
+	console.log('Bot ready as', user.username);
 });
 
-app.on("messageCreate", ({ message }) => {
-  console.log(message.channelId, message.content);
+app.on('messageCreate', ({ message }) => {
+	console.log(message.channelId, message.content);
 });
 
 await app.ready();
@@ -76,12 +82,12 @@ await app.ready();
 
 ```ts
 const result = await app.actions.sendMessage({
-  channelId: "123456789012345678",
-  content: "Hello from app side",
+	channelId: '123456789012345678',
+	content: 'Hello from app side',
 });
 
 if (!result.ok) {
-  console.error(result.error.code, result.error.message);
+	console.error(result.error.code, result.error.message);
 }
 ```
 
@@ -89,14 +95,20 @@ if (!result.ok) {
 
 ```ts
 app.on(
-  "messageCreate",
-  ({ message }) => {
-    console.log("Only this channel:", message.content);
-  },
-  { channelId: "123456789012345678" },
+	'messageCreate',
+	({ message }) => {
+		console.log('Only this channel:', message.content);
+	},
+	{ channelId: '123456789012345678' },
 );
 ```
 
+## Startup lifecycle
+
+- **`createBotBridge(...)`** starts the WebSocket server immediately; `await bridge.ready()` resolves when the Discord client has finished its initial `ready` handshake (same timing you would expect from a normal bot login).
+- **Register `app.on(...)` handlers before `await app.ready()`** so subscriptions are known when the app authenticates. `ready()` connects, completes auth, negotiates capabilities from intents + secret scope, then throws `BridgeCapabilityError` if any registered handler targets an event the app is not allowed to receive.
+- **Sticky `ready`**: if the bot was already ready before the app connected, the bridge replays the latest `ready` payload to matching subscriptions after auth.
+
 ## Built-In Events
 
 Apps subscribe to events with `app.on(...)`. The bridge forwards only what each app subscribes to.
@@ -108,8 +120,14 @@ Apps subscribe to events with `app.on(...)`. The bridge forwards only what each
 - `messageDelete`
 - `messageReactionAdd`
 - `messageReactionRemove`
+- `guildCreate`
+- `guildDelete`
 - `guildMemberAdd`
 - `guildMemberRemove`
+- `guildMemberUpdate`
+- `threadCreate`
+- `threadUpdate`
+- `threadDelete`
 
 Supported filters:
 
@@ -117,13 +135,16 @@ Supported filters:
 - `channelId`
 - `userId`
 - `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`
-- `guildMemberAdd`, `guildMemberRemove`: `GuildMembers`
+- `guildCreate`, `guildDelete`, `threadCreate`, `threadUpdate`, `threadDelete`: `Guilds`
+- `guildMemberAdd`, `guildMemberRemove`, `guildMemberUpdate`: `GuildMembers`
 
 ## Built-In Actions
 
@@ -134,7 +155,14 @@ Supported filters:
 - `deleteMessage`
 - `replyToInteraction`
 - `deferInteraction`
+- `deferUpdateInteraction`
 - `followUpInteraction`
+- `editInteractionReply`
+- `deleteInteractionReply`
+- `updateInteraction`
+- `showModal`
+- `fetchMessage`
+- `fetchMember`
 - `banMember`
 - `kickMember`
 - `addMemberRole`
@@ -146,10 +174,52 @@ All actions return:
 
 ```ts
 type ActionResult<T> =
-  | { ok: true; requestId: string; ts: number; data: T }
-  | { ok: false; requestId: string; ts: number; error: { code: string; message: string; details?: unknown } };
+	| { ok: true; requestId: string; ts: number; data: 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 so repeated calls return the first result while the server-side entry is still valid (default TTL **120s**).
+
+- **Default scope (`connection`)**: dedupe is per WebSocket connection (a reconnect is a new connection and does not replay prior keys).
+- **Optional scope (`secret`)**: set `server.idempotencyScope: "secret"` on the bot bridge to dedupe by configured secret id across connections (useful when the app reconnects and retries the same logical operation).
+
+```ts
+await app.actions.sendMessage(
+	{ channelId: '123456789012345678', content: 'Hello once' },
+	{ idempotencyKey: 'notify:order:123' },
+);
+```
+
+Tune limits on the bot bridge when needed:
+
+```ts
+server: {
+  port: 3001,
+  secrets: [process.env.SHARDWIRE_SECRET!],
+  maxPayloadBytes: 65536, // per-frame JSON limit (default 65536)
+  idempotencyScope: "secret",
+  idempotencyTtlMs: 120_000,
+},
+```
+
+### 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, meta.discordStatus, meta.retryAfterMs);
+		},
+	},
+});
+```
+
+On Discord **429** responses, failed actions surface `SERVICE_UNAVAILABLE` with `details.retryAfterMs` (when Discord provides `retry_after`) and the metrics hook receives `retryAfterMs` / `discordStatus` for backoff and dashboards.
+
 ## Secret Scopes
 
 Use a plain string secret for full event/action access:
@@ -188,7 +258,7 @@ console.log(capabilities.events, capabilities.actions);
 
 ## Run the Included Examples
 
-In two terminals:
+### Minimal (single shared secret)
 
 ```bash
 # terminal 1
@@ -200,15 +270,42 @@ DISCORD_TOKEN=your-token SHARDWIRE_SECRET=dev-secret npm run example:bot
 SHARDWIRE_SECRET=dev-secret npm run example:app
 ```
 
-Examples:
+- Bot bridge: [`examples/bot-basic.ts`](./examples/bot-basic.ts)
+- App client: [`examples/app-basic.ts`](./examples/app-basic.ts)
+
+### Production-style (scoped secrets + moderation + interactions)
+
+Use **two different** secret strings (bridge rejects duplicate values across scoped entries).
+
+```bash
+# terminal 1 — bot with dashboard + moderation scopes
+DISCORD_TOKEN=your-token \
+  SHARDWIRE_SECRET_DASHBOARD=dashboard-secret \
+  SHARDWIRE_SECRET_MODERATION=moderation-secret \
+  npm run example:bot:prod
+```
+
+```bash
+# terminal 2 — delete messages that contain the demo trigger (optional channel filter)
+SHARDWIRE_SECRET_MODERATION=moderation-secret \
+  MOD_ALERT_CHANNEL_ID=123456789012345678 \
+  npm run example:app:moderation
+```
 
-- Bot bridge: `examples/bot-basic.ts`
-- App client: `examples/app-basic.ts`
+```bash
+# terminal 3 — defer + edit reply for `customId: shardwire.demo.btn` buttons
+SHARDWIRE_SECRET_MODERATION=moderation-secret \
+  npm run example:app:interaction
+```
+
+- [`examples/bot-production.ts`](./examples/bot-production.ts)
+- [`examples/app-moderation.ts`](./examples/app-moderation.ts)
+- [`examples/app-interaction.ts`](./examples/app-interaction.ts)
 
 ## Public API
 
 ```ts
-import { createBotBridge, connectBotBridge } from "shardwire";
+import { createBotBridge, connectBotBridge } from 'shardwire';
 ```
 
 Main exports include:
@@ -226,6 +323,10 @@ Main exports include:
 - `ws://` is only accepted for loopback hosts (`127.0.0.1`, `localhost`, `::1`).
 - Event availability depends on enabled intents and secret scope.
 
+**Reporting vulnerabilities:** email [cored.developments@gmail.com](mailto:cored.developments@gmail.com) with enough detail to reproduce the issue (versions, config shape, and steps). Do not open a public issue for undisclosed security problems.
+
+**Rotating bridge secrets without downtime:** configure **two** entries in `server.secrets` (old + new values), roll the app env to the new secret, then remove the old entry on the next deploy. Scoped secrets should keep **distinct** `id` values so apps can pin `secretId` during rotation.
+
 ## Contributing
 
 Issues and pull requests are welcome: [github.com/unloopedmido/shardwire](https://github.com/unloopedmido/shardwire).

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-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;
@@ -42,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;
@@ -53,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 {
@@ -73,7 +92,7 @@ interface BridgeMessageReaction {
     user?: BridgeUser;
     emoji: BridgeReactionEmoji;
 }
-type BridgeInteractionKind = "chatInput" | "contextMenu" | "button" | "stringSelect" | "userSelect" | "roleSelect" | "mentionableSelect" | "channelSelect" | "modalSubmit" | "unknown";
+type BridgeInteractionKind = 'chatInput' | 'contextMenu' | 'button' | 'stringSelect' | 'userSelect' | 'roleSelect' | 'mentionableSelect' | 'channelSelect' | 'modalSubmit' | 'unknown';
 interface BridgeInteraction {
     id: Snowflake;
     applicationId: Snowflake;
@@ -91,6 +110,7 @@ interface BridgeInteraction {
 }
 interface EventEnvelopeBase {
     receivedAt: number;
+    /** Populated when the bot runs under `ShardingManager` (multi-shard). */
     shardId?: number;
 }
 interface ReadyEventPayload extends EventEnvelopeBase {
@@ -115,6 +135,26 @@ 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;
 }
@@ -129,14 +169,24 @@ interface BotEventPayloadMap {
     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;
@@ -161,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;
@@ -200,7 +276,14 @@ interface BotActionPayloadMap {
     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;
@@ -217,6 +300,18 @@ 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;
@@ -232,7 +327,14 @@ interface BotActionResultDataMap {
     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;
@@ -250,14 +352,18 @@ 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;
     filter?: EventSubscriptionFilter;
 }
 interface SecretPermissions {
-    events?: "*" | readonly BotEventName[];
-    actions?: "*" | readonly BotActionName[];
+    events?: '*' | readonly BotEventName[];
+    actions?: '*' | readonly BotActionName[];
 }
 interface ScopedSecretConfig {
     id?: string;
@@ -265,6 +371,16 @@ 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;
+    /** Suggested wait derived from Discord `retry_after` (milliseconds), when available. */
+    retryAfterMs?: number;
+    [key: string]: unknown;
+}
 interface BotBridgeOptions {
     token: string;
     intents: readonly BotIntentName[];
@@ -275,9 +391,36 @@ 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;
+        /**
+         * Where `idempotencyKey` deduplication is scoped (default: `connection`).
+         * - `connection`: same WebSocket connection only (reconnect uses a new scope).
+         * - `secret`: same configured secret id across connections (useful for retries after reconnect).
+         */
+        idempotencyScope?: 'connection' | 'secret';
+        /** TTL for idempotency cache entries in ms (default: 120000). */
+        idempotencyTtlMs?: number;
     };
     logger?: ShardwireLogger;
 }
+interface AppBridgeMetricsHooks {
+    onActionComplete?: (meta: {
+        name: BotActionName;
+        requestId: string;
+        durationMs: number;
+        ok: boolean;
+        errorCode?: string;
+        /** Present when Discord returned HTTP 429 or similar retryable signals. */
+        retryAfterMs?: number;
+        discordStatus?: number;
+        discordCode?: number;
+    }) => void;
+}
 interface AppBridgeOptions {
     url: string;
     secret: string;
@@ -291,11 +434,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;
@@ -311,16 +455,19 @@ interface ActionFailure {
 }
 type ActionResult<T> = ActionSuccess<T> | ActionFailure;
 declare class BridgeCapabilityError extends Error {
-    readonly kind: "event" | "action";
+    readonly kind: 'event' | 'action';
     readonly name: string;
-    constructor(kind: "event" | "action", name: string, message?: string);
+    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>;
@@ -345,4 +492,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 AddMessageReactionActionPayload, 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 BridgeMessageReaction, type BridgeMessageReference, type BridgeReactionEmoji, 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 MessageReactionActionResult, type MessageReactionAddEventPayload, type MessageReactionRemoveEventPayload, type MessageUpdateEventPayload, type ReadyEventPayload, type RemoveMemberRoleActionPayload, type RemoveOwnMessageReactionActionPayload, 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 };