@seedcord/core 0.9.2 → 0.9.3

package/dist/node-internal.index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"node-internal.index.mjs","names":[],"sources":["../src/node/Lifecycle/drainWindow.ts","../src/node/HealthResponder.ts","../src/node/HealthCheck.ts","../src/node/subscribers/SubscriberLoader.ts","../src/commands/deployTarget.ts","../src/node/commands/CommandRegistry.ts","../src/node-internal.index.ts"],"sourcesContent":["import { settleWithin } from './withTimeout';\n\nimport type { Logger } from '@seedcord/logger';\n\n// gateway already used 5s. discord's 3s first-ack deadline is the floor.\nexport const DRAIN_WINDOW_MS = 5000;\n\nconst DRAIN_HEADROOM_MS = 1000;\nexport const DRAIN_TASK_TIMEOUT_MS = DRAIN_WINDOW_MS + DRAIN_HEADROOM_MS;\n\nexport async function drainInFlight(\n    inFlight: ReadonlySet<Promise<unknown>>,\n    timeoutMs: number,\n    logger: Logger,\n    label: string\n): Promise<void> {\n    await settleWithin(Promise.allSettled(inFlight), timeoutMs);\n    // nothing cancels these before the process exits\n    if (inFlight.size > 0) logger.warn(`${label}: ${String(inFlight.size)} still running when the drain window closed`);\n}\n","import type { IncomingMessage, ServerResponse } from 'node:http';\n\nconst HTTP_OK = 200;\nconst DEFAULT_HEALTH_CHECK_PATH = '/health';\n\nexport class HealthResponder {\n    public readonly path: string;\n\n    constructor(path?: string) {\n        this.path = path ?? DEFAULT_HEALTH_CHECK_PATH;\n    }\n\n    public tryRespond(req: IncomingMessage, res: ServerResponse): boolean {\n        if (req.method !== 'GET' || req.url !== this.path) return false;\n\n        res.writeHead(HTTP_OK, { 'Content-Type': 'application/json' });\n        res.end(JSON.stringify({ status: 'ok', timestamp: Date.now() }));\n        return true;\n    }\n}\n","import { createServer } from 'node:http';\n\nimport { paint } from '@seedcord/errors';\nimport { Logger } from '@seedcord/logger';\n\nimport { ShutdownPhase } from '#src/lifecycle/phases';\n\nimport { HealthResponder } from './HealthResponder';\n\nimport type { CoordinatedShutdown } from './Lifecycle/CoordinatedShutdown';\nimport type { HealthCheckConfig, HealthCheckOption } from '@seedcord/types';\nimport type { IncomingMessage, Server, ServerResponse } from 'node:http';\n\nconst HTTP_NOT_FOUND = 404;\n\nconst DEFAULT_HEALTH_CHECK_PORT = 6967;\n\nexport class HealthCheck {\n    public readonly logger = new Logger('HealthCheck', { channel: 'health' });\n\n    private readonly _port: number;\n    private readonly _host: string | undefined;\n\n    private readonly responder: HealthResponder;\n    private server?: Server;\n\n    constructor(shutdown: CoordinatedShutdown, options?: HealthCheckConfig) {\n        this._port = options?.port ?? DEFAULT_HEALTH_CHECK_PORT;\n        this._host = options?.host;\n        this.responder = new HealthResponder(options?.path);\n\n        shutdown.addTask(ShutdownPhase.Drain, 'stop-healthcheck-server', () => this.stop());\n    }\n\n    public get port(): number {\n        return this._port;\n    }\n\n    public get host(): string | undefined {\n        return this._host;\n    }\n\n    public get path(): string {\n        return this.responder.path;\n    }\n\n    public static fromOption(shutdown: CoordinatedShutdown, option?: HealthCheckOption): HealthCheck | undefined {\n        if (option === false) return undefined;\n        return new HealthCheck(shutdown, typeof option === 'object' ? option : undefined);\n    }\n\n    public async init(): Promise<void> {\n        return new Promise<void>((resolve, reject) => {\n            const server = createServer((req: IncomingMessage, res: ServerResponse) => {\n                if (this.responder.tryRespond(req, res)) return;\n\n                res.writeHead(HTTP_NOT_FOUND, { 'Content-Type': 'application/json' });\n                res.end(JSON.stringify({ status: 'not found' }));\n            });\n            this.server = server;\n\n            const onListenError = (err: Error): void => reject(err);\n            server.on('error', onListenError);\n\n            server.once('listening', () => {\n                // a late error would reject an already-settled promise, and node throws process-wide without a listener here\n                server.removeListener('error', onListenError);\n                server.on('error', (err) => this.logger.error('Health check server error', err));\n\n                // binds all interfaces, so log an address a browser can open\n                const address = this._host ?? 'localhost';\n                this.logger.info(\n                    `${paint.mint.bold('✔︎')} Health check server listening on ${paint.sky.bold(`http://${address}:${this._port}${this.path}`)}`\n                );\n                resolve();\n            });\n\n            if (this._host) {\n                this.logger.debug(`Binding health check server to ${this._host}`);\n                server.listen(this._port, this._host);\n            } else {\n                this.logger.debug('Binding health check server to all interfaces');\n                server.listen(this._port);\n            }\n        });\n    }\n\n    public stop(): Promise<void> {\n        const server = this.server;\n        // close() on a non-listening server invokes its callback with ERR_SERVER_NOT_RUNNING and\n        // never fires 'close', so without this guard the promise would hang the shutdown phase.\n        if (!server?.listening) return Promise.resolve();\n\n        return new Promise((resolve, reject) => {\n            // settle only in the callback, a 'close'-event resolve would swallow the callback's error\n            server.close((err) => {\n                if (err) {\n                    reject(err);\n                    return;\n                }\n                this.logger.info(paint.coral.bold('Health check server stopped'));\n                resolve();\n            });\n        });\n    }\n}\n","import { paint } from '@seedcord/errors';\nimport { traverseDirectory } from '@seedcord/utils/node';\nimport { Envapter } from 'envapt';\n\nimport { HmrModuleHandler } from '#hmr/HmrModuleHandler';\nimport { SubscribeMetadataKey } from '#src/metadataKeys';\nimport { busLoggerOf } from '#subscribers/Bus';\nimport { registrationFor, Subscriber } from '#subscribers/index';\nimport {\n    RegisterDefaults,\n    RegisteredCount,\n    RegisterSubscriber,\n    UnregisterSubscriber,\n    VerifyWebhooks\n} from '#subscribers/slots';\n\nimport type { Initializeable } from '#src/plugin/Plugin';\nimport type { SubscribeMetadataEntry } from '#subscribers/decorators/Subscribe';\nimport type { StoredSubscriberCtor, Bus } from '#subscribers/index';\nimport type { SubscriptionKey } from '#subscribers/types/Subscriptions';\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\n\ntype SubscriberArtifact = SubscriptionKey[];\n\n// loads subscribers off the filesystem into a Bus and stores their hot-reload wiring. node only, a bundled isolate registers from the manifest instead\nexport class SubscriberLoader implements Initializeable, HmrAware {\n    private isInitialized = false;\n    private readonly hmrHandler?: HmrModuleHandler<StoredSubscriberCtor, void, SubscriberArtifact>;\n\n    constructor(\n        private readonly bus: Bus,\n        private readonly directory: string | null\n    ) {\n        if (!this.directory) return;\n        if (!Envapter.isDevelopment && !Envapter.isTest) return;\n\n        this.hmrHandler = new HmrModuleHandler({\n            handlersDir: this.directory,\n            isHandler: this.isSubscriber.bind(this),\n            registerHandler: this.registerSubscriber.bind(this),\n            unregisterHandler: this.unregisterSubscriber.bind(this),\n            getArtifacts: this.getArtifacts.bind(this),\n            logger: busLoggerOf(this.bus)\n        });\n    }\n\n    /** @internal */\n    public async init(): Promise<void> {\n        if (this.isInitialized) return;\n        this.isInitialized = true;\n\n        this.bus[RegisterDefaults]();\n\n        const { directory } = this;\n        if (directory) {\n            busLoggerOf(this.bus).debug(paint.mute(directory));\n            await this.load(directory);\n            busLoggerOf(this.bus).utils.list(\n                [`${paint.iris.bold(this.bus[RegisteredCount])} subscribers`],\n                paint.mint.bold('Loaded'),\n                'debug'\n            );\n        }\n\n        if (!Envapter.isTest) await this.bus[VerifyWebhooks]();\n    }\n\n    /** @internal */\n    public async onHmr(event: HmrUpdateEvent): Promise<void> {\n        if (this.hmrHandler) await this.hmrHandler.handle(event);\n    }\n\n    private async load(dir: string): Promise<void> {\n        await traverseDirectory(dir, (fullPath, relativePath, imported) => {\n            for (const exportName of Object.keys(imported)) {\n                const value = imported[exportName];\n                if (!this.isSubscriber(value)) continue;\n\n                this.registerSubscriber(value);\n                this.hmrHandler?.trackHandler(fullPath, value);\n                busLoggerOf(this.bus).utils.registration(value.name, relativePath, undefined, 'trace');\n            }\n        });\n    }\n\n    private registerSubscriber(ctor: StoredSubscriberCtor): void {\n        this.bus[RegisterSubscriber](registrationFor(ctor));\n    }\n\n    private unregisterSubscriber(ctor: StoredSubscriberCtor, artifacts?: SubscriberArtifact): void {\n        this.bus[UnregisterSubscriber](ctor, artifacts);\n    }\n\n    private getArtifacts(ctor: StoredSubscriberCtor): SubscriberArtifact {\n        const meta = Reflect.getMetadata(SubscribeMetadataKey, ctor) as SubscribeMetadataEntry;\n        return [meta.subscriber];\n    }\n\n    private isSubscriber(value: unknown): value is StoredSubscriberCtor {\n        if (typeof value !== 'function') return false;\n        return value.prototype instanceof Subscriber && Reflect.hasMetadata(SubscribeMetadataKey, value);\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport { ConfigGuilds } from '#decorators/Command';\n\nimport type { CommandMeta } from '#decorators/Command';\n\nexport type DeployTarget = Exclude<CommandMeta, { scope: 'config' }>;\n\nexport function resolveDeployTarget(\n    meta: CommandMeta,\n    configured: readonly string[],\n    commandName: string\n): DeployTarget {\n    if (meta.scope === 'global') return { scope: 'global' };\n\n    if (meta.scope === 'config') {\n        return configured.length > 0 ? guildTarget(configured) : { scope: 'global' };\n    }\n\n    if (configured.length === 0 && meta.guilds.includes(ConfigGuilds)) {\n        throw new SeedcordError(SeedcordErrorCode.CoreCommandGuildsEmpty, [commandName]);\n    }\n\n    return guildTarget(meta.guilds.flatMap((target) => (target === ConfigGuilds ? configured : target)));\n}\n\n// a repeated id would push the same builder into one guild twice, and discord rejects a duplicate name in the put\nfunction guildTarget(guilds: readonly string[]): DeployTarget {\n    return { scope: 'guild', guilds: [...new Set(guilds)] };\n}\n","import { resolve } from 'node:path';\n\nimport { SlashCommandBuilder } from '@discordjs/builders';\nimport { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\nimport { formatFilePath } from '@seedcord/utils';\nimport { traverseDirectory } from '@seedcord/utils/node';\nimport { Routes } from 'discord-api-types/v10';\nimport { Envapter } from 'envapt';\n\nimport { getDevChannel } from '#hmr/devChannel';\nimport { HmrModuleHandler } from '#hmr/HmrModuleHandler';\nimport { CommandInjector } from '#src/commands/CommandInjector';\nimport { contextMenuLeaves } from '#src/commands/contextMenuLeaves';\nimport { resolveDeployTarget } from '#src/commands/deployTarget';\nimport { isCommandClass } from '#src/commands/isCommandClass';\nimport { slashRouteLeaves } from '#src/commands/slashRouteLeaves';\nimport { CommandMetadataKey } from '#src/metadataKeys';\nimport { PublishDefault } from '#subscribers/publishDefault';\n\nimport type { CommandMeta } from '#decorators/Command';\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { ContextMenuLeaves } from '#src/commands/contextMenuLeaves';\nimport type { DeployTarget } from '#src/commands/deployTarget';\nimport type { CommandCtor } from '#src/commands/isCommandClass';\nimport type { CommandBuilder, DeployResult } from '#src/commands/types';\nimport type { Initializeable } from '#src/plugin/Plugin';\nimport type { AllSubscriptions } from '#subscribers/types/Subscriptions';\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\nimport type { APIApplicationCommand } from 'discord-api-types/v10';\n\ntype CommandArtifact = DeployTarget & { name: string };\n\nfunction indexById(commands: readonly APIApplicationCommand[]): Map<string, APIApplicationCommand> {\n    return new Map(commands.map((command) => [command.id, command]));\n}\n\n/**\n * Scans the command directory, builds each command, and PUTs the global and guild scopes to Discord.\n *\n * @internal\n */\nexport class CommandRegistry implements Initializeable, HmrAware {\n    private readonly logger = new Logger('Commands', { channel: 'commands' });\n    private isInitialised = false;\n\n    public readonly globalCommands: CommandBuilder[] = [];\n    public readonly guildCommands = new Map<string, CommandBuilder[]>();\n\n    private readonly ctorToCommand = new Map<CommandCtor, CommandArtifact>();\n\n    // batched during bulk load. A reload reports on the hmr channel instead\n    private loading = false;\n    private readonly loadedCommands: { name: string; from: string; kind: 'slash command' | 'context menu' }[] = [];\n\n    private readonly hmrHandler?: HmrModuleHandler<CommandCtor, void, CommandArtifact | undefined>;\n    private readonly pendingEvents = new Map<string, HmrUpdateEvent>();\n    private readonly injector = new CommandInjector();\n\n    private readonly dir: string;\n    private readonly configuredGuilds: readonly string[];\n\n    public constructor(private readonly core: CoreBase) {\n        const { commands } = core.config.bot;\n        if (!commands.path) {\n            throw new SeedcordError(SeedcordErrorCode.CoreControllerPathMissing, ['CommandRegistry', 'commands']);\n        }\n        this.dir = commands.path;\n        this.configuredGuilds = commands.guilds ?? [];\n\n        if (!Envapter.isDevelopment && !Envapter.isTest) return;\n        this.hmrHandler = new HmrModuleHandler<CommandCtor, void, CommandArtifact | undefined>({\n            handlersDir: this.dir,\n            isHandler: isCommandClass,\n            registerHandler: this.registerCommand.bind(this),\n            unregisterHandler: this.unregisterCommand.bind(this),\n            getArtifacts: this.getArtifacts.bind(this),\n            logger: this.logger\n        });\n    }\n\n    private getArtifacts(ctor: CommandCtor): CommandArtifact | undefined {\n        return this.ctorToCommand.get(ctor);\n    }\n\n    /** @internal */\n    public async init(): Promise<void> {\n        if (this.isInitialised) return;\n        this.isInitialised = true;\n\n        this.loading = true;\n        this.loadedCommands.length = 0;\n        try {\n            await this.loadCommands(this.dir);\n        } finally {\n            this.loading = false;\n        }\n\n        this.reportLoad();\n\n        getDevChannel()?.on('seedcord:refresh-commands', (data) => {\n            void this.refresh(data.shouldRefresh);\n        });\n    }\n\n    private reportLoad(): void {\n        const { utils } = this.logger;\n\n        utils.summary(\n            'Loaded commands',\n            { global: this.globalCommands.length, 'guild groups': this.guildCommands.size },\n            'debug'\n        );\n\n        let slash = 0;\n        let menu = 0;\n        for (const command of this.loadedCommands) {\n            if (command.kind === 'slash command') slash++;\n            else menu++;\n        }\n\n        utils.block(\n            'Loaded commands',\n            [\n                ...utils.entries(this.loadedCommands),\n                ...utils.counts({ 'slash commands': slash, 'context menus': menu })\n            ],\n            'debug'\n        );\n    }\n\n    /** @internal */\n    public async refresh(shouldRefresh = true): Promise<void> {\n        if (!shouldRefresh) {\n            this.logger.debug(paint.italic('Command refresh cancelled.'));\n            this.pendingEvents.clear();\n            return;\n        }\n\n        this.logger.debug(paint.italic('Refreshing commands...'));\n        for (const event of this.pendingEvents.values()) {\n            await this.hmrHandler?.handle(event);\n        }\n        this.pendingEvents.clear();\n        await this.setCommands();\n    }\n\n    /** @internal */\n    public async onHmr(event: HmrUpdateEvent): Promise<void> {\n        if (event.file.startsWith(resolve(process.cwd(), this.dir))) {\n            this.pendingEvents.delete(event.file);\n            this.pendingEvents.set(event.file, event);\n            getDevChannel()?.send('seedcord:commands-update-prompt', {\n                files: [...this.pendingEvents.keys()].map((f) => formatFilePath(f))\n            });\n        } else {\n            await this.hmrHandler?.handle(event);\n        }\n    }\n\n    private async loadCommands(dir: string): Promise<void> {\n        await traverseDirectory(dir, (fullPath, rel, mod) => {\n            for (const exported of Object.values(mod))\n                if (isCommandClass(exported)) {\n                    this.registerCommand(exported, rel);\n                    this.hmrHandler?.trackHandler(fullPath, exported);\n                }\n        });\n    }\n\n    private registerCommand(Ctor: CommandCtor, rel: string): void {\n        const meta = Reflect.getMetadata(CommandMetadataKey, Ctor) as CommandMeta | undefined;\n\n        if (!meta) return;\n\n        const instance = new Ctor();\n        const comp = instance.component;\n        const kind = comp instanceof SlashCommandBuilder ? 'slash command' : 'context menu';\n\n        const target = resolveDeployTarget(meta, this.configuredGuilds, Ctor.name);\n\n        if (target.scope === 'global') {\n            this.globalCommands.push(comp);\n        } else {\n            for (const g of target.guilds) {\n                const arr = this.guildCommands.get(g) ?? [];\n                arr.push(comp);\n                this.guildCommands.set(g, arr);\n            }\n        }\n\n        this.ctorToCommand.set(Ctor, { name: comp.name, ...target });\n\n        if (this.loading) {\n            this.loadedCommands.push({ name: comp.name, from: formatFilePath(rel), kind });\n        }\n    }\n\n    private unregisterCommand(ctor: CommandCtor, artifacts?: CommandArtifact): void {\n        const info = artifacts ?? this.ctorToCommand.get(ctor);\n        if (!info) return;\n\n        if (info.scope === 'global') {\n            const idx = this.globalCommands.findIndex((c) => c.name === info.name);\n            if (idx !== -1) this.globalCommands.splice(idx, 1);\n        } else {\n            for (const g of info.guilds) {\n                const arr = this.guildCommands.get(g);\n                if (arr) {\n                    const idx = arr.findIndex((c) => c.name === info.name);\n                    if (idx !== -1) arr.splice(idx, 1);\n                }\n            }\n        }\n        this.ctorToCommand.delete(ctor);\n    }\n\n    /** @internal */\n    public async setCommands(): Promise<DeployResult> {\n        const result: DeployResult = { global: new Map(), guilds: new Map() };\n        const appId = this.core.applicationId;\n\n        if (this.globalCommands.length > 0) {\n            const deployed = await this.put(Routes.applicationCommands(appId), this.globalCommands);\n            result.global = indexById(deployed);\n            const tag = this.globalCommands.length === 1 ? 'command' : 'commands';\n            this.logger.utils.block(\n                `Deployed ${this.globalCommands.length} global ${tag}`,\n                this.logger.utils.wrap(this.globalCommands.map((command) => command.name)),\n                'info'\n            );\n        }\n\n        for (const [guildId, commands] of this.guildCommands.entries()) {\n            const deployed = await this.putGuild(appId, guildId, commands);\n            result.guilds.set(guildId, indexById(deployed));\n            const tag = commands.length === 1 ? 'command' : 'commands';\n            this.logger.utils.block(\n                `Deployed ${paint.iris.bold(commands.length)} ${tag} to ${paint.sky.bold(guildId)}`,\n                this.logger.utils.wrap(commands.map((command) => command.name)),\n                'info'\n            );\n        }\n\n        this.injector.inject(result, this.allCommands());\n        this.core.bus[PublishDefault]('commandsDeployed', deployedPayload(result));\n        return result;\n    }\n\n    private async putGuild(\n        appId: string,\n        guildId: string,\n        commands: readonly CommandBuilder[]\n    ): Promise<APIApplicationCommand[]> {\n        try {\n            return await this.put(Routes.applicationGuildCommands(appId, guildId), commands);\n        } catch (error) {\n            throw new SeedcordError(SeedcordErrorCode.CoreCommandGuildDeployFailed, [guildId], { cause: error });\n        }\n    }\n\n    private async put(route: `/${string}`, commands: readonly CommandBuilder[]): Promise<APIApplicationCommand[]> {\n        const body = commands.map((command) => command.toJSON());\n        // read here because gateway assigns core.rest after this registry is constructed\n        const { rest } = this.core;\n        // justified: the bulk-overwrite routes return the deployed command array\n        return (await rest.put(route, { body })) as APIApplicationCommand[];\n    }\n\n    /** Every registered builder, global first. A guild command in N guilds appears once per guild. @internal */\n    public allCommands(): CommandBuilder[] {\n        return [...this.globalCommands, ...this.guildCommands.values()].flat();\n    }\n\n    /** @internal */\n    public routeLeaves(): Set<string> {\n        return slashRouteLeaves(this.allCommands());\n    }\n\n    /** @internal */\n    public contextMenuLeaves(): ContextMenuLeaves {\n        return contextMenuLeaves(this.allCommands());\n    }\n}\n\nfunction deployedPayload(result: DeployResult): AllSubscriptions['commandsDeployed'] {\n    const guilds: Record<string, APIApplicationCommand[]> = {};\n    for (const [guildId, deployed] of result.guilds) guilds[guildId] = [...deployed.values()];\n\n    return { global: [...result.global.values()], guilds };\n}\n","import { assertNodeVersion } from '#node/assertNodeVersion';\n\n// the edge bundle never reaches this entry\nassertNodeVersion(process.env.PACKAGE_NODE_RANGE ?? '', process.version);\n\nexport * from '#node/Lifecycle';\nexport * from '#node/HealthCheck';\nexport { HealthResponder } from '#node/HealthResponder';\nexport { settleWithin } from '#node/Lifecycle/withTimeout';\nexport { SubscriberLoader } from '#node/subscribers/SubscriberLoader';\nexport { CommandRegistry } from '#node/commands/CommandRegistry';\nexport { shutdownOf } from '#node/Pluggable';\n"],"mappings":"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"}
+{"version":3,"file":"node-internal.index.mjs","names":[],"sources":["../src/node/Lifecycle/drainWindow.ts","../src/node/HealthResponder.ts","../src/node/HealthCheck.ts","../src/node/subscribers/SubscriberLoader.ts","../src/commands/deployTarget.ts","../src/node/commands/CommandRegistry.ts","../src/node-internal.index.ts"],"sourcesContent":["import { settleWithin } from './withTimeout';\n\nimport type { Logger } from '@seedcord/logger';\n\n// gateway already used 5s. discord's 3s first-ack deadline is the floor.\nexport const DRAIN_WINDOW_MS = 5000;\n\nconst DRAIN_HEADROOM_MS = 1000;\nexport const DRAIN_TASK_TIMEOUT_MS = DRAIN_WINDOW_MS + DRAIN_HEADROOM_MS;\n\nexport async function drainInFlight(\n    inFlight: ReadonlySet<Promise<unknown>>,\n    timeoutMs: number,\n    logger: Logger,\n    label: string\n): Promise<void> {\n    await settleWithin(Promise.allSettled(inFlight), timeoutMs);\n    // nothing cancels these before the process exits\n    if (inFlight.size > 0) logger.warn(`${label}: ${String(inFlight.size)} still running when the drain window closed`);\n}\n","import type { IncomingMessage, ServerResponse } from 'node:http';\n\nconst HTTP_OK = 200;\nconst DEFAULT_HEALTH_CHECK_PATH = '/health';\n\nexport class HealthResponder {\n    public readonly path: string;\n\n    constructor(path?: string) {\n        this.path = path ?? DEFAULT_HEALTH_CHECK_PATH;\n    }\n\n    public tryRespond(req: IncomingMessage, res: ServerResponse): boolean {\n        if (req.method !== 'GET' || req.url !== this.path) return false;\n\n        res.writeHead(HTTP_OK, { 'Content-Type': 'application/json' });\n        res.end(JSON.stringify({ status: 'ok', timestamp: Date.now() }));\n        return true;\n    }\n}\n","import { createServer } from 'node:http';\n\nimport { paint } from '@seedcord/errors';\nimport { Logger } from '@seedcord/logger';\n\nimport { ShutdownPhase } from '#src/lifecycle/phases';\n\nimport { HealthResponder } from './HealthResponder';\n\nimport type { CoordinatedShutdown } from './Lifecycle/CoordinatedShutdown';\nimport type { HealthCheckConfig, HealthCheckOption } from '@seedcord/types';\nimport type { IncomingMessage, Server, ServerResponse } from 'node:http';\n\nconst HTTP_NOT_FOUND = 404;\n\nconst DEFAULT_HEALTH_CHECK_PORT = 6967;\n\nexport class HealthCheck {\n    public readonly logger = new Logger('HealthCheck', { channel: 'health' });\n\n    private readonly _port: number;\n    private readonly _host: string | undefined;\n\n    private readonly responder: HealthResponder;\n    private server?: Server;\n\n    constructor(shutdown: CoordinatedShutdown, options?: HealthCheckConfig) {\n        this._port = options?.port ?? DEFAULT_HEALTH_CHECK_PORT;\n        this._host = options?.host;\n        this.responder = new HealthResponder(options?.path);\n\n        shutdown.addTask(ShutdownPhase.Drain, 'stop-healthcheck-server', () => this.stop());\n    }\n\n    public get port(): number {\n        return this._port;\n    }\n\n    public get host(): string | undefined {\n        return this._host;\n    }\n\n    public get path(): string {\n        return this.responder.path;\n    }\n\n    public static fromOption(shutdown: CoordinatedShutdown, option?: HealthCheckOption): HealthCheck | undefined {\n        if (option === false) return undefined;\n        return new HealthCheck(shutdown, typeof option === 'object' ? option : undefined);\n    }\n\n    public async init(): Promise<void> {\n        return new Promise<void>((resolve, reject) => {\n            const server = createServer((req: IncomingMessage, res: ServerResponse) => {\n                if (this.responder.tryRespond(req, res)) return;\n\n                res.writeHead(HTTP_NOT_FOUND, { 'Content-Type': 'application/json' });\n                res.end(JSON.stringify({ status: 'not found' }));\n            });\n            this.server = server;\n\n            const onListenError = (err: Error): void => reject(err);\n            server.on('error', onListenError);\n\n            server.once('listening', () => {\n                // a late error would reject an already-settled promise, and node throws process-wide without a listener here\n                server.removeListener('error', onListenError);\n                server.on('error', (err) => this.logger.error('Health check server error', err));\n\n                // binds all interfaces, so log an address a browser can open\n                const address = this._host ?? 'localhost';\n                this.logger.info(\n                    `${paint.mint.bold('✔︎')} Health check server listening on ${paint.sky.bold(`http://${address}:${this._port}${this.path}`)}`\n                );\n                resolve();\n            });\n\n            if (this._host) {\n                this.logger.debug(`Binding health check server to ${this._host}`);\n                server.listen(this._port, this._host);\n            } else {\n                this.logger.debug('Binding health check server to all interfaces');\n                server.listen(this._port);\n            }\n        });\n    }\n\n    public stop(): Promise<void> {\n        const server = this.server;\n        // close() on a non-listening server invokes its callback with ERR_SERVER_NOT_RUNNING and\n        // never fires 'close', so without this guard the promise would hang the shutdown phase.\n        if (!server?.listening) return Promise.resolve();\n\n        return new Promise((resolve, reject) => {\n            // settle only in the callback, a 'close'-event resolve would swallow the callback's error\n            server.close((err) => {\n                if (err) {\n                    reject(err);\n                    return;\n                }\n                this.logger.info(paint.coral.bold('Health check server stopped'));\n                resolve();\n            });\n        });\n    }\n}\n","import { paint } from '@seedcord/errors';\nimport { traverseDirectory } from '@seedcord/utils/node';\nimport { Envapter } from 'envapt';\n\nimport { HmrModuleHandler } from '#hmr/HmrModuleHandler';\nimport { SubscribeMetadataKey } from '#src/metadataKeys';\nimport { busLoggerOf } from '#subscribers/Bus';\nimport { registrationFor, Subscriber } from '#subscribers/index';\nimport {\n    RegisterDefaults,\n    RegisteredCount,\n    RegisterSubscriber,\n    UnregisterSubscriber,\n    VerifyWebhooks\n} from '#subscribers/slots';\n\nimport type { Initializeable } from '#src/plugin/Plugin';\nimport type { SubscribeMetadataEntry } from '#subscribers/decorators/Subscribe';\nimport type { StoredSubscriberCtor, Bus } from '#subscribers/index';\nimport type { SubscriptionKey } from '#subscribers/types/Subscriptions';\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\n\ntype SubscriberArtifact = SubscriptionKey[];\n\n// loads subscribers off the filesystem into a Bus and stores their hot-reload wiring. node only, a bundled isolate registers from the manifest instead\nexport class SubscriberLoader implements Initializeable, HmrAware {\n    private isInitialized = false;\n    private readonly hmrHandler?: HmrModuleHandler<StoredSubscriberCtor, void, SubscriberArtifact>;\n\n    constructor(\n        private readonly bus: Bus,\n        private readonly directory: string | null\n    ) {\n        if (!this.directory) return;\n        if (!Envapter.isDevelopment && !Envapter.isTest) return;\n\n        this.hmrHandler = new HmrModuleHandler({\n            handlersDir: this.directory,\n            isHandler: this.isSubscriber.bind(this),\n            registerHandler: this.registerSubscriber.bind(this),\n            unregisterHandler: this.unregisterSubscriber.bind(this),\n            getArtifacts: this.getArtifacts.bind(this),\n            logger: busLoggerOf(this.bus)\n        });\n    }\n\n    /** @internal */\n    public async init(): Promise<void> {\n        if (this.isInitialized) return;\n        this.isInitialized = true;\n\n        this.bus[RegisterDefaults]();\n\n        const { directory } = this;\n        if (directory) {\n            busLoggerOf(this.bus).debug(paint.mute(directory));\n            await this.load(directory);\n            busLoggerOf(this.bus).utils.list(\n                [`${paint.iris.bold(this.bus[RegisteredCount])} subscribers`],\n                paint.mint.bold('Loaded'),\n                'debug'\n            );\n        }\n\n        if (!Envapter.isTest) await this.bus[VerifyWebhooks]();\n    }\n\n    /** @internal */\n    public async onHmr(event: HmrUpdateEvent): Promise<void> {\n        if (this.hmrHandler) await this.hmrHandler.handle(event);\n    }\n\n    private async load(dir: string): Promise<void> {\n        await traverseDirectory(dir, (fullPath, relativePath, imported) => {\n            for (const exportName of Object.keys(imported)) {\n                const value = imported[exportName];\n                if (!this.isSubscriber(value)) continue;\n\n                this.registerSubscriber(value);\n                this.hmrHandler?.trackHandler(fullPath, value);\n                busLoggerOf(this.bus).utils.registration(value.name, relativePath, undefined, 'trace');\n            }\n        });\n    }\n\n    private registerSubscriber(ctor: StoredSubscriberCtor): void {\n        this.bus[RegisterSubscriber](registrationFor(ctor));\n    }\n\n    private unregisterSubscriber(ctor: StoredSubscriberCtor, artifacts?: SubscriberArtifact): void {\n        this.bus[UnregisterSubscriber](ctor, artifacts);\n    }\n\n    private getArtifacts(ctor: StoredSubscriberCtor): SubscriberArtifact {\n        const meta = Reflect.getMetadata(SubscribeMetadataKey, ctor) as SubscribeMetadataEntry;\n        return [meta.subscriber];\n    }\n\n    private isSubscriber(value: unknown): value is StoredSubscriberCtor {\n        if (typeof value !== 'function') return false;\n        return value.prototype instanceof Subscriber && Reflect.hasMetadata(SubscribeMetadataKey, value);\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport { ConfigGuilds } from '#decorators/Command';\n\nimport type { CommandMeta } from '#decorators/Command';\n\nexport type DeployTarget = Exclude<CommandMeta, { scope: 'config' }>;\n\nexport function resolveDeployTarget(\n    meta: CommandMeta,\n    configured: readonly string[],\n    commandName: string\n): DeployTarget {\n    if (meta.scope === 'global') return { scope: 'global' };\n\n    if (meta.scope === 'config') {\n        return configured.length > 0 ? guildTarget(configured) : { scope: 'global' };\n    }\n\n    if (configured.length === 0 && meta.guilds.includes(ConfigGuilds)) {\n        throw new SeedcordError(SeedcordErrorCode.CoreCommandGuildsEmpty, [commandName]);\n    }\n\n    return guildTarget(meta.guilds.flatMap((target) => (target === ConfigGuilds ? configured : target)));\n}\n\n// a repeated id would push the same builder into one guild twice, and discord rejects a duplicate name in the put\nfunction guildTarget(guilds: readonly string[]): DeployTarget {\n    return { scope: 'guild', guilds: [...new Set(guilds)] };\n}\n","import { resolve } from 'node:path';\n\nimport { SlashCommandBuilder } from '@discordjs/builders';\nimport { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\nimport { formatFilePath } from '@seedcord/utils';\nimport { traverseDirectory } from '@seedcord/utils/node';\nimport { Routes } from 'discord-api-types/v10';\nimport { Envapter } from 'envapt';\n\nimport { getDevChannel } from '#hmr/devChannel';\nimport { HmrModuleHandler } from '#hmr/HmrModuleHandler';\nimport { CommandInjector } from '#src/commands/CommandInjector';\nimport { contextMenuLeaves } from '#src/commands/contextMenuLeaves';\nimport { resolveDeployTarget } from '#src/commands/deployTarget';\nimport { isCommandClass } from '#src/commands/isCommandClass';\nimport { slashRouteLeaves } from '#src/commands/slashRouteLeaves';\nimport { CommandMetadataKey } from '#src/metadataKeys';\nimport { PublishDefault } from '#subscribers/publishDefault';\n\nimport type { CommandMeta } from '#decorators/Command';\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { ContextMenuLeaves } from '#src/commands/contextMenuLeaves';\nimport type { DeployTarget } from '#src/commands/deployTarget';\nimport type { CommandCtor } from '#src/commands/isCommandClass';\nimport type { CommandBuilder, DeployResult } from '#src/commands/types';\nimport type { Initializeable } from '#src/plugin/Plugin';\nimport type { AllSubscriptions } from '#subscribers/types/Subscriptions';\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\nimport type { APIApplicationCommand } from 'discord-api-types/v10';\n\ntype CommandArtifact = DeployTarget & { name: string };\n\nfunction indexById(commands: readonly APIApplicationCommand[]): Map<string, APIApplicationCommand> {\n    return new Map(commands.map((command) => [command.id, command]));\n}\n\n/**\n * Scans the command directory, builds each command, and PUTs the global and guild scopes to Discord.\n *\n * @internal\n */\nexport class CommandRegistry implements Initializeable, HmrAware {\n    private readonly logger = new Logger('Commands', { channel: 'commands' });\n    private isInitialised = false;\n\n    public readonly globalCommands: CommandBuilder[] = [];\n    public readonly guildCommands = new Map<string, CommandBuilder[]>();\n\n    private readonly ctorToCommand = new Map<CommandCtor, CommandArtifact>();\n\n    // batched during bulk load. A reload reports on the hmr channel instead\n    private loading = false;\n    private readonly loadedCommands: { name: string; from: string; kind: 'slash command' | 'context menu' }[] = [];\n\n    private readonly hmrHandler?: HmrModuleHandler<CommandCtor, void, CommandArtifact | undefined>;\n    private readonly pendingEvents = new Map<string, HmrUpdateEvent>();\n    private readonly injector = new CommandInjector();\n\n    private readonly dir: string;\n    private readonly configuredGuilds: readonly string[];\n\n    public constructor(private readonly core: CoreBase) {\n        const { commands } = core.config.bot;\n        if (!commands.path) {\n            throw new SeedcordError(SeedcordErrorCode.CoreControllerPathMissing, ['CommandRegistry', 'commands']);\n        }\n        this.dir = commands.path;\n        this.configuredGuilds = commands.guilds ?? [];\n\n        if (!Envapter.isDevelopment && !Envapter.isTest) return;\n        this.hmrHandler = new HmrModuleHandler<CommandCtor, void, CommandArtifact | undefined>({\n            handlersDir: this.dir,\n            isHandler: isCommandClass,\n            registerHandler: this.registerCommand.bind(this),\n            unregisterHandler: this.unregisterCommand.bind(this),\n            getArtifacts: this.getArtifacts.bind(this),\n            logger: this.logger\n        });\n    }\n\n    private getArtifacts(ctor: CommandCtor): CommandArtifact | undefined {\n        return this.ctorToCommand.get(ctor);\n    }\n\n    /** @internal */\n    public async init(): Promise<void> {\n        if (this.isInitialised) return;\n        this.isInitialised = true;\n\n        this.loading = true;\n        this.loadedCommands.length = 0;\n        try {\n            await this.loadCommands(this.dir);\n        } finally {\n            this.loading = false;\n        }\n\n        this.reportLoad();\n\n        getDevChannel()?.on('seedcord:refresh-commands', (data) => {\n            void this.refresh(data.shouldRefresh);\n        });\n    }\n\n    private reportLoad(): void {\n        const { utils } = this.logger;\n\n        utils.summary(\n            'Loaded commands',\n            { global: this.globalCommands.length, 'guild groups': this.guildCommands.size },\n            'debug'\n        );\n\n        let slash = 0;\n        let menu = 0;\n        for (const command of this.loadedCommands) {\n            if (command.kind === 'slash command') slash++;\n            else menu++;\n        }\n\n        utils.block(\n            'Loaded commands',\n            [\n                ...utils.entries(this.loadedCommands),\n                ...utils.counts({ 'slash commands': slash, 'context menus': menu })\n            ],\n            'debug'\n        );\n    }\n\n    /** @internal */\n    public async refresh(shouldRefresh = true): Promise<void> {\n        if (!shouldRefresh) {\n            this.logger.debug(paint.italic('Command refresh cancelled.'));\n            this.pendingEvents.clear();\n            return;\n        }\n\n        this.logger.debug(paint.italic('Refreshing commands...'));\n        for (const event of this.pendingEvents.values()) {\n            await this.hmrHandler?.handle(event);\n        }\n        this.pendingEvents.clear();\n        await this.setCommands();\n    }\n\n    /** @internal */\n    public async onHmr(event: HmrUpdateEvent): Promise<void> {\n        if (event.file.startsWith(resolve(process.cwd(), this.dir))) {\n            this.pendingEvents.delete(event.file);\n            this.pendingEvents.set(event.file, event);\n            getDevChannel()?.send('seedcord:commands-update-prompt', {\n                files: [...this.pendingEvents.keys()].map((f) => formatFilePath(f))\n            });\n        } else {\n            await this.hmrHandler?.handle(event);\n        }\n    }\n\n    private async loadCommands(dir: string): Promise<void> {\n        await traverseDirectory(dir, (fullPath, rel, mod) => {\n            for (const exported of Object.values(mod))\n                if (isCommandClass(exported)) {\n                    this.registerCommand(exported, rel);\n                    this.hmrHandler?.trackHandler(fullPath, exported);\n                }\n        });\n    }\n\n    private registerCommand(Ctor: CommandCtor, rel: string): void {\n        const meta = Reflect.getMetadata(CommandMetadataKey, Ctor) as CommandMeta | undefined;\n\n        if (!meta) return;\n\n        const instance = new Ctor();\n        const comp = instance.component;\n        const kind = comp instanceof SlashCommandBuilder ? 'slash command' : 'context menu';\n\n        const target = resolveDeployTarget(meta, this.configuredGuilds, Ctor.name);\n\n        if (target.scope === 'global') {\n            this.globalCommands.push(comp);\n        } else {\n            for (const g of target.guilds) {\n                const arr = this.guildCommands.get(g) ?? [];\n                arr.push(comp);\n                this.guildCommands.set(g, arr);\n            }\n        }\n\n        this.ctorToCommand.set(Ctor, { name: comp.name, ...target });\n\n        if (this.loading) {\n            this.loadedCommands.push({ name: comp.name, from: formatFilePath(rel), kind });\n        }\n    }\n\n    private unregisterCommand(ctor: CommandCtor, artifacts?: CommandArtifact): void {\n        const info = artifacts ?? this.ctorToCommand.get(ctor);\n        if (!info) return;\n\n        if (info.scope === 'global') {\n            const idx = this.globalCommands.findIndex((c) => c.name === info.name);\n            if (idx !== -1) this.globalCommands.splice(idx, 1);\n        } else {\n            for (const g of info.guilds) {\n                const arr = this.guildCommands.get(g);\n                if (!arr) continue;\n                const idx = arr.findIndex((c) => c.name === info.name);\n                if (idx !== -1) arr.splice(idx, 1);\n            }\n        }\n        this.ctorToCommand.delete(ctor);\n    }\n\n    /** @internal */\n    public async setCommands(): Promise<DeployResult> {\n        const result: DeployResult = { global: new Map(), guilds: new Map() };\n        const appId = this.core.applicationId;\n\n        if (this.globalCommands.length > 0) {\n            const deployed = await this.put(Routes.applicationCommands(appId), this.globalCommands);\n            result.global = indexById(deployed);\n            const tag = this.globalCommands.length === 1 ? 'command' : 'commands';\n            this.logger.utils.block(\n                `Deployed ${this.globalCommands.length} global ${tag}`,\n                this.logger.utils.wrap(this.globalCommands.map((command) => command.name)),\n                'info'\n            );\n        }\n\n        for (const [guildId, commands] of this.guildCommands.entries()) {\n            const deployed = await this.putGuild(appId, guildId, commands);\n            result.guilds.set(guildId, indexById(deployed));\n            const tag = commands.length === 1 ? 'command' : 'commands';\n            this.logger.utils.block(\n                `Deployed ${paint.iris.bold(commands.length)} ${tag} to ${paint.sky.bold(guildId)}`,\n                this.logger.utils.wrap(commands.map((command) => command.name)),\n                'info'\n            );\n        }\n\n        this.injector.inject(result, this.allCommands());\n        this.core.bus[PublishDefault]('commandsDeployed', deployedPayload(result));\n        return result;\n    }\n\n    private async putGuild(\n        appId: string,\n        guildId: string,\n        commands: readonly CommandBuilder[]\n    ): Promise<APIApplicationCommand[]> {\n        try {\n            return await this.put(Routes.applicationGuildCommands(appId, guildId), commands);\n        } catch (error) {\n            throw new SeedcordError(SeedcordErrorCode.CoreCommandGuildDeployFailed, [guildId], { cause: error });\n        }\n    }\n\n    private async put(route: `/${string}`, commands: readonly CommandBuilder[]): Promise<APIApplicationCommand[]> {\n        const body = commands.map((command) => command.toJSON());\n        // read here because gateway assigns core.rest after this registry is constructed\n        const { rest } = this.core;\n        // justified: the bulk-overwrite routes return the deployed command array\n        return (await rest.put(route, { body })) as APIApplicationCommand[];\n    }\n\n    /** Every registered builder, global first. A guild command in N guilds appears once per guild. @internal */\n    public allCommands(): CommandBuilder[] {\n        return [...this.globalCommands, ...this.guildCommands.values()].flat();\n    }\n\n    /** @internal */\n    public routeLeaves(): Set<string> {\n        return slashRouteLeaves(this.allCommands());\n    }\n\n    /** @internal */\n    public contextMenuLeaves(): ContextMenuLeaves {\n        return contextMenuLeaves(this.allCommands());\n    }\n}\n\nfunction deployedPayload(result: DeployResult): AllSubscriptions['commandsDeployed'] {\n    const guilds: Record<string, APIApplicationCommand[]> = {};\n    for (const [guildId, deployed] of result.guilds) guilds[guildId] = [...deployed.values()];\n\n    return { global: [...result.global.values()], guilds };\n}\n","import { assertNodeVersion } from '#node/assertNodeVersion';\n\n// the edge bundle never reaches this entry\nassertNodeVersion(process.env.PACKAGE_NODE_RANGE ?? '', process.version);\n\nexport * from '#node/Lifecycle';\nexport * from '#node/HealthCheck';\nexport { HealthResponder } from '#node/HealthResponder';\nexport { settleWithin } from '#node/Lifecycle/withTimeout';\nexport { SubscriberLoader } from '#node/subscribers/SubscriberLoader';\nexport { CommandRegistry } from '#node/commands/CommandRegistry';\nexport { shutdownOf } from '#node/Pluggable';\n"],"mappings":"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"}

