@seedcord/core 0.1.0 → 0.1.1-next.0

package/dist/slashRouteLeaves-nfxOAM7Q.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"slashRouteLeaves-nfxOAM7Q.cjs","names":["SlashCommandBuilder"],"sources":["../src/commands/slashRouteLeaves.ts"],"sourcesContent":["import { SlashCommandBuilder } from '@discordjs/builders';\nimport { routeLeavesOf } from '@seedcord/utils/internal';\n\nimport type { ContextMenuCommandBuilder } from '@discordjs/builders';\n\n/**\n * Collects the route keys of every executable slash leaf across a set of command builders, deduplicated\n * because the same builder appears once per guild. The keys come from the same {@link routeLeavesOf} that\n * `seedcord codegen` reads, so the boot-time check compares against the generated registry's keys.\n *\n * @internal\n */\nexport function slashRouteLeaves(commands: Iterable<SlashCommandBuilder | ContextMenuCommandBuilder>): Set<string> {\n    const leaves = new Set<string>();\n    for (const command of commands) {\n        if (!(command instanceof SlashCommandBuilder)) continue;\n        for (const leaf of routeLeavesOf(command.toJSON())) leaves.add(leaf.route);\n    }\n    return leaves;\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,iBAAiB,UAAkF;CAC/G,MAAM,yBAAS,IAAI,IAAY;CAC/B,KAAK,MAAM,WAAW,UAAU;EAC5B,IAAI,EAAE,mBAAmBA,0CAAsB;EAC/C,KAAK,MAAM,oDAAsB,QAAQ,OAAO,CAAC,GAAG,OAAO,IAAI,KAAK,KAAK;CAC7E;CACA,OAAO;AACX"}
+{"version":3,"file":"slashRouteLeaves-nfxOAM7Q.cjs","names":["SlashCommandBuilder","routeLeavesOf"],"sources":["../src/commands/slashRouteLeaves.ts"],"sourcesContent":["import { SlashCommandBuilder } from '@discordjs/builders';\nimport { routeLeavesOf } from '@seedcord/utils/internal';\n\nimport type { ContextMenuCommandBuilder } from '@discordjs/builders';\n\n/**\n * Collects the route keys of every executable slash leaf across a set of command builders, deduplicated\n * because the same builder appears once per guild. The keys come from the same {@link routeLeavesOf} that\n * `seedcord codegen` reads, so the boot-time check compares against the generated registry's keys.\n *\n * @internal\n */\nexport function slashRouteLeaves(commands: Iterable<SlashCommandBuilder | ContextMenuCommandBuilder>): Set<string> {\n    const leaves = new Set<string>();\n    for (const command of commands) {\n        if (!(command instanceof SlashCommandBuilder)) continue;\n        for (const leaf of routeLeavesOf(command.toJSON())) leaves.add(leaf.route);\n    }\n    return leaves;\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,iBAAiB,UAAkF;CAC/G,MAAM,yBAAS,IAAI,IAAY;CAC/B,KAAK,MAAM,WAAW,UAAU;EAC5B,IAAI,EAAE,mBAAmBA,0CAAsB;EAC/C,KAAK,MAAM,YAAQC,wCAAc,QAAQ,OAAO,CAAC,GAAG,OAAO,IAAI,KAAK,KAAK;CAC7E;CACA,OAAO;AACX"}

package/dist/{subscribers-CojcCgj1.cjs → subscribers-CDbep0RH.cjs}

@@ -1,4 +1,30 @@
-const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
 const require_publishDefault = require('./publishDefault-CVlwYUS5.cjs');
 require("reflect-metadata");
 let _seedcord_logger = require("@seedcord/logger");
@@ -8,7 +34,7 @@ let _seedcord_errors_internal = require("@seedcord/errors/internal");
 let _seedcord_utils = require("@seedcord/utils");
 let _seedcord_event_emitter = require("@seedcord/event-emitter");
 let chalk = require("chalk");
-chalk = require_rolldown_runtime.__toESM(chalk, 1);
+chalk = __toESM(chalk, 1);
 let envapt = require("envapt");
 let _discordjs_rest = require("@discordjs/rest");
 
@@ -251,7 +277,7 @@ function WebhookUrl(envKey) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.135.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -508,10 +534,16 @@ Object.defineProperty(exports, 'WebhookUrl', {
     return WebhookUrl;
   }
 });
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});
 Object.defineProperty(exports, 'registrationFor', {
   enumerable: true,
   get: function () {
     return registrationFor;
   }
 });
-//# sourceMappingURL=subscribers-CojcCgj1.cjs.map
+//# sourceMappingURL=subscribers-CDbep0RH.cjs.map

