@seedcord/core 0.1.0-next.7 → 0.1.0

package/dist/internal.index.mjs

@@ -1,11 +1,12 @@
-import { c as EventMetadataKey, d as InteractionRouteKeys, f as InteractionRoutes, h as WebhookUrlMetadataKey, l as GatedMetadataKey, m as SubscribeMetadataKey, n as deferFlags, o as setBotColor, p as MiddlewareMetadataKey, r as sendFlags, s as CommandMetadataKey, t as PublishDefault, u as InteractionMetadataKey } from "./publishDefault-CCf1azzW.mjs";
-import { A as ComponentDefsKey, D as selectMenuRouteOf, E as interactionRoutesOf, F as NoticeCard, I as Notice, M as CustomId, N as decodeFor, O as storeComponentRoute, P as prefixOf, T as contextMenuRouteOf, _ as NotInDm, b as OnCooldown, d as runCommits, f as GateNotice, g as NotAllowed, h as NeedsAny, j as decodeComponentRoute, k as storeInteractionRoute, m as MissingRole, n as PermissionNames, o as pickNotice, p as MissingPermissions, s as discardCommits, t as Silence, u as runCheck, v as NotInGuild, w as areRoutes, y as NotOwner } from "./Silence-dbC2slOB.mjs";
+import { c as EventMetadataKey, d as InteractionRouteKeys, f as InteractionRoutes, g as contextMenuLeaves, h as WebhookUrlMetadataKey, l as GatedMetadataKey, m as SubscribeMetadataKey, n as deferFlags, o as setBotColor, p as MiddlewareMetadataKey, r as sendFlags, s as CommandMetadataKey, t as PublishDefault, u as InteractionMetadataKey } from "./publishDefault-CldnxcT2.mjs";
+import { A as areRoutes, B as prefixOf, C as NotInDm, E as OnCooldown, F as storeInteractionRoute, H as Notice, I as ComponentDefsKey, J as guardedAccessor, K as accessorStore, L as decodeComponentRoute, M as interactionRoutesOf, N as selectMenuRouteOf, P as storeComponentRoute, S as NotAllowed, T as NotOwner, U as CommandInjector, V as NoticeCard, _ as GateNotice, b as MissingRole, d as pickNotice, f as discardCommits, g as runCommits, h as runCheck, j as contextMenuRouteOf, n as pageCursor, q as clearStore, r as Silence, s as PermissionNames, t as PAGE_MAX, v as HasDangerousPermissions, w as NotInGuild, x as NeedsAny, y as MissingPermissions, z as decodeFor } from "./cursor-BvSH8tgw.mjs";
 import { n as setDevChannel, t as getDevChannel } from "./devChannel-CQU7hq7Q.mjs";
+import { t as slashRouteLeaves } from "./slashRouteLeaves-BANDtPFm.mjs";
 import "reflect-metadata";
-import { SeedcordErrorCode } from "@seedcord/errors";
-import { SeedcordError } from "@seedcord/errors/internal";
 import { TextDisplayBuilder } from "@discordjs/builders";
 import { Logger, paint } from "@seedcord/logger";
+import { SeedcordErrorCode } from "@seedcord/errors";
+import { SeedcordError } from "@seedcord/errors/internal";
 import { formatFilePath, timestampFromSnowflake } from "@seedcord/utils";
 import chalk from "chalk";
 import { Envapter } from "envapt";
@@ -74,6 +75,13 @@ function slowGateMonitor() {
 	};
 }
 
