@seedcord/core 0.1.4 → 0.2.0

package/dist/Bus-DcuUtOEL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bus-DcuUtOEL.mjs","names":[],"sources":["../src/commands/contextMenuLeaves.ts","../src/metadataKeys.ts","../src/components/botColorHolder.ts","../src/components/builderTypes.ts","../src/components/colors.ts","../src/components/resolveColor.ts","../src/components/Component.ts","../src/reply/flags.ts","../src/subscribers/ReportThrottle.ts","../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/publishDefault.ts","../src/subscribers/Bus.ts"],"sourcesContent":["import { ContextMenuCommandBuilder } from '@discordjs/builders';\nimport { ApplicationCommandType } from 'discord-api-types/v10';\n\nimport type { SlashCommandBuilder } from '@discordjs/builders';\n\n/** @internal */\nexport interface ContextMenuLeaves {\n    readonly user: Set<string>;\n    readonly message: Set<string>;\n}\n\n/**\n * dedupes names across builders, since the same builder repeats once per guild.\n * a user and a message command can share a name.\n *\n * @internal\n */\nexport function contextMenuLeaves(\n    commands: Iterable<SlashCommandBuilder | ContextMenuCommandBuilder>\n): ContextMenuLeaves {\n    const user = new Set<string>();\n    const message = new Set<string>();\n    for (const command of commands) {\n        if (!(command instanceof ContextMenuCommandBuilder)) continue;\n        if (command.type === ApplicationCommandType.User) user.add(command.name);\n        else message.add(command.name);\n    }\n    return { user, message };\n}\n","export enum InteractionRoutes {\n    Slash = 'slash',\n    Button = 'button',\n    Modal = 'modal',\n    StringMenu = 'stringMenu',\n    UserMenu = 'userMenu',\n    RoleMenu = 'roleMenu',\n    ChannelMenu = 'channelMenu',\n    MentionableMenu = 'mentionableMenu',\n    MessageContextMenu = 'messageContextMenu',\n    UserContextMenu = 'userContextMenu',\n    Autocomplete = 'autocomplete'\n}\n\nexport const InteractionMetadataKey = Symbol('seedcord:interaction:metadata');\n\nexport const InteractionRouteKeys: Record<InteractionRoutes, symbol> = {\n    [InteractionRoutes.Slash]: Symbol('seedcord:interaction:slash'),\n    [InteractionRoutes.Button]: Symbol('seedcord:interaction:button'),\n    [InteractionRoutes.Modal]: Symbol('seedcord:interaction:modal'),\n    [InteractionRoutes.StringMenu]: Symbol('seedcord:interaction:stringMenu'),\n    [InteractionRoutes.UserMenu]: Symbol('seedcord:interaction:userMenu'),\n    [InteractionRoutes.RoleMenu]: Symbol('seedcord:interaction:roleMenu'),\n    [InteractionRoutes.ChannelMenu]: Symbol('seedcord:interaction:channelMenu'),\n    [InteractionRoutes.MentionableMenu]: Symbol('seedcord:interaction:mentionableMenu'),\n    [InteractionRoutes.MessageContextMenu]: Symbol('seedcord:interaction:messageContextMenu'),\n    [InteractionRoutes.UserContextMenu]: Symbol('seedcord:interaction:userContextMenu'),\n    [InteractionRoutes.Autocomplete]: Symbol('seedcord:interaction:autocomplete')\n};\n\nexport const MiddlewareMetadataKey = Symbol('seedcord:middleware:metadata');\n\nexport const EventMetadataKey = Symbol('seedcord:event:metadata');\n\nexport const CommandMetadataKey = Symbol('seedcord:command:metadata');\n\nexport const GatedMetadataKey = Symbol('seedcord:gated:metadata');\n\nexport const SubscribeMetadataKey = Symbol('seedcord:subscribe:metadata');\n\nexport const WebhookUrlMetadataKey = Symbol('seedcord:webhookUrl:metadata');\n","import type { BotColor } from '@seedcord/types';\n\n// must be 'Default' so the container guard in applyBotColor leaves the accent unset\nconst DEFAULT_COLOR: BotColor = 'Default';\n\nlet current: BotColor = DEFAULT_COLOR;\n\nexport function setBotColor(color: BotColor | undefined): void {\n    current = color ?? DEFAULT_COLOR;\n}\n\nexport function getBotColor(): BotColor {\n    return current;\n}\n","import {\n    ActionRowBuilder,\n    ButtonBuilder,\n    ChannelSelectMenuBuilder,\n    CheckboxBuilder,\n    CheckboxGroupBuilder,\n    CheckboxGroupOptionBuilder,\n    ContainerBuilder,\n    ContextMenuCommandBuilder,\n    EmbedBuilder,\n    FileBuilder,\n    FileUploadBuilder,\n    LabelBuilder,\n    MediaGalleryBuilder,\n    MentionableSelectMenuBuilder,\n    ModalBuilder,\n    RadioGroupBuilder,\n    RadioGroupOptionBuilder,\n    RoleSelectMenuBuilder,\n    SectionBuilder,\n    SeparatorBuilder,\n    SlashCommandBuilder,\n    SlashCommandSubcommandBuilder,\n    SlashCommandSubcommandGroupBuilder,\n    StringSelectMenuBuilder,\n    StringSelectMenuOptionBuilder,\n    TextDisplayBuilder,\n    TextInputBuilder,\n    UserSelectMenuBuilder\n} from '@discordjs/builders';\n\n/**\n * Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.\n *\n * @internal\n */\nexport const BuilderTypes = {\n    // Command Components\n    command: SlashCommandBuilder,\n    context_menu: ContextMenuCommandBuilder,\n    subcommand: SlashCommandSubcommandBuilder,\n    group: SlashCommandSubcommandGroupBuilder,\n\n    // Embed Components\n    embed: EmbedBuilder,\n\n    // Modal Components\n    modal: ModalBuilder,\n    label: LabelBuilder,\n    text_input: TextInputBuilder,\n    file_upload: FileUploadBuilder,\n    checkbox: CheckboxBuilder,\n    checkbox_group: CheckboxGroupBuilder,\n    checkbox_group_option: CheckboxGroupOptionBuilder,\n    radio_group: RadioGroupBuilder,\n    radio_group_option: RadioGroupOptionBuilder,\n\n    // Action Row Components\n    button: ButtonBuilder,\n    menu_string: StringSelectMenuBuilder,\n    menu_option_string: StringSelectMenuOptionBuilder,\n    menu_user: UserSelectMenuBuilder,\n    menu_channel: ChannelSelectMenuBuilder,\n    menu_mentionable: MentionableSelectMenuBuilder,\n    menu_role: RoleSelectMenuBuilder,\n\n    // ComponentsV2\n    container: ContainerBuilder,\n    text_display: TextDisplayBuilder,\n    file: FileBuilder,\n    media: MediaGalleryBuilder,\n    section: SectionBuilder,\n    separator: SeparatorBuilder\n};\n\n/**\n * Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons\n *\n * @internal\n */\nexport const RowTypes: {\n    button: typeof ActionRowBuilder<ButtonBuilder>;\n    menu_string: typeof ActionRowBuilder<StringSelectMenuBuilder>;\n    menu_user: typeof ActionRowBuilder<UserSelectMenuBuilder>;\n    menu_channel: typeof ActionRowBuilder<ChannelSelectMenuBuilder>;\n    menu_mentionable: typeof ActionRowBuilder<MentionableSelectMenuBuilder>;\n    menu_role: typeof ActionRowBuilder<RoleSelectMenuBuilder>;\n} = {\n    button: ActionRowBuilder<ButtonBuilder>,\n    menu_string: ActionRowBuilder<StringSelectMenuBuilder>,\n    menu_user: ActionRowBuilder<UserSelectMenuBuilder>,\n    menu_channel: ActionRowBuilder<ChannelSelectMenuBuilder>,\n    menu_mentionable: ActionRowBuilder<MentionableSelectMenuBuilder>,\n    menu_role: ActionRowBuilder<RoleSelectMenuBuilder>\n};\n\n/**\n * Available Discord.js builder types for use with BuilderComponent\n */\nexport type BuilderType = keyof typeof BuilderTypes;\n\n/**\n * @internal\n */\nexport type InstantiatedBuilder<BuilderKey extends BuilderType> = InstanceType<(typeof BuilderTypes)[BuilderKey]>;\n\n/**\n * Available Discord.js action row types for use with RowComponent\n */\nexport type RowType = keyof typeof RowTypes;\n\n/**\n * @internal\n */\nexport type InstantiatedActionRow<RowKey extends RowType> = InstanceType<(typeof RowTypes)[RowKey]>;\n","import type { ColorName, TypedOmit } from '@seedcord/types';\n\n// ported verbatim from discord.js (Apache-2.0), src/util/Colors.js\nexport const Colors: TypedOmit<Record<ColorName, number>, 'Random'> = {\n    Aqua: 0x1a_bc_9c,\n    Blue: 0x34_98_db,\n    Blurple: 0x58_65_f2,\n    DarkAqua: 0x11_80_6a,\n    DarkBlue: 0x20_66_94,\n    DarkButNotBlack: 0x2c_2f_33,\n    DarkerGrey: 0x7f_8c_8d,\n    DarkGold: 0xc2_7c_0e,\n    DarkGreen: 0x1f_8b_4c,\n    DarkGrey: 0x97_9c_9f,\n    DarkNavy: 0x2c_3e_50,\n    DarkOrange: 0xa8_43_00,\n    DarkPurple: 0x71_36_8a,\n    DarkRed: 0x99_2d_22,\n    DarkVividPink: 0xad_14_57,\n    Default: 0x00_00_00,\n    Fuchsia: 0xeb_45_9e,\n    Gold: 0xf1_c4_0f,\n    Green: 0x57_f2_87,\n    Grey: 0x95_a5_a6,\n    Greyple: 0x99_aa_b5,\n    LightGrey: 0xbc_c0_c0,\n    LuminousVividPink: 0xe9_1e_63,\n    Navy: 0x34_49_5e,\n    NotQuiteBlack: 0x23_27_2a,\n    Orange: 0xe6_7e_22,\n    Purple: 0x9b_59_b6,\n    Red: 0xed_42_45,\n    White: 0xff_ff_ff,\n    Yellow: 0xfe_e7_5c\n} as const;\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordRangeError, SeedcordTypeError } from '@seedcord/errors/internal';\n\nimport { Colors } from './colors';\n\nimport type { BotColor } from '@seedcord/types';\n\nconst MAX_COLOR = 0xff_ff_ff;\nconst RED_SHIFT = 16;\nconst GREEN_SHIFT = 8;\n\nconst palette: Record<string, number | undefined> = Colors;\n\n/**\n * Resolves a {@link BotColor} to the integer Discord expects.\n *\n * Ported from discord.js (Apache-2.0), `resolveColor` in src/util/Util.js.\n */\nexport function resolveColor(color: BotColor): number {\n    let resolved: number | undefined;\n\n    if (typeof color === 'string') {\n        if (color === 'Random') return Math.floor(Math.random() * (MAX_COLOR + 1));\n        if (color === 'Default') return 0;\n        if (/^#?[\\da-f]{6}$/i.test(color)) return Number.parseInt(color.replace('#', ''), 16);\n        resolved = palette[color];\n    } else if (typeof color === 'number') {\n        resolved = color;\n    } else {\n        resolved = (color[0] << RED_SHIFT) + (color[1] << GREEN_SHIFT) + color[2];\n    }\n\n    if (resolved === undefined || !Number.isSafeInteger(resolved)) {\n        throw new SeedcordTypeError(SeedcordErrorCode.ColorUnresolvable, [JSON.stringify(color)]);\n    }\n    if (resolved < 0 || resolved > MAX_COLOR) {\n        throw new SeedcordRangeError(SeedcordErrorCode.ColorOutOfRange);\n    }\n\n    return resolved;\n}\n","import { ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, SlashCommandBuilder } from '@discordjs/builders';\nimport { InteractionContextType } from 'discord-api-types/v10';\n\nimport { getBotColor } from './botColorHolder';\nimport { BuilderTypes, RowTypes } from './builderTypes';\nimport { resolveColor } from './resolveColor';\n\nimport type { BuilderType, InstantiatedActionRow, InstantiatedBuilder, RowType } from './builderTypes';\n\n/** @internal */\nabstract class BaseComponent<TComponent> {\n    private readonly _component: TComponent;\n\n    protected constructor(ComponentClass: new () => TComponent) {\n        this._component = new ComponentClass();\n    }\n\n    /**\n     * Returns the live builder, ready to send in a Discord message or nest in another component.\n     *\n     * Reading this can apply the bot color (see {@link BuilderComponent}), so it has a side effect.\n     * @example new SomeComponent().component\n     */\n    public abstract get component(): InstantiatedBuilder<BuilderType> | InstantiatedActionRow<RowType>;\n\n    /**\n     * The wrapped builder, for calling Discord.js methods like setTitle() and setDescription() inside a subclass.\n     *\n     * @example this.instance.setTitle('My Modal')\n     */\n    protected get instance(): TComponent {\n        return this._component;\n    }\n}\n\n/**\n * Base class for Discord.js builder components\n *\n * Wraps Discord.js builders (SlashCommandBuilder, EmbedBuilder, etc.) with\n * Seedcord-specific defaults and helper methods.\n *\n * @typeParam BuilderKey - The type of Discord.js builder being wrapped\n */\nexport abstract class BuilderComponent<BuilderKey extends BuilderType> extends BaseComponent<\n    InstantiatedBuilder<BuilderKey>\n> {\n    private colorApplied = false;\n\n    protected constructor(public readonly type: BuilderKey) {\n        const ComponentClass = BuilderTypes[type] as unknown;\n        super(ComponentClass as new () => InstantiatedBuilder<BuilderKey>);\n\n        if (this.instance instanceof SlashCommandBuilder || this.instance instanceof ContextMenuCommandBuilder) {\n            this.instance.setContexts(InteractionContextType.Guild);\n        }\n    }\n\n    get component(): InstantiatedBuilder<BuilderKey> {\n        this.applyBotColor();\n        return this.instance;\n    }\n\n    // Resolving in the constructor would capture the default for a component built before setBotColor()\n    // ran. The unset check keeps a color the subclass set for itself.\n    private applyBotColor(): void {\n        if (this.colorApplied) return;\n        this.colorApplied = true;\n\n        const color = getBotColor();\n        if (this.instance instanceof EmbedBuilder) {\n            if (this.instance.data.color === undefined) this.instance.setColor(resolveColor(color));\n        } else if (this.instance instanceof ContainerBuilder) {\n            const accent = this.instance.data.accent_color;\n            if (accent === null || accent === undefined) {\n                this.instance.setAccentColor(color === 'Default' ? undefined : resolveColor(color));\n            }\n        }\n    }\n}\n\n/**\n * Base class for Discord action row components\n *\n * Wraps Discord.js action row builder with Seedcord-specific defaults and helper methods.\n *\n * @typeParam RowKey - The Discord.js action row type being wrapped\n */\nexport abstract class RowComponent<RowKey extends RowType> extends BaseComponent<InstantiatedActionRow<RowKey>> {\n    protected constructor(public readonly type: RowKey) {\n        const ComponentClass = RowTypes[type] as unknown;\n        super(ComponentClass as new () => InstantiatedActionRow<RowKey>);\n    }\n\n    get component(): InstantiatedActionRow<RowKey> {\n        return this.instance;\n    }\n}\n","import { MessageFlags } from 'discord-api-types/v10';\n\nimport type { DeferOpts, SendOpts } from '@seedcord/types';\n\n// IsComponentsV2 is unconditional, since every framework reply is v2\nexport function sendFlags(opts?: SendOpts): number {\n    let flags = MessageFlags.IsComponentsV2;\n    if (opts?.ephemeral ?? true) flags |= MessageFlags.Ephemeral;\n    if (opts?.silent) flags |= MessageFlags.SuppressNotifications;\n    return flags;\n}\n\n// a deferral carries no content\nexport function deferFlags(opts?: DeferOpts): number {\n    return (opts?.ephemeral ?? true) ? MessageFlags.Ephemeral : 0;\n}\n","interface ThrottleWindow {\n    lastSentAt: number;\n    suppressedSinceSend: number;\n}\n\nexport class ReportThrottle {\n    private static readonly perCore = new WeakMap<object, ReportThrottle>();\n\n    public static for(core: object): ReportThrottle {\n        let throttle = ReportThrottle.perCore.get(core);\n        if (!throttle) {\n            throttle = new ReportThrottle();\n            ReportThrottle.perCore.set(core, throttle);\n        }\n        return throttle;\n    }\n\n    private readonly windows = new Map<string, ThrottleWindow>();\n\n    constructor(\n        private readonly windowMs = 60_000,\n        private readonly now: () => number = () => Date.now()\n    ) {}\n\n    // null while the window is open, otherwise how many were dropped since the last send\n    public take(key: string): number | null {\n        const window = this.windows.get(key);\n        if (window && this.now() - window.lastSentAt < this.windowMs) {\n            window.suppressedSinceSend += 1;\n            return null;\n        }\n\n        const suppressed = window?.suppressedSinceSend ?? 0;\n        this.windows.set(key, { lastSentAt: this.now(), suppressedSinceSend: 0 });\n        return suppressed;\n    }\n\n    // gives a failed send's count to the open window, plus the one card that never went out\n    public restore(key: string, suppressed: number): void {\n        const window = this.windows.get(key);\n        if (window) window.suppressedSinceSend += suppressed + 1;\n    }\n}\n","import { Logger } from '@seedcord/logger';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { SubscriptionKey, AllSubscriptions } from './types/Subscriptions';\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 goes inside a ``` code block, so a stray ``` in the text would close it early\nexport function breakBackticks(text: string): string {\n    return text.replaceAll('```', '`​`​`');\n}\n\n// discord caps a message at 2000 characters. the backticks and heading take the rest.\nconst REPORT_BUDGET = 1800;\n\n// breakBackticks grows the text by 2 chars per run\nfunction body(value: unknown): string {\n    const raw = Error.isError(value) ? (value.stack ?? `${value.name}: ${value.message}`) : String(value);\n    return breakBackticks(stripAnsi(raw));\n}\n\nfunction clamp(text: string, budget: number): string {\n    if (text.length <= budget) return text;\n    return budget > 0 ? `${text.slice(0, budget - 1)}…` : '';\n}\n\nfunction omittedLine(count: number): string {\n    return `\\n\\nand ${count} more failure${count === 1 ? '' : 's'}`;\n}\n\nfunction memberReport(members: readonly unknown[], budget: number): string {\n    // the dropped-count line has to fit even when every member is dropped\n    const room = Math.max(budget - omittedLine(members.length).length, 0);\n    const share = Math.floor(room / members.length);\n\n    let report = '';\n    let shown = 0;\n    for (const [index, member] of members.entries()) {\n        const heading = `\\n\\nFailure ${index + 1} of ${members.length}:\\n`;\n        const entry = heading + clamp(body(member), Math.max(share - heading.length, 0));\n        if (report.length + entry.length > room) break;\n        report += entry;\n        shown++;\n    }\n\n    const hidden = members.length - shown;\n    return hidden > 0 ? report + omittedLine(hidden) : report;\n}\n\n// ansi codes are stripped because discord won't render them\nexport function errorReport(error: Error): string {\n    let head = body(error);\n    if (Error.isError(error.cause)) head += `\\n\\nCaused by:\\n${body(error.cause)}`;\n\n    const members: unknown[] = error instanceof AggregateError ? error.errors : [];\n    if (members.length === 0) return clamp(head, REPORT_BUDGET);\n\n    // a long parent stack would otherwise push the dropped-count line off the end\n    const report = clamp(head, REPORT_BUDGET - omittedLine(members.length).length);\n    return report + memberReport(members, REPORT_BUDGET - report.length);\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\nexport interface WebhookSendOptions {\n    flags: number;\n    username: string;\n    avatarUrl?: string | undefined;\n    components: readonly { toJSON(): APIMessageTopLevelComponent }[];\n    files?: readonly WebhookFile[] | undefined;\n}\n\n// throws SeedcordError when the url has no webhook id and token\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        if (!match?.[1] || !match[2]) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookUrlInvalid, ['The url']);\n        this.route = Routes.webhook(match[1], match[2]);\n    }\n\n    // missing means discord answered 404 or 401\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, avatarUrl, 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                ...(avatarUrl && { avatar_url: avatarUrl }),\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, paint } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Converters, Envapter } from 'envapt';\n\nimport { sendFlags } from '#reply/flags';\nimport { WebhookUrlMetadataKey } from '#src/metadataKeys';\n\nimport { ReportThrottle } from '../ReportThrottle';\nimport { Subscriber } from '../Subscriber';\nimport { isDiscordWebhookUrl } from './webhookHelpers';\nimport { WebhookSender } from './WebhookSender';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { WebhookFile } from './WebhookSender';\nimport type { SubscriptionKey } from '../types/Subscriptions';\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    /** Shown as the webhook message avatar. Defaults to the webhook's own. */\n    avatarUrl?: 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    /**\n     * Builds the message for one published event.\n     *\n     * @param suppressed - How many events were dropped since the last card\n     */\n    abstract report(suppressed: number): WebhookReport | Promise<WebhookReport>;\n\n    /**\n     * Events sharing this key collapse into one card per minute. Return `null` to send every event.\n     */\n    protected throttleKey(): string | null {\n        return null;\n    }\n\n    async execute(): Promise<void> {\n        const url = WebhookLog.urlOf(WebhookLog.envKeyOf(this.constructor));\n        if (url === null) {\n            // only an edge host reaches this branch, since it registers reporters lazily\n            this.logger.warn(\n                `${paint.sky.bold(this.constructor.name)} has no webhook url set, this reporter is disabled`\n            );\n            return;\n        }\n\n        const key = this.throttleKey();\n        const throttle = ReportThrottle.for(this.core);\n        const suppressed = key === null ? 0 : throttle.take(key);\n        if (suppressed === null) {\n            this.logger.debug(`counted a repeat into the next ${paint.sky.bold(this.constructor.name)} card`);\n            return;\n        }\n\n        try {\n            const { username, avatarUrl, components, files } = await this.report(suppressed);\n            await WebhookLog.senderFor(url).send({\n                flags: sendFlags({ ephemeral: false }),\n                username: username ?? this.constructor.name,\n                avatarUrl,\n                components,\n                files\n            });\n        } catch (error) {\n            if (key !== null) throttle.restore(key, suppressed);\n            this.logger.error('Webhook report failed', 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 { CoreBase } from '#interfaces/CoreBase';\nimport type { Subscriber } from '../Subscriber';\nimport type { SubscriptionKey } from '../types/Subscriptions';\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 *   }\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 { CoreBase } from '#interfaces/CoreBase';\nimport type { WebhookLog } from '../bases/WebhookLog';\nimport type { SubscriptionKey } from '../types/Subscriptions';\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 { breakBackticks, jsonAttachment, WebhookSeparator } from '../bases/webhookHelpers';\nimport { WebhookLog } from '../bases/WebhookLog';\nimport { Subscribe } from '../decorators/Subscribe';\nimport { WebhookUrl } from '../decorators/WebhookUrl';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { Notice } from '#stops/Notice';\nimport type { WebhookReport } from '../bases/WebhookLog';\nimport type { AllSubscriptions, FaultSource } from '../types/Subscriptions';\n\n// no HANDLED_EXCEPTION_WEBHOOK_URL disables the reporter with a boot warning\n@Subscribe('handledException')\n@WebhookUrl('HANDLED_EXCEPTION_WEBHOOK_URL')\nexport class HandledException extends WebhookLog<'handledException', CoreBase> {\n    protected override throttleKey(): string {\n        return `handledException:${this.data.routeId}:${this.data.denial.name}`;\n    }\n\n    report(suppressed: number): WebhookReport {\n        return {\n            username: 'Handled Exception',\n            components: [new HandledExceptionContainer(this.data, suppressed).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'], suppressed: number) {\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\\`\\`\\`${breakBackticks(causeStack(denial))}\\`\\`\\``)\n            )\n            .addSeparatorComponents(new WebhookSeparator().component)\n            .addTextDisplayComponents((text) => text.setContent('### Source'))\n            .addFileComponents((file) => file.setURL('attachment://source.json'));\n\n        this.addSuppressedCount(suppressed);\n    }\n\n    private addSuppressedCount(suppressed: number): void {\n        if (suppressed === 0) return;\n\n        this.instance.addTextDisplayComponents((text) =>\n            text.setContent(`-# ${suppressed} more of these since the last report`)\n        );\n    }\n}\n\nfunction faultSummary(denial: Notice, source: FaultSource): string {\n    // name and message carry chalk codes\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// building the report must not throw on a bigint or a 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 { CoreBase } from '#interfaces/CoreBase';\nimport type { WebhookReport } from '../bases/WebhookLog';\nimport type { AllSubscriptions } from '../types/Subscriptions';\n\n// no UNKNOWN_EXCEPTION_WEBHOOK_URL disables the reporter with a boot warning\n@Subscribe('unknownException')\n@WebhookUrl('UNKNOWN_EXCEPTION_WEBHOOK_URL')\nexport class UnknownException extends WebhookLog<'unknownException', CoreBase> {\n    protected override throttleKey(): string {\n        return `unknownException:${this.data.routeId}:${nameOf(this.data.error)}`;\n    }\n\n    report(suppressed: number): WebhookReport {\n        const { metadata } = this.data;\n        return {\n            username: 'Unknown Exception',\n            components: [new UnhandledErrorContainer(this.data, suppressed).component],\n            files: metadata\n                ? [jsonAttachment('metadata.json', 'Metadata associated with the error', metadata)]\n                : undefined\n        };\n    }\n}\n\n// discord.js puts the api code in the name, as `DiscordAPIError[10062]`\nfunction nameOf(error: Error): string {\n    return error.name === 'Error' ? error.constructor.name : error.name;\n}\n\nclass UnhandledErrorContainer extends BuilderComponent<'container'> {\n    constructor(data: AllSubscriptions['unknownException'], suppressed: number) {\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        this.addSuppressedCount(suppressed);\n    }\n\n    private addSuppressedCount(suppressed: number): void {\n        if (suppressed === 0) return;\n\n        this.instance.addTextDisplayComponents((text) =>\n            text.setContent(`-# ${suppressed} more of these since the last report`)\n        );\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","/** @internal PublishableKey excludes this key so publish() never emits it externally. */\nexport const PublishDefault = Symbol('seedcord.publishDefault');\n","import { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { TypedEventEmitter } from '@seedcord/event-emitter';\nimport { Logger } from '@seedcord/logger';\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 { CoreBase } from '#interfaces/CoreBase';\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 { EventFrequency } from '@seedcord/types';\n\n/**\n * Both parameters are `never` because construct-signature parameters check contravariantly, and a\n * concrete subscriber narrows each to its own payload and transport `Core`. One cast at dispatch\n * restores both.\n *\n * @internal\n */\nexport type StoredSubscriberCtor = new (data: never, core: never) => Subscriber<SubscriptionKey, CoreBase>;\n\n/**\n * `resolve` is lazy so an edge host registers from a manifest row without importing the module\n * 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    /** A server-host registration carries it from the start. A lazy one fills it on first resolve. */\n    ctor?: StoredSubscriberCtor | undefined;\n}\n\nconst loggerSlot = Symbol('seedcord:bus:logger');\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    private readonly logger = new Logger('Subscribers', { channel: 'subscribers' });\n\n    /** @internal */\n    readonly [loggerSlot]: Logger = this.logger;\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    /** @internal the host calls this during startup, keeping the url validation inside `start()` where a failure can still release the singleton guard. */\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. a publish on its key reaches nothing\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        // the once state hangs off the registration identity, which is why a restored subscriber runs again\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(\n                        `could not verify webhook at ${envKeys.map((key) => paint.amber.bold(key)).join(', ')}`\n                    );\n            })\n        );\n        // collected first so the first boot names every missing webhook at once\n        if (missing.length > 0) throw new SeedcordError(SeedcordErrorCode.ConfigWebhookNotFound, [missing.join(', ')]);\n    }\n\n    // true means the class registers\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(`${paint.sky.bold(ctor.name)} disabled, ${paint.amber.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. Subscriber handlers run asynchronously and this returns before they finish. A\n     * caller cannot assume a side effect has completed. Errors thrown by a subscriber or by an `on()`\n     * listener are caught and logged, never surfaced here. One throwing listener does not stop the\n     * others. Subscribers on one key run concurrently and carry no ordering guarantee. A `'once'`\n     * subscriber is marked as executed when it starts, even if it throws. 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 say 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(\n                `Error in subscriber ${paint.mute(String(subscriberName))} handler ${paint.sky.bold(name)}:`,\n                err\n            );\n        }\n    }\n}\n\n// every caller has already gated on the Subscribe metadata being there\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\n/** @internal */\nexport function busLoggerOf(bus: Bus): Logger {\n    return bus[loggerSlot];\n}\n"],"mappings":"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"}

