shardwire 1.2.0 → 1.4.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.
@@ -106,6 +118,7 @@ Apps subscribe to events with `app.on(...)`. The bridge forwards only what each
 - `messageCreate`
 - `messageUpdate`
 - `messageDelete`
+- `messageBulkDelete`
 - `messageReactionAdd`
 - `messageReactionRemove`
 - `guildCreate`
@@ -116,6 +129,9 @@ Apps subscribe to events with `app.on(...)`. The bridge forwards only what each
 - `threadCreate`
 - `threadUpdate`
 - `threadDelete`
+- `channelCreate`
+- `channelUpdate`
+- `channelDelete`
 
 Supported filters:
 
@@ -125,13 +141,16 @@ Supported filters:
 - `commandName` (for `interactionCreate`)
 - `customId` (for `interactionCreate`)
 - `interactionKind` (for `interactionCreate`)
+- `channelType` (Discord `ChannelType` when present on the payload, for example `messageCreate` / `messageBulkDelete`)
+- `parentChannelId` (category parent, forum/text parent for threads, or thread parent when serialized)
+- `threadId` (guild thread channels only: matches thread channel ids)
 
 ### Intent Notes
 
 - `ready` and `interactionCreate`: no specific event intent requirement
-- `messageCreate`, `messageUpdate`, `messageDelete`: `GuildMessages`
+- `messageCreate`, `messageUpdate`, `messageDelete`, `messageBulkDelete`: `GuildMessages`
 - `messageReactionAdd`, `messageReactionRemove`: `GuildMessageReactions`
-- `guildCreate`, `guildDelete`, `threadCreate`, `threadUpdate`, `threadDelete`: `Guilds`
+- `guildCreate`, `guildDelete`, `threadCreate`, `threadUpdate`, `threadDelete`, `channelCreate`, `channelUpdate`, `channelDelete`: `Guilds`
 - `guildMemberAdd`, `guildMemberRemove`, `guildMemberUpdate`: `GuildMembers`
 
 ## Built-In Actions
@@ -157,40 +176,64 @@ Supported filters:
 - `removeMemberRole`
 - `addMessageReaction`
 - `removeOwnMessageReaction`
+- `timeoutMember`
+- `removeMemberTimeout`
+- `createChannel`
+- `editChannel`
+- `deleteChannel`
+- `createThread`
+- `archiveThread`
 
 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 to dedupe repeated requests on the same connection:
+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" },
+	{ 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);
-    },
-  },
+	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:
@@ -229,7 +272,7 @@ console.log(capabilities.events, capabilities.actions);
 
 ## Run the Included Examples
 
-In two terminals:
+### Minimal (single shared secret)
 
 ```bash
 # terminal 1
@@ -241,15 +284,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)
 
-- Bot bridge: `examples/bot-basic.ts`
-- App client: `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
+```
+
+```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:
@@ -266,7 +336,10 @@ Main exports include:
 - 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).
+
+**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
 

package/dist/index.d.mts

@@ -59,6 +59,14 @@ interface BridgeThread {
     archived?: boolean;
     locked?: boolean;
 }