package/dist/subscribers-CDbep0RH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers-CDbep0RH.cjs","names":["Logger","filterCirculars","stripAnsi","BuilderComponent","SeparatorSpacingSize","REST","SeedcordError","SeedcordErrorCode","Routes","DiscordAPIError","sendFlags","WebhookUrlMetadataKey","SeedcordError","SeedcordErrorCode","Envapter","Converters","SubscribeMetadataKey","WebhookUrlMetadataKey","BuilderComponent","stripAnsi","BuilderComponent","DiscordAPIError","timestampFromSnowflake","TypedEventEmitter","Logger","paint","SeedcordError","SeedcordErrorCode","PublishDefault","SubscribeMetadataKey"],"sources":["../src/subscribers/Subscriber.ts","../src/subscribers/bases/webhookHelpers.ts","../src/subscribers/bases/WebhookSender.ts","../src/subscribers/bases/WebhookLog.ts","../src/subscribers/decorators/Subscribe.ts","../src/subscribers/decorators/WebhookUrl.ts","../src/subscribers/default/HandledException.ts","../src/subscribers/default/UnknownException.ts","../src/subscribers/Bus.ts"],"sourcesContent":["import { Logger } from '@seedcord/logger';\n\nimport type { SubscriptionKey, AllSubscriptions } from './types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\n\n/**\n * Abstract base class for handling application subscribers.\n *\n * Provides type-safe access to subscribers data and the core framework instance.\n * Extend this class to create custom subscriber handlers.\n *\n * @typeParam KeyOfSubscribers - The specific subscriber type this handler processes\n * @typeParam TCore - The transport's Core\n */\nexport abstract class Subscriber<KeyOfSubscribers extends SubscriptionKey, TCore extends CoreBase> {\n    protected readonly logger: Logger;\n\n    /**\n     * Instantiates the subscriber with event data and core.\n     *\n     * @param data - The subscriber event data\n     * @param core - The core framework instance\n     */\n    constructor(\n        protected readonly data: AllSubscriptions[KeyOfSubscribers],\n        protected readonly core: TCore\n    ) {\n        this.logger = new Logger(this.constructor.name, { channel: 'subscribers' });\n    }\n\n    /**\n     * Executes the subscriber handler logic.\n     */\n    abstract execute(): Promise<void>;\n}\n","import { filterCirculars, stripAnsi } from '@seedcord/utils';\nimport { SeparatorSpacingSize } from 'discord-api-types/v10';\n\nimport { BuilderComponent } from '@components/Component';\n\nimport type { WebhookFile } from './WebhookSender';\n\nconst DISCORD_WEBHOOK_REGEX = new RegExp(\n    String.raw`^https?:\\/\\/(?:canary\\.|ptb\\.)?discord(?:app)?\\.com\\/api\\/webhooks\\/\\d+\\/[\\w$-]+$`\n);\n\nexport function isDiscordWebhookUrl(value: string): boolean {\n    return URL.canParse(value) && DISCORD_WEBHOOK_REGEX.test(value);\n}\n\nexport function jsonAttachment(name: string, description: string, data: unknown): WebhookFile {\n    const content = filterCirculars(data);\n    return { name, description, data: new TextEncoder().encode(JSON.stringify(content, undefined, 2)) };\n}\n\n// the report renders inside a ``` fence, so break any triple-backtick run to keep it from closing early\nexport function neutralizeFences(text: string): string {\n    return text.replaceAll('```', '`​`​`');\n}\n\n/** An error's stack with its direct cause appended (one level), ANSI-stripped for the webhook payload. */\nexport function errorReport(error: Error): string {\n    let report = error.stack ?? `${error.name}: ${error.message}`;\n    if (Error.isError(error.cause)) {\n        const cause = error.cause.stack ?? `${error.cause.name}: ${error.cause.message}`;\n        report += `\\n\\nCaused by:\\n${cause}`;\n    }\n    const stripped = neutralizeFences(stripAnsi(report));\n    // eslint-disable-next-line no-magic-numbers\n    return stripped.length > 1800 ? `${stripped.slice(0, 1799)}…` : stripped;\n}\n\nexport class WebhookSeparator extends BuilderComponent<'separator'> {\n    constructor() {\n        super('separator');\n        this.instance.setSpacing(SeparatorSpacingSize.Small).setDivider(true);\n    }\n}\n","import { DiscordAPIError, REST } from '@discordjs/rest';\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Routes } from 'discord-api-types/v10';\n\nimport type { ReplyFile } from '@seedcord/types';\nimport type { APIMessageTopLevelComponent } from 'discord-api-types/v10';\n\nconst HTTP_NOT_FOUND = 404;\nconst HTTP_UNAUTHORIZED = 401;\n\n/** A file attached to a webhook report. */\nexport interface WebhookFile extends ReplyFile {\n    readonly description: string;\n}\n\n/** The payload {@link WebhookSender.send} posts. */\nexport interface WebhookSendOptions {\n    flags: number;\n    username: string;\n    components: readonly { toJSON(): APIMessageTopLevelComponent }[];\n    files?: readonly WebhookFile[] | undefined;\n}\n\n/**\n * Sends component messages to a Discord webhook through `@discordjs/rest`.\n *\n * @throws A `SeedcordError` when the url does not carry a webhook id and token.\n */\nexport class WebhookSender {\n    private readonly rest = new REST();\n    private readonly route: `/${string}`;\n\n    constructor(url: string) {\n        const match = /\\/webhooks\\/(\\d+)\\/([\\w$-]+)$/.exec(url);\n        // the url is a secret, so the error message never carries it\n        if (!match?.[1] || !match[2]) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookUrlInvalid, ['The url']);\n        this.route = Routes.webhook(match[1], match[2]);\n    }\n\n    /**\n     * Fetches the webhook object, sending no message. Returns `missing` on a 404 or 401 from\n     * Discord and `unreachable` on any other failure.\n     */\n    async verify(): Promise<'ok' | 'missing' | 'unreachable'> {\n        try {\n            await this.rest.get(this.route, { auth: false });\n            return 'ok';\n        } catch (error) {\n            const gone =\n                error instanceof DiscordAPIError &&\n                (error.status === HTTP_NOT_FOUND || error.status === HTTP_UNAUTHORIZED);\n            return gone ? 'missing' : 'unreachable';\n        }\n    }\n\n    async send(options: WebhookSendOptions): Promise<void> {\n        const { flags, username, components, files } = options;\n        await this.rest.post(this.route, {\n            auth: false,\n            // with_components=true makes discord accept a components-v2 payload. wait=true makes it\n            // return payload errors in the response\n            query: new URLSearchParams({ with_components: 'true', wait: 'true' }),\n            body: {\n                flags,\n                username,\n                components: components.map((component) => component.toJSON()),\n                ...(files?.length && {\n                    attachments: files.map((file, id) => ({ id, filename: file.name, description: file.description }))\n                })\n            },\n            ...(files?.length && { files: files.map((file) => ({ name: file.name, data: file.data })) })\n        });\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport chalk from 'chalk';\nimport { Converters, Envapter } from 'envapt';\n\nimport { sendFlags } from '@reply/flags';\nimport { WebhookUrlMetadataKey } from '@src/metadataKeys';\n\nimport { Subscriber } from '../Subscriber';\nimport { isDiscordWebhookUrl } from './webhookHelpers';\nimport { WebhookSender } from './WebhookSender';\n\nimport type { WebhookFile } from './WebhookSender';\nimport type { SubscriptionKey } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { APIMessageTopLevelComponent } from 'discord-api-types/v10';\n\n/**\n * The content a reporter returns from {@link WebhookLog.report}.\n */\nexport interface WebhookReport {\n    /** Shown as the webhook message author. Defaults to the reporter's class name. */\n    username?: string;\n    components: readonly { toJSON(): APIMessageTopLevelComponent }[];\n    files?: readonly WebhookFile[] | undefined;\n}\n\n/**\n * Base class for subscribers that deliver their event to a Discord webhook.\n *\n * Declare the url's environment variable with `@WebhookUrl` and implement {@link report}. Url\n * resolution, validation, sender reuse, and sending run in the base. When the variable is unset\n * the reporter is skipped at registration with a boot warning.\n *\n * @typeParam KeyOfSubscribers - The subscription key this reporter receives\n * @typeParam TCore - The transport's Core\n */\nexport abstract class WebhookLog<KeyOfSubscribers extends SubscriptionKey, TCore extends CoreBase> extends Subscriber<\n    KeyOfSubscribers,\n    TCore\n> {\n    private static readonly senders = new Map<string, WebhookSender>();\n\n    /** Builds the message for one published event. */\n    abstract report(): WebhookReport | Promise<WebhookReport>;\n\n    async execute(): Promise<void> {\n        const url = WebhookLog.urlOf(WebhookLog.envKeyOf(this.constructor));\n        if (url === null) {\n            // a server host skips url-less reporters at registration, an edge host registers lazily and reaches this branch\n            this.logger.warn(`${chalk.bold(this.constructor.name)} has no webhook url set, this reporter is disabled`);\n            return;\n        }\n\n        const { username, components, files } = await this.report();\n        try {\n            await WebhookLog.senderFor(url).send({\n                flags: sendFlags({ ephemeral: false }),\n                username: username ?? this.constructor.name,\n                components,\n                files\n            });\n        } catch (error) {\n            this.logger.error('Failed to send webhook report', error);\n        }\n    }\n\n    /** @internal */\n    static senderFor(url: string): WebhookSender {\n        let sender = WebhookLog.senders.get(url);\n        if (!sender) {\n            sender = new WebhookSender(url);\n            WebhookLog.senders.set(url, sender);\n        }\n        return sender;\n    }\n\n    /** @internal */\n    static envKeyOf(ctor: NewableFunction): string {\n        const envKey = Reflect.getMetadata(WebhookUrlMetadataKey, ctor) as string | undefined;\n        if (!envKey) throw new SeedcordError(SeedcordErrorCode.DecoratorWebhookUrlMissing, [ctor.name]);\n        return envKey;\n    }\n\n    /** @internal Returns null when the env var is unset, throws when set but malformed. */\n    static urlOf(envKey: string): string | null {\n        if (!Envapter.has(envKey)) return null;\n        const raw = Envapter.getRequired(envKey, Converters.String).trim();\n        if (raw === '') return null;\n        if (!isDiscordWebhookUrl(raw)) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookUrlInvalid, [envKey]);\n        return raw;\n    }\n}\n","// the default reporters are decorated at Bus module load, before any entry's own polyfill import runs\nimport 'reflect-metadata';\n\nimport { SubscribeMetadataKey } from '@src/metadataKeys';\n\nimport type { Subscriber } from '../Subscriber';\nimport type { SubscriptionKey } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { EventFrequency } from '@seedcord/types';\nimport type { Constructor } from 'type-fest';\n\n/**\n * Options accepted by the `@Subscribe` decorator.\n */\nexport interface SubscribeOptions {\n    /**\n     * Frequency: `'once'` or `'on'`.\n     *\n     * @defaultValue `'on'`\n     */\n    readonly frequency?: EventFrequency | undefined;\n}\n\n/** @internal */\nexport interface SubscribeMetadataEntry {\n    readonly subscriber: SubscriptionKey;\n    readonly frequency?: EventFrequency | undefined;\n}\n\n/**\n * Registers a subscriber handler class with a specific subscriber event.\n *\n * Associates the decorated class with a subscriber event type for automatic\n * registration and execution when the subscriber is emitted.\n *\n * @typeParam TSubscriber - The subscriber event name to register for\n * @param subscriber - The subscriber event name to register for\n * @param options - Options to configure the subscriber handler registration.\n * @decorator\n * @example\n * ```typescript\n * \\@Subscribe('userJoin')\n * class WelcomeHandler extends Subscriber<'userJoin'> {\n *   async execute() {\n *     // Handle user join event\n *   }\n * }\n * ```\n * @example\n * ```ts\n * \\@Subscribe('userJoin', { frequency: 'once' })\n * // or\n * \\@Subscribe('userJoin')\n * ```\n */\nexport function Subscribe<TSubscriber extends SubscriptionKey>(subscriber: TSubscriber, options?: SubscribeOptions) {\n    return function <HandlerCtor extends Constructor<Subscriber<TSubscriber, CoreBase>>>(\n        constructor: HandlerCtor\n    ): void {\n        const meta: SubscribeMetadataEntry = {\n            subscriber,\n            frequency: options?.frequency\n        };\n\n        Reflect.defineMetadata(SubscribeMetadataKey, meta, constructor);\n    };\n}\n","import 'reflect-metadata';\n\nimport { WebhookUrlMetadataKey } from '@src/metadataKeys';\n\nimport type { WebhookLog } from '../bases/WebhookLog';\nimport type { SubscriptionKey } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { Constructor } from 'type-fest';\n\n/**\n * Declares the environment variable a {@link WebhookLog} reporter reads its webhook url from.\n *\n * An unset variable disables the reporter with a boot warning. A set but malformed value throws\n * at boot.\n *\n * @param envKey - The environment variable name holding the webhook url\n * @decorator\n * @example\n * ```ts\n * \\@Subscribe('memberBanned')\n * \\@WebhookUrl('BAN_LOG_WEBHOOK_URL')\n * class BanLog extends WebhookLog<'memberBanned'> {\n *   report() {\n *     return { components: [new BanCard(this.data).component] };\n *   }\n * }\n * ```\n */\nexport function WebhookUrl(envKey: string) {\n    return function <HandlerCtor extends Constructor<WebhookLog<SubscriptionKey, CoreBase>>>(\n        constructor: HandlerCtor\n    ): void {\n        Reflect.defineMetadata(WebhookUrlMetadataKey, envKey, constructor);\n    };\n}\n","import { stripAnsi } from '@seedcord/utils';\n\nimport { BuilderComponent } from '@components/Component';\n\nimport { jsonAttachment, neutralizeFences, WebhookSeparator } from '../bases/webhookHelpers';\nimport { WebhookLog } from '../bases/WebhookLog';\nimport { Subscribe } from '../decorators/Subscribe';\nimport { WebhookUrl } from '../decorators/WebhookUrl';\n\nimport type { WebhookReport } from '../bases/WebhookLog';\nimport type { AllSubscriptions, FaultSource } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { Notice } from '@stops/Notice';\n\n/**\n * Default subscriber that delivers a reported `Notice` (`report: true`) to a webhook with the\n * denial, the fault source, the threaded uuid, the cause stack, and the raw source as a JSON\n * attachment. The controller boundary throttles identical faults before they reach the bus.\n *\n * Reads its webhook url from HANDLED_EXCEPTION_WEBHOOK_URL. Unset, the reporter is disabled with\n * a boot warning.\n */\n@Subscribe('handledException')\n@WebhookUrl('HANDLED_EXCEPTION_WEBHOOK_URL')\nexport class HandledException extends WebhookLog<'handledException', CoreBase> {\n    report(): WebhookReport {\n        return {\n            username: 'Handled Exception',\n            components: [new HandledExceptionContainer(this.data).component],\n            files: [jsonAttachment('source.json', 'The raw source the fault came from', this.data.source.raw)]\n        };\n    }\n}\n\nclass HandledExceptionContainer extends BuilderComponent<'container'> {\n    constructor(data: AllSubscriptions['handledException']) {\n        super('container');\n\n        const { denial, uuid, source } = data;\n\n        this.instance\n            .addTextDisplayComponents((text) => text.setContent(faultSummary(denial, source)))\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) =>\n                text.setContent(`### UUID \\`${uuid}\\`\\n\\`\\`\\`${neutralizeFences(causeStack(denial))}\\`\\`\\``)\n            )\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) => text.setContent('### Source'))\n            .addFileComponents((file) => file.setURL('attachment://source.json'));\n    }\n}\n\nfunction faultSummary(denial: Notice, source: FaultSource): string {\n    // name and message carry chalk, the webhook payload renders them raw\n    const head = stripAnsi(`### A handled fault was reported: \\`${denial.name}\\`\\n**Message:** ${denial.message}\\n`);\n    if (source.kind === 'event') {\n        return (\n            `${head}**Event:** ${source.eventName}\\n` +\n            `**Handler:** ${source.handler}\\n` +\n            `**User ID:** \\`${source.userId ?? 'n/a'}\\`\\n` +\n            `**Guild ID:** \\`${source.guildId ?? 'n/a'}\\`\\n` +\n            `**Channel ID:** \\`${source.channelId ?? 'n/a'}\\``\n        );\n    }\n    return (\n        `${head}**Kind:** ${source.interactionKind}\\n` +\n        `**Command:** ${source.command ?? 'n/a'}\\n` +\n        `**CustomId:** ${source.customId ?? 'n/a'}\\n` +\n        `**User ID:** \\`${source.userId}\\`\\n` +\n        `**Guild ID:** \\`${source.guildId ?? 'n/a'}\\`\\n` +\n        `**Channel ID:** \\`${source.channelId ?? 'n/a'}\\`\\n` +\n        `**Interaction ID:** \\`${source.interactionId}\\``\n    );\n}\n\n// every cause shape returns a string, building the report never throws on a bigint or circular cause\nfunction causeStack(denial: Notice): string {\n    const { cause } = denial;\n    if (Error.isError(cause)) return stripAnsi(cause.stack ?? cause.message);\n    if (typeof cause === 'string') return stripAnsi(cause);\n    if (typeof cause === 'bigint' || typeof cause === 'symbol' || typeof cause === 'function') return cause.toString();\n    if (cause !== undefined) {\n        try {\n            return JSON.stringify(cause);\n        } catch {\n            return '[unserializable cause]';\n        }\n    }\n    return stripAnsi(denial.stack ?? 'No cause recorded.');\n}\n","import { DiscordAPIError } from '@discordjs/rest';\nimport { timestampFromSnowflake } from '@seedcord/utils';\n\nimport { BuilderComponent } from '@components/Component';\n\nimport { errorReport, jsonAttachment, WebhookSeparator } from '../bases/webhookHelpers';\nimport { WebhookLog } from '../bases/WebhookLog';\nimport { Subscribe } from '../decorators/Subscribe';\nimport { WebhookUrl } from '../decorators/WebhookUrl';\n\nimport type { WebhookReport } from '../bases/WebhookLog';\nimport type { AllSubscriptions } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\n\n/**\n * Default subscriber that reports an unhandled exception to a webhook: the stack trace, the guild\n * and user, a tracking uuid, interaction timestamps when available, and the error metadata as a\n * JSON attachment.\n *\n * Reads its webhook url from UNKNOWN_EXCEPTION_WEBHOOK_URL. Unset, the reporter is disabled with\n * a boot warning.\n */\n@Subscribe('unknownException')\n@WebhookUrl('UNKNOWN_EXCEPTION_WEBHOOK_URL')\nexport class UnknownException extends WebhookLog<'unknownException', CoreBase> {\n    report(): WebhookReport {\n        const { metadata } = this.data;\n        return {\n            username: 'Unknown Exception',\n            components: [new UnhandledErrorContainer(this.data).component],\n            files: metadata\n                ? [jsonAttachment('metadata.json', 'Metadata associated with the error', metadata)]\n                : undefined\n        };\n    }\n}\n\nclass UnhandledErrorContainer extends BuilderComponent<'container'> {\n    constructor(data: AllSubscriptions['unknownException']) {\n        super('container');\n\n        const { uuid, error, guild, user, metadata } = data;\n\n        this.instance\n            .addTextDisplayComponents((text) =>\n                text.setContent(\n                    `### An unknown exception was thrown\\n` +\n                        `**Guild ID:** \\`${guild?.id ?? 'Not used in a guild'}\\`\\n` +\n                        `**Guild Name:** ${guild?.name ?? 'Not used in a guild'}\\n` +\n                        `**User ID:** \\`${user?.id ?? 'Missing user info'}\\`\\n` +\n                        `**Username:** ${user?.username ?? 'Missing user info'}\\n`\n                )\n            )\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) =>\n                text.setContent(`### UUID \\`${uuid}\\`\\n\\`\\`\\`${errorReport(error)}\\`\\`\\``)\n            );\n\n        this.addTimestampsIfAvailable(error);\n        this.addMetadataIfAvailable(metadata);\n    }\n\n    private addTimestampsIfAvailable(error: Error): void {\n        if (!(error instanceof DiscordAPIError)) return;\n\n        const now = Date.now();\n\n        const snowflake = error.url.match(/\\/interactions\\/(\\d+)\\//)?.[1];\n        if (!snowflake) return undefined;\n\n        const interactionTs = timestampFromSnowflake(snowflake);\n\n        const diff = now - interactionTs;\n        const seconds = Math.floor(diff / 1000);\n        const millis = diff % 1000;\n\n        this.instance\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) =>\n                text.setContent(\n                    `### Timestamps\\n` +\n                        `- **\\`Interaction sent\\` :** ${new Date(interactionTs).toISOString()} (${interactionTs})\\n` +\n                        `- **\\`Error logged    \\` :** ${new Date(now).toISOString()} (${now})\\n` +\n                        `- **\\`Offset          \\` :** ${seconds}s ${millis}ms`\n                )\n            );\n    }\n\n    private addMetadataIfAvailable(metadata: unknown): void {\n        if (!metadata) return;\n\n        this.instance\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) => text.setContent('### Metadata'))\n            .addFileComponents((file) => file.setURL('attachment://metadata.json'));\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { TypedEventEmitter } from '@seedcord/event-emitter';\nimport { Logger, paint } from '@seedcord/logger';\nimport chalk from 'chalk';\n\nimport { SubscribeMetadataKey } from '@src/metadataKeys';\n\nimport { WebhookLog } from './bases/WebhookLog';\nimport { HandledException } from './default/HandledException';\nimport { UnknownException } from './default/UnknownException';\nimport { PublishDefault } from './publishDefault';\n\nimport type { SubscribeMetadataEntry } from './decorators/Subscribe';\nimport type { Subscriber } from './Subscriber';\nimport type {\n    AllSubscriptions,\n    DefaultSubscriptions,\n    PublishableKey,\n    SubscriptionKey,\n    SubscriptionTuples\n} from './types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { EventFrequency } from '@seedcord/types';\n\n/**\n * A subscriber class as the Bus stores it. Both parameters are `never` because construct-signature\n * parameters check contravariantly, and a concrete subscriber narrows each to its own payload and\n * transport `Core`. One cast at dispatch restores both.\n *\n * @internal\n */\nexport type StoredSubscriberCtor = new (data: never, core: never) => Subscriber<SubscriptionKey, CoreBase>;\n\n/**\n * One registration. `resolve` is lazy so an edge host registers from a manifest row without\n * importing the module until that key first publishes.\n *\n * @internal\n */\nexport interface SubscriberRegistration {\n    readonly keys: readonly SubscriptionKey[];\n    readonly frequency: EventFrequency;\n    readonly resolve: () => StoredSubscriberCtor | Promise<StoredSubscriberCtor>;\n    /** The resolved class. A server-host registration carries it from the start, a lazy one fills it on first resolve. */\n    ctor?: StoredSubscriberCtor | undefined;\n}\n\n/**\n * Registers and dispatches subscribers. Subscribers run on a programmatic or framework publish.\n * Accessed via `core.bus`. Do not construct it directly.\n */\nexport class Bus extends TypedEventEmitter<SubscriptionTuples> {\n    /** @internal */\n    public readonly logger = new Logger('Subscribers', { channel: 'subscribers' });\n\n    private readonly subscribersMap = new Map<SubscriptionKey, SubscriberRegistration[]>();\n    private readonly executedOnce = new Set<SubscriberRegistration>();\n    // url -> env keys, filled as reporters register and read once by verifyWebhooks\n    private readonly webhookProbes = new Map<string, string[]>();\n\n    constructor(protected core: CoreBase) {\n        super();\n    }\n\n    /**\n     * Registers the two shipped webhook reporters. The host calls this during startup, keeping the\n     * url validation inside `start()` where a failure can still release the singleton guard.\n     *\n     * @internal\n     */\n    public registerDefaults(): void {\n        this.register(registrationFor(UnknownException));\n        this.register(registrationFor(HandledException));\n    }\n\n    /** @internal */\n    public register(registration: SubscriberRegistration): void {\n        // a url-less reporter never registers, so a publish on its key does not reach a disabled sender\n        if (registration.ctor && !this.probeWebhook(registration.ctor)) return;\n\n        for (const key of registration.keys) {\n            let registrations = this.subscribersMap.get(key);\n            if (!registrations) {\n                registrations = [];\n                this.subscribersMap.set(key, registrations);\n            }\n            registrations.push(registration);\n        }\n    }\n\n    /** @internal */\n    public unregister(ctor: StoredSubscriberCtor, keys?: readonly SubscriptionKey[]): void {\n        for (const key of keys ?? [...this.subscribersMap.keys()]) {\n            const registrations = this.subscribersMap.get(key);\n            if (!registrations) continue;\n            const index = registrations.findIndex((entry) => entry.ctor === ctor);\n            if (index !== -1) registrations.splice(index, 1);\n        }\n        // registration identity carries the once state, so a restored subscriber runs again after a rollback\n    }\n\n    /** @internal */\n    public get registeredCount(): number {\n        return [...this.subscribersMap.values()].reduce((total, entries) => total + entries.length, 0);\n    }\n\n    /** @internal Only eagerly registered reporters are probed, which is every server-host one. */\n    public async verifyWebhooks(): Promise<void> {\n        const missing: string[] = [];\n        await Promise.all(\n            [...this.webhookProbes].map(async ([url, envKeys]) => {\n                const result = await WebhookLog.senderFor(url).verify();\n                if (result === 'missing') missing.push(...envKeys);\n                else if (result === 'unreachable')\n                    this.logger.warn(`could not verify webhook at ${paint.sky.bold(envKeys.join(', '))}`);\n            })\n        );\n        // initial boot reports all missing webhooks\n        if (missing.length > 0) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookNotFound, [missing.join(', ')]);\n    }\n\n    /** Returns whether the class should register. */\n    private probeWebhook(ctor: StoredSubscriberCtor): boolean {\n        if (!(ctor.prototype instanceof WebhookLog)) return true;\n\n        const envKey = WebhookLog.envKeyOf(ctor);\n        const url = WebhookLog.urlOf(envKey);\n        if (url === null) {\n            this.logger.warn(`${chalk.bold(ctor.name)} disabled, ${paint.sky.bold(envKey)} is not set`);\n            return false;\n        }\n        const envKeys = this.webhookProbes.get(url) ?? [];\n        if (!envKeys.includes(envKey)) envKeys.push(envKey);\n        this.webhookProbes.set(url, envKeys);\n        return true;\n    }\n\n    /**\n     * Publishes an event to its subscribers and native listeners.\n     *\n     * Fire-and-forget, so subscriber handlers run asynchronously and this returns before they\n     * complete, and callers must not assume side effects have completed. Errors thrown by a subscriber\n     * or by an `on()` listener are caught and logged, never surfaced here. One throwing listener\n     * does not stop the others. Subscribers on one key run concurrently and carry no ordering\n     * guarantee. A `'once'` subscriber is marked as executed when it starts (even if it throws), so\n     * it never runs twice.\n     *\n     * The framework's own keys are excluded. Subscribe to those and listen with `on`. The framework\n     * is their only publisher.\n     *\n     * @param event - The subscription key to publish\n     * @param data - Payload passed to each subscriber\n     * @returns Whether the underlying emitter had native listeners for the event\n     */\n    public publish<KeyOfSubscribers extends PublishableKey>(\n        event: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): boolean {\n        return this.dispatchKey(event, data);\n    }\n\n    /** @internal the framework's own publish path, keyed by a symbol no public entry exports */\n    public [PublishDefault]<KeyOfSubscribers extends keyof DefaultSubscriptions>(\n        event: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): boolean {\n        return this.dispatchKey(event, data);\n    }\n\n    private dispatchKey<KeyOfSubscribers extends SubscriptionKey>(\n        event: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): boolean {\n        void this.processSubscriber(event, data);\n        // justified: a generic key can't reduce SubscriptionTuples[K], but data is this event's payload by the signature\n        return this.emitSafe(event, ...([data] as SubscriptionTuples[KeyOfSubscribers]));\n    }\n\n    protected override onListenerError(error: unknown, event: string | symbol): void {\n        this.logger.error(`listener for ${String(event)} threw`, error);\n    }\n\n    private async processSubscriber<KeyOfSubscribers extends SubscriptionKey>(\n        subscriberName: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): Promise<void> {\n        const registrations = this.subscribersMap.get(subscriberName);\n        if (!registrations) return;\n\n        const pending = registrations.reduce<Promise<void>[]>((acc, entry) => {\n            if (entry.frequency === 'once') {\n                if (this.executedOnce.has(entry)) return acc;\n                // mark before awaiting, so a re-entrant publish can't run a 'once' subscriber twice mid-flight\n                this.executedOnce.add(entry);\n            }\n            acc.push(this.runSubscriber(entry, subscriberName, data));\n            return acc;\n        }, []);\n\n        await Promise.allSettled(pending);\n    }\n\n    private async runSubscriber<KeyOfSubscribers extends SubscriptionKey>(\n        entry: SubscriberRegistration,\n        subscriberName: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): Promise<void> {\n        // named outside the try so the catch can report which subscriber threw, several run per key\n        let name = '<unresolved>';\n        try {\n            entry.ctor ??= await entry.resolve();\n            // the registration keys each subscriber to its subscriptions, so data matches this ctor's payload arm\n            const Ctor = entry.ctor as new (\n                data: AllSubscriptions[KeyOfSubscribers],\n                core: CoreBase\n            ) => Subscriber<KeyOfSubscribers, CoreBase>;\n            name = Ctor.name;\n            await new Ctor(data, this.core).execute();\n        } catch (err) {\n            this.logger.error(`Error in subscriber ${String(subscriberName)} handler ${paint.sky.bold(name)}:`, err);\n        }\n    }\n}\n\n// callers gate on the Subscribe metadata, so it is present\n/** @internal */\nexport function registrationFor(ctor: StoredSubscriberCtor): SubscriberRegistration {\n    const meta = Reflect.getMetadata(SubscribeMetadataKey, ctor) as SubscribeMetadataEntry;\n    return { keys: [meta.subscriber], frequency: meta.frequency ?? 'on', resolve: () => ctor, ctor };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,IAAsB,aAAtB,MAAmG;CAUxE;CACA;CAVvB,AAAmB;;;;;;;CAQnB,YACI,AAAmB,MACnB,AAAmB,MACrB;EAFqB;EACA;EAEnB,KAAK,SAAS,IAAIA,wBAAO,KAAK,YAAY,MAAM,EAAE,SAAS,cAAc,CAAC;CAC9E;AAMJ;;;;AC3BA,MAAM,wBAAwB,IAAI,OAC9B,OAAO,GAAG,mFACd;AAEA,SAAgB,oBAAoB,OAAwB;CACxD,OAAO,IAAI,SAAS,KAAK,KAAK,sBAAsB,KAAK,KAAK;AAClE;AAEA,SAAgB,eAAe,MAAc,aAAqB,MAA4B;CAC1F,MAAM,cAAUC,iCAAgB,IAAI;CACpC,OAAO;EAAE;EAAM;EAAa,MAAM,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK,UAAU,SAAS,QAAW,CAAC,CAAC;CAAE;AACtG;AAGA,SAAgB,iBAAiB,MAAsB;CACnD,OAAO,KAAK,WAAW,OAAO,OAAO;AACzC;;AAGA,SAAgB,YAAY,OAAsB;CAC9C,IAAI,SAAS,MAAM,SAAS,GAAG,MAAM,KAAK,IAAI,MAAM;CACpD,IAAI,MAAM,QAAQ,MAAM,KAAK,GAAG;EAC5B,MAAM,QAAQ,MAAM,MAAM,SAAS,GAAG,MAAM,MAAM,KAAK,IAAI,MAAM,MAAM;EACvE,UAAU,mBAAmB;CACjC;CACA,MAAM,WAAW,qBAAiBC,2BAAU,MAAM,CAAC;CAEnD,OAAO,SAAS,SAAS,OAAO,GAAG,SAAS,MAAM,GAAG,IAAI,EAAE,KAAK;AACpE;AAEA,IAAa,mBAAb,cAAsCC,wCAA8B;CAChE,cAAc;EACV,MAAM,WAAW;EACjB,KAAK,SAAS,WAAWC,2CAAqB,KAAK,CAAC,CAAC,WAAW,IAAI;CACxE;AACJ;;;;AClCA,MAAM,iBAAiB;AACvB,MAAM,oBAAoB;;;;;;AAoB1B,IAAa,gBAAb,MAA2B;CACvB,AAAiB,OAAO,IAAIC,qBAAK;CACjC,AAAiB;CAEjB,YAAY,KAAa;EACrB,MAAM,QAAQ,gCAAgC,KAAK,GAAG;EAEtD,IAAI,CAAC,QAAQ,MAAM,CAAC,MAAM,IAAI,MAAM,IAAIC,wCAAcC,mCAAkB,yBAAyB,CAAC,SAAS,CAAC;EAC5G,KAAK,QAAQC,6BAAO,QAAQ,MAAM,IAAI,MAAM,EAAE;CAClD;;;;;CAMA,MAAM,SAAoD;EACtD,IAAI;GACA,MAAM,KAAK,KAAK,IAAI,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;GAC/C,OAAO;EACX,SAAS,OAAO;GAIZ,OAFI,iBAAiBC,oCAChB,MAAM,WAAW,kBAAkB,MAAM,WAAW,qBAC3C,YAAY;EAC9B;CACJ;CAEA,MAAM,KAAK,SAA4C;EACnD,MAAM,EAAE,OAAO,UAAU,YAAY,UAAU;EAC/C,MAAM,KAAK,KAAK,KAAK,KAAK,OAAO;GAC7B,MAAM;GAGN,OAAO,IAAI,gBAAgB;IAAE,iBAAiB;IAAQ,MAAM;GAAO,CAAC;GACpE,MAAM;IACF;IACA;IACA,YAAY,WAAW,KAAK,cAAc,UAAU,OAAO,CAAC;IAC5D,GAAI,OAAO,UAAU,EACjB,aAAa,MAAM,KAAK,MAAM,QAAQ;KAAE;KAAI,UAAU,KAAK;KAAM,aAAa,KAAK;IAAY,EAAE,EACrG;GACJ;GACA,GAAI,OAAO,UAAU,EAAE,OAAO,MAAM,KAAK,UAAU;IAAE,MAAM,KAAK;IAAM,MAAM,KAAK;GAAK,EAAE,EAAE;EAC9F,CAAC;CACL;AACJ;;;;;;;;;;;;;;ACrCA,IAAsB,aAAtB,MAAsB,mBAAqF,WAGzG;CACE,OAAwB,0BAAU,IAAI,IAA2B;CAKjE,MAAM,UAAyB;EAC3B,MAAM,MAAM,WAAW,MAAM,WAAW,SAAS,KAAK,WAAW,CAAC;EAClE,IAAI,QAAQ,MAAM;GAEd,KAAK,OAAO,KAAK,GAAG,cAAM,KAAK,KAAK,YAAY,IAAI,EAAE,mDAAmD;GACzG;EACJ;EAEA,MAAM,EAAE,UAAU,YAAY,UAAU,MAAM,KAAK,OAAO;EAC1D,IAAI;GACA,MAAM,WAAW,UAAU,GAAG,CAAC,CAAC,KAAK;IACjC,OAAOC,iCAAU,EAAE,WAAW,MAAM,CAAC;IACrC,UAAU,YAAY,KAAK,YAAY;IACvC;IACA;GACJ,CAAC;EACL,SAAS,OAAO;GACZ,KAAK,OAAO,MAAM,iCAAiC,KAAK;EAC5D;CACJ;;CAGA,OAAO,UAAU,KAA4B;EACzC,IAAI,SAAS,WAAW,QAAQ,IAAI,GAAG;EACvC,IAAI,CAAC,QAAQ;GACT,SAAS,IAAI,cAAc,GAAG;GAC9B,WAAW,QAAQ,IAAI,KAAK,MAAM;EACtC;EACA,OAAO;CACX;;CAGA,OAAO,SAAS,MAA+B;EAC3C,MAAM,SAAS,QAAQ,YAAYC,8CAAuB,IAAI;EAC9D,IAAI,CAAC,QAAQ,MAAM,IAAIC,wCAAcC,mCAAkB,4BAA4B,CAAC,KAAK,IAAI,CAAC;EAC9F,OAAO;CACX;;CAGA,OAAO,MAAM,QAA+B;EACxC,IAAI,CAACC,gBAAS,IAAI,MAAM,GAAG,OAAO;EAClC,MAAM,MAAMA,gBAAS,YAAY,QAAQC,kBAAW,MAAM,CAAC,CAAC,KAAK;EACjE,IAAI,QAAQ,IAAI,OAAO;EACvB,IAAI,CAAC,oBAAoB,GAAG,GAAG,MAAM,IAAIH,wCAAcC,mCAAkB,yBAAyB,CAAC,MAAM,CAAC;EAC1G,OAAO;CACX;AACJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACrCA,SAAgB,UAA+C,YAAyB,SAA4B;CAChH,OAAO,SACH,aACI;EACJ,MAAM,OAA+B;GACjC;GACA,WAAW,SAAS;EACxB;EAEA,QAAQ,eAAeG,6CAAsB,MAAM,WAAW;CAClE;AACJ;;;;;;;;;;;;;;;;;;;;;;;ACtCA,SAAgB,WAAW,QAAgB;CACvC,OAAO,SACH,aACI;EACJ,QAAQ,eAAeC,8CAAuB,QAAQ,WAAW;CACrE;AACJ;;;;;;;;;;;;;ACVO,IAAM,mBAAN,MAAM,yBAAyB,WAAyC;CAC3E,SAAwB;EACpB,OAAO;GACH,UAAU;GACV,YAAY,CAAC,IAAI,0BAA0B,KAAK,IAAI,CAAC,CAAC,SAAS;GAC/D,OAAO,CAAC,eAAe,eAAe,sCAAsC,KAAK,KAAK,OAAO,GAAG,CAAC;EACrG;CACJ;AACJ;+BAVC,UAAU,kBAAkB,GAC5B,WAAW,+BAA+B;AAW3C,IAAM,4BAAN,cAAwCC,wCAA8B;CAClE,YAAY,MAA4C;EACpD,MAAM,WAAW;EAEjB,MAAM,EAAE,QAAQ,MAAM,WAAW;EAEjC,KAAK,SACA,0BAA0B,SAAS,KAAK,WAAW,aAAa,QAAQ,MAAM,CAAC,CAAC,CAAC,CACjF,uBAAuB,IAAI,iBAAiB,CAAC,CAAC,SAAS,CAAC,CACxD,0BAA0B,SACvB,KAAK,WAAW,cAAc,KAAK,YAAY,iBAAiB,WAAW,MAAM,CAAC,EAAE,OAAO,CAC/F,CAAC,CACA,uBAAuB,IAAI,iBAAiB,CAAC,CAAC,SAAS,CAAC,CACxD,0BAA0B,SAAS,KAAK,WAAW,YAAY,CAAC,CAAC,CACjE,mBAAmB,SAAS,KAAK,OAAO,0BAA0B,CAAC;CAC5E;AACJ;AAEA,SAAS,aAAa,QAAgB,QAA6B;CAE/D,MAAM,WAAOC,2BAAU,uCAAuC,OAAO,KAAK,mBAAmB,OAAO,QAAQ,GAAG;CAC/G,IAAI,OAAO,SAAS,SAChB,OACI,GAAG,KAAK,aAAa,OAAO,UAAU,iBACtB,OAAO,QAAQ,mBACb,OAAO,UAAU,MAAM,sBACtB,OAAO,WAAW,MAAM,wBACtB,OAAO,aAAa,MAAM;CAGvD,OACI,GAAG,KAAK,YAAY,OAAO,gBAAgB,iBAC3B,OAAO,WAAW,MAAM,kBACvB,OAAO,YAAY,MAAM,mBACxB,OAAO,OAAO,sBACb,OAAO,WAAW,MAAM,wBACtB,OAAO,aAAa,MAAM,4BACtB,OAAO,cAAc;AAEtD;AAGA,SAAS,WAAW,QAAwB;CACxC,MAAM,EAAE,UAAU;CAClB,IAAI,MAAM,QAAQ,KAAK,GAAG,WAAOA,2BAAU,MAAM,SAAS,MAAM,OAAO;CACvE,IAAI,OAAO,UAAU,UAAU,WAAOA,2BAAU,KAAK;CACrD,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,MAAM,SAAS;CACjH,IAAI,UAAU,QACV,IAAI;EACA,OAAO,KAAK,UAAU,KAAK;CAC/B,QAAQ;EACJ,OAAO;CACX;CAEJ,WAAOA,2BAAU,OAAO,SAAS,oBAAoB;AACzD;;;;ACjEO,IAAM,mBAAN,MAAM,yBAAyB,WAAyC;CAC3E,SAAwB;EACpB,MAAM,EAAE,aAAa,KAAK;EAC1B,OAAO;GACH,UAAU;GACV,YAAY,CAAC,IAAI,wBAAwB,KAAK,IAAI,CAAC,CAAC,SAAS;GAC7D,OAAO,WACD,CAAC,eAAe,iBAAiB,sCAAsC,QAAQ,CAAC,IAChF;EACV;CACJ;AACJ;+BAbC,UAAU,kBAAkB,GAC5B,WAAW,+BAA+B;AAc3C,IAAM,0BAAN,cAAsCC,wCAA8B;CAChE,YAAY,MAA4C;EACpD,MAAM,WAAW;EAEjB,MAAM,EAAE,MAAM,OAAO,OAAO,MAAM,aAAa;EAE/C,KAAK,SACA,0BAA0B,SACvB,KAAK,WACD,wDACuB,OAAO,MAAM,sBAAsB,sBACnC,OAAO,QAAQ,sBAAsB,mBACtC,MAAM,MAAM,oBAAoB,oBACjC,MAAM,YAAY,oBAAoB,GAC/D,CACJ,CAAC,CACA,uBAAuB,IAAI,iBAAiB,CAAC,CAAC,SAAS,CAAC,CACxD,0BAA0B,SACvB,KAAK,WAAW,cAAc,KAAK,YAAY,YAAY,KAAK,EAAE,OAAO,CAC7E;EAEJ,KAAK,yBAAyB,KAAK;EACnC,KAAK,uBAAuB,QAAQ;CACxC;CAEA,AAAQ,yBAAyB,OAAoB;EACjD,IAAI,EAAE,iBAAiBC,kCAAkB;EAEzC,MAAM,MAAM,KAAK,IAAI;EAErB,MAAM,YAAY,MAAM,IAAI,MAAM,yBAAyB,CAAC,GAAG;EAC/D,IAAI,CAAC,WAAW,OAAO;EAEvB,MAAM,oBAAgBC,wCAAuB,SAAS;EAEtD,MAAM,OAAO,MAAM;EACnB,MAAM,UAAU,KAAK,MAAM,OAAO,GAAI;EACtC,MAAM,SAAS,OAAO;EAEtB,KAAK,SACA,uBAAuB,IAAI,iBAAiB,CAAC,CAAC,SAAS,CAAC,CACxD,0BAA0B,SACvB,KAAK,WACD,gDACoC,IAAI,KAAK,aAAa,CAAC,CAAC,YAAY,EAAE,IAAI,cAAc,kCACxD,IAAI,KAAK,GAAG,CAAC,CAAC,YAAY,EAAE,IAAI,IAAI,kCACpC,QAAQ,IAAI,OAAO,GAC3D,CACJ;CACR;CAEA,AAAQ,uBAAuB,UAAyB;EACpD,IAAI,CAAC,UAAU;EAEf,KAAK,SACA,uBAAuB,IAAI,iBAAiB,CAAC,CAAC,SAAS,CAAC,CACxD,0BAA0B,SAAS,KAAK,WAAW,cAAc,CAAC,CAAC,CACnE,mBAAmB,SAAS,KAAK,OAAO,4BAA4B,CAAC;CAC9E;AACJ;;;;;;;;AC5CA,IAAa,MAAb,cAAyBC,0CAAsC;CASrC;;CAPtB,AAAgB,SAAS,IAAIC,wBAAO,eAAe,EAAE,SAAS,cAAc,CAAC;CAE7E,AAAiB,iCAAiB,IAAI,IAA+C;CACrF,AAAiB,+BAAe,IAAI,IAA4B;CAEhE,AAAiB,gCAAgB,IAAI,IAAsB;CAE3D,YAAY,AAAU,MAAgB;EAClC,MAAM;EADY;CAEtB;;;;;;;CAQA,AAAO,mBAAyB;EAC5B,KAAK,SAAS,gBAAgB,gBAAgB,CAAC;EAC/C,KAAK,SAAS,gBAAgB,gBAAgB,CAAC;CACnD;;CAGA,AAAO,SAAS,cAA4C;EAExD,IAAI,aAAa,QAAQ,CAAC,KAAK,aAAa,aAAa,IAAI,GAAG;EAEhE,KAAK,MAAM,OAAO,aAAa,MAAM;GACjC,IAAI,gBAAgB,KAAK,eAAe,IAAI,GAAG;GAC/C,IAAI,CAAC,eAAe;IAChB,gBAAgB,CAAC;IACjB,KAAK,eAAe,IAAI,KAAK,aAAa;GAC9C;GACA,cAAc,KAAK,YAAY;EACnC;CACJ;;CAGA,AAAO,WAAW,MAA4B,MAAyC;EACnF,KAAK,MAAM,OAAO,QAAQ,CAAC,GAAG,KAAK,eAAe,KAAK,CAAC,GAAG;GACvD,MAAM,gBAAgB,KAAK,eAAe,IAAI,GAAG;GACjD,IAAI,CAAC,eAAe;GACpB,MAAM,QAAQ,cAAc,WAAW,UAAU,MAAM,SAAS,IAAI;GACpE,IAAI,UAAU,IAAI,cAAc,OAAO,OAAO,CAAC;EACnD;CAEJ;;CAGA,IAAW,kBAA0B;EACjC,OAAO,CAAC,GAAG,KAAK,eAAe,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,YAAY,QAAQ,QAAQ,QAAQ,CAAC;CACjG;;CAGA,MAAa,iBAAgC;EACzC,MAAM,UAAoB,CAAC;EAC3B,MAAM,QAAQ,IACV,CAAC,GAAG,KAAK,aAAa,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,aAAa;GAClD,MAAM,SAAS,MAAM,WAAW,UAAU,GAAG,CAAC,CAAC,OAAO;GACtD,IAAI,WAAW,WAAW,QAAQ,KAAK,GAAG,OAAO;QAC5C,IAAI,WAAW,eAChB,KAAK,OAAO,KAAK,+BAA+BC,uBAAM,IAAI,KAAK,QAAQ,KAAK,IAAI,CAAC,GAAG;EAC5F,CAAC,CACL;EAEA,IAAI,QAAQ,SAAS,GAAG,MAAM,IAAIC,wCAAcC,mCAAkB,uBAAuB,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;CACjH;;CAGA,AAAQ,aAAa,MAAqC;EACtD,IAAI,EAAE,KAAK,qBAAqB,aAAa,OAAO;EAEpD,MAAM,SAAS,WAAW,SAAS,IAAI;EACvC,MAAM,MAAM,WAAW,MAAM,MAAM;EACnC,IAAI,QAAQ,MAAM;GACd,KAAK,OAAO,KAAK,GAAG,cAAM,KAAK,KAAK,IAAI,EAAE,aAAaF,uBAAM,IAAI,KAAK,MAAM,EAAE,YAAY;GAC1F,OAAO;EACX;EACA,MAAM,UAAU,KAAK,cAAc,IAAI,GAAG,KAAK,CAAC;EAChD,IAAI,CAAC,QAAQ,SAAS,MAAM,GAAG,QAAQ,KAAK,MAAM;EAClD,KAAK,cAAc,IAAI,KAAK,OAAO;EACnC,OAAO;CACX;;;;;;;;;;;;;;;;;;CAmBA,AAAO,QACH,OACA,MACO;EACP,OAAO,KAAK,YAAY,OAAO,IAAI;CACvC;;CAGA,CAAQG,uCACJ,OACA,MACO;EACP,OAAO,KAAK,YAAY,OAAO,IAAI;CACvC;CAEA,AAAQ,YACJ,OACA,MACO;EACP,AAAK,KAAK,kBAAkB,OAAO,IAAI;EAEvC,OAAO,KAAK,SAAS,OAAO,GAAI,CAAC,IAAI,CAA0C;CACnF;CAEA,AAAmB,gBAAgB,OAAgB,OAA8B;EAC7E,KAAK,OAAO,MAAM,gBAAgB,OAAO,KAAK,EAAE,SAAS,KAAK;CAClE;CAEA,MAAc,kBACV,gBACA,MACa;EACb,MAAM,gBAAgB,KAAK,eAAe,IAAI,cAAc;EAC5D,IAAI,CAAC,eAAe;EAEpB,MAAM,UAAU,cAAc,QAAyB,KAAK,UAAU;GAClE,IAAI,MAAM,cAAc,QAAQ;IAC5B,IAAI,KAAK,aAAa,IAAI,KAAK,GAAG,OAAO;IAEzC,KAAK,aAAa,IAAI,KAAK;GAC/B;GACA,IAAI,KAAK,KAAK,cAAc,OAAO,gBAAgB,IAAI,CAAC;GACxD,OAAO;EACX,GAAG,CAAC,CAAC;EAEL,MAAM,QAAQ,WAAW,OAAO;CACpC;CAEA,MAAc,cACV,OACA,gBACA,MACa;EAEb,IAAI,OAAO;EACX,IAAI;GACA,MAAM,SAAS,MAAM,MAAM,QAAQ;GAEnC,MAAM,OAAO,MAAM;GAInB,OAAO,KAAK;GACZ,MAAM,IAAI,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,QAAQ;EAC5C,SAAS,KAAK;GACV,KAAK,OAAO,MAAM,uBAAuB,OAAO,cAAc,EAAE,WAAWH,uBAAM,IAAI,KAAK,IAAI,EAAE,IAAI,GAAG;EAC3G;CACJ;AACJ;;AAIA,SAAgB,gBAAgB,MAAoD;CAChF,MAAM,OAAO,QAAQ,YAAYI,6CAAsB,IAAI;CAC3D,OAAO;EAAE,MAAM,CAAC,KAAK,UAAU;EAAG,WAAW,KAAK,aAAa;EAAM,eAAe;EAAM;CAAK;AACnG"}