package/dist/node.index.d.mts

@@ -1,2 +1,2 @@
-import { i as CoordinatedShutdown, r as CoordinatedStartup, t as Pluggable } from "./Pluggable-aRzcpx4e.mjs";
+import { i as CoordinatedShutdown, r as CoordinatedStartup, t as Pluggable } from "./Pluggable-CwKbLui3.mjs";
 export { CoordinatedShutdown, CoordinatedStartup, Pluggable };

package/dist/node.index.mjs

@@ -1,5 +1,5 @@
 import { n as StartupPhase, t as ShutdownPhase } from "./phases-BauKJOTT.mjs";
-import { a as withTimeout, i as settleWithin, t as Pluggable } from "./Pluggable-D-xWcaIv.mjs";
+import { a as withTimeout, i as settleWithin, t as Pluggable } from "./Pluggable-CXyUZIvT.mjs";
 import { SeedcordErrorCode, paint } from "@seedcord/errors";
 import { SeedcordAggregateError, SeedcordError, SeedcordRangeError, SeedcordTypeError } from "@seedcord/errors/internal";
 import { Logger } from "@seedcord/logger";
@@ -141,10 +141,9 @@ var CoordinatedShutdown = class extends CoordinatedLifecycle {
 			process.off("SIGTERM", this.onSigTerm);
 			this.onSigTerm = null;
 		}
