@went.tf/discord-bot-framework 2.0.0

package/build/interactions/handle-interaction-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-interaction-error.d.ts","sourceRoot":"","sources":["../../src/interactions/handle-interaction-error.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EAIvB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKpD,MAAM,WAAW,6BAA6B;IAC5C,0FAA0F;IAC1F,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,oBAAoB,EAAE,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClG;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAID,eAAO,MAAM,sBAAsB,GACjC,aAAa,oBAAoB,GAAG,uBAAuB,EAC3D,SAAS;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,EACnC,SAAS,6BAA6B,KACrC,OAAO,CAAC,IAAI,CA2Dd,CAAC"}

package/build/interactions/handle-interaction-error.js

@@ -0,0 +1,65 @@
+import { MessageFlags } from 'discord-api-types/v10';
+import { ComponentType, DiscordjsError, DiscordjsErrorCodes, } from 'discord.js';
+const ellipsis = '…';
+const maximumMessageLength = 2000;
+const defaultReply = (interaction, options) => interaction.reply(options);
+export const handleInteractionError = async (interaction, context, options) => {
+    const { buildMessage, reply = defaultReply, onUnexpectedError } = options;
+    if (interaction.isAutocomplete()) {
+        await interaction.respond([
+            {
+                value: '',
+                name: buildMessage(),
+            },
+        ]);
+        return;
+    }
+    let alreadyReplied = interaction.replied;
+    if (!alreadyReplied) {
+        await onUnexpectedError?.();
+        try {
+            await reply(interaction, {
+                content: buildMessage(),
+                flags: MessageFlags.Ephemeral,
+            });
+        }
+        catch (e) {
+            if (e instanceof DiscordjsError && e.code === DiscordjsErrorCodes.InteractionAlreadyReplied) {
+                alreadyReplied = true;
+            }
+            else {
+                context.logger.error('Failed to send interaction error reply', e);
+                throw e;
+            }
+        }
+    }
+    if (!alreadyReplied) {
+        return;
+    }
+    // If we already replied, edit the existing message to include the error
+    const oldReply = await interaction.fetchReply();
+    const flags = oldReply.flags.bitfield;
+    const errorMessage = buildMessage();
+    const oldReplyComponents = oldReply.components;
+    if (oldReply.flags.has(MessageFlags.IsComponentsV2)) {
+        await interaction.editReply({
+            flags,
+            components: [...oldReplyComponents, {
+                    type: ComponentType.TextDisplay,
+                    content: errorMessage,
+                }],
+        });
+        return;
+    }
+    const oldReplyContent = oldReply.content;
+    const messageSuffix = `\n\n${errorMessage}`;
+    let newContent = oldReplyContent + messageSuffix;
+    if (newContent.length > maximumMessageLength) {
+        newContent = oldReplyContent.substring(0, maximumMessageLength - messageSuffix.length - ellipsis.length) + ellipsis + messageSuffix;
+    }
+    await interaction.editReply({
+        flags,
+        content: newContent,
+    });
+};
+//# sourceMappingURL=handle-interaction-error.js.map

package/build/interactions/handle-interaction-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-interaction-error.js","sourceRoot":"","sources":["../../src/interactions/handle-interaction-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAEL,aAAa,EACb,cAAc,EACd,mBAAmB,GAGpB,MAAM,YAAY,CAAC;AAGpB,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAmBlC,MAAM,YAAY,GAAG,CAAC,WAAiC,EAAE,OAAgC,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAEzH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EACzC,WAA2D,EAC3D,OAAmC,EACnC,OAAsC,EACvB,EAAE;IACjB,MAAM,EAAE,YAAY,EAAE,KAAK,GAAG,YAAY,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;IAE1E,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC;QACjC,MAAM,WAAW,CAAC,OAAO,CAAC;YACxB;gBACE,KAAK,EAAE,EAAE;gBACT,IAAI,EAAE,YAAY,EAAE;aACrB;SACF,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,cAAc,GAAG,WAAW,CAAC,OAAO,CAAC;IACzC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,iBAAiB,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,WAAW,EAAE;gBACvB,OAAO,EAAE,YAAY,EAAE;gBACvB,KAAK,EAAE,YAAY,CAAC,SAAS;aAC9B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,cAAc,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,yBAAyB,EAAE,CAAC;gBAC5F,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAC;gBAClE,MAAM,CAAC,CAAC;YACV,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,wEAAwE;IACxE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,CAAC;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;IACtC,MAAM,YAAY,GAAG,YAAY,EAAE,CAAC;IACpC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC;IAC/C,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,CAAC;QACpD,MAAM,WAAW,CAAC,SAAS,CAAC;YAC1B,KAAK;YACL,UAAU,EAAE,CAAC,GAAG,kBAAkB,EAAE;oBAClC,IAAI,EAAE,aAAa,CAAC,WAAW;oBAC/B,OAAO,EAAE,YAAY;iBACtB,CAAC;SACH,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC;IACzC,MAAM,aAAa,GAAG,OAAO,YAAY,EAAE,CAAC;IAC5C,IAAI,UAAU,GAAG,eAAe,GAAG,aAAa,CAAC;IACjD,IAAI,UAAU,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QAC7C,UAAU,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,GAAG,aAAa,CAAC;IACtI,CAAC;IACD,MAAM,WAAW,CAAC,SAAS,CAAC;QAC1B,KAAK;QACL,OAAO,EAAE,UAAU;KACpB,CAAC,CAAC;AACL,CAAC,CAAC"}