+/** Normalized non-thread channel snapshot for channel lifecycle events. */
+interface BridgeChannel {
+    id: Snowflake;
+    type: number;
+    name?: string | null;
+    guildId?: Snowflake;
+    parentId?: Snowflake | null;
+}
 interface BridgeMessage {
     id: Snowflake;
     channelId: Snowflake;
@@ -73,12 +81,18 @@ interface BridgeMessage {
     /** Message component rows (JSON-serializable API shape). */
     components?: APIActionRowComponent<APIComponentInMessageActionRow>[];
     reference?: BridgeMessageReference;
+    /** Discord `ChannelType` when the runtime could resolve `message.channel`. */
+    channelType?: number;
+    /** Parent category (guild text channels) or parent text/forum (threads), when known. */
+    parentChannelId?: Snowflake;
 }
 interface BridgeDeletedMessage {
     id: Snowflake;
     channelId: Snowflake;
     guildId?: Snowflake;
     deletedAt: string;
+    channelType?: number;
+    parentChannelId?: Snowflake;
 }
 interface BridgeReactionEmoji {
     id?: Snowflake;
@@ -92,13 +106,17 @@ 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;
     kind: BridgeInteractionKind;
     guildId?: Snowflake;
     channelId?: Snowflake;
+    /** Discord `ChannelType` for `channelId` when the runtime resolved the channel. */
+    channelType?: number;
+    /** Parent category or parent text/forum for thread channels, when known. */
+    parentChannelId?: Snowflake;
     user: BridgeUser;
     member?: BridgeGuildMember;
     commandName?: string;
@@ -161,12 +179,32 @@ interface MessageReactionAddEventPayload extends EventEnvelopeBase {
 interface MessageReactionRemoveEventPayload extends EventEnvelopeBase {
     reaction: BridgeMessageReaction;
 }
+interface ChannelCreateEventPayload extends EventEnvelopeBase {
+    channel: BridgeChannel;
+}
+interface ChannelUpdateEventPayload extends EventEnvelopeBase {
+    oldChannel?: BridgeChannel;
+    channel: BridgeChannel;
+}
+interface ChannelDeleteEventPayload extends EventEnvelopeBase {
+    channel: BridgeChannel;
+}
+interface MessageBulkDeleteEventPayload extends EventEnvelopeBase {
+    channelId: Snowflake;
+    guildId: Snowflake;
+    messageIds: Snowflake[];
+    /** Discord `ChannelType` for `channelId` when known. */
+    channelType?: number;
+    /** Parent category or forum/text parent when the channel reports one. */
+    parentChannelId?: Snowflake;
+}
 interface BotEventPayloadMap {
     ready: ReadyEventPayload;
     interactionCreate: InteractionCreateEventPayload;
     messageCreate: MessageCreateEventPayload;
     messageUpdate: MessageUpdateEventPayload;
     messageDelete: MessageDeleteEventPayload;
+    messageBulkDelete: MessageBulkDeleteEventPayload;
     messageReactionAdd: MessageReactionAddEventPayload;
     messageReactionRemove: MessageReactionRemoveEventPayload;
     guildCreate: GuildCreateEventPayload;
@@ -177,6 +215,9 @@ interface BotEventPayloadMap {
     threadCreate: ThreadCreateEventPayload;
     threadUpdate: ThreadUpdateEventPayload;
     threadDelete: ThreadDeleteEventPayload;
+    channelCreate: ChannelCreateEventPayload;
+    channelUpdate: ChannelUpdateEventPayload;
+    channelDelete: ChannelDeleteEventPayload;
 }
 type BotEventName = keyof BotEventPayloadMap;
 interface BridgeMessageInput {
@@ -270,6 +311,53 @@ interface RemoveOwnMessageReactionActionPayload {
     messageId: Snowflake;
     emoji: string;
 }
+interface TimeoutMemberActionPayload {
+    guildId: Snowflake;
+    userId: Snowflake;
+    /** Duration in milliseconds (Discord allows up to 28 days). */
+    durationMs: number;
+    reason?: string;
+}
+interface RemoveMemberTimeoutActionPayload {
+    guildId: Snowflake;
+    userId: Snowflake;
+    reason?: string;
+}
+interface CreateChannelActionPayload {
+    guildId: Snowflake;
+    name: string;
+    /** Discord `ChannelType` (default: `0` guild text). */
+    type?: number;
+    parentId?: Snowflake;
+    topic?: string;
+    reason?: string;
+}
+interface EditChannelActionPayload {
+    channelId: Snowflake;
+    name?: string | null;
+    parentId?: Snowflake | null;
+    topic?: string | null;
+    reason?: string;
+}
+interface DeleteChannelActionPayload {
+    channelId: Snowflake;
+    reason?: string;
+}
+/** `autoArchiveDuration` is in minutes (Discord-supported values). */
+interface CreateThreadActionPayload {
+    parentChannelId: Snowflake;
+    name: string;
+    /** When set, starts a thread on this message (requires a text-based parent). */
+    messageId?: Snowflake;
+    type?: 'public' | 'private';
+    autoArchiveDuration?: 60 | 1440 | 4320 | 10080;
+    reason?: string;
+}
+interface ArchiveThreadActionPayload {
+    threadId: Snowflake;
+    archived?: boolean;
+    reason?: string;
+}
 interface BotActionPayloadMap {
     sendMessage: SendMessageActionPayload;
     editMessage: EditMessageActionPayload;
@@ -290,6 +378,13 @@ interface BotActionPayloadMap {
     removeMemberRole: RemoveMemberRoleActionPayload;
     addMessageReaction: AddMessageReactionActionPayload;
     removeOwnMessageReaction: RemoveOwnMessageReactionActionPayload;
+    timeoutMember: TimeoutMemberActionPayload;
+    removeMemberTimeout: RemoveMemberTimeoutActionPayload;
+    createChannel: CreateChannelActionPayload;
+    editChannel: EditChannelActionPayload;
+    deleteChannel: DeleteChannelActionPayload;
+    createThread: CreateThreadActionPayload;
+    archiveThread: ArchiveThreadActionPayload;
 }
 interface DeleteMessageActionResult {
     deleted: true;
@@ -321,6 +416,10 @@ interface MessageReactionActionResult {
     channelId: Snowflake;
     emoji: string;
 }
+interface DeleteChannelActionResult {
+    deleted: true;
+    channelId: Snowflake;
+}
 interface BotActionResultDataMap {
     sendMessage: BridgeMessage;
     editMessage: BridgeMessage;
@@ -341,6 +440,13 @@ interface BotActionResultDataMap {
     removeMemberRole: BridgeGuildMember;
     addMessageReaction: MessageReactionActionResult;
     removeOwnMessageReaction: MessageReactionActionResult;
+    timeoutMember: MemberModerationActionResult;
+    removeMemberTimeout: BridgeGuildMember;
+    createChannel: BridgeChannel;
+    editChannel: BridgeChannel;
+    deleteChannel: DeleteChannelActionResult;
+    createThread: BridgeThread;
+    archiveThread: BridgeThread;
 }
 type BotActionName = keyof BotActionPayloadMap;
 interface BridgeCapabilities {
@@ -356,14 +462,20 @@ interface EventSubscriptionFilter {
     customId?: string | readonly string[];
     /** Matches `BridgeInteraction.kind`. */
     interactionKind?: BridgeInteractionKind | readonly BridgeInteractionKind[];
+    /** Matches Discord `ChannelType` when present on the payload (messages, interactions, bulk delete). */
+    channelType?: number | readonly number[];
+    /** Matches `BridgeMessage.parentChannelId` / thread parent / channel parent when present. */
+    parentChannelId?: Snowflake | readonly Snowflake[];
+    /** Matches guild thread channels only: same as message `channelId` when `channelType` is a guild thread. */
+    threadId?: Snowflake | readonly Snowflake[];
 }
 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;
@@ -377,6 +489,8 @@ interface ActionErrorDetails {
     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 {
@@ -395,6 +509,14 @@ interface BotBridgeOptions {
         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;
 }
@@ -405,6 +527,10 @@ interface AppBridgeMetricsHooks {
         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 {
@@ -423,7 +549,7 @@ interface AppBridgeOptions {
     metrics?: AppBridgeMetricsHooks;
 }
 interface ActionError {
-    code: "UNAUTHORIZED" | "TIMEOUT" | "DISCONNECTED" | "FORBIDDEN" | "NOT_FOUND" | "INVALID_REQUEST" | "INTERNAL_ERROR" | "SERVICE_UNAVAILABLE";
+    code: 'UNAUTHORIZED' | 'TIMEOUT' | 'DISCONNECTED' | 'FORBIDDEN' | 'NOT_FOUND' | 'INVALID_REQUEST' | 'INTERNAL_ERROR' | 'SERVICE_UNAVAILABLE';
     message: string;
     details?: ActionErrorDetails | unknown;
 }
@@ -441,9 +567,9 @@ 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 = {
@@ -478,4 +604,4 @@ declare function createBotBridge(options: BotBridgeOptions): BotBridge;
 
 declare function connectBotBridge(options: AppBridgeOptions): AppBridge;
 
-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 };
+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 ArchiveThreadActionPayload, 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 BridgeChannel, 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 ChannelCreateEventPayload, type ChannelDeleteEventPayload, type ChannelUpdateEventPayload, type CreateChannelActionPayload, type CreateThreadActionPayload, type DeferInteractionActionPayload, type DeferInteractionActionResult, type DeferUpdateInteractionActionPayload, type DeferUpdateInteractionActionResult, type DeleteChannelActionPayload, type DeleteChannelActionResult, type DeleteInteractionReplyActionPayload, type DeleteInteractionReplyActionResult, type DeleteMessageActionPayload, type DeleteMessageActionResult, type EditChannelActionPayload, 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 MessageBulkDeleteEventPayload, type MessageCreateEventPayload, type MessageDeleteEventPayload, type MessageReactionActionResult, type MessageReactionAddEventPayload, type MessageReactionRemoveEventPayload, type MessageUpdateEventPayload, type ReadyEventPayload, type RemoveMemberRoleActionPayload, type RemoveMemberTimeoutActionPayload, type RemoveOwnMessageReactionActionPayload, type ReplyToInteractionActionPayload, type ScopedSecretConfig, type SecretPermissions, type SendMessageActionPayload, type ShardwireLogger, type ShowModalActionPayload, type ShowModalActionResult, type ThreadCreateEventPayload, type ThreadDeleteEventPayload, type ThreadUpdateEventPayload, type TimeoutMemberActionPayload, type Unsubscribe, type UpdateInteractionActionPayload, connectBotBridge, createBotBridge };