-		if (this.onSigInt) {
-			process.off("SIGINT", this.onSigInt);
-			this.onSigInt = null;
-		}
+		if (!this.onSigInt) return;
+		process.off("SIGINT", this.onSigInt);
+		this.onSigInt = null;
 	}
 	/** @internal run() awaits this so boot finishes registering its dispose tasks first */
 	gateOnStartup(settled) {

package/dist/node.index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"node.index.mjs","names":["PHASE_ORDER"],"sources":["../src/node/Lifecycle/CoordinatedLifecycle.ts","../src/node/Lifecycle/CoordinatedShutdown.ts","../src/node/Lifecycle/CoordinatedStartup.ts"],"sourcesContent":["/*\n * Inspired by Akka Coordinated Shutdown: https://doc.akka.io/libraries/akka-core/current/coordinated-shutdown.html\n * and Lewis's implementation in a private repo elsewhere (https://github.com/Yomanz)\n */\n\nimport { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordAggregateError, SeedcordTypeError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\n\nimport { withTimeout } from './withTimeout';\n\nimport type { LifecycleTask } from './LifecycleTypes';\n\n// base for the startup and shutdown coordinators, runs phase-ordered tasks off a per-phase map\nexport abstract class CoordinatedLifecycle<TPhase extends number> {\n    protected readonly logger: Logger;\n    protected readonly tasksMap = new Map<TPhase, LifecycleTask[]>();\n\n    protected constructor(\n        loggerName: string,\n        protected readonly phaseOrder: TPhase[],\n        protected readonly phaseEnum: Record<number, string>\n    ) {\n        this.logger = new Logger(loggerName, { channel: 'lifecycle' });\n        this.phaseOrder.forEach((phase) => this.tasksMap.set(phase, []));\n    }\n\n    public addTask(phase: TPhase, taskName: string, task: () => Promise<void>, timeoutMs: number): void {\n        if (!this.canAddTask()) return;\n\n        const tasks = this.tasksMap.get(phase);\n        if (!tasks) {\n            throw new SeedcordTypeError(SeedcordErrorCode.LifecycleUnknownPhase, [phase]);\n        }\n\n        tasks.push({ name: taskName, task, timeout: timeoutMs });\n        this.logger.debug(\n            `${paint.italic('Added')} ${this.getTaskType()} task ${paint.sky.bold(taskName)} to phase ${paint.iris.bold(this.phaseEnum[phase])}`\n        );\n    }\n\n    public removeTask(phase: TPhase, taskName: string): boolean {\n        if (!this.canRemoveTask()) return false;\n\n        const tasks = this.tasksMap.get(phase);\n        if (!tasks) return false;\n\n        const initialLength = tasks.length;\n        const filteredTasks = tasks.filter((task) => task.name !== taskName);\n        this.tasksMap.set(phase, filteredTasks);\n\n        const removed = initialLength !== filteredTasks.length;\n        if (removed) {\n            this.logger.debug(\n                `${paint.italic('Removed')} ${this.getTaskType()} task ${paint.sky.bold(taskName)} from phase ${paint.iris.bold(this.phaseEnum[phase])}`\n            );\n        }\n\n        return removed;\n    }\n\n    protected async runPhase(phase: TPhase): Promise<void> {\n        const tasks = this.tasksMap.get(phase) ?? [];\n        if (tasks.length === 0) {\n            this.logger.trace(`No tasks to run in phase ${paint.iris.bold(this.phaseEnum[phase])}`);\n            return;\n        }\n\n        this.logger.debug(\n            `${paint.amber.bold('Running')} ${this.getTaskType()} phase ${paint.iris.bold(this.phaseEnum[phase])} with ${paint.sky.bold(String(tasks.length))} tasks`\n        );\n\n        const results: PromiseSettledResult<void>[] = await this.executeTasksInPhase(phase, tasks);\n\n        const reasons = results.reduce<unknown[]>((rejected, result) => {\n            if (result.status === 'rejected') rejected.push(result.reason as unknown);\n            return rejected;\n        }, []);\n        if (reasons.length > 0) {\n            // paint here would leak ANSI codes into the serialized error message (the unknown-exception webhook)\n            throw new SeedcordAggregateError(SeedcordErrorCode.LifecyclePhaseFailures, reasons, [\n                this.phaseEnum[phase],\n                reasons.length\n            ]);\n        }\n\n        this.logger.debug(\n            `Phase ${paint.iris.bold(this.phaseEnum[phase])} ${paint.mint.bold('completed successfully')}`\n        );\n    }\n\n    protected async runTaskWithTimeout(phase: TPhase, task: LifecycleTask): Promise<void> {\n        this.logger.trace(\n            `${paint.italic('Starting')} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}`\n        );\n\n        try {\n            await withTimeout(task.name, task.task, task.timeout);\n\n            this.logger.trace(\n                `${paint.italic('Completed')} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}`\n            );\n        } catch (error) {\n            if (this.isAborted()) return;\n            this.logger.error(\n                `${paint.italic('Failed')} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}:`,\n                error\n            );\n            throw error;\n        }\n    }\n\n    protected isAborted(): boolean {\n        return false;\n    }\n\n    protected abstract canAddTask(): boolean;\n    protected abstract canRemoveTask(): boolean;\n    protected abstract getTaskType(): string;\n    protected abstract executeTasksInPhase(\n        phase: TPhase,\n        tasks: LifecycleTask[]\n    ): Promise<PromiseSettledResult<void>[]>;\n}\n","import { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordRangeError } from '@seedcord/errors/internal';\n\nimport { ShutdownPhase } from '#src/lifecycle/phases';\n\nimport { CoordinatedLifecycle } from './CoordinatedLifecycle';\nimport { settleWithin } from './withTimeout';\n\nimport type { LifecycleTask } from './LifecycleTypes';\n\nconst PHASE_ORDER: ShutdownPhase[] = [\n    ShutdownPhase.Unbind,\n    ShutdownPhase.Drain,\n    ShutdownPhase.Disconnect,\n    ShutdownPhase.Logout\n];\n\n// gives the logger's file sink time to flush before process.exit\nconst LOG_FLUSH_DELAY_MS = 3000;\n\n// 25s plus LOG_FLUSH_DELAY_MS stays under kubernetes' 30s SIGKILL window\nconst DEFAULT_SHUTDOWN_DEADLINE_MS = 25_000;\n\nexport class CoordinatedShutdown extends CoordinatedLifecycle<ShutdownPhase> {\n    private isShuttingDown = false;\n    private hasShutdown = false;\n    private exitCode = 0;\n    private onSigTerm: (() => void) | null = null;\n    private onSigInt: (() => void) | null = null;\n    private startupGate?: Promise<void>;\n    private deadlineMs = DEFAULT_SHUTDOWN_DEADLINE_MS;\n    private phasesExpireAt = Infinity;\n    private runningPhase: ShutdownPhase | undefined;\n\n    // the signal handlers below can fire before start() ever runs\n    public constructor(deadlineMs?: number) {\n        super('Shutdown', PHASE_ORDER, ShutdownPhase);\n\n        if (deadlineMs !== undefined) this.setDeadline(deadlineMs);\n        this.registerSignalHandlers();\n    }\n\n    /** @internal */\n    public setDeadline(deadlineMs: number): void {\n        if (!Number.isFinite(deadlineMs) || deadlineMs <= 0) {\n            throw new SeedcordRangeError(SeedcordErrorCode.LifecycleInvalidShutdownDeadline, [deadlineMs]);\n        }\n        this.deadlineMs = deadlineMs;\n    }\n\n    private async runPhases(failures: unknown[]): Promise<void> {\n        for (const phase of PHASE_ORDER) {\n            // set above the check so the reported phase is the one that never started\n            this.runningPhase = phase;\n            // runPhases keeps going after settleWithin stops waiting on it\n            if (performance.now() >= this.phasesExpireAt) return;\n            try {\n                await this.runPhase(phase);\n            } catch (error) {\n                failures.push(error);\n            }\n        }\n        this.runningPhase = undefined;\n    }\n\n    protected canAddTask(): boolean {\n        return true;\n    }\n\n    protected canRemoveTask(): boolean {\n        return true;\n    }\n\n    protected getTaskType(): string {\n        return 'shutdown';\n    }\n\n    protected async executeTasksInPhase(\n        phase: ShutdownPhase,\n        tasks: LifecycleTask[]\n    ): Promise<PromiseSettledResult<void>[]> {\n        const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));\n        return Promise.allSettled(promises);\n    }\n\n    private registerSignalHandlers(): void {\n        this.onSigTerm = () => {\n            this.logger.info(`Received ${paint.amber.bold('SIGTERM')} signal`);\n            void this.run(0);\n        };\n\n        this.onSigInt = () => {\n            this.logger.info(`Received ${paint.amber.bold('SIGINT')} signal`);\n            void this.run(0);\n        };\n\n        process.on('SIGTERM', this.onSigTerm);\n        process.on('SIGINT', this.onSigInt);\n    }\n\n    /** @internal */\n    public removeSignalHandlers(): void {\n        if (this.onSigTerm) {\n            process.off('SIGTERM', this.onSigTerm);\n            this.onSigTerm = null;\n        }\n        if (this.onSigInt) {\n            process.off('SIGINT', this.onSigInt);\n            this.onSigInt = null;\n        }\n    }\n\n    /** @internal run() awaits this so boot finishes registering its dispose tasks first */\n    public gateOnStartup(settled: Promise<void>): void {\n        this.startupGate = settled;\n    }\n\n    public override addTask(phase: ShutdownPhase, taskName: string, task: () => Promise<void>, timeoutMs = 5000): void {\n        super.addTask(phase, taskName, task, timeoutMs);\n    }\n\n    /** @internal */\n    public override removeTask(phase: ShutdownPhase, taskName: string): boolean {\n        return super.removeTask(phase, taskName);\n    }\n\n    /** @internal */\n    public async run(exitCode = 0, exitProcess = true): Promise<void> {\n        this.removeSignalHandlers();\n\n        // a dev-mode run leaves the process alive, so a second call would re-execute every task\n        if (this.hasShutdown || this.isShuttingDown) {\n            // a crash mid-shutdown must still leave a failing code for whatever supervises the process\n            if (exitCode > this.exitCode) this.exitCode = exitCode;\n            this.logger.warn('Shutdown sequence already ran or is in progress');\n            return;\n        }\n\n        this.isShuttingDown = true;\n        this.exitCode = exitCode;\n        this.logger.info(\n            `${paint.amber.bold('Starting')} coordinated shutdown with exit code ${paint.sky.bold(exitCode)}`\n        );\n\n        try {\n            this.phasesExpireAt = performance.now() + this.deadlineMs;\n            // a startup that outlasts the deadline leaves its own dispose tasks unregistered\n            if (this.startupGate) await settleWithin(this.startupGate, this.deadlineMs);\n\n            const failures: unknown[] = [];\n            await settleWithin(this.runPhases(failures), Math.max(this.phasesExpireAt - performance.now(), 0));\n\n            const caughtPhase = this.runningPhase;\n            if (caughtPhase !== undefined) {\n                this.logger.error(\n                    `Shutdown deadline of ${paint.sky.bold(this.deadlineMs)}ms elapsed at phase ${paint.iris.bold(this.phaseEnum[caughtPhase])}`\n                );\n            }\n\n            if (failures.length > 0) {\n                this.logger.error(`${paint.coral.bold('Coordinated shutdown failed')}`, ...failures);\n            } else if (caughtPhase === undefined) {\n                this.logger.info(`${paint.mint.bold('Coordinated shutdown completed')} successfully`);\n            }\n        } finally {\n            this.hasShutdown = true;\n            if (exitProcess) {\n                this.logger.debug(`${paint.coral.bold('Exiting')} process with code ${paint.sky.bold(this.exitCode)}`);\n                setTimeout(() => {\n                    process.exit(this.exitCode);\n                }, LOG_FLUSH_DELAY_MS);\n            } else {\n                this.logger.debug(`${paint.amber.bold('Skipping')} process exit (dev mode)`);\n                this.isShuttingDown = false;\n            }\n        }\n    }\n}\n","import { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport { StartupPhase } from '#src/lifecycle/phases';\n\nimport { CoordinatedLifecycle } from './CoordinatedLifecycle';\n\nimport type { LifecycleTask } from './LifecycleTypes';\n\nconst PHASE_ORDER: StartupPhase[] = [StartupPhase.Configuration, StartupPhase.Login, StartupPhase.Ready];\n\nexport class CoordinatedStartup extends CoordinatedLifecycle<StartupPhase> {\n    private isStartingUp = false;\n    private hasStarted = false;\n\n    public constructor() {\n        super('Startup', PHASE_ORDER, StartupPhase);\n    }\n\n    public override addTask(\n        phase: StartupPhase,\n        taskName: string,\n        task: () => Promise<void>,\n        timeoutMs = 10_000\n    ): void {\n        super.addTask(phase, taskName, task, timeoutMs);\n    }\n\n    protected canAddTask(): boolean {\n        if (this.hasStarted) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleAddAfterCompletion);\n        }\n\n        if (this.isStartingUp) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleAddDuringRun);\n        }\n\n        return true;\n    }\n\n    protected canRemoveTask(): boolean {\n        if (this.isStartingUp) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleRemoveDuringRun);\n        }\n\n        return true;\n    }\n\n    protected getTaskType(): string {\n        return 'startup';\n    }\n\n    protected async executeTasksInPhase(\n        phase: StartupPhase,\n        tasks: LifecycleTask[]\n    ): Promise<PromiseSettledResult<void>[]> {\n        const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));\n        return Promise.allSettled(promises);\n    }\n\n    // each phase completes fully before the next begins\n    /** @internal */\n    public async run(): Promise<void> {\n        if (this.hasStarted) {\n            this.logger.warn('Startup sequence has already completed');\n            return;\n        }\n\n        if (this.isStartingUp) {\n            this.logger.warn('Startup sequence already in progress');\n            return;\n        }\n\n        this.isStartingUp = true;\n        this.logger.info(`${paint.mint.bold('Starting')} coordinated startup sequence`);\n\n        try {\n            for (const phase of PHASE_ORDER) {\n                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- abort() can flip isStartingUp to false mid-loop from the cli\n                if (!this.isStartingUp) {\n                    this.logger.warn('Startup sequence aborted');\n                    return;\n                }\n                await this.runPhase(phase);\n            }\n\n            this.hasStarted = true;\n            this.logger.info(`${paint.mint.bold('Coordinated startup completed')} successfully`);\n        } catch (error) {\n            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- abort() can flip isStartingUp to false before this catch runs\n            if (!this.isStartingUp) {\n                this.logger.warn('Startup sequence aborted during error handling');\n                return;\n            }\n            this.logger.error(`${paint.coral.bold('Coordinated startup failed')}`);\n            throw error;\n        } finally {\n            this.isStartingUp = false;\n        }\n    }\n\n    protected override isAborted(): boolean {\n        return !this.isStartingUp;\n    }\n\n    /** @internal */\n    public abort(): void {\n        if (!this.isStartingUp) return;\n\n        this.isStartingUp = false;\n        this.logger.warn('Aborting coordinated startup sequence');\n    }\n\n    /** @internal */\n    public get isReady(): boolean {\n        return this.hasStarted;\n    }\n}\n"],"mappings":"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"}
+{"version":3,"file":"node.index.mjs","names":["PHASE_ORDER"],"sources":["../src/node/Lifecycle/CoordinatedLifecycle.ts","../src/node/Lifecycle/CoordinatedShutdown.ts","../src/node/Lifecycle/CoordinatedStartup.ts"],"sourcesContent":["/*\n * Inspired by Akka Coordinated Shutdown: https://doc.akka.io/libraries/akka-core/current/coordinated-shutdown.html\n * and Lewis's implementation in a private repo elsewhere (https://github.com/Yomanz)\n */\n\nimport { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordAggregateError, SeedcordTypeError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\n\nimport { withTimeout } from './withTimeout';\n\nimport type { LifecycleTask } from './LifecycleTypes';\n\n// base for the startup and shutdown coordinators, runs phase-ordered tasks off a per-phase map\nexport abstract class CoordinatedLifecycle<TPhase extends number> {\n    protected readonly logger: Logger;\n    protected readonly tasksMap = new Map<TPhase, LifecycleTask[]>();\n\n    protected constructor(\n        loggerName: string,\n        protected readonly phaseOrder: TPhase[],\n        protected readonly phaseEnum: Record<number, string>\n    ) {\n        this.logger = new Logger(loggerName, { channel: 'lifecycle' });\n        this.phaseOrder.forEach((phase) => this.tasksMap.set(phase, []));\n    }\n\n    public addTask(phase: TPhase, taskName: string, task: () => Promise<void>, timeoutMs: number): void {\n        if (!this.canAddTask()) return;\n\n        const tasks = this.tasksMap.get(phase);\n        if (!tasks) {\n            throw new SeedcordTypeError(SeedcordErrorCode.LifecycleUnknownPhase, [phase]);\n        }\n\n        tasks.push({ name: taskName, task, timeout: timeoutMs });\n        this.logger.debug(\n            `${paint.italic('Added')} ${this.getTaskType()} task ${paint.sky.bold(taskName)} to phase ${paint.iris.bold(this.phaseEnum[phase])}`\n        );\n    }\n\n    public removeTask(phase: TPhase, taskName: string): boolean {\n        if (!this.canRemoveTask()) return false;\n\n        const tasks = this.tasksMap.get(phase);\n        if (!tasks) return false;\n\n        const initialLength = tasks.length;\n        const filteredTasks = tasks.filter((task) => task.name !== taskName);\n        this.tasksMap.set(phase, filteredTasks);\n\n        const removed = initialLength !== filteredTasks.length;\n        if (removed) {\n            this.logger.debug(\n                `${paint.italic('Removed')} ${this.getTaskType()} task ${paint.sky.bold(taskName)} from phase ${paint.iris.bold(this.phaseEnum[phase])}`\n            );\n        }\n\n        return removed;\n    }\n\n    protected async runPhase(phase: TPhase): Promise<void> {\n        const tasks = this.tasksMap.get(phase) ?? [];\n        if (tasks.length === 0) {\n            this.logger.trace(`No tasks to run in phase ${paint.iris.bold(this.phaseEnum[phase])}`);\n            return;\n        }\n\n        this.logger.debug(\n            `${paint.amber.bold('Running')} ${this.getTaskType()} phase ${paint.iris.bold(this.phaseEnum[phase])} with ${paint.sky.bold(String(tasks.length))} tasks`\n        );\n\n        const results: PromiseSettledResult<void>[] = await this.executeTasksInPhase(phase, tasks);\n\n        const reasons = results.reduce<unknown[]>((rejected, result) => {\n            if (result.status === 'rejected') rejected.push(result.reason as unknown);\n            return rejected;\n        }, []);\n        if (reasons.length > 0) {\n            // paint here would leak ANSI codes into the serialized error message (the unknown-exception webhook)\n            throw new SeedcordAggregateError(SeedcordErrorCode.LifecyclePhaseFailures, reasons, [\n                this.phaseEnum[phase],\n                reasons.length\n            ]);\n        }\n\n        this.logger.debug(\n            `Phase ${paint.iris.bold(this.phaseEnum[phase])} ${paint.mint.bold('completed successfully')}`\n        );\n    }\n\n    protected async runTaskWithTimeout(phase: TPhase, task: LifecycleTask): Promise<void> {\n        this.logger.trace(\n            `${paint.italic('Starting')} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}`\n        );\n\n        try {\n            await withTimeout(task.name, task.task, task.timeout);\n\n            this.logger.trace(\n                `${paint.italic('Completed')} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}`\n            );\n        } catch (error) {\n            if (this.isAborted()) return;\n            this.logger.error(\n                `${paint.italic('Failed')} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}:`,\n                error\n            );\n            throw error;\n        }\n    }\n\n    protected isAborted(): boolean {\n        return false;\n    }\n\n    protected abstract canAddTask(): boolean;\n    protected abstract canRemoveTask(): boolean;\n    protected abstract getTaskType(): string;\n    protected abstract executeTasksInPhase(\n        phase: TPhase,\n        tasks: LifecycleTask[]\n    ): Promise<PromiseSettledResult<void>[]>;\n}\n","import { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordRangeError } from '@seedcord/errors/internal';\n\nimport { ShutdownPhase } from '#src/lifecycle/phases';\n\nimport { CoordinatedLifecycle } from './CoordinatedLifecycle';\nimport { settleWithin } from './withTimeout';\n\nimport type { LifecycleTask } from './LifecycleTypes';\n\nconst PHASE_ORDER: ShutdownPhase[] = [\n    ShutdownPhase.Unbind,\n    ShutdownPhase.Drain,\n    ShutdownPhase.Disconnect,\n    ShutdownPhase.Logout\n];\n\n// gives the logger's file sink time to flush before process.exit\nconst LOG_FLUSH_DELAY_MS = 3000;\n\n// 25s plus LOG_FLUSH_DELAY_MS stays under kubernetes' 30s SIGKILL window\nconst DEFAULT_SHUTDOWN_DEADLINE_MS = 25_000;\n\nexport class CoordinatedShutdown extends CoordinatedLifecycle<ShutdownPhase> {\n    private isShuttingDown = false;\n    private hasShutdown = false;\n    private exitCode = 0;\n    private onSigTerm: (() => void) | null = null;\n    private onSigInt: (() => void) | null = null;\n    private startupGate?: Promise<void>;\n    private deadlineMs = DEFAULT_SHUTDOWN_DEADLINE_MS;\n    private phasesExpireAt = Infinity;\n    private runningPhase: ShutdownPhase | undefined;\n\n    // the signal handlers below can fire before start() ever runs\n    public constructor(deadlineMs?: number) {\n        super('Shutdown', PHASE_ORDER, ShutdownPhase);\n\n        if (deadlineMs !== undefined) this.setDeadline(deadlineMs);\n        this.registerSignalHandlers();\n    }\n\n    /** @internal */\n    public setDeadline(deadlineMs: number): void {\n        if (!Number.isFinite(deadlineMs) || deadlineMs <= 0) {\n            throw new SeedcordRangeError(SeedcordErrorCode.LifecycleInvalidShutdownDeadline, [deadlineMs]);\n        }\n        this.deadlineMs = deadlineMs;\n    }\n\n    private async runPhases(failures: unknown[]): Promise<void> {\n        for (const phase of PHASE_ORDER) {\n            // set above the check so the reported phase is the one that never started\n            this.runningPhase = phase;\n            // runPhases keeps going after settleWithin stops waiting on it\n            if (performance.now() >= this.phasesExpireAt) return;\n            try {\n                await this.runPhase(phase);\n            } catch (error) {\n                failures.push(error);\n            }\n        }\n        this.runningPhase = undefined;\n    }\n\n    protected canAddTask(): boolean {\n        return true;\n    }\n\n    protected canRemoveTask(): boolean {\n        return true;\n    }\n\n    protected getTaskType(): string {\n        return 'shutdown';\n    }\n\n    protected async executeTasksInPhase(\n        phase: ShutdownPhase,\n        tasks: LifecycleTask[]\n    ): Promise<PromiseSettledResult<void>[]> {\n        const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));\n        return Promise.allSettled(promises);\n    }\n\n    private registerSignalHandlers(): void {\n        this.onSigTerm = () => {\n            this.logger.info(`Received ${paint.amber.bold('SIGTERM')} signal`);\n            void this.run(0);\n        };\n\n        this.onSigInt = () => {\n            this.logger.info(`Received ${paint.amber.bold('SIGINT')} signal`);\n            void this.run(0);\n        };\n\n        process.on('SIGTERM', this.onSigTerm);\n        process.on('SIGINT', this.onSigInt);\n    }\n\n    /** @internal */\n    public removeSignalHandlers(): void {\n        if (this.onSigTerm) {\n            process.off('SIGTERM', this.onSigTerm);\n            this.onSigTerm = null;\n        }\n        if (!this.onSigInt) {\n            return;\n        }\n\n        process.off('SIGINT', this.onSigInt);\n        this.onSigInt = null;\n    }\n\n    /** @internal run() awaits this so boot finishes registering its dispose tasks first */\n    public gateOnStartup(settled: Promise<void>): void {\n        this.startupGate = settled;\n    }\n\n    public override addTask(phase: ShutdownPhase, taskName: string, task: () => Promise<void>, timeoutMs = 5000): void {\n        super.addTask(phase, taskName, task, timeoutMs);\n    }\n\n    /** @internal */\n    public override removeTask(phase: ShutdownPhase, taskName: string): boolean {\n        return super.removeTask(phase, taskName);\n    }\n\n    /** @internal */\n    public async run(exitCode = 0, exitProcess = true): Promise<void> {\n        this.removeSignalHandlers();\n\n        // a dev-mode run leaves the process alive, so a second call would re-execute every task\n        if (this.hasShutdown || this.isShuttingDown) {\n            // a crash mid-shutdown must still leave a failing code for whatever supervises the process\n            if (exitCode > this.exitCode) this.exitCode = exitCode;\n            this.logger.warn('Shutdown sequence already ran or is in progress');\n            return;\n        }\n\n        this.isShuttingDown = true;\n        this.exitCode = exitCode;\n        this.logger.info(\n            `${paint.amber.bold('Starting')} coordinated shutdown with exit code ${paint.sky.bold(exitCode)}`\n        );\n\n        try {\n            this.phasesExpireAt = performance.now() + this.deadlineMs;\n            // a startup that outlasts the deadline leaves its own dispose tasks unregistered\n            if (this.startupGate) await settleWithin(this.startupGate, this.deadlineMs);\n\n            const failures: unknown[] = [];\n            await settleWithin(this.runPhases(failures), Math.max(this.phasesExpireAt - performance.now(), 0));\n\n            const caughtPhase = this.runningPhase;\n            if (caughtPhase !== undefined) {\n                this.logger.error(\n                    `Shutdown deadline of ${paint.sky.bold(this.deadlineMs)}ms elapsed at phase ${paint.iris.bold(this.phaseEnum[caughtPhase])}`\n                );\n            }\n\n            if (failures.length > 0) {\n                this.logger.error(`${paint.coral.bold('Coordinated shutdown failed')}`, ...failures);\n            } else if (caughtPhase === undefined) {\n                this.logger.info(`${paint.mint.bold('Coordinated shutdown completed')} successfully`);\n            }\n        } finally {\n            this.hasShutdown = true;\n            if (exitProcess) {\n                this.logger.debug(`${paint.coral.bold('Exiting')} process with code ${paint.sky.bold(this.exitCode)}`);\n                setTimeout(() => {\n                    process.exit(this.exitCode);\n                }, LOG_FLUSH_DELAY_MS);\n            } else {\n                this.logger.debug(`${paint.amber.bold('Skipping')} process exit (dev mode)`);\n                this.isShuttingDown = false;\n            }\n        }\n    }\n}\n","import { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nimport { StartupPhase } from '#src/lifecycle/phases';\n\nimport { CoordinatedLifecycle } from './CoordinatedLifecycle';\n\nimport type { LifecycleTask } from './LifecycleTypes';\n\nconst PHASE_ORDER: StartupPhase[] = [StartupPhase.Configuration, StartupPhase.Login, StartupPhase.Ready];\n\nexport class CoordinatedStartup extends CoordinatedLifecycle<StartupPhase> {\n    private isStartingUp = false;\n    private hasStarted = false;\n\n    public constructor() {\n        super('Startup', PHASE_ORDER, StartupPhase);\n    }\n\n    public override addTask(\n        phase: StartupPhase,\n        taskName: string,\n        task: () => Promise<void>,\n        timeoutMs = 10_000\n    ): void {\n        super.addTask(phase, taskName, task, timeoutMs);\n    }\n\n    protected canAddTask(): boolean {\n        if (this.hasStarted) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleAddAfterCompletion);\n        }\n\n        if (this.isStartingUp) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleAddDuringRun);\n        }\n\n        return true;\n    }\n\n    protected canRemoveTask(): boolean {\n        if (this.isStartingUp) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleRemoveDuringRun);\n        }\n\n        return true;\n    }\n\n    protected getTaskType(): string {\n        return 'startup';\n    }\n\n    protected async executeTasksInPhase(\n        phase: StartupPhase,\n        tasks: LifecycleTask[]\n    ): Promise<PromiseSettledResult<void>[]> {\n        const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));\n        return Promise.allSettled(promises);\n    }\n\n    // each phase completes fully before the next begins\n    /** @internal */\n    public async run(): Promise<void> {\n        if (this.hasStarted) {\n            this.logger.warn('Startup sequence has already completed');\n            return;\n        }\n\n        if (this.isStartingUp) {\n            this.logger.warn('Startup sequence already in progress');\n            return;\n        }\n\n        this.isStartingUp = true;\n        this.logger.info(`${paint.mint.bold('Starting')} coordinated startup sequence`);\n\n        try {\n            for (const phase of PHASE_ORDER) {\n                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- abort() can flip isStartingUp to false mid-loop from the cli\n                if (!this.isStartingUp) {\n                    this.logger.warn('Startup sequence aborted');\n                    return;\n                }\n                await this.runPhase(phase);\n            }\n\n            this.hasStarted = true;\n            this.logger.info(`${paint.mint.bold('Coordinated startup completed')} successfully`);\n        } catch (error) {\n            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- abort() can flip isStartingUp to false before this catch runs\n            if (!this.isStartingUp) {\n                this.logger.warn('Startup sequence aborted during error handling');\n                return;\n            }\n            this.logger.error(`${paint.coral.bold('Coordinated startup failed')}`);\n            throw error;\n        } finally {\n            this.isStartingUp = false;\n        }\n    }\n\n    protected override isAborted(): boolean {\n        return !this.isStartingUp;\n    }\n\n    /** @internal */\n    public abort(): void {\n        if (!this.isStartingUp) return;\n\n        this.isStartingUp = false;\n        this.logger.warn('Aborting coordinated startup sequence');\n    }\n\n    /** @internal */\n    public get isReady(): boolean {\n        return this.hasStarted;\n    }\n}\n"],"mappings":"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"}

