@seedcord/core 0.10.0 → 0.11.0-next.0

package/dist/node.index.mjs

@@ -1,76 +1,12 @@
-import { n as StartupPhase, t as ShutdownPhase } from "./phases-BauKJOTT.mjs";
-import { a as withTimeout, i as settleWithin, t as Pluggable } from "./Pluggable-afy2H0Dr.mjs";
+import { t as ShutdownPhase } from "./phases-BauKJOTT.mjs";
+import { n as settleWithin } from "./PluginLifecycle-AhQ46NIr.mjs";
+import { n as CoordinatedLifecycle, t as CoordinatedStartup } from "./CoordinatedStartup-CGnJrqcl.mjs";
+import { t as ServerHost } from "./ServerHost-CvGQr7oN.mjs";
 import { SeedcordErrorCode, paint } from "@seedcord/errors";
-import { SeedcordAggregateError, SeedcordError, SeedcordRangeError, SeedcordTypeError } from "@seedcord/errors/internal";
-import { Logger } from "@seedcord/logger";
+import { SeedcordRangeError } from "@seedcord/errors/internal";
 
-//#region src/node/Lifecycle/CoordinatedLifecycle.ts
-var CoordinatedLifecycle = class {
-	phaseOrder;
-	phaseEnum;
-	logger;
-	tasksMap = /* @__PURE__ */ new Map();
-	constructor(loggerName, phaseOrder, phaseEnum) {
-		this.phaseOrder = phaseOrder;
-		this.phaseEnum = phaseEnum;
-		this.logger = new Logger(loggerName, { channel: "lifecycle" });
-		this.phaseOrder.forEach((phase) => this.tasksMap.set(phase, []));
-	}
-	addTask(phase, taskName, task, timeoutMs) {
-		if (!this.canAddTask()) return;
-		const tasks = this.tasksMap.get(phase);
-		if (!tasks) throw new SeedcordTypeError(SeedcordErrorCode.LifecycleUnknownPhase, [phase]);
-		tasks.push({
-			name: taskName,
-			task,
-			timeout: timeoutMs
-		});
-		this.logger.debug(`${paint.italic("Added")} ${this.getTaskType()} task ${paint.sky.bold(taskName)} to phase ${paint.iris.bold(this.phaseEnum[phase])}`);
-	}
-	removeTask(phase, taskName) {
-		if (!this.canRemoveTask()) return false;
-		const tasks = this.tasksMap.get(phase);
-		if (!tasks) return false;
-		const initialLength = tasks.length;
-		const filteredTasks = tasks.filter((task) => task.name !== taskName);
-		this.tasksMap.set(phase, filteredTasks);
-		const removed = initialLength !== filteredTasks.length;
-		if (removed) this.logger.debug(`${paint.italic("Removed")} ${this.getTaskType()} task ${paint.sky.bold(taskName)} from phase ${paint.iris.bold(this.phaseEnum[phase])}`);
-		return removed;
-	}
-	async runPhase(phase) {
-		const tasks = this.tasksMap.get(phase) ?? [];
-		if (tasks.length === 0) {
-			this.logger.trace(`No tasks to run in phase ${paint.iris.bold(this.phaseEnum[phase])}`);
-			return;
-		}
-		this.logger.debug(`${paint.amber.bold("Running")} ${this.getTaskType()} phase ${paint.iris.bold(this.phaseEnum[phase])} with ${paint.sky.bold(String(tasks.length))} tasks`);
-		const reasons = (await this.executeTasksInPhase(phase, tasks)).reduce((rejected, result) => {
-			if (result.status === "rejected") rejected.push(result.reason);
-			return rejected;
-		}, []);
-		if (reasons.length > 0) throw new SeedcordAggregateError(SeedcordErrorCode.LifecyclePhaseFailures, reasons, [this.phaseEnum[phase], reasons.length]);
-		this.logger.debug(`Phase ${paint.iris.bold(this.phaseEnum[phase])} ${paint.mint.bold("completed successfully")}`);
-	}
-	async runTaskWithTimeout(phase, task) {
-		this.logger.trace(`${paint.italic("Starting")} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}`);
-		try {
-			await withTimeout(task.name, task.task, task.timeout);
-			this.logger.trace(`${paint.italic("Completed")} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}`);
-		} catch (error) {
-			if (this.isAborted()) return;
-			this.logger.error(`${paint.italic("Failed")} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}:`, error);
-			throw error;
-		}
-	}
-	isAborted() {
-		return false;
-	}
-};
-
-//#endregion
 //#region src/node/Lifecycle/CoordinatedShutdown.ts
