@seedcord/core 0.1.0-next.5 → 0.1.0-next.7

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-internal.index.mjs","names":["PHASE_ORDER"],"sources":["../src/node/Lifecycle/withTimeout.ts","../src/node/Lifecycle/CoordinatedLifecycle.ts","../src/node/Lifecycle/CoordinatedShutdown.ts","../src/node/Lifecycle/CoordinatedStartup.ts","../src/node/HealthCheck.ts","../src/node/Pluggable.ts","../src/node/subscribers/SubscriberLoader.ts"],"sourcesContent":["import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\nasync function raceTimer(\n    work: Promise<unknown>,\n    timeoutMs: number,\n    onTimeout: (resolve: () => void, reject: (error: unknown) => void) => void\n): Promise<void> {\n    let timer: NodeJS.Timeout | undefined;\n    try {\n        await Promise.race([\n            work,\n            new Promise<void>((resolve, reject) => {\n                timer = setTimeout(() => onTimeout(resolve, reject), timeoutMs);\n            })\n        ]);\n    } finally {\n        if (timer) clearTimeout(timer);\n    }\n}\n\n/** @internal rejects with a `LifecycleTaskTimeout` when `run` outlasts the bound. */\nexport function withTimeout(name: string, run: () => Promise<void>, timeoutMs: number): Promise<void> {\n    return raceTimer(run(), timeoutMs, (_, reject) => {\n        reject(new SeedcordError(SeedcordErrorCode.LifecycleTaskTimeout, [name, timeoutMs]));\n    });\n}\n\n/** @internal resolves when `work` settles or the bound elapses, whichever is first. */\nexport function settleWithin(work: Promise<unknown>, timeoutMs: number): Promise<void> {\n    return raceTimer(work, timeoutMs, (resolve) => resolve());\n}\n","/*\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 } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\nimport chalk from 'chalk';\n\nimport { withTimeout } from './withTimeout';\n\nimport type { LifecycleTask } from './LifecycleTypes';\n\n/**\n * Base for the startup and shutdown coordinators. Runs phase-ordered tasks off a per-phase map.\n *\n * @internal\n */\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    /**\n     * Adds a task to `phase`. Tasks run in phase order, each bounded by `timeoutMs`.\n     *\n     * @param phase - The lifecycle phase to add the task to\n     * @param taskName - Unique name for the task, used for logging and removal\n     * @param task - Async function to execute during the phase\n     * @param timeoutMs - Maximum time allowed for task execution in milliseconds\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 SeedcordError(SeedcordErrorCode.LifecycleUnknownPhase, [phase]);\n        }\n\n        tasks.push({ name: taskName, task, timeout: timeoutMs });\n        this.logger.debug(\n            `${chalk.italic('Added')} ${this.getTaskType()} task ${chalk.bold.cyan(taskName)} to phase ${chalk.bold.magenta(this.phaseEnum[phase])}`\n        );\n    }\n\n    /**\n     * Removes a lifecycle task from a specific phase.\n     *\n     * @param phase - The lifecycle phase to remove the task from\n     * @param taskName - Name of the task to remove\n     * @returns True if the task was found and removed, false otherwise\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                `${chalk.italic('Removed')} ${this.getTaskType()} task ${chalk.bold.cyan(taskName)} from phase ${chalk.bold.magenta(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.debug(`No tasks to run in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`);\n            return;\n        }\n\n        this.logger.info(\n            `${chalk.bold.yellow('Running')} ${this.getTaskType()} phase ${chalk.bold.magenta(this.phaseEnum[phase])} with ${chalk.bold.cyan(tasks.length)} tasks`\n        );\n\n        const results: PromiseSettledResult<void>[] = await this.executeTasksInPhase(phase, tasks);\n\n        const failures = results.filter((r) => r.status === 'rejected').length;\n        if (failures > 0) {\n            // chalk here would leak ANSI codes into the serialized error message (the unknown-exception webhook)\n            throw new SeedcordError(SeedcordErrorCode.LifecyclePhaseFailures, [this.phaseEnum[phase], failures]);\n        }\n\n        this.logger.info(\n            `Phase ${chalk.bold.magenta(this.phaseEnum[phase])} ${chalk.bold.green('completed successfully')}`\n        );\n    }\n\n    protected async runTaskWithTimeout(phase: TPhase, task: LifecycleTask): Promise<void> {\n        this.logger.info(\n            `${chalk.italic('Starting')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`\n        );\n\n        try {\n            await withTimeout(task.name, task.task, task.timeout);\n\n            this.logger.info(\n                `${chalk.italic('Completed')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}`\n            );\n        } catch (error) {\n            this.logger.error(\n                `${chalk.italic('Failed')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(this.phaseEnum[phase])}:`,\n                error\n            );\n            throw error;\n        }\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 chalk from 'chalk';\n\nimport { ShutdownPhase } from '@src/lifecycle/phases';\n\nimport { CoordinatedLifecycle } from './CoordinatedLifecycle';\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/**\n * Runs registered shutdown tasks across `ShutdownPhase` in order. Registers SIGINT and SIGTERM\n * handlers. Tasks within a phase run in parallel.\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\n    public constructor() {\n        super('Shutdown', PHASE_ORDER, ShutdownPhase);\n\n        this.registerSignalHandlers();\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 ${chalk.yellow.bold('SIGTERM')} signal`);\n            void this.run(0);\n        };\n\n        this.onSigInt = () => {\n            this.logger.info(`Received ${chalk.yellow.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    /**\n     * Adds a shutdown-phase task.\n     *\n     * @param phase - The shutdown phase to run the task in.\n     * @param taskName - A descriptive name for the task.\n     * @param task - The async function to run.\n     * @param timeoutMs - Task timeout in ms. {@default `5000` }\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    /** Removes a shutdown-phase task, returning whether one was removed. */\n    public override removeTask(phase: ShutdownPhase, taskName: string): boolean {\n        return super.removeTask(phase, taskName);\n    }\n\n    /**\n     * Runs registered tasks across shutdown phases in `ShutdownPhase` order.\n     * Tasks within each phase run in parallel.\n     *\n     * @param exitCode - Process exit code. {@default `0` }\n     * @param exitProcess - Whether to exit the process after shutdown. {@default `true` }\n     * @example\n     * ```typescript\n     * shutdown.addTask(ShutdownPhase.Disconnect, 'database', () => db.disconnect(), 5000);\n     * await shutdown.run(0);\n     * ```\n     */\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            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            `${chalk.bold.yellow('Starting')} coordinated shutdown with exit code ${chalk.bold.cyan(exitCode)}`\n        );\n\n        try {\n            if (this.startupGate) await this.startupGate;\n            const failures: unknown[] = [];\n            for (const phase of PHASE_ORDER) {\n                // run every phase so a mid-shutdown failure still attempts the later teardowns\n                try {\n                    await this.runPhase(phase);\n                } catch (error) {\n                    failures.push(error);\n                }\n            }\n\n            if (failures.length > 0) {\n                this.logger.error(`${chalk.bold.red('Coordinated shutdown failed')}`, ...failures);\n            } else {\n                this.logger.info(`${chalk.bold.green('Coordinated shutdown completed')} successfully`);\n            }\n        } finally {\n            this.hasShutdown = true;\n            if (exitProcess) {\n                this.logger.info(`${chalk.bold.red('Exiting')} process with code ${chalk.bold.cyan(this.exitCode)}`);\n                setTimeout(() => {\n                    process.exit(this.exitCode);\n                }, LOG_FLUSH_DELAY_MS);\n            } else {\n                this.logger.info(`${chalk.bold.yellow('Skipping')} process exit (dev mode)`);\n                this.isShuttingDown = false;\n            }\n        }\n    }\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport chalk from 'chalk';\n\nimport { StartupPhase } from '@src/lifecycle/phases';\n\nimport { CoordinatedLifecycle } from './CoordinatedLifecycle';\nimport { withTimeout } from './withTimeout';\n\nimport type { LifecycleTask } from './LifecycleTypes';\n\nconst PHASE_ORDER: StartupPhase[] = [StartupPhase.Configuration, StartupPhase.Login, StartupPhase.Ready];\n\n/**\n * Runs registered startup tasks across `StartupPhase` in order. Tasks within a phase run in parallel.\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    /**\n     * Adds a startup-phase task.\n     *\n     * @param phase - The startup phase to run the task in.\n     * @param taskName - A descriptive name for the task.\n     * @param task - The async function to run.\n     * @param timeoutMs - Task timeout in ms. {@default `10000` }\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    /**\n     * Runs the registered tasks across startup phases in `StartupPhase` order. Each phase completes\n     * before the next begins, and tasks within a phase run concurrently.\n     *\n     * @throws {@link SeedcordError} if a startup task throws.\n     */\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(`${chalk.bold.green('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(`${chalk.bold.green('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(`${chalk.bold.red('Coordinated startup failed')}`);\n            throw error;\n        } finally {\n            this.isStartingUp = false;\n        }\n    }\n\n    protected override async runTaskWithTimeout(phase: StartupPhase, task: LifecycleTask): Promise<void> {\n        this.logger.info(\n            `${chalk.italic('Starting')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(StartupPhase[phase])}`\n        );\n\n        try {\n            await withTimeout(task.name, task.task, task.timeout);\n\n            this.logger.info(\n                `${chalk.italic('Completed')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(StartupPhase[phase])}`\n            );\n        } catch (error) {\n            if (!this.isStartingUp) {\n                return;\n            }\n\n            this.logger.error(\n                `${chalk.italic('Failed')} task ${chalk.bold.cyan(task.name)} in phase ${chalk.bold.magenta(StartupPhase[phase])}:`,\n                error\n            );\n            throw error;\n        }\n    }\n\n    /**\n     * Aborts the startup sequence if it is currently running.\n     */\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    public get isReady(): boolean {\n        return this.hasStarted;\n    }\n\n    public get isRunning(): boolean {\n        return this.isStartingUp;\n    }\n}\n","import { createServer } from 'node:http';\n\nimport { Logger, paint } from '@seedcord/logger';\n\nimport { ShutdownPhase } from '@src/lifecycle/phases';\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_OK = 200;\nconst HTTP_NOT_FOUND = 404;\n\nconst DEFAULT_HEALTH_CHECK_PORT = 6967;\nconst DEFAULT_HEALTH_CHECK_PATH = '/health';\n\n/**\n * HTTP server answering `GET` on the configured path with a JSON `{ status, timestamp }` body.\n */\nexport class HealthCheck {\n    /** @internal */\n    public readonly logger = new Logger('HealthCheck', { channel: 'health' });\n\n    public readonly port: number;\n    public readonly path: string;\n    public readonly host: string | undefined;\n\n    private server?: Server;\n\n    constructor(shutdown: CoordinatedShutdown, options?: HealthCheckConfig) {\n        this.port = options?.port ?? DEFAULT_HEALTH_CHECK_PORT;\n        this.path = options?.path ?? DEFAULT_HEALTH_CHECK_PATH;\n        this.host = options?.host;\n\n        shutdown.addTask(ShutdownPhase.Drain, 'stop-healthcheck-server', () => this.stop());\n    }\n\n    /**\n     * Resolves the `healthCheck` option. `undefined` and `true` build the defaults, an object uses\n     * its config, `false` returns `undefined`.\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    /**\n     * Starts the health check server.\n     * @returns Promise that resolves when the server is listening\n     * @internal\n     */\n    public async init(): Promise<void> {\n        return new Promise<void>((resolve, reject) => {\n            const server = createServer((req: IncomingMessage, res: ServerResponse) => {\n                if (req.method === 'GET' && req.url === this.path) {\n                    res.writeHead(HTTP_OK, { 'Content-Type': 'application/json' });\n                    res.end(JSON.stringify({ status: 'ok', timestamp: Date.now() }));\n                } else {\n                    res.writeHead(HTTP_NOT_FOUND, { 'Content-Type': 'application/json' });\n                    res.end(JSON.stringify({ status: 'not found' }));\n                }\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 no 'error' listener at all crashes the process\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(`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    /**\n     * Stops the health check server.\n     * @internal\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 { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { FRAMEWORK_CHANNELS, Logger } from '@seedcord/logger';\n\nimport { StartupPhase } from '@src/lifecycle/phases';\nimport { finalizePluginContext } from '@src/plugin/context';\nimport { resolvedLifecycleSpecOf } from '@src/plugin/Plugin';\n\nimport { withTimeout } from './Lifecycle/withTimeout';\n\nimport type { CoreBase } from '@interfaces/CoreBase';\nimport type { CoordinatedShutdown } from '@node/Lifecycle/CoordinatedShutdown';\nimport type { CoordinatedStartup } from '@node/Lifecycle/CoordinatedStartup';\nimport type { Config, IRateLimiter, Store } from '@seedcord/types';\nimport type { ShutdownPhase } from '@src/lifecycle/phases';\nimport type { PluginCapabilities, PluginContext, StoredPluginContext } from '@src/plugin/context';\nimport type { ChannelKeyAssert, Runtime, RuntimeAssert, Transport, TransportAssert } from '@src/plugin/options';\nimport type { CoreParamAssert, PluginArgs, PluginCtor, PluginLike } from '@src/plugin/Plugin';\nimport type { Bus } from '@subscribers/Bus';\n\ninterface Attachment {\n    readonly key: string;\n    readonly instance: PluginLike;\n}\n\nconst RESERVED_KEYS: ReadonlySet<string> = new Set(FRAMEWORK_CHANNELS);\n\n/**\n * Base class for objects that can have plugins attached.\n *\n * Plugins are attached during configuration and initialized during startup, sequentially in attach\n * order within each phase. Not constructed directly, the host is a transport `Seedcord` class.\n */\n// no defaults, a default runtime of the full union contains 'edge' and RuntimeAssert rejects every plugin on that\nexport abstract class Pluggable<BotT extends Transport, BotRt extends Runtime> implements CoreBase {\n    public abstract readonly config: Config;\n    public abstract readonly rateLimiter: IRateLimiter;\n    public abstract readonly bus: Bus;\n\n    /** @see {@link CoordinatedShutdown} */\n    public readonly shutdown: CoordinatedShutdown;\n\n    /** @see {@link CoordinatedStartup} */\n    public readonly startup: CoordinatedStartup;\n\n    protected isInitialized = false;\n    protected startFailed = false;\n    protected readonly plugins: PluginLike[] = [];\n\n    private readonly pluginLogger = new Logger('Plugins', { channel: 'plugins' });\n\n    private readonly attachments: Attachment[] = [];\n    private readonly completedInits = new Set<Attachment>();\n    private readonly disposePhases = new Set<ShutdownPhase>();\n    private pluginTasksRegistered = false;\n\n    private static isInstantiated = false;\n    private static liveShutdown?: CoordinatedShutdown | undefined;\n\n    constructor(shutdown: CoordinatedShutdown, startup: CoordinatedStartup) {\n        if (Pluggable.isInstantiated) {\n            // the caller constructed this shutdown, its signal handlers leak unless dropped here\n            shutdown.removeSignalHandlers();\n            throw new SeedcordError(SeedcordErrorCode.CoreSingletonViolation);\n        }\n\n        Pluggable.isInstantiated = true;\n        Pluggable.liveShutdown = shutdown;\n        this.shutdown = shutdown;\n        this.startup = startup;\n    }\n\n    /** @internal */\n    protected async init(): Promise<this> {\n        if (this.isInitialized) return this;\n        // a rerun after a failed startup would re-init the rolled-back plugins\n        if (this.startFailed) throw new SeedcordError(SeedcordErrorCode.LifecycleRestartAfterFailure);\n\n        this.registerPluginTasks();\n\n        const startupSettled: PromiseWithResolvers<void> = Promise.withResolvers();\n        this.shutdown.gateOnStartup(startupSettled.promise);\n\n        try {\n            await this.startup.run();\n        } catch (caught) {\n            await this.rollback();\n            throw caught;\n        } finally {\n            startupSettled.resolve();\n        }\n\n        this.isInitialized = true;\n        return this;\n    }\n\n    // transports override to inject client/token/rest\n    protected pluginCapabilities(): PluginCapabilities {\n        return {};\n    }\n\n    protected pluginStore(): Store<'charge'> {\n        // justified: both assignment branches of rateLimiter are Store<'charge'> at the hosts\n        return this.config.store ?? (this.rateLimiter as Store<'charge'>);\n    }\n\n    /** @internal codegen reads these to emit the `Core` augmentation */\n    public get pluginKeys(): readonly string[] {\n        return this.attachments.map((attachment) => attachment.key);\n    }\n\n    /** @internal releases the signal handlers and clears the singleton so the next host can construct */\n    protected static reset(): void {\n        Pluggable.liveShutdown?.removeSignalHandlers();\n        Pluggable.liveShutdown = undefined;\n        Pluggable.isInstantiated = false;\n    }\n\n    /**\n     * Attaches a plugin to this instance.\n     *\n     * The plugin initializes during startup, after every plugin attached before it, and becomes\n     * available as a property on `core`. `seedcord codegen` writes the `Core` augmentation that\n     * types it.\n     *\n     * A plugin declaring a `transport` or `runtime` this host does not run is a compile error on\n     * this call. An edge host takes no plugins at all. A plugin constructor narrowing its first\n     * parameter past `CoreBase` is a compile error here too. Read the transport `Core` off `this.core`.\n     *\n     * @typeParam Key - The property name for accessing the plugin\n     * @typeParam Ctor - The plugin constructor type\n     * @param key - Property name to access the plugin instance\n     * @param Plugin - Plugin constructor class\n     * @param args - Additional arguments to pass to the plugin constructor\n     * @returns This instance with the plugin attached as a typed property\n     * @throws A **SeedcordError** When called after initialization or if key already exists or is reserved\n     * @example\n     * ```typescript\n     * seedcord.attach('db', Mongoose, { uri: 'mongodb://...', name: 'seedcord', dir: ... })\n     * ```\n     */\n    public attach<Key extends string, Ctor extends PluginCtor>(\n        this: this,\n        key: ChannelKeyAssert<Key>,\n        Plugin: Ctor &\n            TransportAssert<InstanceType<Ctor>, BotT> &\n            RuntimeAssert<InstanceType<Ctor>, BotRt> &\n            CoreParamAssert<Ctor>,\n        ...args: PluginArgs<Ctor>\n    ): this & Record<Key, InstanceType<Ctor>> {\n        if (this.isInitialized) {\n            throw new SeedcordError(SeedcordErrorCode.CorePluginAfterInit);\n        }\n        // several reserved channels are also members on a host, which the next check would report first\n        if (RESERVED_KEYS.has(key)) {\n            throw new SeedcordError(SeedcordErrorCode.CorePluginReservedChannel, [key]);\n        }\n        if (key in this) {\n            throw new SeedcordError(SeedcordErrorCode.CorePluginKeyExists, [key]);\n        }\n\n        const instance = new Plugin(this, ...args);\n        this.plugins.push(instance);\n        this.attachments.push({ key, instance });\n        this.finalizeContext(key, instance);\n\n        return Object.assign(this, { [key]: instance } as Record<Key, InstanceType<Ctor>>);\n    }\n\n    private finalizeContext(key: string, instance: PluginLike): void {\n        const caps = this.pluginCapabilities();\n        const readToken = (): string | undefined => this.pluginCapabilities().token;\n        instance.logger.setChannel(key);\n        const ctx: StoredPluginContext = {\n            config: this.config,\n            store: this.pluginStore(),\n            client: caps.client,\n            // http sets the token during Ready, read it live\n            get token(): string | undefined {\n                return readToken();\n            },\n            rest: caps.rest\n        };\n        finalizePluginContext(instance, ctx as PluginContext);\n    }\n\n    // one combined task per phase keeps plugin inits sequential while the phase's other tasks run concurrently\n    private registerPluginTasks(): void {\n        if (this.pluginTasksRegistered) return;\n        this.pluginTasksRegistered = true;\n\n        const groups = new Map<StartupPhase, Attachment[]>();\n        for (const attachment of this.attachments) {\n            const phase = resolvedLifecycleSpecOf(attachment.instance).init.phase;\n            const group = groups.get(phase) ?? [];\n            group.push(attachment);\n            groups.set(phase, group);\n        }\n\n        for (const [phase, group] of groups) {\n            // Ready inits run in the combined Ready task, before the ready hooks\n            if (phase === StartupPhase.Ready) continue;\n            const budget = group.reduce((sum, a) => sum + resolvedLifecycleSpecOf(a.instance).init.timeout, 0);\n            this.startup.addTask(phase, 'plugins-init', () => this.runInits(group), budget);\n        }\n\n        this.registerReadyTask(groups.get(StartupPhase.Ready) ?? []);\n    }\n\n    private async runInits(group: readonly Attachment[]): Promise<void> {\n        for (const attachment of group) {\n            const { key, instance } = attachment;\n            const spec = resolvedLifecycleSpecOf(instance);\n\n            instance.logger.utils.initialization(key, 'start');\n            await withTimeout(`Plugin (${key})`, () => instance.init(), spec.init.timeout);\n            instance.logger.utils.initialization(key, 'end');\n\n            this.completedInits.add(attachment);\n            if (instance.dispose) this.registerDisposeTask(spec.dispose.phase);\n        }\n    }\n\n    private registerReadyTask(readyInits: readonly Attachment[]): void {\n        const steps = this.attachments.reduce<{ key: string; run: () => Promise<void>; timeout: number }[]>(\n            (acc, a) => {\n                const ready = a.instance.ready?.bind(a.instance);\n                if (ready) {\n                    acc.push({\n                        key: a.key,\n                        run: ready,\n                        timeout: resolvedLifecycleSpecOf(a.instance).ready.timeout\n                    });\n                }\n                return acc;\n            },\n            []\n        );\n        if (readyInits.length === 0 && steps.length === 0) return;\n\n        const budget =\n            readyInits.reduce((sum, a) => sum + resolvedLifecycleSpecOf(a.instance).init.timeout, 0) +\n            steps.reduce((sum, step) => sum + step.timeout, 0);\n        this.startup.addTask(\n            StartupPhase.Ready,\n            'plugins-ready',\n            async () => {\n                await this.runInits(readyInits);\n                for (const step of steps) {\n                    await withTimeout(`Plugin:${step.key}:ready`, step.run, step.timeout);\n                }\n            },\n            budget\n        );\n    }\n\n    private registerDisposeTask(phase: ShutdownPhase): void {\n        if (this.disposePhases.has(phase)) return;\n        this.disposePhases.add(phase);\n\n        // registered once per phase, later inits of that phase run in the same task\n        const budget = this.attachments.reduce((sum, a) => {\n            const spec = resolvedLifecycleSpecOf(a.instance);\n            return a.instance.dispose && spec.dispose.phase === phase ? sum + spec.dispose.timeout : sum;\n        }, 0);\n        this.shutdown.addTask(phase, 'plugins-dispose', () => this.runDisposals(phase), budget);\n    }\n\n    private async runDisposals(phase: ShutdownPhase): Promise<void> {\n        const failures: unknown[] = [];\n        // keep disposing the rest even when one fails\n        await this.disposeCompleted(phase, (caught) => failures.push(caught));\n        if (failures.length === 1) throw failures[0];\n        if (failures.length > 1) throw new AggregateError(failures, 'plugin dispose failures');\n    }\n\n    private async disposeCompleted(\n        phase: ShutdownPhase | undefined,\n        onError: (caught: unknown) => void\n    ): Promise<void> {\n        for (const attachment of [...this.attachments].reverse()) {\n            if (!this.completedInits.has(attachment)) continue;\n            const dispose = attachment.instance.dispose?.bind(attachment.instance);\n            if (!dispose) continue;\n            const spec = resolvedLifecycleSpecOf(attachment.instance);\n            if (phase !== undefined && spec.dispose.phase !== phase) continue;\n\n            try {\n                await withTimeout(`Plugin:${attachment.key}:dispose`, dispose, spec.dispose.timeout);\n            } catch (caught) {\n                onError(caught);\n            }\n        }\n    }\n\n    private async rollback(): Promise<void> {\n        this.startFailed = true;\n        // log rollback dispose failures so they do not hide the startup error\n        await this.disposeCompleted(undefined, (caught) => this.pluginLogger.warn('rollback dispose failed', caught));\n        // prevents re-dispose when shutdown runs after rollback\n        this.completedInits.clear();\n    }\n}\n","import { traverseDirectory } from '@seedcord/utils/node';\nimport chalk from 'chalk';\nimport { Envapter } from 'envapt';\n\nimport { HmrModuleHandler } from '@hmr/HmrModuleHandler';\nimport { SubscribeMetadataKey } from '@src/metadataKeys';\nimport { registrationFor, Subscriber } from '@subscribers/index';\n\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\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';\n\ntype SubscriberArtifact = SubscriptionKey[];\n\n/**\n * Loads subscribers off the filesystem into a {@link Bus} and stores their hot-reload wiring. Node\n * only, a bundled isolate registers from the manifest instead.\n *\n * @internal\n */\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: this.bus.logger\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            this.bus.logger.info(chalk.bold(directory));\n            await this.load(directory);\n            this.bus.logger.utils.list(\n                [`${chalk.bold.magenta(this.bus.registeredCount)} subscribers`],\n                chalk.bold.green('Loaded')\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                this.bus.logger.utils.registration(value.name, relativePath);\n            }\n        });\n    }\n\n    private registerSubscriber(ctor: StoredSubscriberCtor): void {\n        this.bus.register(registrationFor(ctor));\n    }\n\n    private unregisterSubscriber(ctor: StoredSubscriberCtor, artifacts?: SubscriberArtifact): void {\n        this.bus.unregister(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"],"mappings":"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"}

package/dist/phases-BfpAG6w3.mjs

@@ -0,0 +1,31 @@
+//#region src/lifecycle/phases.ts
+/**
+* Startup phases, in run order.
+*/
+let StartupPhase = /* @__PURE__ */ function(StartupPhase) {
+	/** Nothing connected. Plugin init runs here by default. */
+	StartupPhase[StartupPhase["Configuration"] = 1] = "Configuration";
+	/** The gateway session opens. Empty on http. */
+	StartupPhase[StartupPhase["Login"] = 2] = "Login";
+	/** Handlers are live and interactions dispatch. */
+	StartupPhase[StartupPhase["Ready"] = 3] = "Ready";
+	return StartupPhase;
+}({});
+/**
+* Shutdown phases, in run order.
+*/
+let ShutdownPhase = /* @__PURE__ */ function(ShutdownPhase) {
+	/** Stop taking new interactions and requests. */
+	ShutdownPhase[ShutdownPhase["Unbind"] = 1] = "Unbind";
+	/** Waits for in-flight work to settle and stops internal services. */
+	ShutdownPhase[ShutdownPhase["Drain"] = 2] = "Drain";
+	/** External resources close. Plugin dispose runs here by default. */
+	ShutdownPhase[ShutdownPhase["Disconnect"] = 3] = "Disconnect";
+	/** The client disconnects last so in-flight handlers can still reference it during drain. */
+	ShutdownPhase[ShutdownPhase["Logout"] = 4] = "Logout";
+	return ShutdownPhase;
+}({});
+
+//#endregion
+export { StartupPhase as n, ShutdownPhase as t };
+//# sourceMappingURL=phases-BfpAG6w3.mjs.map

package/dist/phases-BfpAG6w3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases-BfpAG6w3.mjs","names":[],"sources":["../src/lifecycle/phases.ts"],"sourcesContent":["/**\n * Startup phases, in run order.\n */\nexport enum StartupPhase {\n    /** Nothing connected. Plugin init runs here by default. */\n    Configuration = 1,\n    /** The gateway session opens. Empty on http. */\n    Login,\n    /** Handlers are live and interactions dispatch. */\n    Ready\n}\n\n/**\n * Shutdown phases, in run order.\n */\nexport enum ShutdownPhase {\n    /** Stop taking new interactions and requests. */\n    Unbind = 1,\n    /** Waits for in-flight work to settle and stops internal services. */\n    Drain,\n    /** External resources close. Plugin dispose runs here by default. */\n    Disconnect,\n    /** The client disconnects last so in-flight handlers can still reference it during drain. */\n    Logout\n}\n"],"mappings":";;;;AAGA,IAAY,eAAL;;CAEH;;CAEA;;CAEA;;AACJ;;;;AAKA,IAAY,gBAAL;;CAEH;;CAEA;;CAEA;;CAEA;;AACJ"}

package/dist/phases-C_BGNyVo.cjs

@@ -0,0 +1,43 @@
+
+//#region src/lifecycle/phases.ts
+/**
+* Startup phases, in run order.
+*/
+let StartupPhase = /* @__PURE__ */ function(StartupPhase) {
+	/** Nothing connected. Plugin init runs here by default. */
+	StartupPhase[StartupPhase["Configuration"] = 1] = "Configuration";
+	/** The gateway session opens. Empty on http. */
+	StartupPhase[StartupPhase["Login"] = 2] = "Login";
+	/** Handlers are live and interactions dispatch. */
+	StartupPhase[StartupPhase["Ready"] = 3] = "Ready";
+	return StartupPhase;
+}({});
+/**
+* Shutdown phases, in run order.
+*/
+let ShutdownPhase = /* @__PURE__ */ function(ShutdownPhase) {
+	/** Stop taking new interactions and requests. */
+	ShutdownPhase[ShutdownPhase["Unbind"] = 1] = "Unbind";
+	/** Waits for in-flight work to settle and stops internal services. */
+	ShutdownPhase[ShutdownPhase["Drain"] = 2] = "Drain";
+	/** External resources close. Plugin dispose runs here by default. */
+	ShutdownPhase[ShutdownPhase["Disconnect"] = 3] = "Disconnect";
+	/** The client disconnects last so in-flight handlers can still reference it during drain. */
+	ShutdownPhase[ShutdownPhase["Logout"] = 4] = "Logout";
+	return ShutdownPhase;
+}({});
+
+//#endregion
+Object.defineProperty(exports, 'ShutdownPhase', {
+  enumerable: true,
+  get: function () {
+    return ShutdownPhase;
+  }
+});
+Object.defineProperty(exports, 'StartupPhase', {
+  enumerable: true,
+  get: function () {
+    return StartupPhase;
+  }
+});
+//# sourceMappingURL=phases-C_BGNyVo.cjs.map

package/dist/phases-C_BGNyVo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases-C_BGNyVo.cjs","names":[],"sources":["../src/lifecycle/phases.ts"],"sourcesContent":["/**\n * Startup phases, in run order.\n */\nexport enum StartupPhase {\n    /** Nothing connected. Plugin init runs here by default. */\n    Configuration = 1,\n    /** The gateway session opens. Empty on http. */\n    Login,\n    /** Handlers are live and interactions dispatch. */\n    Ready\n}\n\n/**\n * Shutdown phases, in run order.\n */\nexport enum ShutdownPhase {\n    /** Stop taking new interactions and requests. */\n    Unbind = 1,\n    /** Waits for in-flight work to settle and stops internal services. */\n    Drain,\n    /** External resources close. Plugin dispose runs here by default. */\n    Disconnect,\n    /** The client disconnects last so in-flight handlers can still reference it during drain. */\n    Logout\n}\n"],"mappings":";;;;;AAGA,IAAY,eAAL;;CAEH;;CAEA;;CAEA;;AACJ;;;;AAKA,IAAY,gBAAL;;CAEH;;CAEA;;CAEA;;CAEA;;AACJ"}

package/dist/plugin.index.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_Plugin = require('./Plugin-Cgp1a0uQ.cjs');
+
+exports.Plugin = require_Plugin.Plugin;

package/dist/plugin.index.d.cts

@@ -0,0 +1 @@
+export type * from './plugin.index.d.mts'

package/dist/plugin.index.d.mts

@@ -0,0 +1,3 @@
+import { d as PluginCapabilityTypes, f as PluginContext, m as PluginOptions, n as Initializeable, r as Plugin, s as PluginLifecycleSpec } from "./Plugin-3rlH0uxH.mjs";
+import { HmrAware, HmrUpdateEvent } from "@seedcord/types";
+export { type HmrAware, type HmrUpdateEvent, type Initializeable, Plugin, type PluginCapabilityTypes, type PluginContext, type PluginLifecycleSpec, type PluginOptions };

package/dist/plugin.index.mjs

@@ -0,0 +1,3 @@
+import { t as Plugin } from "./Plugin-j9GYdroS.mjs";
+
+export { Plugin };

package/dist/publishDefault-CCf1azzW.mjs

@@ -0,0 +1,264 @@
+import { SeedcordErrorCode } from "@seedcord/errors";
+import { SeedcordRangeError, SeedcordTypeError } from "@seedcord/errors/internal";
+import { InteractionContextType, MessageFlags } from "discord-api-types/v10";
+import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, CheckboxBuilder, CheckboxGroupBuilder, CheckboxGroupOptionBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RadioGroupBuilder, RadioGroupOptionBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder } from "@discordjs/builders";
+
+//#region src/metadataKeys.ts
+let InteractionRoutes = /* @__PURE__ */ function(InteractionRoutes) {
+	InteractionRoutes["Slash"] = "slash";
+	InteractionRoutes["Button"] = "button";
+	InteractionRoutes["Modal"] = "modal";
+	InteractionRoutes["StringMenu"] = "stringMenu";
+	InteractionRoutes["UserMenu"] = "userMenu";
+	InteractionRoutes["RoleMenu"] = "roleMenu";
+	InteractionRoutes["ChannelMenu"] = "channelMenu";
+	InteractionRoutes["MentionableMenu"] = "mentionableMenu";
+	InteractionRoutes["MessageContextMenu"] = "messageContextMenu";
+	InteractionRoutes["UserContextMenu"] = "userContextMenu";
+	InteractionRoutes["Autocomplete"] = "autocomplete";
+	return InteractionRoutes;
+}({});
+const InteractionMetadataKey = Symbol("seedcord:interaction:metadata");
+const InteractionRouteKeys = {
+	["slash"]: Symbol("seedcord:interaction:slash"),
+	["button"]: Symbol("seedcord:interaction:button"),
+	["modal"]: Symbol("seedcord:interaction:modal"),
+	["stringMenu"]: Symbol("seedcord:interaction:stringMenu"),
+	["userMenu"]: Symbol("seedcord:interaction:userMenu"),
+	["roleMenu"]: Symbol("seedcord:interaction:roleMenu"),
+	["channelMenu"]: Symbol("seedcord:interaction:channelMenu"),
+	["mentionableMenu"]: Symbol("seedcord:interaction:mentionableMenu"),
+	["messageContextMenu"]: Symbol("seedcord:interaction:messageContextMenu"),
+	["userContextMenu"]: Symbol("seedcord:interaction:userContextMenu"),
+	["autocomplete"]: Symbol("seedcord:interaction:autocomplete")
+};
+const MiddlewareMetadataKey = Symbol("seedcord:middleware:metadata");
+const EventMetadataKey = Symbol("seedcord:event:metadata");
+const CommandMetadataKey = Symbol("seedcord:command:metadata");
+const GatedMetadataKey = Symbol("seedcord:gated:metadata");
+const SubscribeMetadataKey = Symbol("seedcord:subscribe:metadata");
+const WebhookUrlMetadataKey = Symbol("seedcord:webhookUrl:metadata");
+
+//#endregion
+//#region src/components/botColorHolder.ts
+const DEFAULT_COLOR = "Default";
+let current = DEFAULT_COLOR;
+function setBotColor(color) {
+	current = color ?? DEFAULT_COLOR;
+}
+function getBotColor() {
+	return current;
+}
+
+//#endregion
+//#region src/components/builderTypes.ts
+/**
+* Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.
+*
+* @internal
+*/
+const BuilderTypes = {
+	command: SlashCommandBuilder,
+	context_menu: ContextMenuCommandBuilder,
+	subcommand: SlashCommandSubcommandBuilder,
+	group: SlashCommandSubcommandGroupBuilder,
+	embed: EmbedBuilder,
+	modal: ModalBuilder,
+	label: LabelBuilder,
+	text_input: TextInputBuilder,
+	file_upload: FileUploadBuilder,
+	checkbox: CheckboxBuilder,
+	checkbox_group: CheckboxGroupBuilder,
+	checkbox_group_option: CheckboxGroupOptionBuilder,
+	radio_group: RadioGroupBuilder,
+	radio_group_option: RadioGroupOptionBuilder,
+	button: ButtonBuilder,
+	menu_string: StringSelectMenuBuilder,
+	menu_option_string: StringSelectMenuOptionBuilder,
+	menu_user: UserSelectMenuBuilder,
+	menu_channel: ChannelSelectMenuBuilder,
+	menu_mentionable: MentionableSelectMenuBuilder,
+	menu_role: RoleSelectMenuBuilder,
+	container: ContainerBuilder,
+	text_display: TextDisplayBuilder,
+	file: FileBuilder,
+	media: MediaGalleryBuilder,
+	section: SectionBuilder,
+	separator: SeparatorBuilder
+};
+/**
+* Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons
+*
+* @internal
+*/
+const RowTypes = {
+	button: ActionRowBuilder,
+	menu_string: ActionRowBuilder,
+	menu_user: ActionRowBuilder,
+	menu_channel: ActionRowBuilder,
+	menu_mentionable: ActionRowBuilder,
+	menu_role: ActionRowBuilder
+};
+
+//#endregion
+//#region src/components/colors.ts
+const Colors = {
+	Aqua: 1752220,
+	Blue: 3447003,
+	Blurple: 5793266,
+	DarkAqua: 1146986,
+	DarkBlue: 2123412,
+	DarkButNotBlack: 2895667,
+	DarkerGrey: 8359053,
+	DarkGold: 12745742,
+	DarkGreen: 2067276,
+	DarkGrey: 9936031,
+	DarkNavy: 2899536,
+	DarkOrange: 11027200,
+	DarkPurple: 7419530,
+	DarkRed: 10038562,
+	DarkVividPink: 11342935,
+	Default: 0,
+	Fuchsia: 15418782,
+	Gold: 15844367,
+	Green: 5763719,
+	Grey: 9807270,
+	Greyple: 10070709,
+	LightGrey: 12370112,
+	LuminousVividPink: 15277667,
+	Navy: 3426654,
+	NotQuiteBlack: 2303786,
+	Orange: 15105570,
+	Purple: 10181046,
+	Red: 15548997,
+	White: 16777215,
+	Yellow: 16705372
+};
+
+//#endregion
+//#region src/components/resolveColor.ts
+const MAX_COLOR = 16777215;
+const RED_SHIFT = 16;
+const GREEN_SHIFT = 8;
+const palette = Colors;
+/**
+* Resolves a {@link BotColor} to the integer Discord expects.
+*
+* Ported from discord.js (Apache-2.0), `resolveColor` in src/util/Util.js.
+*/
+function resolveColor(color) {
+	let resolved;
+	if (typeof color === "string") {
+		if (color === "Random") return Math.floor(Math.random() * 16777216);
+		if (color === "Default") return 0;
+		if (/^#?[\da-f]{6}$/i.test(color)) return Number.parseInt(color.replace("#", ""), 16);
+		resolved = palette[color];
+	} else if (typeof color === "number") resolved = color;
+	else resolved = (color[0] << RED_SHIFT) + (color[1] << GREEN_SHIFT) + color[2];
+	if (resolved === void 0 || !Number.isSafeInteger(resolved)) throw new SeedcordTypeError(SeedcordErrorCode.ColorUnresolvable, [JSON.stringify(color)]);
+	if (resolved < 0 || resolved > MAX_COLOR) throw new SeedcordRangeError(SeedcordErrorCode.ColorOutOfRange);
+	return resolved;
+}
+
+//#endregion
+//#region src/components/Component.ts
+/**
+* Base class for Discord component wrappers.
+*
+* @typeParam TComponent - The Discord.js component type being wrapped
+*
+* @internal
+*/
+var BaseComponent = class {
+	_component;
+	constructor(ComponentClass) {
+		this._component = new ComponentClass();
+	}
+	/**
+	* The wrapped builder, for calling Discord.js methods like setTitle() and setDescription() inside a subclass.
+	*
+	* @example this.instance.setTitle('My Modal')
+	*/
+	get instance() {
+		return this._component;
+	}
+};
+/**
+* Base class for Discord.js builder components
+*
+* Wraps Discord.js builders (SlashCommandBuilder, EmbedBuilder, etc.) with
+* Seedcord-specific defaults and helper methods.
+*
+* @typeParam BuilderKey - The type of Discord.js builder being wrapped
+*/
+var BuilderComponent = class extends BaseComponent {
+	type;
+	colorApplied = false;
+	constructor(type) {
+		const ComponentClass = BuilderTypes[type];
+		super(ComponentClass);
+		this.type = type;
+		if (this.instance instanceof SlashCommandBuilder || this.instance instanceof ContextMenuCommandBuilder) this.instance.setContexts(InteractionContextType.Guild);
+	}
+	get component() {
+		this.applyBotColor();
+		return this.instance;
+	}
+	applyBotColor() {
+		if (this.colorApplied) return;
+		this.colorApplied = true;
+		const color = getBotColor();
+		if (this.instance instanceof EmbedBuilder) {
+			if (this.instance.data.color === void 0) this.instance.setColor(resolveColor(color));
+		} else if (this.instance instanceof ContainerBuilder) {
+			const accent = this.instance.data.accent_color;
+			if (accent === null || accent === void 0) this.instance.setAccentColor(color === "Default" ? void 0 : resolveColor(color));
+		}
+	}
+};
+/**
+* Base class for Discord action row components
+*
+* Wraps Discord.js action row builder with Seedcord-specific defaults and helper methods.
+*
+* @typeParam RowKey - The Discord.js action row type being wrapped
+*/
+var RowComponent = class extends BaseComponent {
+	type;
+	constructor(type) {
+		const ComponentClass = RowTypes[type];
+		super(ComponentClass);
+		this.type = type;
+	}
+	get component() {
+		return this.instance;
+	}
+};
+
+//#endregion
+//#region src/reply/flags.ts
+/** IsComponentsV2 is unconditional, every framework reply is v2. */
+function sendFlags(opts) {
+	let flags = MessageFlags.IsComponentsV2;
+	if (opts?.ephemeral ?? true) flags |= MessageFlags.Ephemeral;
+	if (opts?.silent) flags |= MessageFlags.SuppressNotifications;
+	return flags;
+}
+/** A deferral carries no content, so only Ephemeral applies. */
+function deferFlags(opts) {
+	return opts?.ephemeral ?? true ? MessageFlags.Ephemeral : 0;
+}
+
+//#endregion
+//#region src/subscribers/publishDefault.ts
+/**
+* The key of the Bus method that emits the framework's own subscriptions. `publish` excludes these keys
+* through `PublishableKey`, and this symbol is exported only from the internal entry.
+*
+* @internal
+*/
+const PublishDefault = Symbol("seedcord.publishDefault");
+
+//#endregion
+export { RowComponent as a, EventMetadataKey as c, InteractionRouteKeys as d, InteractionRoutes as f, WebhookUrlMetadataKey as h, BuilderComponent as i, GatedMetadataKey as l, SubscribeMetadataKey as m, deferFlags as n, setBotColor as o, MiddlewareMetadataKey as p, sendFlags as r, CommandMetadataKey as s, PublishDefault as t, InteractionMetadataKey as u };
+//# sourceMappingURL=publishDefault-CCf1azzW.mjs.map

package/dist/publishDefault-CCf1azzW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishDefault-CCf1azzW.mjs","names":[],"sources":["../src/metadataKeys.ts","../src/components/botColorHolder.ts","../src/components/builderTypes.ts","../src/components/colors.ts","../src/components/resolveColor.ts","../src/components/Component.ts","../src/reply/flags.ts","../src/subscribers/publishDefault.ts"],"sourcesContent":["export enum InteractionRoutes {\n    Slash = 'slash',\n    Button = 'button',\n    Modal = 'modal',\n    StringMenu = 'stringMenu',\n    UserMenu = 'userMenu',\n    RoleMenu = 'roleMenu',\n    ChannelMenu = 'channelMenu',\n    MentionableMenu = 'mentionableMenu',\n    MessageContextMenu = 'messageContextMenu',\n    UserContextMenu = 'userContextMenu',\n    Autocomplete = 'autocomplete'\n}\n\nexport const InteractionMetadataKey = Symbol('seedcord:interaction:metadata');\n\nexport const InteractionRouteKeys: Record<InteractionRoutes, symbol> = {\n    [InteractionRoutes.Slash]: Symbol('seedcord:interaction:slash'),\n    [InteractionRoutes.Button]: Symbol('seedcord:interaction:button'),\n    [InteractionRoutes.Modal]: Symbol('seedcord:interaction:modal'),\n    [InteractionRoutes.StringMenu]: Symbol('seedcord:interaction:stringMenu'),\n    [InteractionRoutes.UserMenu]: Symbol('seedcord:interaction:userMenu'),\n    [InteractionRoutes.RoleMenu]: Symbol('seedcord:interaction:roleMenu'),\n    [InteractionRoutes.ChannelMenu]: Symbol('seedcord:interaction:channelMenu'),\n    [InteractionRoutes.MentionableMenu]: Symbol('seedcord:interaction:mentionableMenu'),\n    [InteractionRoutes.MessageContextMenu]: Symbol('seedcord:interaction:messageContextMenu'),\n    [InteractionRoutes.UserContextMenu]: Symbol('seedcord:interaction:userContextMenu'),\n    [InteractionRoutes.Autocomplete]: Symbol('seedcord:interaction:autocomplete')\n};\n\nexport const MiddlewareMetadataKey = Symbol('seedcord:middleware:metadata');\n\nexport const EventMetadataKey = Symbol('seedcord:event:metadata');\n\nexport const CommandMetadataKey = Symbol('seedcord:command:metadata');\n\nexport const GatedMetadataKey = Symbol('seedcord:gated:metadata');\n\nexport const SubscribeMetadataKey = Symbol('seedcord:subscribe:metadata');\n\nexport const WebhookUrlMetadataKey = Symbol('seedcord:webhookUrl:metadata');\n","import type { BotColor } from '@seedcord/types';\n\n// must be 'Default' so the container guard in applyBotColor leaves the accent unset\nconst DEFAULT_COLOR: BotColor = 'Default';\n\nlet current: BotColor = DEFAULT_COLOR;\n\nexport function setBotColor(color: BotColor | undefined): void {\n    current = color ?? DEFAULT_COLOR;\n}\n\nexport function getBotColor(): BotColor {\n    return current;\n}\n","import {\n    ActionRowBuilder,\n    ButtonBuilder,\n    ChannelSelectMenuBuilder,\n    CheckboxBuilder,\n    CheckboxGroupBuilder,\n    CheckboxGroupOptionBuilder,\n    ContainerBuilder,\n    ContextMenuCommandBuilder,\n    EmbedBuilder,\n    FileBuilder,\n    FileUploadBuilder,\n    LabelBuilder,\n    MediaGalleryBuilder,\n    MentionableSelectMenuBuilder,\n    ModalBuilder,\n    RadioGroupBuilder,\n    RadioGroupOptionBuilder,\n    RoleSelectMenuBuilder,\n    SectionBuilder,\n    SeparatorBuilder,\n    SlashCommandBuilder,\n    SlashCommandSubcommandBuilder,\n    SlashCommandSubcommandGroupBuilder,\n    StringSelectMenuBuilder,\n    StringSelectMenuOptionBuilder,\n    TextDisplayBuilder,\n    TextInputBuilder,\n    UserSelectMenuBuilder\n} from '@discordjs/builders';\n\n/**\n * Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.\n *\n * @internal\n */\nexport const BuilderTypes = {\n    // Command Components\n    command: SlashCommandBuilder,\n    context_menu: ContextMenuCommandBuilder,\n    subcommand: SlashCommandSubcommandBuilder,\n    group: SlashCommandSubcommandGroupBuilder,\n\n    // Embed Components\n    embed: EmbedBuilder,\n\n    // Modal Components\n    modal: ModalBuilder,\n    label: LabelBuilder,\n    text_input: TextInputBuilder,\n    file_upload: FileUploadBuilder,\n    checkbox: CheckboxBuilder,\n    checkbox_group: CheckboxGroupBuilder,\n    checkbox_group_option: CheckboxGroupOptionBuilder,\n    radio_group: RadioGroupBuilder,\n    radio_group_option: RadioGroupOptionBuilder,\n\n    // Action Row Components\n    button: ButtonBuilder,\n    menu_string: StringSelectMenuBuilder,\n    menu_option_string: StringSelectMenuOptionBuilder,\n    menu_user: UserSelectMenuBuilder,\n    menu_channel: ChannelSelectMenuBuilder,\n    menu_mentionable: MentionableSelectMenuBuilder,\n    menu_role: RoleSelectMenuBuilder,\n\n    // ComponentsV2\n    container: ContainerBuilder,\n    text_display: TextDisplayBuilder,\n    file: FileBuilder,\n    media: MediaGalleryBuilder,\n    section: SectionBuilder,\n    separator: SeparatorBuilder\n};\n\n/**\n * Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons\n *\n * @internal\n */\nexport const RowTypes: {\n    button: typeof ActionRowBuilder<ButtonBuilder>;\n    menu_string: typeof ActionRowBuilder<StringSelectMenuBuilder>;\n    menu_user: typeof ActionRowBuilder<UserSelectMenuBuilder>;\n    menu_channel: typeof ActionRowBuilder<ChannelSelectMenuBuilder>;\n    menu_mentionable: typeof ActionRowBuilder<MentionableSelectMenuBuilder>;\n    menu_role: typeof ActionRowBuilder<RoleSelectMenuBuilder>;\n} = {\n    button: ActionRowBuilder<ButtonBuilder>,\n    menu_string: ActionRowBuilder<StringSelectMenuBuilder>,\n    menu_user: ActionRowBuilder<UserSelectMenuBuilder>,\n    menu_channel: ActionRowBuilder<ChannelSelectMenuBuilder>,\n    menu_mentionable: ActionRowBuilder<MentionableSelectMenuBuilder>,\n    menu_role: ActionRowBuilder<RoleSelectMenuBuilder>\n};\n\n/**\n * Available Discord.js builder types for use with BuilderComponent\n */\nexport type BuilderType = keyof typeof BuilderTypes;\n\n/**\n * @internal\n */\nexport type InstantiatedBuilder<BuilderKey extends BuilderType> = InstanceType<(typeof BuilderTypes)[BuilderKey]>;\n\n/**\n * Available Discord.js action row types for use with RowComponent\n */\nexport type RowType = keyof typeof RowTypes;\n\n/**\n * @internal\n */\nexport type InstantiatedActionRow<RowKey extends RowType> = InstanceType<(typeof RowTypes)[RowKey]>;\n","import type { ColorName, TypedOmit } from '@seedcord/types';\n\n// Ported verbatim from discord.js (Apache-2.0), src/util/Colors.js.\nexport const Colors: TypedOmit<Record<ColorName, number>, 'Random'> = {\n    Aqua: 0x1a_bc_9c,\n    Blue: 0x34_98_db,\n    Blurple: 0x58_65_f2,\n    DarkAqua: 0x11_80_6a,\n    DarkBlue: 0x20_66_94,\n    DarkButNotBlack: 0x2c_2f_33,\n    DarkerGrey: 0x7f_8c_8d,\n    DarkGold: 0xc2_7c_0e,\n    DarkGreen: 0x1f_8b_4c,\n    DarkGrey: 0x97_9c_9f,\n    DarkNavy: 0x2c_3e_50,\n    DarkOrange: 0xa8_43_00,\n    DarkPurple: 0x71_36_8a,\n    DarkRed: 0x99_2d_22,\n    DarkVividPink: 0xad_14_57,\n    Default: 0x00_00_00,\n    Fuchsia: 0xeb_45_9e,\n    Gold: 0xf1_c4_0f,\n    Green: 0x57_f2_87,\n    Grey: 0x95_a5_a6,\n    Greyple: 0x99_aa_b5,\n    LightGrey: 0xbc_c0_c0,\n    LuminousVividPink: 0xe9_1e_63,\n    Navy: 0x34_49_5e,\n    NotQuiteBlack: 0x23_27_2a,\n    Orange: 0xe6_7e_22,\n    Purple: 0x9b_59_b6,\n    Red: 0xed_42_45,\n    White: 0xff_ff_ff,\n    Yellow: 0xfe_e7_5c\n} as const;\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordRangeError, SeedcordTypeError } from '@seedcord/errors/internal';\n\nimport { Colors } from './colors';\n\nimport type { BotColor } from '@seedcord/types';\n\nconst MAX_COLOR = 0xff_ff_ff;\nconst RED_SHIFT = 16;\nconst GREEN_SHIFT = 8;\n\nconst palette: Record<string, number | undefined> = Colors;\n\n/**\n * Resolves a {@link BotColor} to the integer Discord expects.\n *\n * Ported from discord.js (Apache-2.0), `resolveColor` in src/util/Util.js.\n */\nexport function resolveColor(color: BotColor): number {\n    let resolved: number | undefined;\n\n    if (typeof color === 'string') {\n        if (color === 'Random') return Math.floor(Math.random() * (MAX_COLOR + 1));\n        if (color === 'Default') return 0;\n        if (/^#?[\\da-f]{6}$/i.test(color)) return Number.parseInt(color.replace('#', ''), 16);\n        resolved = palette[color];\n    } else if (typeof color === 'number') {\n        resolved = color;\n    } else {\n        resolved = (color[0] << RED_SHIFT) + (color[1] << GREEN_SHIFT) + color[2];\n    }\n\n    if (resolved === undefined || !Number.isSafeInteger(resolved)) {\n        throw new SeedcordTypeError(SeedcordErrorCode.ColorUnresolvable, [JSON.stringify(color)]);\n    }\n    if (resolved < 0 || resolved > MAX_COLOR) {\n        throw new SeedcordRangeError(SeedcordErrorCode.ColorOutOfRange);\n    }\n\n    return resolved;\n}\n","import { ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, SlashCommandBuilder } from '@discordjs/builders';\nimport { InteractionContextType } from 'discord-api-types/v10';\n\nimport { getBotColor } from './botColorHolder';\nimport { BuilderTypes, RowTypes } from './builderTypes';\nimport { resolveColor } from './resolveColor';\n\nimport type { BuilderType, InstantiatedActionRow, InstantiatedBuilder, RowType } from './builderTypes';\n\n/**\n * Base class for Discord component wrappers.\n *\n * @typeParam TComponent - The Discord.js component type being wrapped\n *\n * @internal\n */\nabstract class BaseComponent<TComponent> {\n    private readonly _component: TComponent;\n\n    protected constructor(ComponentClass: new () => TComponent) {\n        this._component = new ComponentClass();\n    }\n\n    /**\n     * Returns the live builder, ready to send in a Discord message or nest in another component.\n     *\n     * Configure it through `this.instance`. Reading this can apply the bot color (see\n     * {@link BuilderComponent}), so it has a side effect.\n     * @example new SomeComponent().component\n     */\n    public abstract get component(): InstantiatedBuilder<BuilderType> | InstantiatedActionRow<RowType>;\n\n    /**\n     * The wrapped builder, for calling Discord.js methods like setTitle() and setDescription() inside a subclass.\n     *\n     * @example this.instance.setTitle('My Modal')\n     */\n    protected get instance(): TComponent {\n        return this._component;\n    }\n}\n\n/**\n * Base class for Discord.js builder components\n *\n * Wraps Discord.js builders (SlashCommandBuilder, EmbedBuilder, etc.) with\n * Seedcord-specific defaults and helper methods.\n *\n * @typeParam BuilderKey - The type of Discord.js builder being wrapped\n */\nexport abstract class BuilderComponent<BuilderKey extends BuilderType> extends BaseComponent<\n    InstantiatedBuilder<BuilderKey>\n> {\n    private colorApplied = false;\n\n    protected constructor(public readonly type: BuilderKey) {\n        const ComponentClass = BuilderTypes[type] as unknown;\n        super(ComponentClass as new () => InstantiatedBuilder<BuilderKey>);\n\n        if (this.instance instanceof SlashCommandBuilder || this.instance instanceof ContextMenuCommandBuilder) {\n            this.instance.setContexts(InteractionContextType.Guild);\n        }\n    }\n\n    get component(): InstantiatedBuilder<BuilderKey> {\n        this.applyBotColor();\n        return this.instance;\n    }\n\n    // Resolving in the constructor would capture the default for a component built before setBotColor()\n    // ran. The unset check keeps a color the subclass set for itself.\n    private applyBotColor(): void {\n        if (this.colorApplied) return;\n        this.colorApplied = true;\n\n        const color = getBotColor();\n        if (this.instance instanceof EmbedBuilder) {\n            if (this.instance.data.color === undefined) this.instance.setColor(resolveColor(color));\n        } else if (this.instance instanceof ContainerBuilder) {\n            const accent = this.instance.data.accent_color;\n            if (accent === null || accent === undefined) {\n                this.instance.setAccentColor(color === 'Default' ? undefined : resolveColor(color));\n            }\n        }\n    }\n}\n\n/**\n * Base class for Discord action row components\n *\n * Wraps Discord.js action row builder with Seedcord-specific defaults and helper methods.\n *\n * @typeParam RowKey - The Discord.js action row type being wrapped\n */\nexport abstract class RowComponent<RowKey extends RowType> extends BaseComponent<InstantiatedActionRow<RowKey>> {\n    protected constructor(public readonly type: RowKey) {\n        const ComponentClass = RowTypes[type] as unknown;\n        super(ComponentClass as new () => InstantiatedActionRow<RowKey>);\n    }\n\n    get component(): InstantiatedActionRow<RowKey> {\n        return this.instance;\n    }\n}\n","import { MessageFlags } from 'discord-api-types/v10';\n\nimport type { DeferOpts, SendOpts } from '@seedcord/types';\n\n/** IsComponentsV2 is unconditional, every framework reply is v2. */\nexport function sendFlags(opts?: SendOpts): number {\n    let flags = MessageFlags.IsComponentsV2;\n    if (opts?.ephemeral ?? true) flags |= MessageFlags.Ephemeral;\n    if (opts?.silent) flags |= MessageFlags.SuppressNotifications;\n    return flags;\n}\n\n/** A deferral carries no content, so only Ephemeral applies. */\nexport function deferFlags(opts?: DeferOpts): number {\n    return (opts?.ephemeral ?? true) ? MessageFlags.Ephemeral : 0;\n}\n","/**\n * The key of the Bus method that emits the framework's own subscriptions. `publish` excludes these keys\n * through `PublishableKey`, and this symbol is exported only from the internal entry.\n *\n * @internal\n */\nexport const PublishDefault = Symbol('seedcord.publishDefault');\n"],"mappings":"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"}