package/build/interactions/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './custom-id.js';
+export * from './dispatch.js';
+export * from './router.js';
+export * from './handle-interaction-error.js';
+export * from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/build/interactions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interactions/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,eAAe,CAAC"}

package/build/interactions/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './custom-id.js';
+export * from './dispatch.js';
+export * from './router.js';
+export * from './handle-interaction-error.js';
+export * from './registry.js';
+//# sourceMappingURL=index.js.map

package/build/interactions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interactions/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,eAAe,CAAC"}

package/build/interactions/registry.d.ts

@@ -0,0 +1,32 @@
+import { BaseInteractionContext, BotChatInputCommand, BotContextMenuCommand, BotMessageComponent, BotModal } from './types.js';
+export type NamedChatInputCommand<Ctx extends BaseInteractionContext, Name extends string = string> = BotChatInputCommand<Ctx> & {
+    name: Name;
+};
+export type NamedContextMenuCommand<Ctx extends BaseInteractionContext, Name extends string = string> = BotContextMenuCommand<Ctx> & {
+    name: Name;
+};
+export type NamedComponent<Ctx extends BaseInteractionContext, Id extends string = string> = BotMessageComponent<Ctx> & {
+    id: Id;
+};
+export type NamedModal<Ctx extends BaseInteractionContext, Id extends string = string> = BotModal<Ctx> & {
+    id: Id;
+};
+export interface Registry<Name extends string, T> {
+    readonly byName: Record<Name, T>;
+    readonly names: readonly Name[];
+    isKnown(name: string): name is Name;
+}
+export declare function createChatInputCommandRegistry<const Commands extends readonly NamedChatInputCommand<any, string>[]>(commands: Commands): Registry<Commands[number]['name'], Commands[number]>;
+export declare function createContextMenuCommandRegistry<const Commands extends readonly NamedContextMenuCommand<any, string>[]>(commands: Commands): Registry<Commands[number]['name'], Commands[number]>;
+export declare function createComponentRegistry<const Components extends readonly NamedComponent<any, string>[]>(components: Components): Registry<Components[number]['id'], Components[number]>;
+export declare function createModalRegistry<const Modals extends readonly NamedModal<any, string>[]>(modals: Modals): Registry<Modals[number]['id'], Modals[number]>;
+/**
+ * Flattens every chat-input command's nested `.modal` map into a flat
+ * modal-id -> owning-command lookup (mirroring what a bot with Fantastick's
+ * shape hand-builds today), presented as a synthesized `Registry` so the
+ * existing `dispatchModal` can consume it directly via `.byName` without any
+ * changes to `dispatch.ts`. Each synthesized entry's `handle` closes over the
+ * owning command's `modal[modalId]`.
+ */
+export declare function flattenCommandModals<Ctx extends BaseInteractionContext>(chatInputRegistry: Registry<string, NamedChatInputCommand<Ctx, string>>): Registry<string, BotModal<Ctx>>;
+//# sourceMappingURL=registry.d.ts.map

