@seedcord/core 0.12.0-next.0 → 0.12.0-next.3

package/dist/HmrModuleHandler-BMD7dg8N.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"HmrModuleHandler-BMD7dg8N.mjs","names":[],"sources":["../src/hmr/HmrModuleHandler.ts"],"sourcesContent":["import { pathToFileURL } from 'node:url';\n\nimport { paint } from '@seedcord/errors';\nimport { formatFilePath } from '@seedcord/utils';\nimport { botFolder, vitePluginThrew } from '@seedcord/utils/internal';\n\nimport type { Logger } from '@seedcord/logger';\nimport type { HmrUpdateEvent } from '@seedcord/types';\n\ninterface HmrStore<THandler, TMiddleware, TArtifacts> {\n    fileToHandlers: Map<string, Set<THandler>>;\n    fileToMiddlewares: Map<string, Set<TMiddleware>>;\n    handlerArtifacts: Map<THandler, TArtifacts>;\n}\n\n// justified: units are caller-supplied classes, name is read for log labels only\nconst displayName = (unit: unknown, fallback: string): string => (unit as { name?: string }).name ?? fallback;\n\ninterface HmrModuleHandlerOptions<THandler, TMiddleware = void, TArtifacts = unknown> {\n    handlersDir: string;\n    middlewaresDir?: string;\n    isHandler: (val: unknown) => val is THandler;\n    isMiddleware?: (val: unknown) => val is TMiddleware;\n    registerHandler: (handler: THandler, file: string) => void;\n    registerMiddleware?: (middleware: TMiddleware, file: string) => void;\n    unregisterHandler: (handler: THandler, artifacts?: TArtifacts) => void;\n    unregisterMiddleware?: (middleware: TMiddleware) => void;\n    /** Snapshotted per handler so a rollback re-registers with the same artifacts after the module re-imports. */\n    getArtifacts?: (handler: THandler) => TArtifacts;\n    logger: Logger;\n}\n\n/**\n * Reloads THandler and optional TMiddleware modules on HMR updates.\n *\n * Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.\n *\n * This is only useful during development.\n */\nexport class HmrModuleHandler<THandler, TMiddleware = void, TArtifacts = unknown> {\n    private readonly store: HmrStore<THandler, TMiddleware, TArtifacts>;\n    private readonly options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>;\n\n    constructor(options: HmrModuleHandlerOptions<THandler, TMiddleware, TArtifacts>) {\n        this.options = { ...options, logger: options.logger.withChannel('hmr') };\n\n        // no import.meta.hot.data stash needed because a leaf reload never reconstructs the singleton\n        // holding these Maps\n        this.store = {\n            fileToHandlers: new Map(),\n            fileToMiddlewares: new Map(),\n            handlerArtifacts: new Map()\n        };\n    }\n\n    /** Unloads or reloads the modules affected by an {@link HmrUpdateEvent}, scoped to the handler and middleware directories. */\n    public async handle(event: HmrUpdateEvent): Promise<void> {\n        const { file, affectedModules, type } = event;\n\n        if (type === 'delete' || type === 'deleteDir') {\n            this.report('Unloaded', this.unload(file), [file]);\n            return;\n        }\n\n        // a directory is never importable. its files arrive as their own create events\n        if (type === 'createDir') return;\n\n        const rollbackEnabled = event.rollback ?? true;\n        const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];\n\n        const startedAt = Date.now();\n        const names: string[] = [];\n        const touched: string[] = [];\n\n        for (const fileToReload of filesToReload) {\n            if (!this.inScope(fileToReload)) continue;\n\n            const reloaded = await this.reloadWithRollback(fileToReload, rollbackEnabled);\n            if (reloaded.length === 0) continue;\n\n            names.push(...reloaded);\n            touched.push(fileToReload);\n        }\n\n        this.report(type === 'create' ? 'Registered' : 'Reloaded', names, touched, Date.now() - startedAt);\n    }\n\n    private inScope(file: string): boolean {\n        const { handlersDir, middlewaresDir } = this.options;\n\n        if (botFolder(handlersDir).holdsModule(file)) return true;\n        return middlewaresDir ? botFolder(middlewaresDir).holdsModule(file) : false;\n    }\n\n    // one line per save, since one edit can reload every module that imports the file\n    private report(verb: string, names: string[], files: string[], elapsedMs?: number): void {\n        if (names.length === 0) return;\n\n        const from = files.length === 1 ? formatFilePath(files[0] ?? '') : `${String(files.length)} files`;\n        const timing = elapsedMs === undefined ? '' : ` ${paint.mute('in')} ${String(elapsedMs)}ms`;\n        this.options.logger.debug(`${verb} ${paint.sky.bold(names.join(', '))} from ${paint.mute(from)}${timing}`);\n    }\n\n    private async reloadWithRollback(file: string, rollbackEnabled: boolean): Promise<string[]> {\n        const { logger } = this.options;\n        const snapshot = this.snapshotUnits(file);\n        this.unload(file);\n\n        const reloaded = await this.reloadFile(file);\n        if (reloaded !== null) return reloaded;\n\n        // a failed reload can leave a partial registration\n        this.unload(file);\n        if (!rollbackEnabled) return [];\n        if (snapshot.handlers.length === 0 && snapshot.middlewares.length === 0) return [];\n\n        // a typo keeps the last-good units live until the next good save\n        this.restoreUnits(file, snapshot);\n        logger.warn(`${paint.amber.bold('Rolled back')} ${paint.mute(formatFilePath(file))} to the last-good version`);\n        return [];\n    }\n\n    /** Links the handler to its source file so a later update can unload it. */\n    public trackHandler(file: string, handler: THandler): void {\n        let set = this.store.fileToHandlers.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToHandlers.set(file, set);\n        }\n        set.add(handler);\n\n        if (!this.options.getArtifacts) return;\n        this.store.handlerArtifacts.set(handler, this.options.getArtifacts(handler));\n    }\n\n    /** Links the middleware to its source file so a later update can unload it. */\n    public trackMiddleware(file: string, middleware: TMiddleware): void {\n        let set = this.store.fileToMiddlewares.get(file);\n        if (!set) {\n            set = new Set();\n            this.store.fileToMiddlewares.set(file, set);\n        }\n        set.add(middleware);\n    }\n\n    private unload(file: string): string[] {\n        const names: string[] = [];\n        const handlers = this.store.fileToHandlers.get(file);\n        if (handlers) {\n            for (const handler of handlers) {\n                const artifacts = this.store.handlerArtifacts.get(handler);\n                this.options.unregisterHandler(handler, artifacts);\n                this.store.handlerArtifacts.delete(handler);\n                names.push(displayName(handler, 'Handler'));\n            }\n            this.store.fileToHandlers.delete(file);\n        }\n\n        const middlewares = this.store.fileToMiddlewares.get(file);\n        if (middlewares) {\n            for (const middleware of middlewares) {\n                this.options.unregisterMiddleware?.(middleware);\n                names.push(displayName(middleware, 'Middleware'));\n            }\n            this.store.fileToMiddlewares.delete(file);\n        }\n\n        return names;\n    }\n\n    private async reloadFile(file: string): Promise<string[] | null> {\n        const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;\n\n        try {\n            let fileUrl = pathToFileURL(file).href;\n            // vitest has no real vite server managing the module graph\n            if (process.env.VITEST === 'true') fileUrl += `?update=${Date.now()}`;\n\n            // justified: a dynamic import resolves to an untyped export map\n            const imported = (await import(/* @vite-ignore */ fileUrl)) as Record<string, unknown>;\n\n            const names: string[] = [];\n            for (const val of Object.values(imported)) {\n                if (isHandler(val)) {\n                    registerHandler(val, file);\n                    this.trackHandler(file, val);\n                    names.push(displayName(val, 'Handler'));\n                } else if (isMiddleware && registerMiddleware && isMiddleware(val)) {\n                    registerMiddleware(val, file);\n                    this.trackMiddleware(file, val);\n                    names.push(displayName(val, 'Middleware'));\n                }\n            }\n\n            return names;\n        } catch (error) {\n            logger.error(`Failed to reload file: ${formatFilePath(file)}`, vitePluginThrew(error) ?? error);\n            return null;\n        }\n    }\n\n    // these are the same class objects, which is how a live db connection survives a rollback\n    private snapshotUnits(file: string): { handlers: THandler[]; middlewares: TMiddleware[] } {\n        return {\n            handlers: [...(this.store.fileToHandlers.get(file) ?? [])],\n            middlewares: [...(this.store.fileToMiddlewares.get(file) ?? [])]\n        };\n    }\n\n    private restoreUnits(file: string, snapshot: { handlers: THandler[]; middlewares: TMiddleware[] }): void {\n        for (const handler of snapshot.handlers) {\n            this.options.registerHandler(handler, file);\n            this.trackHandler(file, handler);\n        }\n\n        if (this.options.registerMiddleware) {\n            for (const middleware of snapshot.middlewares) {\n                this.options.registerMiddleware(middleware, file);\n                this.trackMiddleware(file, middleware);\n            }\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/PluginHost-CYe-UVpp.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginHost-CYe-UVpp.mjs","names":[],"sources":["../src/hmr/devChannel.ts","../src/plugin/lifecycle.ts","../src/plugin/Plugin.ts","../src/kv/GuardedDriver.ts","../src/kv/KeyedQueue.ts","../src/kv/KvCollection.ts","../src/kv/Kv.ts","../src/rateLimiter/KvRateLimiter.ts","../src/plugin/splitPluginKey.ts","../src/plugin/PluginHost.ts"],"sourcesContent":["import type { DevChannel, SeedcordCliEvents, SeedcordFrameworkEvents } from '@seedcord/types/internal';\n\nexport type CliChannel = DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents>;\n\n// one module instance per process, the HmrManager write and every framework read share it\nlet channel: CliChannel | undefined;\n\n/** @internal */\nexport function setDevChannel(next: CliChannel | undefined): void {\n    channel = next;\n}\n\n/** @internal */\nexport function getDevChannel(): CliChannel | undefined {\n    return channel;\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordRangeError } from '@seedcord/errors/internal';\n\nimport { ShutdownPhase, StartupPhase } from '#src/lifecycle/phases';\n\nimport type { TaskShutdownPhase } from '#src/lifecycle/phases';\n\n/**\n * Sets when a plugin's lifecycle methods run. Pass it as the second argument to `super()`. Omit a\n * field to keep its default.\n *\n * @see {@link StartupPhase}\n * @see {@link ShutdownPhase}\n * @example\n * ```ts\n * super(host, { init: { phase: StartupPhase.Login }, dispose: { timeout: 30_000 } });\n * ```\n */\nexport interface PluginLifecycleSpec {\n    /**\n     * Defaults to `StartupPhase.Configuration` and 15000ms. Set the phase to `Ready` and `init()`\n     * runs ahead of every plugin's `ready()`.\n     */\n    init?: { phase?: StartupPhase; timeout?: number };\n    /** `ready()` always runs in `StartupPhase.Ready`. Defaults to a 15000ms timeout. */\n    ready?: { timeout?: number };\n    /** Defaults to `ShutdownPhase.Disconnect` and 10000ms. */\n    dispose?: { phase?: TaskShutdownPhase; timeout?: number };\n}\n\n/** @internal */\nexport interface ResolvedPluginLifecycleSpec {\n    readonly init: { readonly phase: StartupPhase; readonly timeout: number };\n    readonly ready: { readonly timeout: number };\n    readonly dispose: { readonly phase: TaskShutdownPhase; readonly timeout: number };\n}\n\nconst DEFAULT_INIT_TIMEOUT_MS = 15_000;\nconst DEFAULT_READY_TIMEOUT_MS = 15_000;\nconst DEFAULT_DISPOSE_TIMEOUT_MS = 10_000;\n\nfunction timeoutOf(\n    field: 'init' | 'ready' | 'dispose',\n    declared: number | undefined,\n    fallback: number,\n    pluginName: string\n): number {\n    if (declared === undefined) return fallback;\n    if (!Number.isFinite(declared) || declared <= 0) {\n        throw new SeedcordRangeError(SeedcordErrorCode.LifecycleInvalidTimeout, [\n            `${pluginName}'s lifecycle ${field}.timeout`,\n            declared\n        ]);\n    }\n    return declared;\n}\n\n/** @internal */\nexport function resolveLifecycleSpec(\n    spec: PluginLifecycleSpec | undefined,\n    pluginName: string\n): ResolvedPluginLifecycleSpec {\n    return {\n        init: {\n            phase: spec?.init?.phase ?? StartupPhase.Configuration,\n            timeout: timeoutOf('init', spec?.init?.timeout, DEFAULT_INIT_TIMEOUT_MS, pluginName)\n        },\n        ready: {\n            timeout: timeoutOf('ready', spec?.ready?.timeout, DEFAULT_READY_TIMEOUT_MS, pluginName)\n        },\n        dispose: {\n            phase: spec?.dispose?.phase ?? ShutdownPhase.Disconnect,\n            timeout: timeoutOf('dispose', spec?.dispose?.timeout, DEFAULT_DISPOSE_TIMEOUT_MS, pluginName)\n        }\n    };\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordTypeError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\n\nimport { getDevChannel } from '#hmr/devChannel';\n\nimport { RuntimeBrand, TransportBrand } from './brands';\nimport { resolveLifecycleSpec } from './lifecycle';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { Kv } from '#src/kv/Kv';\nimport type { ScopedSpec } from './brands';\nimport type { ResolvedPluginLifecycleSpec, PluginLifecycleSpec } from './lifecycle';\nimport type {\n    DeclaredScope,\n    TransportOf,\n    PluginOptions,\n    PluginSpecArgs,\n    RuntimeOf,\n    ScopeAxis,\n    Runtime,\n    RuntimeAssert,\n    Transport,\n    TransportAssert\n} from './options';\nimport type { Tail, FrameworkChannel, HmrAware, HmrUpdateEvent } from '@seedcord/types';\n\ninterface Attaching {\n    readonly key: string;\n    readonly kv: Kv;\n}\n\n// set only while attach() runs `new Plugin()`\nlet attaching: Attaching | undefined;\n\nexport interface Initializeable {\n    init(): Promise<void>;\n}\n\n/** @internal */\nconst resolvedSpecSlot = Symbol('seedcord:plugin:spec');\n/** @internal */\nconst loggerSlot = Symbol('seedcord:plugin:logger');\n/** @internal */\nconst scopeSlot = Symbol('seedcord:plugin:scope');\n/** @internal */\nexport const FixedScope = Symbol('seedcord:plugin:fixed-scope');\n\n/**\n * Base class for a seedcord plugin. Extend it and implement `init()`. `this.core` is the running\n * bot.\n *\n * Your constructor takes the host first and passes it to `super()`. Add your own parameters after\n * it. `attach()` types them at the call site.\n *\n * A plugin that narrows `transport` or `runtime` in `Opts` passes the same values to `super()`.\n * `attach()` throws when either one differs from the bot's.\n *\n * @typeParam Opts - Where this plugin may attach.\n * @typeParam TCore - The `Core` each transport binds `this.core` to.\n * @typeParam Fixed - The `transport` and `runtime` values a transport's own `Plugin` base sets. Leave it out.\n *\n * @example\n * ```ts\n * class Analytics extends Plugin<{ transport: 'gateway' }> {\n *     constructor(\n *         host: CoreBase,\n *         private readonly apiKey: string\n *     ) {\n *         super(host, { transport: 'gateway', init: { phase: StartupPhase.Login } });\n *     }\n *\n *     public async init(): Promise<void> {\n *         await this.connect(this.apiKey);\n *     }\n * }\n *\n * seedcord.attach('analytics', Analytics, apiKey);\n * ```\n */\nexport abstract class Plugin<\n    Opts extends PluginOptions = {},\n    TCore extends CoreBase = CoreBase,\n    Fixed extends ScopeAxis = never\n>\n    implements Initializeable, HmrAware\n{\n    /** @internal */\n    protected static readonly [FixedScope]: Partial<DeclaredScope> = {};\n\n    // phantom, never set at runtime.\n    /** @internal */\n    declare readonly [TransportBrand]?: TransportOf<Opts>;\n    /** @internal */\n    declare readonly [RuntimeBrand]?: RuntimeOf<Opts>;\n\n    /** @internal */\n    readonly [resolvedSpecSlot]: ResolvedPluginLifecycleSpec;\n    /** @internal */\n    readonly [loggerSlot]: Logger;\n    /** @internal */\n    readonly [scopeSlot]: DeclaredScope;\n\n    /** Logs under the plugin's class name, on the channel its attach key sets. */\n    protected readonly logger: Logger;\n\n    readonly #kv: Kv | undefined;\n\n    // CoreBase here keeps the augmented Core out of ConstructorParameters, which attach reads\n    constructor(\n        private readonly host: CoreBase,\n        ...[spec]: PluginSpecArgs<Opts, Fixed>\n    ) {\n        // cleared here. a plugin this constructor builds by hand doesn't get the outer key\n        const attachment = attaching;\n        attaching = undefined;\n        this.#kv = attachment?.kv;\n\n        this.logger = new Logger(this.constructor.name, attachment && { channel: attachment.key });\n        this[loggerSlot] = this.logger;\n        this[resolvedSpecSlot] = resolveLifecycleSpec(spec, this.constructor.name);\n\n        const passed: (PluginLifecycleSpec & Partial<DeclaredScope>) | undefined = spec;\n        const fixed = new.target[FixedScope];\n        this[scopeSlot] = {\n            transport: fixed.transport ?? passed?.transport ?? 'any',\n            runtime: fixed.runtime ?? passed?.runtime ?? 'any'\n        };\n    }\n\n    /** The host, typed to the transport whose `Plugin` base this class extends. */\n    protected get core(): TCore {\n        // justified: each transport binds TCore to the Core its own host satisfies\n        return this.host as TCore;\n    }\n\n    /**\n     * This plugin's records in the bot's `config.kv`, stored under its attach key. Two attachments of\n     * one plugin class each get their own records. Renaming the attach key leaves the records under\n     * the old key behind.\n     *\n     * @throws A **SeedcordTypeError** when something built the plugin with `new` outside `attach()`.\n     * @example\n     * ```ts\n     * // works in a field initializer, the constructor, and every method\n     * private readonly jobs = this.kv.collection<Job>('job');\n     * ```\n     */\n    protected get kv(): Kv {\n        if (!this.#kv)\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKvOutsideAttach, [this.constructor.name]);\n        return this.#kv;\n    }\n\n    /**\n     * Runs in `StartupPhase.Configuration` by default.\n     * Move it to a different phase with the {@link PluginLifecycleSpec}.\n     */\n    abstract init(): Promise<void>;\n\n    /**\n     * Runs in the Ready phase, after every attached plugin's `init()` has resolved. The other Ready\n     * tasks run alongside it, including the http server binding its port.\n     *\n     * Override it when your work needs a logged-in client or a resolved application id.\n     */\n    ready?(): Promise<void>;\n\n    /**\n     * Runs during teardown, in `ShutdownPhase.Disconnect` by default. seedcord skips it when `init()`\n     * has thrown.\n     *\n     * When `init()` outlasts its timeout, seedcord calls this once that `init()` resolves, outside any\n     * shutdown phase. The process must still be alive for that call to happen.\n     */\n    dispose?(): Promise<void>;\n\n    /**\n     * Returns data that `seedcord codegen` writes into the bot's `seedcord-gen.ts` as a type.\n     * Read it back with `Generated<typeof YourPlugin>`. Return plain data, or classes and objects\n     * that a project file or your plugin's package exports. The class needs a `static readonly id`.\n     *\n     * `seedcord codegen` calls this without running `init()`. Read only what the constructor stored\n     * and the bot's files.\n     */\n    codegen?(): Promise<unknown>;\n\n    /**\n     * Rejects the options this plugin got.\n     *\n     * @param reason - Why the options are invalid.\n     * @throws A **SeedcordTypeError** every time, with the plugin class name and `reason` in its message.\n     */\n    protected rejectOptions(reason: string): never {\n        throw new SeedcordTypeError(SeedcordErrorCode.PluginOptionsRejected, [this.constructor.name, reason]);\n    }\n\n    /** Override to reload plugin state on an HMR update. */\n    public onHmr(_event: HmrUpdateEvent): Promise<void> {\n        return Promise.resolve();\n    }\n\n    /**\n     * Registers critical file patterns that should trigger a full restart when changed in Dev HMR.\n     * @param patterns - Glob patterns. A relative one resolves against `root` from `seedcord.config.ts`.\n     */\n    protected registerCriticalFiles(patterns: string[]): void {\n        getDevChannel()?.send('seedcord:register-critical-files', { patterns });\n    }\n}\n\n/** @internal */\nexport function resolvedLifecycleSpecOf(plugin: PluginLike): ResolvedPluginLifecycleSpec {\n    return plugin[resolvedSpecSlot];\n}\n\n/** @internal */\nexport function extendsThisCorePlugin(ctor: PluginCtor): boolean {\n    return ctor.prototype instanceof Plugin;\n}\n\n/** @internal */\nexport function pluginLoggerOf(plugin: PluginLike): Logger {\n    return plugin[loggerSlot];\n}\n\n/** @internal */\nexport function declaredScopeOf(plugin: PluginLike): DeclaredScope {\n    return plugin[scopeSlot];\n}\n\n/** @internal */\nexport function constructAttached<TPlugin>(key: string, kv: Kv, construct: () => TPlugin): TPlugin {\n    attaching = { key, kv };\n    try {\n        return construct();\n    } finally {\n        attaching = undefined;\n    }\n}\n\nexport type { PluginLifecycleSpec } from './lifecycle';\nexport type { PluginOptions } from './options';\n\n// a bound of Plugin<{}> rejects every plugin that declares an option, since Plugin<A> and Plugin<B>\n// are mutually unassignable. every member here must stay Opts-independent.\n/** @internal */\nexport type PluginLike = Pick<\n    Plugin,\n    'init' | 'ready' | 'dispose' | 'onHmr' | typeof resolvedSpecSlot | typeof loggerSlot | typeof scopeSlot\n>;\n\n// a `CoreBase` first parameter rejects a narrowing ctor on its own, and it also collapses\n// `InstanceType<Ctor>` to `PluginLike` at every attach call. CoreParamAssert checks it instead.\n/** @internal */\nexport type PluginCtor<TPlugin extends PluginLike = PluginLike> = new (...args: any[]) => TPlugin;\n\n/** @internal */\nexport type PluginArgs<Ctor extends PluginCtor> =\n    InheritsScopedConstructor<Ctor> extends true ? [] : Tail<ConstructorParameters<Ctor>>;\n\n// a narrowed plugin with no constructor of its own inherits the base one, whose spec carries ScopedSpec\ntype InheritsScopedConstructor<Ctor extends PluginCtor> =\n    Tail<ConstructorParameters<Ctor>> extends [infer Spec, ...unknown[]]\n        ? typeof ScopedSpec extends keyof Spec\n            ? true\n            : false\n        : false;\n\n/** @internal */\nexport type Attached<Key extends string, Instance> = Key extends `${infer Group}.${infer Leaf}`\n    ? Record<Group, Record<Leaf, Instance>>\n    : Record<Key, Instance>;\n\n// attach writes the key onto the host, so a key like toString would shadow the one on Object.prototype\n// eslint-disable-next-line @typescript-eslint/no-wrapper-object-types -- lint:fix swaps this for `keyof object`, which is never\ntype HostMember<Host> = keyof Host | keyof Object;\n\n// a string argument against an object type renders only as `string is not assignable`\n/** @internal */\nexport type AttachKeyAssert<Key extends string, Host> = Key extends ''\n    ? 'A plugin key needs a name.'\n    : Key extends `${infer Group}.${infer Leaf}`\n      ? Leaf extends `${string}.${string}`\n          ? `'${Key}' has more than one dot. A plugin key takes one dot at most.`\n          : '' extends Group | Leaf\n            ? `'${Key}' has an empty part. Write a group and a plugin name around the dot, like 'services.users'.`\n            : Group extends FrameworkChannel\n              ? `'${Group}' is a channel the framework logs on. Pick another group name.`\n              : Group extends keyof Host\n                ? Host[Group] extends PluginLike\n                    ? `'${Group}' already holds a plugin, so '${Leaf}' cannot nest inside it.`\n                    : Host[Group] extends Record<string, PluginLike>\n                      ? Leaf extends keyof Host[Group]\n                          ? `'${Key}' is already attached.`\n                          : Key\n                      : `'${Group}' is already a member on the bot. Pick another group name.`\n                : Group extends HostMember<Host>\n                  ? `'${Group}' is already a member on the bot. Pick another group name.`\n                  : Key\n      : Key extends FrameworkChannel\n        ? `'${Key}' is a channel the framework logs on. Pick another plugin key.`\n        : Key extends keyof Host\n          ? Host[Key] extends PluginLike\n              ? `'${Key}' is already attached.`\n              : Host[Key] extends Record<string, PluginLike>\n                ? `'${Key}' already holds a group of plugins. Attach this one under a name of its own.`\n                : `'${Key}' is already a member on the bot. Pick another plugin key.`\n          : Key extends HostMember<Host>\n            ? `'${Key}' is already a member on the bot. Pick another plugin key.`\n            : Key;\n\ntype CoreParamTooNarrow = Record<\n    'this plugin constructor must take CoreBase as its first parameter and read the transport Core off this.core',\n    never\n>;\n\n// a narrowed first parameter fails `CoreBase extends Param`\ntype CoreParamAssert<Ctor extends PluginCtor> = CoreBase extends ConstructorParameters<Ctor>[0]\n    ? unknown\n    : CoreParamTooNarrow;\n\ntype ConstructorMissing = Record<\n    \"this plugin narrows its transport or runtime. Give it a constructor that passes them to super(), like super(host, { runtime: 'server' })\",\n    never\n>;\n\ntype OwnConstructorAssert<Ctor extends PluginCtor> =\n    InheritsScopedConstructor<Ctor> extends true ? ConstructorMissing : unknown;\n\ntype AttachAsserts<Ctor extends PluginCtor, BotT extends Transport, BotRt extends Runtime> = TransportAssert<\n    InstanceType<Ctor>,\n    BotT\n> &\n    RuntimeAssert<InstanceType<Ctor>, BotRt> &\n    CoreParamAssert<Ctor> &\n    OwnConstructorAssert<Ctor>;\n\n// typescript can't infer Ctor from a generic class through `Ctor & AttachAsserts`. every assert returns unknown to pass.\n/** @internal */\nexport type AttachableCtor<Ctor extends PluginCtor, BotT extends Transport, BotRt extends Runtime> =\n    unknown extends AttachAsserts<Ctor, BotT, BotRt> ? Ctor : AttachAsserts<Ctor, BotT, BotRt>;\n","import { SeedcordErrorCode, isSeedcordError } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport type { SeedcordErrorArguments } from '@seedcord/errors/internal';\nimport type { KvDriver, KvEntry } from '@seedcord/types';\nimport type { Promisable } from 'type-fest';\n\ntype Operation = SeedcordErrorArguments<SeedcordErrorCode.CoreKvDriverFailed>[0];\n\nfunction translated(operation: Operation, key: string, error: unknown): unknown {\n    if (isSeedcordError(error)) return error;\n    return new SeedcordError(SeedcordErrorCode.CoreKvDriverFailed, [operation, key], { cause: error });\n}\n\nasync function guard<TResult>(operation: Operation, key: string, run: () => Promisable<TResult>): Promise<TResult> {\n    try {\n        return await run();\n    } catch (error) {\n        throw translated(operation, key, error);\n    }\n}\n\nexport class GuardedDriver implements KvDriver {\n    constructor(private readonly driver: KvDriver) {}\n\n    public async get(key: string): Promise<string | undefined> {\n        return guard('read', key, () => this.driver.get(key));\n    }\n\n    public async set(key: string, value: string, ttlMs?: number): Promise<void> {\n        await guard('write', key, () => this.driver.set(key, value, ttlMs));\n    }\n\n    public async delete(key: string): Promise<void> {\n        await guard('delete', key, () => this.driver.delete(key));\n    }\n\n    public async *entries(prefix: string): AsyncIterable<KvEntry> {\n        try {\n            for await (const entry of this.driver.entries(prefix)) yield entry;\n        } catch (error) {\n            throw translated('list', prefix, error);\n        }\n    }\n}\n","export class KeyedQueue {\n    private readonly tails = new Map<string, Promise<void>>();\n\n    public run<TResult>(key: string, task: () => Promise<TResult>): Promise<TResult> {\n        const run = (this.tails.get(key) ?? Promise.resolve()).then(task);\n        const tail = run.then(\n            () => undefined,\n            () => undefined\n        );\n        this.tails.set(key, tail);\n        void tail.then(() => {\n            if (this.tails.get(key) === tail) this.tails.delete(key);\n        });\n        return run;\n    }\n}\n","import type { KeyedQueue } from './KeyedQueue';\nimport type { KvDriver } from '@seedcord/types';\nimport type { Jsonify, Simplify } from 'type-fest';\n\n// a hover shows the record's fields in place of JsonifyObject<...>. SimplifyDeep hits TS2589 in get()\ntype Stored<TRecord> = Simplify<Jsonify<TRecord>>;\n\n// expiresAt covers backends that ignore a ttl, like unstorage's fs driver\ninterface Envelope<TValue> {\n    value: TValue;\n    expiresAt?: number;\n}\n\n/**\n * The records of one type, stored under one name in `config.kv`. Get one from\n * `kv.collection<T>('name')`.\n *\n * Every record goes through JSON on its way in and out. A `Date` you store reads back from `get()`\n * as an ISO string.\n *\n * @example\n * ```ts\n * interface Profile { bio: string; joinedAt: Date }\n * const profiles = this.core.kv.collection<Profile>('profile');\n *\n * await profiles.set(user.id, { bio: 'hi', joinedAt: new Date() });\n * const profile = await profiles.get(user.id); // { bio: string; joinedAt: string } | undefined\n * await profiles.delete(user.id);\n * ```\n */\nexport class KvCollection<TRecord> {\n    readonly #driver: KvDriver;\n    readonly #prefix: string;\n    readonly #updates: KeyedQueue;\n\n    constructor(driver: KvDriver, prefix: string, updates: KeyedQueue) {\n        this.#driver = driver;\n        this.#prefix = prefix;\n        this.#updates = updates;\n    }\n\n    /** Reads the record stored under `id`. Resolves to `undefined` when nothing is there or the record expired. */\n    public async get(id: string): Promise<Stored<TRecord> | undefined> {\n        const key = this.#prefix + id;\n        const raw = await this.#driver.get(key);\n        const value = this.#liveValue(raw);\n        if (raw !== undefined && value === undefined) await this.#deleteExpired(key);\n        return value;\n    }\n\n    /**\n     * Stores `value` under `id` and replaces whatever was there.\n     *\n     * @param ttlMs - How long the record lasts, in milliseconds. Leave it out to keep the record until you delete it.\n     */\n    public async set(id: string, value: TRecord, ttlMs?: number): Promise<void> {\n        const key = this.#prefix + id;\n        await this.#updates.run(key, async () => this.#write(key, value, ttlMs));\n    }\n\n    /** Removes the record under `id`. */\n    public async delete(id: string): Promise<void> {\n        const key = this.#prefix + id;\n        await this.#updates.run(key, async () => this.#driver.delete(key));\n    }\n\n    /**\n     * Stores what `next` returns for the record under `id`, then resolves to that value. `next` gets\n     * the current record, or `undefined` when there is none.\n     *\n     * Use it over a `get()` then a `set()` when two calls can change one record at the same time.\n     * `set()`, `delete()`, and `update()` calls on one id run one after the other in this process.\n     * None of them loses another's change. Two processes sharing one backend can still both read\n     * before either writes.\n     *\n     * @param ttlMs - How many milliseconds the stored record lasts. Pass a function to work it out from the record. Leave it out to keep the record until you delete it.\n     * @example\n     * ```ts\n     * // counts a run of the command and resolves to the new count\n     * const runs = await counts.update(user.id, (count) => (count ?? 0) + 1);\n     * ```\n     */\n    public async update(\n        id: string,\n        next: (current: Stored<TRecord> | undefined) => TRecord,\n        ttlMs?: number | ((value: TRecord) => number)\n    ): Promise<TRecord> {\n        const key = this.#prefix + id;\n        return this.#updates.run(key, async () => {\n            const value = next(this.#liveValue(await this.#driver.get(key)));\n            await this.#write(key, value, typeof ttlMs === 'function' ? ttlMs(value) : ttlMs);\n            return value;\n        });\n    }\n\n    /**\n     * Yields `[id, record]` for every record in this collection that hasn't expired. Use it to read\n     * back what the bot saved before a restart.\n     *\n     * @throws A **SeedcordError** when the backend can't list its keys, like `@keyv/memcache`.\n     * @example\n     * ```ts\n     * // schedules every saved reminder again after a restart\n     * for await (const [id, reminder] of reminders.entries()) schedule(id, reminder);\n     * ```\n     */\n    public async *entries(): AsyncIterable<[id: string, record: Stored<TRecord>]> {\n        const expired: string[] = [];\n        try {\n            for await (const [key, raw] of this.#driver.entries(this.#prefix)) {\n                const value = this.#liveValue(raw);\n                if (value === undefined) expired.push(key);\n                else yield [key.slice(this.#prefix.length), value];\n            }\n        } finally {\n            // deletes wait until the listing ends. a driver may be reading from an open cursor\n            await Promise.all(expired.map(async (key) => this.#deleteExpired(key)));\n        }\n    }\n\n    async #write(key: string, value: TRecord, ttlMs: number | undefined): Promise<void> {\n        const envelope: Envelope<TRecord> = ttlMs === undefined ? { value } : { value, expiresAt: Date.now() + ttlMs };\n        await this.#driver.set(key, JSON.stringify(envelope), ttlMs);\n    }\n\n    // reads again in the queue. a set queued after the first read may have stored a live record\n    async #deleteExpired(key: string): Promise<void> {\n        await this.#updates.run(key, async () => {\n            const raw = await this.#driver.get(key);\n            if (raw !== undefined && this.#liveValue(raw) === undefined) await this.#driver.delete(key);\n        });\n    }\n\n    #liveValue(raw: string | undefined): Stored<TRecord> | undefined {\n        if (raw === undefined) return undefined;\n        // justified: only this collection writes under its prefix\n        const envelope = JSON.parse(raw) as Envelope<Stored<TRecord>>;\n        if (envelope.expiresAt !== undefined && envelope.expiresAt <= Date.now()) return undefined;\n        return envelope.value;\n    }\n}\n","import { GuardedDriver } from './GuardedDriver';\nimport { KeyedQueue } from './KeyedQueue';\nimport { KvCollection } from './KvCollection';\n\nimport type { Config } from '@seedcord/types';\n\ntype ConfiguredDriver = NonNullable<Config['kv']>;\n\n// what JSON.stringify keeps as written. a Date passes through its toJSON\ntype JsonSafe<TValue> = TValue extends string | number | boolean | null | undefined\n    ? TValue\n    : TValue extends { toJSON(): unknown }\n      ? TValue\n      : TValue extends (...args: never[]) => unknown\n        ? never\n        : TValue extends ReadonlyMap<unknown, unknown> | ReadonlySet<unknown>\n          ? never\n          : TValue extends readonly (infer Item)[]\n            ? readonly JsonSafe<Item>[]\n            : TValue extends object\n              ? { [K in keyof TValue]: JsonSafe<TValue[K]> }\n              : never;\n\n// tsc prints a failed string argument against an object type as only `string is not assignable`\ntype CollectionName<TRecord> = unknown extends TRecord\n    ? 'Pass the record type, like kv.collection<Profile>(name).'\n    : [TRecord] extends [JsonSafe<TRecord>]\n      ? string\n      : 'This record type holds a value JSON cannot keep, like a function, Map, Set, or bigint.';\n\n// unescaped, every key under `user:settings:` would also start with `user:`\nfunction keyPrefix(path: readonly string[]): string {\n    return path.map((segment) => `${encodeURIComponent(segment)}:`).join('');\n}\n\n/**\n * The bot's key-value store, or one prefixed slice of it. `core.kv` holds your handlers' records. A\n * plugin's `this.kv` holds the plugin's.\n */\nexport class Kv {\n    /** What you passed as `config.kv`. Register its type in `KvTypes` to call the library's own methods on it. */\n    public readonly driver: ConfiguredDriver;\n    readonly #guarded: GuardedDriver;\n    readonly #path: readonly string[];\n    readonly #updates = new KeyedQueue();\n\n    constructor(driver: ConfiguredDriver, ...path: string[]) {\n        this.driver = driver;\n        this.#guarded = new GuardedDriver(driver);\n        this.#path = path;\n    }\n\n    /**\n     * Records of one type under `name`. Pass the type argument. A record type holding a function,\n     * `Map`, `Set`, or `bigint` fails to compile here.\n     */\n    public collection<TRecord>(name: CollectionName<TRecord>): KvCollection<TRecord> {\n        return new KvCollection<TRecord>(this.#guarded, keyPrefix([...this.#path, name]), this.#updates);\n    }\n}\n","import type { Kv } from '#src/kv/Kv';\nimport type { KvCollection } from '#src/kv/KvCollection';\nimport type { EpochMs, IRateLimiter, RateLimitResult, RateLimitWindow } from '@seedcord/types';\n\nfunction limitedResult(live: readonly number[], now: number): RateLimitResult {\n    // a reduce, because spreading into Math.min throws past the argument cap\n    const resetAt = live.reduce((earliest, exp) => Math.min(earliest, exp), Number.POSITIVE_INFINITY) as EpochMs;\n    return { limited: true, resetAt, remaining: 0, retryAfterMs: resetAt - now };\n}\n\nfunction openResult(remaining: number): RateLimitResult {\n    return { limited: false, resetAt: 0 as EpochMs, remaining, retryAfterMs: 0 };\n}\n\n// 0 or a negative limit never means \"block everything\"\nfunction limitOf(window: RateLimitWindow): number {\n    return Math.max(1, window.limit ?? 1);\n}\n\nfunction liveUses(stored: readonly number[] | undefined, now: number): number[] {\n    return (stored ?? []).filter((exp) => exp > now);\n}\n\nexport class KvRateLimiter implements IRateLimiter {\n    private readonly uses: KvCollection<number[]>;\n\n    constructor(kv: Kv) {\n        this.uses = kv.collection<number[]>('rate-limit');\n    }\n\n    public async charge(key: string, window: RateLimitWindow): Promise<RateLimitResult> {\n        const limit = limitOf(window);\n        // update() calls the callback before it resolves\n        let result!: RateLimitResult;\n        await this.uses.update(\n            key,\n            (stored) => {\n                // read here, since this callback can wait in the queue behind other charges\n                const now = Date.now();\n                const live = liveUses(stored, now);\n                const limited = live.length >= limit;\n                if (!limited) live.push(now + window.windowMs);\n                result = limited ? limitedResult(live, now) : openResult(limit - live.length);\n                return live;\n            },\n            (live) => live.reduce((latest, exp) => Math.max(latest, exp), 0) - Date.now()\n        );\n        return result;\n    }\n\n    public async peek(key: string, window: RateLimitWindow): Promise<RateLimitResult> {\n        const stored = await this.uses.get(key);\n        const now = Date.now();\n        const limit = limitOf(window);\n        const live = liveUses(stored, now);\n        return live.length >= limit ? limitedResult(live, now) : openResult(limit - live.length);\n    }\n\n    public async reset(key: string): Promise<void> {\n        await this.uses.delete(key);\n    }\n}\n","interface PluginKeyParts {\n    readonly head: string;\n    readonly leaf: string | undefined;\n}\n\n// 'services.users' attaches the plugin as users inside the group services\nexport function splitPluginKey(key: string): PluginKeyParts {\n    const dot = key.indexOf('.');\n    return dot === -1 ? { head: key, leaf: undefined } : { head: key.slice(0, dot), leaf: key.slice(dot + 1) };\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError, SeedcordTypeError } from '@seedcord/errors/internal';\nimport { FRAMEWORK_CHANNELS } from '@seedcord/logger';\nimport { HostPluginKeys } from '@seedcord/types/internal';\n\nimport { Kv } from '#src/kv/Kv';\nimport { MemoryDriver } from '#src/kv/MemoryDriver';\nimport { KvRateLimiter } from '#src/rateLimiter/KvRateLimiter';\nimport { Bus } from '#subscribers/Bus';\n\nimport { constructAttached, declaredScopeOf, extendsThisCorePlugin, resolvedLifecycleSpecOf } from './Plugin';\nimport { splitPluginKey } from './splitPluginKey';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { ResolvedPluginLifecycleSpec } from './lifecycle';\nimport type { DeclaredScope, Runtime, Transport } from './options';\nimport type { AttachableCtor, Attached, AttachKeyAssert, PluginArgs, PluginCtor, PluginLike } from './Plugin';\nimport type { REST } from '@discordjs/rest';\nimport type { Config, IRateLimiter } from '@seedcord/types';\n\nexport interface Attachment {\n    readonly key: string;\n    readonly instance: PluginLike;\n    readonly spec: ResolvedPluginLifecycleSpec;\n}\n\nconst RESERVED_KEYS: ReadonlySet<string> = new Set(FRAMEWORK_CHANNELS);\n\nconst attachmentsSlot = Symbol('seedcord:host:attachments');\nconst sealSlot = Symbol('seedcord:host:seal');\n\n/** Base class for a plugin host. */\nexport abstract class PluginHost<BotT extends Transport, BotRt extends Runtime> implements CoreBase {\n    public abstract readonly config: Config;\n    public abstract readonly rest: REST;\n    public abstract readonly applicationId: string;\n\n    /** @see {@link Bus} */\n    public readonly bus: Bus;\n    /** @see {@link Kv} */\n    public readonly kv: Kv;\n    /** @see {@link IRateLimiter} */\n    public readonly rateLimiter: IRateLimiter;\n\n    #sealed = false;\n    readonly #attachments: Attachment[] = [];\n    readonly #groups = new Map<string, Record<string, PluginLike>>();\n    readonly #scope: { readonly transport: BotT; readonly runtime: BotRt };\n\n    constructor(transport: BotT, runtime: BotRt, driver: Config['kv']) {\n        this.#scope = { transport, runtime };\n        this.bus = new Bus(this);\n        const kvDriver = driver ?? new MemoryDriver();\n        this.kv = new Kv(kvDriver, 'app');\n        this.rateLimiter = new KvRateLimiter(new Kv(kvDriver, 'seedcord'));\n    }\n\n    /** @internal */\n    public get [attachmentsSlot](): readonly Attachment[] {\n        return this.#attachments;\n    }\n\n    /** @internal */\n    public [sealSlot](): void {\n        this.#sealed = true;\n    }\n\n    /** @internal codegen reads this to emit the `Core` augmentation */\n    public get [HostPluginKeys](): readonly string[] {\n        return this.#attachments.map((attachment) => attachment.key);\n    }\n\n    /**\n     * Attaches a plugin under `key`. Read the instance back as `core[key]`. `seedcord codegen`\n     * writes the `Core` augmentation that types it there.\n     *\n     * Put one dot in the key to nest the plugin under a group. `'services.users'` reads back as\n     * `core.services.users`. Each name holds one plugin or one group.\n     *\n     * Startup runs each plugin's `init()` in attach order within its phase. A node bot starts in\n     * `start()`. An edge bot starts on its first request.\n     *\n     * Attaching a plugin whose `transport` or `runtime` differs from this host fails to compile.\n     * Your constructor takes `CoreBase` as its first parameter (you don't need to pass it though).\n     * A narrower one fails to compile here.\n     *\n     * @param key - Also the channel the plugin logs on, dots included.\n     * @param args - Whatever your constructor takes after the host.\n     * @throws A **SeedcordError** when you attach after the bot has started.\n     * @throws A **SeedcordTypeError** when `key` is taken, reserved, or malformed.\n     * @throws A **SeedcordTypeError** when the plugin extends `Plugin` from another copy of `@seedcord/core`.\n     * @throws A **SeedcordTypeError** when the plugin's `transport` or `runtime` differs from this host and the types were bypassed.\n     * @example\n     * ```ts\n     * seedcord.attach('db', Mongoose, { uri: 'mongodb://...', name: 'seedcord', dir: ... });\n     * ```\n     */\n    public attach<Key extends string, Ctor extends PluginCtor>(\n        this: this,\n        key: AttachKeyAssert<Key, this>,\n        Plugin: AttachableCtor<Ctor, BotT, BotRt>,\n        ...args: PluginArgs<Ctor>\n    ): this & Attached<Key, InstanceType<Ctor>>;\n    public attach<Key extends string, Ctor extends PluginCtor>(\n        this: this,\n        key: Key,\n        Plugin: Ctor,\n        ...args: PluginArgs<Ctor>\n    ): this & Attached<Key, InstanceType<Ctor>> {\n        if (this.#sealed) {\n            throw new SeedcordError(SeedcordErrorCode.CorePluginAfterInit);\n        }\n\n        const { head, leaf } = splitPluginKey(key);\n\n        // runs before assertFree because some reserved channels are also host members\n        if (RESERVED_KEYS.has(head)) {\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginReservedChannel, [head]);\n        }\n\n        if (head === '' || leaf === '') {\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyMalformed, [key, 'has an empty part.']);\n        }\n        if (leaf?.includes('.')) {\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyMalformed, [key, 'has more than one dot.']);\n        }\n        this.#assertFree(head, leaf, key);\n\n        if (!extendsThisCorePlugin(Plugin)) {\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginFromOtherCore, [Plugin.name]);\n        }\n\n        const kv = new Kv(this.kv.driver, 'plugins', key);\n        const instance = constructAttached(key, kv, () => new Plugin(this, ...args));\n        this.#assertScope(Plugin.name, declaredScopeOf(instance));\n        this.#attachments.push({ key, instance, spec: resolvedLifecycleSpecOf(instance) });\n\n        if (leaf === undefined) {\n            return Object.assign(this, { [key]: instance }) as this & Attached<Key, InstanceType<Ctor>>;\n        }\n\n        this.#groupFor(head)[leaf] = instance;\n        return this as this & Attached<Key, InstanceType<Ctor>>;\n    }\n\n    #assertFree(head: string, leaf: string | undefined, key: string): void {\n        if (leaf === undefined) {\n            if (this.#groups.has(key)) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyHoldsGroup, [key]);\n            if (key in this) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyExists, [key]);\n            return;\n        }\n\n        const group = this.#groups.get(head);\n        if (!group) {\n            if (head in this) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginGroupTaken, [head, key]);\n            return;\n        }\n        if (Object.hasOwn(group, leaf)) throw new SeedcordTypeError(SeedcordErrorCode.CorePluginKeyExists, [key]);\n    }\n\n    // the types already reject a mismatch. plain JS and casts reach this.\n    #assertScope(pluginName: string, declared: DeclaredScope): void {\n        for (const axis of ['transport', 'runtime'] as const) {\n            const host = this.#scope[axis];\n            if (declared[axis] === 'any' || declared[axis] === host) continue;\n            throw new SeedcordTypeError(SeedcordErrorCode.CorePluginScopeMismatch, [\n                pluginName,\n                axis,\n                declared[axis],\n                host\n            ]);\n        }\n    }\n\n    #groupFor(head: string): Record<string, PluginLike> {\n        const existing = this.#groups.get(head);\n        if (existing) return existing;\n\n        // a null prototype makes a leaf called __proto__ or valueOf an ordinary key\n        const group = Object.create(null) as Record<string, PluginLike>;\n        this.#groups.set(head, group);\n        Object.assign(this, { [head]: group });\n        return group;\n    }\n}\n\nexport function attachmentsOf(\n    host: Pick<PluginHost<Transport, Runtime>, typeof attachmentsSlot>\n): readonly Attachment[] {\n    return host[attachmentsSlot];\n}\n\nexport function sealAttachments(host: Pick<PluginHost<Transport, Runtime>, typeof sealSlot>): void {\n    host[sealSlot]();\n}\n"],"mappings":"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"}