package/dist/{phases-DJf12l5T.d.mts → phases-D_zQBXga.d.mts}

@@ -4,6 +4,7 @@ import { TypedEventEmitter } from "@seedcord/event-emitter";
 import { REST } from "@discordjs/rest";
 import { UUID } from "@seedcord/types/internal";
 import { Config, DispatchBag, DispatchState, EventFrequency, IRateLimiter, RenderContext, ReplyResponse, TypedExclude } from "@seedcord/types";
+import { Constructor } from "type-fest";
 //#region src/stops/Notice.d.ts
 /**
  * Base class for a user-facing refusal or a reported fault.
@@ -372,26 +373,13 @@ declare abstract class Subscriber<KeyOfSubscribers extends SubscriptionKey, TCor
 }
 //#endregion
 //#region src/subscribers/Bus.d.ts
-/**
- * Both parameters are `never` because construct-signature parameters check contravariantly, and a
- * concrete subscriber narrows each to its own payload and transport `Core`. One cast at dispatch
- * restores both.
- *
- * @internal
- */
-type StoredSubscriberCtor = new (data: never, core: never) => Subscriber<SubscriptionKey, CoreBase>;
-/**
- * `resolve` is lazy so an edge host registers from a manifest row without importing the module
- * until that key first publishes.
- *
- * @internal
- */
+/** @internal */
+type StoredSubscriberCtor = Constructor<Subscriber<SubscriptionKey, CoreBase>, never[]>;
+/** @internal */
 interface SubscriberRegistration {
   readonly keys: readonly SubscriptionKey[];
   readonly frequency: EventFrequency;
-  readonly resolve: () => StoredSubscriberCtor | Promise<StoredSubscriberCtor>;
-  /** A server-host registration carries it from the start. A lazy one fills it on first resolve. */
-  ctor?: StoredSubscriberCtor | undefined;
+  readonly ctor: StoredSubscriberCtor;
 }
 declare const loggerSlot: unique symbol;
 /**
@@ -415,17 +403,17 @@ declare class Bus extends TypedEventEmitter<SubscriptionTuples> {
   [UnregisterSubscriber](ctor: StoredSubscriberCtor, keys?: readonly SubscriptionKey[]): void;
   /** @internal */
   get [RegisteredCount](): number;