package/build/interactions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/interactions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,qBAAqB,CAAC,GAAG,SAAS,sBAAsB,EAAE,IAAI,SAAS,MAAM,GAAG,MAAM,IAChG,mBAAmB,CAAC,GAAG,CAAC,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAE5C,MAAM,MAAM,uBAAuB,CAAC,GAAG,SAAS,sBAAsB,EAAE,IAAI,SAAS,MAAM,GAAG,MAAM,IAClG,qBAAqB,CAAC,GAAG,CAAC,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,cAAc,CAAC,GAAG,SAAS,sBAAsB,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,IACvF,mBAAmB,CAAC,GAAG,CAAC,GAAG;IAAE,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC;AAExC,MAAM,MAAM,UAAU,CAAC,GAAG,SAAS,sBAAsB,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,IACnF,QAAQ,CAAC,GAAG,CAAC,GAAG;IAAE,EAAE,EAAE,EAAE,CAAA;CAAE,CAAC;AAE7B,MAAM,WAAW,QAAQ,CAAC,IAAI,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,IAAI,CAAC;CACrC;AAmBD,wBAAgB,8BAA8B,CAE5C,KAAK,CAAC,QAAQ,SAAS,SAAS,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EACpE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAE1E;AAED,wBAAgB,gCAAgC,CAE9C,KAAK,CAAC,QAAQ,SAAS,SAAS,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EACtE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAE1E;AAED,wBAAgB,uBAAuB,CAErC,KAAK,CAAC,UAAU,SAAS,SAAS,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAC/D,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAEhF;AAED,wBAAgB,mBAAmB,CAEjC,KAAK,CAAC,MAAM,SAAS,SAAS,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EACvD,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,SAAS,sBAAsB,EACrE,iBAAiB,EAAE,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GACtE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAUjC"}

package/build/interactions/registry.js

@@ -0,0 +1,49 @@
+function buildRegistry(items, keyOf) {
+    const byName = {};
+    for (const item of items) {
+        const key = keyOf(item);
+        if (key in byName) {
+            throw new Error(`Duplicate registry key "${key}"`);
+        }
+        byName[key] = item;
+    }
+    const names = Object.keys(byName);
+    return {
+        byName,
+        names,
+        isKnown: (name) => name in byName,
+    };
+}
+export function createChatInputCommandRegistry(commands) {
+    return buildRegistry(commands, (c) => c.name);
+}
+export function createContextMenuCommandRegistry(commands) {
+    return buildRegistry(commands, (c) => c.name);
+}
+export function createComponentRegistry(components) {
+    return buildRegistry(components, (c) => c.id);
+}
+export function createModalRegistry(modals) {
+    return buildRegistry(modals, (m) => m.id);
+}
+/**
+ * Flattens every chat-input command's nested `.modal` map into a flat
+ * modal-id -> owning-command lookup (mirroring what a bot with Fantastick's
+ * shape hand-builds today), presented as a synthesized `Registry` so the
+ * existing `dispatchModal` can consume it directly via `.byName` without any
+ * changes to `dispatch.ts`. Each synthesized entry's `handle` closes over the
+ * owning command's `modal[modalId]`.
+ */
+export function flattenCommandModals(chatInputRegistry) {
+    const modals = [];
+    for (const command of chatInputRegistry.names.map((name) => chatInputRegistry.byName[name])) {
+        if (!command.modal)
+            continue;
+        for (const modalId of Object.keys(command.modal)) {
+            const handle = command.modal[modalId];
+            modals.push({ id: modalId, handle });
+        }
+    }
+    return buildRegistry(modals, (m) => m.id);
+}
+//# sourceMappingURL=registry.js.map

package/build/interactions/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/interactions/registry.ts"],"names":[],"mappings":"AA0BA,SAAS,aAAa,CAAyB,KAAmB,EAAE,KAAwB;IAC1F,MAAM,MAAM,GAAG,EAAqB,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,GAAG,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAW,CAAC;IAC5C,OAAO;QACL,MAAM;QACN,KAAK;QACL,OAAO,EAAE,CAAC,IAAY,EAAgB,EAAE,CAAC,IAAI,IAAI,MAAM;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAG5C,QAAkB;IAClB,OAAO,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAyD,CAAC;AACxG,CAAC;AAED,MAAM,UAAU,gCAAgC,CAG9C,QAAkB;IAClB,OAAO,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAyD,CAAC;AACxG,CAAC;AAED,MAAM,UAAU,uBAAuB,CAGrC,UAAsB;IACtB,OAAO,aAAa,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAA2D,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,mBAAmB,CAGjC,MAAc;IACd,OAAO,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAmD,CAAC;AAC9F,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,iBAAuE;IAEvE,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5F,IAAI,CAAC,OAAO,CAAC,KAAK;YAAE,SAAS;QAC7B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/build/interactions/router.d.ts