package/dist/PluginLifecycle-DdwRzcDj.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginLifecycle-DdwRzcDj.mjs","names":[],"sources":["../src/notices/logUnknownFault.ts","../src/lifecycle/withTimeout.ts","../src/lifecycle/PluginLifecycle.ts"],"sourcesContent":["import type { Logger } from '@seedcord/logger';\nimport type { ErrorsConfig } from '@seedcord/types';\n\nfunction causeLine(error: Error): string {\n    const { cause } = error;\n    if (!Error.isError(cause)) return '';\n    const [first] = cause.message.split('\\n');\n    return `\\ncaused by ${cause.name}: ${first ?? cause.message}`;\n}\n\nexport function logUnknownFault(logger: Logger, uuid: string, error: Error, errors: ErrorsConfig | undefined): void {\n    if (errors?.errorStack ?? true) logger.error(uuid, error);\n    else logger.error(`${uuid} | ${error.message}${causeLine(error)}`);\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\n// calling start() in here turns its synchronous throw into a rejection\nasync function raceTimer(\n    start: () => Promise<unknown>,\n    timeoutMs: number,\n    onTimeout: (resolve: () => void, reject: (error: unknown) => void) => void\n): Promise<void> {\n    let timer: NodeJS.Timeout | undefined;\n    try {\n        await Promise.race([\n            start(),\n            new Promise<void>((resolve, reject) => {\n                // node's timer can go off before performance.now() reaches timeoutMs\n                const expiresAt = performance.now() + timeoutMs;\n                const tick = (): void => {\n                    const remaining = expiresAt - performance.now();\n                    if (remaining > 0) {\n                        timer = setTimeout(tick, remaining);\n                        return;\n                    }\n                    onTimeout(resolve, reject);\n                };\n                timer = setTimeout(tick, timeoutMs);\n            })\n        ]);\n    } finally {\n        if (timer) clearTimeout(timer);\n    }\n}\n\n// rejects with a LifecycleTaskTimeout when run outlasts the bound\nexport function withTimeout(name: string, run: () => Promise<void>, timeoutMs: number): Promise<void> {\n    return raceTimer(run, timeoutMs, (_, reject) => {\n        reject(new SeedcordError(SeedcordErrorCode.LifecycleTaskTimeout, [name, timeoutMs]));\n    });\n}\n\n// the caller does not get work's rejection\nexport function settleWithin(work: Promise<unknown>, timeoutMs: number): Promise<void> {\n    return raceTimer(\n        () =>\n            work.then(\n                () => undefined,\n                () => undefined\n            ),\n        timeoutMs,\n        (resolve) => resolve()\n    );\n}\n","import { SeedcordErrorCode, isSeedcordError } from '@seedcord/errors';\nimport { throwSingleOrAggregate } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\n\nimport { StartupPhase } from '#src/lifecycle/phases';\nimport { pluginLoggerOf } from '#src/plugin/Plugin';\n\nimport { withTimeout } from './withTimeout';\n\nimport type { ShutdownTasks } from '#node/Lifecycle/CoordinatedShutdown';\nimport type { TaskShutdownPhase } from '#src/lifecycle/phases';\nimport type { Attachment } from '#src/plugin/PluginHost';\nimport type { StartupTasks } from './CoordinatedStartup';\n\ninterface ReadyStep {\n    readonly key: string;\n    readonly run: () => Promise<void>;\n    readonly timeout: number;\n}\n\nexport class PluginLifecycle {\n    private readonly logger = new Logger('Plugins', { channel: 'plugins' });\n    private readonly completedInits = new Set<Attachment>();\n    private readonly disposePhases = new Set<TaskShutdownPhase>();\n    private readonly timedOutInits = new Set<Promise<void>>();\n    private attachments: readonly Attachment[] = [];\n    private registered = false;\n\n    constructor(\n        private readonly startup: StartupTasks,\n        private readonly shutdown: ShutdownTasks\n    ) {}\n\n    // one combined task per phase keeps plugin inits sequential while the phase's other tasks run concurrently\n    public register(attachments: readonly Attachment[]): void {\n        if (this.registered) return;\n        this.registered = true;\n        this.attachments = [...attachments];\n\n        const groups = Map.groupBy(this.attachments, (attachment) => attachment.spec.init.phase);\n\n        for (const [phase, group] of groups) {\n            // Ready inits run in the combined Ready task, before the ready hooks\n            if (phase === StartupPhase.Ready) continue;\n            const budget = group.reduce((sum, a) => sum + a.spec.init.timeout, 0);\n            this.startup.addTask(phase, 'plugins-init', () => this.runInits(group), budget);\n        }\n\n        this.registerReadyTask(groups.get(StartupPhase.Ready) ?? []);\n    }\n\n    public async rollback(): Promise<void> {\n        // log rollback dispose failures so they do not hide the startup error\n        await this.disposeCompleted(undefined, (caught) => this.logger.warn('rollback dispose failed', caught));\n        // prevents re-dispose when shutdown runs after rollback\n        this.completedInits.clear();\n    }\n\n    public afterTimedOutInits(run: () => void): void {\n        if (this.timedOutInits.size === 0) {\n            run();\n            return;\n        }\n        void Promise.allSettled(this.timedOutInits).then(run);\n    }\n\n    private async runInits(group: readonly Attachment[]): Promise<void> {\n        for (const attachment of group) {\n            const { key, instance, spec } = attachment;\n\n            pluginLoggerOf(instance).utils.initialization(key, 'start');\n            const running = instance.init();\n            try {\n                await withTimeout(`Plugin (${key})`, () => running, spec.init.timeout);\n            } catch (caught) {\n                if (isSeedcordError(caught, undefined, SeedcordErrorCode.LifecycleTaskTimeout)) {\n                    this.disposeWhenInitResolves(attachment, running);\n                }\n                throw caught;\n            }\n            pluginLoggerOf(instance).utils.initialization(key, 'end');\n\n            this.completedInits.add(attachment);\n            if (instance.dispose) this.registerDisposeTask(spec.dispose.phase);\n        }\n    }\n\n    // disposeCompleted skips a plugin missing from completedInits\n    private disposeWhenInitResolves({ key, instance, spec }: Attachment, running: Promise<void>): void {\n        const dispose = instance.dispose?.bind(instance);\n\n        const settled = running.then(\n            async () => {\n                if (!dispose) return;\n                await withTimeout(`Plugin:${key}:dispose`, dispose, spec.dispose.timeout).catch((caught: unknown) =>\n                    this.logger.warn(`${key} dispose failed after a timed-out init`, caught)\n                );\n            },\n            (caught: unknown) => this.logger.warn(`${key} init failed after its timeout`, caught)\n        );\n        this.timedOutInits.add(settled);\n        void settled.finally(() => this.timedOutInits.delete(settled));\n    }\n\n    private registerReadyTask(readyInits: readonly Attachment[]): void {\n        const steps = this.attachments.reduce<ReadyStep[]>((acc, { key, instance, spec }) => {\n            const ready = instance.ready?.bind(instance);\n            if (ready) acc.push({ key, run: ready, timeout: spec.ready.timeout });\n            return acc;\n        }, []);\n        if (readyInits.length === 0 && steps.length === 0) return;\n\n        const budget =\n            readyInits.reduce((sum, a) => sum + a.spec.init.timeout, 0) +\n            steps.reduce((sum, step) => sum + step.timeout, 0);\n        this.startup.addTask(\n            StartupPhase.Ready,\n            'plugins-ready',\n            async () => {\n                await this.runInits(readyInits);\n                for (const step of steps) {\n                    await withTimeout(`Plugin:${step.key}:ready`, step.run, step.timeout);\n                }\n            },\n            budget\n        );\n    }\n\n    private registerDisposeTask(phase: TaskShutdownPhase): void {\n        if (this.disposePhases.has(phase)) return;\n        this.disposePhases.add(phase);\n\n        // the budget covers every dispose in this phase because they all run in this one task\n        const budget = this.attachments.reduce(\n            (sum, a) => (a.instance.dispose && a.spec.dispose.phase === phase ? sum + a.spec.dispose.timeout : sum),\n            0\n        );\n        this.shutdown.addTask(phase, 'plugins-dispose', () => this.runDisposals(phase), budget);\n    }\n\n    private async runDisposals(phase: TaskShutdownPhase): Promise<void> {\n        const failures: unknown[] = [];\n        await this.disposeCompleted(phase, (caught) => failures.push(caught));\n        throwSingleOrAggregate(failures, SeedcordErrorCode.PluginDisposeFailures);\n    }\n\n    private async disposeCompleted(\n        phase: TaskShutdownPhase | undefined,\n        onError: (caught: unknown) => void\n    ): Promise<void> {\n        for (const attachment of [...this.attachments].reverse()) {\n            if (!this.completedInits.has(attachment)) continue;\n            const { key, instance, spec } = attachment;\n            const dispose = instance.dispose?.bind(instance);\n            if (!dispose) continue;\n            if (phase !== undefined && spec.dispose.phase !== phase) continue;\n\n            try {\n                await withTimeout(`Plugin:${key}:dispose`, dispose, spec.dispose.timeout);\n            } catch (caught) {\n                onError(caught);\n            }\n        }\n    }\n}\n"],"mappings":"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"}

package/dist/subscribers-D4_HZcgw.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"subscribers-D4_HZcgw.mjs","names":["allOf"],"sources":["../src/stops/Notice.ts","../src/stops/NoticeCard.ts","../src/commands/contextMenuLeaves.ts","../src/commands/scopes.ts","../src/miscellaneous/guarded.ts","../src/commands/linkCommands.ts","../src/commands/CommandInjector.ts","../src/decorators/Command.ts","../src/customId/routing.ts","../src/decorators/interactionRoutes.ts","../src/decorators/middleware.ts","../src/reply/ackLegality.ts","../src/reply/AckTrace.ts","../src/reply/responseReport.ts","../src/reply/translateSerialization.ts","../src/reply/serializeReply.ts","../src/gates/Gate.ts","../src/notices/index.ts","../src/gates/effects.ts","../src/gates/catalog/options.ts","../src/permissions/bits.ts","../src/gates/catalog/permissions.ts","../src/stops/Silence.ts","../src/miscellaneous/ResolvedEmoji.ts","../src/pagination/cursor.ts"],"sourcesContent":["import type { RenderContext, ReplyResponse } from '@seedcord/types';\n\n/**\n * Base class for a user-facing refusal or a reported fault.\n *\n * Throw a `Notice` to stop a handler and reply to the user. The framework catches it at the controller\n * boundary and renders {@link Notice.render}, which always decides what the user sees. With `report`\n * false that render is all that happens. With `report` true the framework also logs the fault and\n * publishes it to the `handledException` bus. A raw, non-Notice throw shows the generic message.\n *\n * @example\n * ```ts\n * import { Notice, BuilderComponent, type RenderContext, type ReplyResponse } from '@seedcord/gateway';\n * import { TextDisplayBuilder } from '@discordjs/builders';\n *\n * // reading `.component` applies the configured bot color to the container accent\n * class TooPoorCard extends BuilderComponent<'container'> {\n *     constructor(balance: number) {\n *         super('container');\n *         this.instance.addTextDisplayComponents(\n *             new TextDisplayBuilder().setContent(`### Insufficient balance\\nYou need more than ${balance} coins.`)\n *         );\n *     }\n * }\n *\n * class TooPoor extends Notice {\n *     constructor(private readonly balance: number) {\n *         super(`balance ${balance} is below the cost`);\n *     }\n *\n *     render(_ctx: RenderContext): ReplyResponse {\n *         return { components: [new TooPoorCard(this.balance).component] };\n *     }\n * }\n *\n * // in a handler, throwing stops the handler and replies with render(ctx)\n * if (wallet.balance < cost) throw new TooPoor(wallet.balance);\n * ```\n */\nexport abstract class Notice extends Error {\n    /**\n     * Whether this denial is a reported fault. True also logs it and publishes it to the `handledException`\n     * bus. The user always sees {@link Notice.render} either way.\n     *\n     * @defaultValue `false`\n     */\n    public report = false;\n\n    /**\n     * Whether the reply is ephemeral, seen only by the invoking user. Set it false for a refusal the\n     * whole channel should see.\n     *\n     * @defaultValue `true`\n     */\n    public ephemeral = true;\n\n    /**\n     * A short one-line reason. When every arm of an {@link or} gate refuses and each one sets this, `or`\n     * throws a refusal listing them under `You need to meet at least one of these:`. Write a verb phrase that\n     * finishes that line, for example, \"be the bot owner\".\n     */\n    public summary?: string;\n\n    protected constructor(message: string, options?: ErrorOptions) {\n        super(message, options);\n\n        // Error sets name to 'Error', so stamp the concrete subclass name for logs and the fault report\n        this.name = new.target.name;\n        Error.captureStackTrace(this, this.constructor);\n    }\n\n    /**\n     * Builds what the user sees. Called fresh each time the denial is shown, so the builders are new\n     * and the bot color resolves at render time.\n     */\n    public abstract render(ctx: RenderContext): ReplyResponse;\n}\n","import { TextDisplayBuilder } from '@discordjs/builders';\n\nimport { BuilderComponent } from '#components/Component';\n\n// built fresh inside a Notice's render to back its ComponentsV2 reply\n// discord renders the ### line as an h3 with the description below\nexport class NoticeCard extends BuilderComponent<'container'> {\n    public constructor(description: string, title = 'Cannot Proceed') {\n        super('container');\n        this.instance.addTextDisplayComponents(new TextDisplayBuilder().setContent(`### ${title}\\n${description}`));\n    }\n}\n","import { ApplicationCommandType } from 'discord-api-types/v10';\n\nimport type { RESTPostAPIApplicationCommandsJSONBody } from 'discord-api-types/v10';\n\nexport interface ContextMenuLeaves {\n    readonly user: Set<string>;\n    readonly message: Set<string>;\n}\n\n// a user and a message command can share a name\nexport function contextMenuLeaves(commands: Iterable<RESTPostAPIApplicationCommandsJSONBody>): ContextMenuLeaves {\n    const user = new Set<string>();\n    const message = new Set<string>();\n    for (const command of commands) {\n        if (command.type === ApplicationCommandType.User) user.add(command.name);\n        else if (command.type === ApplicationCommandType.Message) message.add(command.name);\n    }\n    return { user, message };\n}\n","import { Routes } from 'discord-api-types/v10';\n\nimport type { DeployTarget } from '#src/commands/deployTarget';\nimport type { Snowflake } from 'discord-api-types/v10';\nimport type { LiteralUnion } from 'type-fest';\n\nexport const GLOBAL_ID = 'global';\n\nconst allOf = new Intl.ListFormat('en', { type: 'conjunction' });\n\n// discord's guild ids are all digits\nexport type ScopeId = LiteralUnion<typeof GLOBAL_ID, Snowflake>;\n\nexport function commandsRoute(applicationId: Snowflake, scope: ScopeId): `/${string}` {\n    return scope === GLOBAL_ID\n        ? Routes.applicationCommands(applicationId)\n        : Routes.applicationGuildCommands(applicationId, scope);\n}\n\nexport function globalFirst<ValueT>(scopes: Iterable<readonly [ScopeId, ValueT]>): (readonly [ScopeId, ValueT])[] {\n    return [...scopes].toSorted(([a], [b]) => Number(b === GLOBAL_ID) - Number(a === GLOBAL_ID));\n}\n\nexport function scopeIdsOf(target: DeployTarget): readonly ScopeId[] {\n    return target.scope === 'global' ? [GLOBAL_ID] : target.guilds;\n}\n\nexport function skippedNote(skipped: readonly ScopeId[], guildLabel: (guildId: string) => string): string {\n    const guilds = skipped.filter((scope) => scope !== GLOBAL_ID).map(guildLabel);\n    const parts = [\n        ...(skipped.includes(GLOBAL_ID) ? ['the global commands'] : []),\n        ...(guilds.length > 0 ? [`the commands in ${allOf.format(guilds)}`] : [])\n    ];\n    return `Skipped ${allOf.format(parts)} because they match the last deploy.`;\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\n// null-prototype, on a plain object a key named __proto__ sets the store's prototype and adds no entry\nexport function accessorStore<Value>(): Record<string, Value> {\n    return Object.create(null) as Record<string, Value>;\n}\n\n// empties a store in place, keeping the reference the accessor's Proxy wraps\nexport function clearStore(store: Record<string, unknown>): void {\n    for (const key of Object.keys(store)) Reflect.deleteProperty(store, key);\n}\n\n// handler modules import before startup fills the record, and an unguarded read there returns undefined and renders as an empty string\nexport function guardedAccessor<Value>(accessor: string, storage: Record<string, Value>): Record<string, Value> {\n    return new Proxy(storage, {\n        get(target, key, receiver): unknown {\n            // hasOwn, since `in` walks the prototype and would read a key like `constructor` as resolved\n            if (typeof key !== 'string' || Object.hasOwn(target, key)) return Reflect.get(target, key, receiver);\n            throw new SeedcordError(SeedcordErrorCode.CoreAccessorUnresolved, [accessor, key]);\n        }\n    });\n}\n","import { routeLeavesOf } from '@seedcord/utils/internal';\nimport { ApplicationCommandType } from 'discord-api-types/v10';\n\nimport { contextMenuLeaves } from '#src/commands/contextMenuLeaves';\nimport { GLOBAL_ID } from '#src/commands/scopes';\nimport { accessorStore } from '#src/miscellaneous/guarded';\n\nimport type { ContextMenuKind } from '#registries/ContextMenuRegistry';\nimport type { CommandInfo, ContextMenuInfo } from '#src/commands/CommandInjector';\nimport type { DeployResult } from '#src/commands/types';\nimport type {\n    APIApplicationCommand,\n    RESTPostAPIApplicationCommandsJSONBody as CommandJson,\n    RESTPostAPIChatInputApplicationCommandsJSONBody,\n    Snowflake\n} from 'discord-api-types/v10';\n\nexport interface CommandRef {\n    readonly name: string;\n    readonly type: ApplicationCommandType;\n}\n\ninterface LinkedContextMenus {\n    readonly user: Record<string, ContextMenuInfo>;\n    readonly message: Record<string, ContextMenuInfo>;\n}\n\nexport interface LinkedCommands {\n    readonly commands: Record<string, CommandInfo>;\n    readonly contextMenus: LinkedContextMenus;\n    readonly multiGuild: CommandRef[];\n    readonly notInCode: CommandRef[];\n}\n\nconst MULTI_GUILD = Symbol('seedcord:commands:multi-guild');\ntype DeployedId = Snowflake | typeof MULTI_GUILD;\n\ninterface CommandLike {\n    name: string;\n    type?: ApplicationCommandType | undefined;\n}\n\nexport function commandRefOf({ name, type }: CommandLike): CommandRef {\n    // discord reads a missing type as a slash command\n    return { name, type: type ?? ApplicationCommandType.ChatInput };\n}\n\n// Discord keeps command names unique per type\nexport function commandKey(command: CommandLike): string {\n    const { type, name } = commandRefOf(command);\n    return `${type}:${name}`;\n}\n\nexport function indexById(commands: readonly APIApplicationCommand[]): Map<string, APIApplicationCommand> {\n    return new Map(commands.map((command) => [command.id, command]));\n}\n\nfunction isSlash(json: CommandJson): json is RESTPostAPIChatInputApplicationCommandsJSONBody {\n    return commandRefOf(json).type === ApplicationCommandType.ChatInput;\n}\n\n// a guild command in N guilds appears once per guild\nfunction uniqueRefs(refs: readonly CommandRef[]): CommandRef[] {\n    return [...new Map(refs.map((ref) => [commandKey(ref), ref])).values()];\n}\n\nfunction deployedIds(deploy: DeployResult): Map<string, DeployedId> {\n    const ids = new Map<string, DeployedId>();\n    for (const [scope, collection] of deploy) {\n        if (scope === GLOBAL_ID) continue;\n        for (const command of collection.values()) {\n            const key = commandKey(command);\n            const existing = ids.get(key);\n            // Discord gives a guild command its own id in each guild\n            if (existing === undefined) ids.set(key, command.id);\n            else if (existing !== command.id) ids.set(key, MULTI_GUILD);\n        }\n    }\n    // a global command's one id wins over any guild copy\n    for (const command of deploy.get(GLOBAL_ID)?.values() ?? []) ids.set(commandKey(command), command.id);\n    return ids;\n}\n\nfunction allDeployed(deploy: DeployResult): APIApplicationCommand[] {\n    return [...deploy.values()].flatMap((collection) => [...collection.values()]);\n}\n\nfunction mentionOf(route: string, id: Snowflake | undefined): string {\n    const spaced = route.replaceAll('/', ' ');\n    return id ? `</${spaced}:${id}>` : `/${spaced}`;\n}\n\nclass CommandLinker {\n    private readonly ids: Map<string, DeployedId>;\n\n    constructor(private readonly deploy: DeployResult) {\n        this.ids = deployedIds(deploy);\n    }\n\n    public link(all: readonly CommandJson[]): LinkedCommands {\n        const slash = all.filter(isSlash);\n        const leaves = contextMenuLeaves(all);\n        const inCode = uniqueRefs([\n            ...slash.map(commandRefOf),\n            ...[...leaves.user].map((name) => ({ name, type: ApplicationCommandType.User })),\n            ...[...leaves.message].map((name) => ({ name, type: ApplicationCommandType.Message }))\n        ]);\n\n        return {\n            commands: this.slashRoutes(slash),\n            contextMenus: {\n                user: this.menus(leaves.user, ApplicationCommandType.User),\n                message: this.menus(leaves.message, ApplicationCommandType.Message)\n            },\n            multiGuild: inCode.filter((ref) => this.ids.get(commandKey(ref)) === MULTI_GUILD),\n            notInCode: this.notInCode(inCode)\n        };\n    }\n\n    private slashRoutes(\n        slash: readonly RESTPostAPIChatInputApplicationCommandsJSONBody[]\n    ): Record<string, CommandInfo> {\n        const commands = accessorStore<CommandInfo>();\n        for (const command of slash) {\n            const id = this.idOf(commandRefOf(command));\n            for (const { route, description } of routeLeavesOf(command)) {\n                commands[route] = { mention: mentionOf(route, id), ...(id && { id }), route, description };\n            }\n        }\n        return commands;\n    }\n\n    private menus(names: ReadonlySet<string>, kind: ContextMenuKind): Record<string, ContextMenuInfo> {\n        const menus = accessorStore<ContextMenuInfo>();\n        for (const name of names) {\n            const id = this.idOf({ name, type: kind });\n            menus[name] = { ...(id && { id }), name, kind };\n        }\n        return menus;\n    }\n\n    private idOf(ref: CommandRef): Snowflake | undefined {\n        const id = this.ids.get(commandKey(ref));\n        return id === MULTI_GUILD ? undefined : id;\n    }\n\n    private notInCode(inCode: readonly CommandRef[]): CommandRef[] {\n        const inCodeKeys = new Set(inCode.map(commandKey));\n        const extra = new Map<string, CommandRef>();\n        for (const command of allDeployed(this.deploy)) {\n            const key = commandKey(command);\n            if (!inCodeKeys.has(key)) extra.set(key, commandRefOf(command));\n        }\n        return [...extra.values()];\n    }\n}\n\nexport function linkCommands(deploy: DeployResult, all: readonly CommandJson[]): LinkedCommands {\n    return new CommandLinker(deploy).link(all);\n}\n","import { paint } from '@seedcord/errors';\nimport { Logger } from '@seedcord/logger';\nimport { ApplicationCommandType } from 'discord-api-types/v10';\n\nimport { linkCommands } from '#src/commands/linkCommands';\nimport { accessorStore, clearStore, guardedAccessor } from '#src/miscellaneous/guarded';\n\nimport type {\n    ContextMenuKind,\n    MessageContextMenuRegistry,\n    UserContextMenuRegistry\n} from '#registries/ContextMenuRegistry';\nimport type { SlashRegistry } from '#registries/SlashRegistry';\nimport type { CommandRef, LinkedCommands } from '#src/commands/linkCommands';\nimport type { CommandBuilder, DeployResult } from '#src/commands/types';\nimport type { ILogger } from '@seedcord/types';\n\nconst commandStorage = accessorStore<CommandInfo>();\nconst userMenuStorage = accessorStore<ContextMenuInfo>();\nconst messageMenuStorage = accessorStore<ContextMenuInfo>();\n\n/** What {@link Commands} resolves to for one slash route. */\nexport interface CommandInfo {\n    /** The clickable `</config set:id>` mention. A route whose id did not resolve falls back to `/config set`. */\n    readonly mention: string;\n    /** The deployed command id. Absent when the command deployed to two or more guilds. */\n    readonly id?: string;\n    /** The full route, e.g. `config/set`. */\n    readonly route: string;\n    /** The route's own description, taken from the subcommand for a nested route. */\n    readonly description: string;\n}\n\n/** Each registered slash route mapped to its deployed command. */\nexport type InjectedCommandMap = {\n    [K in keyof SlashRegistry]: CommandInfo;\n};\n\n/**\n * The bot's deployed slash commands, keyed by {@link SlashRegistry}. A server bot fills these after\n * each deploy. An edge bot fills them on its first request, from the ids `seedcord build` wrote into\n * the worker.\n *\n * @throws A **SeedcordError** when you read a command before the bot fills it.\n *\n * @example\n * ```ts\n * import { Commands } from '@seedcord/gateway';\n *\n * await this.reply(`Try ${Commands['config/set'].mention}`);\n *\n * // a help listing\n * const lines = Object.values(Commands).map((c) => `${c.mention} ${c.description}`);\n * ```\n */\nexport const Commands = guardedAccessor('Commands', commandStorage) as InjectedCommandMap;\n\n/** What {@link ContextMenus} resolves to for one context-menu command. */\nexport interface ContextMenuInfo {\n    /** The deployed command id. Absent when the command deployed to two or more guilds. */\n    readonly id?: string;\n    /** The name shown in Discord's right-click menu. */\n    readonly name: string;\n    readonly kind: ContextMenuKind;\n}\n\n/** Deployed context-menu commands, split by kind because Discord scopes name uniqueness per command type. */\nexport interface InjectedContextMenuMap {\n    readonly user: { [K in keyof UserContextMenuRegistry]: ContextMenuInfo };\n    readonly message: { [K in keyof MessageContextMenuRegistry]: ContextMenuInfo };\n}\n\n/**\n * The bot's deployed context-menu commands. A server bot fills these after each deploy. An edge bot\n * fills them on its first request, from the ids `seedcord build` wrote into the worker.\n *\n * @throws A **SeedcordError** when you read a command before the bot fills it.\n *\n * @example\n * ```ts\n * import { ContextMenus } from '@seedcord/gateway';\n *\n * const id = ContextMenus.user['View Profile'].id;\n * ```\n */\nexport const ContextMenus = {\n    user: guardedAccessor('ContextMenus.user', userMenuStorage),\n    message: guardedAccessor('ContextMenus.message', messageMenuStorage)\n} as InjectedContextMenuMap;\n\nexport function installLinks({ commands, contextMenus }: Pick<LinkedCommands, 'commands' | 'contextMenus'>): void {\n    const pairs = [\n        [commandStorage, commands],\n        [userMenuStorage, contextMenus.user],\n        [messageMenuStorage, contextMenus.message]\n    ] as const;\n    for (const [store, values] of pairs) {\n        clearStore(store);\n        Object.assign(store, values);\n    }\n}\n\nconst KIND_LABELS: Record<ApplicationCommandType, string> = {\n    [ApplicationCommandType.ChatInput]: 'slash command',\n    [ApplicationCommandType.User]: 'user menu',\n    [ApplicationCommandType.Message]: 'message menu',\n    [ApplicationCommandType.PrimaryEntryPoint]: 'entry point command'\n};\n\nfunction multiGuildWarning({ name, type }: CommandRef): string {\n    const consequence =\n        type === ApplicationCommandType.ChatInput\n            ? 'falling back to plain text (not clickable)'\n            : 'leaving its id unset';\n    return `${paint.sky.bold(name)} is deployed to multiple guilds, ${consequence}.`;\n}\n\nexport function warnLinks(\n    logger: ILogger,\n    { multiGuild, notInCode }: Pick<LinkedCommands, 'multiGuild' | 'notInCode'>\n): void {\n    for (const ref of multiGuild) logger.warn(multiGuildWarning(ref));\n    for (const { name, type } of notInCode) {\n        logger.warn(\n            `The ${KIND_LABELS[type]} ${paint.sky.bold(name)} is deployed on Discord with no command for it in your code.`\n        );\n    }\n}\n\n/** @internal */\nexport class CommandInjector {\n    private readonly logger = new Logger('Commands', { channel: 'bot' });\n\n    public inject(deploy: DeployResult, all: readonly CommandBuilder[]): void {\n        const linked = linkCommands(\n            deploy,\n            all.map((command) => command.toJSON())\n        );\n        installLinks(linked);\n\n        warnLinks(this.logger, linked);\n\n        const routes = Object.values(linked.commands);\n        const clickable = routes.filter((command) => command.id !== undefined).length;\n        this.logger.utils.summary('Linked commands', {\n            clickable,\n            plain: routes.length - clickable,\n            'context menus':\n                Object.keys(linked.contextMenus.user).length + Object.keys(linked.contextMenus.message).length\n        });\n    }\n}\n","import 'reflect-metadata';\n\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordTypeError } from '@seedcord/errors/internal';\n\nimport { CommandMetadataKey } from '#src/metadataKeys';\n\nimport type { BuilderComponent } from '#components/Component';\nimport type { Constructor, LiteralUnion } from 'type-fest';\n\ntype CommandCtor = Constructor<BuilderComponent<'command' | 'context_menu'>>;\n\nexport const ConfigGuilds = 'config';\n\n/** A guild id, or `'config'` for every id in `commands.guilds`. */\nexport type GuildTarget = LiteralUnion<typeof ConfigGuilds, string>;\n\ninterface GlobalMeta {\n    scope: 'global';\n}\n\ninterface GuildMeta {\n    scope: 'guild';\n    guilds: GuildTarget[];\n}\n\ninterface ConfigMeta {\n    scope: 'config';\n}\n\nexport type CommandMeta = GlobalMeta | GuildMeta | ConfigMeta;\n\ntype CommandScope = CommandMeta['scope'];\n\n/**\n * Registers a command in the guilds listed under `commands.guilds`. With no ids listed there, the\n * command deploys globally.\n *\n * @decorator\n * @example\n * ```typescript\n * \\@RegisterCommand()\n * class PingCommand extends BuilderComponent<'command'> {} // or BuilderComponent<'context_menu'>\n * ```\n */\nexport function RegisterCommand(): (ctor: CommandCtor) => void;\n\n/**\n * Registers a command globally, ignoring `commands.guilds`.\n *\n * @decorator\n * @example\n * ```typescript\n * \\@RegisterCommand('global')\n * class PingCommand extends BuilderComponent<'command'> {} // or BuilderComponent<'context_menu'>\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/unified-signatures -- merging these puts two different deploy targets under one doc block\nexport function RegisterCommand(scope: 'global'): (ctor: CommandCtor) => void;\n\n/**\n * Registers a command in the guilds you pass. These ids replace `commands.guilds`. Include\n * `'config'` among them to keep that list too.\n *\n * @decorator\n * @example\n * ```typescript\n * \\@RegisterCommand('guild', ['config', '123456789'])\n * class AdminCommand extends BuilderComponent<'command'> {} // or BuilderComponent<'context_menu'>\n * ```\n */\nexport function RegisterCommand(scope: 'guild', guilds: GuildTarget[]): (ctor: CommandCtor) => void;\n\nexport function RegisterCommand(scope: CommandScope = 'config', guilds: GuildTarget[] = []) {\n    return (ctor: CommandCtor): void => {\n        const existingMeta = Reflect.getOwnMetadata(CommandMetadataKey, ctor) as CommandMeta | undefined;\n        if (existingMeta) {\n            throw new SeedcordTypeError(SeedcordErrorCode.DecoratorCommandAlreadyRegistered, [\n                ctor.name,\n                decoratorCall(existingMeta.scope),\n                decoratorCall(scope)\n            ]);\n        }\n\n        if (scope === 'global' && guilds.length > 0) {\n            throw new SeedcordTypeError(SeedcordErrorCode.DecoratorCommandGlobalWithGuilds, [ctor.name]);\n        }\n\n        if (scope === 'guild' && (!Array.isArray(guilds) || guilds.length === 0)) {\n            throw new SeedcordTypeError(SeedcordErrorCode.DecoratorCommandGuildWithoutGuilds, [ctor.name]);\n        }\n\n        const meta: CommandMeta = scope === 'guild' ? { scope, guilds } : { scope };\n        Reflect.defineMetadata(CommandMetadataKey, meta, ctor);\n    };\n}\n\nfunction decoratorCall(scope: CommandScope): string {\n    if (scope === 'global') return \"@RegisterCommand('global')\";\n    if (scope === 'guild') return \"@RegisterCommand('guild', [...])\";\n\n    return '@RegisterCommand()';\n}\n","import 'reflect-metadata';\n\nimport { decodeFor } from '@seedcord/custom-id';\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordTypeError } from '@seedcord/errors/internal';\n\nimport type { ComponentDefsBrand } from '#src/decorators/brands';\nimport type { AnyCustomId, DecodedParams } from '@seedcord/custom-id';\nimport type { Promisable } from 'type-fest';\n\n/**\n * route decorators store a handler's customId defs here, so the component base can decode\n * against them at runtime.\n *\n * @internal\n */\n// storeComponentRoute writes this beside the route keys in metadataKeys.ts\nexport const ComponentDefsKey = Symbol.for('seedcord:custom-id:component-defs');\n\n/**\n * the phantom a component handler base carries. a route decorator constrains its argument to this, so\n * passing different defs to the decorator and the handler's generic is a compile error. never set at runtime.\n *\n * @internal\n */\nexport interface HasComponentDefs<Defs extends readonly AnyCustomId[]> {\n    /** @internal */\n    readonly [ComponentDefsBrand]?: Defs;\n}\n\n/** @internal */\nexport interface DecodedComponentRoute {\n    prefix: string;\n    params: Record<string, unknown>;\n}\n\n/**\n * throws `CustomIdHandlerRouteMissing` when the class has no stored defs. a drifted or corrupt wire\n * throws `StaleCustomId` or `InvalidCustomId`.\n *\n * @internal\n */\nexport function decodeComponentRoute(handlerClass: { name: string }, wire: string): DecodedComponentRoute {\n    const defs = Reflect.getMetadata(ComponentDefsKey, handlerClass) as readonly AnyCustomId[] | undefined;\n    if (!defs) throw new SeedcordTypeError(SeedcordErrorCode.CustomIdHandlerRouteMissing, [handlerClass.name]);\n    return decodeFor(defs, wire);\n}\n\n/** @internal */\nexport type SingleParams<Defs extends readonly AnyCustomId[]> = Defs extends readonly [infer One extends AnyCustomId]\n    ? DecodedParams<One['shape']>\n    : never;\n\n/** @internal */\nexport type MatchArms<Defs extends readonly AnyCustomId[], Ret> = {\n    [Def in Defs[number] as Def['prefix']]: (params: DecodedParams<Def['shape']>) => Promisable<Ret>;\n};\n","import 'reflect-metadata';\n\nimport { isStringArray } from '@seedcord/utils/internal';\nimport { ApplicationCommandType } from 'discord-api-types/v10';\n\nimport { ComponentDefsKey } from '#customId/routing';\nimport { InteractionMetadataKey, InteractionRouteKeys, InteractionKind } from '#src/metadataKeys';\n\nimport type { ContextMenuKind } from '#registries/ContextMenuRegistry';\nimport type { AnyCustomId } from '@seedcord/custom-id';\n\n// loose on purpose, each transport's typed decorators pass their asserted ctors straight in\nexport type RoutableConstructor = new (...args: never[]) => unknown;\n\n// the build's manifest emitter reads the same pairs\nexport function interactionRoutesOf(constructor: RoutableConstructor): [InteractionKind, string[]][] {\n    const pairs: [InteractionKind, string[]][] = [];\n    for (const route of Object.values(InteractionKind)) {\n        const meta: unknown = Reflect.getMetadata(InteractionRouteKeys[route], constructor);\n        if (isStringArray(meta)) pairs.push([route, meta]);\n    }\n    return pairs;\n}\n\nexport function storeInteractionRoute(\n    route: InteractionKind,\n    routes: string | readonly string[],\n    constructor: RoutableConstructor\n): void {\n    const key = InteractionRouteKeys[route];\n    const saved: unknown = Reflect.getMetadata(key, constructor);\n    const existing = isStringArray(saved) ? saved : [];\n    const toStore = typeof routes === 'string' ? [routes] : routes;\n    Reflect.defineMetadata(key, [...existing, ...toStore], constructor);\n    Reflect.defineMetadata(InteractionMetadataKey, true, constructor);\n}\n\nexport function storeComponentRoute(\n    route: InteractionKind,\n    defs: readonly AnyCustomId[],\n    constructor: RoutableConstructor\n): void {\n    storeInteractionRoute(\n        route,\n        defs.map((def) => def.prefix),\n        constructor\n    );\n    Reflect.defineMetadata(ComponentDefsKey, defs, constructor);\n}\n\nexport function contextMenuRouteOf(kind: ContextMenuKind): InteractionKind {\n    return kind === ApplicationCommandType.User ? InteractionKind.UserContextMenu : InteractionKind.MessageContextMenu;\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordTypeError } from '@seedcord/errors/internal';\n\nimport { InteractionMiddlewareMetadataKey } from '#src/metadataKeys';\n\nimport type { MiddlewareKind } from '#src/metadataKeys';\nimport type { MiddlewareKindsBrand } from './brands';\nimport type { Constructor, NonEmptyTuple } from 'type-fest';\n\n/** @internal */\nexport type AnyMiddlewareCtor = Constructor<unknown, never[]>;\n\n// core cannot import the transport's middleware base. the kinds arrive on a phantom brand.\ntype KindsOf<TCtor extends AnyMiddlewareCtor> =\n    InstanceType<TCtor> extends { [MiddlewareKindsBrand]?: infer Kind extends MiddlewareKind } ? Kind : never;\n\ntype AssertMiddlewareKinds<Kinds extends MiddlewareKind, TCtor extends AnyMiddlewareCtor> = [Kinds] extends [\n    KindsOf<TCtor>\n]\n    ? [KindsOf<TCtor>] extends [Kinds]\n        ? TCtor\n        : Constructor<\n              ['the middleware generic declares a kind that RegisterInteractionMiddleware omits', KindsOf<TCtor>]\n          >\n    : Constructor<['RegisterInteractionMiddleware lists a kind that the middleware generic omits', Kinds]>;\n\n/** Registration options for an interaction middleware. */\nexport interface InteractionMiddlewareOptions<Kinds extends NonEmptyTuple<MiddlewareKind>> {\n    /**\n     * Restrict this middleware to certain interaction kinds. The middleware's generic must list the same\n     * kinds, or applying the decorator is a compile error. Omit it to run on every repliable kind.\n     */\n    readonly kinds?: Kinds;\n    /**\n     * Lower runs earlier. Two middleware sharing a priority run in registration order.\n     *\n     * @defaultValue 0\n     */\n    readonly priority?: number;\n}\n\n/** @internal */\nexport interface InteractionMiddlewareMetadata {\n    readonly priority: number;\n    readonly kinds?: readonly MiddlewareKind[];\n}\n\n/**\n * Registers an interaction middleware. It runs after the dispatcher builds the handler and before its\n * gates, over that handler's reply surface.\n *\n * @param options - The kinds this middleware runs on and its ordering.\n * @decorator\n *\n * @example\n * ```ts\n * \\@RegisterInteractionMiddleware({ kinds: [InteractionKind.Button], priority: 10 })\n * class Audit extends InteractionMiddleware<InteractionKind.Button> {\n *     async execute() {\n *         this.logger.info(this.dispatch.routeId);\n *     }\n * }\n * ```\n *\n * @throws A **SeedcordTypeError** when `priority` is not a finite number.\n */\nexport function RegisterInteractionMiddleware<\n    const Kinds extends NonEmptyTuple<MiddlewareKind> = NonEmptyTuple<MiddlewareKind>\n>(options: InteractionMiddlewareOptions<Kinds> = {}) {\n    return function <TCtor extends AnyMiddlewareCtor>(ctor: AssertMiddlewareKinds<Kinds[number], TCtor>): void {\n        const priority = Number(options.priority ?? 0);\n        if (!Number.isFinite(priority))\n            throw new SeedcordTypeError(SeedcordErrorCode.DecoratorInvalidMiddlewarePriority, [\n                ctor.name,\n                String(options.priority)\n            ]);\n        if (options.kinds?.length === 0)\n            throw new SeedcordTypeError(SeedcordErrorCode.DecoratorEmptyMiddlewareFilter, [ctor.name, 'kinds']);\n\n        const metadata: InteractionMiddlewareMetadata = {\n            priority,\n            ...(options.kinds && { kinds: options.kinds })\n        };\n\n        Reflect.defineMetadata(InteractionMiddlewareMetadataKey, metadata, ctor);\n    };\n}\n\n/** @internal */\nexport function interactionMiddlewareMetaOf(constructor: AnyMiddlewareCtor): InteractionMiddlewareMetadata | undefined {\n    const saved: unknown = Reflect.getMetadata(InteractionMiddlewareMetadataKey, constructor);\n    return saved as InteractionMiddlewareMetadata | undefined;\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' | 'defer' | 'deferUpdate' | 'update' | 'followUp' | 'edit' | 'delete' | 'send' | '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, and ackedBy becomes the throw cause with its stack pointing 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 { paint } from '@seedcord/errors';\nimport { Logger } from '@seedcord/logger';\nimport { asError } from '@seedcord/utils/internal';\n\nimport { PublishDefault } from '#subscribers/publishDefault';\n\nimport type { DispatchContext } from '#src/dispatch/DispatchContext';\nimport type { Bus } from '#subscribers/Bus';\nimport type { ReplyMethod } from './ackLegality';\n\nlet replyLogger: Logger | undefined;\nfunction logger(): Logger {\n    replyLogger ??= new Logger('Reply', { channel: 'interactions' });\n    return replyLogger;\n}\n\nexport interface ReplyTelemetry {\n    readonly bus: Bus;\n    readonly dispatch: DispatchContext;\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\ninterface WriteStart {\n    readonly method: WriteMethod;\n    // performance.now() captured before the write began\n    readonly startedAt: number;\n}\n\ninterface SentReport extends WriteStart {\n    readonly outcome: 'sent';\n    readonly messageId: string | null;\n}\n\ninterface FailedReport extends WriteStart {\n    readonly outcome: 'failed';\n    readonly error: Error;\n}\n\nexport type ResponseReport = SentReport | FailedReport;\n\n/** @internal */\nexport function publishResponse(telemetry: ReplyTelemetry, report: ResponseReport): void {\n    const durationMs = performance.now() - report.startedAt;\n    const { routeId } = telemetry.dispatch;\n    const write = {\n        dispatchId: telemetry.dispatch.id,\n        routeId,\n        interactionId: telemetry.interactionId,\n        method: report.method,\n        durationMs\n    };\n    telemetry.bus[PublishDefault](\n        'responseAttempted',\n        report.outcome === 'failed'\n            ? { ...write, outcome: 'failed', messageId: null, error: report.error }\n            : { ...write, outcome: 'sent', messageId: report.messageId }\n    );\n\n    // after publish so a throwing sink doesn't reach the publish above\n    logger().trace(\n        `${paint.sky.bold(routeId)} ${report.method} ${report.outcome} ${paint.mute('in')} ${Math.round(durationMs)}ms`\n    );\n}\n\nexport async function reportedWrite<Result>(\n    telemetry: ReplyTelemetry,\n    method: WriteMethod,\n    write: () => Promise<Result>\n): Promise<Result> {\n    const startedAt = performance.now();\n    const result = await attemptWrite(telemetry, method, startedAt, write);\n    publishResponse(telemetry, { method, startedAt, outcome: 'sent', messageId: null });\n    return result;\n}\n\n// publishes the failed arm when write() throws, since the caller's success report sits after the write and a throw skips it\nexport async function attemptWrite<Result>(\n    telemetry: ReplyTelemetry,\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, { method, startedAt, outcome: 'failed', error });\n        // rethrown raw\n        throw caught;\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { pluralize } from '@seedcord/utils/internal';\n\nconst allOf = new Intl.ListFormat('en', { type: 'conjunction' });\n\n// shapeshift aggregate errors nest, so 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} ${pluralize(Number(limit), unit)}`;\n    });\n    return allOf.format(phrases);\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\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// a shapeshift throw becomes an actionable message with the cause kept, while anything else contributes its own message as the detail\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\nexport interface SerializedReply<TNative = never> {\n    readonly components: APIMessageTopLevelComponent[];\n    readonly allowedMentions?: ReplyResponse['allowedMentions'];\n    readonly files?: ReplyResponse<TNative>['files'];\n}\n\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 'toJSON' in component ? component.toJSON() : component;\n        } catch (error) {\n            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- untyped code can pass null, and a null-prototype value has no constructor\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 type { CoreBase } from '#interfaces/CoreBase';\nimport type { DispatchContext } from '#src/dispatch/DispatchContext';\n\n/**\n * The transport-agnostic gate context, the scalar identity of the acting user resolvable from any\n * transport's payload. Every field except `core` is nullable, since an event or DM may carry no\n * guild or member. Each transport extends it with its own arm. For example, the gateway adds the djs\n * `user`/`guild`/`member` objects and the live interaction or event payload.\n *\n * @example\n * ```ts\n * // a gate reading only the base fields fits any handler on any transport\n * const NeedsGuild = defineGate('NeedsGuild', (ctx: GateContextBase) => {\n *     if (!ctx.guildId) throw new NotInGuild();\n * });\n * ```\n */\nexport interface GateContextBase {\n    /** Gates read the config and the rate limiter through it. */\n    readonly core: CoreBase;\n    /** The acting user's id, or null on an event that carries none. */\n    readonly userId: string | null;\n    /** The guild id, or null outside a guild. */\n    readonly guildId: string | null;\n    /** The channel id, or null when the source carries none. */\n    readonly channelId: string | null;\n    /**\n     * The member's role ids without the everyone role, the shape a raw interaction payload\n     * contains. Empty outside a guild or when the source contains none.\n     */\n    readonly memberRoleIds: readonly string[];\n    /**\n     * The member's permission bits, or null outside a guild. On an interaction these are the\n     * channel-scoped permissions the payload contains, and on a gateway event they're the member's guild-level ones.\n     */\n    readonly memberPermissions: bigint | null;\n    /**\n     * The bot's permissions in the invoked channel, the wire `app_permissions` value. Null on gateway events.\n     */\n    readonly appPermissions: bigint | null;\n    /**\n     * The handler's own route, as `kind:route` (`slash:daily`, `button:confirm`). A handler registered\n     * on several reports the one this dispatch matched. Null when the handler declares none, which\n     * covers a plain event handler, the unhandled default, and a gate run outside a handler.\n     */\n    readonly declaredRoute: string | null;\n    /**\n     * The bag for this dispatch, the same instance the handler and its middleware hold. Every middleware\n     * runs before the first gate. A gate therefore reads what a middleware wrote.\n     */\n    readonly dispatch: DispatchContext;\n}\n\n/**\n * The context the guild-scoped permission gates require. It adds the base permission sets computed from\n * roles alone, which only the gateway transport can provide from its cache. The http transport's context\n * does not define these fields.\n *\n * @example\n * ```ts\n * // in:'guild' returns a Gate<GuildPermissionsContext>, which fits only a gateway handler\n * \\@Gated(RequirePermissions([PermissionFlagsBits.BanMembers], { in: 'guild' }))\n * ```\n */\nexport interface GuildPermissionsContext extends GateContextBase {\n    /**\n     * The member's base permission set, roles only, matching djs `GuildMember.permissions`. Null when the\n     * member is unavailable.\n     */\n    readonly memberGuildPermissions: bigint | null;\n    /**\n     * The bot's base permission set from the transport's cache. Null when the cached member is unavailable.\n     */\n    readonly appGuildPermissions: bigint | null;\n}\n\n// phantom brand rejects a bare check function or plain object where a Gate is expected\ndeclare const GateBrand: unique symbol;\n\n/**\n * A precondition attached to a handler. It refuses by throwing a `Notice` (a reply) or a `Silence`\n * (a drop with no reply), and passes by returning. `Ctx` is the context it requires, so a gate that reads\n * a field absent on a handler's context is rejected at compile time. `Name` is captured as a literal so\n * a mismatch error can name the gate. Build one with {@link defineGate} or {@link defineEffectGate}.\n *\n * @typeParam Ctx - The context the gate requires. A field missing from it is a compile error.\n * @typeParam Name - The gate's literal name, named in a mismatch error.\n *\n * @example\n * ```ts\n * // a factory returning a typed, agnostic gate\n * function MyGate(): Gate<GateContextBase, 'MyGate'> {\n *     return defineGate('MyGate', (ctx) => {\n *         if (shouldRefuse(ctx)) throw new MyNotice();\n *     });\n * }\n * ```\n *\n * @see {@link defineGate}\n */\nexport interface Gate<Ctx extends GateContextBase = GateContextBase, Name extends string = string> {\n    /** The gate's name, surfaced in a mismatch error and joined by the combinators. */\n    readonly name: Name;\n    /** Reads the context and refuses by throwing a Notice or a Silence, or passes by resolving. */\n    check(ctx: Ctx): Promise<void>;\n\n    /** @internal */\n    readonly [GateBrand]: true;\n}\n\n/**\n * A gate whose `check` method can refuse a request without applying its side effect. `commit` applies\n * the effect after every gate passes. {@link Cooldown} is the catalog gate that returns one. Build one with\n * {@link defineEffectGate}.\n *\n * @typeParam Ctx - The context both `check` and `commit` require. A field missing from it fails to compile.\n * @typeParam Name - The literal name a mismatch error prints.\n *\n * @example\n * ```ts\n * // a factory returning a typed effect gate\n * function MyEffectGate(): EffectGate<GateContextBase, 'MyEffectGate'> {\n *     return defineEffectGate(\n *         'MyEffectGate',\n *         (ctx) => {\n *             if (shouldRefuse(ctx)) throw new MyNotice();\n *         },\n *         (ctx) => {\n *             applyMyEffect(ctx);\n *         }\n *     );\n * }\n * ```\n *\n * @see {@link defineEffectGate}\n */\nexport interface EffectGate<Ctx extends GateContextBase = GateContextBase, Name extends string = string> extends Gate<\n    Ctx,\n    Name\n> {\n    /** Applies the side effect, run only after the whole gate set passes. */\n    commit(ctx: Ctx): Promise<void>;\n}\n\n/**\n * Builds a {@link Gate} from a check. The check refuses by throwing a Notice or a Silence and passes\n * by returning. The required context is inferred from `ctx`, so annotate it as narrowly as the fields\n * the check reads. No annotation defaults to {@link GateContextBase}, an agnostic gate that fits every\n * handler.\n *\n * @typeParam Name - The gate's name, captured as a literal for mismatch errors.\n * @typeParam Ctx - The context the check reads, inferred from the `ctx` annotation.\n *\n * @param name - The gate's name, used in mismatch errors.\n * @param fn - The check, which refuses by throwing a Notice or a Silence and passes by returning.\n *\n * @see {@link defineEffectGate}\n * @see the `@Gated` decorator from your transport package\n *\n * @example\n * ```ts\n * // a gate factory that takes its own option and closes over it\n * function MinRoles(min: number): Gate<GateContextBase, 'MinRoles'> {\n *     return defineGate('MinRoles', (ctx) => {\n *         if (ctx.memberRoleIds.length < min) throw new NotEnoughRoles(min);\n *     });\n * }\n * ```\n *\n * @example\n * ```ts\n * // agnostic gate (no ctx annotation): fits any handler\n * const Owner = defineGate('owner', (ctx) => {\n *     if (!ctx.userId) throw new NotOwner();\n * });\n * ```\n */\nexport function defineGate<const Name extends string, Ctx extends GateContextBase = GateContextBase>(\n    name: Name,\n    fn: (ctx: Ctx) => void | Promise<void>\n): Gate<Ctx, Name> {\n    return { name, check: async (ctx) => fn(ctx) } as Gate<Ctx, Name>;\n}\n\n/**\n * Builds an {@link EffectGate} from a `check` and a `commit`. `check` peeks and refuses by throwing, and\n * `commit` applies the side effect, running only once the whole gate set passes so a later refusal never\n * commits. In an `or`, a refusing arm's queued commit is rolled back. This is how {@link Cooldown} peeks\n * in `check` and charges the slot in `commit`.\n *\n * @typeParam Name - The gate's literal name, used to name a mismatch error.\n * @typeParam Ctx - The context both `check` and `commit` read, inferred from the `ctx` annotation.\n *\n * @param name - The gate's name, used in mismatch errors.\n * @param check - Peeks and refuses by throwing, without applying the side effect.\n * @param commit - Applies the side effect, running only after the whole gate set passes.\n *\n * @see {@link defineGate}\n * @see the `@Gated` decorator from your transport package\n * @see {@link Cooldown}\n *\n * @example\n * ```ts\n * // an effect-gate factory that takes its own limit and closes over it\n * function UsesPerDay(max: number): EffectGate<GateContextBase, 'UsesPerDay'> {\n *     return defineEffectGate(\n *         'UsesPerDay',\n *         (ctx) => {\n *             // peek and refuse by throwing. do not mutate yet\n *             if (usedToday(ctx.userId) >= max) throw new OutOfUsesNotice(max);\n *         },\n *         (ctx) => {\n *             // runs only after the whole gate set passes\n *             recordUse(ctx.userId);\n *         }\n *     );\n * }\n * ```\n */\nexport function defineEffectGate<const Name extends string, Ctx extends GateContextBase = GateContextBase>(\n    name: Name,\n    check: (ctx: Ctx) => void | Promise<void>,\n    commit: (ctx: Ctx) => void | Promise<void>\n): EffectGate<Ctx, Name> {\n    return {\n        name,\n        check: async (ctx) => check(ctx),\n        commit: async (ctx) => commit(ctx)\n    } as EffectGate<Ctx, Name>;\n}\n\n/**\n * The context a {@link Gate} requires.\n *\n * @typeParam TGate - The gate type to read the required context from.\n *\n * @example\n * ```ts\n * type OwnerCtx = RequiredOf<ReturnType<typeof OwnerOnly>>; // GateContextBase\n * ```\n */\nexport type RequiredOf<TGate> = TGate extends Gate<infer Ctx> ? Ctx : never;\n","import { toEpochSeconds } from '@seedcord/utils';\n\nimport { Notice } from '#stops/Notice';\nimport { NoticeCard } from '#stops/NoticeCard';\n\nimport type { EpochMs, ReplyResponse } from '@seedcord/types';\n\nexport abstract class GateNotice extends Notice {\n    public render(): ReplyResponse {\n        return { components: [new NoticeCard(this.message).component] };\n    }\n}\n\nexport class NotOwner extends GateNotice {\n    public constructor(message = 'Only the bot owner can use this.') {\n        super(message);\n        this.summary = 'be the bot owner';\n    }\n}\n\nexport class NotInGuild extends GateNotice {\n    public constructor(message = 'This can only be used in a server.') {\n        super(message);\n        this.summary = 'be in a server';\n    }\n}\n\nexport class NotInDm extends GateNotice {\n    public constructor(message = 'This can only be used in a direct message.') {\n        super(message);\n        this.summary = 'be in a direct message';\n    }\n}\n\nfunction retryAt(resetAt: EpochMs): string {\n    return `<t:${toEpochSeconds(resetAt)}:R>`;\n}\n\nexport class OnCooldown extends GateNotice {\n    public constructor(\n        public readonly resetAt: EpochMs,\n        message?: string\n    ) {\n        super(message ?? `You are doing that too fast. Try again ${retryAt(resetAt)}.`);\n        this.summary = `try again ${retryAt(resetAt)}`;\n    }\n}\n\nexport class NotAllowed extends Notice {\n    public constructor() {\n        super('not allowed');\n    }\n\n    public render(): ReplyResponse {\n        return { components: [new NoticeCard('You are not allowed to use this command.').component] };\n    }\n}\n\nexport class NeedsAny extends Notice {\n    private readonly summaries: readonly string[];\n\n    public constructor(summaries: readonly string[]) {\n        super('not allowed');\n        // two arms can refuse with the same summary\n        this.summaries = [...new Set(summaries)];\n    }\n\n    public render(): ReplyResponse {\n        const bullets = this.summaries.map((summary) => `• ${summary}`).join('\\n');\n        return { components: [new NoticeCard(`You need to meet at least one of these:\\n${bullets}`).component] };\n    }\n}\n\nexport class MissingRole extends GateNotice {\n    public constructor(message: string | undefined, roleId: string | null) {\n        super(\n            message ?? (roleId ? `You need the <@&${roleId}> role to use this.` : 'You do not have the required role.')\n        );\n        this.summary = roleId ? `hold the <@&${roleId}> role` : 'hold the required role';\n    }\n}\n\nexport class MissingPermissions extends Notice {\n    private readonly customLead: string | undefined;\n\n    public constructor(\n        message: string | undefined,\n        private readonly subject: string | null,\n        private readonly missingPerms: readonly string[]\n    ) {\n        super(message ?? 'A required permission is missing.');\n        this.customLead = message;\n        const names = missingPerms.join(', ');\n        this.summary = subject === null ? `hold ${names}` : `${subject} needs ${names}`;\n    }\n\n    public render(): ReplyResponse {\n        const bullets = this.missingPerms.map((perm) => `• ${perm}`).join('\\n');\n        const lead =\n            this.customLead ??\n            `${this.subject === null ? 'You are' : `${this.subject} is`} missing the following permission entries:`;\n        return {\n            components: [new NoticeCard(`${lead}\\n${bullets}`).component]\n        };\n    }\n}\n\nexport class HasDangerousPermissions extends Notice {\n    private readonly customLead: string | undefined;\n\n    public constructor(\n        message: string | undefined,\n        private readonly subject: string,\n        private readonly dangerousPerms: readonly string[]\n    ) {\n        super(message ?? 'A dangerous permission is enabled.');\n        this.customLead = message;\n        this.summary = `${subject} must not hold ${dangerousPerms.join(', ')}`;\n    }\n\n    public render(): ReplyResponse {\n        const bullets = this.dangerousPerms.map((perm) => `• ${perm}`).join('\\n');\n        const lead =\n            this.customLead ?? `${this.subject} has the following permission entries that must not be enabled:`;\n        return {\n            components: [new NoticeCard(`${lead}\\n${bullets}`).component]\n        };\n    }\n}\n","import type { EffectGate, Gate, GateContextBase } from './Gate';\n\ntype CommitFn = () => Promise<void>;\n\n// commits wait here until the whole gate set passes, one queue per request. the key is the context\n// itself and the map is weak, so an entry goes when its request does\nconst commitQueues = new WeakMap<GateContextBase, CommitFn[]>();\n\nfunction isEffectGate(gate: Gate<GateContextBase>): gate is EffectGate<GateContextBase> {\n    return typeof (gate as Partial<EffectGate<GateContextBase>>).commit === 'function';\n}\n\n// a refused effect gate never commits. combinators call this too\nexport async function runCheck(gate: Gate<GateContextBase>, ctx: GateContextBase): Promise<void> {\n    await gate.check(ctx);\n    if (!isEffectGate(gate)) return;\n\n    let queue = commitQueues.get(ctx);\n    if (!queue) {\n        queue = [];\n        commitQueues.set(ctx, queue);\n    }\n    queue.push(() => gate.commit(ctx));\n}\n\nexport async function runCommits(ctx: GateContextBase): Promise<void> {\n    const queue = commitQueues.get(ctx);\n    if (!queue) return;\n    for (const commit of queue) await commit();\n}\n\n// the runner calls this from a finally, refused run or not\nexport function discardCommits(ctx: GateContextBase): void {\n    commitQueues.delete(ctx);\n}\n\n// an `or` arm takes this mark before it runs\nexport function markCommits(ctx: GateContextBase): number {\n    return commitQueues.get(ctx)?.length ?? 0;\n}\n\n// and rolls back to it when the arm refuses, leaving no commit behind\nexport function rollbackCommits(ctx: GateContextBase, mark: number): void {\n    const queue = commitQueues.get(ctx);\n    if (queue && queue.length > mark) queue.length = mark;\n}\n","import type { Notice } from '#stops/Notice';\n\n/**\n * The override a catalog gate accepts. A one-line `message` reword or a full `notice` replacement. Accepted by\n * the agnostic catalog gates and, nested per refusal, by {@link RequireRole}. {@link RequirePermissions} and\n * {@link RequireBotPermissions} take `RequirePermissionsOptions` instead.\n *\n * @example\n * ```ts\n * // reword the default refusal\n * OwnerOnly({ message: 'Bot owners only.' });\n * ```\n *\n * @example\n * ```ts\n * // replace the refusal entirely, for example a translated Notice\n * GuildOnly({ notice: new MyTranslatedNotice() });\n * ```\n */\nexport interface GateNoticeOptions {\n    /** Reword the default refusal, keeping its embed styling. */\n    message?: string;\n    /** Replace the default refusal Notice entirely, for full control or a translated copy. */\n    notice?: Notice;\n}\n\nexport function pickNotice(options: GateNoticeOptions | undefined, makeDefault: (message?: string) => Notice): Notice {\n    return options?.notice ?? makeDefault(options?.message);\n}\n","import { prettify } from '@seedcord/utils';\nimport { PermissionFlagsBits } from 'discord-api-types/v10';\n\n/**\n * The permission flag bits a caller or the bot must hold. Pass the `PermissionFlagsBits` values from\n * `discord-api-types/v10` (or `discord.js`).\n */\nexport type PermissionScope = readonly bigint[];\n\n// permission bit to its prettified human-readable name\nexport const PermissionNames = new Map<bigint, string>(\n    Object.entries(PermissionFlagsBits).map(([key, bit]) => [bit, prettify(key)])\n);\n\nconst ADMINISTRATOR = PermissionFlagsBits.Administrator;\n\nfunction nameOf(bit: bigint): string {\n    return PermissionNames.get(bit) ?? String(bit);\n}\n\n// discord treats the administrator bit as granting every permission\nfunction holds(held: bigint, bit: bigint): boolean {\n    return (held & ADMINISTRATOR) === ADMINISTRATOR || (held & bit) === bit;\n}\n\n/** @internal */\nexport function hasAll(held: bigint, scope: PermissionScope): boolean {\n    return scope.every((bit) => holds(held, bit));\n}\n\n/** @internal only reached once hasAll failed, so the administrator bit is absent */\nexport function missingNames(held: bigint, scope: PermissionScope): string[] {\n    return scope.reduce<string[]>((names, bit) => {\n        if ((held & bit) !== bit) names.push(nameOf(bit));\n        return names;\n    }, []);\n}\n\n/** @internal */\nexport function presentNames(held: bigint, scope: PermissionScope): string[] {\n    return scope.reduce<string[]>((names, bit) => {\n        if (holds(held, bit)) names.push(nameOf(bit));\n        return names;\n    }, []);\n}\n","import { defineGate } from '#gates/Gate';\nimport { MissingPermissions, MissingRole, NotInGuild } from '#notices/index';\nimport { hasAll, missingNames } from '#src/permissions/bits';\n\nimport { pickNotice } from './options';\n\nimport type { Gate, GateContextBase, GuildPermissionsContext } from '#gates/Gate';\nimport type { PermissionScope } from '#src/permissions/bits';\nimport type { GateNoticeOptions } from './options';\n\nexport type { PermissionScope } from '#src/permissions/bits';\nexport { PermissionNames } from '#src/permissions/bits';\n\ninterface PermCheckKind {\n    unresolved: string;\n    subject: string | null;\n}\n\nconst MEMBER_CHECK: PermCheckKind = {\n    unresolved: 'Your server member data could not be resolved. Try again.',\n    subject: null\n};\nconst BOT_CHECK: PermCheckKind = {\n    unresolved: \"The bot's permissions could not be resolved. Try again.\",\n    subject: 'The bot'\n};\n\nfunction refusePermissions(\n    held: bigint | null,\n    scope: PermissionScope,\n    options: RequirePermissionsOptions | undefined,\n    guildId: string | null,\n    kind: PermCheckKind\n): void {\n    if (held === null) {\n        throw pickNotice(\n            options?.notInGuild,\n            (message) => new NotInGuild(message ?? (guildId ? kind.unresolved : undefined))\n        );\n    }\n    if (hasAll(held, scope)) return;\n    throw pickNotice(\n        options?.missing,\n        (message) => new MissingPermissions(message, kind.subject, missingNames(held, scope))\n    );\n}\n\n/**\n * Options for {@link RequirePermissions} and {@link RequireBotPermissions}.\n */\nexport interface RequirePermissionsOptions {\n    /**\n     * The set the check reads. `'channel'` reads the effective channel set the payload carries, what\n     * Discord enforces in the invoked channel. `'guild'` reads the base set from roles, available on the\n     * gateway transport only.\n     *\n     * @defaultValue `'channel'`\n     */\n    in?: 'channel' | 'guild';\n    /** Reword or replace the refusal shown when the set is unavailable (outside a guild, or unresolved inside one). */\n    notInGuild?: GateNoticeOptions;\n    /** Reword or replace the refusal shown when a permission is missing. */\n    missing?: GateNoticeOptions;\n}\n\n/**\n * Options for {@link RequireRole}.\n */\nexport interface RequireRoleOptions {\n    /** Reword or replace the refusal shown outside a guild. */\n    notInGuild?: GateNoticeOptions;\n    /** Reword or replace the refusal shown when the caller lacks the role. */\n    missingRole?: GateNoticeOptions;\n}\n\n/**\n * Requires the caller to hold every permission in `scope`. Refuses outside a guild first, then when a\n * permission is missing. The Administrator bit passes any scope.\n *\n * The default `'channel'` scope reads the effective channel set the payload carries, what Discord enforces\n * in the invoked channel. The `'guild'` scope reads the base set from roles and requires a\n * {@link GuildPermissionsContext}, so it fits a gateway handler only.\n *\n * @param scope - The permission flag bits the caller must all hold.\n * @param options - Pick the scope with `in`, and override each refusal with `notInGuild` or `missing`.\n *\n * @see the `@Gated` decorator from your transport package\n *\n * @example\n * ```ts\n * import { PermissionFlagsBits } from 'discord-api-types/v10';\n *\n * \\@Gated(RequirePermissions([PermissionFlagsBits.BanMembers]))\n * \\@SlashRoute('ban')\n * class BanHandler extends SlashHandler<'ban'> {\n *     async execute() {\n *         // ...\n *     }\n * }\n * ```\n *\n * @example\n * ```ts\n * // the base set from roles, on a gateway handler\n * RequirePermissions([PermissionFlagsBits.BanMembers], { in: 'guild' });\n * ```\n */\nexport function RequirePermissions(\n    scope: PermissionScope,\n    options: RequirePermissionsOptions & { in: 'guild' }\n): Gate<GuildPermissionsContext, 'RequirePermissions'>;\nexport function RequirePermissions(\n    scope: PermissionScope,\n    options?: RequirePermissionsOptions & { in?: 'channel' }\n): Gate<GateContextBase, 'RequirePermissions'>;\nexport function RequirePermissions(\n    scope: PermissionScope,\n    options?: RequirePermissionsOptions\n): Gate<GuildPermissionsContext, 'RequirePermissions'> | Gate<GateContextBase, 'RequirePermissions'> {\n    if (options?.in === 'guild') {\n        return defineGate('RequirePermissions', (ctx: GuildPermissionsContext) => {\n            refusePermissions(ctx.memberGuildPermissions, scope, options, ctx.guildId, MEMBER_CHECK);\n        });\n    }\n    return defineGate('RequirePermissions', (ctx: GateContextBase) => {\n        refusePermissions(ctx.memberPermissions, scope, options, ctx.guildId, MEMBER_CHECK);\n    });\n}\n\n/**\n * Requires the bot to hold every permission in `scope`. Refuses outside a guild first, then when a\n * permission is missing. The Administrator bit passes any scope.\n *\n * The default `'channel'` scope reads the bot's effective channel set (wire `app_permissions`), what\n * Discord enforces in the invoked channel. The `'guild'` scope reads the bot's base set from roles and\n * requires a {@link GuildPermissionsContext}, fitting a gateway handler only. `app_permissions` is\n * absent on gateway events, the channel scope refuses there as unresolved, use `in: 'guild'` on an\n * event handler.\n *\n * @param scope - The permission flag bits the bot must all hold.\n * @param options - Pick the scope with `in`, and override each refusal with `notInGuild` or `missing`.\n *\n * @see the `@Gated` decorator from your transport package\n *\n * @example\n * ```ts\n * import { PermissionFlagsBits } from 'discord-api-types/v10';\n *\n * \\@Gated(RequireBotPermissions([PermissionFlagsBits.ManageMessages]))\n * \\@SlashRoute('purge')\n * class PurgeHandler extends SlashHandler<'purge'> {\n *     async execute() {\n *         // ...\n *     }\n * }\n * ```\n */\nexport function RequireBotPermissions(\n    scope: PermissionScope,\n    options: RequirePermissionsOptions & { in: 'guild' }\n): Gate<GuildPermissionsContext, 'RequireBotPermissions'>;\nexport function RequireBotPermissions(\n    scope: PermissionScope,\n    options?: RequirePermissionsOptions & { in?: 'channel' }\n): Gate<GateContextBase, 'RequireBotPermissions'>;\nexport function RequireBotPermissions(\n    scope: PermissionScope,\n    options?: RequirePermissionsOptions\n): Gate<GuildPermissionsContext, 'RequireBotPermissions'> | Gate<GateContextBase, 'RequireBotPermissions'> {\n    if (options?.in === 'guild') {\n        return defineGate('RequireBotPermissions', (ctx: GuildPermissionsContext) => {\n            refusePermissions(ctx.appGuildPermissions, scope, options, ctx.guildId, BOT_CHECK);\n        });\n    }\n    return defineGate('RequireBotPermissions', (ctx: GateContextBase) => {\n        refusePermissions(ctx.appPermissions, scope, options, ctx.guildId, BOT_CHECK);\n    });\n}\n\n/**\n * Requires the caller to hold `roleId`, read from the member's role ids. Refuses outside a guild first,\n * then when the role is missing. Roles are guild-global, so there is no scope dimension.\n *\n * @param roleId - The role snowflake the caller must hold.\n * @param options - Override each refusal, the outside-guild one with `notInGuild` and the missing-role one with `missingRole`.\n *\n * @see the `@Gated` decorator from your transport package\n *\n * @example\n * ```ts\n * \\@Gated(RequireRole('123456789012345678'))\n * \\@SlashRoute('vip')\n * class VipHandler extends SlashHandler<'vip'> {\n *     async execute() {\n *         // ...\n *     }\n * }\n * ```\n */\nexport function RequireRole(roleId: string, options?: RequireRoleOptions): Gate<GateContextBase, 'RequireRole'> {\n    return defineGate('RequireRole', (ctx) => {\n        if (!ctx.guildId) throw pickNotice(options?.notInGuild, (message) => new NotInGuild(message));\n        if (ctx.memberRoleIds.includes(roleId)) return;\n        throw pickNotice(options?.missingRole, (message) => new MissingRole(message, roleId));\n    });\n}\n","/**\n * Throw to stop a handler with no reply and no report.\n *\n * The framework boundary catches `Silence` before {@link Notice}, makes zero Discord calls, and stops.\n * Ideally you'd only throw this in `EventHandlers` (or `Gates` for those), because it doesn't make sense to\n * leave the user with no reply for an interaction.\n *\n * @example\n * ```ts\n * import { Silence } from '@seedcord/gateway';\n *\n * // a helper under a guildMemberAdd handler, stopping when this guild configured nothing to send\n * const template = await settings.welcome(member.guild.id);\n * if (!template) throw new Silence('no welcome message set');\n * ```\n */\nexport class Silence extends Error {\n    /**\n     * @param reason - Optional note written only to a debug log, never shown to the user or reported.\n     */\n    public constructor(public readonly reason?: string) {\n        super(reason ?? 'Silence');\n\n        Error.captureStackTrace(this, this.constructor);\n    }\n}\n","import type { APIMessageComponentEmoji } from 'discord-api-types/v10';\n\n/**\n * A resolved custom emoji. Renders as `<:name:id>` in message content, or `<a:name:id>` when animated,\n * and passes straight to a builder's `setEmoji`.\n */\n// setEmoji in @discordjs/builders rejects any own key past these three, scanning with Object.entries\nexport class ResolvedEmoji implements APIMessageComponentEmoji {\n    constructor(\n        public readonly name: string,\n        public readonly id: string,\n        public readonly animated = false\n    ) {}\n\n    public toString(): string {\n        return `<${this.animated ? 'a' : ''}:${this.name}:${this.id}>`;\n    }\n}\n","import { CustomId } from '@seedcord/custom-id';\n\nimport type { CustomIdField } from '@seedcord/custom-id';\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).\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"],"mappings":"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"}