@seedcord/core 0.9.4 → 0.11.0-next.0

package/dist/PluginLifecycle-AhQ46NIr.mjs

@@ -0,0 +1,158 @@
+import { n as StartupPhase } from "./phases-BauKJOTT.mjs";
+import { o as pluginLoggerOf } from "./PluginHost-B8kxLOeb.mjs";
+import { SeedcordErrorCode, isSeedcordError } from "@seedcord/errors";
+import { SeedcordError, throwSingleOrAggregate } from "@seedcord/errors/internal";
+import { Logger } from "@seedcord/logger";
+
+//#region src/notices/logUnknownFault.ts
+function causeLine(error) {
+	const { cause } = error;
+	if (!Error.isError(cause)) return "";
+	const [first] = cause.message.split("\n");
+	return `\ncaused by ${cause.name}: ${first ?? cause.message}`;
+}
+function logUnknownFault(logger, uuid, error, errors) {
+	if (errors?.errorStack ?? true) logger.error(uuid, error);
+	else logger.error(`${uuid} | ${error.message}${causeLine(error)}`);
+}
+
+//#endregion
+//#region src/lifecycle/withTimeout.ts
+async function raceTimer(start, timeoutMs, onTimeout) {
+	let timer;
+	try {
+		await Promise.race([start(), new Promise((resolve, reject) => {
+			const expiresAt = performance.now() + timeoutMs;
+			const tick = () => {
+				const remaining = expiresAt - performance.now();
+				if (remaining > 0) {
+					timer = setTimeout(tick, remaining);
+					return;
+				}
+				onTimeout(resolve, reject);
+			};
+			timer = setTimeout(tick, timeoutMs);
+		})]);
+	} finally {
+		if (timer) clearTimeout(timer);
+	}
+}
+function withTimeout(name, run, timeoutMs) {
+	return raceTimer(run, timeoutMs, (_, reject) => {
+		reject(new SeedcordError(SeedcordErrorCode.LifecycleTaskTimeout, [name, timeoutMs]));
+	});
+}
+function settleWithin(work, timeoutMs) {
+	return raceTimer(() => work.then(() => void 0, () => void 0), timeoutMs, (resolve) => resolve());
+}
+
+//#endregion
+//#region src/lifecycle/PluginLifecycle.ts
+var PluginLifecycle = class {
+	startup;
+	shutdown;
+	logger = new Logger("Plugins", { channel: "plugins" });
+	completedInits = /* @__PURE__ */ new Set();
+	disposePhases = /* @__PURE__ */ new Set();
+	timedOutInits = /* @__PURE__ */ new Set();
+	attachments = [];
+	registered = false;
+	constructor(startup, shutdown) {
+		this.startup = startup;
+		this.shutdown = shutdown;
+	}
+	register(attachments) {
+		if (this.registered) return;
+		this.registered = true;
+		this.attachments = [...attachments];
+		const groups = Map.groupBy(this.attachments, (attachment) => attachment.spec.init.phase);
+		for (const [phase, group] of groups) {
+			if (phase === 3) continue;
+			const budget = group.reduce((sum, a) => sum + a.spec.init.timeout, 0);
+			this.startup.addTask(phase, "plugins-init", () => this.runInits(group), budget);
+		}
+		this.registerReadyTask(groups.get(3) ?? []);
+	}
+	async rollback() {
+		await this.disposeCompleted(void 0, (caught) => this.logger.warn("rollback dispose failed", caught));
+		this.completedInits.clear();
+	}
+	afterTimedOutInits(run) {
+		if (this.timedOutInits.size === 0) {
+			run();
+			return;
+		}
+		Promise.allSettled(this.timedOutInits).then(run);
+	}
+	async runInits(group) {
+		for (const attachment of group) {
+			const { key, instance, spec } = attachment;
+			pluginLoggerOf(instance).utils.initialization(key, "start");
+			const running = instance.init();
+			try {
+				await withTimeout(`Plugin (${key})`, () => running, spec.init.timeout);
+			} catch (caught) {
+				if (isSeedcordError(caught, void 0, SeedcordErrorCode.LifecycleTaskTimeout)) this.disposeWhenInitResolves(attachment, running);
+				throw caught;
+			}
+			pluginLoggerOf(instance).utils.initialization(key, "end");
+			this.completedInits.add(attachment);
+			if (instance.dispose) this.registerDisposeTask(spec.dispose.phase);
+		}
+	}
+	disposeWhenInitResolves({ key, instance, spec }, running) {
+		const dispose = instance.dispose?.bind(instance);
+		const settled = running.then(async () => {
+			if (!dispose) return;
+			await withTimeout(`Plugin:${key}:dispose`, dispose, spec.dispose.timeout).catch((caught) => this.logger.warn(`${key} dispose failed after a timed-out init`, caught));
+		}, (caught) => this.logger.warn(`${key} init failed after its timeout`, caught));
+		this.timedOutInits.add(settled);
+		settled.finally(() => this.timedOutInits.delete(settled));
+	}
+	registerReadyTask(readyInits) {
+		const steps = this.attachments.reduce((acc, { key, instance, spec }) => {
+			const ready = instance.ready?.bind(instance);
+			if (ready) acc.push({
+				key,
+				run: ready,
+				timeout: spec.ready.timeout
+			});
+			return acc;
+		}, []);
+		if (readyInits.length === 0 && steps.length === 0) return;
+		const budget = readyInits.reduce((sum, a) => sum + a.spec.init.timeout, 0) + steps.reduce((sum, step) => sum + step.timeout, 0);
+		this.startup.addTask(3, "plugins-ready", async () => {
+			await this.runInits(readyInits);
+			for (const step of steps) await withTimeout(`Plugin:${step.key}:ready`, step.run, step.timeout);
+		}, budget);
+	}
+	registerDisposeTask(phase) {
+		if (this.disposePhases.has(phase)) return;
+		this.disposePhases.add(phase);
+		const budget = this.attachments.reduce((sum, a) => a.instance.dispose && a.spec.dispose.phase === phase ? sum + a.spec.dispose.timeout : sum, 0);
+		this.shutdown.addTask(phase, "plugins-dispose", () => this.runDisposals(phase), budget);
+	}
+	async runDisposals(phase) {
+		const failures = [];
+		await this.disposeCompleted(phase, (caught) => failures.push(caught));
+		throwSingleOrAggregate(failures, SeedcordErrorCode.PluginDisposeFailures);
+	}
+	async disposeCompleted(phase, onError) {
+		for (const attachment of [...this.attachments].reverse()) {
+			if (!this.completedInits.has(attachment)) continue;
+			const { key, instance, spec } = attachment;
+			const dispose = instance.dispose?.bind(instance);
+			if (!dispose) continue;
+			if (phase !== void 0 && spec.dispose.phase !== phase) continue;
+			try {
+				await withTimeout(`Plugin:${key}:dispose`, dispose, spec.dispose.timeout);
+			} catch (caught) {
+				onError(caught);
+			}
+		}
+	}
+};
+
+//#endregion
+export { logUnknownFault as i, settleWithin as n, withTimeout as r, PluginLifecycle as t };
+//# sourceMappingURL=PluginLifecycle-AhQ46NIr.mjs.map