-const PHASE_ORDER$1 = [
+const PHASE_ORDER = [
 	1,
 	2,
 	3,
@@ -79,36 +15,34 @@ const PHASE_ORDER$1 = [
 const LOG_FLUSH_DELAY_MS = 3e3;
 const DEFAULT_SHUTDOWN_DEADLINE_MS = 25e3;
 var CoordinatedShutdown = class extends CoordinatedLifecycle {
-	isShuttingDown = false;
-	hasShutdown = false;
-	exitCode = 0;
-	onSigTerm = null;
-	onSigInt = null;
-	startupGate;
-	deadlineMs = DEFAULT_SHUTDOWN_DEADLINE_MS;
-	phasesExpireAt = Infinity;
-	runningPhase;
+	#running;
+	#exitCode = 0;
+	#onSigTerm = null;
+	#onSigInt = null;
+	#startupGate;
+	#deadlineMs = DEFAULT_SHUTDOWN_DEADLINE_MS;
+	#phasesExpireAt = Infinity;
+	#runningPhase;
 	constructor(deadlineMs) {
-		super("Shutdown", PHASE_ORDER$1, ShutdownPhase);
+		super("Shutdown", PHASE_ORDER, ShutdownPhase);
 		if (deadlineMs !== void 0) this.setDeadline(deadlineMs);
-		this.registerSignalHandlers();
 	}
 	/** @internal */
 	setDeadline(deadlineMs) {
-		if (!Number.isFinite(deadlineMs) || deadlineMs <= 0) throw new SeedcordRangeError(SeedcordErrorCode.LifecycleInvalidShutdownDeadline, [deadlineMs]);
-		this.deadlineMs = deadlineMs;
+		if (!Number.isFinite(deadlineMs) || deadlineMs <= 0) throw new SeedcordRangeError(SeedcordErrorCode.LifecycleInvalidTimeout, ["lifecycle.shutdownDeadline", deadlineMs]);
+		this.#deadlineMs = deadlineMs;
 	}
-	async runPhases(failures) {
-		for (const phase of PHASE_ORDER$1) {
-			this.runningPhase = phase;
-			if (performance.now() >= this.phasesExpireAt) return;
+	async #runPhases(failures) {
+		for (const phase of PHASE_ORDER) {
+			this.#runningPhase = phase;
+			if (performance.now() >= this.#phasesExpireAt) return;
 			try {
 				await this.runPhase(phase);
 			} catch (error) {
 				failures.push(error);
 			}
 		}
-		this.runningPhase = void 0;
+		this.#runningPhase = void 0;
 	}
 	canAddTask() {
 		return true;
@@ -123,31 +57,32 @@ var CoordinatedShutdown = class extends CoordinatedLifecycle {
 		const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));
 		return Promise.allSettled(promises);
 	}
+	/** @internal */
 	registerSignalHandlers() {
-		this.onSigTerm = () => {
+		this.#onSigTerm = () => {
 			this.logger.info(`Received ${paint.amber.bold("SIGTERM")} signal`);
 			this.run(0);
 		};
-		this.onSigInt = () => {
+		this.#onSigInt = () => {
 			this.logger.info(`Received ${paint.amber.bold("SIGINT")} signal`);
 			this.run(0);
 		};
-		process.on("SIGTERM", this.onSigTerm);
-		process.on("SIGINT", this.onSigInt);
+		process.on("SIGTERM", this.#onSigTerm);
+		process.on("SIGINT", this.#onSigInt);
 	}
 	/** @internal */
 	removeSignalHandlers() {
-		if (this.onSigTerm) {
-			process.off("SIGTERM", this.onSigTerm);
-			this.onSigTerm = null;
+		if (this.#onSigTerm) {
+			process.off("SIGTERM", this.#onSigTerm);
+			this.#onSigTerm = null;
 		}
-		if (!this.onSigInt) return;
-		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) {
-		this.startupGate = settled;
+		this.#startupGate = settled;
 	}
 	addTask(phase, taskName, task, timeoutMs = 5e3) {
 		super.addTask(phase, taskName, task, timeoutMs);
@@ -157,120 +92,38 @@ var CoordinatedShutdown = class extends CoordinatedLifecycle {
 		return super.removeTask(phase, taskName);
 	}
 	/** @internal */
-	async run(exitCode = 0, exitProcess = true) {
+	run(exitCode = 0, exitProcess = true) {
 		this.removeSignalHandlers();
-		if (this.hasShutdown || this.isShuttingDown) {
-			if (exitCode > this.exitCode) this.exitCode = exitCode;
-			this.logger.warn("Shutdown sequence already ran or is in progress");
-			return;
+		if (this.#running) {
+			if (exitCode > this.#exitCode) this.#exitCode = exitCode;
+			return this.#running;
 		}
-		this.isShuttingDown = true;
-		this.exitCode = exitCode;
-		this.logger.info(`${paint.amber.bold("Starting")} coordinated shutdown with exit code ${paint.sky.bold(exitCode)}`);
+		this.#exitCode = exitCode;
+		this.#running = this.#shutDown(exitProcess);
+		return this.#running;
+	}
+	async #shutDown(exitProcess) {
+		this.logger.info(`${paint.amber.bold("Starting")} coordinated shutdown with exit code ${paint.sky.bold(this.#exitCode)}`);
 		try {
-			this.phasesExpireAt = performance.now() + this.deadlineMs;
-			if (this.startupGate) await settleWithin(this.startupGate, this.deadlineMs);
+			this.#phasesExpireAt = performance.now() + this.#deadlineMs;
+			if (this.#startupGate) await settleWithin(this.#startupGate, this.#deadlineMs);
 			const failures = [];
-			await settleWithin(this.runPhases(failures), Math.max(this.phasesExpireAt - performance.now(), 0));
-			const caughtPhase = this.runningPhase;
-			if (caughtPhase !== void 0) this.logger.error(`Shutdown deadline of ${paint.sky.bold(this.deadlineMs)}ms elapsed at phase ${paint.iris.bold(this.phaseEnum[caughtPhase])}`);
+			await settleWithin(this.#runPhases(failures), Math.max(this.#phasesExpireAt - performance.now(), 0));
+			const caughtPhase = this.#runningPhase;
+			if (caughtPhase !== void 0) this.logger.error(`Shutdown deadline of ${paint.sky.bold(this.#deadlineMs)}ms elapsed at phase ${paint.iris.bold(this.phaseEnum[caughtPhase])}`);
 			if (failures.length > 0) this.logger.error(`${paint.coral.bold("Coordinated shutdown failed")}`, ...failures);
 			else if (caughtPhase === void 0) this.logger.info(`${paint.mint.bold("Coordinated shutdown completed")} successfully`);
 		} finally {
-			this.hasShutdown = true;
 			if (exitProcess) {
-				this.logger.debug(`${paint.coral.bold("Exiting")} process with code ${paint.sky.bold(this.exitCode)}`);
+				this.logger.debug(`${paint.coral.bold("Exiting")} process with code ${paint.sky.bold(this.#exitCode)}`);
 				setTimeout(() => {
-					process.exit(this.exitCode);
+					process.exit(this.#exitCode);
 				}, LOG_FLUSH_DELAY_MS);
-			} else {
-				this.logger.debug(`${paint.amber.bold("Skipping")} process exit (dev mode)`);
-				this.isShuttingDown = false;
-			}
-		}
-	}
-};
-
-//#endregion
-//#region src/node/Lifecycle/CoordinatedStartup.ts
-const PHASE_ORDER = [
-	1,
-	2,
-	3
-];
-var CoordinatedStartup = class extends CoordinatedLifecycle {
-	isStartingUp = false;
-	hasStarted = false;
-	constructor() {
-		super("Startup", PHASE_ORDER, StartupPhase);
-	}
-	addTask(phase, taskName, task, timeoutMs = 1e4) {
-		super.addTask(phase, taskName, task, timeoutMs);
-	}
-	canAddTask() {
-		if (this.hasStarted) throw new SeedcordError(SeedcordErrorCode.LifecycleAddAfterCompletion);
-		if (this.isStartingUp) throw new SeedcordError(SeedcordErrorCode.LifecycleAddDuringRun);
-		return true;
-	}
-	canRemoveTask() {
-		if (this.isStartingUp) throw new SeedcordError(SeedcordErrorCode.LifecycleRemoveDuringRun);
-		return true;
-	}
-	getTaskType() {
-		return "startup";
-	}
-	async executeTasksInPhase(phase, tasks) {
-		const promises = tasks.map((task) => this.runTaskWithTimeout(phase, task));
-		return Promise.allSettled(promises);
-	}
-	/** @internal */
-	async run() {
-		if (this.hasStarted) {
-			this.logger.warn("Startup sequence has already completed");
-			return;
-		}
-		if (this.isStartingUp) {
-			this.logger.warn("Startup sequence already in progress");
-			return;
+			} else this.logger.debug(`${paint.amber.bold("Skipping")} process exit (dev mode)`);
 		}
-		this.isStartingUp = true;
-		this.logger.info(`${paint.mint.bold("Starting")} coordinated startup sequence`);
-		try {
-			for (const phase of PHASE_ORDER) {
-				if (!this.isStartingUp) {
-					this.logger.warn("Startup sequence aborted");
-					return;
-				}
-				await this.runPhase(phase);
-			}
-			this.hasStarted = true;
-			this.logger.info(`${paint.mint.bold("Coordinated startup completed")} successfully`);
-		} catch (error) {
-			if (!this.isStartingUp) {
-				this.logger.warn("Startup sequence aborted during error handling");
-				return;
-			}
-			this.logger.error(`${paint.coral.bold("Coordinated startup failed")}`);
-			throw error;
-		} finally {
-			this.isStartingUp = false;
-		}
-	}
-	isAborted() {
-		return !this.isStartingUp;
-	}
-	/** @internal */
-	abort() {
-		if (!this.isStartingUp) return;
-		this.isStartingUp = false;
-		this.logger.warn("Aborting coordinated startup sequence");
-	}
-	/** @internal */
-	get isReady() {
-		return this.hasStarted;
 	}
 };
 
 //#endregion
-export { CoordinatedShutdown, CoordinatedStartup, Pluggable };
+export { CoordinatedShutdown, CoordinatedStartup, ServerHost };
 //# sourceMappingURL=node.index.mjs.map

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            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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"}
+{"version":3,"file":"node.index.mjs","names":[],"sources":["../src/node/Lifecycle/CoordinatedShutdown.ts"],"sourcesContent":["import { SeedcordErrorCode, paint } from '@seedcord/errors';\nimport { SeedcordRangeError } from '@seedcord/errors/internal';\n\nimport { CoordinatedLifecycle } from '#src/lifecycle/CoordinatedLifecycle';\nimport { ShutdownPhase } from '#src/lifecycle/phases';\nimport { settleWithin } from '#src/lifecycle/withTimeout';\n\nimport type { LifecycleTask } from '#src/lifecycle/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    #running?: Promise<void>;\n    #exitCode = 0;\n    #onSigTerm: (() => void) | null = null;\n    #onSigInt: (() => void) | null = null;\n    #startupGate?: Promise<void>;\n    #deadlineMs = DEFAULT_SHUTDOWN_DEADLINE_MS;\n    #phasesExpireAt = Infinity;\n    #runningPhase: ShutdownPhase | undefined;\n\n    public constructor(deadlineMs?: number) {\n        super('Shutdown', PHASE_ORDER, ShutdownPhase);\n\n        if (deadlineMs !== undefined) this.setDeadline(deadlineMs);\n    }\n\n    /** @internal */\n    public setDeadline(deadlineMs: number): void {\n        if (!Number.isFinite(deadlineMs) || deadlineMs <= 0) {\n            throw new SeedcordRangeError(SeedcordErrorCode.LifecycleInvalidTimeout, [\n                'lifecycle.shutdownDeadline',\n                deadlineMs\n            ]);\n        }\n        this.#deadlineMs = deadlineMs;\n    }\n\n    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    /** @internal */\n    public 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(\n        phase: ShutdownPhase,\n        taskName: string,\n        task: LifecycleTask['task'],\n        timeoutMs = 5000\n    ): 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    // a later call waits on the first run and never repeats a task\n    /** @internal */\n    public run(exitCode = 0, exitProcess = true): Promise<void> {\n        this.removeSignalHandlers();\n\n        if (this.#running) {\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            return this.#running;\n        }\n\n        this.#exitCode = exitCode;\n        this.#running = this.#shutDown(exitProcess);\n        return this.#running;\n    }\n\n    async #shutDown(exitProcess: boolean): Promise<void> {\n        this.logger.info(\n            `${paint.amber.bold('Starting')} coordinated shutdown with exit code ${paint.sky.bold(this.#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            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            }\n        }\n    }\n}\n"],"mappings":"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"}

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

@@ -119,7 +119,7 @@ declare class DispatchContext implements DispatchBag {
   /**
    * Read a key that must be present, with `undefined` stripped from the result.
    *
-   * @throws A **SeedcordError** If nothing set the key on this dispatch.
+   * @throws A **SeedcordError** when nothing set the key on this dispatch.
    */
   require<Key extends keyof DispatchState>(key: Key): Exclude<DispatchState[Key], undefined>;
 }
@@ -424,8 +424,8 @@ declare class Bus extends TypedEventEmitter<SubscriptionTuples> {
    */
   publish<KeyOfSubscribers extends PublishableKey>(event: KeyOfSubscribers, data: AllSubscriptions[KeyOfSubscribers]): boolean;
   /**
-   * @deprecated Always throws. Call {@link Bus.publish} to reach subscribers and listeners together.
-   * @throws A **SeedcordTypeError** with `CoreBusEmitUnavailable`. `emit` reaches only the `on()` listeners.
+   * @deprecated Call {@link Bus.publish} to reach subscribers and listeners together.
+   * @throws A **SeedcordTypeError** every time, with `CoreBusEmitUnavailable`. `emit` reaches only the `on()` listeners.
    */
   emit<KeyOfSubscribers extends SubscriptionKey>(event: KeyOfSubscribers, ..._args: SubscriptionTuples[KeyOfSubscribers]): never;
   /** @internal the framework's own publish path, keyed by a symbol no public entry exports */
@@ -489,4 +489,4 @@ declare enum ShutdownPhase {
 }
 //#endregion
 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
+//# sourceMappingURL=phases-FTM69J3a.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-Dhx_ivqj.mjs";
+import { f as PluginLifecycleSpec, n as PluginHost, s as Plugin, u as PluginOptions } from "./PluginHost-DB4j8unu.mjs";
 import { HmrAware, HmrUpdateEvent } from "@seedcord/types";
-export { type HmrAware, type HmrUpdateEvent, Plugin, type PluginLifecycleSpec, type PluginOptions };
+export { type HmrAware, type HmrUpdateEvent, Plugin, PluginHost, type PluginLifecycleSpec, type PluginOptions };

package/dist/plugin.index.mjs

@@ -1,3 +1,3 @@
-import { t as Plugin } from "./Plugin-CmNW5n6a.mjs";
+import { a as Plugin, t as PluginHost } from "./PluginHost-B8kxLOeb.mjs";
 
-export { Plugin };
+export { Plugin, PluginHost };

package/dist/publishDefault-D3dAyzZ9.mjs

@@ -0,0 +1,7 @@
+//#region src/subscribers/publishDefault.ts
+/** @internal PublishableKey excludes this key so publish() never emits it externally. */
+const PublishDefault = Symbol("seedcord:bus:publish-default");
+
+//#endregion
+export { PublishDefault as t };
+//# sourceMappingURL=publishDefault-D3dAyzZ9.mjs.map

package/dist/publishDefault-D3dAyzZ9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishDefault-D3dAyzZ9.mjs","names":[],"sources":["../src/subscribers/publishDefault.ts"],"sourcesContent":["/** @internal PublishableKey excludes this key so publish() never emits it externally. */\nexport const PublishDefault = Symbol('seedcord:bus:publish-default');\n"],"mappings":";;AACA,MAAa,iBAAiB,OAAO,8BAA8B"}