package/dist/{subscribers-CmDKqC7y.mjs → subscribers-xO6DZ-70.mjs}

@@ -249,7 +249,7 @@ function WebhookUrl(envKey) {
 }
 
 //#endregion
-//#region \0@oxc-project+runtime@0.135.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -477,4 +477,4 @@ function registrationFor(ctor) {
 
 //#endregion
 export { WebhookLog as a, Subscribe as i, registrationFor as n, Subscriber as o, WebhookUrl as r, Bus as t };
-//# sourceMappingURL=subscribers-CmDKqC7y.mjs.map
+//# sourceMappingURL=subscribers-xO6DZ-70.mjs.map

package/dist/{subscribers-CmDKqC7y.mjs.map → subscribers-xO6DZ-70.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"subscribers-CmDKqC7y.mjs","names":[],"sources":["../src/subscribers/Subscriber.ts","../src/subscribers/bases/webhookHelpers.ts","../src/subscribers/bases/WebhookSender.ts","../src/subscribers/bases/WebhookLog.ts","../src/subscribers/decorators/Subscribe.ts","../src/subscribers/decorators/WebhookUrl.ts","../src/subscribers/default/HandledException.ts","../src/subscribers/default/UnknownException.ts","../src/subscribers/Bus.ts"],"sourcesContent":["import { Logger } from '@seedcord/logger';\n\nimport type { SubscriptionKey, AllSubscriptions } from './types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\n\n/**\n * Abstract base class for handling application subscribers.\n *\n * Provides type-safe access to subscribers data and the core framework instance.\n * Extend this class to create custom subscriber handlers.\n *\n * @typeParam KeyOfSubscribers - The specific subscriber type this handler processes\n * @typeParam TCore - The transport's Core\n */\nexport abstract class Subscriber<KeyOfSubscribers extends SubscriptionKey, TCore extends CoreBase> {\n    protected readonly logger: Logger;\n\n    /**\n     * Instantiates the subscriber with event data and core.\n     *\n     * @param data - The subscriber event data\n     * @param core - The core framework instance\n     */\n    constructor(\n        protected readonly data: AllSubscriptions[KeyOfSubscribers],\n        protected readonly core: TCore\n    ) {\n        this.logger = new Logger(this.constructor.name, { channel: 'subscribers' });\n    }\n\n    /**\n     * Executes the subscriber handler logic.\n     */\n    abstract execute(): Promise<void>;\n}\n","import { filterCirculars, stripAnsi } from '@seedcord/utils';\nimport { SeparatorSpacingSize } from 'discord-api-types/v10';\n\nimport { BuilderComponent } from '@components/Component';\n\nimport type { WebhookFile } from './WebhookSender';\n\nconst DISCORD_WEBHOOK_REGEX = new RegExp(\n    String.raw`^https?:\\/\\/(?:canary\\.|ptb\\.)?discord(?:app)?\\.com\\/api\\/webhooks\\/\\d+\\/[\\w$-]+$`\n);\n\nexport function isDiscordWebhookUrl(value: string): boolean {\n    return URL.canParse(value) && DISCORD_WEBHOOK_REGEX.test(value);\n}\n\nexport function jsonAttachment(name: string, description: string, data: unknown): WebhookFile {\n    const content = filterCirculars(data);\n    return { name, description, data: new TextEncoder().encode(JSON.stringify(content, undefined, 2)) };\n}\n\n// the report renders inside a ``` fence, so break any triple-backtick run to keep it from closing early\nexport function neutralizeFences(text: string): string {\n    return text.replaceAll('```', '`​`​`');\n}\n\n/** An error's stack with its direct cause appended (one level), ANSI-stripped for the webhook payload. */\nexport function errorReport(error: Error): string {\n    let report = error.stack ?? `${error.name}: ${error.message}`;\n    if (Error.isError(error.cause)) {\n        const cause = error.cause.stack ?? `${error.cause.name}: ${error.cause.message}`;\n        report += `\\n\\nCaused by:\\n${cause}`;\n    }\n    const stripped = neutralizeFences(stripAnsi(report));\n    // eslint-disable-next-line no-magic-numbers\n    return stripped.length > 1800 ? `${stripped.slice(0, 1799)}…` : stripped;\n}\n\nexport class WebhookSeparator extends BuilderComponent<'separator'> {\n    constructor() {\n        super('separator');\n        this.instance.setSpacing(SeparatorSpacingSize.Small).setDivider(true);\n    }\n}\n","import { DiscordAPIError, REST } from '@discordjs/rest';\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Routes } from 'discord-api-types/v10';\n\nimport type { ReplyFile } from '@seedcord/types';\nimport type { APIMessageTopLevelComponent } from 'discord-api-types/v10';\n\nconst HTTP_NOT_FOUND = 404;\nconst HTTP_UNAUTHORIZED = 401;\n\n/** A file attached to a webhook report. */\nexport interface WebhookFile extends ReplyFile {\n    readonly description: string;\n}\n\n/** The payload {@link WebhookSender.send} posts. */\nexport interface WebhookSendOptions {\n    flags: number;\n    username: string;\n    components: readonly { toJSON(): APIMessageTopLevelComponent }[];\n    files?: readonly WebhookFile[] | undefined;\n}\n\n/**\n * Sends component messages to a Discord webhook through `@discordjs/rest`.\n *\n * @throws A `SeedcordError` when the url does not carry a webhook id and token.\n */\nexport class WebhookSender {\n    private readonly rest = new REST();\n    private readonly route: `/${string}`;\n\n    constructor(url: string) {\n        const match = /\\/webhooks\\/(\\d+)\\/([\\w$-]+)$/.exec(url);\n        // the url is a secret, so the error message never carries it\n        if (!match?.[1] || !match[2]) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookUrlInvalid, ['The url']);\n        this.route = Routes.webhook(match[1], match[2]);\n    }\n\n    /**\n     * Fetches the webhook object, sending no message. Returns `missing` on a 404 or 401 from\n     * Discord and `unreachable` on any other failure.\n     */\n    async verify(): Promise<'ok' | 'missing' | 'unreachable'> {\n        try {\n            await this.rest.get(this.route, { auth: false });\n            return 'ok';\n        } catch (error) {\n            const gone =\n                error instanceof DiscordAPIError &&\n                (error.status === HTTP_NOT_FOUND || error.status === HTTP_UNAUTHORIZED);\n            return gone ? 'missing' : 'unreachable';\n        }\n    }\n\n    async send(options: WebhookSendOptions): Promise<void> {\n        const { flags, username, components, files } = options;\n        await this.rest.post(this.route, {\n            auth: false,\n            // with_components=true makes discord accept a components-v2 payload. wait=true makes it\n            // return payload errors in the response\n            query: new URLSearchParams({ with_components: 'true', wait: 'true' }),\n            body: {\n                flags,\n                username,\n                components: components.map((component) => component.toJSON()),\n                ...(files?.length && {\n                    attachments: files.map((file, id) => ({ id, filename: file.name, description: file.description }))\n                })\n            },\n            ...(files?.length && { files: files.map((file) => ({ name: file.name, data: file.data })) })\n        });\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport chalk from 'chalk';\nimport { Converters, Envapter } from 'envapt';\n\nimport { sendFlags } from '@reply/flags';\nimport { WebhookUrlMetadataKey } from '@src/metadataKeys';\n\nimport { Subscriber } from '../Subscriber';\nimport { isDiscordWebhookUrl } from './webhookHelpers';\nimport { WebhookSender } from './WebhookSender';\n\nimport type { WebhookFile } from './WebhookSender';\nimport type { SubscriptionKey } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { APIMessageTopLevelComponent } from 'discord-api-types/v10';\n\n/**\n * The content a reporter returns from {@link WebhookLog.report}.\n */\nexport interface WebhookReport {\n    /** Shown as the webhook message author. Defaults to the reporter's class name. */\n    username?: string;\n    components: readonly { toJSON(): APIMessageTopLevelComponent }[];\n    files?: readonly WebhookFile[] | undefined;\n}\n\n/**\n * Base class for subscribers that deliver their event to a Discord webhook.\n *\n * Declare the url's environment variable with `@WebhookUrl` and implement {@link report}. Url\n * resolution, validation, sender reuse, and sending run in the base. When the variable is unset\n * the reporter is skipped at registration with a boot warning.\n *\n * @typeParam KeyOfSubscribers - The subscription key this reporter receives\n * @typeParam TCore - The transport's Core\n */\nexport abstract class WebhookLog<KeyOfSubscribers extends SubscriptionKey, TCore extends CoreBase> extends Subscriber<\n    KeyOfSubscribers,\n    TCore\n> {\n    private static readonly senders = new Map<string, WebhookSender>();\n\n    /** Builds the message for one published event. */\n    abstract report(): WebhookReport | Promise<WebhookReport>;\n\n    async execute(): Promise<void> {\n        const url = WebhookLog.urlOf(WebhookLog.envKeyOf(this.constructor));\n        if (url === null) {\n            // a server host skips url-less reporters at registration, an edge host registers lazily and reaches this branch\n            this.logger.warn(`${chalk.bold(this.constructor.name)} has no webhook url set, this reporter is disabled`);\n            return;\n        }\n\n        const { username, components, files } = await this.report();\n        try {\n            await WebhookLog.senderFor(url).send({\n                flags: sendFlags({ ephemeral: false }),\n                username: username ?? this.constructor.name,\n                components,\n                files\n            });\n        } catch (error) {\n            this.logger.error('Failed to send webhook report', error);\n        }\n    }\n\n    /** @internal */\n    static senderFor(url: string): WebhookSender {\n        let sender = WebhookLog.senders.get(url);\n        if (!sender) {\n            sender = new WebhookSender(url);\n            WebhookLog.senders.set(url, sender);\n        }\n        return sender;\n    }\n\n    /** @internal */\n    static envKeyOf(ctor: NewableFunction): string {\n        const envKey = Reflect.getMetadata(WebhookUrlMetadataKey, ctor) as string | undefined;\n        if (!envKey) throw new SeedcordError(SeedcordErrorCode.DecoratorWebhookUrlMissing, [ctor.name]);\n        return envKey;\n    }\n\n    /** @internal Returns null when the env var is unset, throws when set but malformed. */\n    static urlOf(envKey: string): string | null {\n        if (!Envapter.has(envKey)) return null;\n        const raw = Envapter.getRequired(envKey, Converters.String).trim();\n        if (raw === '') return null;\n        if (!isDiscordWebhookUrl(raw)) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookUrlInvalid, [envKey]);\n        return raw;\n    }\n}\n","// the default reporters are decorated at Bus module load, before any entry's own polyfill import runs\nimport 'reflect-metadata';\n\nimport { SubscribeMetadataKey } from '@src/metadataKeys';\n\nimport type { Subscriber } from '../Subscriber';\nimport type { SubscriptionKey } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { EventFrequency } from '@seedcord/types';\nimport type { Constructor } from 'type-fest';\n\n/**\n * Options accepted by the `@Subscribe` decorator.\n */\nexport interface SubscribeOptions {\n    /**\n     * Frequency: `'once'` or `'on'`.\n     *\n     * @defaultValue `'on'`\n     */\n    readonly frequency?: EventFrequency | undefined;\n}\n\n/** @internal */\nexport interface SubscribeMetadataEntry {\n    readonly subscriber: SubscriptionKey;\n    readonly frequency?: EventFrequency | undefined;\n}\n\n/**\n * Registers a subscriber handler class with a specific subscriber event.\n *\n * Associates the decorated class with a subscriber event type for automatic\n * registration and execution when the subscriber is emitted.\n *\n * @typeParam TSubscriber - The subscriber event name to register for\n * @param subscriber - The subscriber event name to register for\n * @param options - Options to configure the subscriber handler registration.\n * @decorator\n * @example\n * ```typescript\n * \\@Subscribe('userJoin')\n * class WelcomeHandler extends Subscriber<'userJoin'> {\n *   async execute() {\n *     // Handle user join event\n *   }\n * }\n * ```\n * @example\n * ```ts\n * \\@Subscribe('userJoin', { frequency: 'once' })\n * // or\n * \\@Subscribe('userJoin')\n * ```\n */\nexport function Subscribe<TSubscriber extends SubscriptionKey>(subscriber: TSubscriber, options?: SubscribeOptions) {\n    return function <HandlerCtor extends Constructor<Subscriber<TSubscriber, CoreBase>>>(\n        constructor: HandlerCtor\n    ): void {\n        const meta: SubscribeMetadataEntry = {\n            subscriber,\n            frequency: options?.frequency\n        };\n\n        Reflect.defineMetadata(SubscribeMetadataKey, meta, constructor);\n    };\n}\n","import 'reflect-metadata';\n\nimport { WebhookUrlMetadataKey } from '@src/metadataKeys';\n\nimport type { WebhookLog } from '../bases/WebhookLog';\nimport type { SubscriptionKey } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { Constructor } from 'type-fest';\n\n/**\n * Declares the environment variable a {@link WebhookLog} reporter reads its webhook url from.\n *\n * An unset variable disables the reporter with a boot warning. A set but malformed value throws\n * at boot.\n *\n * @param envKey - The environment variable name holding the webhook url\n * @decorator\n * @example\n * ```ts\n * \\@Subscribe('memberBanned')\n * \\@WebhookUrl('BAN_LOG_WEBHOOK_URL')\n * class BanLog extends WebhookLog<'memberBanned'> {\n *   report() {\n *     return { components: [new BanCard(this.data).component] };\n *   }\n * }\n * ```\n */\nexport function WebhookUrl(envKey: string) {\n    return function <HandlerCtor extends Constructor<WebhookLog<SubscriptionKey, CoreBase>>>(\n        constructor: HandlerCtor\n    ): void {\n        Reflect.defineMetadata(WebhookUrlMetadataKey, envKey, constructor);\n    };\n}\n","import { stripAnsi } from '@seedcord/utils';\n\nimport { BuilderComponent } from '@components/Component';\n\nimport { jsonAttachment, neutralizeFences, WebhookSeparator } from '../bases/webhookHelpers';\nimport { WebhookLog } from '../bases/WebhookLog';\nimport { Subscribe } from '../decorators/Subscribe';\nimport { WebhookUrl } from '../decorators/WebhookUrl';\n\nimport type { WebhookReport } from '../bases/WebhookLog';\nimport type { AllSubscriptions, FaultSource } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { Notice } from '@stops/Notice';\n\n/**\n * Default subscriber that delivers a reported `Notice` (`report: true`) to a webhook with the\n * denial, the fault source, the threaded uuid, the cause stack, and the raw source as a JSON\n * attachment. The controller boundary throttles identical faults before they reach the bus.\n *\n * Reads its webhook url from HANDLED_EXCEPTION_WEBHOOK_URL. Unset, the reporter is disabled with\n * a boot warning.\n */\n@Subscribe('handledException')\n@WebhookUrl('HANDLED_EXCEPTION_WEBHOOK_URL')\nexport class HandledException extends WebhookLog<'handledException', CoreBase> {\n    report(): WebhookReport {\n        return {\n            username: 'Handled Exception',\n            components: [new HandledExceptionContainer(this.data).component],\n            files: [jsonAttachment('source.json', 'The raw source the fault came from', this.data.source.raw)]\n        };\n    }\n}\n\nclass HandledExceptionContainer extends BuilderComponent<'container'> {\n    constructor(data: AllSubscriptions['handledException']) {\n        super('container');\n\n        const { denial, uuid, source } = data;\n\n        this.instance\n            .addTextDisplayComponents((text) => text.setContent(faultSummary(denial, source)))\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) =>\n                text.setContent(`### UUID \\`${uuid}\\`\\n\\`\\`\\`${neutralizeFences(causeStack(denial))}\\`\\`\\``)\n            )\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) => text.setContent('### Source'))\n            .addFileComponents((file) => file.setURL('attachment://source.json'));\n    }\n}\n\nfunction faultSummary(denial: Notice, source: FaultSource): string {\n    // name and message carry chalk, the webhook payload renders them raw\n    const head = stripAnsi(`### A handled fault was reported: \\`${denial.name}\\`\\n**Message:** ${denial.message}\\n`);\n    if (source.kind === 'event') {\n        return (\n            `${head}**Event:** ${source.eventName}\\n` +\n            `**Handler:** ${source.handler}\\n` +\n            `**User ID:** \\`${source.userId ?? 'n/a'}\\`\\n` +\n            `**Guild ID:** \\`${source.guildId ?? 'n/a'}\\`\\n` +\n            `**Channel ID:** \\`${source.channelId ?? 'n/a'}\\``\n        );\n    }\n    return (\n        `${head}**Kind:** ${source.interactionKind}\\n` +\n        `**Command:** ${source.command ?? 'n/a'}\\n` +\n        `**CustomId:** ${source.customId ?? 'n/a'}\\n` +\n        `**User ID:** \\`${source.userId}\\`\\n` +\n        `**Guild ID:** \\`${source.guildId ?? 'n/a'}\\`\\n` +\n        `**Channel ID:** \\`${source.channelId ?? 'n/a'}\\`\\n` +\n        `**Interaction ID:** \\`${source.interactionId}\\``\n    );\n}\n\n// every cause shape returns a string, building the report never throws on a bigint or circular cause\nfunction causeStack(denial: Notice): string {\n    const { cause } = denial;\n    if (Error.isError(cause)) return stripAnsi(cause.stack ?? cause.message);\n    if (typeof cause === 'string') return stripAnsi(cause);\n    if (typeof cause === 'bigint' || typeof cause === 'symbol' || typeof cause === 'function') return cause.toString();\n    if (cause !== undefined) {\n        try {\n            return JSON.stringify(cause);\n        } catch {\n            return '[unserializable cause]';\n        }\n    }\n    return stripAnsi(denial.stack ?? 'No cause recorded.');\n}\n","import { DiscordAPIError } from '@discordjs/rest';\nimport { timestampFromSnowflake } from '@seedcord/utils';\n\nimport { BuilderComponent } from '@components/Component';\n\nimport { errorReport, jsonAttachment, WebhookSeparator } from '../bases/webhookHelpers';\nimport { WebhookLog } from '../bases/WebhookLog';\nimport { Subscribe } from '../decorators/Subscribe';\nimport { WebhookUrl } from '../decorators/WebhookUrl';\n\nimport type { WebhookReport } from '../bases/WebhookLog';\nimport type { AllSubscriptions } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\n\n/**\n * Default subscriber that reports an unhandled exception to a webhook: the stack trace, the guild\n * and user, a tracking uuid, interaction timestamps when available, and the error metadata as a\n * JSON attachment.\n *\n * Reads its webhook url from UNKNOWN_EXCEPTION_WEBHOOK_URL. Unset, the reporter is disabled with\n * a boot warning.\n */\n@Subscribe('unknownException')\n@WebhookUrl('UNKNOWN_EXCEPTION_WEBHOOK_URL')\nexport class UnknownException extends WebhookLog<'unknownException', CoreBase> {\n    report(): WebhookReport {\n        const { metadata } = this.data;\n        return {\n            username: 'Unknown Exception',\n            components: [new UnhandledErrorContainer(this.data).component],\n            files: metadata\n                ? [jsonAttachment('metadata.json', 'Metadata associated with the error', metadata)]\n                : undefined\n        };\n    }\n}\n\nclass UnhandledErrorContainer extends BuilderComponent<'container'> {\n    constructor(data: AllSubscriptions['unknownException']) {\n        super('container');\n\n        const { uuid, error, guild, user, metadata } = data;\n\n        this.instance\n            .addTextDisplayComponents((text) =>\n                text.setContent(\n                    `### An unknown exception was thrown\\n` +\n                        `**Guild ID:** \\`${guild?.id ?? 'Not used in a guild'}\\`\\n` +\n                        `**Guild Name:** ${guild?.name ?? 'Not used in a guild'}\\n` +\n                        `**User ID:** \\`${user?.id ?? 'Missing user info'}\\`\\n` +\n                        `**Username:** ${user?.username ?? 'Missing user info'}\\n`\n                )\n            )\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) =>\n                text.setContent(`### UUID \\`${uuid}\\`\\n\\`\\`\\`${errorReport(error)}\\`\\`\\``)\n            );\n\n        this.addTimestampsIfAvailable(error);\n        this.addMetadataIfAvailable(metadata);\n    }\n\n    private addTimestampsIfAvailable(error: Error): void {\n        if (!(error instanceof DiscordAPIError)) return;\n\n        const now = Date.now();\n\n        const snowflake = error.url.match(/\\/interactions\\/(\\d+)\\//)?.[1];\n        if (!snowflake) return undefined;\n\n        const interactionTs = timestampFromSnowflake(snowflake);\n\n        const diff = now - interactionTs;\n        const seconds = Math.floor(diff / 1000);\n        const millis = diff % 1000;\n\n        this.instance\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) =>\n                text.setContent(\n                    `### Timestamps\\n` +\n                        `- **\\`Interaction sent\\` :** ${new Date(interactionTs).toISOString()} (${interactionTs})\\n` +\n                        `- **\\`Error logged    \\` :** ${new Date(now).toISOString()} (${now})\\n` +\n                        `- **\\`Offset          \\` :** ${seconds}s ${millis}ms`\n                )\n            );\n    }\n\n    private addMetadataIfAvailable(metadata: unknown): void {\n        if (!metadata) return;\n\n        this.instance\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) => text.setContent('### Metadata'))\n            .addFileComponents((file) => file.setURL('attachment://metadata.json'));\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { TypedEventEmitter } from '@seedcord/event-emitter';\nimport { Logger, paint } from '@seedcord/logger';\nimport chalk from 'chalk';\n\nimport { SubscribeMetadataKey } from '@src/metadataKeys';\n\nimport { WebhookLog } from './bases/WebhookLog';\nimport { HandledException } from './default/HandledException';\nimport { UnknownException } from './default/UnknownException';\nimport { PublishDefault } from './publishDefault';\n\nimport type { SubscribeMetadataEntry } from './decorators/Subscribe';\nimport type { Subscriber } from './Subscriber';\nimport type {\n    AllSubscriptions,\n    DefaultSubscriptions,\n    PublishableKey,\n    SubscriptionKey,\n    SubscriptionTuples\n} from './types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { EventFrequency } from '@seedcord/types';\n\n/**\n * A subscriber class as the Bus stores it. Both parameters are `never` because construct-signature\n * parameters check contravariantly, and a concrete subscriber narrows each to its own payload and\n * transport `Core`. One cast at dispatch restores both.\n *\n * @internal\n */\nexport type StoredSubscriberCtor = new (data: never, core: never) => Subscriber<SubscriptionKey, CoreBase>;\n\n/**\n * One registration. `resolve` is lazy so an edge host registers from a manifest row without\n * importing the module until that key first publishes.\n *\n * @internal\n */\nexport interface SubscriberRegistration {\n    readonly keys: readonly SubscriptionKey[];\n    readonly frequency: EventFrequency;\n    readonly resolve: () => StoredSubscriberCtor | Promise<StoredSubscriberCtor>;\n    /** The resolved class. A server-host registration carries it from the start, a lazy one fills it on first resolve. */\n    ctor?: StoredSubscriberCtor | undefined;\n}\n\n/**\n * Registers and dispatches subscribers. Subscribers run on a programmatic or framework publish.\n * Accessed via `core.bus`. Do not construct it directly.\n */\nexport class Bus extends TypedEventEmitter<SubscriptionTuples> {\n    /** @internal */\n    public readonly logger = new Logger('Subscribers', { channel: 'subscribers' });\n\n    private readonly subscribersMap = new Map<SubscriptionKey, SubscriberRegistration[]>();\n    private readonly executedOnce = new Set<SubscriberRegistration>();\n    // url -> env keys, filled as reporters register and read once by verifyWebhooks\n    private readonly webhookProbes = new Map<string, string[]>();\n\n    constructor(protected core: CoreBase) {\n        super();\n    }\n\n    /**\n     * Registers the two shipped webhook reporters. The host calls this during startup, keeping the\n     * url validation inside `start()` where a failure can still release the singleton guard.\n     *\n     * @internal\n     */\n    public registerDefaults(): void {\n        this.register(registrationFor(UnknownException));\n        this.register(registrationFor(HandledException));\n    }\n\n    /** @internal */\n    public register(registration: SubscriberRegistration): void {\n        // a url-less reporter never registers, so a publish on its key does not reach a disabled sender\n        if (registration.ctor && !this.probeWebhook(registration.ctor)) return;\n\n        for (const key of registration.keys) {\n            let registrations = this.subscribersMap.get(key);\n            if (!registrations) {\n                registrations = [];\n                this.subscribersMap.set(key, registrations);\n            }\n            registrations.push(registration);\n        }\n    }\n\n    /** @internal */\n    public unregister(ctor: StoredSubscriberCtor, keys?: readonly SubscriptionKey[]): void {\n        for (const key of keys ?? [...this.subscribersMap.keys()]) {\n            const registrations = this.subscribersMap.get(key);\n            if (!registrations) continue;\n            const index = registrations.findIndex((entry) => entry.ctor === ctor);\n            if (index !== -1) registrations.splice(index, 1);\n        }\n        // registration identity carries the once state, so a restored subscriber runs again after a rollback\n    }\n\n    /** @internal */\n    public get registeredCount(): number {\n        return [...this.subscribersMap.values()].reduce((total, entries) => total + entries.length, 0);\n    }\n\n    /** @internal Only eagerly registered reporters are probed, which is every server-host one. */\n    public async verifyWebhooks(): Promise<void> {\n        const missing: string[] = [];\n        await Promise.all(\n            [...this.webhookProbes].map(async ([url, envKeys]) => {\n                const result = await WebhookLog.senderFor(url).verify();\n                if (result === 'missing') missing.push(...envKeys);\n                else if (result === 'unreachable')\n                    this.logger.warn(`could not verify webhook at ${paint.sky.bold(envKeys.join(', '))}`);\n            })\n        );\n        // initial boot reports all missing webhooks\n        if (missing.length > 0) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookNotFound, [missing.join(', ')]);\n    }\n\n    /** Returns whether the class should register. */\n    private probeWebhook(ctor: StoredSubscriberCtor): boolean {\n        if (!(ctor.prototype instanceof WebhookLog)) return true;\n\n        const envKey = WebhookLog.envKeyOf(ctor);\n        const url = WebhookLog.urlOf(envKey);\n        if (url === null) {\n            this.logger.warn(`${chalk.bold(ctor.name)} disabled, ${paint.sky.bold(envKey)} is not set`);\n            return false;\n        }\n        const envKeys = this.webhookProbes.get(url) ?? [];\n        if (!envKeys.includes(envKey)) envKeys.push(envKey);\n        this.webhookProbes.set(url, envKeys);\n        return true;\n    }\n\n    /**\n     * Publishes an event to its subscribers and native listeners.\n     *\n     * Fire-and-forget, so subscriber handlers run asynchronously and this returns before they\n     * complete, and callers must not assume side effects have completed. Errors thrown by a subscriber\n     * or by an `on()` listener are caught and logged, never surfaced here. One throwing listener\n     * does not stop the others. Subscribers on one key run concurrently and carry no ordering\n     * guarantee. A `'once'` subscriber is marked as executed when it starts (even if it throws), so\n     * it never runs twice.\n     *\n     * The framework's own keys are excluded. Subscribe to those and listen with `on`. The framework\n     * is their only publisher.\n     *\n     * @param event - The subscription key to publish\n     * @param data - Payload passed to each subscriber\n     * @returns Whether the underlying emitter had native listeners for the event\n     */\n    public publish<KeyOfSubscribers extends PublishableKey>(\n        event: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): boolean {\n        return this.dispatchKey(event, data);\n    }\n\n    /** @internal the framework's own publish path, keyed by a symbol no public entry exports */\n    public [PublishDefault]<KeyOfSubscribers extends keyof DefaultSubscriptions>(\n        event: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): boolean {\n        return this.dispatchKey(event, data);\n    }\n\n    private dispatchKey<KeyOfSubscribers extends SubscriptionKey>(\n        event: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): boolean {\n        void this.processSubscriber(event, data);\n        // justified: a generic key can't reduce SubscriptionTuples[K], but data is this event's payload by the signature\n        return this.emitSafe(event, ...([data] as SubscriptionTuples[KeyOfSubscribers]));\n    }\n\n    protected override onListenerError(error: unknown, event: string | symbol): void {\n        this.logger.error(`listener for ${String(event)} threw`, error);\n    }\n\n    private async processSubscriber<KeyOfSubscribers extends SubscriptionKey>(\n        subscriberName: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): Promise<void> {\n        const registrations = this.subscribersMap.get(subscriberName);\n        if (!registrations) return;\n\n        const pending = registrations.reduce<Promise<void>[]>((acc, entry) => {\n            if (entry.frequency === 'once') {\n                if (this.executedOnce.has(entry)) return acc;\n                // mark before awaiting, so a re-entrant publish can't run a 'once' subscriber twice mid-flight\n                this.executedOnce.add(entry);\n            }\n            acc.push(this.runSubscriber(entry, subscriberName, data));\n            return acc;\n        }, []);\n\n        await Promise.allSettled(pending);\n    }\n\n    private async runSubscriber<KeyOfSubscribers extends SubscriptionKey>(\n        entry: SubscriberRegistration,\n        subscriberName: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): Promise<void> {\n        // named outside the try so the catch can report which subscriber threw, several run per key\n        let name = '<unresolved>';\n        try {\n            entry.ctor ??= await entry.resolve();\n            // the registration keys each subscriber to its subscriptions, so data matches this ctor's payload arm\n            const Ctor = entry.ctor as new (\n                data: AllSubscriptions[KeyOfSubscribers],\n                core: CoreBase\n            ) => Subscriber<KeyOfSubscribers, CoreBase>;\n            name = Ctor.name;\n            await new Ctor(data, this.core).execute();\n        } catch (err) {\n            this.logger.error(`Error in subscriber ${String(subscriberName)} handler ${paint.sky.bold(name)}:`, err);\n        }\n    }\n}\n\n// callers gate on the Subscribe metadata, so it is present\n/** @internal */\nexport function registrationFor(ctor: StoredSubscriberCtor): SubscriberRegistration {\n    const meta = Reflect.getMetadata(SubscribeMetadataKey, ctor) as SubscribeMetadataEntry;\n    return { keys: [meta.subscriber], frequency: meta.frequency ?? 'on', resolve: () => ctor, ctor };\n}\n"],"mappings":"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"}
+{"version":3,"file":"subscribers-xO6DZ-70.mjs","names":[],"sources":["../src/subscribers/Subscriber.ts","../src/subscribers/bases/webhookHelpers.ts","../src/subscribers/bases/WebhookSender.ts","../src/subscribers/bases/WebhookLog.ts","../src/subscribers/decorators/Subscribe.ts","../src/subscribers/decorators/WebhookUrl.ts","../src/subscribers/default/HandledException.ts","../src/subscribers/default/UnknownException.ts","../src/subscribers/Bus.ts"],"sourcesContent":["import { Logger } from '@seedcord/logger';\n\nimport type { SubscriptionKey, AllSubscriptions } from './types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\n\n/**\n * Abstract base class for handling application subscribers.\n *\n * Provides type-safe access to subscribers data and the core framework instance.\n * Extend this class to create custom subscriber handlers.\n *\n * @typeParam KeyOfSubscribers - The specific subscriber type this handler processes\n * @typeParam TCore - The transport's Core\n */\nexport abstract class Subscriber<KeyOfSubscribers extends SubscriptionKey, TCore extends CoreBase> {\n    protected readonly logger: Logger;\n\n    /**\n     * Instantiates the subscriber with event data and core.\n     *\n     * @param data - The subscriber event data\n     * @param core - The core framework instance\n     */\n    constructor(\n        protected readonly data: AllSubscriptions[KeyOfSubscribers],\n        protected readonly core: TCore\n    ) {\n        this.logger = new Logger(this.constructor.name, { channel: 'subscribers' });\n    }\n\n    /**\n     * Executes the subscriber handler logic.\n     */\n    abstract execute(): Promise<void>;\n}\n","import { filterCirculars, stripAnsi } from '@seedcord/utils';\nimport { SeparatorSpacingSize } from 'discord-api-types/v10';\n\nimport { BuilderComponent } from '@components/Component';\n\nimport type { WebhookFile } from './WebhookSender';\n\nconst DISCORD_WEBHOOK_REGEX = new RegExp(\n    String.raw`^https?:\\/\\/(?:canary\\.|ptb\\.)?discord(?:app)?\\.com\\/api\\/webhooks\\/\\d+\\/[\\w$-]+$`\n);\n\nexport function isDiscordWebhookUrl(value: string): boolean {\n    return URL.canParse(value) && DISCORD_WEBHOOK_REGEX.test(value);\n}\n\nexport function jsonAttachment(name: string, description: string, data: unknown): WebhookFile {\n    const content = filterCirculars(data);\n    return { name, description, data: new TextEncoder().encode(JSON.stringify(content, undefined, 2)) };\n}\n\n// the report renders inside a ``` fence, so break any triple-backtick run to keep it from closing early\nexport function neutralizeFences(text: string): string {\n    return text.replaceAll('```', '`​`​`');\n}\n\n/** An error's stack with its direct cause appended (one level), ANSI-stripped for the webhook payload. */\nexport function errorReport(error: Error): string {\n    let report = error.stack ?? `${error.name}: ${error.message}`;\n    if (Error.isError(error.cause)) {\n        const cause = error.cause.stack ?? `${error.cause.name}: ${error.cause.message}`;\n        report += `\\n\\nCaused by:\\n${cause}`;\n    }\n    const stripped = neutralizeFences(stripAnsi(report));\n    // eslint-disable-next-line no-magic-numbers\n    return stripped.length > 1800 ? `${stripped.slice(0, 1799)}…` : stripped;\n}\n\nexport class WebhookSeparator extends BuilderComponent<'separator'> {\n    constructor() {\n        super('separator');\n        this.instance.setSpacing(SeparatorSpacingSize.Small).setDivider(true);\n    }\n}\n","import { DiscordAPIError, REST } from '@discordjs/rest';\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Routes } from 'discord-api-types/v10';\n\nimport type { ReplyFile } from '@seedcord/types';\nimport type { APIMessageTopLevelComponent } from 'discord-api-types/v10';\n\nconst HTTP_NOT_FOUND = 404;\nconst HTTP_UNAUTHORIZED = 401;\n\n/** A file attached to a webhook report. */\nexport interface WebhookFile extends ReplyFile {\n    readonly description: string;\n}\n\n/** The payload {@link WebhookSender.send} posts. */\nexport interface WebhookSendOptions {\n    flags: number;\n    username: string;\n    components: readonly { toJSON(): APIMessageTopLevelComponent }[];\n    files?: readonly WebhookFile[] | undefined;\n}\n\n/**\n * Sends component messages to a Discord webhook through `@discordjs/rest`.\n *\n * @throws A `SeedcordError` when the url does not carry a webhook id and token.\n */\nexport class WebhookSender {\n    private readonly rest = new REST();\n    private readonly route: `/${string}`;\n\n    constructor(url: string) {\n        const match = /\\/webhooks\\/(\\d+)\\/([\\w$-]+)$/.exec(url);\n        // the url is a secret, so the error message never carries it\n        if (!match?.[1] || !match[2]) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookUrlInvalid, ['The url']);\n        this.route = Routes.webhook(match[1], match[2]);\n    }\n\n    /**\n     * Fetches the webhook object, sending no message. Returns `missing` on a 404 or 401 from\n     * Discord and `unreachable` on any other failure.\n     */\n    async verify(): Promise<'ok' | 'missing' | 'unreachable'> {\n        try {\n            await this.rest.get(this.route, { auth: false });\n            return 'ok';\n        } catch (error) {\n            const gone =\n                error instanceof DiscordAPIError &&\n                (error.status === HTTP_NOT_FOUND || error.status === HTTP_UNAUTHORIZED);\n            return gone ? 'missing' : 'unreachable';\n        }\n    }\n\n    async send(options: WebhookSendOptions): Promise<void> {\n        const { flags, username, components, files } = options;\n        await this.rest.post(this.route, {\n            auth: false,\n            // with_components=true makes discord accept a components-v2 payload. wait=true makes it\n            // return payload errors in the response\n            query: new URLSearchParams({ with_components: 'true', wait: 'true' }),\n            body: {\n                flags,\n                username,\n                components: components.map((component) => component.toJSON()),\n                ...(files?.length && {\n                    attachments: files.map((file, id) => ({ id, filename: file.name, description: file.description }))\n                })\n            },\n            ...(files?.length && { files: files.map((file) => ({ name: file.name, data: file.data })) })\n        });\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport chalk from 'chalk';\nimport { Converters, Envapter } from 'envapt';\n\nimport { sendFlags } from '@reply/flags';\nimport { WebhookUrlMetadataKey } from '@src/metadataKeys';\n\nimport { Subscriber } from '../Subscriber';\nimport { isDiscordWebhookUrl } from './webhookHelpers';\nimport { WebhookSender } from './WebhookSender';\n\nimport type { WebhookFile } from './WebhookSender';\nimport type { SubscriptionKey } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { APIMessageTopLevelComponent } from 'discord-api-types/v10';\n\n/**\n * The content a reporter returns from {@link WebhookLog.report}.\n */\nexport interface WebhookReport {\n    /** Shown as the webhook message author. Defaults to the reporter's class name. */\n    username?: string;\n    components: readonly { toJSON(): APIMessageTopLevelComponent }[];\n    files?: readonly WebhookFile[] | undefined;\n}\n\n/**\n * Base class for subscribers that deliver their event to a Discord webhook.\n *\n * Declare the url's environment variable with `@WebhookUrl` and implement {@link report}. Url\n * resolution, validation, sender reuse, and sending run in the base. When the variable is unset\n * the reporter is skipped at registration with a boot warning.\n *\n * @typeParam KeyOfSubscribers - The subscription key this reporter receives\n * @typeParam TCore - The transport's Core\n */\nexport abstract class WebhookLog<KeyOfSubscribers extends SubscriptionKey, TCore extends CoreBase> extends Subscriber<\n    KeyOfSubscribers,\n    TCore\n> {\n    private static readonly senders = new Map<string, WebhookSender>();\n\n    /** Builds the message for one published event. */\n    abstract report(): WebhookReport | Promise<WebhookReport>;\n\n    async execute(): Promise<void> {\n        const url = WebhookLog.urlOf(WebhookLog.envKeyOf(this.constructor));\n        if (url === null) {\n            // a server host skips url-less reporters at registration, an edge host registers lazily and reaches this branch\n            this.logger.warn(`${chalk.bold(this.constructor.name)} has no webhook url set, this reporter is disabled`);\n            return;\n        }\n\n        const { username, components, files } = await this.report();\n        try {\n            await WebhookLog.senderFor(url).send({\n                flags: sendFlags({ ephemeral: false }),\n                username: username ?? this.constructor.name,\n                components,\n                files\n            });\n        } catch (error) {\n            this.logger.error('Failed to send webhook report', error);\n        }\n    }\n\n    /** @internal */\n    static senderFor(url: string): WebhookSender {\n        let sender = WebhookLog.senders.get(url);\n        if (!sender) {\n            sender = new WebhookSender(url);\n            WebhookLog.senders.set(url, sender);\n        }\n        return sender;\n    }\n\n    /** @internal */\n    static envKeyOf(ctor: NewableFunction): string {\n        const envKey = Reflect.getMetadata(WebhookUrlMetadataKey, ctor) as string | undefined;\n        if (!envKey) throw new SeedcordError(SeedcordErrorCode.DecoratorWebhookUrlMissing, [ctor.name]);\n        return envKey;\n    }\n\n    /** @internal Returns null when the env var is unset, throws when set but malformed. */\n    static urlOf(envKey: string): string | null {\n        if (!Envapter.has(envKey)) return null;\n        const raw = Envapter.getRequired(envKey, Converters.String).trim();\n        if (raw === '') return null;\n        if (!isDiscordWebhookUrl(raw)) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookUrlInvalid, [envKey]);\n        return raw;\n    }\n}\n","// the default reporters are decorated at Bus module load, before any entry's own polyfill import runs\nimport 'reflect-metadata';\n\nimport { SubscribeMetadataKey } from '@src/metadataKeys';\n\nimport type { Subscriber } from '../Subscriber';\nimport type { SubscriptionKey } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { EventFrequency } from '@seedcord/types';\nimport type { Constructor } from 'type-fest';\n\n/**\n * Options accepted by the `@Subscribe` decorator.\n */\nexport interface SubscribeOptions {\n    /**\n     * Frequency: `'once'` or `'on'`.\n     *\n     * @defaultValue `'on'`\n     */\n    readonly frequency?: EventFrequency | undefined;\n}\n\n/** @internal */\nexport interface SubscribeMetadataEntry {\n    readonly subscriber: SubscriptionKey;\n    readonly frequency?: EventFrequency | undefined;\n}\n\n/**\n * Registers a subscriber handler class with a specific subscriber event.\n *\n * Associates the decorated class with a subscriber event type for automatic\n * registration and execution when the subscriber is emitted.\n *\n * @typeParam TSubscriber - The subscriber event name to register for\n * @param subscriber - The subscriber event name to register for\n * @param options - Options to configure the subscriber handler registration.\n * @decorator\n * @example\n * ```typescript\n * \\@Subscribe('userJoin')\n * class WelcomeHandler extends Subscriber<'userJoin'> {\n *   async execute() {\n *     // Handle user join event\n *   }\n * }\n * ```\n * @example\n * ```ts\n * \\@Subscribe('userJoin', { frequency: 'once' })\n * // or\n * \\@Subscribe('userJoin')\n * ```\n */\nexport function Subscribe<TSubscriber extends SubscriptionKey>(subscriber: TSubscriber, options?: SubscribeOptions) {\n    return function <HandlerCtor extends Constructor<Subscriber<TSubscriber, CoreBase>>>(\n        constructor: HandlerCtor\n    ): void {\n        const meta: SubscribeMetadataEntry = {\n            subscriber,\n            frequency: options?.frequency\n        };\n\n        Reflect.defineMetadata(SubscribeMetadataKey, meta, constructor);\n    };\n}\n","import 'reflect-metadata';\n\nimport { WebhookUrlMetadataKey } from '@src/metadataKeys';\n\nimport type { WebhookLog } from '../bases/WebhookLog';\nimport type { SubscriptionKey } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { Constructor } from 'type-fest';\n\n/**\n * Declares the environment variable a {@link WebhookLog} reporter reads its webhook url from.\n *\n * An unset variable disables the reporter with a boot warning. A set but malformed value throws\n * at boot.\n *\n * @param envKey - The environment variable name holding the webhook url\n * @decorator\n * @example\n * ```ts\n * \\@Subscribe('memberBanned')\n * \\@WebhookUrl('BAN_LOG_WEBHOOK_URL')\n * class BanLog extends WebhookLog<'memberBanned'> {\n *   report() {\n *     return { components: [new BanCard(this.data).component] };\n *   }\n * }\n * ```\n */\nexport function WebhookUrl(envKey: string) {\n    return function <HandlerCtor extends Constructor<WebhookLog<SubscriptionKey, CoreBase>>>(\n        constructor: HandlerCtor\n    ): void {\n        Reflect.defineMetadata(WebhookUrlMetadataKey, envKey, constructor);\n    };\n}\n","import { stripAnsi } from '@seedcord/utils';\n\nimport { BuilderComponent } from '@components/Component';\n\nimport { jsonAttachment, neutralizeFences, WebhookSeparator } from '../bases/webhookHelpers';\nimport { WebhookLog } from '../bases/WebhookLog';\nimport { Subscribe } from '../decorators/Subscribe';\nimport { WebhookUrl } from '../decorators/WebhookUrl';\n\nimport type { WebhookReport } from '../bases/WebhookLog';\nimport type { AllSubscriptions, FaultSource } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { Notice } from '@stops/Notice';\n\n/**\n * Default subscriber that delivers a reported `Notice` (`report: true`) to a webhook with the\n * denial, the fault source, the threaded uuid, the cause stack, and the raw source as a JSON\n * attachment. The controller boundary throttles identical faults before they reach the bus.\n *\n * Reads its webhook url from HANDLED_EXCEPTION_WEBHOOK_URL. Unset, the reporter is disabled with\n * a boot warning.\n */\n@Subscribe('handledException')\n@WebhookUrl('HANDLED_EXCEPTION_WEBHOOK_URL')\nexport class HandledException extends WebhookLog<'handledException', CoreBase> {\n    report(): WebhookReport {\n        return {\n            username: 'Handled Exception',\n            components: [new HandledExceptionContainer(this.data).component],\n            files: [jsonAttachment('source.json', 'The raw source the fault came from', this.data.source.raw)]\n        };\n    }\n}\n\nclass HandledExceptionContainer extends BuilderComponent<'container'> {\n    constructor(data: AllSubscriptions['handledException']) {\n        super('container');\n\n        const { denial, uuid, source } = data;\n\n        this.instance\n            .addTextDisplayComponents((text) => text.setContent(faultSummary(denial, source)))\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) =>\n                text.setContent(`### UUID \\`${uuid}\\`\\n\\`\\`\\`${neutralizeFences(causeStack(denial))}\\`\\`\\``)\n            )\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) => text.setContent('### Source'))\n            .addFileComponents((file) => file.setURL('attachment://source.json'));\n    }\n}\n\nfunction faultSummary(denial: Notice, source: FaultSource): string {\n    // name and message carry chalk, the webhook payload renders them raw\n    const head = stripAnsi(`### A handled fault was reported: \\`${denial.name}\\`\\n**Message:** ${denial.message}\\n`);\n    if (source.kind === 'event') {\n        return (\n            `${head}**Event:** ${source.eventName}\\n` +\n            `**Handler:** ${source.handler}\\n` +\n            `**User ID:** \\`${source.userId ?? 'n/a'}\\`\\n` +\n            `**Guild ID:** \\`${source.guildId ?? 'n/a'}\\`\\n` +\n            `**Channel ID:** \\`${source.channelId ?? 'n/a'}\\``\n        );\n    }\n    return (\n        `${head}**Kind:** ${source.interactionKind}\\n` +\n        `**Command:** ${source.command ?? 'n/a'}\\n` +\n        `**CustomId:** ${source.customId ?? 'n/a'}\\n` +\n        `**User ID:** \\`${source.userId}\\`\\n` +\n        `**Guild ID:** \\`${source.guildId ?? 'n/a'}\\`\\n` +\n        `**Channel ID:** \\`${source.channelId ?? 'n/a'}\\`\\n` +\n        `**Interaction ID:** \\`${source.interactionId}\\``\n    );\n}\n\n// every cause shape returns a string, building the report never throws on a bigint or circular cause\nfunction causeStack(denial: Notice): string {\n    const { cause } = denial;\n    if (Error.isError(cause)) return stripAnsi(cause.stack ?? cause.message);\n    if (typeof cause === 'string') return stripAnsi(cause);\n    if (typeof cause === 'bigint' || typeof cause === 'symbol' || typeof cause === 'function') return cause.toString();\n    if (cause !== undefined) {\n        try {\n            return JSON.stringify(cause);\n        } catch {\n            return '[unserializable cause]';\n        }\n    }\n    return stripAnsi(denial.stack ?? 'No cause recorded.');\n}\n","import { DiscordAPIError } from '@discordjs/rest';\nimport { timestampFromSnowflake } from '@seedcord/utils';\n\nimport { BuilderComponent } from '@components/Component';\n\nimport { errorReport, jsonAttachment, WebhookSeparator } from '../bases/webhookHelpers';\nimport { WebhookLog } from '../bases/WebhookLog';\nimport { Subscribe } from '../decorators/Subscribe';\nimport { WebhookUrl } from '../decorators/WebhookUrl';\n\nimport type { WebhookReport } from '../bases/WebhookLog';\nimport type { AllSubscriptions } from '../types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\n\n/**\n * Default subscriber that reports an unhandled exception to a webhook: the stack trace, the guild\n * and user, a tracking uuid, interaction timestamps when available, and the error metadata as a\n * JSON attachment.\n *\n * Reads its webhook url from UNKNOWN_EXCEPTION_WEBHOOK_URL. Unset, the reporter is disabled with\n * a boot warning.\n */\n@Subscribe('unknownException')\n@WebhookUrl('UNKNOWN_EXCEPTION_WEBHOOK_URL')\nexport class UnknownException extends WebhookLog<'unknownException', CoreBase> {\n    report(): WebhookReport {\n        const { metadata } = this.data;\n        return {\n            username: 'Unknown Exception',\n            components: [new UnhandledErrorContainer(this.data).component],\n            files: metadata\n                ? [jsonAttachment('metadata.json', 'Metadata associated with the error', metadata)]\n                : undefined\n        };\n    }\n}\n\nclass UnhandledErrorContainer extends BuilderComponent<'container'> {\n    constructor(data: AllSubscriptions['unknownException']) {\n        super('container');\n\n        const { uuid, error, guild, user, metadata } = data;\n\n        this.instance\n            .addTextDisplayComponents((text) =>\n                text.setContent(\n                    `### An unknown exception was thrown\\n` +\n                        `**Guild ID:** \\`${guild?.id ?? 'Not used in a guild'}\\`\\n` +\n                        `**Guild Name:** ${guild?.name ?? 'Not used in a guild'}\\n` +\n                        `**User ID:** \\`${user?.id ?? 'Missing user info'}\\`\\n` +\n                        `**Username:** ${user?.username ?? 'Missing user info'}\\n`\n                )\n            )\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) =>\n                text.setContent(`### UUID \\`${uuid}\\`\\n\\`\\`\\`${errorReport(error)}\\`\\`\\``)\n            );\n\n        this.addTimestampsIfAvailable(error);\n        this.addMetadataIfAvailable(metadata);\n    }\n\n    private addTimestampsIfAvailable(error: Error): void {\n        if (!(error instanceof DiscordAPIError)) return;\n\n        const now = Date.now();\n\n        const snowflake = error.url.match(/\\/interactions\\/(\\d+)\\//)?.[1];\n        if (!snowflake) return undefined;\n\n        const interactionTs = timestampFromSnowflake(snowflake);\n\n        const diff = now - interactionTs;\n        const seconds = Math.floor(diff / 1000);\n        const millis = diff % 1000;\n\n        this.instance\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) =>\n                text.setContent(\n                    `### Timestamps\\n` +\n                        `- **\\`Interaction sent\\` :** ${new Date(interactionTs).toISOString()} (${interactionTs})\\n` +\n                        `- **\\`Error logged    \\` :** ${new Date(now).toISOString()} (${now})\\n` +\n                        `- **\\`Offset          \\` :** ${seconds}s ${millis}ms`\n                )\n            );\n    }\n\n    private addMetadataIfAvailable(metadata: unknown): void {\n        if (!metadata) return;\n\n        this.instance\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) => text.setContent('### Metadata'))\n            .addFileComponents((file) => file.setURL('attachment://metadata.json'));\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { TypedEventEmitter } from '@seedcord/event-emitter';\nimport { Logger, paint } from '@seedcord/logger';\nimport chalk from 'chalk';\n\nimport { SubscribeMetadataKey } from '@src/metadataKeys';\n\nimport { WebhookLog } from './bases/WebhookLog';\nimport { HandledException } from './default/HandledException';\nimport { UnknownException } from './default/UnknownException';\nimport { PublishDefault } from './publishDefault';\n\nimport type { SubscribeMetadataEntry } from './decorators/Subscribe';\nimport type { Subscriber } from './Subscriber';\nimport type {\n    AllSubscriptions,\n    DefaultSubscriptions,\n    PublishableKey,\n    SubscriptionKey,\n    SubscriptionTuples\n} from './types/Subscriptions';\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { EventFrequency } from '@seedcord/types';\n\n/**\n * A subscriber class as the Bus stores it. Both parameters are `never` because construct-signature\n * parameters check contravariantly, and a concrete subscriber narrows each to its own payload and\n * transport `Core`. One cast at dispatch restores both.\n *\n * @internal\n */\nexport type StoredSubscriberCtor = new (data: never, core: never) => Subscriber<SubscriptionKey, CoreBase>;\n\n/**\n * One registration. `resolve` is lazy so an edge host registers from a manifest row without\n * importing the module until that key first publishes.\n *\n * @internal\n */\nexport interface SubscriberRegistration {\n    readonly keys: readonly SubscriptionKey[];\n    readonly frequency: EventFrequency;\n    readonly resolve: () => StoredSubscriberCtor | Promise<StoredSubscriberCtor>;\n    /** The resolved class. A server-host registration carries it from the start, a lazy one fills it on first resolve. */\n    ctor?: StoredSubscriberCtor | undefined;\n}\n\n/**\n * Registers and dispatches subscribers. Subscribers run on a programmatic or framework publish.\n * Accessed via `core.bus`. Do not construct it directly.\n */\nexport class Bus extends TypedEventEmitter<SubscriptionTuples> {\n    /** @internal */\n    public readonly logger = new Logger('Subscribers', { channel: 'subscribers' });\n\n    private readonly subscribersMap = new Map<SubscriptionKey, SubscriberRegistration[]>();\n    private readonly executedOnce = new Set<SubscriberRegistration>();\n    // url -> env keys, filled as reporters register and read once by verifyWebhooks\n    private readonly webhookProbes = new Map<string, string[]>();\n\n    constructor(protected core: CoreBase) {\n        super();\n    }\n\n    /**\n     * Registers the two shipped webhook reporters. The host calls this during startup, keeping the\n     * url validation inside `start()` where a failure can still release the singleton guard.\n     *\n     * @internal\n     */\n    public registerDefaults(): void {\n        this.register(registrationFor(UnknownException));\n        this.register(registrationFor(HandledException));\n    }\n\n    /** @internal */\n    public register(registration: SubscriberRegistration): void {\n        // a url-less reporter never registers, so a publish on its key does not reach a disabled sender\n        if (registration.ctor && !this.probeWebhook(registration.ctor)) return;\n\n        for (const key of registration.keys) {\n            let registrations = this.subscribersMap.get(key);\n            if (!registrations) {\n                registrations = [];\n                this.subscribersMap.set(key, registrations);\n            }\n            registrations.push(registration);\n        }\n    }\n\n    /** @internal */\n    public unregister(ctor: StoredSubscriberCtor, keys?: readonly SubscriptionKey[]): void {\n        for (const key of keys ?? [...this.subscribersMap.keys()]) {\n            const registrations = this.subscribersMap.get(key);\n            if (!registrations) continue;\n            const index = registrations.findIndex((entry) => entry.ctor === ctor);\n            if (index !== -1) registrations.splice(index, 1);\n        }\n        // registration identity carries the once state, so a restored subscriber runs again after a rollback\n    }\n\n    /** @internal */\n    public get registeredCount(): number {\n        return [...this.subscribersMap.values()].reduce((total, entries) => total + entries.length, 0);\n    }\n\n    /** @internal Only eagerly registered reporters are probed, which is every server-host one. */\n    public async verifyWebhooks(): Promise<void> {\n        const missing: string[] = [];\n        await Promise.all(\n            [...this.webhookProbes].map(async ([url, envKeys]) => {\n                const result = await WebhookLog.senderFor(url).verify();\n                if (result === 'missing') missing.push(...envKeys);\n                else if (result === 'unreachable')\n                    this.logger.warn(`could not verify webhook at ${paint.sky.bold(envKeys.join(', '))}`);\n            })\n        );\n        // initial boot reports all missing webhooks\n        if (missing.length > 0) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookNotFound, [missing.join(', ')]);\n    }\n\n    /** Returns whether the class should register. */\n    private probeWebhook(ctor: StoredSubscriberCtor): boolean {\n        if (!(ctor.prototype instanceof WebhookLog)) return true;\n\n        const envKey = WebhookLog.envKeyOf(ctor);\n        const url = WebhookLog.urlOf(envKey);\n        if (url === null) {\n            this.logger.warn(`${chalk.bold(ctor.name)} disabled, ${paint.sky.bold(envKey)} is not set`);\n            return false;\n        }\n        const envKeys = this.webhookProbes.get(url) ?? [];\n        if (!envKeys.includes(envKey)) envKeys.push(envKey);\n        this.webhookProbes.set(url, envKeys);\n        return true;\n    }\n\n    /**\n     * Publishes an event to its subscribers and native listeners.\n     *\n     * Fire-and-forget, so subscriber handlers run asynchronously and this returns before they\n     * complete, and callers must not assume side effects have completed. Errors thrown by a subscriber\n     * or by an `on()` listener are caught and logged, never surfaced here. One throwing listener\n     * does not stop the others. Subscribers on one key run concurrently and carry no ordering\n     * guarantee. A `'once'` subscriber is marked as executed when it starts (even if it throws), so\n     * it never runs twice.\n     *\n     * The framework's own keys are excluded. Subscribe to those and listen with `on`. The framework\n     * is their only publisher.\n     *\n     * @param event - The subscription key to publish\n     * @param data - Payload passed to each subscriber\n     * @returns Whether the underlying emitter had native listeners for the event\n     */\n    public publish<KeyOfSubscribers extends PublishableKey>(\n        event: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): boolean {\n        return this.dispatchKey(event, data);\n    }\n\n    /** @internal the framework's own publish path, keyed by a symbol no public entry exports */\n    public [PublishDefault]<KeyOfSubscribers extends keyof DefaultSubscriptions>(\n        event: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): boolean {\n        return this.dispatchKey(event, data);\n    }\n\n    private dispatchKey<KeyOfSubscribers extends SubscriptionKey>(\n        event: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): boolean {\n        void this.processSubscriber(event, data);\n        // justified: a generic key can't reduce SubscriptionTuples[K], but data is this event's payload by the signature\n        return this.emitSafe(event, ...([data] as SubscriptionTuples[KeyOfSubscribers]));\n    }\n\n    protected override onListenerError(error: unknown, event: string | symbol): void {\n        this.logger.error(`listener for ${String(event)} threw`, error);\n    }\n\n    private async processSubscriber<KeyOfSubscribers extends SubscriptionKey>(\n        subscriberName: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): Promise<void> {\n        const registrations = this.subscribersMap.get(subscriberName);\n        if (!registrations) return;\n\n        const pending = registrations.reduce<Promise<void>[]>((acc, entry) => {\n            if (entry.frequency === 'once') {\n                if (this.executedOnce.has(entry)) return acc;\n                // mark before awaiting, so a re-entrant publish can't run a 'once' subscriber twice mid-flight\n                this.executedOnce.add(entry);\n            }\n            acc.push(this.runSubscriber(entry, subscriberName, data));\n            return acc;\n        }, []);\n\n        await Promise.allSettled(pending);\n    }\n\n    private async runSubscriber<KeyOfSubscribers extends SubscriptionKey>(\n        entry: SubscriberRegistration,\n        subscriberName: KeyOfSubscribers,\n        data: AllSubscriptions[KeyOfSubscribers]\n    ): Promise<void> {\n        // named outside the try so the catch can report which subscriber threw, several run per key\n        let name = '<unresolved>';\n        try {\n            entry.ctor ??= await entry.resolve();\n            // the registration keys each subscriber to its subscriptions, so data matches this ctor's payload arm\n            const Ctor = entry.ctor as new (\n                data: AllSubscriptions[KeyOfSubscribers],\n                core: CoreBase\n            ) => Subscriber<KeyOfSubscribers, CoreBase>;\n            name = Ctor.name;\n            await new Ctor(data, this.core).execute();\n        } catch (err) {\n            this.logger.error(`Error in subscriber ${String(subscriberName)} handler ${paint.sky.bold(name)}:`, err);\n        }\n    }\n}\n\n// callers gate on the Subscribe metadata, so it is present\n/** @internal */\nexport function registrationFor(ctor: StoredSubscriberCtor): SubscriberRegistration {\n    const meta = Reflect.getMetadata(SubscribeMetadataKey, ctor) as SubscribeMetadataEntry;\n    return { keys: [meta.subscriber], frequency: meta.frequency ?? 'on', resolve: () => ctor, ctor };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@seedcord/core",
   "type": "module",
-  "version": "0.1.0",
+  "version": "0.1.1-next.0",
+  "engines": {
+    "node": ">=24.11"
+  },
   "description": "Transport-agnostic core for Seedcord bots",
   "repository": {
     "type": "git",
@@ -73,23 +76,23 @@
   },
   "dependencies": {
     "@discordjs/builders": "^1.14.1",
-    "@discordjs/rest": "^2.6.2",
-    "chalk": "^5.6.2",
-    "discord-api-types": "^0.38.51",
-    "envapt": "^8.1.0",
-    "@seedcord/errors": "0.3.0",
-    "@seedcord/event-emitter": "0.1.0",
-    "@seedcord/logger": "0.1.0",
-    "@seedcord/types": "0.8.0",
-    "@seedcord/utils": "0.8.0"
+    "@discordjs/rest": "^2.6.3",
+    "chalk": "^6.0.0",
+    "discord-api-types": "^0.38.52",
+    "envapt": "^8.1.1",
+    "@seedcord/errors": "0.3.1-next.0",
+    "@seedcord/event-emitter": "0.1.1-next.0",
+    "@seedcord/logger": "0.1.1-next.0",
+    "@seedcord/types": "0.8.1-next.0",
+    "@seedcord/utils": "0.8.1-next.0"
   },
   "devDependencies": {
     "reflect-metadata": "^0.2.2",
-    "type-fest": "^5.7.0",
-    "vite": "^8.0.16",
-    "@seedcord/eslint-config": "1.5.0",
-    "@seedcord/rate-limiter": "0.1.0",
-    "@seedcord/tsconfig": "2.0.1",
+    "type-fest": "^5.8.0",
+    "vite": "^8.2.0",
+    "@seedcord/eslint-config": "1.5.1-next.0",
+    "@seedcord/rate-limiter": "0.1.1-next.0",
+    "@seedcord/tsconfig": "2.0.2-next.0",
     "@seedcord/tsdown-config": "2.0.1",
     "@seedcord/vitest-config": "0.0.1"
   },

package/dist/HmrModuleHandler-3sNgKHdf.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"HmrModuleHandler-3sNgKHdf.mjs","names":[],"sources":["../src/hmr/HmrModuleHandler.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { resolve, sep } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\n\nimport type { Logger } from '@seedcord/logger';\nimport type { HmrUpdateEvent } from '@seedcord/types';\n\ninterface HmrStore<THandler, TMiddleware, TArtifacts> {\n    fileToHandlers: Map<string, Set<THandler>>;\n    fileToMiddlewares: Map<string, Set<TMiddleware>>;\n    handlerArtifacts: Map<THandler, TArtifacts>;\n}\n\n// justified: units are caller-supplied classes, name is read for log labels only\nconst displayName = (unit: unknown, fallback: string): string => (unit as { name?: string }).name ?? fallback;\n\ninterface HmrModuleHandlerOptions<THandler, TMiddleware = void, TArtifacts = unknown> {\n    handlersDir: string;\n    middlewaresDir?: string;\n    isHandler: (val: unknown) => val is THandler;\n    isMiddleware?: (val: unknown) => val is TMiddleware;\n    registerHandler: (handler: THandler, file: string) => void;\n    registerMiddleware?: (middleware: TMiddleware, file: string) => void;\n    unregisterHandler: (handler: THandler, artifacts?: TArtifacts) => void;\n    unregisterMiddleware?: (middleware: TMiddleware) => void;\n    /** Snapshotted per handler so a rollback re-registers with the same artifacts after the module re-imports. */\n    getArtifacts?: (handler: THandler) => TArtifacts;\n    logger: Logger;\n}\n\n/**\n * Reloads THandler and optional TMiddleware modules on HMR updates.\n *\n * Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.\n *\n * This is only useful during development.\n */\nexport class HmrModuleHandler<THandler, TMiddleware = void, TArtifacts = unknown> {\n    private readonly store: HmrStore<THandler, TMiddleware, TArtifacts>;\n    private readonly options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>;\n\n    constructor(options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>) {\n        // the caller's options object stays unmutated\n        this.options = { ...options, logger: options.logger.inChannel('hmr') };\n\n        // no import.meta.hot.data stash needed, a leaf reload never reconstructs the singleton that holds these Maps\n        this.store = {\n            fileToHandlers: new Map(),\n            fileToMiddlewares: new Map(),\n            handlerArtifacts: new Map()\n        };\n    }\n\n    /** Unloads or reloads the modules affected by an {@link HmrUpdateEvent}, scoped to the handler and middleware directories. */\n    public async handle(event: HmrUpdateEvent): Promise<void> {\n        const { file, affectedModules, type } = event;\n        const { logger, handlersDir, middlewaresDir } = this.options;\n\n        if (type === 'delete' || type === 'deleteDir') {\n            this.unload(file);\n            return;\n        }\n\n        // a directory is never importable, its files arrive as their own create events\n        if (type === 'createDir') return;\n\n        if (type === 'update' && !existsSync(file)) {\n            if (this.isTracked(file)) {\n                logger.info(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);\n                this.unload(file);\n            }\n            return;\n        }\n\n        const rollbackEnabled = event.rollback ?? true;\n        const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];\n        const absHandlersDir = resolve(process.cwd(), handlersDir);\n        const absMiddlewaresDir = middlewaresDir ? resolve(process.cwd(), middlewaresDir) : null;\n\n        for (const fileToReload of filesToReload) {\n            // the separator keeps a sibling dir sharing the prefix (commands-extra vs commands) out\n            const isHandler = fileToReload.startsWith(absHandlersDir + sep);\n            const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + sep) : false;\n\n            if (!isHandler && !isMiddleware) {\n                continue;\n            }\n\n            await this.reloadWithRollback(fileToReload, rollbackEnabled);\n        }\n    }\n\n    private async reloadWithRollback(file: string, rollbackEnabled: boolean): Promise<void> {\n        const { logger } = this.options;\n        const snapshot = this.snapshotUnits(file);\n        this.unload(file);\n\n        const reloaded = await this.reloadFile(file);\n        if (reloaded) return;\n\n        // a failed reload can leave a partial registration\n        this.unload(file);\n        if (!rollbackEnabled) return;\n        if (snapshot.handlers.length === 0 && snapshot.middlewares.length === 0) return;\n\n        // a typo keeps them live until the next good save\n        this.restoreUnits(file, snapshot);\n        logger.warn(`${chalk.yellow.bold('Rolled back')} ${chalk.gray(formatFilePath(file))} to the last-good version`);\n    }\n\n    /** Links the handler to its source file so a later update can unload it. */\n    public trackHandler(file: string, handler: THandler): void {\n        let set = this.store.fileToHandlers.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToHandlers.set(file, set);\n        }\n        set.add(handler);\n\n        if (this.options.getArtifacts) {\n            const artifacts = this.options.getArtifacts(handler);\n            this.store.handlerArtifacts.set(handler, artifacts);\n        }\n    }\n\n    /** Links the middleware to its source file so a later update can unload it. */\n    public trackMiddleware(file: string, middleware: TMiddleware): void {\n        let set = this.store.fileToMiddlewares.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToMiddlewares.set(file, set);\n        }\n        set.add(middleware);\n    }\n\n    private isTracked(file: string): boolean {\n        return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);\n    }\n\n    private unload(file: string): void {\n        const { logger } = this.options;\n        const handlers = this.store.fileToHandlers.get(file);\n        if (handlers) {\n            for (const handler of handlers) {\n                const artifacts = this.store.handlerArtifacts.get(handler);\n                this.options.unregisterHandler(handler, artifacts);\n                this.store.handlerArtifacts.delete(handler);\n                const name = displayName(handler, 'Handler');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToHandlers.delete(file);\n        }\n\n        const middlewares = this.store.fileToMiddlewares.get(file);\n        if (middlewares) {\n            for (const middleware of middlewares) {\n                this.options.unregisterMiddleware?.(middleware);\n                const name = displayName(middleware, 'Middleware');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToMiddlewares.delete(file);\n        }\n    }\n\n    private async reloadFile(file: string): Promise<boolean> {\n        const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;\n\n        if (!existsSync(file)) {\n            logger.info(`File does not exist, skipping reload: ${formatFilePath(file)}`);\n            return false;\n        }\n\n        try {\n            let fileUrl = pathToFileURL(file).href;\n            // vitest has no real vite server managing the module graph, so bust the import cache manually.\n            if (process.env.VITEST === 'true') fileUrl += `?update=${Date.now()}`;\n\n            // justified: a dynamic import resolves to an untyped export map\n            const imported = (await import(fileUrl)) as Record<string, unknown>;\n\n            for (const val of Object.values(imported)) {\n                if (isHandler(val)) {\n                    registerHandler(val, file);\n                    this.trackHandler(file, val);\n                    const name = displayName(val, 'Handler');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                } else if (isMiddleware && registerMiddleware && isMiddleware(val)) {\n                    registerMiddleware(val, file);\n                    this.trackMiddleware(file, val);\n                    const name = displayName(val, 'Middleware');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                }\n            }\n\n            return true;\n        } catch (error) {\n            logger.error(`Failed to reload file: ${file}`, error);\n            return false;\n        }\n    }\n\n    // restoring re-registers the same class objects, so a live db connection survives rollback\n    private snapshotUnits(file: string): { handlers: THandler[]; middlewares: TMiddleware[] } {\n        return {\n            handlers: [...(this.store.fileToHandlers.get(file) ?? [])],\n            middlewares: [...(this.store.fileToMiddlewares.get(file) ?? [])]\n        };\n    }\n\n    private restoreUnits(file: string, snapshot: { handlers: THandler[]; middlewares: TMiddleware[] }): void {\n        for (const handler of snapshot.handlers) {\n            this.options.registerHandler(handler, file);\n            this.trackHandler(file, handler);\n        }\n\n        if (this.options.registerMiddleware) {\n            for (const middleware of snapshot.middlewares) {\n                this.options.registerMiddleware(middleware, file);\n                this.trackMiddleware(file, middleware);\n            }\n        }\n    }\n}\n"],"mappings":";;;;;;;AAiBA,MAAM,eAAe,MAAe,aAA8B,KAA2B,QAAQ;;;;;;;;AAuBrG,IAAa,mBAAb,MAAkF;CAC9E,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAqE;EAE7E,KAAK,UAAU;GAAE,GAAG;GAAS,QAAQ,QAAQ,OAAO,UAAU,KAAK;EAAE;EAGrE,KAAK,QAAQ;GACT,gCAAgB,IAAI,IAAI;GACxB,mCAAmB,IAAI,IAAI;GAC3B,kCAAkB,IAAI,IAAI;EAC9B;CACJ;;CAGA,MAAa,OAAO,OAAsC;EACtD,MAAM,EAAE,MAAM,iBAAiB,SAAS;EACxC,MAAM,EAAE,QAAQ,aAAa,mBAAmB,KAAK;EAErD,IAAI,SAAS,YAAY,SAAS,aAAa;GAC3C,KAAK,OAAO,IAAI;GAChB;EACJ;EAGA,IAAI,SAAS,aAAa;EAE1B,IAAI,SAAS,YAAY,CAAC,WAAW,IAAI,GAAG;GACxC,IAAI,KAAK,UAAU,IAAI,GAAG;IACtB,OAAO,KAAK,0CAA0C,eAAe,IAAI,EAAE,qBAAqB;IAChG,KAAK,OAAO,IAAI;GACpB;GACA;EACJ;EAEA,MAAM,kBAAkB,MAAM,YAAY;EAC1C,MAAM,gBAAgB,mBAAmB,gBAAgB,SAAS,IAAI,kBAAkB,CAAC,IAAI;EAC7F,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,GAAG,WAAW;EACzD,MAAM,oBAAoB,iBAAiB,QAAQ,QAAQ,IAAI,GAAG,cAAc,IAAI;EAEpF,KAAK,MAAM,gBAAgB,eAAe;GAEtC,MAAM,YAAY,aAAa,WAAW,iBAAiB,GAAG;GAC9D,MAAM,eAAe,oBAAoB,aAAa,WAAW,oBAAoB,GAAG,IAAI;GAE5F,IAAI,CAAC,aAAa,CAAC,cACf;GAGJ,MAAM,KAAK,mBAAmB,cAAc,eAAe;EAC/D;CACJ;CAEA,MAAc,mBAAmB,MAAc,iBAAyC;EACpF,MAAM,EAAE,WAAW,KAAK;EACxB,MAAM,WAAW,KAAK,cAAc,IAAI;EACxC,KAAK,OAAO,IAAI;EAGhB,IAAI,MADmB,KAAK,WAAW,IAAI,GAC7B;EAGd,KAAK,OAAO,IAAI;EAChB,IAAI,CAAC,iBAAiB;EACtB,IAAI,SAAS,SAAS,WAAW,KAAK,SAAS,YAAY,WAAW,GAAG;EAGzE,KAAK,aAAa,MAAM,QAAQ;EAChC,OAAO,KAAK,GAAG,MAAM,OAAO,KAAK,aAAa,EAAE,GAAG,MAAM,KAAK,eAAe,IAAI,CAAC,EAAE,0BAA0B;CAClH;;CAGA,AAAO,aAAa,MAAc,SAAyB;EACvD,IAAI,MAAM,KAAK,MAAM,eAAe,IAAI,IAAI;EAC5C,IAAI,CAAC,KAAK;GACN,sBAAM,IAAI,IAAI;GACd,KAAK,MAAM,eAAe,IAAI,MAAM,GAAG;EAC3C;EACA,IAAI,IAAI,OAAO;EAEf,IAAI,KAAK,QAAQ,cAAc;GAC3B,MAAM,YAAY,KAAK,QAAQ,aAAa,OAAO;GACnD,KAAK,MAAM,iBAAiB,IAAI,SAAS,SAAS;EACtD;CACJ;;CAGA,AAAO,gBAAgB,MAAc,YAA+B;EAChE,IAAI,MAAM,KAAK,MAAM,kBAAkB,IAAI,IAAI;EAC/C,IAAI,CAAC,KAAK;GACN,sBAAM,IAAI,IAAI;GACd,KAAK,MAAM,kBAAkB,IAAI,MAAM,GAAG;EAC9C;EACA,IAAI,IAAI,UAAU;CACtB;CAEA,AAAQ,UAAU,MAAuB;EACrC,OAAO,KAAK,MAAM,eAAe,IAAI,IAAI,KAAK,KAAK,MAAM,kBAAkB,IAAI,IAAI;CACvF;CAEA,AAAQ,OAAO,MAAoB;EAC/B,MAAM,EAAE,WAAW,KAAK;EACxB,MAAM,WAAW,KAAK,MAAM,eAAe,IAAI,IAAI;EACnD,IAAI,UAAU;GACV,KAAK,MAAM,WAAW,UAAU;IAC5B,MAAM,YAAY,KAAK,MAAM,iBAAiB,IAAI,OAAO;IACzD,KAAK,QAAQ,kBAAkB,SAAS,SAAS;IACjD,KAAK,MAAM,iBAAiB,OAAO,OAAO;IAC1C,MAAM,OAAO,YAAY,SAAS,SAAS;IAC3C,OAAO,KACH,GAAG,MAAM,IAAI,KAAK,UAAU,EAAE,GAAG,MAAM,KAAK,KAAK,IAAI,EAAE,QAAQ,MAAM,KAAK,eAAe,IAAI,CAAC,GAClG;GACJ;GACA,KAAK,MAAM,eAAe,OAAO,IAAI;EACzC;EAEA,MAAM,cAAc,KAAK,MAAM,kBAAkB,IAAI,IAAI;EACzD,IAAI,aAAa;GACb,KAAK,MAAM,cAAc,aAAa;IAClC,KAAK,QAAQ,uBAAuB,UAAU;IAC9C,MAAM,OAAO,YAAY,YAAY,YAAY;IACjD,OAAO,KACH,GAAG,MAAM,IAAI,KAAK,UAAU,EAAE,GAAG,MAAM,KAAK,KAAK,IAAI,EAAE,QAAQ,MAAM,KAAK,eAAe,IAAI,CAAC,GAClG;GACJ;GACA,KAAK,MAAM,kBAAkB,OAAO,IAAI;EAC5C;CACJ;CAEA,MAAc,WAAW,MAAgC;EACrD,MAAM,EAAE,QAAQ,WAAW,cAAc,iBAAiB,uBAAuB,KAAK;EAEtF,IAAI,CAAC,WAAW,IAAI,GAAG;GACnB,OAAO,KAAK,yCAAyC,eAAe,IAAI,GAAG;GAC3E,OAAO;EACX;EAEA,IAAI;GACA,IAAI,UAAU,cAAc,IAAI,CAAC,CAAC;GAElC,IAAI,QAAQ,IAAI,WAAW,QAAQ,WAAW,WAAW,KAAK,IAAI;GAGlE,MAAM,WAAY,MAAM,OAAO;GAE/B,KAAK,MAAM,OAAO,OAAO,OAAO,QAAQ,GACpC,IAAI,UAAU,GAAG,GAAG;IAChB,gBAAgB,KAAK,IAAI;IACzB,KAAK,aAAa,MAAM,GAAG;IAC3B,MAAM,OAAO,YAAY,KAAK,SAAS;IACvC,OAAO,KACH,GAAG,MAAM,KAAK,KAAK,UAAU,EAAE,GAAG,MAAM,KAAK,KAAK,IAAI,EAAE,QAAQ,MAAM,KAAK,eAAe,IAAI,CAAC,GACnG;GACJ,OAAO,IAAI,gBAAgB,sBAAsB,aAAa,GAAG,GAAG;IAChE,mBAAmB,KAAK,IAAI;IAC5B,KAAK,gBAAgB,MAAM,GAAG;IAC9B,MAAM,OAAO,YAAY,KAAK,YAAY;IAC1C,OAAO,KACH,GAAG,MAAM,KAAK,KAAK,UAAU,EAAE,GAAG,MAAM,KAAK,KAAK,IAAI,EAAE,QAAQ,MAAM,KAAK,eAAe,IAAI,CAAC,GACnG;GACJ;GAGJ,OAAO;EACX,SAAS,OAAO;GACZ,OAAO,MAAM,0BAA0B,QAAQ,KAAK;GACpD,OAAO;EACX;CACJ;CAGA,AAAQ,cAAc,MAAoE;EACtF,OAAO;GACH,UAAU,CAAC,GAAI,KAAK,MAAM,eAAe,IAAI,IAAI,KAAK,CAAC,CAAE;GACzD,aAAa,CAAC,GAAI,KAAK,MAAM,kBAAkB,IAAI,IAAI,KAAK,CAAC,CAAE;EACnE;CACJ;CAEA,AAAQ,aAAa,MAAc,UAAsE;EACrG,KAAK,MAAM,WAAW,SAAS,UAAU;GACrC,KAAK,QAAQ,gBAAgB,SAAS,IAAI;GAC1C,KAAK,aAAa,MAAM,OAAO;EACnC;EAEA,IAAI,KAAK,QAAQ,oBACb,KAAK,MAAM,cAAc,SAAS,aAAa;GAC3C,KAAK,QAAQ,mBAAmB,YAAY,IAAI;GAChD,KAAK,gBAAgB,MAAM,UAAU;EACzC;CAER;AACJ"}

package/dist/HmrModuleHandler-CTBng7wV.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"HmrModuleHandler-CTBng7wV.cjs","names":["sep"],"sources":["../src/hmr/HmrModuleHandler.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { resolve, sep } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\n\nimport type { Logger } from '@seedcord/logger';\nimport type { HmrUpdateEvent } from '@seedcord/types';\n\ninterface HmrStore<THandler, TMiddleware, TArtifacts> {\n    fileToHandlers: Map<string, Set<THandler>>;\n    fileToMiddlewares: Map<string, Set<TMiddleware>>;\n    handlerArtifacts: Map<THandler, TArtifacts>;\n}\n\n// justified: units are caller-supplied classes, name is read for log labels only\nconst displayName = (unit: unknown, fallback: string): string => (unit as { name?: string }).name ?? fallback;\n\ninterface HmrModuleHandlerOptions<THandler, TMiddleware = void, TArtifacts = unknown> {\n    handlersDir: string;\n    middlewaresDir?: string;\n    isHandler: (val: unknown) => val is THandler;\n    isMiddleware?: (val: unknown) => val is TMiddleware;\n    registerHandler: (handler: THandler, file: string) => void;\n    registerMiddleware?: (middleware: TMiddleware, file: string) => void;\n    unregisterHandler: (handler: THandler, artifacts?: TArtifacts) => void;\n    unregisterMiddleware?: (middleware: TMiddleware) => void;\n    /** Snapshotted per handler so a rollback re-registers with the same artifacts after the module re-imports. */\n    getArtifacts?: (handler: THandler) => TArtifacts;\n    logger: Logger;\n}\n\n/**\n * Reloads THandler and optional TMiddleware modules on HMR updates.\n *\n * Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.\n *\n * This is only useful during development.\n */\nexport class HmrModuleHandler<THandler, TMiddleware = void, TArtifacts = unknown> {\n    private readonly store: HmrStore<THandler, TMiddleware, TArtifacts>;\n    private readonly options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>;\n\n    constructor(options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>) {\n        // the caller's options object stays unmutated\n        this.options = { ...options, logger: options.logger.inChannel('hmr') };\n\n        // no import.meta.hot.data stash needed, a leaf reload never reconstructs the singleton that holds these Maps\n        this.store = {\n            fileToHandlers: new Map(),\n            fileToMiddlewares: new Map(),\n            handlerArtifacts: new Map()\n        };\n    }\n\n    /** Unloads or reloads the modules affected by an {@link HmrUpdateEvent}, scoped to the handler and middleware directories. */\n    public async handle(event: HmrUpdateEvent): Promise<void> {\n        const { file, affectedModules, type } = event;\n        const { logger, handlersDir, middlewaresDir } = this.options;\n\n        if (type === 'delete' || type === 'deleteDir') {\n            this.unload(file);\n            return;\n        }\n\n        // a directory is never importable, its files arrive as their own create events\n        if (type === 'createDir') return;\n\n        if (type === 'update' && !existsSync(file)) {\n            if (this.isTracked(file)) {\n                logger.info(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);\n                this.unload(file);\n            }\n            return;\n        }\n\n        const rollbackEnabled = event.rollback ?? true;\n        const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];\n        const absHandlersDir = resolve(process.cwd(), handlersDir);\n        const absMiddlewaresDir = middlewaresDir ? resolve(process.cwd(), middlewaresDir) : null;\n\n        for (const fileToReload of filesToReload) {\n            // the separator keeps a sibling dir sharing the prefix (commands-extra vs commands) out\n            const isHandler = fileToReload.startsWith(absHandlersDir + sep);\n            const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + sep) : false;\n\n            if (!isHandler && !isMiddleware) {\n                continue;\n            }\n\n            await this.reloadWithRollback(fileToReload, rollbackEnabled);\n        }\n    }\n\n    private async reloadWithRollback(file: string, rollbackEnabled: boolean): Promise<void> {\n        const { logger } = this.options;\n        const snapshot = this.snapshotUnits(file);\n        this.unload(file);\n\n        const reloaded = await this.reloadFile(file);\n        if (reloaded) return;\n\n        // a failed reload can leave a partial registration\n        this.unload(file);\n        if (!rollbackEnabled) return;\n        if (snapshot.handlers.length === 0 && snapshot.middlewares.length === 0) return;\n\n        // a typo keeps them live until the next good save\n        this.restoreUnits(file, snapshot);\n        logger.warn(`${chalk.yellow.bold('Rolled back')} ${chalk.gray(formatFilePath(file))} to the last-good version`);\n    }\n\n    /** Links the handler to its source file so a later update can unload it. */\n    public trackHandler(file: string, handler: THandler): void {\n        let set = this.store.fileToHandlers.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToHandlers.set(file, set);\n        }\n        set.add(handler);\n\n        if (this.options.getArtifacts) {\n            const artifacts = this.options.getArtifacts(handler);\n            this.store.handlerArtifacts.set(handler, artifacts);\n        }\n    }\n\n    /** Links the middleware to its source file so a later update can unload it. */\n    public trackMiddleware(file: string, middleware: TMiddleware): void {\n        let set = this.store.fileToMiddlewares.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToMiddlewares.set(file, set);\n        }\n        set.add(middleware);\n    }\n\n    private isTracked(file: string): boolean {\n        return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);\n    }\n\n    private unload(file: string): void {\n        const { logger } = this.options;\n        const handlers = this.store.fileToHandlers.get(file);\n        if (handlers) {\n            for (const handler of handlers) {\n                const artifacts = this.store.handlerArtifacts.get(handler);\n                this.options.unregisterHandler(handler, artifacts);\n                this.store.handlerArtifacts.delete(handler);\n                const name = displayName(handler, 'Handler');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToHandlers.delete(file);\n        }\n\n        const middlewares = this.store.fileToMiddlewares.get(file);\n        if (middlewares) {\n            for (const middleware of middlewares) {\n                this.options.unregisterMiddleware?.(middleware);\n                const name = displayName(middleware, 'Middleware');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToMiddlewares.delete(file);\n        }\n    }\n\n    private async reloadFile(file: string): Promise<boolean> {\n        const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;\n\n        if (!existsSync(file)) {\n            logger.info(`File does not exist, skipping reload: ${formatFilePath(file)}`);\n            return false;\n        }\n\n        try {\n            let fileUrl = pathToFileURL(file).href;\n            // vitest has no real vite server managing the module graph, so bust the import cache manually.\n            if (process.env.VITEST === 'true') fileUrl += `?update=${Date.now()}`;\n\n            // justified: a dynamic import resolves to an untyped export map\n            const imported = (await import(fileUrl)) as Record<string, unknown>;\n\n            for (const val of Object.values(imported)) {\n                if (isHandler(val)) {\n                    registerHandler(val, file);\n                    this.trackHandler(file, val);\n                    const name = displayName(val, 'Handler');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                } else if (isMiddleware && registerMiddleware && isMiddleware(val)) {\n                    registerMiddleware(val, file);\n                    this.trackMiddleware(file, val);\n                    const name = displayName(val, 'Middleware');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                }\n            }\n\n            return true;\n        } catch (error) {\n            logger.error(`Failed to reload file: ${file}`, error);\n            return false;\n        }\n    }\n\n    // restoring re-registers the same class objects, so a live db connection survives rollback\n    private snapshotUnits(file: string): { handlers: THandler[]; middlewares: TMiddleware[] } {\n        return {\n            handlers: [...(this.store.fileToHandlers.get(file) ?? [])],\n            middlewares: [...(this.store.fileToMiddlewares.get(file) ?? [])]\n        };\n    }\n\n    private restoreUnits(file: string, snapshot: { handlers: THandler[]; middlewares: TMiddleware[] }): void {\n        for (const handler of snapshot.handlers) {\n            this.options.registerHandler(handler, file);\n            this.trackHandler(file, handler);\n        }\n\n        if (this.options.registerMiddleware) {\n            for (const middleware of snapshot.middlewares) {\n                this.options.registerMiddleware(middleware, file);\n                this.trackMiddleware(file, middleware);\n            }\n        }\n    }\n}\n"],"mappings":"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"}