package/dist/PluginLifecycle-AhQ46NIr.mjs.map

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

package/dist/ServerHost-CvGQr7oN.mjs

@@ -0,0 +1,191 @@
+import { t as PublishDefault } from "./publishDefault-D3dAyzZ9.mjs";
+import { n as attachmentsOf, r as sealAttachments, t as PluginHost } from "./PluginHost-B8kxLOeb.mjs";
+import { i as logUnknownFault, t as PluginLifecycle } from "./PluginLifecycle-AhQ46NIr.mjs";
+import { SeedcordErrorCode } from "@seedcord/errors";
+import { SeedcordError } from "@seedcord/errors/internal";
+import { Logger, LoggerChannelRegistry } from "@seedcord/logger";
+import { asError, runsUnderSeedcordDev } from "@seedcord/utils/internal";
+import { HostShutdown, HostStartup } from "@seedcord/types/internal";
+import { installNodeConsole, installNodeDefaults } from "@seedcord/logger/node";
+import crypto from "node:crypto";
+
+//#region src/node/assertRuntimeVersion.ts
+const MINIMUM = ">=";
+const SPACES = /\s/g;
+function parseVersion(text) {
+	const [withoutBuild = ""] = text.replace(/^v/, "").split("+");
+	const [release = "", ...prerelease] = withoutBuild.split("-");
+	const parts = release.split(".").map(Number);
+	return parts.every(Number.isInteger) ? {
+		parts,
+		prerelease: prerelease.length > 0
+	} : void 0;
+}
+function meetsMinimum(required, running) {
+	const length = Math.max(required.parts.length, running.parts.length);
+	for (let index = 0; index < length; index++) {
+		const wanted = required.parts[index] ?? 0;
+		const got = running.parts[index] ?? 0;
+		if (got !== wanted) return got > wanted;
+	}
+	return !running.prerelease;
+}
+function assertDeclaredRuntime() {
+	const { bun, node } = process.versions;
+	const runtime = bun === void 0 ? {
+		name: "Node",
+		range: ">=24.11",
+		running: node
+	} : {
+		name: "Bun",
+		range: ">=1.4.2",
+		running: bun
+	};
+	const range = runtime.range.replaceAll(SPACES, "");
+	if (!range.startsWith(MINIMUM)) return;
+	const required = parseVersion(range.slice(2));
+	const running = parseVersion(runtime.running);
+	if (!required || !running || meetsMinimum(required, running)) return;
+	throw new SeedcordError(SeedcordErrorCode.UnsupportedRuntimeVersion, [
+		runtime.name,
+		runtime.range,
+		runtime.running
+	]);
+}
+
+//#endregion
+//#region src/node/processErrors.ts
+const logger = new Logger("Faults", { channel: "errors" });
+/** @internal */
+function registerProcessErrors(core, shutdown) {
+	function report(caught, origin) {
+		const error = asError(caught);
+		const uuid = crypto.randomUUID();
+		logUnknownFault(logger, uuid, error, core.config.errors);
+		core.bus[PublishDefault]("unknownException", {
+			uuid,
+			dispatchId: null,
+			error,
+			origin
+		});
+	}
+	const onRejection = (reason) => {
+		report(reason, "process:unhandledRejection");
+	};
+	const onException = (caught) => {
+		report(caught, "process:uncaughtException");
+		shutdown.run(1);
+	};
+	process.on("unhandledRejection", onRejection);
+	process.on("uncaughtException", onException);
+	return () => {
+		process.off("unhandledRejection", onRejection);
+		process.off("uncaughtException", onException);
+	};
+}
+
+//#endregion
+//#region src/node/ServerHost.ts
+/** Base class for a transport `Seedcord` class that runs as a long-lived node or bun process. */
+var ServerHost = class ServerHost extends PluginHost {
+	/** @internal */
+	[HostShutdown];
+	/** @internal */
+	[HostStartup];
+	/** Add a task that runs while the bot shuts down. */
+	shutdown;
+	/** Add a task that runs while the bot starts. */
+	startup;
+	#lifecycle;
+	#startFailed = false;
+	#initPromise;
+	static #isInstantiated = false;
+	static #liveHost;
+	static #liveShutdown;
+	static #liveProcessErrors;
+	constructor(transport, shutdown, startup) {
+		assertDeclaredRuntime();
+		super(transport, "server");
+		if (ServerHost.#isInstantiated) throw new SeedcordError(SeedcordErrorCode.CoreSingletonViolation);
+		installNodeConsole();
+		ServerHost.#isInstantiated = true;
+		ServerHost.#liveHost = this;
+		ServerHost.#liveShutdown = shutdown;
+		this[HostShutdown] = shutdown;
+		this[HostStartup] = startup;
+		this.shutdown = { addTask: shutdown.addTask.bind(shutdown) };
+		this.startup = { addTask: startup.addTask.bind(startup) };
+		this.#lifecycle = new PluginLifecycle(this.startup, this.shutdown);
+	}
+	/** @internal */
+	init() {
+		this.#initPromise ??= this.#runInit().catch(async (caught) => {
+			this.#initPromise = void 0;
+			await this.#release(1);
+			throw caught;
+		});
+		return this.#initPromise;
+	}
+	async #runInit() {
+		if (this.#startFailed) throw new SeedcordError(SeedcordErrorCode.LifecycleRestartAfterFailure);
+		installNodeDefaults(this.config.logger);
+		sealAttachments(this);
+		this.#lifecycle.register(attachmentsOf(this));
+		if (!runsUnderSeedcordDev()) this[HostShutdown].registerSignalHandlers();
+		if (this.config.errors?.catchProcessErrors ?? true) ServerHost.#liveProcessErrors = registerProcessErrors(this, this[HostShutdown]);
+		const startupSettled = Promise.withResolvers();
+		this[HostShutdown].gateOnStartup(startupSettled.promise);
+		try {
+			await this[HostStartup].run(() => this.openHealth());
+		} catch (caught) {
+			this.#startFailed = true;
+			await this.#lifecycle.rollback();
+			throw caught;
+		} finally {
+			startupSettled.resolve();
+		}
+		return this;
+	}
+	/** @internal */
+	openHealth() {}
+	/**
+	* Runs the coordinated shutdown without calling `process.exit`. A new `Seedcord` can be
+	* constructed afterwards. `await using` calls this when its scope ends.
+	*
+	* @example
+	* ```ts
+	* // the bot shuts down when this block ends
+	* await using bot = await new Seedcord(config).start();
+	* console.log(await bot.rest.get(Routes.user('@me')));
+	* ```
+	*/
+	async [Symbol.asyncDispose]() {
+		await this.#release(0);
+	}
+	async #release(exitCode) {
+		try {
+			await this[HostShutdown].run(exitCode, false);
+		} finally {
+			ServerHost.reset(this);
+		}
+	}
+	/** @internal */
+	static reset(host) {
+		if (host !== void 0 && ServerHost.#liveHost !== host) return false;
+		ServerHost.#liveShutdown?.removeSignalHandlers();
+		ServerHost.#liveShutdown = void 0;
+		ServerHost.#liveProcessErrors?.();
+		ServerHost.#liveProcessErrors = void 0;
+		ServerHost.#liveHost = void 0;
+		ServerHost.#isInstantiated = false;
+		LoggerChannelRegistry.instance.configure({});
+		return true;
+	}
+};
+function shutdownOf(host) {
+	return host[HostShutdown];
+}
+
+//#endregion
+export { shutdownOf as n, assertDeclaredRuntime as r, ServerHost as t };
+//# sourceMappingURL=ServerHost-CvGQr7oN.mjs.map