@@ -0,0 +1,28 @@
+import { Interaction } from 'discord.js';
+import { OnDispatchError } from './dispatch.js';
+import { BaseInteractionContext, BotChatInputCommand, BotContextMenuCommand, BotMessageComponent, BotModal } from './types.js';
+export interface InteractionRouterConfig<Ctx extends BaseInteractionContext> {
+    commands: Record<string, BotChatInputCommand<Ctx>>;
+    components?: Record<string, BotMessageComponent<Ctx>>;
+    modals?: Record<string, BotModal<Ctx>>;
+    contextMenuCommands?: Record<string, BotContextMenuCommand<Ctx>>;
+    customIdSeparator?: string;
+    /**
+     * Builds (or enriches) the per-interaction context. Runs before dispatch on
+     * every interaction type. This is the seam bots use to wire in things the
+     * router itself has no opinion about, e.g. a per-locale `t` function or a
+     * cached settings lookup.
+     */
+    buildContext: (interaction: Interaction, baseContext: Ctx) => Ctx | Promise<Ctx>;
+    onError: OnDispatchError<Ctx>;
+}
+/**
+ * A convenience dispatcher covering chat-input commands, autocomplete,
+ * message components, modal submits, and context-menu commands, wired
+ * through a single `Client#interactionCreate` listener. Bots that need
+ * finer-grained control (e.g. running telemetry after a command handles
+ * successfully) can call the individual `dispatch*` functions directly
+ * instead of this convenience wrapper.
+ */
+export declare function createInteractionRouter<Ctx extends BaseInteractionContext>(config: InteractionRouterConfig<Ctx>): (interaction: Interaction, baseContext: Ctx) => Promise<void>;
+//# sourceMappingURL=router.d.ts.map

package/build/interactions/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/interactions/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAML,eAAe,EAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,uBAAuB,CAAC,GAAG,SAAS,sBAAsB;IACzE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,YAAY,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACjF,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,SAAS,sBAAsB,EAAE,MAAM,EAAE,uBAAuB,CAAC,GAAG,CAAC,IAChG,aAAa,WAAW,EAAE,aAAa,GAAG,KAAG,OAAO,CAAC,IAAI,CAAC,CAqCzE"}

package/build/interactions/router.js

@@ -0,0 +1,48 @@
+import { InteractionType } from 'discord.js';
+import { dispatchAutocomplete, dispatchChatInputCommand, dispatchComponent, dispatchContextMenu, dispatchModal, } from './dispatch.js';
+/**
+ * A convenience dispatcher covering chat-input commands, autocomplete,
+ * message components, modal submits, and context-menu commands, wired
+ * through a single `Client#interactionCreate` listener. Bots that need
+ * finer-grained control (e.g. running telemetry after a command handles
+ * successfully) can call the individual `dispatch*` functions directly
+ * instead of this convenience wrapper.
+ */
+export function createInteractionRouter(config) {
+    return async (interaction, baseContext) => {
+        const context = await config.buildContext(interaction, baseContext);
+        if (interaction.isChatInputCommand()) {
+            await dispatchChatInputCommand(interaction, context, { commands: config.commands, onError: config.onError });
+            return;
+        }
+        if (interaction.isAutocomplete()) {
+            await dispatchAutocomplete(interaction, context, { commands: config.commands, onError: config.onError });
+            return;
+        }
+        if (interaction.isMessageComponent()) {
+            await dispatchComponent(interaction, context, {
+                components: config.components ?? {},
+                customIdSeparator: config.customIdSeparator,
+                onError: config.onError,
+            });
+            return;
+        }
+        if (interaction.isModalSubmit()) {
+            await dispatchModal(interaction, context, {
+                modals: config.modals ?? {},
+                customIdSeparator: config.customIdSeparator,
+                onError: config.onError,
+            });
+            return;
+        }
+        if (interaction.type === InteractionType.ApplicationCommand && (interaction.isUserContextMenuCommand() || interaction.isMessageContextMenuCommand())) {
+            await dispatchContextMenu(interaction, context, {
+                contextMenuCommands: config.contextMenuCommands ?? {},
+                onError: config.onError,
+            });
+            return;
+        }
+        throw new Error(`Unhandled interaction of type ${interaction.type}`);
+    };
+}
+//# sourceMappingURL=router.js.map

package/build/interactions/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/interactions/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,GAEd,MAAM,eAAe,CAAC;AAyBvB;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAqC,MAAoC;IAC9G,OAAO,KAAK,EAAE,WAAwB,EAAE,WAAgB,EAAiB,EAAE;QACzE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAEpE,IAAI,WAAW,CAAC,kBAAkB,EAAE,EAAE,CAAC;YACrC,MAAM,wBAAwB,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7G,OAAO;QACT,CAAC;QACD,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC;YACjC,MAAM,oBAAoB,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YACzG,OAAO;QACT,CAAC;QACD,IAAI,WAAW,CAAC,kBAAkB,EAAE,EAAE,CAAC;YACrC,MAAM,iBAAiB,CAAC,WAAW,EAAE,OAAO,EAAE;gBAC5C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;gBACnC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;gBAC3C,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,WAAW,CAAC,aAAa,EAAE,EAAE,CAAC;YAChC,MAAM,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE;gBACxC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;gBAC3B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;gBAC3C,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,WAAW,CAAC,IAAI,KAAK,eAAe,CAAC,kBAAkB,IAAI,CAAC,WAAW,CAAC,wBAAwB,EAAE,IAAI,WAAW,CAAC,2BAA2B,EAAE,CAAC,EAAE,CAAC;YACrJ,MAAM,mBAAmB,CAAC,WAAW,EAAE,OAAO,EAAE;gBAC9C,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,EAAE;gBACrD,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC;AACJ,CAAC"}