package/dist/{HmrModuleHandler-KxRP8lqJ.mjs → HmrModuleHandler-9AUfKXRl.mjs}

@@ -1,4 +1,4 @@
-import { paint } from "@seedcord/logger";
+import { paint } from "@seedcord/errors";
 import { formatFilePath } from "@seedcord/utils";
 import { existsSync } from "node:fs";
 import { resolve, sep } from "node:path";
@@ -174,4 +174,4 @@ var HmrModuleHandler = class {
 
 //#endregion
 export { HmrModuleHandler as t };
-//# sourceMappingURL=HmrModuleHandler-KxRP8lqJ.mjs.map
+//# sourceMappingURL=HmrModuleHandler-9AUfKXRl.mjs.map

package/dist/{HmrModuleHandler-KxRP8lqJ.mjs.map → HmrModuleHandler-9AUfKXRl.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"HmrModuleHandler-KxRP8lqJ.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 { paint } from '@seedcord/logger';\nimport { formatFilePath } from '@seedcord/utils';\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        this.options = { ...options, logger: options.logger.inChannel('hmr') };\n\n        // no import.meta.hot.data stash needed because a leaf reload never reconstructs the singleton\n        // holding 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 } = this.options;\n\n        if (type === 'delete' || type === 'deleteDir') {\n            this.report('Unloaded', this.unload(file), [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.debug(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);\n                this.report('Unloaded', this.unload(file), [file]);\n            }\n            return;\n        }\n\n        const rollbackEnabled = event.rollback ?? true;\n        const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];\n\n        const startedAt = Date.now();\n        const names: string[] = [];\n        const touched: string[] = [];\n\n        for (const fileToReload of filesToReload) {\n            if (!this.inScope(fileToReload)) continue;\n\n            const reloaded = await this.reloadWithRollback(fileToReload, rollbackEnabled);\n            if (reloaded.length === 0) continue;\n\n            names.push(...reloaded);\n            touched.push(fileToReload);\n        }\n\n        this.report(type === 'create' ? 'Registered' : 'Reloaded', names, touched, Date.now() - startedAt);\n    }\n\n    private inScope(file: string): boolean {\n        const { handlersDir, middlewaresDir } = this.options;\n\n        // the trailing separator keeps commands-extra out of commands\n        if (file.startsWith(resolve(process.cwd(), handlersDir) + sep)) return true;\n        return middlewaresDir ? file.startsWith(resolve(process.cwd(), middlewaresDir) + sep) : false;\n    }\n\n    // one line per save, since one edit can reload every module that imports the file\n    private report(verb: string, names: string[], files: string[], elapsedMs?: number): void {\n        if (names.length === 0) return;\n\n        const from = files.length === 1 ? formatFilePath(files[0] ?? '') : `${String(files.length)} files`;\n        const timing = elapsedMs === undefined ? '' : ` ${paint.mute('in')} ${String(elapsedMs)}ms`;\n        this.options.logger.debug(`${verb} ${paint.sky.bold(names.join(', '))} from ${paint.mute(from)}${timing}`);\n    }\n\n    private async reloadWithRollback(file: string, rollbackEnabled: boolean): Promise<string[]> {\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 !== null) return reloaded;\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 the last-good units live until the next good save\n        this.restoreUnits(file, snapshot);\n        logger.warn(`${paint.amber.bold('Rolled back')} ${paint.mute(formatFilePath(file))} to the last-good version`);\n        return [];\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): string[] {\n        const names: string[] = [];\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                names.push(displayName(handler, 'Handler'));\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                names.push(displayName(middleware, 'Middleware'));\n            }\n            this.store.fileToMiddlewares.delete(file);\n        }\n\n        return names;\n    }\n\n    private async reloadFile(file: string): Promise<string[] | null> {\n        const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;\n\n        if (!existsSync(file)) {\n            logger.debug(`File does not exist, skipping reload: ${formatFilePath(file)}`);\n            return null;\n        }\n\n        try {\n            let fileUrl = pathToFileURL(file).href;\n            // vitest has no real vite server managing the module graph\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            const names: string[] = [];\n            for (const val of Object.values(imported)) {\n                if (isHandler(val)) {\n                    registerHandler(val, file);\n                    this.trackHandler(file, val);\n                    names.push(displayName(val, 'Handler'));\n                } else if (isMiddleware && registerMiddleware && isMiddleware(val)) {\n                    registerMiddleware(val, file);\n                    this.trackMiddleware(file, val);\n                    names.push(displayName(val, 'Middleware'));\n                }\n            }\n\n            return names;\n        } catch (error) {\n            logger.error(`Failed to reload file: ${file}`, error);\n            return null;\n        }\n    }\n\n    // these are the same class objects, which is how a live db connection survives a 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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"}
+{"version":3,"file":"HmrModuleHandler-9AUfKXRl.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 { paint } from '@seedcord/errors';\nimport { formatFilePath } from '@seedcord/utils';\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        this.options = { ...options, logger: options.logger.inChannel('hmr') };\n\n        // no import.meta.hot.data stash needed because a leaf reload never reconstructs the singleton\n        // holding 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 } = this.options;\n\n        if (type === 'delete' || type === 'deleteDir') {\n            this.report('Unloaded', this.unload(file), [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.debug(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);\n                this.report('Unloaded', this.unload(file), [file]);\n            }\n            return;\n        }\n\n        const rollbackEnabled = event.rollback ?? true;\n        const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];\n\n        const startedAt = Date.now();\n        const names: string[] = [];\n        const touched: string[] = [];\n\n        for (const fileToReload of filesToReload) {\n            if (!this.inScope(fileToReload)) continue;\n\n            const reloaded = await this.reloadWithRollback(fileToReload, rollbackEnabled);\n            if (reloaded.length === 0) continue;\n\n            names.push(...reloaded);\n            touched.push(fileToReload);\n        }\n\n        this.report(type === 'create' ? 'Registered' : 'Reloaded', names, touched, Date.now() - startedAt);\n    }\n\n    private inScope(file: string): boolean {\n        const { handlersDir, middlewaresDir } = this.options;\n\n        // the trailing separator keeps commands-extra out of commands\n        if (file.startsWith(resolve(process.cwd(), handlersDir) + sep)) return true;\n        return middlewaresDir ? file.startsWith(resolve(process.cwd(), middlewaresDir) + sep) : false;\n    }\n\n    // one line per save, since one edit can reload every module that imports the file\n    private report(verb: string, names: string[], files: string[], elapsedMs?: number): void {\n        if (names.length === 0) return;\n\n        const from = files.length === 1 ? formatFilePath(files[0] ?? '') : `${String(files.length)} files`;\n        const timing = elapsedMs === undefined ? '' : ` ${paint.mute('in')} ${String(elapsedMs)}ms`;\n        this.options.logger.debug(`${verb} ${paint.sky.bold(names.join(', '))} from ${paint.mute(from)}${timing}`);\n    }\n\n    private async reloadWithRollback(file: string, rollbackEnabled: boolean): Promise<string[]> {\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 !== null) return reloaded;\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 the last-good units live until the next good save\n        this.restoreUnits(file, snapshot);\n        logger.warn(`${paint.amber.bold('Rolled back')} ${paint.mute(formatFilePath(file))} to the last-good version`);\n        return [];\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): string[] {\n        const names: string[] = [];\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                names.push(displayName(handler, 'Handler'));\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                names.push(displayName(middleware, 'Middleware'));\n            }\n            this.store.fileToMiddlewares.delete(file);\n        }\n\n        return names;\n    }\n\n    private async reloadFile(file: string): Promise<string[] | null> {\n        const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;\n\n        if (!existsSync(file)) {\n            logger.debug(`File does not exist, skipping reload: ${formatFilePath(file)}`);\n            return null;\n        }\n\n        try {\n            let fileUrl = pathToFileURL(file).href;\n            // vitest has no real vite server managing the module graph\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            const names: string[] = [];\n            for (const val of Object.values(imported)) {\n                if (isHandler(val)) {\n                    registerHandler(val, file);\n                    this.trackHandler(file, val);\n                    names.push(displayName(val, 'Handler'));\n                } else if (isMiddleware && registerMiddleware && isMiddleware(val)) {\n                    registerMiddleware(val, file);\n                    this.trackMiddleware(file, val);\n                    names.push(displayName(val, 'Middleware'));\n                }\n            }\n\n            return names;\n        } catch (error) {\n            logger.error(`Failed to reload file: ${file}`, error);\n            return null;\n        }\n    }\n\n    // these are the same class objects, which is how a live db connection survives a 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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"}

package/dist/{Plugin-CDAV7P9l.mjs → Plugin-Bkeqcjy6.mjs}

@@ -1,7 +1,7 @@
 import { n as StartupPhase, t as ShutdownPhase } from "./phases-BauKJOTT.mjs";
 import { t as getDevChannel } from "./devChannel-CQU7hq7Q.mjs";
-import { Logger } from "@seedcord/logger";
 import { SeedcordErrorCode } from "@seedcord/errors";
+import { Logger } from "@seedcord/logger";
 import { SeedcordError } from "@seedcord/errors/internal";
 
 //#region src/plugin/lifecycle.ts
@@ -32,6 +32,8 @@ function resolveLifecycleSpec(spec, pluginName) {
 //#region src/plugin/Plugin.ts
 /** @internal */
 const resolvedSpecSlot = Symbol("seedcord.plugin.spec");
+/** @internal */
+const loggerSlot = Symbol("seedcord.plugin.logger");
 /**
 * Base class for Seedcord plugins. A subclass declares its options as the `Opts` type argument,
 * implements `init()`, and reads the framework surface through `this.core`.
@@ -43,11 +45,14 @@ var Plugin = class {
 	host;
 	/** @internal */
 	[resolvedSpecSlot];
+	/** @internal */
+	[loggerSlot];
 	/** Logs under the plugin's class name, on the channel its attach key sets. */
 	logger;
 	constructor(host, spec) {
 		this.host = host;
 		this.logger = new Logger(this.constructor.name);
+		this[loggerSlot] = this.logger;
 		this[resolvedSpecSlot] = resolveLifecycleSpec(spec, this.constructor.name);
 	}
 	/** The host, typed to the transport whose `Plugin` base this class extends. */
@@ -78,7 +83,11 @@ var Plugin = class {
 function resolvedLifecycleSpecOf(plugin) {
 	return plugin[resolvedSpecSlot];
 }
+/** @internal */
+function pluginLoggerOf(plugin) {
+	return plugin[loggerSlot];
+}
 
 //#endregion
-export { resolvedLifecycleSpecOf as n, Plugin as t };
-//# sourceMappingURL=Plugin-CDAV7P9l.mjs.map
+export { pluginLoggerOf as n, resolvedLifecycleSpecOf as r, Plugin as t };
+//# sourceMappingURL=Plugin-Bkeqcjy6.mjs.map

package/dist/Plugin-Bkeqcjy6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin-Bkeqcjy6.mjs","names":[],"sources":["../src/plugin/lifecycle.ts","../src/plugin/Plugin.ts"],"sourcesContent":["import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport { ShutdownPhase, StartupPhase } from '#src/lifecycle/phases';\n\n/**\n * The lifecycle a plugin declares through `super(host, spec)`. Unset fields resolve to the base\n * defaults. `ready` runs at a fixed `StartupPhase.Ready`.\n */\nexport interface PluginLifecycleSpec {\n    init?: { phase?: StartupPhase; timeout?: number };\n    ready?: { timeout?: number };\n    dispose?: { phase?: ShutdownPhase; timeout?: number };\n}\n\n/** @internal */\nexport interface ResolvedPluginLifecycleSpec {\n    readonly init: { readonly phase: StartupPhase; readonly timeout: number };\n    readonly ready: { readonly timeout: number };\n    readonly dispose: { readonly phase: ShutdownPhase; readonly timeout: number };\n}\n\nconst DEFAULT_INIT_TIMEOUT_MS = 15_000;\nconst DEFAULT_READY_TIMEOUT_MS = 15_000;\nconst DEFAULT_DISPOSE_TIMEOUT_MS = 10_000;\n\nfunction timeoutOf(\n    field: 'init' | 'ready' | 'dispose',\n    declared: number | undefined,\n    fallback: number,\n    pluginName: string\n): number {\n    if (declared === undefined) return fallback;\n    if (!Number.isFinite(declared) || declared <= 0) {\n        throw new SeedcordError(SeedcordErrorCode.PluginOptionsRejected, [\n            pluginName,\n            `lifecycle ${field}.timeout must be a positive number of milliseconds`\n        ]);\n    }\n    return declared;\n}\n\n/** @internal */\nexport function resolveLifecycleSpec(\n    spec: PluginLifecycleSpec | undefined,\n    pluginName: string\n): ResolvedPluginLifecycleSpec {\n    return {\n        init: {\n            phase: spec?.init?.phase ?? StartupPhase.Configuration,\n            timeout: timeoutOf('init', spec?.init?.timeout, DEFAULT_INIT_TIMEOUT_MS, pluginName)\n        },\n        ready: {\n            timeout: timeoutOf('ready', spec?.ready?.timeout, DEFAULT_READY_TIMEOUT_MS, pluginName)\n        },\n        dispose: {\n            phase: spec?.dispose?.phase ?? ShutdownPhase.Disconnect,\n            timeout: timeoutOf('dispose', spec?.dispose?.timeout, DEFAULT_DISPOSE_TIMEOUT_MS, pluginName)\n        }\n    };\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\n\nimport { getDevChannel } from '#hmr/devChannel';\n\nimport { resolveLifecycleSpec } from './lifecycle';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { ResolvedPluginLifecycleSpec, PluginLifecycleSpec } from './lifecycle';\nimport type { TransportOf, PluginOptions, RuntimeOf } from './options';\nimport type { Tail, HmrAware, HmrUpdateEvent } from '@seedcord/types';\n\nexport interface Initializeable {\n    init(): Promise<void>;\n}\n\n/** @internal */\nconst resolvedSpecSlot = Symbol('seedcord.plugin.spec');\n/** @internal */\nconst loggerSlot = Symbol('seedcord.plugin.logger');\n\n/**\n * Base class for Seedcord plugins. A subclass declares its options as the `Opts` type argument,\n * implements `init()`, and reads the framework surface through `this.core`.\n *\n * @typeParam Opts - The plugin's declared {@link PluginOptions}.\n * @typeParam TCore - The host type `this.core` resolves to. Each transport binds it to its own `Core`.\n */\nexport abstract class Plugin<Opts extends PluginOptions = {}, TCore extends CoreBase = CoreBase>\n    implements Initializeable, HmrAware\n{\n    /** @internal phantom, never set at runtime */\n    declare readonly __transport?: TransportOf<Opts>;\n    /** @internal phantom, never set at runtime */\n    declare readonly __runtime?: RuntimeOf<Opts>;\n\n    /** @internal */\n    readonly [resolvedSpecSlot]: ResolvedPluginLifecycleSpec;\n    /** @internal */\n    readonly [loggerSlot]: Logger;\n\n    /** Logs under the plugin's class name, on the channel its attach key sets. */\n    protected readonly logger: Logger;\n\n    // CoreBase here keeps the augmented Core out of ConstructorParameters, which attach reads\n    constructor(\n        private readonly host: CoreBase,\n        spec?: PluginLifecycleSpec\n    ) {\n        this.logger = new Logger(this.constructor.name);\n        this[loggerSlot] = this.logger;\n        this[resolvedSpecSlot] = resolveLifecycleSpec(spec, this.constructor.name);\n    }\n\n    /** The host, typed to the transport whose `Plugin` base this class extends. */\n    protected get core(): TCore {\n        // justified: each transport binds TCore to the Core its own host satisfies\n        return this.host as TCore;\n    }\n\n    abstract init(): Promise<void>;\n\n    /**\n     * Runs in the startup Ready phase, after `init()`. The gateway client is logged in by this phase,\n     * and the http host binds its server in the same phase.\n     */\n    ready?(): Promise<void>;\n\n    /** Runs during teardown, only when `init()` resolved. */\n    dispose?(): Promise<void>;\n\n    /**\n     * Throws a `SeedcordError` that contains the plugin class name and the reason.\n     *\n     * @param reason - Why the options are invalid.\n     */\n    protected rejectOptions(reason: string): never {\n        throw new SeedcordError(SeedcordErrorCode.PluginOptionsRejected, [this.constructor.name, reason]);\n    }\n\n    /** Override to reload plugin state on an HMR update. */\n    public onHmr(_event: HmrUpdateEvent): Promise<void> {\n        return Promise.resolve();\n    }\n\n    /**\n     * Registers critical file patterns that should trigger a full restart when changed in Dev HMR.\n     * @param patterns - Glob patterns relative to the project root\n     */\n    protected registerCriticalFiles(patterns: string[]): void {\n        getDevChannel()?.send('seedcord:register-critical-files', { patterns });\n    }\n}\n\n/** @internal */\nexport function resolvedLifecycleSpecOf(plugin: PluginLike): ResolvedPluginLifecycleSpec {\n    return plugin[resolvedSpecSlot];\n}\n\n/** @internal */\nexport function pluginLoggerOf(plugin: PluginLike): Logger {\n    return plugin[loggerSlot];\n}\n\nexport type { PluginLifecycleSpec } from './lifecycle';\nexport type { PluginOptions } from './options';\n\n// a bound of Plugin<{}> rejects every plugin that declares an option, since Plugin<A> and Plugin<B>\n// are mutually unassignable. every member here must stay Opts-independent.\n/** @internal */\nexport type PluginLike = Pick<\n    Plugin,\n    'init' | 'ready' | 'dispose' | 'onHmr' | typeof resolvedSpecSlot | typeof loggerSlot\n>;\n\n// a `CoreBase` first parameter rejects a narrowing ctor on its own, and it also collapses\n// `InstanceType<Ctor>` to `PluginLike` at every attach call. CoreParamAssert checks it instead.\n/** @internal */\nexport type PluginCtor<TPlugin extends PluginLike = PluginLike> = new (...args: any[]) => TPlugin;\n\n/** @internal */\nexport type PluginArgs<Ctor extends PluginCtor> = Tail<ConstructorParameters<Ctor>>;\n\ntype CoreParamTooNarrow = Record<\n    'this plugin constructor must take CoreBase as its first parameter and read the transport Core off this.core',\n    never\n>;\n\n// a narrowed first parameter fails `CoreBase extends Param`\n/** @internal */\nexport type CoreParamAssert<Ctor extends PluginCtor> = CoreBase extends ConstructorParameters<Ctor>[0]\n    ? unknown\n    : CoreParamTooNarrow;\n"],"mappings":";;;;;;;AAsBA,MAAM,0BAA0B;AAChC,MAAM,2BAA2B;AACjC,MAAM,6BAA6B;AAEnC,SAAS,UACL,OACA,UACA,UACA,YACM;CACN,IAAI,aAAa,QAAW,OAAO;CACnC,IAAI,CAAC,OAAO,SAAS,QAAQ,KAAK,YAAY,GAC1C,MAAM,IAAI,cAAc,kBAAkB,uBAAuB,CAC7D,YACA,aAAa,MAAM,mDACvB,CAAC;CAEL,OAAO;AACX;;AAGA,SAAgB,qBACZ,MACA,YAC2B;CAC3B,OAAO;EACH,MAAM;GACF,OAAO,MAAM,MAAM;GACnB,SAAS,UAAU,QAAQ,MAAM,MAAM,SAAS,yBAAyB,UAAU;EACvF;EACA,OAAO,EACH,SAAS,UAAU,SAAS,MAAM,OAAO,SAAS,0BAA0B,UAAU,EAC1F;EACA,SAAS;GACL,OAAO,MAAM,SAAS;GACtB,SAAS,UAAU,WAAW,MAAM,SAAS,SAAS,4BAA4B,UAAU;EAChG;CACJ;AACJ;;;;;AC1CA,MAAM,mBAAmB,OAAO,sBAAsB;;AAEtD,MAAM,aAAa,OAAO,wBAAwB;;;;;;;;AASlD,IAAsB,SAAtB,MAEA;CAgByB;;CATrB,CAAU;;CAEV,CAAU;;CAGV,AAAmB;CAGnB,YACI,AAAiB,MACjB,MACF;EAFmB;EAGjB,KAAK,SAAS,IAAI,OAAO,KAAK,YAAY,IAAI;EAC9C,KAAK,cAAc,KAAK;EACxB,KAAK,oBAAoB,qBAAqB,MAAM,KAAK,YAAY,IAAI;CAC7E;;CAGA,IAAc,OAAc;EAExB,OAAO,KAAK;CAChB;;;;;;CAkBA,AAAU,cAAc,QAAuB;EAC3C,MAAM,IAAI,cAAc,kBAAkB,uBAAuB,CAAC,KAAK,YAAY,MAAM,MAAM,CAAC;CACpG;;CAGA,AAAO,MAAM,QAAuC;EAChD,OAAO,QAAQ,QAAQ;CAC3B;;;;;CAMA,AAAU,sBAAsB,UAA0B;EACtD,cAAc,CAAC,EAAE,KAAK,oCAAoC,EAAE,SAAS,CAAC;CAC1E;AACJ;;AAGA,SAAgB,wBAAwB,QAAiD;CACrF,OAAO,OAAO;AAClB;;AAGA,SAAgB,eAAe,QAA4B;CACvD,OAAO,OAAO;AAClB"}

package/dist/{Plugin-qRc7Ch4g.d.mts → Plugin-Cl5P7-PO.d.mts}

@@ -1,7 +1,7 @@
-import { FrameworkChannel, Logger } from "@seedcord/logger";
+import { Logger } from "@seedcord/logger";
 import { TypedEventEmitter } from "@seedcord/event-emitter";
 import { REST } from "@discordjs/rest";
-import { Config, EventFrequency, HmrAware, HmrUpdateEvent, IRateLimiter, RenderContext, ReplyResponse, Tail, TypedExclude } from "@seedcord/types";
+import { Config, EventFrequency, FrameworkChannel, HmrAware, HmrUpdateEvent, IRateLimiter, RenderContext, ReplyResponse, Tail, TypedExclude } from "@seedcord/types";
 import { UUID } from "node:crypto";
 //#region src/metadataKeys.d.ts
 declare enum InteractionRoutes {
@@ -174,6 +174,8 @@ interface DefaultSubscriptions {
   unknownException: {
     uuid: UUID;
     error: Error;
+    /** Where the throw came from, `slash:ban` for an interaction and `event:name:handler` for an event. */
+    routeId: string;
     guild?: {
       id: string;
       name: string;
@@ -188,6 +190,8 @@ interface DefaultSubscriptions {
   handledException: {
     denial: Notice;
     uuid: UUID;
+    /** The same id `interactionDispatched` publishes. An event reads `event:name:handler`. */
+    routeId: string;
     source: FaultSource;
   };
   /** Triggered when an interaction dispatch throws past the fault boundary. */
@@ -313,14 +317,16 @@ interface SubscriberRegistration {
   /** A server-host registration carries it from the start. A lazy one fills it on first resolve. */
   ctor?: StoredSubscriberCtor | undefined;
 }
+declare const loggerSlot$1: unique symbol;
 /**
  * Registers and dispatches subscribers. Subscribers run on a programmatic or framework publish.
  * Accessed via `core.bus`. Do not construct it directly.
  */
 declare class Bus extends TypedEventEmitter<SubscriptionTuples> {
   protected core: CoreBase;
+  private readonly logger;
   /** @internal */
-  readonly logger: Logger;
+  readonly [loggerSlot$1]: Logger;
   private readonly subscribersMap;
   private readonly executedOnce;
   private readonly webhookProbes;
@@ -360,6 +366,8 @@ declare class Bus extends TypedEventEmitter<SubscriptionTuples> {
   private processSubscriber;
   private runSubscriber;
 }
+/** @internal */
+declare function busLoggerOf(bus: Bus): Logger;
 //#endregion
 //#region src/interfaces/CoreBase.d.ts
 /**
@@ -484,6 +492,8 @@ interface Initializeable {
 }
 /** @internal */
 declare const resolvedSpecSlot: unique symbol;
+/** @internal */
+declare const loggerSlot: unique symbol;
 /**
  * Base class for Seedcord plugins. A subclass declares its options as the `Opts` type argument,
  * implements `init()`, and reads the framework surface through `this.core`.
@@ -499,8 +509,10 @@ declare abstract class Plugin<Opts extends PluginOptions = {}, TCore extends Cor
   readonly __runtime?: RuntimeOf<Opts>;
   /** @internal */
   readonly [resolvedSpecSlot]: ResolvedPluginLifecycleSpec;
+  /** @internal */
+  readonly [loggerSlot]: Logger;
   /** Logs under the plugin's class name, on the channel its attach key sets. */
-  readonly logger: Logger;
+  protected readonly logger: Logger;
   constructor(host: CoreBase, spec?: PluginLifecycleSpec);
   /** The host, typed to the transport whose `Plugin` base this class extends. */
   protected get core(): TCore;
@@ -527,7 +539,7 @@ declare abstract class Plugin<Opts extends PluginOptions = {}, TCore extends Cor
   protected registerCriticalFiles(patterns: string[]): void;
 }
 /** @internal */
-type PluginLike = Pick<Plugin, 'init' | 'ready' | 'dispose' | 'logger' | 'onHmr' | typeof resolvedSpecSlot>;
+type PluginLike = Pick<Plugin, 'init' | 'ready' | 'dispose' | 'onHmr' | typeof resolvedSpecSlot | typeof loggerSlot>;
 /** @internal */
 type PluginCtor<TPlugin extends PluginLike = PluginLike> = new (...args: any[]) => TPlugin;
 /** @internal */
@@ -536,5 +548,5 @@ type CoreParamTooNarrow = Record<'this plugin constructor must take CoreBase as
 /** @internal */
 type CoreParamAssert<Ctor extends PluginCtor> = CoreBase extends ConstructorParameters<Ctor>[0] ? unknown : CoreParamTooNarrow;
 //#endregion
-export { AckState as A, InteractionRouteKeys as B, FaultSource as C, Notice as D, Subscriptions as E, PublishDefault as F, MiddlewareMetadataKey as H, CommandMetadataKey as I, EventMetadataKey as L, checkAckLegality as M, sendTarget as N, ReplyTelemetry as O, AckTrace as P, GatedMetadataKey as R, DispatchOutcome as S, SubscriptionKey as T, SubscribeMetadataKey as U, InteractionRoutes as V, WebhookUrlMetadataKey as W, Bus as _, PluginCtor as a, Subscriber as b, PluginOptions as c, Transport as d, TransportAssert as f, CoreBase as g, StartupPhase as h, PluginArgs as i, ReplyMethod as j, reportedWrite as k, Runtime as l, ShutdownPhase as m, Initializeable as n, PluginLike as o, PluginLifecycleSpec as p, Plugin as r, ChannelKeyAssert as s, CoreParamAssert as t, RuntimeAssert as u, StoredSubscriberCtor as v, SubscriptionData as w, DefaultSubscriptions as x, SubscriberRegistration as y, InteractionMetadataKey as z };
-//# sourceMappingURL=Plugin-qRc7Ch4g.d.mts.map
+export { reportedWrite as A, InteractionMetadataKey as B, DispatchOutcome as C, Subscriptions as D, SubscriptionKey as E, AckTrace as F, WebhookUrlMetadataKey as G, InteractionRoutes as H, PublishDefault as I, CommandMetadataKey as L, ReplyMethod as M, checkAckLegality as N, Notice as O, sendTarget as P, EventMetadataKey as R, DefaultSubscriptions as S, SubscriptionData as T, MiddlewareMetadataKey as U, InteractionRouteKeys as V, SubscribeMetadataKey as W, Bus as _, PluginCtor as a, busLoggerOf as b, PluginOptions as c, Transport as d, TransportAssert as f, CoreBase as g, StartupPhase as h, PluginArgs as i, AckState as j, ReplyTelemetry as k, Runtime as l, ShutdownPhase as m, Initializeable as n, PluginLike as o, PluginLifecycleSpec as p, Plugin as r, ChannelKeyAssert as s, CoreParamAssert as t, RuntimeAssert as u, StoredSubscriberCtor as v, FaultSource as w, Subscriber as x, SubscriberRegistration as y, GatedMetadataKey as z };
+//# sourceMappingURL=Plugin-Cl5P7-PO.d.mts.map

package/dist/{cursor-D207VrRo.mjs → cursor-B07ArwDz.mjs}

@@ -1,10 +1,10 @@
-import { d as InteractionRouteKeys, f as InteractionRoutes, g as contextMenuLeaves, i as BuilderComponent, u as InteractionMetadataKey } from "./publishDefault-BCrMG9T8.mjs";
+import { b as InteractionRoutes, f as BuilderComponent, v as InteractionMetadataKey, w as contextMenuLeaves, y as InteractionRouteKeys } from "./Bus-DcuUtOEL.mjs";
 import "reflect-metadata";
 import { SlashCommandBuilder, TextDisplayBuilder } from "@discordjs/builders";
-import { Logger, paint } from "@seedcord/logger";
+import { SeedcordErrorCode, paint } from "@seedcord/errors";
+import { Logger } from "@seedcord/logger";
 import { routeLeavesOf } from "@seedcord/utils/internal";
 import { ApplicationCommandType, PermissionFlagsBits } from "discord-api-types/v10";
-import { SeedcordErrorCode } from "@seedcord/errors";
 import { SeedcordError, SeedcordRangeError } from "@seedcord/errors/internal";
 import { prettify, toEpochSeconds } from "@seedcord/utils";
 
@@ -1049,4 +1049,4 @@ function pageCursor(prefix) {
 
 //#endregion
 export { areRoutes as A, prefixOf as B, NotInDm as C, defineEffectGate as D, OnCooldown as E, storeInteractionRoute as F, ContextMenus as G, Notice as H, ComponentDefsKey as I, guardedAccessor as J, accessorStore as K, decodeComponentRoute as L, interactionRoutesOf as M, selectMenuRouteOf as N, defineGate as O, storeComponentRoute as P, CustomId as R, NotAllowed as S, NotOwner as T, CommandInjector as U, NoticeCard as V, Commands as W, GateNotice as _, RequirePermissions as a, MissingRole as b, hasAll as c, pickNotice as d, discardCommits as f, runCommits as g, runCheck as h, RequireBotPermissions as i, contextMenuRouteOf as j, SelectMenuKind as k, missingNames as l, rollbackCommits as m, pageCursor as n, RequireRole as o, markCommits as p, clearStore as q, Silence as r, PermissionNames as s, PAGE_MAX as t, presentNames as u, HasDangerousPermissions as v, NotInGuild as w, NeedsAny as x, MissingPermissions as y, decodeFor as z };
-//# sourceMappingURL=cursor-D207VrRo.mjs.map
+//# sourceMappingURL=cursor-B07ArwDz.mjs.map