package/dist/ServerHost-CvGQr7oN.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerHost-CvGQr7oN.mjs","names":[],"sources":["../src/node/assertRuntimeVersion.ts","../src/node/processErrors.ts","../src/node/ServerHost.ts"],"sourcesContent":["import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\n\n// every seedcord package writes each engines range as `>=` and a version\nconst MINIMUM = '>=';\nconst SPACES = /\\s/g;\n\ninterface Version {\n    parts: number[];\n    prerelease: boolean;\n}\n\nfunction parseVersion(text: string): Version | undefined {\n    const [withoutBuild = ''] = text.replace(/^v/, '').split('+');\n    const [release = '', ...prerelease] = withoutBuild.split('-');\n    const parts = release.split('.').map(Number);\n    return parts.every(Number.isInteger) ? { parts, prerelease: prerelease.length > 0 } : undefined;\n}\n\n// semver ranks 1.4.2-canary.1 below 1.4.2\nfunction meetsMinimum(required: Version, running: Version): boolean {\n    const length = Math.max(required.parts.length, running.parts.length);\n    for (let index = 0; index < length; index++) {\n        const wanted = required.parts[index] ?? 0;\n        const got = running.parts[index] ?? 0;\n        if (got !== wanted) return got > wanted;\n    }\n    return !running.prerelease;\n}\n\nexport function assertDeclaredRuntime(): void {\n    const { bun, node } = process.versions;\n    // tsdown-config bakes both ranges in from this package's engines\n    const runtime =\n        bun === undefined\n            ? { name: 'Node', range: process.env.PACKAGE_NODE_RANGE ?? '', running: node }\n            : { name: 'Bun', range: process.env.PACKAGE_BUN_RANGE ?? '', running: bun };\n\n    const range = runtime.range.replaceAll(SPACES, '');\n    if (!range.startsWith(MINIMUM)) return;\n\n    const required = parseVersion(range.slice(MINIMUM.length));\n    const running = parseVersion(runtime.running);\n    if (!required || !running || meetsMinimum(required, running)) return;\n\n    throw new SeedcordError(SeedcordErrorCode.UnsupportedRuntimeVersion, [\n        runtime.name,\n        runtime.range,\n        runtime.running\n    ]);\n}\n","import crypto from 'node:crypto';\n\nimport { Logger } from '@seedcord/logger';\nimport { asError } from '@seedcord/utils/internal';\n\nimport { logUnknownFault } from '#src/notices/logUnknownFault';\nimport { PublishDefault } from '#subscribers/publishDefault';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { CoordinatedShutdown } from '#node/Lifecycle/CoordinatedShutdown';\n\nconst logger = new Logger('Faults', { channel: 'errors' });\n\n/** @internal */\nexport function registerProcessErrors(core: CoreBase, shutdown: CoordinatedShutdown): () => void {\n    function report(caught: unknown, origin: string): void {\n        const error = asError(caught);\n        const uuid = crypto.randomUUID();\n\n        logUnknownFault(logger, uuid, error, core.config.errors);\n\n        core.bus[PublishDefault]('unknownException', { uuid, dispatchId: null, error, origin });\n    }\n\n    const onRejection = (reason: unknown): void => {\n        report(reason, 'process:unhandledRejection');\n    };\n\n    const onException = (caught: unknown): void => {\n        report(caught, 'process:uncaughtException');\n        // node does not exit on its own once a listener is registered\n        void shutdown.run(1);\n    };\n\n    process.on('unhandledRejection', onRejection);\n    process.on('uncaughtException', onException);\n\n    return () => {\n        process.off('unhandledRejection', onRejection);\n        process.off('uncaughtException', onException);\n    };\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { LoggerChannelRegistry } from '@seedcord/logger';\nimport { installNodeConsole, installNodeDefaults } from '@seedcord/logger/node';\nimport { HostShutdown, HostStartup } from '@seedcord/types/internal';\nimport { runsUnderSeedcordDev } from '@seedcord/utils/internal';\n\nimport { assertDeclaredRuntime } from '#node/assertRuntimeVersion';\nimport { PluginLifecycle } from '#src/lifecycle/PluginLifecycle';\nimport { attachmentsOf, PluginHost, sealAttachments } from '#src/plugin/PluginHost';\n\nimport { registerProcessErrors } from './processErrors';\n\nimport type { CoordinatedShutdown } from '#node/Lifecycle/CoordinatedShutdown';\nimport type { CoordinatedStartup } from '#src/lifecycle/CoordinatedStartup';\nimport type { Transport } from '#src/plugin/options';\nimport type { Promisable } from 'type-fest';\n\n/** Base class for a transport `Seedcord` class that runs as a long-lived node or bun process. */\nexport abstract class ServerHost<BotT extends Transport> extends PluginHost<BotT, 'server'> {\n    /** @internal */\n    readonly [HostShutdown]: CoordinatedShutdown;\n    /** @internal */\n    readonly [HostStartup]: CoordinatedStartup;\n\n    /** Add a task that runs while the bot shuts down. */\n    public readonly shutdown: Pick<CoordinatedShutdown, 'addTask'>;\n\n    /** Add a task that runs while the bot starts. */\n    public readonly startup: Pick<CoordinatedStartup, 'addTask'>;\n\n    readonly #lifecycle: PluginLifecycle;\n    #startFailed = false;\n    #initPromise?: Promise<this> | undefined;\n\n    static #isInstantiated = false;\n    static #liveHost?: object | undefined;\n    static #liveShutdown?: CoordinatedShutdown | undefined;\n    static #liveProcessErrors?: (() => void) | undefined;\n\n    constructor(transport: BotT, shutdown: CoordinatedShutdown, startup: CoordinatedStartup) {\n        // a `sideEffects: false` build would drop the same call in the node entry\n        assertDeclaredRuntime();\n        super(transport, 'server');\n\n        if (ServerHost.#isInstantiated) throw new SeedcordError(SeedcordErrorCode.CoreSingletonViolation);\n\n        // init() opens the log file\n        installNodeConsole();\n\n        ServerHost.#isInstantiated = true;\n        ServerHost.#liveHost = this;\n        ServerHost.#liveShutdown = shutdown;\n        this[HostShutdown] = shutdown;\n        this[HostStartup] = startup;\n        // a getter returning the slot would expose run() and the signal handlers too\n        this.shutdown = { addTask: shutdown.addTask.bind(shutdown) };\n        this.startup = { addTask: startup.addTask.bind(startup) };\n        this.#lifecycle = new PluginLifecycle(this.startup, this.shutdown);\n    }\n\n    /** @internal */\n    protected init(): Promise<this> {\n        // a retry after a rejection runs #runInit again and hits its restart guard\n        this.#initPromise ??= this.#runInit().catch(async (caught: unknown) => {\n            this.#initPromise = undefined;\n            await this.#release(1);\n            throw caught;\n        });\n        return this.#initPromise;\n    }\n\n    async #runInit(): Promise<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        installNodeDefaults(this.config.logger);\n        sealAttachments(this);\n        this.#lifecycle.register(attachmentsOf(this));\n\n        // codegen and the build construct the bot without starting it.\n        // under seedcord dev the CLI handles SIGINT and SIGTERM\n        if (!runsUnderSeedcordDev()) this[HostShutdown].registerSignalHandlers();\n        if (this.config.errors?.catchProcessErrors ?? true) {\n            ServerHost.#liveProcessErrors = registerProcessErrors(this, this[HostShutdown]);\n        }\n\n        const startupSettled: PromiseWithResolvers<void> = Promise.withResolvers();\n        this[HostShutdown].gateOnStartup(startupSettled.promise);\n\n        try {\n            // nothing a plugin adds through startup.addTask runs after this\n            await this[HostStartup].run(() => this.openHealth());\n        } catch (caught) {\n            this.#startFailed = true;\n            await this.#lifecycle.rollback();\n            throw caught;\n        } finally {\n            startupSettled.resolve();\n        }\n\n        return this;\n    }\n\n    /** @internal */\n    protected openHealth(): Promisable<void> {}\n\n    /**\n     * Runs the coordinated shutdown without calling `process.exit`. A new `Seedcord` can be\n     * constructed afterwards. `await using` calls this when its scope ends.\n     *\n     * @example\n     * ```ts\n     * // the bot shuts down when this block ends\n     * await using bot = await new Seedcord(config).start();\n     * console.log(await bot.rest.get(Routes.user('@me')));\n     * ```\n     */\n    public async [Symbol.asyncDispose](): Promise<void> {\n        await this.#release(0);\n    }\n\n    async #release(exitCode: number): Promise<void> {\n        try {\n            await this[HostShutdown].run(exitCode, false);\n        } finally {\n            ServerHost.reset(this);\n        }\n    }\n\n    /** @internal */\n    protected static reset(host?: object): boolean {\n        if (host !== undefined && ServerHost.#liveHost !== host) return false;\n\n        ServerHost.#liveShutdown?.removeSignalHandlers();\n        ServerHost.#liveShutdown = undefined;\n        ServerHost.#liveProcessErrors?.();\n        ServerHost.#liveProcessErrors = undefined;\n        ServerHost.#liveHost = undefined;\n        ServerHost.#isInstantiated = false;\n        // configure() keeps the dev TUI's capture sink\n        LoggerChannelRegistry.instance.configure({});\n        return true;\n    }\n}\n\n// the public `shutdown` field carries addTask alone\nexport function shutdownOf(host: Pick<ServerHost<Transport>, typeof HostShutdown>): CoordinatedShutdown {\n    return host[HostShutdown];\n}\n"],"mappings":"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"}