-  /** @internal a lazy edge registration never probes. every server-host reporter registers eagerly */
+  /** @internal registration already dropped every reporter with no url set */
   [VerifyWebhooks](): Promise<void>;
   private probeWebhook;
   /**
    * Publishes an event to its subscribers and native listeners.
    *
-   * Fire-and-forget. Subscriber handlers run asynchronously and this returns before they finish. A
-   * caller cannot assume a side effect has completed. Errors thrown by a subscriber or by an `on()`
-   * listener are caught and logged, never surfaced here. One throwing listener does not stop the
-   * others. Subscribers on one key run concurrently and carry no ordering guarantee. A `'once'`
-   * subscriber is marked as executed when it starts, even if it throws. It never runs twice.
+   * Fire-and-forget. Subscriber handlers run asynchronously and this returns before they finish.
+   * Errors thrown by a subscriber or by an `on()` listener are caught and logged, never surfaced
+   * here. One throwing listener does not stop the others. Subscribers on one key run concurrently
+   * and carry no ordering guarantee. A `'once'` subscriber is marked as executed when it starts,
+   * even if it throws. It never runs twice.
    *
    * The framework's own keys are excluded. Subscribe to those and listen with `on`. The framework
    * is their only publisher.
@@ -448,6 +436,8 @@ declare class Bus extends TypedEventEmitter<SubscriptionTuples> {
   private runSubscriber;
 }
 /** @internal */