package/build/interactions/types.d.ts

@@ -0,0 +1,37 @@
+import { AutocompleteInteraction, ChatInputCommandInteraction, MessageComponentInteraction, ModalSubmitInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction } from 'discord.js';
+import { NestableLogger } from '../logger/types.js';
+export type BaseInteractionContext = {
+    logger: NestableLogger;
+};
+export type CommandHandler<Ctx> = (interaction: ChatInputCommandInteraction, context: Ctx) => void | Promise<void>;
+export type AutocompleteHandler<Ctx> = (interaction: AutocompleteInteraction, context: Ctx, optionName: string) => void | Promise<void>;
+export type ComponentHandler<Ctx> = (interaction: MessageComponentInteraction, context: Ctx, resourceId?: string) => void | Promise<void>;
+export type ModalHandler<Ctx> = (interaction: ModalSubmitInteraction, context: Ctx, resourceId?: string) => void | Promise<void>;
+export type ContextMenuHandler<Ctx> = (interaction: UserContextMenuCommandInteraction | MessageContextMenuCommandInteraction, context: Ctx) => void | Promise<void>;
+/**
+ * A command's wire definition (name, description, options, permissions) lives
+ * in the bot's commands.json file, not here - see `./schema` and
+ * `buildApplicationCommandsBody`. This is purely the handler side.
+ */
+export interface BotChatInputCommand<Ctx> {
+    /** When present, the command is only included in registration output if this returns true. */
+    registerCondition?: () => boolean;
+    handle: CommandHandler<Ctx>;
+    /** Keyed by the autocompleted option's name. */
+    autocomplete?: Record<string, AutocompleteHandler<Ctx>>;
+    /** Keyed by modal ID, for modals shown by this command. */
+    modal?: Record<string, ModalHandler<Ctx>>;
+}
+export interface BotMessageComponent<Ctx> {
+    handle: ComponentHandler<Ctx>;
+}
+export interface BotModal<Ctx> {
+    handle: ModalHandler<Ctx>;
+}
+/** A context-menu command's wire definition lives in the bot's commands.json file - see `./schema`. */
+export interface BotContextMenuCommand<Ctx> {
+    /** When present, the command is only included in registration output if this returns true. */
+    registerCondition?: () => boolean;
+    handle: ContextMenuHandler<Ctx>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/interactions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/interactions/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,2BAA2B,EAC3B,sBAAsB,EACtB,iCAAiC,EACjC,oCAAoC,EACrC,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,MAAM,sBAAsB,GAAG;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,cAAc,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,2BAA2B,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACnH,MAAM,MAAM,mBAAmB,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,uBAAuB,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACxI,MAAM,MAAM,gBAAgB,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,2BAA2B,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1I,MAAM,MAAM,YAAY,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,sBAAsB,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACjI,MAAM,MAAM,kBAAkB,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,iCAAiC,GAAG,oCAAoC,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpK;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,GAAG;IACtC,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC;IAC5B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB,CAAC,GAAG;IACtC,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ,CAAC,GAAG;IAC3B,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;CAC3B;AAED,uGAAuG;AACvG,MAAM,WAAW,qBAAqB,CAAC,GAAG;IACxC,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;IAClC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;CACjC"}

package/build/interactions/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/interactions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/interactions/types.ts"],"names":[],"mappings":""}

package/build/logger/create-logger.d.ts

@@ -0,0 +1,27 @@
+import pino from 'pino';
+import { LogMethod, NestableLogger } from './types.js';
+import { DiscordWebhookBatcherOptions } from './discord-webhook-batcher.js';
+export interface CreateLoggerOptions {
+    prefix?: string | string[];
+    mutedMethods?: LogMethod[] | Set<LogMethod>;
+    console?: {
+        /** @default true */
+        enabled?: boolean;
+        /** @default 'trace' */
+        level?: pino.Level;
+        /** @default true */
+        pretty?: boolean;
+    };
+    discordWebhook?: Omit<DiscordWebhookBatcherOptions, 'fetchImpl'> & {
+        /** @default 'warn' */
+        level?: pino.Level;
+    };
+}
+/**
+ * Builds a `NestableLogger` backed by a single root pino instance, configured with
+ * whichever transport targets (console + optional Discord webhook) are requested.
+ * `pino.transport()` — which spawns a worker thread — is invoked exactly once here,
+ * regardless of how many times the returned Logger is later `nest()`ed.
+ */
+export declare function createLogger(options?: CreateLoggerOptions): NestableLogger;
+//# sourceMappingURL=create-logger.d.ts.map

package/build/logger/create-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-logger.d.ts","sourceRoot":"","sources":["../../src/logger/create-logger.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE;QACR,oBAAoB;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,uBAAuB;QACvB,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;QACnB,oBAAoB;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,cAAc,CAAC,EAAE,IAAI,CAAC,4BAA4B,EAAE,WAAW,CAAC,GAAG;QACjE,sBAAsB;QACtB,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;KACpB,CAAC;CACH;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,cAAc,CAoB9E"}

package/build/logger/create-logger.js

@@ -0,0 +1,36 @@
+import { fileURLToPath } from 'node:url';
+import pino from 'pino';
+import { Logger } from './logger.js';
+import { PINO_PRETTY_OPTIONS } from './pino-pretty-options.js';
+const DISCORD_WEBHOOK_TRANSPORT_PATH = fileURLToPath(new URL('./discord-webhook-transport.js', import.meta.url));
+/**
+ * Builds a `NestableLogger` backed by a single root pino instance, configured with
+ * whichever transport targets (console + optional Discord webhook) are requested.
+ * `pino.transport()` — which spawns a worker thread — is invoked exactly once here,
+ * regardless of how many times the returned Logger is later `nest()`ed.
+ */
+export function createLogger(options = {}) {
+    const targets = [];
+    if (options.console?.enabled !== false) {
+        targets.push(options.console?.pretty === false
+            ? { target: 'pino/file', options: {}, level: options.console?.level ?? 'trace' }
+            : { target: 'pino-pretty', options: PINO_PRETTY_OPTIONS, level: options.console?.level ?? 'trace' });
+    }
+    if (options.discordWebhook) {
+        const { level, ...discordWebhookOptions } = options.discordWebhook;
+        targets.push({
+            target: DISCORD_WEBHOOK_TRANSPORT_PATH,
+            options: discordWebhookOptions,
+            level: level ?? 'warn',
+        });
+    }
+    const root = pino({ level: 'trace' }, pino.transport({ targets }));
+    return Logger.withPino(root, toArray(options.prefix ?? []), toSet(options.mutedMethods ?? []));
+}
+function toArray(value) {
+    return Array.isArray(value) ? value : [value];
+}
+function toSet(value) {
+    return Array.isArray(value) ? new Set(value) : value;
+}
+//# sourceMappingURL=create-logger.js.map

package/build/logger/create-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-logger.js","sourceRoot":"","sources":["../../src/logger/create-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAoB/D,MAAM,8BAA8B,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEjH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,MAAM,OAAO,GAAkC,EAAE,CAAC;IAElD,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK;YAC5C,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE;YAChF,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,MAAM,EAAE,KAAK,EAAE,GAAG,qBAAqB,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,8BAA8B;YACtC,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,KAAK,IAAI,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,OAAO,CAAC,KAAwB;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,KAAK,CAAC,KAAmC;IAChD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC"}

package/build/logger/dev-null-logger.d.ts

@@ -0,0 +1,11 @@
+import { NestableLogger } from './types.js';
+export declare class DevNullLogger implements NestableLogger {
+    debug(): void;
+    info(): void;
+    log(): void;
+    warn(): void;
+    error(): void;
+    nest(): NestableLogger;
+    muteMethods(): this;
+}
+//# sourceMappingURL=dev-null-logger.d.ts.map

package/build/logger/dev-null-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-null-logger.d.ts","sourceRoot":"","sources":["../../src/logger/dev-null-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,aAAc,YAAW,cAAc;IAClD,KAAK,IAAI,IAAI;IAGb,IAAI,IAAI,IAAI;IAGZ,GAAG,IAAI,IAAI;IAGX,IAAI,IAAI,IAAI;IAGZ,KAAK,IAAI,IAAI;IAGb,IAAI,IAAI,cAAc;IAItB,WAAW,IAAI,IAAI;CAGpB"}

package/build/logger/dev-null-logger.js

@@ -0,0 +1,19 @@
+export class DevNullLogger {
+    debug() {
+    }
+    info() {
+    }
+    log() {
+    }
+    warn() {
+    }
+    error() {
+    }
+    nest() {
+        return new DevNullLogger();
+    }
+    muteMethods() {
+        return this;
+    }
+}
+//# sourceMappingURL=dev-null-logger.js.map

package/build/logger/dev-null-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-null-logger.js","sourceRoot":"","sources":["../../src/logger/dev-null-logger.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACxB,KAAK;IACL,CAAC;IAED,IAAI;IACJ,CAAC;IAED,GAAG;IACH,CAAC;IAED,IAAI;IACJ,CAAC;IAED,KAAK;IACL,CAAC;IAED,IAAI;QACF,OAAO,IAAI,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/build/logger/discord-webhook-batcher.d.ts

@@ -0,0 +1,38 @@
+export interface DiscordWebhookBatcherOptions {
+    url: string;
+    username?: string;
+    avatarUrl?: string;
+    /** @default 20000 */
+    batchIntervalMs?: number;
+    /** @default 10 */
+    maxBatchSize?: number;
+    /** @default 500 */
+    maxQueueLength?: number;
+    /** Overridable for tests; defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+}
+export interface PinoLogRecord {
+    level: number;
+    time: number;
+    msg?: string;
+    prefixLabel?: string;
+    [key: string]: unknown;
+}
+/**
+ * Buffers pino log records and flushes them to a Discord webhook at a fixed
+ * interval, rather than one POST per log call. A fixed cadence gives a hard,
+ * by-construction cap on request volume (600_000 / batchIntervalMs POSTs per
+ * 10 minutes), safely under Discord's per-webhook rate limits without needing a
+ * separate token-bucket.
+ */
+export declare class DiscordWebhookBatcher {
+    private readonly options;
+    private queue;
+    private readonly timer;
+    private readonly fetchImpl;
+    constructor(options: DiscordWebhookBatcherOptions);
+    write(record: PinoLogRecord): void;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=discord-webhook-batcher.d.ts.map

package/build/logger/discord-webhook-batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-webhook-batcher.d.ts","sourceRoot":"","sources":["../../src/logger/discord-webhook-batcher.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiBD;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAOpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,KAAK,CAAuB;IAEpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAEvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAEZ,OAAO,EAAE,4BAA4B;IASlE,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAY5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/build/logger/discord-webhook-batcher.js

@@ -0,0 +1,87 @@
+const DEFAULT_BATCH_INTERVAL_MS = 20_000;
+const DEFAULT_MAX_BATCH_SIZE = 10;
+const DEFAULT_MAX_QUEUE_LENGTH = 500;
+const EMBED_DESCRIPTION_LIMIT = 4096;
+// Discord embed side-bar colors, keyed by pino's numeric levels (trace=10 ... fatal=60).
+const LEVEL_COLORS = {
+    10: 0x95a5a6,
+    20: 0x3498db,
+    30: 0x2ecc71,
+    40: 0xf1c40f,
+    50: 0xe74c3c,
+    60: 0x992d22,
+};
+/**
+ * Buffers pino log records and flushes them to a Discord webhook at a fixed
+ * interval, rather than one POST per log call. A fixed cadence gives a hard,
+ * by-construction cap on request volume (600_000 / batchIntervalMs POSTs per
+ * 10 minutes), safely under Discord's per-webhook rate limits without needing a
+ * separate token-bucket.
+ */
+export class DiscordWebhookBatcher {
+    options;
+    queue = [];
+    timer;
+    fetchImpl;
+    constructor(options) {
+        this.options = options;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        const intervalMs = options.batchIntervalMs ?? DEFAULT_BATCH_INTERVAL_MS;
+        this.timer = setInterval(() => {
+            void this.flush();
+        }, intervalMs);
+        this.timer.unref?.();
+    }
+    write(record) {
+        this.queue.push(record);
+        const maxQueueLength = this.options.maxQueueLength ?? DEFAULT_MAX_QUEUE_LENGTH;
+        if (this.queue.length > maxQueueLength) {
+            const dropped = this.queue.length - maxQueueLength;
+            this.queue.splice(0, dropped);
+            // Reported directly to console, never re-entering the webhook pipeline, to
+            // avoid a feedback loop during a log storm.
+            console.error(`[discord-webhook-transport] Queue exceeded ${maxQueueLength} entries; dropped ${dropped} oldest log record(s).`);
+        }
+    }
+    async flush() {
+        if (this.queue.length === 0)
+            return;
+        const maxBatchSize = this.options.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+        const batch = this.queue.splice(0, maxBatchSize);
+        const payload = {
+            username: this.options.username,
+            avatar_url: this.options.avatarUrl,
+            embeds: batch.map(buildEmbed),
+        };
+        try {
+            const response = await this.fetchImpl(this.options.url, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                console.error(`[discord-webhook-transport] Webhook POST failed with status ${response.status}`);
+            }
+        }
+        catch (e) {
+            console.error('[discord-webhook-transport] Webhook POST threw', e);
+        }
+    }
+    async close() {
+        clearInterval(this.timer);
+        await this.flush();
+    }
+}
+function buildEmbed(record) {
+    const prefixLabel = typeof record.prefixLabel === 'string' ? record.prefixLabel : '';
+    const msg = typeof record.msg === 'string' ? record.msg : '';
+    return {
+        description: truncate(`${prefixLabel}${msg}`, EMBED_DESCRIPTION_LIMIT),
+        color: LEVEL_COLORS[record.level] ?? LEVEL_COLORS[30],
+        timestamp: new Date(record.time ?? Date.now()).toISOString(),
+    };
+}
+function truncate(value, maxLength) {
+    return value.length > maxLength ? `${value.slice(0, maxLength - 1)}…` : value;
+}
+//# sourceMappingURL=discord-webhook-batcher.js.map

package/build/logger/discord-webhook-batcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-webhook-batcher.js","sourceRoot":"","sources":["../../src/logger/discord-webhook-batcher.ts"],"names":[],"mappings":"AAsBA,MAAM,yBAAyB,GAAG,MAAM,CAAC;AACzC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC,yFAAyF;AACzF,MAAM,YAAY,GAA2B;IAC3C,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;CACb,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,OAAO,qBAAqB;IAOH;IANrB,KAAK,GAAoB,EAAE,CAAC;IAEnB,KAAK,CAAiC;IAEtC,SAAS,CAAe;IAEzC,YAA6B,OAAqC;QAArC,YAAO,GAAP,OAAO,CAA8B;QAChE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAC;QACxE,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAqB;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;QAC/E,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC9B,2EAA2E;YAC3E,4CAA4C;YAC5C,OAAO,CAAC,KAAK,CAAC,8CAA8C,cAAc,qBAAqB,OAAO,wBAAwB,CAAC,CAAC;QAClI,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAC;QACzE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YAC/B,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;SAC9B,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBACtD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;aAC9B,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,+DAA+D,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,gDAAgD,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED,SAAS,UAAU,CAAC,MAAqB;IACvC,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,MAAM,GAAG,GAAG,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,GAAG,WAAW,GAAG,GAAG,EAAE,EAAE,uBAAuB,CAAC;QACtE,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,EAAE,CAAC;QACrD,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,SAAiB;IAChD,OAAO,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAChF,CAAC"}

package/build/logger/discord-webhook-transport.d.ts

@@ -0,0 +1,9 @@
+import build from 'pino-abstract-transport';
+import { DiscordWebhookBatcherOptions } from './discord-webhook-batcher.js';
+/**
+ * pino worker-thread transport entry point, loaded by `createLogger()` via an
+ * absolute file path (not a bare module specifier), since nothing outside this
+ * module needs to resolve it by name.
+ */
+export default function discordWebhookTransport(options: DiscordWebhookBatcherOptions): import("stream").Transform & build.OnUnknown;
+//# sourceMappingURL=discord-webhook-transport.d.ts.map

package/build/logger/discord-webhook-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-webhook-transport.d.ts","sourceRoot":"","sources":["../../src/logger/discord-webhook-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,yBAAyB,CAAC;AAC5C,OAAO,EAAyB,4BAA4B,EAAiB,MAAM,8BAA8B,CAAC;AAElH;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,OAAO,EAAE,4BAA4B,gDAepF"}

package/build/logger/discord-webhook-transport.js

@@ -0,0 +1,20 @@
+import build from 'pino-abstract-transport';
+import { DiscordWebhookBatcher } from './discord-webhook-batcher.js';
+/**
+ * pino worker-thread transport entry point, loaded by `createLogger()` via an
+ * absolute file path (not a bare module specifier), since nothing outside this
+ * module needs to resolve it by name.
+ */
+export default function discordWebhookTransport(options) {
+    const batcher = new DiscordWebhookBatcher(options);
+    return build(async (source) => {
+        for await (const record of source) {
+            batcher.write(record);
+        }
+    }, {
+        close: async () => {
+            await batcher.close();
+        },
+    });
+}
+//# sourceMappingURL=discord-webhook-transport.js.map

package/build/logger/discord-webhook-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-webhook-transport.js","sourceRoot":"","sources":["../../src/logger/discord-webhook-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,yBAAyB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAA+C,MAAM,8BAA8B,CAAC;AAElH;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,OAAqC;IACnF,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAEnD,OAAO,KAAK,CACV,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,MAAuB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,EACD;QACE,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;KACF,CACF,CAAC;AACJ,CAAC"}