package/dist/ServerHost-DYeh0KTk.d.mts

@@ -0,0 +1,40 @@
+import { d as Transport, n as PluginHost } from "./PluginHost-DB4j8unu.mjs";
+import { n as CoordinatedStartup, t as CoordinatedShutdown } from "./CoordinatedShutdown-H5YjZn8A.mjs";
+import { HostShutdown, HostStartup } from "@seedcord/types/internal";
+import { Promisable } from "type-fest";
+//#region src/node/ServerHost.d.ts
+/** Base class for a transport `Seedcord` class that runs as a long-lived node or bun process. */
+declare abstract class ServerHost<BotT extends Transport> extends PluginHost<BotT, 'server'> {
+  #private;
+  /** @internal */
+  readonly [HostShutdown]: CoordinatedShutdown;
+  /** @internal */
+  readonly [HostStartup]: CoordinatedStartup;
+  /** Add a task that runs while the bot shuts down. */
+  readonly shutdown: Pick<CoordinatedShutdown, 'addTask'>;
+  /** Add a task that runs while the bot starts. */
+  readonly startup: Pick<CoordinatedStartup, 'addTask'>;
+  constructor(transport: BotT, shutdown: CoordinatedShutdown, startup: CoordinatedStartup);
+  /** @internal */
+  protected init(): Promise<this>;
+  /** @internal */
+  protected openHealth(): Promisable<void>;
+  /**
+   * Runs the coordinated shutdown without calling `process.exit`. A new `Seedcord` can be
+   * constructed afterwards. `await using` calls this when its scope ends.
+   *
+   * @example
+   * ```ts
+   * // the bot shuts down when this block ends
+   * await using bot = await new Seedcord(config).start();
+   * console.log(await bot.rest.get(Routes.user('@me')));
+   * ```
+   */
+  [Symbol.asyncDispose](): Promise<void>;
+  /** @internal */
+  protected static reset(host?: object): boolean;
+}
+declare function shutdownOf(host: Pick<ServerHost<Transport>, typeof HostShutdown>): CoordinatedShutdown;
+//#endregion
+export { shutdownOf as n, ServerHost as t };
+//# sourceMappingURL=ServerHost-DYeh0KTk.d.mts.map

package/dist/hmr.index.d.mts

@@ -34,7 +34,6 @@ export declare class HmrModuleHandler<THandler, TMiddleware = void, TArtifacts =
   trackHandler(file: string, handler: THandler): void;
   /** Links the middleware to its source file so a later update can unload it. */
   trackMiddleware(file: string, middleware: TMiddleware): void;
-  private isTracked;
   private unload;
   private reloadFile;
   private snapshotUnits;

package/dist/hmr.index.mjs

@@ -1,3 +1,3 @@
-import { t as HmrModuleHandler } from "./HmrModuleHandler-DOAtah3j.mjs";
+import { t as HmrModuleHandler } from "./HmrModuleHandler-8ZC-UuZh.mjs";
 
 export { HmrModuleHandler };