+declare function registrationFor(ctor: StoredSubscriberCtor): SubscriberRegistration;
+/** @internal */
 declare function busLoggerOf(bus: Bus): Logger;
 //#endregion
 //#region src/interfaces/CoreBase.d.ts
@@ -498,5 +488,5 @@ declare enum ShutdownPhase {
   Logout = 4
 }
 //#endregion
-export { UnregisterSubscriber as A, InteractionMiddlewareMetadataKey as B, ReplyMethod as C, RegisterDefaults as D, AckTrace as E, EventMetadataKey as F, Notice as G, MiddlewareKind as H, EventMiddlewareMetadataKey as I, GatedMetadataKey as L, PublishDefault as M, DispatchContext as N, RegisterSubscriber as O, CommandMetadataKey as P, InteractionKind as R, AckState as S, sendTarget as T, SubscribeMetadataKey as U, InteractionRouteKeys as V, WebhookUrlMetadataKey as W, SubscriptionData as _, StoredSubscriberCtor as a, ReplyTelemetry as b, Subscriber as c, DispatchOutcome as d, FaultSource as f, ResponseSent as g, ResponseOutcome as h, Bus as i, VerifyWebhooks as j, RegisteredCount as k, AttemptedWrite as l, ResponseFailed as m, StartupPhase as n, SubscriberRegistration as o, ResponseAttempt as p, CoreBase as r, busLoggerOf as s, ShutdownPhase as t, DefaultSubscriptions as u, SubscriptionKey as v, checkAckLegality as w, reportedWrite as x, Subscriptions as y, InteractionMetadataKey as z };
-//# sourceMappingURL=phases-DJf12l5T.d.mts.map
+export { RegisteredCount as A, InteractionMetadataKey as B, AckState as C, AckTrace as D, sendTarget as E, CommandMetadataKey as F, WebhookUrlMetadataKey as G, InteractionRouteKeys as H, EventMetadataKey as I, Notice as K, EventMiddlewareMetadataKey as L, VerifyWebhooks as M, PublishDefault as N, RegisterDefaults as O, DispatchContext as P, GatedMetadataKey as R, reportedWrite as S, checkAckLegality as T, MiddlewareKind as U, InteractionMiddlewareMetadataKey as V, SubscribeMetadataKey as W, ResponseSent as _, StoredSubscriberCtor as a, Subscriptions as b, registrationFor as c, DefaultSubscriptions as d, DispatchOutcome as f, ResponseOutcome as g, ResponseFailed as h, Bus as i, UnregisterSubscriber as j, RegisterSubscriber as k, Subscriber as l, ResponseAttempt as m, StartupPhase as n, SubscriberRegistration as o, FaultSource as p, CoreBase as r, busLoggerOf as s, ShutdownPhase as t, AttemptedWrite as u, SubscriptionData as v, ReplyMethod as w, ReplyTelemetry as x, SubscriptionKey as y, InteractionKind as z };
+//# sourceMappingURL=phases-D_zQBXga.d.mts.map