+//#endregion
+//#region src/miscellaneous/emojiConfig.ts
+/** Narrows a configured emoji value to the `[name, guildId]` form. @internal */
+function isEmojiTuple(value) {
+	return Array.isArray(value) && value.length === 2 && typeof value[0] === "string" && typeof value[1] === "string";
+}
+
 //#endregion
 //#region src/hmr/wrapHot.ts
 /**
@@ -135,15 +143,6 @@ function asError(caught) {
 	return Error.isError(caught) ? caught : new Error(String(caught), { cause: caught });
 }
 
-//#endregion
-//#region src/pagination/cursor.ts
-const PAGE_MAX = 1e6;
-const SLOT_MAX = 4;
-/** Build the page cursor for a paginator. */
-function pageCursor(prefix) {
-	return new CustomId(prefix).int("page", 0, PAGE_MAX).int("slot", 0, SLOT_MAX);
-}
-
 //#endregion
 //#region src/reply/ackLegality.ts
 const showModalReason = {
@@ -686,5 +685,5 @@ function dispatchedPayload(report) {
 }
 
 //#endregion
-export { AckTrace, BaseReplySender, CommandMetadataKey, ComponentDefsKey, EventMetadataKey, FaultThrottle, GateNotice, GatedMetadataKey, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, MissingPermissions, MissingRole, NeedsAny, NotAllowed, NotInDm, NotInGuild, NotOwner, NoticeCard, OnCooldown, PAGE_MAX, PermissionNames, PublishDefault, SubscribeMetadataKey, WebhookUrlMetadataKey, areRoutes, asError, checkAckLegality, contextMenuRouteOf, decodeComponentRoute, decodeFor, deferFlags, dispatchedPayload, getDevChannel, interactionRoutesOf, outcomeFor, pageCursor, pickNotice, prefixOf, queuedMsFor, reportedWrite, routeIdOf, runGates, runHandlerGates, selectMenuRouteOf, sendFlags, sendTarget, serializeReply, setBotColor, setDevChannel, slowGateMonitor, storeComponentRoute, storeInteractionRoute, translateSerializationError, wrapHot };
+export { AckTrace, BaseReplySender, CommandInjector, CommandMetadataKey, ComponentDefsKey, EventMetadataKey, FaultThrottle, GateNotice, GatedMetadataKey, HasDangerousPermissions, HmrManager, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, MissingPermissions, MissingRole, NeedsAny, NotAllowed, NotInDm, NotInGuild, NotOwner, NoticeCard, OnCooldown, PAGE_MAX, PermissionNames, PublishDefault, SubscribeMetadataKey, WebhookUrlMetadataKey, accessorStore, areRoutes, asError, checkAckLegality, clearStore, contextMenuLeaves, contextMenuRouteOf, decodeComponentRoute, decodeFor, deferFlags, dispatchedPayload, getDevChannel, guardedAccessor, interactionRoutesOf, isEmojiTuple, outcomeFor, pageCursor, pickNotice, prefixOf, queuedMsFor, reportedWrite, routeIdOf, runGates, runHandlerGates, selectMenuRouteOf, sendFlags, sendTarget, serializeReply, setBotColor, setDevChannel, slashRouteLeaves, slowGateMonitor, storeComponentRoute, storeInteractionRoute, translateSerializationError, wrapHot };
 //# sourceMappingURL=internal.index.mjs.map

package/dist/internal.index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal.index.mjs","names":[],"sources":["../src/gates/runGates.ts","../src/gates/slowGate.ts","../src/hmr/wrapHot.ts","../src/hmr/HmrManager.ts","../src/stops/asError.ts","../src/pagination/cursor.ts","../src/reply/ackLegality.ts","../src/reply/AckTrace.ts","../src/reply/responseReport.ts","../src/reply/translateSerialization.ts","../src/reply/serializeReply.ts","../src/reply/BaseReplySender.ts","../src/subscribers/FaultThrottle.ts","../src/dispatch/dispatchReport.ts"],"sourcesContent":["import 'reflect-metadata';\n\nimport { GatedMetadataKey, InteractionRouteKeys } from '@src/metadataKeys';\n\nimport { discardCommits, runCheck, runCommits } from './effects';\n\nimport type { Gate, GateContextBase } from './Gate';\n\n/**\n * Receives each gate's name and how long its check ran, in ms. A combinator (`and`/`or`) reports once\n * under its joined name.\n */\nexport type GateObserver = (gateName: string, elapsedMs: number) => void;\n\n// the stable id a route decorator stored, e.g. slash:daily or button:confirm. null for a plain event handler.\nexport function routeIdOf(handlerCtor: object): string | null {\n    for (const [kind, key] of Object.entries(InteractionRouteKeys)) {\n        // justified: getMetadata returns any, this key only ever stores the route/prefix string array\n        const routes = Reflect.getMetadata(key, handlerCtor) as string[] | undefined;\n        if (routes?.length) return `${kind}:${routes.join(',')}`;\n    }\n    return null;\n}\n\nasync function timedCheck(gate: Gate<GateContextBase>, ctx: GateContextBase, observe: GateObserver): Promise<void> {\n    const start = performance.now();\n    // finally so a refusing gate still reports\n    try {\n        await runCheck(gate, ctx);\n    } finally {\n        observe(gate.name, performance.now() - start);\n    }\n}\n\n/**\n * Runs each gate's check in order, so the first refusal propagates to the dispatcher boundary. An effect\n * gate's commit runs once the whole set passes. When `observe` is given, each check is timed and reported,\n * commits excluded.\n */\nexport async function runGates(\n    gates: readonly Gate<GateContextBase>[],\n    ctx: GateContextBase,\n    observe?: GateObserver\n): Promise<void> {\n    try {\n        for (const gate of gates) {\n            await (observe ? timedCheck(gate, ctx, observe) : runCheck(gate, ctx));\n        }\n        await runCommits(ctx);\n    } finally {\n        discardCommits(ctx);\n    }\n}\n\n// dispatchers call this before execute, inside the boundary, so a refusal renders or drops. the\n// explicit routeId overrides the ctor-derived id for manifest-driven handlers with no route metadata.\nexport async function runHandlerGates(\n    handlerCtor: object,\n    ctx: GateContextBase,\n    routeId?: string,\n    observe?: GateObserver\n): Promise<void> {\n    // justified: getMetadata returns any, and this key only ever stores the @Gated gate array\n    const gates = Reflect.getMetadata(GatedMetadataKey, handlerCtor) as readonly Gate<GateContextBase>[] | undefined;\n    if (!gates) return;\n    await runGates(gates, { ...ctx, routeId: routeId ?? routeIdOf(handlerCtor) }, observe);\n}\n","import { Logger, paint } from '@seedcord/logger';\nimport { Envapter } from 'envapt';\n\nimport type { GateObserver } from './runGates';\n\n// combined check time slower than this cuts into the 3s interaction-ack budget\nconst SLOW_GATE_MS = 750;\n\n// lazy because the logger reads the environment, which binds after this module loads\nlet gateLogger: Logger | undefined;\nfunction logger(): Logger {\n    gateLogger ??= new Logger('Gates', { channel: 'gates' });\n    return gateLogger;\n}\n\n/**\n * Collects each gate check's elapsed time for one dispatch. `report` warns once when the checks sum\n * past the threshold, naming the total, the route, and each gate's share.\n */\nexport interface SlowGateMonitor {\n    readonly observe: GateObserver;\n    report(routeId: string | null): void;\n}\n\n// undefined in production, so timedCheck skips the clock there. read per call, the environment binds late\nexport function slowGateMonitor(): SlowGateMonitor | undefined {\n    if (Envapter.isProduction) return undefined;\n    const readings: { name: string; ms: number }[] = [];\n    return {\n        observe: (name, ms) => readings.push({ name, ms }),\n        report(routeId) {\n            const total = readings.reduce((sum, reading) => sum + reading.ms, 0);\n            if (total < SLOW_GATE_MS) return;\n            const shares = readings\n                .toSorted((a, b) => b.ms - a.ms)\n                .map((reading) => `${paint.sky.bold(reading.name)} ${Math.round(reading.ms)}ms`);\n            const route = routeId === null ? '' : ` for ${paint.sky.bold(routeId)}`;\n            const headline = `gates${route} took ${paint.amber(`${Math.round(total)}ms`)} of the 3s ack budget`;\n            logger().utils.block(headline, shares, 'warn', (text) => text);\n        }\n    };\n}\n","import type { DevChannel } from '@seedcord/types/internal';\n\n// the minimal raw-hot shape, satisfied by both vite's `import.meta.hot` and the CLI's `NormalizedHotChannel`.\ninterface RawHot {\n    send(event: string, data?: unknown): void;\n    on(event: string, cb: (data: unknown) => void): void;\n}\n\n/**\n * Wraps a raw vite hot object as a typed {@link DevChannel}.\n *\n * @internal\n */\nexport function wrapHot<TSend, TRecv>(hot: RawHot): DevChannel<TSend, TRecv> {\n    return {\n        send: (event, data) => hot.send(event, data),\n        // justified: RawHot types every payload as unknown, the wire contract guarantees it matches TRecv[Key]\n        on: (event, cb) => hot.on(event, cb as (data: unknown) => void)\n    };\n}\n","// scoped here so import.meta.hot stays untyped in the rest of the package\n/// <reference types=\"vite/client\" />\nimport { Logger } from '@seedcord/logger';\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\nimport { Envapter } from 'envapt';\n\nimport { setDevChannel } from './devChannel';\nimport { wrapHot } from './wrapHot';\n\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\nimport type { SeedcordCliEvents, SeedcordFrameworkEvents } from '@seedcord/types/internal';\n\nexport class HmrManager {\n    private readonly logger = new Logger('HMR', { channel: 'hmr' });\n    private readonly listeners = new Set<HmrAware>();\n\n    /** @internal */\n    public init(): void {\n        if (!import.meta.hot) return;\n        // the only raw `import.meta.hot` read in the framework\n        const channel = wrapHot<SeedcordFrameworkEvents, SeedcordCliEvents>(import.meta.hot);\n        setDevChannel(channel);\n\n        if (Envapter.isDevelopment || Envapter.isTest) {\n            this.logger.info('Enabled');\n\n            channel.on('seedcord:hmr', (payload) => {\n                const affected = payload.affectedModules?.length ?? 0;\n                this.logger.info(`${chalk.bold('1')} module changed, ${chalk.bold(affected)} affected modules`);\n\n                if (payload.affectedModules) {\n                    this.logger.utils.list(\n                        payload.affectedModules.map((mod) => formatFilePath(mod)),\n                        'Affected modules: '\n                    );\n                }\n\n                void this.handleUpdate(payload);\n            });\n        }\n    }\n\n    /** @internal */\n    public register(listener: HmrAware): void {\n        this.listeners.add(listener);\n    }\n\n    /** @internal */\n    public unregister(listener: HmrAware): void {\n        this.listeners.delete(listener);\n    }\n\n    private async handleUpdate(event: HmrUpdateEvent): Promise<void> {\n        const promises = [...this.listeners].map(async (listener) => {\n            try {\n                await listener.onHmr(event);\n            } catch (error) {\n                this.logger.error(`Error handling HMR update in ${chalk.bold(listener.constructor.name)}: `, error);\n            }\n        });\n\n        await Promise.all(promises);\n    }\n}\n","// dropping a non-Error throw would leave the user with no fault card, and every report payload declares an Error\n/** @internal */\nexport function asError(caught: unknown): Error {\n    return Error.isError(caught) ? caught : new Error(String(caught), { cause: caught });\n}\n","import { CustomId } from '@customId/CustomId';\n\nimport type { CustomIdField } from '@customId/Field';\n\n// Included in the layout hash so it is fixed per prefix. Reducing it marks every active button as StaleCustomId.\n// @internal\nexport const PAGE_MAX = 1_000_000;\n\n// Discord rejects a message with duplicate custom_ids, and two controls can target the same page (first and\n// prev both hit 0), so each control uses a distinct slot.\n// @internal\nconst SLOT_MAX = 4;\n\n/** Page cursor for a paginator. */\nexport type PageCursor<Prefix extends string> = CustomId<\n    Prefix,\n    { page: CustomIdField<number>; slot: CustomIdField<number> }\n>;\n\n/** Build the page cursor for a paginator. */\nexport function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix> {\n    return new CustomId(prefix).int('page', 0, PAGE_MAX).int('slot', 0, SLOT_MAX);\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport type { AckTrace } from './AckTrace';\n\nexport type AckState = 'unacked' | 'deferred-reply' | 'deferred-update' | 'replied';\n\nexport type ReplyMethod =\n    | 'reply'\n    | 'defer'\n    | 'deferUpdate'\n    | 'update'\n    | 'followUp'\n    | 'edit'\n    | 'delete'\n    | 'send'\n    | 'showModal';\n\ninterface Illegal {\n    // spliced into the message after \"was called when\"\n    readonly reason: string;\n    readonly alternative: string;\n}\n\nconst showModalReason: Illegal = {\n    reason: 'this interaction was already acknowledged',\n    alternative: 'showModal() must be the initial response.'\n};\n\nfunction deferReason(what: string): Illegal {\n    return {\n        reason: `this interaction was already acknowledged with ${what}`,\n        alternative: 'A deferral can only be the initial response.'\n    };\n}\n\n// a missing entry means legal in that state\nconst ILLEGAL: Record<Exclude<ReplyMethod, 'send'>, Partial<Record<AckState, Illegal>>> = {\n    reply: {\n        'deferred-reply': {\n            reason: 'this interaction was already deferred',\n            alternative: 'Use edit() to fill the deferred reply or followUp() for a new message.'\n        },\n        'deferred-update': {\n            reason: 'this interaction was already acknowledged with a deferred update',\n            alternative: 'Use followUp() for a new message.'\n        },\n        replied: {\n            reason: 'this interaction was already replied to',\n            alternative: 'Use followUp() for a new message or edit() to rewrite the reply.'\n        }\n    },\n    defer: {\n        'deferred-reply': deferReason('a deferred reply'),\n        'deferred-update': deferReason('a deferred update'),\n        replied: deferReason('a reply')\n    },\n    deferUpdate: {\n        'deferred-reply': deferReason('a deferred reply'),\n        'deferred-update': deferReason('a deferred update'),\n        replied: deferReason('a reply')\n    },\n    update: {\n        'deferred-reply': {\n            reason: 'this interaction was deferred as a reply',\n            alternative: 'The placeholder is yours via edit(). update() rewrites a source message.'\n        },\n        replied: {\n            reason: 'this interaction was already replied to',\n            alternative: 'update() rewrites a source message. Use edit() or followUp() instead.'\n        }\n    },\n    followUp: {\n        unacked: {\n            reason: 'this interaction has not been acknowledged yet',\n            alternative: 'Ack first with reply() or defer().'\n        }\n    },\n    edit: {\n        unacked: {\n            reason: 'nothing has been sent yet',\n            alternative: 'Send with reply() or defer() first, then edit() rewrites it.'\n        }\n    },\n    delete: {\n        unacked: {\n            reason: 'nothing has been sent yet',\n            alternative: 'Acknowledge first with reply() or defer(), then delete() removes it.'\n        }\n    },\n    showModal: {\n        'deferred-reply': showModalReason,\n        'deferred-update': showModalReason,\n        replied: showModalReason\n    }\n};\n\nconst SEND_TARGET: Record<AckState, 'reply' | 'edit' | 'followUp'> = {\n    unacked: 'reply',\n    'deferred-reply': 'edit',\n    'deferred-update': 'followUp',\n    replied: 'followUp'\n};\n\n/** Throws before any API call. `ackedBy` becomes the throw cause, its stack points at the first ack. */\nexport function checkAckLegality(method: ReplyMethod, state: AckState, routeId: string, ackedBy?: AckTrace): void {\n    if (method === 'send') return;\n    const illegal = ILLEGAL[method][state];\n    if (!illegal) return;\n    throw new SeedcordError(\n        SeedcordErrorCode.ReplyIllegalAckState,\n        [method, illegal.reason, illegal.alternative, routeId],\n        { cause: ackedBy }\n    );\n}\n\nexport function sendTarget(state: AckState): 'reply' | 'edit' | 'followUp' {\n    return SEND_TARGET[state];\n}\n","import type { ReplyMethod } from './ackLegality';\n\n/** The first ack's stack, passed as the throw cause so a double-ack points to both lines. */\nexport class AckTrace extends Error {\n    public constructor(method: ReplyMethod) {\n        super(`${method}() acknowledged this interaction`);\n        this.name = 'AckTrace';\n    }\n}\n","import { asError } from '@stops/asError';\nimport { PublishDefault } from '@subscribers/publishDefault';\n\nimport type { ReplyMethod } from './ackLegality';\nimport type { Bus } from '@subscribers/Bus';\nimport type { ResponseOutcome } from '@subscribers/types/Subscriptions';\n\n/** What `publishResponse` requires. Without it the call returns without publishing. */\nexport interface ReplyTelemetry {\n    readonly bus: Bus;\n    readonly interactionId: string;\n}\n\n/** The reply verbs plus the autocomplete choices callback, which runs outside the ack state machine. */\nexport type WriteMethod = ReplyMethod | 'respond';\n\n/** What one write reports once it settles. */\nexport interface ResponseReport {\n    readonly routeId: string;\n    readonly method: WriteMethod;\n    /** `performance.now()` captured before the write began. */\n    readonly startedAt: number;\n    readonly outcome: ResponseOutcome;\n    readonly messageId: string | null;\n    readonly error?: Error;\n}\n\n/** @internal */\nexport function publishResponse(telemetry: ReplyTelemetry | undefined, report: ResponseReport): void {\n    if (!telemetry) return;\n    telemetry.bus[PublishDefault]('responseAttempted', {\n        routeId: report.routeId,\n        interactionId: telemetry.interactionId,\n        method: report.method,\n        outcome: report.outcome,\n        durationMs: performance.now() - report.startedAt,\n        messageId: report.messageId,\n        ...(report.error && { error: report.error })\n    });\n}\n\n/**\n * Runs a write that returns no message and publishes whichever arm it takes.\n *\n * @internal\n */\nexport async function reportedWrite<Result>(\n    telemetry: ReplyTelemetry | undefined,\n    routeId: string,\n    method: WriteMethod,\n    write: () => Promise<Result>\n): Promise<Result> {\n    const startedAt = performance.now();\n    const result = await attemptWrite(telemetry, routeId, method, startedAt, write);\n    publishResponse(telemetry, { routeId, method, startedAt, outcome: 'sent', messageId: null });\n    return result;\n}\n\n/**\n * Runs a wire write and publishes the `failed` arm when it throws, since the caller's success report\n * sits after the write and a throw skips it.\n *\n * @internal\n */\nexport async function attemptWrite<Result>(\n    telemetry: ReplyTelemetry | undefined,\n    routeId: string,\n    method: WriteMethod,\n    startedAt: number,\n    write: () => Promise<Result>\n): Promise<Result> {\n    try {\n        return await write();\n    } catch (caught) {\n        const error = asError(caught);\n        publishResponse(telemetry, { routeId, method, startedAt, outcome: 'failed', messageId: null, error });\n        // rethrown raw, so the caller catches the value the write threw\n        throw caught;\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\n// shapeshift aggregate errors nest, the cap bounds the recursion\nconst MAX_DEPTH = 8;\n\ninterface ShapeshiftLike {\n    readonly message?: unknown;\n    readonly errors?: unknown;\n    readonly constraint?: unknown;\n    readonly validator?: unknown;\n    readonly expected?: unknown;\n    readonly given?: unknown;\n}\n\nconst OPERATOR_WORD: Record<string, string> = {\n    '<=': 'at most',\n    '>=': 'at least',\n    '<': 'fewer than',\n    '>': 'more than'\n};\n\nconst KIND_WORD: Record<string, string> = {\n    string: 'a string',\n    number: 'a number',\n    boolean: 'a boolean',\n    bigint: 'a bigint',\n    array: 'a list',\n    tuple: 'a list',\n    date: 'a date',\n    object: 'an object'\n};\n\nfunction asRecord(value: unknown): ShapeshiftLike | null {\n    return typeof value === 'object' && value !== null ? value : null;\n}\n\nfunction firstLine(message: unknown): string {\n    if (typeof message !== 'string') return 'unknown validation failure';\n    return message.split('\\n')[0] ?? message;\n}\n\n// strings over this limit render as a character count\nconst GIVEN_PREVIEW_LIMIT = 40;\n\nfunction gotPhrase(given: unknown): string {\n    if (given === undefined) return 'nothing';\n    if (given === null) return 'null';\n    if (typeof given === 'string') {\n        if (given.length === 0) return 'an empty string';\n        if (given.length > GIVEN_PREVIEW_LIMIT) return `${given.length} characters`;\n        return JSON.stringify(given);\n    }\n    if (Array.isArray(given)) return given.length === 0 ? 'an empty list' : `${given.length} items`;\n    if (typeof given === 'number' || typeof given === 'bigint' || typeof given === 'boolean') return String(given);\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- a null-prototype value has no constructor at runtime\n    if (typeof given === 'object') return given.constructor?.name ?? 'an object';\n    return typeof given;\n}\n\n// shapeshift constraint strings take the form 'expected.length >= 1' or 'expected <= 16777215'\nfunction needPhrase(expected: string, given: unknown): string | null {\n    const bounds = [...expected.matchAll(/expected(\\.length)?\\s*(<=|>=|<|>)\\s*(\\d+)/g)];\n    if (bounds.length === 0) return null;\n    const phrases = bounds.map(([, lengthPart, operator, limit]) => {\n        const word = OPERATOR_WORD[operator ?? ''] ?? operator ?? '';\n        if (!lengthPart) return `${word} ${limit}`;\n        const unit = typeof given === 'string' ? 'character' : 'item';\n        return `${word} ${limit} ${Number(limit) === 1 ? unit : `${unit}s`}`;\n    });\n    return phrases.join(' and ');\n}\n\nfunction instanceName(expected: unknown): string {\n    if (typeof expected === 'function' && expected.name) return expected.name;\n    return 'specific class instance';\n}\n\nfunction describeLeaf(record: ShapeshiftLike): string {\n    if (typeof record.constraint === 'string') {\n        const need = typeof record.expected === 'string' ? needPhrase(record.expected, record.given) : null;\n        if (need) return `need ${need}, got ${gotPhrase(record.given)}`;\n        return `${firstLine(record.message)}${'given' in record ? ` (got ${gotPhrase(record.given)})` : ''}`;\n    }\n    if (typeof record.expected === 'function') {\n        return `need a ${instanceName(record.expected)}, got ${gotPhrase(record.given)}`;\n    }\n    if (typeof record.validator === 'string') {\n        const kind = KIND_WORD[record.validator.replace(/^s\\./, '').replace(/\\(.*$/, '')];\n        if (kind) return `need ${kind}, got ${gotPhrase(record.given)}`;\n        return `${firstLine(record.message)}, got ${gotPhrase(record.given)}`;\n    }\n    return firstLine(record.message);\n}\n\n// a concrete bound is picked first, then accepted instance classes, then the first branch\nfunction describeUnion(branches: unknown[], depth: number): string {\n    const records: ShapeshiftLike[] = [];\n    for (const branch of branches) {\n        const record = asRecord(branch);\n        if (record) records.push(record);\n    }\n    const bounded = records.find((record) => typeof record.constraint === 'string');\n    if (bounded) return describeLeaf(bounded);\n\n    const names: string[] = [];\n    let allInstances = records.length > 0;\n    for (const record of records) {\n        if (typeof record.expected === 'function') names.push(instanceName(record.expected));\n        else allInstances = false;\n    }\n    if (allInstances) {\n        return `need a ${[...new Set(names)].join(' or ')}, got ${gotPhrase(records[0]?.given)}`;\n    }\n    return detailOf(branches[0], depth + 1);\n}\n\n// shapeshift nests errors as [key, inner] tuples\nfunction detailOf(value: unknown, depth: number): string {\n    const record = asRecord(value);\n    if (!record || depth >= MAX_DEPTH) return firstLine(record?.message);\n\n    if (Array.isArray(record.errors) && record.errors.length > 0) {\n        const errors = record.errors as unknown[];\n        const [first] = errors;\n        if (Array.isArray(first)) {\n            const [key, inner] = first as [unknown, unknown];\n            return `${String(key)}: ${detailOf(inner, depth + 1)}`;\n        }\n        return describeUnion(errors, depth);\n    }\n\n    return describeLeaf(record);\n}\n\n/**\n * Translates a shapeshift throw into an actionable message, keeping the original as `cause`. Any other\n * throw contributes its message as the detail.\n */\nexport function translateSerializationError(\n    error: unknown,\n    componentClass: string,\n    index: number,\n    routeId: string\n): SeedcordError<SeedcordErrorCode.ReplyComponentSerialization> {\n    const detail = detailOf(error, 0);\n    return new SeedcordError(SeedcordErrorCode.ReplyComponentSerialization, [componentClass, index, detail, routeId], {\n        cause: error\n    });\n}\n","import { TextDisplayBuilder } from '@discordjs/builders';\n\nimport { translateSerializationError } from './translateSerialization';\n\nimport type { ReplyResponse } from '@seedcord/types';\nimport type { APIMessageTopLevelComponent } from 'discord-api-types/v10';\n\n/** Serialized message data the transport wire writers consume. */\nexport interface SerializedReply {\n    readonly components: APIMessageTopLevelComponent[];\n    readonly allowedMentions?: ReplyResponse['allowedMentions'];\n    readonly files?: ReplyResponse['files'];\n}\n\n/** Wraps a string in a TextDisplay component. */\nexport function serializeReply(response: ReplyResponse | string, routeId: string): SerializedReply {\n    if (typeof response === 'string') {\n        try {\n            return { components: [new TextDisplayBuilder().setContent(response).toJSON()] };\n        } catch (error) {\n            throw translateSerializationError(error, 'TextDisplayBuilder', 0, routeId);\n        }\n    }\n\n    const components = response.components.map((component, index) => {\n        try {\n            return component.toJSON();\n        } catch (error) {\n            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- a null-prototype value has no constructor at runtime\n            const name = component.constructor?.name;\n            throw translateSerializationError(error, !name || name === 'Object' ? 'component' : name, index, routeId);\n        }\n    });\n\n    return {\n        components,\n        ...(response.allowedMentions && { allowedMentions: response.allowedMentions }),\n        ...(response.files && { files: response.files })\n    };\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport { checkAckLegality, sendTarget } from './ackLegality';\nimport { AckTrace } from './AckTrace';\nimport { attemptWrite, publishResponse } from './responseReport';\nimport { serializeReply } from './serializeReply';\nimport { translateSerializationError } from './translateSerialization';\n\nimport type { AckState, ReplyMethod } from './ackLegality';\nimport type { ReplyTelemetry } from './responseReport';\nimport type { SerializedReply } from './serializeReply';\nimport type { DeferOpts, ReplyResponse, SendOpts } from '@seedcord/types';\nimport type { ResponseOutcome } from '@subscribers/types/Subscriptions';\nimport type { APIModalInteractionResponseCallbackData } from 'discord-api-types/v10';\n\n/** The shape djs modal builders emit from `toJSON()`. */\nexport interface ModalLike {\n    toJSON(): APIModalInteractionResponseCallbackData;\n}\n\n/**\n * Tracks acknowledgement state and throws a translated `SeedcordError` on an illegal verb before any\n * transport call. Verbs execute the legality check, control the transport wire writer, then update the\n * state and ack trace. Each transport binds `TMessage` to its created-message lens and supplies the\n * writers.\n */\nexport abstract class BaseReplySender<TMessage extends { id: string }> {\n    private state: AckState;\n    // the only ids a targeted edit accepts\n    private readonly sent = new Set<string>();\n    // the cause carries the first ack's stack so a double-ack names both lines\n    private ackedBy?: AckTrace;\n\n    protected constructor(\n        protected readonly routeId: string,\n        initialState: AckState = 'unacked',\n        // absent for getConfirmation, which builds a sender from an interaction alone and reaches no core\n        private readonly telemetry?: ReplyTelemetry\n    ) {\n        this.state = initialState;\n    }\n\n    private report(method: ReplyMethod, startedAt: number, outcome: ResponseOutcome, messageId: string | null): void {\n        publishResponse(this.telemetry, { routeId: this.routeId, method, startedAt, outcome, messageId });\n    }\n\n    private async attempt<Result>(\n        method: ReplyMethod,\n        startedAt: number,\n        write: () => Promise<Result>\n    ): Promise<Result> {\n        return await attemptWrite(this.telemetry, this.routeId, method, startedAt, write);\n    }\n\n    public async reply(response: ReplyResponse | string, opts?: SendOpts): Promise<TMessage> {\n        this.checkLegality('reply');\n        const startedAt = performance.now();\n        const created = await this.attempt('reply', startedAt, () => this.writeReply(response, opts));\n        // the callback already acked discord, so record replied before the message guard can throw\n        this.transition('reply', 'replied');\n        const message = this.remember(this.requireMessage(created, 'reply'));\n        this.report('reply', startedAt, 'sent', message.id);\n        return message;\n    }\n\n    public async defer(opts?: DeferOpts): Promise<void> {\n        this.checkLegality('defer');\n        const startedAt = performance.now();\n        await this.attempt('defer', startedAt, () => this.writeDefer(opts));\n        this.transition('defer', 'deferred-reply');\n        this.report('defer', startedAt, 'sent', null);\n    }\n\n    public async deferUpdate(): Promise<void> {\n        this.checkLegality('deferUpdate');\n        const startedAt = performance.now();\n        await this.attempt('deferUpdate', startedAt, () => this.writeDeferUpdate());\n        this.transition('deferUpdate', 'deferred-update');\n        this.report('deferUpdate', startedAt, 'sent', null);\n    }\n\n    /**\n     * After a deferUpdate the state stays deferred-update, so the rewrite repeats. The returned message\n     * is the source message, editable only through a bare `update` or `edit`. A targeted `edit` or `delete`\n     * of it throws the foreign-target error.\n     */\n    public async update(response: ReplyResponse | string): Promise<TMessage> {\n        this.checkLegality('update');\n        const startedAt = performance.now();\n        // in deferred-update the source message is @original and the ack-legality check above already passed\n        if (this.state === 'deferred-update') {\n            const edited = await this.attempt('update', startedAt, () => this.editOriginal(response));\n            this.report('update', startedAt, 'sent', edited.id);\n            return edited;\n        }\n        const created = await this.attempt('update', startedAt, () => this.writeUpdate(response));\n        this.transition('update', 'replied');\n        const message = this.remember(this.requireMessage(created, 'update'));\n        this.report('update', startedAt, 'sent', message.id);\n        return message;\n    }\n\n    public async followUp(response: ReplyResponse | string, opts?: SendOpts): Promise<TMessage> {\n        this.checkLegality('followUp');\n        const startedAt = performance.now();\n        const created = await this.attempt('followUp', startedAt, () => this.writeFollowUp(response, opts));\n        const message = this.remember(created);\n        this.report('followUp', startedAt, 'sent', message.id);\n        return message;\n    }\n\n    public edit(response: ReplyResponse | string): Promise<TMessage>;\n    public edit(target: TMessage, response: ReplyResponse | string): Promise<TMessage>;\n    public async edit(\n        targetOrResponse: TMessage | ReplyResponse | string,\n        maybeResponse?: ReplyResponse | string\n    ): Promise<TMessage> {\n        this.checkLegality('edit');\n        const startedAt = performance.now();\n        if (maybeResponse === undefined) {\n            // justified: the overloads narrow targetOrResponse to a response once maybeResponse is absent\n            const edited = await this.attempt('edit', startedAt, () =>\n                this.editOriginal(targetOrResponse as ReplyResponse | string)\n            );\n            this.report('edit', startedAt, 'sent', edited.id);\n            return edited;\n        }\n        // justified: the overloads narrow targetOrResponse to a target message once maybeResponse is defined\n        const target = targetOrResponse as TMessage;\n        if (!this.sent.has(target.id)) {\n            throw new SeedcordError(SeedcordErrorCode.ReplyForeignEditTarget, ['edit', target.id, this.routeId]);\n        }\n        const written = await this.attempt('edit', startedAt, () => this.writeEditTarget(target.id, maybeResponse));\n        const message = this.remember(written);\n        this.report('edit', startedAt, 'sent', message.id);\n        return message;\n    }\n\n    public delete(): Promise<void>;\n    public delete(target: TMessage): Promise<void>;\n    public async delete(target?: TMessage): Promise<void> {\n        this.checkLegality('delete');\n        const startedAt = performance.now();\n        if (target === undefined) {\n            await this.attempt('delete', startedAt, () => this.writeDeleteOriginal());\n            this.report('delete', startedAt, 'sent', null);\n            return;\n        }\n        if (!this.sent.has(target.id)) {\n            throw new SeedcordError(SeedcordErrorCode.ReplyForeignEditTarget, ['delete', target.id, this.routeId]);\n        }\n        await this.attempt('delete', startedAt, () => this.writeDeleteTarget(target.id));\n        // evict so a later targeted edit of this id throws foreign\n        this.sent.delete(target.id);\n        this.report('delete', startedAt, 'sent', null);\n    }\n\n    /** Routes to the verb the current ack state permits. Every state has a route, so the illegal-ack throw is unreachable. */\n    public async send(response: ReplyResponse | string, opts?: SendOpts): Promise<TMessage> {\n        const target = sendTarget(this.state);\n        if (target === 'reply') return await this.reply(response, opts);\n        if (target === 'edit') return await this.edit(response);\n        return await this.followUp(response, opts);\n    }\n\n    /** Must be the initial response. */\n    public async showModal(modal: ModalLike): Promise<void> {\n        this.checkLegality('showModal');\n        this.guardModalSource();\n        let data: APIModalInteractionResponseCallbackData;\n        try {\n            data = modal.toJSON();\n        } catch (error) {\n            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- a null-prototype modal has no constructor at runtime\n            const name = modal.constructor?.name;\n            throw translateSerializationError(error, !name || name === 'Object' ? 'modal' : name, 0, this.routeId);\n        }\n        const startedAt = performance.now();\n        await this.attempt('showModal', startedAt, () => this.writeModal(data));\n        this.transition('showModal', 'replied');\n        this.report('showModal', startedAt, 'sent', null);\n    }\n\n    protected serialize(response: ReplyResponse | string): SerializedReply {\n        return serializeReply(response, this.routeId);\n    }\n\n    protected remember(created: TMessage): TMessage {\n        this.sent.add(created.id);\n        return created;\n    }\n\n    // a with_response callback always returns the created message, this guards a wire-contract gap\n    private requireMessage(created: TMessage | undefined, method: 'reply' | 'update'): TMessage {\n        if (!created) throw new SeedcordError(SeedcordErrorCode.ReplyCallbackMissingMessage, [method, this.routeId]);\n        return created;\n    }\n\n    private async editOriginal(response: ReplyResponse | string): Promise<TMessage> {\n        const edited = await this.writeEditOriginal(response);\n        // after a deferUpdate the source message is @original, which this interaction did not send\n        if (this.state !== 'deferred-update') this.remember(edited);\n        return edited;\n    }\n\n    private checkLegality(method: ReplyMethod): void {\n        checkAckLegality(method, this.state, this.routeId, this.ackedBy);\n    }\n\n    private transition(method: ReplyMethod, state: AckState): void {\n        this.state = state;\n        this.ackedBy = new AckTrace(method);\n    }\n\n    // the modal-submit backstop, gateway overrides, the base call is a no-op elsewhere\n    protected guardModalSource(): void {}\n\n    protected abstract writeReply(response: ReplyResponse | string, opts?: SendOpts): Promise<TMessage | undefined>;\n    protected abstract writeDefer(opts?: DeferOpts): Promise<void>;\n    protected abstract writeDeferUpdate(): Promise<void>;\n    protected abstract writeUpdate(response: ReplyResponse | string): Promise<TMessage | undefined>;\n    protected abstract writeFollowUp(response: ReplyResponse | string, opts?: SendOpts): Promise<TMessage>;\n    protected abstract writeEditOriginal(response: ReplyResponse | string): Promise<TMessage>;\n    protected abstract writeEditTarget(targetId: string, response: ReplyResponse | string): Promise<TMessage>;\n    protected abstract writeDeleteOriginal(): Promise<void>;\n    protected abstract writeDeleteTarget(targetId: string): Promise<void>;\n    protected abstract writeModal(data: APIModalInteractionResponseCallbackData): Promise<void>;\n}\n","/**\n * Drops duplicate fault reports inside a fixed window, so a recurring fault (a database outage on a\n * hot path) reports once per window and never floods the webhook.\n *\n * @internal\n */\nexport class FaultThrottle {\n    // keyed by core so each bot gets its own window, and the entry is collected with the core\n    private static readonly perCore = new WeakMap<object, FaultThrottle>();\n\n    /**\n     * The throttle for one bot instance.\n     *\n     * @internal\n     */\n    public static for(core: object): FaultThrottle {\n        let throttle = FaultThrottle.perCore.get(core);\n        if (!throttle) {\n            throttle = new FaultThrottle();\n            FaultThrottle.perCore.set(core, throttle);\n        }\n        return throttle;\n    }\n\n    private readonly lastReportedAt = new Map<string, number>();\n\n    constructor(\n        private readonly windowMs = 60_000,\n        private readonly now: () => number = () => Date.now()\n    ) {}\n\n    /** Evicts the entry for this key if it has aged out. */\n    public shouldReport(key: string): boolean {\n        const last = this.lastReportedAt.get(key);\n        if (last === undefined) return true;\n        if (this.now() - last < this.windowMs) return false;\n\n        this.lastReportedAt.delete(key);\n        return true;\n    }\n\n    public markReported(key: string): void {\n        this.lastReportedAt.set(key, this.now());\n    }\n\n    public clear(): void {\n        this.lastReportedAt.clear();\n    }\n}\n","import { timestampFromSnowflake } from '@seedcord/utils';\n\nimport { Notice } from '@stops/Notice';\nimport { Silence } from '@stops/Silence';\n\nimport type { InteractionRoutes } from '@src/metadataKeys';\nimport type { DispatchOutcome, SubscriptionData } from '@subscribers/types/Subscriptions';\n\n/**\n * Classifies a caught stop for `interactionDispatched` so a gate and a\n * handler label the same stop identically.\n *\n * @internal\n */\nexport function outcomeFor(caught: unknown): DispatchOutcome {\n    if (caught instanceof Silence) return 'refused';\n    if (caught instanceof Notice) return caught.report ? 'failed' : 'refused';\n    return 'failed';\n}\n\n/** The values a dispatcher has once its handler chain settles. */\ninterface DispatchReport {\n    readonly routeId: string;\n    readonly interactionId: string;\n    readonly kind: `${InteractionRoutes}`;\n    readonly outcome: DispatchOutcome;\n    /** True when no route matched and the unhandled default ran. */\n    readonly fallback: boolean;\n    /** `performance.now()` captured as the dispatch began. */\n    readonly startedAt: number;\n    /** {@link queuedMsFor} read at the same moment as `startedAt`. */\n    readonly queuedMs: number;\n}\n\n/**\n * Discord's interaction creation to now, read from the snowflake. Called at dispatch entry, since\n * a later read would count the handler run into the queue time as well.\n *\n * @internal\n */\nexport function queuedMsFor(interactionId: string): number {\n    // telemetry never breaks a dispatch, and BigInt() throws on a malformed id\n    try {\n        return Date.now() - timestampFromSnowflake(interactionId);\n    } catch {\n        return 0;\n    }\n}\n\n/**\n * Builds the `interactionDispatched` payload both transports publish, so the two clocks are read the\n * same way on each.\n *\n * @internal\n */\nexport function dispatchedPayload(report: DispatchReport): SubscriptionData<'interactionDispatched'> {\n    return {\n        routeId: report.routeId,\n        interactionId: report.interactionId,\n        kind: report.kind,\n        outcome: report.outcome,\n        fallback: report.fallback,\n        durationMs: performance.now() - report.startedAt,\n        queuedMs: report.queuedMs\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"internal.index.mjs","names":[],"sources":["../src/gates/runGates.ts","../src/gates/slowGate.ts","../src/miscellaneous/emojiConfig.ts","../src/hmr/wrapHot.ts","../src/hmr/HmrManager.ts","../src/stops/asError.ts","../src/reply/ackLegality.ts","../src/reply/AckTrace.ts","../src/reply/responseReport.ts","../src/reply/translateSerialization.ts","../src/reply/serializeReply.ts","../src/reply/BaseReplySender.ts","../src/subscribers/FaultThrottle.ts","../src/dispatch/dispatchReport.ts"],"sourcesContent":["import 'reflect-metadata';\n\nimport { GatedMetadataKey, InteractionRouteKeys } from '@src/metadataKeys';\n\nimport { discardCommits, runCheck, runCommits } from './effects';\n\nimport type { Gate, GateContextBase } from './Gate';\n\n/**\n * Receives each gate's name and how long its check ran, in ms. A combinator (`and`/`or`) reports once\n * under its joined name.\n */\nexport type GateObserver = (gateName: string, elapsedMs: number) => void;\n\n// the stable id a route decorator stored, e.g. slash:daily or button:confirm. null for a plain event handler.\nexport function routeIdOf(handlerCtor: object): string | null {\n    for (const [kind, key] of Object.entries(InteractionRouteKeys)) {\n        // justified: getMetadata returns any, this key only ever stores the route/prefix string array\n        const routes = Reflect.getMetadata(key, handlerCtor) as string[] | undefined;\n        if (routes?.length) return `${kind}:${routes.join(',')}`;\n    }\n    return null;\n}\n\nasync function timedCheck(gate: Gate<GateContextBase>, ctx: GateContextBase, observe: GateObserver): Promise<void> {\n    const start = performance.now();\n    // finally so a refusing gate still reports\n    try {\n        await runCheck(gate, ctx);\n    } finally {\n        observe(gate.name, performance.now() - start);\n    }\n}\n\n/**\n * Runs each gate's check in order, so the first refusal propagates to the dispatcher boundary. An effect\n * gate's commit runs once the whole set passes. When `observe` is given, each check is timed and reported,\n * commits excluded.\n */\nexport async function runGates(\n    gates: readonly Gate<GateContextBase>[],\n    ctx: GateContextBase,\n    observe?: GateObserver\n): Promise<void> {\n    try {\n        for (const gate of gates) {\n            await (observe ? timedCheck(gate, ctx, observe) : runCheck(gate, ctx));\n        }\n        await runCommits(ctx);\n    } finally {\n        discardCommits(ctx);\n    }\n}\n\n// dispatchers call this before execute, inside the boundary, so a refusal renders or drops. the\n// explicit routeId overrides the ctor-derived id for manifest-driven handlers with no route metadata.\nexport async function runHandlerGates(\n    handlerCtor: object,\n    ctx: GateContextBase,\n    routeId?: string,\n    observe?: GateObserver\n): Promise<void> {\n    // justified: getMetadata returns any, and this key only ever stores the @Gated gate array\n    const gates = Reflect.getMetadata(GatedMetadataKey, handlerCtor) as readonly Gate<GateContextBase>[] | undefined;\n    if (!gates) return;\n    await runGates(gates, { ...ctx, routeId: routeId ?? routeIdOf(handlerCtor) }, observe);\n}\n","import { Logger, paint } from '@seedcord/logger';\nimport { Envapter } from 'envapt';\n\nimport type { GateObserver } from './runGates';\n\n// combined check time slower than this cuts into the 3s interaction-ack budget\nconst SLOW_GATE_MS = 750;\n\n// lazy because the logger reads the environment, which binds after this module loads\nlet gateLogger: Logger | undefined;\nfunction logger(): Logger {\n    gateLogger ??= new Logger('Gates', { channel: 'gates' });\n    return gateLogger;\n}\n\n/**\n * Collects each gate check's elapsed time for one dispatch. `report` warns once when the checks sum\n * past the threshold, naming the total, the route, and each gate's share.\n */\nexport interface SlowGateMonitor {\n    readonly observe: GateObserver;\n    report(routeId: string | null): void;\n}\n\n// undefined in production, so timedCheck skips the clock there. read per call, the environment binds late\nexport function slowGateMonitor(): SlowGateMonitor | undefined {\n    if (Envapter.isProduction) return undefined;\n    const readings: { name: string; ms: number }[] = [];\n    return {\n        observe: (name, ms) => readings.push({ name, ms }),\n        report(routeId) {\n            const total = readings.reduce((sum, reading) => sum + reading.ms, 0);\n            if (total < SLOW_GATE_MS) return;\n            const shares = readings\n                .toSorted((a, b) => b.ms - a.ms)\n                .map((reading) => `${paint.sky.bold(reading.name)} ${Math.round(reading.ms)}ms`);\n            const route = routeId === null ? '' : ` for ${paint.sky.bold(routeId)}`;\n            const headline = `gates${route} took ${paint.amber(`${Math.round(total)}ms`)} of the 3s ack budget`;\n            logger().utils.block(headline, shares, 'warn', (text) => text);\n        }\n    };\n}\n","/** Narrows a configured emoji value to the `[name, guildId]` form. @internal */\nexport function isEmojiTuple(value: unknown): value is readonly [string, string] {\n    return Array.isArray(value) && value.length === 2 && typeof value[0] === 'string' && typeof value[1] === 'string';\n}\n","import type { DevChannel } from '@seedcord/types/internal';\n\n// the minimal raw-hot shape, satisfied by both vite's `import.meta.hot` and the CLI's `NormalizedHotChannel`.\ninterface RawHot {\n    send(event: string, data?: unknown): void;\n    on(event: string, cb: (data: unknown) => void): void;\n}\n\n/**\n * Wraps a raw vite hot object as a typed {@link DevChannel}.\n *\n * @internal\n */\nexport function wrapHot<TSend, TRecv>(hot: RawHot): DevChannel<TSend, TRecv> {\n    return {\n        send: (event, data) => hot.send(event, data),\n        // justified: RawHot types every payload as unknown, the wire contract guarantees it matches TRecv[Key]\n        on: (event, cb) => hot.on(event, cb as (data: unknown) => void)\n    };\n}\n","// scoped here so import.meta.hot stays untyped in the rest of the package\n/// <reference types=\"vite/client\" />\nimport { Logger } from '@seedcord/logger';\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\nimport { Envapter } from 'envapt';\n\nimport { setDevChannel } from './devChannel';\nimport { wrapHot } from './wrapHot';\n\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\nimport type { SeedcordCliEvents, SeedcordFrameworkEvents } from '@seedcord/types/internal';\n\nexport class HmrManager {\n    private readonly logger = new Logger('HMR', { channel: 'hmr' });\n    private readonly listeners = new Set<HmrAware>();\n\n    /** @internal */\n    public init(): void {\n        if (!import.meta.hot) return;\n        // the only raw `import.meta.hot` read in the framework\n        const channel = wrapHot<SeedcordFrameworkEvents, SeedcordCliEvents>(import.meta.hot);\n        setDevChannel(channel);\n\n        if (Envapter.isDevelopment || Envapter.isTest) {\n            this.logger.info('Enabled');\n\n            channel.on('seedcord:hmr', (payload) => {\n                const affected = payload.affectedModules?.length ?? 0;\n                this.logger.info(`${chalk.bold('1')} module changed, ${chalk.bold(affected)} affected modules`);\n\n                if (payload.affectedModules) {\n                    this.logger.utils.list(\n                        payload.affectedModules.map((mod) => formatFilePath(mod)),\n                        'Affected modules: '\n                    );\n                }\n\n                void this.handleUpdate(payload);\n            });\n        }\n    }\n\n    /** @internal */\n    public register(listener: HmrAware): void {\n        this.listeners.add(listener);\n    }\n\n    /** @internal */\n    public unregister(listener: HmrAware): void {\n        this.listeners.delete(listener);\n    }\n\n    private async handleUpdate(event: HmrUpdateEvent): Promise<void> {\n        const promises = [...this.listeners].map(async (listener) => {\n            try {\n                await listener.onHmr(event);\n            } catch (error) {\n                this.logger.error(`Error handling HMR update in ${chalk.bold(listener.constructor.name)}: `, error);\n            }\n        });\n\n        await Promise.all(promises);\n    }\n}\n","// dropping a non-Error throw would leave the user with no fault card, and every report payload declares an Error\n/** @internal */\nexport function asError(caught: unknown): Error {\n    return Error.isError(caught) ? caught : new Error(String(caught), { cause: caught });\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport type { AckTrace } from './AckTrace';\n\nexport type AckState = 'unacked' | 'deferred-reply' | 'deferred-update' | 'replied';\n\nexport type ReplyMethod =\n    | 'reply'\n    | 'defer'\n    | 'deferUpdate'\n    | 'update'\n    | 'followUp'\n    | 'edit'\n    | 'delete'\n    | 'send'\n    | 'showModal';\n\ninterface Illegal {\n    // spliced into the message after \"was called when\"\n    readonly reason: string;\n    readonly alternative: string;\n}\n\nconst showModalReason: Illegal = {\n    reason: 'this interaction was already acknowledged',\n    alternative: 'showModal() must be the initial response.'\n};\n\nfunction deferReason(what: string): Illegal {\n    return {\n        reason: `this interaction was already acknowledged with ${what}`,\n        alternative: 'A deferral can only be the initial response.'\n    };\n}\n\n// a missing entry means legal in that state\nconst ILLEGAL: Record<Exclude<ReplyMethod, 'send'>, Partial<Record<AckState, Illegal>>> = {\n    reply: {\n        'deferred-reply': {\n            reason: 'this interaction was already deferred',\n            alternative: 'Use edit() to fill the deferred reply or followUp() for a new message.'\n        },\n        'deferred-update': {\n            reason: 'this interaction was already acknowledged with a deferred update',\n            alternative: 'Use followUp() for a new message.'\n        },\n        replied: {\n            reason: 'this interaction was already replied to',\n            alternative: 'Use followUp() for a new message or edit() to rewrite the reply.'\n        }\n    },\n    defer: {\n        'deferred-reply': deferReason('a deferred reply'),\n        'deferred-update': deferReason('a deferred update'),\n        replied: deferReason('a reply')\n    },\n    deferUpdate: {\n        'deferred-reply': deferReason('a deferred reply'),\n        'deferred-update': deferReason('a deferred update'),\n        replied: deferReason('a reply')\n    },\n    update: {\n        'deferred-reply': {\n            reason: 'this interaction was deferred as a reply',\n            alternative: 'The placeholder is yours via edit(). update() rewrites a source message.'\n        },\n        replied: {\n            reason: 'this interaction was already replied to',\n            alternative: 'update() rewrites a source message. Use edit() or followUp() instead.'\n        }\n    },\n    followUp: {\n        unacked: {\n            reason: 'this interaction has not been acknowledged yet',\n            alternative: 'Ack first with reply() or defer().'\n        }\n    },\n    edit: {\n        unacked: {\n            reason: 'nothing has been sent yet',\n            alternative: 'Send with reply() or defer() first, then edit() rewrites it.'\n        }\n    },\n    delete: {\n        unacked: {\n            reason: 'nothing has been sent yet',\n            alternative: 'Acknowledge first with reply() or defer(), then delete() removes it.'\n        }\n    },\n    showModal: {\n        'deferred-reply': showModalReason,\n        'deferred-update': showModalReason,\n        replied: showModalReason\n    }\n};\n\nconst SEND_TARGET: Record<AckState, 'reply' | 'edit' | 'followUp'> = {\n    unacked: 'reply',\n    'deferred-reply': 'edit',\n    'deferred-update': 'followUp',\n    replied: 'followUp'\n};\n\n/** Throws before any API call. `ackedBy` becomes the throw cause, its stack points at the first ack. */\nexport function checkAckLegality(method: ReplyMethod, state: AckState, routeId: string, ackedBy?: AckTrace): void {\n    if (method === 'send') return;\n    const illegal = ILLEGAL[method][state];\n    if (!illegal) return;\n    throw new SeedcordError(\n        SeedcordErrorCode.ReplyIllegalAckState,\n        [method, illegal.reason, illegal.alternative, routeId],\n        { cause: ackedBy }\n    );\n}\n\nexport function sendTarget(state: AckState): 'reply' | 'edit' | 'followUp' {\n    return SEND_TARGET[state];\n}\n","import type { ReplyMethod } from './ackLegality';\n\n/** The first ack's stack, passed as the throw cause so a double-ack points to both lines. */\nexport class AckTrace extends Error {\n    public constructor(method: ReplyMethod) {\n        super(`${method}() acknowledged this interaction`);\n        this.name = 'AckTrace';\n    }\n}\n","import { asError } from '@stops/asError';\nimport { PublishDefault } from '@subscribers/publishDefault';\n\nimport type { ReplyMethod } from './ackLegality';\nimport type { Bus } from '@subscribers/Bus';\nimport type { ResponseOutcome } from '@subscribers/types/Subscriptions';\n\n/** What `publishResponse` requires. Without it the call returns without publishing. */\nexport interface ReplyTelemetry {\n    readonly bus: Bus;\n    readonly interactionId: string;\n}\n\n/** The reply verbs plus the autocomplete choices callback, which runs outside the ack state machine. */\nexport type WriteMethod = ReplyMethod | 'respond';\n\n/** What one write reports once it settles. */\nexport interface ResponseReport {\n    readonly routeId: string;\n    readonly method: WriteMethod;\n    /** `performance.now()` captured before the write began. */\n    readonly startedAt: number;\n    readonly outcome: ResponseOutcome;\n    readonly messageId: string | null;\n    readonly error?: Error;\n}\n\n/** @internal */\nexport function publishResponse(telemetry: ReplyTelemetry | undefined, report: ResponseReport): void {\n    if (!telemetry) return;\n    telemetry.bus[PublishDefault]('responseAttempted', {\n        routeId: report.routeId,\n        interactionId: telemetry.interactionId,\n        method: report.method,\n        outcome: report.outcome,\n        durationMs: performance.now() - report.startedAt,\n        messageId: report.messageId,\n        ...(report.error && { error: report.error })\n    });\n}\n\n/**\n * Runs a write that returns no message and publishes whichever arm it takes.\n *\n * @internal\n */\nexport async function reportedWrite<Result>(\n    telemetry: ReplyTelemetry | undefined,\n    routeId: string,\n    method: WriteMethod,\n    write: () => Promise<Result>\n): Promise<Result> {\n    const startedAt = performance.now();\n    const result = await attemptWrite(telemetry, routeId, method, startedAt, write);\n    publishResponse(telemetry, { routeId, method, startedAt, outcome: 'sent', messageId: null });\n    return result;\n}\n\n/**\n * Runs a wire write and publishes the `failed` arm when it throws, since the caller's success report\n * sits after the write and a throw skips it.\n *\n * @internal\n */\nexport async function attemptWrite<Result>(\n    telemetry: ReplyTelemetry | undefined,\n    routeId: string,\n    method: WriteMethod,\n    startedAt: number,\n    write: () => Promise<Result>\n): Promise<Result> {\n    try {\n        return await write();\n    } catch (caught) {\n        const error = asError(caught);\n        publishResponse(telemetry, { routeId, method, startedAt, outcome: 'failed', messageId: null, error });\n        // rethrown raw, so the caller catches the value the write threw\n        throw caught;\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\n// shapeshift aggregate errors nest, the cap bounds the recursion\nconst MAX_DEPTH = 8;\n\ninterface ShapeshiftLike {\n    readonly message?: unknown;\n    readonly errors?: unknown;\n    readonly constraint?: unknown;\n    readonly validator?: unknown;\n    readonly expected?: unknown;\n    readonly given?: unknown;\n}\n\nconst OPERATOR_WORD: Record<string, string> = {\n    '<=': 'at most',\n    '>=': 'at least',\n    '<': 'fewer than',\n    '>': 'more than'\n};\n\nconst KIND_WORD: Record<string, string> = {\n    string: 'a string',\n    number: 'a number',\n    boolean: 'a boolean',\n    bigint: 'a bigint',\n    array: 'a list',\n    tuple: 'a list',\n    date: 'a date',\n    object: 'an object'\n};\n\nfunction asRecord(value: unknown): ShapeshiftLike | null {\n    return typeof value === 'object' && value !== null ? value : null;\n}\n\nfunction firstLine(message: unknown): string {\n    if (typeof message !== 'string') return 'unknown validation failure';\n    return message.split('\\n')[0] ?? message;\n}\n\n// strings over this limit render as a character count\nconst GIVEN_PREVIEW_LIMIT = 40;\n\nfunction gotPhrase(given: unknown): string {\n    if (given === undefined) return 'nothing';\n    if (given === null) return 'null';\n    if (typeof given === 'string') {\n        if (given.length === 0) return 'an empty string';\n        if (given.length > GIVEN_PREVIEW_LIMIT) return `${given.length} characters`;\n        return JSON.stringify(given);\n    }\n    if (Array.isArray(given)) return given.length === 0 ? 'an empty list' : `${given.length} items`;\n    if (typeof given === 'number' || typeof given === 'bigint' || typeof given === 'boolean') return String(given);\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- a null-prototype value has no constructor at runtime\n    if (typeof given === 'object') return given.constructor?.name ?? 'an object';\n    return typeof given;\n}\n\n// shapeshift constraint strings take the form 'expected.length >= 1' or 'expected <= 16777215'\nfunction needPhrase(expected: string, given: unknown): string | null {\n    const bounds = [...expected.matchAll(/expected(\\.length)?\\s*(<=|>=|<|>)\\s*(\\d+)/g)];\n    if (bounds.length === 0) return null;\n    const phrases = bounds.map(([, lengthPart, operator, limit]) => {\n        const word = OPERATOR_WORD[operator ?? ''] ?? operator ?? '';\n        if (!lengthPart) return `${word} ${limit}`;\n        const unit = typeof given === 'string' ? 'character' : 'item';\n        return `${word} ${limit} ${Number(limit) === 1 ? unit : `${unit}s`}`;\n    });\n    return phrases.join(' and ');\n}\n\nfunction instanceName(expected: unknown): string {\n    if (typeof expected === 'function' && expected.name) return expected.name;\n    return 'specific class instance';\n}\n\nfunction describeLeaf(record: ShapeshiftLike): string {\n    if (typeof record.constraint === 'string') {\n        const need = typeof record.expected === 'string' ? needPhrase(record.expected, record.given) : null;\n        if (need) return `need ${need}, got ${gotPhrase(record.given)}`;\n        return `${firstLine(record.message)}${'given' in record ? ` (got ${gotPhrase(record.given)})` : ''}`;\n    }\n    if (typeof record.expected === 'function') {\n        return `need a ${instanceName(record.expected)}, got ${gotPhrase(record.given)}`;\n    }\n    if (typeof record.validator === 'string') {\n        const kind = KIND_WORD[record.validator.replace(/^s\\./, '').replace(/\\(.*$/, '')];\n        if (kind) return `need ${kind}, got ${gotPhrase(record.given)}`;\n        return `${firstLine(record.message)}, got ${gotPhrase(record.given)}`;\n    }\n    return firstLine(record.message);\n}\n\n// a concrete bound is picked first, then accepted instance classes, then the first branch\nfunction describeUnion(branches: unknown[], depth: number): string {\n    const records: ShapeshiftLike[] = [];\n    for (const branch of branches) {\n        const record = asRecord(branch);\n        if (record) records.push(record);\n    }\n    const bounded = records.find((record) => typeof record.constraint === 'string');\n    if (bounded) return describeLeaf(bounded);\n\n    const names: string[] = [];\n    let allInstances = records.length > 0;\n    for (const record of records) {\n        if (typeof record.expected === 'function') names.push(instanceName(record.expected));\n        else allInstances = false;\n    }\n    if (allInstances) {\n        return `need a ${[...new Set(names)].join(' or ')}, got ${gotPhrase(records[0]?.given)}`;\n    }\n    return detailOf(branches[0], depth + 1);\n}\n\n// shapeshift nests errors as [key, inner] tuples\nfunction detailOf(value: unknown, depth: number): string {\n    const record = asRecord(value);\n    if (!record || depth >= MAX_DEPTH) return firstLine(record?.message);\n\n    if (Array.isArray(record.errors) && record.errors.length > 0) {\n        const errors = record.errors as unknown[];\n        const [first] = errors;\n        if (Array.isArray(first)) {\n            const [key, inner] = first as [unknown, unknown];\n            return `${String(key)}: ${detailOf(inner, depth + 1)}`;\n        }\n        return describeUnion(errors, depth);\n    }\n\n    return describeLeaf(record);\n}\n\n/**\n * Translates a shapeshift throw into an actionable message, keeping the original as `cause`. Any other\n * throw contributes its message as the detail.\n */\nexport function translateSerializationError(\n    error: unknown,\n    componentClass: string,\n    index: number,\n    routeId: string\n): SeedcordError<SeedcordErrorCode.ReplyComponentSerialization> {\n    const detail = detailOf(error, 0);\n    return new SeedcordError(SeedcordErrorCode.ReplyComponentSerialization, [componentClass, index, detail, routeId], {\n        cause: error\n    });\n}\n","import { TextDisplayBuilder } from '@discordjs/builders';\n\nimport { translateSerializationError } from './translateSerialization';\n\nimport type { ReplyResponse } from '@seedcord/types';\nimport type { APIMessageTopLevelComponent } from 'discord-api-types/v10';\n\n/** Serialized message data the transport wire writers consume. */\nexport interface SerializedReply<TNative = never> {\n    readonly components: APIMessageTopLevelComponent[];\n    readonly allowedMentions?: ReplyResponse['allowedMentions'];\n    readonly files?: ReplyResponse<TNative>['files'];\n}\n\n/** Wraps a string in a TextDisplay component. */\nexport function serializeReply<TNative>(\n    response: ReplyResponse<TNative> | string,\n    routeId: string\n): SerializedReply<TNative> {\n    if (typeof response === 'string') {\n        try {\n            return { components: [new TextDisplayBuilder().setContent(response).toJSON()] };\n        } catch (error) {\n            throw translateSerializationError(error, 'TextDisplayBuilder', 0, routeId);\n        }\n    }\n\n    const components = response.components.map((component, index) => {\n        try {\n            return component.toJSON();\n        } catch (error) {\n            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- a null-prototype value has no constructor at runtime\n            const name = component.constructor?.name;\n            throw translateSerializationError(error, !name || name === 'Object' ? 'component' : name, index, routeId);\n        }\n    });\n\n    return {\n        components,\n        ...(response.allowedMentions && { allowedMentions: response.allowedMentions }),\n        ...(response.files && { files: response.files })\n    };\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport { checkAckLegality, sendTarget } from './ackLegality';\nimport { AckTrace } from './AckTrace';\nimport { attemptWrite, publishResponse } from './responseReport';\nimport { serializeReply } from './serializeReply';\nimport { translateSerializationError } from './translateSerialization';\n\nimport type { AckState, ReplyMethod } from './ackLegality';\nimport type { ReplyTelemetry } from './responseReport';\nimport type { SerializedReply } from './serializeReply';\nimport type { DeferOpts, ReplyResponse, SendOpts } from '@seedcord/types';\nimport type { ResponseOutcome } from '@subscribers/types/Subscriptions';\nimport type { APIModalInteractionResponseCallbackData } from 'discord-api-types/v10';\n\n/** The shape djs modal builders emit from `toJSON()`. */\nexport interface ModalLike {\n    toJSON(): APIModalInteractionResponseCallbackData;\n}\n\n/**\n * Tracks acknowledgement state and throws a translated `SeedcordError` on an illegal verb before any\n * transport call. Verbs execute the legality check, control the transport wire writer, then update the\n * state and ack trace. Each transport binds `TMessage` to its created-message lens and supplies the\n * writers.\n */\nexport abstract class BaseReplySender<TMessage extends { id: string }, TNative = never> {\n    private state: AckState;\n    // the only ids a targeted edit accepts\n    private readonly sent = new Set<string>();\n    // the cause carries the first ack's stack so a double-ack reports both lines\n    private ackedBy?: AckTrace;\n\n    protected constructor(\n        protected readonly routeId: string,\n        initialState: AckState = 'unacked',\n        // absent for getConfirmation, which builds a sender from an interaction alone and reaches no core\n        private readonly telemetry?: ReplyTelemetry\n    ) {\n        this.state = initialState;\n    }\n\n    private report(method: ReplyMethod, startedAt: number, outcome: ResponseOutcome, messageId: string | null): void {\n        publishResponse(this.telemetry, { routeId: this.routeId, method, startedAt, outcome, messageId });\n    }\n\n    private async attempt<Result>(\n        method: ReplyMethod,\n        startedAt: number,\n        write: () => Promise<Result>\n    ): Promise<Result> {\n        return await attemptWrite(this.telemetry, this.routeId, method, startedAt, write);\n    }\n\n    public async reply(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage> {\n        this.checkLegality('reply');\n        const startedAt = performance.now();\n        const created = await this.attempt('reply', startedAt, () => this.writeReply(response, opts));\n        // the callback already acked discord, so record replied before the message guard can throw\n        this.transition('reply', 'replied');\n        const message = this.remember(this.requireMessage(created, 'reply'));\n        this.report('reply', startedAt, 'sent', message.id);\n        return message;\n    }\n\n    public async defer(opts?: DeferOpts): Promise<void> {\n        this.checkLegality('defer');\n        const startedAt = performance.now();\n        await this.attempt('defer', startedAt, () => this.writeDefer(opts));\n        this.transition('defer', 'deferred-reply');\n        this.report('defer', startedAt, 'sent', null);\n    }\n\n    public async deferUpdate(): Promise<void> {\n        this.checkLegality('deferUpdate');\n        const startedAt = performance.now();\n        await this.attempt('deferUpdate', startedAt, () => this.writeDeferUpdate());\n        this.transition('deferUpdate', 'deferred-update');\n        this.report('deferUpdate', startedAt, 'sent', null);\n    }\n\n    /**\n     * After a deferUpdate the state stays deferred-update, so the rewrite repeats. The returned message\n     * is the source message, editable only through a bare `update` or `edit`. A targeted `edit` or `delete`\n     * of it throws the foreign-target error.\n     */\n    public async update(response: ReplyResponse<TNative> | string): Promise<TMessage> {\n        this.checkLegality('update');\n        const startedAt = performance.now();\n        // in deferred-update the source message is @original and the ack-legality check above already passed\n        if (this.state === 'deferred-update') {\n            const edited = await this.attempt('update', startedAt, () => this.editOriginal(response));\n            this.report('update', startedAt, 'sent', edited.id);\n            return edited;\n        }\n        const created = await this.attempt('update', startedAt, () => this.writeUpdate(response));\n        this.transition('update', 'replied');\n        const message = this.remember(this.requireMessage(created, 'update'));\n        this.report('update', startedAt, 'sent', message.id);\n        return message;\n    }\n\n    public async followUp(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage> {\n        this.checkLegality('followUp');\n        const startedAt = performance.now();\n        const created = await this.attempt('followUp', startedAt, () => this.writeFollowUp(response, opts));\n        const message = this.remember(created);\n        this.report('followUp', startedAt, 'sent', message.id);\n        return message;\n    }\n\n    public edit(response: ReplyResponse<TNative> | string): Promise<TMessage>;\n    public edit(target: TMessage, response: ReplyResponse<TNative> | string): Promise<TMessage>;\n    public async edit(\n        targetOrResponse: TMessage | ReplyResponse<TNative> | string,\n        maybeResponse?: ReplyResponse<TNative> | string\n    ): Promise<TMessage> {\n        this.checkLegality('edit');\n        const startedAt = performance.now();\n        if (maybeResponse === undefined) {\n            // justified: the overloads narrow targetOrResponse to a response once maybeResponse is absent\n            const edited = await this.attempt('edit', startedAt, () =>\n                this.editOriginal(targetOrResponse as ReplyResponse<TNative> | string)\n            );\n            this.report('edit', startedAt, 'sent', edited.id);\n            return edited;\n        }\n        // justified: the overloads narrow targetOrResponse to a target message once maybeResponse is defined\n        const target = targetOrResponse as TMessage;\n        if (!this.sent.has(target.id)) {\n            throw new SeedcordError(SeedcordErrorCode.ReplyForeignEditTarget, ['edit', target.id, this.routeId]);\n        }\n        const written = await this.attempt('edit', startedAt, () => this.writeEditTarget(target.id, maybeResponse));\n        const message = this.remember(written);\n        this.report('edit', startedAt, 'sent', message.id);\n        return message;\n    }\n\n    public delete(): Promise<void>;\n    public delete(target: TMessage): Promise<void>;\n    public async delete(target?: TMessage): Promise<void> {\n        this.checkLegality('delete');\n        const startedAt = performance.now();\n        if (target === undefined) {\n            await this.attempt('delete', startedAt, () => this.writeDeleteOriginal());\n            this.report('delete', startedAt, 'sent', null);\n            return;\n        }\n        if (!this.sent.has(target.id)) {\n            throw new SeedcordError(SeedcordErrorCode.ReplyForeignEditTarget, ['delete', target.id, this.routeId]);\n        }\n        await this.attempt('delete', startedAt, () => this.writeDeleteTarget(target.id));\n        // evict so a later targeted edit of this id throws foreign\n        this.sent.delete(target.id);\n        this.report('delete', startedAt, 'sent', null);\n    }\n\n    /** Routes to the verb the current ack state permits. Every state has a route, so the illegal-ack throw is unreachable. */\n    public async send(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage> {\n        const target = sendTarget(this.state);\n        if (target === 'reply') return await this.reply(response, opts);\n        if (target === 'edit') return await this.edit(response);\n        return await this.followUp(response, opts);\n    }\n\n    /** Must be the initial response. */\n    public async showModal(modal: ModalLike): Promise<void> {\n        this.checkLegality('showModal');\n        this.guardModalSource();\n        let data: APIModalInteractionResponseCallbackData;\n        try {\n            data = modal.toJSON();\n        } catch (error) {\n            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- a null-prototype modal has no constructor at runtime\n            const name = modal.constructor?.name;\n            throw translateSerializationError(error, !name || name === 'Object' ? 'modal' : name, 0, this.routeId);\n        }\n        const startedAt = performance.now();\n        await this.attempt('showModal', startedAt, () => this.writeModal(data));\n        this.transition('showModal', 'replied');\n        this.report('showModal', startedAt, 'sent', null);\n    }\n\n    protected serialize(response: ReplyResponse<TNative> | string): SerializedReply<TNative> {\n        return serializeReply(response, this.routeId);\n    }\n\n    protected remember(created: TMessage): TMessage {\n        this.sent.add(created.id);\n        return created;\n    }\n\n    // a with_response callback always returns the created message, so this guards a wire-contract gap\n    private requireMessage(created: TMessage | undefined, method: 'reply' | 'update'): TMessage {\n        if (!created) throw new SeedcordError(SeedcordErrorCode.ReplyCallbackMissingMessage, [method, this.routeId]);\n        return created;\n    }\n\n    private async editOriginal(response: ReplyResponse<TNative> | string): Promise<TMessage> {\n        const edited = await this.writeEditOriginal(response);\n        // after a deferUpdate the source message is @original, which this interaction did not send\n        if (this.state !== 'deferred-update') this.remember(edited);\n        return edited;\n    }\n\n    private checkLegality(method: ReplyMethod): void {\n        checkAckLegality(method, this.state, this.routeId, this.ackedBy);\n    }\n\n    private transition(method: ReplyMethod, state: AckState): void {\n        this.state = state;\n        this.ackedBy = new AckTrace(method);\n    }\n\n    // gateway overrides this to reject a modal-submit source\n    protected guardModalSource(): void {}\n\n    protected abstract writeReply(\n        response: ReplyResponse<TNative> | string,\n        opts?: SendOpts\n    ): Promise<TMessage | undefined>;\n    protected abstract writeDefer(opts?: DeferOpts): Promise<void>;\n    protected abstract writeDeferUpdate(): Promise<void>;\n    protected abstract writeUpdate(response: ReplyResponse<TNative> | string): Promise<TMessage | undefined>;\n    protected abstract writeFollowUp(response: ReplyResponse<TNative> | string, opts?: SendOpts): Promise<TMessage>;\n    protected abstract writeEditOriginal(response: ReplyResponse<TNative> | string): Promise<TMessage>;\n    protected abstract writeEditTarget(targetId: string, response: ReplyResponse<TNative> | string): Promise<TMessage>;\n    protected abstract writeDeleteOriginal(): Promise<void>;\n    protected abstract writeDeleteTarget(targetId: string): Promise<void>;\n    protected abstract writeModal(data: APIModalInteractionResponseCallbackData): Promise<void>;\n}\n","/**\n * Drops duplicate fault reports inside a fixed window, so a recurring fault (a database outage on a\n * hot path) reports once per window and never floods the webhook.\n *\n * @internal\n */\nexport class FaultThrottle {\n    // keyed by core so each bot gets its own window, and the entry is collected with the core\n    private static readonly perCore = new WeakMap<object, FaultThrottle>();\n\n    /**\n     * The throttle for one bot instance.\n     *\n     * @internal\n     */\n    public static for(core: object): FaultThrottle {\n        let throttle = FaultThrottle.perCore.get(core);\n        if (!throttle) {\n            throttle = new FaultThrottle();\n            FaultThrottle.perCore.set(core, throttle);\n        }\n        return throttle;\n    }\n\n    private readonly lastReportedAt = new Map<string, number>();\n\n    constructor(\n        private readonly windowMs = 60_000,\n        private readonly now: () => number = () => Date.now()\n    ) {}\n\n    /** Evicts the entry for this key if it has aged out. */\n    public shouldReport(key: string): boolean {\n        const last = this.lastReportedAt.get(key);\n        if (last === undefined) return true;\n        if (this.now() - last < this.windowMs) return false;\n\n        this.lastReportedAt.delete(key);\n        return true;\n    }\n\n    public markReported(key: string): void {\n        this.lastReportedAt.set(key, this.now());\n    }\n\n    public clear(): void {\n        this.lastReportedAt.clear();\n    }\n}\n","import { timestampFromSnowflake } from '@seedcord/utils';\n\nimport { Notice } from '@stops/Notice';\nimport { Silence } from '@stops/Silence';\n\nimport type { InteractionRoutes } from '@src/metadataKeys';\nimport type { DispatchOutcome, SubscriptionData } from '@subscribers/types/Subscriptions';\n\n/**\n * Classifies a caught stop for `interactionDispatched` so a gate and a\n * handler label the same stop identically.\n *\n * @internal\n */\nexport function outcomeFor(caught: unknown): DispatchOutcome {\n    if (caught instanceof Silence) return 'refused';\n    if (caught instanceof Notice) return caught.report ? 'failed' : 'refused';\n    return 'failed';\n}\n\n/** The values a dispatcher has once its handler chain settles. */\ninterface DispatchReport {\n    readonly routeId: string;\n    readonly interactionId: string;\n    readonly kind: `${InteractionRoutes}`;\n    readonly outcome: DispatchOutcome;\n    /** True when no route matched and the unhandled default ran. */\n    readonly fallback: boolean;\n    /** `performance.now()` captured as the dispatch began. */\n    readonly startedAt: number;\n    /** {@link queuedMsFor} read at the same moment as `startedAt`. */\n    readonly queuedMs: number;\n}\n\n/**\n * Discord's interaction creation to now, read from the snowflake. Called at dispatch entry, since\n * a later read would count the handler run into the queue time as well.\n *\n * @internal\n */\nexport function queuedMsFor(interactionId: string): number {\n    // telemetry never breaks a dispatch, and BigInt() throws on a malformed id\n    try {\n        return Date.now() - timestampFromSnowflake(interactionId);\n    } catch {\n        return 0;\n    }\n}\n\n/**\n * Builds the `interactionDispatched` payload both transports publish, so the two clocks are read the\n * same way on each.\n *\n * @internal\n */\nexport function dispatchedPayload(report: DispatchReport): SubscriptionData<'interactionDispatched'> {\n    return {\n        routeId: report.routeId,\n        interactionId: report.interactionId,\n        kind: report.kind,\n        outcome: report.outcome,\n        fallback: report.fallback,\n        durationMs: performance.now() - report.startedAt,\n        queuedMs: report.queuedMs\n    };\n}\n"],"mappings":"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"}

package/dist/node-internal.index.cjs

@@ -1,16 +1,22 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
-const require_publishDefault = require('./publishDefault-l0NQ-SHo.cjs');
-const require_phases = require('./phases-C_BGNyVo.cjs');
-const require_subscribers = require('./subscribers-B1G6_LlK.cjs');
-const require_Plugin = require('./Plugin-Cgp1a0uQ.cjs');
+const require_publishDefault = require('./publishDefault-CVlwYUS5.cjs');
+const require_phases = require('./phases-DcuDHoQl.cjs');
+const require_subscribers = require('./subscribers-CojcCgj1.cjs');
+const require_devChannel = require('./devChannel-CoCmAVDx.cjs');
+const require_Plugin = require('./Plugin-BlkhHNRm.cjs');
+const require_slashRouteLeaves = require('./slashRouteLeaves-nfxOAM7Q.cjs');
 const require_HmrModuleHandler = require('./HmrModuleHandler-CTBng7wV.cjs');
+let _discordjs_builders = require("@discordjs/builders");
+let _seedcord_logger = require("@seedcord/logger");
+let discord_api_types_v10 = require("discord-api-types/v10");
 let _seedcord_errors = require("@seedcord/errors");
 let _seedcord_errors_internal = require("@seedcord/errors/internal");
-let _seedcord_logger = require("@seedcord/logger");
+let _seedcord_utils = require("@seedcord/utils");
 let chalk = require("chalk");
 chalk = require_rolldown_runtime.__toESM(chalk, 1);
 let envapt = require("envapt");
+let node_path = require("node:path");
 let node_http = require("node:http");
 let _seedcord_utils_node = require("@seedcord/utils/node");
 
@@ -439,10 +445,10 @@ var HealthCheck = class HealthCheck {
 //#region src/node/Pluggable.ts
 const RESERVED_KEYS = new Set(_seedcord_logger.FRAMEWORK_CHANNELS);
 /**
-* Base class for objects that can have plugins attached.
+* Base class for a plugin host, a transport `Seedcord` class.
 *
 * Plugins are attached during configuration and initialized during startup, sequentially in attach
-* order within each phase. Not constructed directly, the host is a transport `Seedcord` class.
+* order within each phase.
 */
 var Pluggable = class Pluggable {
 	/** @see {@link CoordinatedShutdown} */
@@ -487,17 +493,11 @@ var Pluggable = class Pluggable {
 		this.isInitialized = true;
 		return this;
 	}
-	pluginCapabilities() {
-		return {};
-	}
-	pluginStore() {
-		return this.config.store ?? this.rateLimiter;
-	}
 	/** @internal codegen reads these to emit the `Core` augmentation */
 	get pluginKeys() {
 		return this.attachments.map((attachment) => attachment.key);
 	}
-	/** @internal releases the signal handlers and clears the singleton so the next host can construct */
+	/** @internal so the next host can construct */
 	static reset() {
 		Pluggable.liveShutdown?.removeSignalHandlers();
 		Pluggable.liveShutdown = void 0;
@@ -531,28 +531,14 @@ var Pluggable = class Pluggable {
 		if (RESERVED_KEYS.has(key)) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CorePluginReservedChannel, [key]);
 		if (key in this) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CorePluginKeyExists, [key]);
 		const instance = new Plugin(this, ...args);
+		instance.logger.setChannel(key);
 		this.plugins.push(instance);
 		this.attachments.push({
 			key,
 			instance
 		});
-		this.finalizeContext(key, instance);
 		return Object.assign(this, { [key]: instance });
 	}
-	finalizeContext(key, instance) {
-		const caps = this.pluginCapabilities();
-		const readToken = () => this.pluginCapabilities().token;
-		instance.logger.setChannel(key);
-		require_Plugin.finalizePluginContext(instance, {
-			config: this.config,
-			store: this.pluginStore(),
-			client: caps.client,
-			get token() {
-				return readToken();
-			},
-			rest: caps.rest
-		});
-	}
 	registerPluginTasks() {
 		if (this.pluginTasksRegistered) return;
 		this.pluginTasksRegistered = true;
@@ -705,6 +691,187 @@ var SubscriberLoader = class {
 };
 
 //#endregion
+//#region src/node/commands/CommandRegistry.ts
+function indexById(commands) {
+	return new Map(commands.map((command) => [command.id, command]));
+}
+/**
+* Scans the command directory, builds each command, and PUTs the global and guild scopes to Discord.
+*
+* @internal
+*/
+var CommandRegistry = class {
+	options;
+	logger = new _seedcord_logger.Logger("Commands", { channel: "commands" });
+	isInitialised = false;
+	globalCommands = [];
+	guildCommands = /* @__PURE__ */ new Map();
+	ctorToCommand = /* @__PURE__ */ new Map();
+	loading = false;
+	loadedCommands = [];
+	hmrHandler;
+	pendingEvents = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.options = options;
+		if (!options.dir) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CoreControllerPathMissing, ["CommandRegistry", "commands"]);
+		if (!envapt.Envapter.isDevelopment && !envapt.Envapter.isTest) return;
+		this.hmrHandler = new require_HmrModuleHandler.HmrModuleHandler({
+			handlersDir: options.dir,
+			isHandler: this.isCommandClass.bind(this),
+			registerHandler: this.registerCommand.bind(this),
+			unregisterHandler: this.unregisterCommand.bind(this),
+			getArtifacts: this.getArtifacts.bind(this),
+			logger: this.logger
+		});
+	}
+	getArtifacts(ctor) {
+		return this.ctorToCommand.get(ctor);
+	}
+	/** @internal */
+	async init() {
+		if (this.isInitialised) return;
+		this.isInitialised = true;
+		this.loading = true;
+		this.loadedCommands.length = 0;
+		try {
+			await this.loadCommands(this.options.dir);
+		} finally {
+			this.loading = false;
+		}
+		this.reportLoad();
+		require_devChannel.getDevChannel()?.on("seedcord:refresh-commands", (data) => {
+			this.refresh(data.shouldRefresh);
+		});
+	}
+	reportLoad() {
+		const { utils } = this.logger;
+		utils.summary("Loaded commands", {
+			global: this.globalCommands.length,
+			"guild groups": this.guildCommands.size
+		});
+		let slash = 0;
+		let menu = 0;
+		for (const command of this.loadedCommands) if (command.kind === "slash command") slash++;
+		else menu++;
+		utils.block("Loaded commands", [...utils.entries(this.loadedCommands), ...utils.counts({
+			"slash commands": slash,
+			"context menus": menu
+		})]);
+	}
+	/** @internal */
+	async refresh(shouldRefresh = true) {
+		if (!shouldRefresh) {
+			this.logger.info(chalk.default.italic("Command refresh cancelled."));
+			this.pendingEvents.clear();
+			return;
+		}
+		this.logger.info(chalk.default.italic("Refreshing commands..."));
+		for (const event of this.pendingEvents.values()) await this.hmrHandler?.handle(event);
+		this.pendingEvents.clear();
+		await this.setCommands();
+	}
+	/** @internal */
+	async onHmr(event) {
+		if (event.file.startsWith((0, node_path.resolve)(process.cwd(), this.options.dir))) {
+			this.pendingEvents.delete(event.file);
+			this.pendingEvents.set(event.file, event);
+			require_devChannel.getDevChannel()?.send("seedcord:commands-update-prompt", { files: [...this.pendingEvents.keys()].map((f) => (0, _seedcord_utils.formatFilePath)(f)) });
+		} else await this.hmrHandler?.handle(event);
+	}
+	async loadCommands(dir) {
+		await (0, _seedcord_utils_node.traverseDirectory)(dir, (fullPath, rel, mod) => {
+			for (const exported of Object.values(mod)) if (this.isCommandClass(exported)) {
+				this.registerCommand(exported, rel);
+				this.hmrHandler?.trackHandler(fullPath, exported);
+			}
+		});
+	}
+	isCommandClass(obj) {
+		if (typeof obj !== "function") return false;
+		return obj.prototype instanceof require_publishDefault.BuilderComponent && Reflect.hasMetadata(require_publishDefault.CommandMetadataKey, obj);
+	}
+	registerCommand(ctor, rel) {
+		const meta = Reflect.getMetadata(require_publishDefault.CommandMetadataKey, ctor);
+		if (!meta) return;
+		const comp = new ctor().component;
+		const kind = comp instanceof _discordjs_builders.SlashCommandBuilder ? "slash command" : "context menu";
+		if (meta.scope === "global") this.globalCommands.push(comp);
+		else for (const g of meta.guilds) {
+			const arr = this.guildCommands.get(g) ?? [];
+			arr.push(comp);
+			this.guildCommands.set(g, arr);
+		}
+		this.ctorToCommand.set(ctor, {
+			name: comp.name,
+			scope: meta.scope,
+			...meta.scope === "guild" && { guilds: meta.guilds }
+		});
+		if (this.loading) {
+			this.loadedCommands.push({
+				name: comp.name,
+				from: (0, _seedcord_utils.formatFilePath)(rel),
+				kind
+			});
+			return;
+		}
+		this.logger.utils.registration(comp.name, rel, `${meta.scope} ${kind}`);
+	}
+	unregisterCommand(ctor, artifacts) {
+		const info = artifacts ?? this.ctorToCommand.get(ctor);
+		if (!info) return;
+		if (info.scope === "global") {
+			const idx = this.globalCommands.findIndex((c) => c.name === info.name);
+			if (idx !== -1) this.globalCommands.splice(idx, 1);
+		} else for (const g of info.guilds ?? []) {
+			const arr = this.guildCommands.get(g);
+			if (arr) {
+				const idx = arr.findIndex((c) => c.name === info.name);
+				if (idx !== -1) arr.splice(idx, 1);
+			}
+		}
+		this.ctorToCommand.delete(ctor);
+	}
+	/** @internal */
+	async setCommands() {
+		const result = {
+			global: /* @__PURE__ */ new Map(),
+			guilds: /* @__PURE__ */ new Map()
+		};
+		const appId = this.options.applicationId();
+		if (this.globalCommands.length > 0) {
+			result.global = indexById(await this.put(discord_api_types_v10.Routes.applicationCommands(appId), this.globalCommands));
+			const tag = this.globalCommands.length === 1 ? "command" : "commands";
+			this.logger.utils.block(`Deployed ${this.globalCommands.length} global ${tag}`, this.logger.utils.wrap(this.globalCommands.map((command) => command.name)), "info");
+		}
+		for (const [guildId, commands] of this.guildCommands.entries()) {
+			const deployed = await this.put(discord_api_types_v10.Routes.applicationGuildCommands(appId, guildId), commands);
+			result.guilds.set(guildId, indexById(deployed));
+			const tag = commands.length === 1 ? "command" : "commands";
+			this.logger.utils.block(`Deployed ${commands.length} ${tag} to ${_seedcord_logger.paint.amber.bold(guildId)}`, this.logger.utils.wrap(commands.map((command) => command.name)), "info");
+		}
+		this.options.onDeployed?.(result);
+		return result;
+	}
+	async put(route, commands) {
+		const body = commands.map((command) => command.toJSON());
+		return await this.options.rest.put(route, { body });
+	}
+	/** Every registered builder, global first. A guild command in N guilds appears once per guild. @internal */
+	allCommands() {
+		return [...this.globalCommands, ...this.guildCommands.values()].flat();
+	}
+	/** @internal */
+	routeLeaves() {
+		return require_slashRouteLeaves.slashRouteLeaves(this.allCommands());
+	}
+	/** @internal */
+	contextMenuLeaves() {
+		return require_publishDefault.contextMenuLeaves(this.allCommands());
+	}
+};
+
+//#endregion
+exports.CommandRegistry = CommandRegistry;
 exports.CoordinatedShutdown = CoordinatedShutdown;
 exports.CoordinatedStartup = CoordinatedStartup;
 exports.HealthCheck = HealthCheck;