package/dist/plugin.index.d.mts

@@ -1,3 +1,3 @@
-import { a as Plugin, f as PluginLifecycleSpec, l as PluginOptions } from "./Plugin-D01bBIFo.mjs";
+import { a as Plugin, f as PluginLifecycleSpec, l as PluginOptions } from "./Plugin-Dhx_ivqj.mjs";
 import { HmrAware, HmrUpdateEvent } from "@seedcord/types";
 export { type HmrAware, type HmrUpdateEvent, Plugin, type PluginLifecycleSpec, type PluginOptions };

package/dist/{slashRouteLeaves-DTFHzCKN.mjs → slashRouteLeaves-D__G9vsr.mjs}

@@ -1,4 +1,4 @@
-import { M as isBuilderComponentClass, g as CommandMetadataKey } from "./Bus-Djm6688b.mjs";
+import { M as isBuilderComponentClass, g as CommandMetadataKey } from "./Bus-DUDafYDD.mjs";
 import { SlashCommandBuilder } from "@discordjs/builders";
 import { routeLeavesOf } from "@seedcord/utils/internal";
 
@@ -28,4 +28,4 @@ function slashRouteLeaves(commands) {
 
 //#endregion
 export { isCommandClass as n, slashRouteLeaves as t };
-//# sourceMappingURL=slashRouteLeaves-DTFHzCKN.mjs.map
+//# sourceMappingURL=slashRouteLeaves-D__G9vsr.mjs.map

package/dist/slashRouteLeaves-D__G9vsr.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slashRouteLeaves-D__G9vsr.mjs","names":[],"sources":["../src/commands/isCommandClass.ts","../src/commands/slashRouteLeaves.ts"],"sourcesContent":["import { isBuilderComponentClass } from '#components/Component';\nimport { CommandMetadataKey } from '#src/metadataKeys';\n\nimport type { BuilderComponent } from '#components/Component';\nimport type { Constructor } from 'type-fest';\n\n/** @internal */\nexport type CommandCtor = Constructor<BuilderComponent<'command' | 'context_menu'>, never[]>;\n\n// the cli's codegen scan reads this too\n/** @internal */\nexport function isCommandClass(value: unknown): value is CommandCtor {\n    return isBuilderComponentClass(value) && Reflect.hasMetadata(CommandMetadataKey, value);\n}\n","import { SlashCommandBuilder } from '@discordjs/builders';\nimport { routeLeavesOf } from '@seedcord/utils/internal';\n\nimport type { ContextMenuCommandBuilder } from '@discordjs/builders';\n\n/**\n * dedupes route keys since the same builder appears once per guild.\n * these come from the same {@link routeLeavesOf} that `seedcord codegen` reads, so the boot-time\n * check compares against the generated registry's keys.\n *\n * @internal\n */\nexport function slashRouteLeaves(commands: Iterable<SlashCommandBuilder | ContextMenuCommandBuilder>): Set<string> {\n    const leaves = new Set<string>();\n    for (const command of commands) {\n        if (!(command instanceof SlashCommandBuilder)) continue;\n        for (const leaf of routeLeavesOf(command.toJSON())) leaves.add(leaf.route);\n    }\n    return leaves;\n}\n"],"mappings":";;;;;;AAWA,SAAgB,eAAe,OAAsC;CACjE,OAAO,wBAAwB,KAAK,KAAK,QAAQ,YAAY,oBAAoB,KAAK;AAC1F;;;;;;;;;;;ACDA,SAAgB,iBAAiB,UAAkF;CAC/G,MAAM,yBAAS,IAAI,IAAY;CAC/B,KAAK,MAAM,WAAW,UAAU;EAC5B,IAAI,EAAE,mBAAmB,sBAAsB;EAC/C,KAAK,MAAM,QAAQ,cAAc,QAAQ,OAAO,CAAC,GAAG,OAAO,IAAI,KAAK,KAAK;CAC7E;CACA,OAAO;AACX"}

package/dist/{subscribers-kAQQt_YP.mjs → subscribers-Bxut8U6g.mjs}

@@ -1,4 +1,4 @@
-import { D as clearStore, E as accessorStore, O as guardedAccessor, g as CommandMetadataKey, k as contextMenuLeaves } from "./Bus-Djm6688b.mjs";
+import { D as clearStore, E as accessorStore, O as guardedAccessor, g as CommandMetadataKey, k as contextMenuLeaves } from "./Bus-DUDafYDD.mjs";
 import "reflect-metadata";
 import { SlashCommandBuilder } from "@discordjs/builders";
 import { ApplicationCommandType } from "discord-api-types/v10";
@@ -164,4 +164,4 @@ function decoratorCall(scope) {
 
 //#endregion
 export { ContextMenus as a, Commands as i, RegisterCommand as n, CommandInjector as r, ConfigGuilds as t };
-//# sourceMappingURL=subscribers-kAQQt_YP.mjs.map
+//# sourceMappingURL=subscribers-Bxut8U6g.mjs.map

package/dist/{subscribers-kAQQt_YP.mjs.map → subscribers-Bxut8U6g.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"subscribers-kAQQt_YP.mjs","names":[],"sources":["../src/commands/CommandInjector.ts","../src/decorators/Command.ts"],"sourcesContent":["import { SlashCommandBuilder } from '@discordjs/builders';\nimport { paint } from '@seedcord/errors';\nimport { Logger } from '@seedcord/logger';\nimport { routeLeavesOf } from '@seedcord/utils/internal';\nimport { ApplicationCommandType } from 'discord-api-types/v10';\n\nimport { contextMenuLeaves } from '#src/commands/contextMenuLeaves';\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 { CommandBuilder, DeployResult } from '#src/commands/types';\nimport type { APIApplicationCommand, Snowflake } from 'discord-api-types/v10';\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}. Filled by\n * {@link CommandInjector} after each deploy, and a read before that throws.\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. Filled by {@link CommandInjector} after each deploy, and a read\n * before that throws.\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\nconst MULTI_GUILD = Symbol('seedcord:commands:multi-guild');\n\n// Discord scopes name uniqueness per type, and a context-menu name may be all lowercase like a slash name\nfunction commandKey(type: ApplicationCommandType, name: string): string {\n    return `${type}:${name}`;\n}\n\nfunction slashBuildersOf(all: readonly CommandBuilder[]): SlashCommandBuilder[] {\n    const slash = all.filter((command): command is SlashCommandBuilder => command instanceof SlashCommandBuilder);\n    // a guild command in N guilds is the same builder pushed once per guild\n    return [...new Set(slash)];\n}\n\ninterface DeployedIds {\n    readonly global: Map<string, Snowflake>;\n    readonly guild: Map<string, Snowflake | typeof MULTI_GUILD>;\n    readonly warned: Set<string>;\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        this.clear();\n\n        const ids: DeployedIds = {\n            global: this.indexByKey(deploy.global),\n            guild: this.indexGuilds(deploy.guilds),\n            warned: new Set<string>()\n        };\n        let clickable = 0;\n\n        for (const command of slashBuildersOf(all)) {\n            const id = this.resolveId(\n                ApplicationCommandType.ChatInput,\n                command.name,\n                ids,\n                'falling back to plain text (not clickable)'\n            );\n            for (const leaf of routeLeavesOf(command.toJSON())) {\n                commandStorage[leaf.route] = {\n                    mention: id ? this.toMention(leaf.route, id) : this.toPlain(leaf.route),\n                    ...(id && { id }),\n                    route: leaf.route,\n                    description: leaf.description\n                };\n                if (id) clickable++;\n            }\n        }\n\n        const menus = contextMenuLeaves(all);\n        this.injectMenus(menus.user, ApplicationCommandType.User, userMenuStorage, ids);\n        this.injectMenus(menus.message, ApplicationCommandType.Message, messageMenuStorage, ids);\n\n        this.logger.utils.summary('Linked commands', {\n            clickable,\n            plain: Object.keys(commandStorage).length - clickable,\n            'context menus': menus.user.size + menus.message.size\n        });\n    }\n\n    private injectMenus(\n        names: ReadonlySet<string>,\n        kind: ContextMenuKind,\n        storage: Record<string, ContextMenuInfo>,\n        ids: DeployedIds\n    ): void {\n        for (const name of names) {\n            const id = this.resolveId(kind, name, ids, 'leaving its id unset');\n            storage[name] = { ...(id && { id }), name, kind };\n        }\n    }\n\n    private indexByKey(collection: Map<Snowflake, APIApplicationCommand>): Map<string, Snowflake> {\n        const map = new Map<string, Snowflake>();\n        for (const command of collection.values()) map.set(commandKey(command.type, command.name), command.id);\n        return map;\n    }\n\n    private indexGuilds(\n        guilds: Map<Snowflake, Map<Snowflake, APIApplicationCommand>>\n    ): Map<string, Snowflake | typeof MULTI_GUILD> {\n        const map = new Map<string, Snowflake | typeof MULTI_GUILD>();\n        for (const collection of guilds.values()) {\n            for (const command of collection.values()) {\n                const key = commandKey(command.type, command.name);\n                const existing = map.get(key);\n                // Discord assigns a separate id per guild, so two ids for one name means no single mention\n                if (existing === undefined) map.set(key, command.id);\n                else if (existing !== command.id) map.set(key, MULTI_GUILD);\n            }\n        }\n        return map;\n    }\n\n    private resolveId(\n        type: ApplicationCommandType,\n        name: string,\n        ids: DeployedIds,\n        consequence: string\n    ): Snowflake | undefined {\n        const key = commandKey(type, name);\n        const global = ids.global.get(key);\n        if (global) return global;\n\n        const guild = ids.guild.get(key);\n        if (guild === undefined) return undefined;\n        if (guild === MULTI_GUILD) {\n            if (!ids.warned.has(key)) {\n                this.logger.warn(`${paint.sky.bold(name)} is deployed to multiple guilds, ${consequence}.`);\n                ids.warned.add(key);\n            }\n            return undefined;\n        }\n        return guild;\n    }\n\n    private toMention(route: string, id: Snowflake): string {\n        return `</${route.replaceAll('/', ' ')}:${id}>`;\n    }\n\n    private toPlain(route: string): string {\n        return `/${route.replaceAll('/', ' ')}`;\n    }\n\n    private clear(): void {\n        for (const store of [commandStorage, userMenuStorage, messageMenuStorage]) clearStore(store);\n    }\n}\n","import 'reflect-metadata';\n\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError, 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 SeedcordError(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);\n        }\n\n        if (scope === 'guild' && (!Array.isArray(guilds) || guilds.length === 0)) {\n            throw new SeedcordTypeError(SeedcordErrorCode.DecoratorCommandGuildWithoutGuilds);\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"],"mappings":"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"}
+{"version":3,"file":"subscribers-Bxut8U6g.mjs","names":[],"sources":["../src/commands/CommandInjector.ts","../src/decorators/Command.ts"],"sourcesContent":["import { SlashCommandBuilder } from '@discordjs/builders';\nimport { paint } from '@seedcord/errors';\nimport { Logger } from '@seedcord/logger';\nimport { routeLeavesOf } from '@seedcord/utils/internal';\nimport { ApplicationCommandType } from 'discord-api-types/v10';\n\nimport { contextMenuLeaves } from '#src/commands/contextMenuLeaves';\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 { CommandBuilder, DeployResult } from '#src/commands/types';\nimport type { APIApplicationCommand, Snowflake } from 'discord-api-types/v10';\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}. Filled by\n * {@link CommandInjector} after each deploy, and a read before that throws.\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. Filled by {@link CommandInjector} after each deploy, and a read\n * before that throws.\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\nconst MULTI_GUILD = Symbol('seedcord:commands:multi-guild');\n\n// Discord scopes name uniqueness per type, and a context-menu name may be all lowercase like a slash name\nfunction commandKey(type: ApplicationCommandType, name: string): string {\n    return `${type}:${name}`;\n}\n\nfunction slashBuildersOf(all: readonly CommandBuilder[]): SlashCommandBuilder[] {\n    const slash = all.filter((command): command is SlashCommandBuilder => command instanceof SlashCommandBuilder);\n    // a guild command in N guilds is the same builder pushed once per guild\n    return [...new Set(slash)];\n}\n\ninterface DeployedIds {\n    readonly global: Map<string, Snowflake>;\n    readonly guild: Map<string, Snowflake | typeof MULTI_GUILD>;\n    readonly warned: Set<string>;\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        this.clear();\n\n        const ids: DeployedIds = {\n            global: this.indexByKey(deploy.global),\n            guild: this.indexGuilds(deploy.guilds),\n            warned: new Set<string>()\n        };\n        let clickable = 0;\n\n        for (const command of slashBuildersOf(all)) {\n            const id = this.resolveId(\n                ApplicationCommandType.ChatInput,\n                command.name,\n                ids,\n                'falling back to plain text (not clickable)'\n            );\n            for (const leaf of routeLeavesOf(command.toJSON())) {\n                commandStorage[leaf.route] = {\n                    mention: id ? this.toMention(leaf.route, id) : this.toPlain(leaf.route),\n                    ...(id && { id }),\n                    route: leaf.route,\n                    description: leaf.description\n                };\n                if (id) clickable++;\n            }\n        }\n\n        const menus = contextMenuLeaves(all);\n        this.injectMenus(menus.user, ApplicationCommandType.User, userMenuStorage, ids);\n        this.injectMenus(menus.message, ApplicationCommandType.Message, messageMenuStorage, ids);\n\n        this.logger.utils.summary('Linked commands', {\n            clickable,\n            plain: Object.keys(commandStorage).length - clickable,\n            'context menus': menus.user.size + menus.message.size\n        });\n    }\n\n    private injectMenus(\n        names: ReadonlySet<string>,\n        kind: ContextMenuKind,\n        storage: Record<string, ContextMenuInfo>,\n        ids: DeployedIds\n    ): void {\n        for (const name of names) {\n            const id = this.resolveId(kind, name, ids, 'leaving its id unset');\n            storage[name] = { ...(id && { id }), name, kind };\n        }\n    }\n\n    private indexByKey(collection: Map<Snowflake, APIApplicationCommand>): Map<string, Snowflake> {\n        const map = new Map<string, Snowflake>();\n        for (const command of collection.values()) map.set(commandKey(command.type, command.name), command.id);\n        return map;\n    }\n\n    private indexGuilds(\n        guilds: Map<Snowflake, Map<Snowflake, APIApplicationCommand>>\n    ): Map<string, Snowflake | typeof MULTI_GUILD> {\n        const map = new Map<string, Snowflake | typeof MULTI_GUILD>();\n        for (const collection of guilds.values()) {\n            for (const command of collection.values()) {\n                const key = commandKey(command.type, command.name);\n                const existing = map.get(key);\n                // Discord assigns a separate id per guild, so two ids for one name means no single mention\n                if (existing === undefined) map.set(key, command.id);\n                else if (existing !== command.id) map.set(key, MULTI_GUILD);\n            }\n        }\n        return map;\n    }\n\n    private resolveId(\n        type: ApplicationCommandType,\n        name: string,\n        ids: DeployedIds,\n        consequence: string\n    ): Snowflake | undefined {\n        const key = commandKey(type, name);\n        const global = ids.global.get(key);\n        if (global) return global;\n\n        const guild = ids.guild.get(key);\n        if (guild === undefined) return undefined;\n        if (guild === MULTI_GUILD) {\n            if (!ids.warned.has(key)) {\n                this.logger.warn(`${paint.sky.bold(name)} is deployed to multiple guilds, ${consequence}.`);\n                ids.warned.add(key);\n            }\n            return undefined;\n        }\n        return guild;\n    }\n\n    private toMention(route: string, id: Snowflake): string {\n        return `</${route.replaceAll('/', ' ')}:${id}>`;\n    }\n\n    private toPlain(route: string): string {\n        return `/${route.replaceAll('/', ' ')}`;\n    }\n\n    private clear(): void {\n        for (const store of [commandStorage, userMenuStorage, messageMenuStorage]) clearStore(store);\n    }\n}\n","import 'reflect-metadata';\n\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError, 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 SeedcordError(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);\n        }\n\n        if (scope === 'guild' && (!Array.isArray(guilds) || guilds.length === 0)) {\n            throw new SeedcordTypeError(SeedcordErrorCode.DecoratorCommandGuildWithoutGuilds);\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"],"mappings":"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"}

package/dist/{basic-Dng__Ena.d.mts → types-BG0BimVr.d.mts}

@@ -9,13 +9,5 @@ interface DeployResult {
   guilds: Map<string, Map<string, APIApplicationCommand>>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.0/node_modules/type-fest/source/basic.d.ts
-/**
-Matches a [`class` constructor](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes).
-
-@category Class
-*/
-type Constructor<T, Arguments extends unknown[] = any[]> = new (...arguments_: Arguments) => T;
-//#endregion
-export { CommandBuilder as n, DeployResult as r, Constructor as t };
-//# sourceMappingURL=basic-Dng__Ena.d.mts.map
+export { DeployResult as n, CommandBuilder as t };
+//# sourceMappingURL=types-BG0BimVr.d.mts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@seedcord/core",
   "type": "module",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "engines": {
     "node": ">=24.11"
   },
@@ -70,24 +70,24 @@
   ],
   "peerDependencies": {
     "envapt": "^8.2.2",
-    "typescript": "^6.0.3"
+    "typescript": "^5.9.3 || ^6.0.0 || ^7.0.0"
   },
   "dependencies": {
     "@discordjs/builders": "^1.14.1",
     "@discordjs/rest": "^2.6.3",
-    "@seedcord/custom-id": "^0.2.5",
-    "@seedcord/errors": "^0.11.1",
-    "@seedcord/event-emitter": "^0.1.6",
-    "@seedcord/logger": "^0.4.2",
-    "@seedcord/types": "^0.14.1",
-    "@seedcord/utils": "^0.8.15",
+    "@seedcord/custom-id": "^0.2.6",
+    "@seedcord/errors": "^0.12.0",
+    "@seedcord/event-emitter": "^0.1.7",
+    "@seedcord/logger": "^0.4.3",
+    "@seedcord/types": "^0.14.2",
+    "@seedcord/utils": "^0.8.16",
     "discord-api-types": "^0.38.52",
     "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
-    "@seedcord/eslint-config": "^2.2.2",
-    "@seedcord/rate-limiter": "^0.1.10",
-    "@seedcord/tsconfig": "^2.0.4",
+    "@seedcord/eslint-config": "^2.3.0",
+    "@seedcord/rate-limiter": "^0.1.11",
+    "@seedcord/tsconfig": "^2.0.5",
     "@seedcord/tsdown-config": "^2.0.1",
     "@seedcord/vitest-config": "^0.0.1",
     "envapt": "^8.2.2",
@@ -110,5 +110,5 @@
     "test:watch": "vitest dev",
     "coverage": "vitest run --coverage"
   },
-  "readme": "<div align=\"center\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://cdn.seedcord.org/assets/wordmark-dark.webp\" />\n    <img src=\"https://cdn.seedcord.org/assets/wordmark-light.webp\" alt=\"seedcord\" width=\"440\" />\n  </picture>\n</div>\n\n<div align=\"center\">\n  <h3>The whole Discord bot, typed end to end</h3>\n  <a href=\"https://seedcord.org\">Website</a> ·\n  <a href=\"https://guide.seedcord.org\">Guide</a> ·\n  <a href=\"https://docs.seedcord.org\">Reference</a> ·\n  <a href=\"https://discord.gg/DzFxY58WXf\">Discord</a>\n</div>\n\n<br />\n\n<div align=\"center\">\n\n[![npm](https://img.shields.io/npm/v/@seedcord/core?style=flat-square&logo=npm&logoColor=c8341f&label=&labelColor=1f1f1f&color=c8341f)](https://www.npmjs.com/package/@seedcord/core) [![node](https://img.shields.io/node/v/@seedcord/core?style=flat-square&label=node&labelColor=1f1f1f&color=4d7d33)](https://nodejs.org) [![license](https://img.shields.io/npm/l/@seedcord/core?style=flat-square&label=license&labelColor=1f1f1f&color=f8f6e8)](LICENSE)\n\n</div>\n\n## About\n\n`@seedcord/core` is the foundational code both seedcord transports share. Command and context-menu injection, the interaction route decorators, the handler bases, gates, the startup and shutdown phases, and the plugin base all live here.\n\nNothing in it opens a connection to Discord. `@seedcord/gateway` and `@seedcord/http` each bind their own transport into these pieces.\n\nUntil v1.0.0, minor versions can break.\n\n## Installation\n\nYour transport already re-exports all of this.\n\nInstall it directly when you are writing a plugin against the framework:\n\n```sh\npnpm add @seedcord/core\n```\n\n`@seedcord/core/plugin` holds the base a plugin extends.\n"
+  "readme": "<div align=\"center\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://cdn.seedcord.org/assets/wordmark-dark.webp\" />\n    <img src=\"https://cdn.seedcord.org/assets/wordmark-light.webp\" alt=\"seedcord\" width=\"440\" />\n  </picture>\n</div>\n\n<div align=\"center\">\n  <h3>The whole Discord bot, typed end to end</h3>\n  <a href=\"https://seedcord.org\">Website</a> ·\n  <a href=\"https://seedcord.org/guide\">Guide</a> ·\n  <a href=\"https://seedcord.org/docs\">Reference</a> ·\n  <a href=\"https://discord.gg/DzFxY58WXf\">Discord</a>\n</div>\n\n<br />\n\n<div align=\"center\">\n\n[![npm](https://img.shields.io/npm/v/@seedcord/core?style=flat-square&logo=npm&logoColor=c8341f&label=&labelColor=1f1f1f&color=c8341f)](https://www.npmjs.com/package/@seedcord/core) [![node](https://img.shields.io/node/v/@seedcord/core?style=flat-square&label=node&labelColor=1f1f1f&color=4d7d33)](https://nodejs.org) [![license](https://img.shields.io/npm/l/@seedcord/core?style=flat-square&label=license&labelColor=1f1f1f&color=f8f6e8)](LICENSE)\n\n</div>\n\n## About\n\n`@seedcord/core` is the foundational code both seedcord transports share. Command and context-menu injection, the interaction route decorators, the handler bases, gates, the startup and shutdown phases, and the plugin base all live here.\n\nNothing in it opens a connection to Discord. `@seedcord/gateway` and `@seedcord/http` each bind their own transport into these pieces.\n\nUntil v1.0.0, minor versions can break.\n\n## Installation\n\nYour transport already re-exports all of this.\n\nInstall it directly when you are writing a plugin against the framework:\n\n```sh\npnpm add @seedcord/core\n```\n\n`@seedcord/core/plugin` holds the base a plugin extends.\n"
 }