@seedcord/core 0.10.0 → 0.11.0

package/README.md

@@ -10,7 +10,7 @@
   <a href="https://seedcord.org">Website</a> ·
   <a href="https://seedcord.org/guide">Guide</a> ·
   <a href="https://seedcord.org/docs">Reference</a> ·
-  <a href="https://discord.gg/DzFxY58WXf">Discord</a>
+  <a href="https://seedcord.org/chat/">Discord</a>
 </div>
 
 <br />
@@ -23,20 +23,38 @@
 
 ## About
 
-`@seedcord/core` is the foundational code both seedcord transports share. Command and context-menu injection, the interaction route decorators, the handler bases, gates, the startup and shutdown phases, and the plugin base all live here.
+`@seedcord/core` is the code both seedcord transports share. It has the route decorators, the handler bases, checks, pagination, the startup and shutdown phases, and the plugin base. [`@seedcord/gateway`](https://www.npmjs.com/package/@seedcord/gateway) and [`@seedcord/http`](https://www.npmjs.com/package/@seedcord/http) connect it to Discord.
 
-Nothing in it opens a connection to Discord. `@seedcord/gateway` and `@seedcord/http` each bind their own transport into these pieces.
+Both transports depend on core and re-export all of it, so a bot imports everything from its transport. Install core directly when you write a plugin that works on both transports.
 
-Until v1.0.0, minor versions can break.
+seedcord is pre-1.0, so a minor version can break your plugin. Each release's changelog says what changed and how to update.
 
 ## Installation
 
-Your transport already re-exports all of this.
+```sh
+pnpm add -D @seedcord/core envapt typescript
+```
 
-Install it directly when you are writing a plugin against the framework:
+Also list `@seedcord/core` in your plugin's `peerDependencies`, with the versions you tested against. A plugin that extends a different copy of core than the bot's throws `CorePluginFromOtherCore` when the bot attaches it.
 
-```sh
-pnpm add @seedcord/core
+## Usage
+
+A plugin extends `Plugin` from `@seedcord/core/plugin` and implements `init()`:
+
+```ts
+import { Plugin } from '@seedcord/core/plugin';
+
+export class Uptime extends Plugin {
+    private startedAt = 0;
+
+    public async init(): Promise<void> {
+        this.startedAt = Date.now();
+    }
+
+    public elapsed(): number {
+        return Date.now() - this.startedAt;
+    }
+}
 ```
 
-`@seedcord/core/plugin` holds the base a plugin extends.
+A gateway or http bot attaches it with `.attach('uptime', Uptime)`, and handlers call `this.core.uptime.elapsed()`. The [Writing plugins guide](https://seedcord.org/guide/writing-plugins) covers options, lifecycle phases, testing a plugin locally, and publishing.

package/dist/CoordinatedShutdown-H5YjZn8A.d.mts

@@ -0,0 +1,78 @@
+import { n as StartupPhase, t as ShutdownPhase } from "./phases-FTM69J3a.mjs";
+import { Logger } from "@seedcord/logger";
+import { Promisable } from "type-fest";
+//#region src/lifecycle/LifecycleTypes.d.ts
+interface LifecycleTask {
+  name: string;
+  task: (signal: AbortSignal) => Promise<void>;
+  timeout: number;
+}
+//#endregion
+//#region src/lifecycle/CoordinatedLifecycle.d.ts
+declare abstract class CoordinatedLifecycle<TPhase extends number> {
+  #private;
+  protected readonly phaseOrder: TPhase[];
+  protected readonly phaseEnum: Record<number, string>;
+  protected readonly logger: Logger;
+  protected readonly tasksMap: Map<TPhase, LifecycleTask[]>;
+  protected constructor(loggerName: string, phaseOrder: TPhase[], phaseEnum: Record<number, string>);
+  addTask(phase: TPhase, taskName: string, task: LifecycleTask['task'], timeoutMs: number): void;
+  removeTask(phase: TPhase, taskName: string): boolean;
+  protected runPhase(phase: TPhase): Promise<void>;
+  protected runTaskWithTimeout(phase: TPhase, task: LifecycleTask): Promise<void>;
+  protected isAborted(): boolean;
+  protected beginRun(): void;
+  protected abortRun(): void;
+  protected abstract canAddTask(): boolean;
+  protected abstract canRemoveTask(): boolean;
+  protected abstract getTaskType(): string;
+  protected abstract executeTasksInPhase(phase: TPhase, tasks: LifecycleTask[]): Promise<PromiseSettledResult<void>[]>;
+}
+//#endregion
+//#region src/lifecycle/CoordinatedStartup.d.ts
+declare class CoordinatedStartup extends CoordinatedLifecycle<StartupPhase> {
+  #private;
+  constructor();
+  /**
+   * Adds a task to a startup phase. The task gets a signal that aborts when it runs past `timeoutMs`
+   * or when startup is aborted. Pass it to any request the task makes.
+   */
+  addTask(phase: StartupPhase, taskName: string, task: LifecycleTask['task'], timeoutMs?: number): void;
+  protected canAddTask(): boolean;
+  protected canRemoveTask(): boolean;
+  protected getTaskType(): string;
+  protected executeTasksInPhase(phase: StartupPhase, tasks: LifecycleTask[]): Promise<PromiseSettledResult<void>[]>;
+  /** @internal */
+  run(afterReady?: () => Promisable<void>): Promise<void>;
+  protected isAborted(): boolean;
+  /** @internal */
+  abort(): void;
+  /** @internal */
+  get isReady(): boolean;
+}
+//#endregion
+//#region src/node/Lifecycle/CoordinatedShutdown.d.ts
+declare class CoordinatedShutdown extends CoordinatedLifecycle<ShutdownPhase> {
+  #private;
+  constructor(deadlineMs?: number);
+  /** @internal */
+  setDeadline(deadlineMs: number): void;
+  protected canAddTask(): boolean;
+  protected canRemoveTask(): boolean;
+  protected getTaskType(): string;
+  protected executeTasksInPhase(phase: ShutdownPhase, tasks: LifecycleTask[]): Promise<PromiseSettledResult<void>[]>;
+  /** @internal */
+  registerSignalHandlers(): void;
+  /** @internal */
+  removeSignalHandlers(): void;
+  /** @internal run() awaits this so boot finishes registering its dispose tasks first */
+  gateOnStartup(settled: Promise<void>): void;
+  addTask(phase: ShutdownPhase, taskName: string, task: LifecycleTask['task'], timeoutMs?: number): void;
+  /** @internal */
+  removeTask(phase: ShutdownPhase, taskName: string): boolean;
+  /** @internal */
+  run(exitCode?: number, exitProcess?: boolean): Promise<void>;
+}
+//#endregion
+export { CoordinatedStartup as n, LifecycleTask as r, CoordinatedShutdown as t };
+//# sourceMappingURL=CoordinatedShutdown-H5YjZn8A.d.mts.map

package/dist/CoordinatedStartup-CGnJrqcl.mjs

@@ -0,0 +1,168 @@
+import { n as StartupPhase } from "./phases-BauKJOTT.mjs";
+import { r as withTimeout } from "./PluginLifecycle-AhQ46NIr.mjs";
+import { SeedcordErrorCode, paint } from "@seedcord/errors";
+import { SeedcordAggregateError, SeedcordError, SeedcordTypeError } from "@seedcord/errors/internal";
+import { Logger } from "@seedcord/logger";
+
+//#region src/lifecycle/CoordinatedLifecycle.ts
+var CoordinatedLifecycle = class {
+	phaseOrder;
+	phaseEnum;
+	logger;
+	tasksMap = /* @__PURE__ */ new Map();
+	#run = new AbortController();
+	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
+		});
+	}
+	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);
+		return initialLength !== filteredTasks.length;
+	}
+	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])}`);
+		const stopTask = new AbortController();
+		const signal = AbortSignal.any([stopTask.signal, this.#run.signal]);
+		try {
+			await withTimeout(task.name, () => task.task(signal), task.timeout);
+			this.logger.trace(`${paint.italic("Completed")} task ${paint.sky.bold(task.name)} in phase ${paint.iris.bold(this.phaseEnum[phase])}`);
+		} catch (error) {
+			stopTask.abort(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;
+	}
+	beginRun() {
+		this.#run = new AbortController();
+	}
+	abortRun() {
+		this.#run.abort();
+	}
+};
+
+//#endregion
+//#region src/lifecycle/CoordinatedStartup.ts
+const PHASE_ORDER = [
+	1,
+	2,
+	3
+];
+var CoordinatedStartup = class extends CoordinatedLifecycle {
+	#isStartingUp = false;
+	#hasStarted = false;
+	constructor() {
+		super("Startup", PHASE_ORDER, StartupPhase);
+	}
+	/**
+	* Adds a task to a startup phase. The task gets a signal that aborts when it runs past `timeoutMs`
+	* or when startup is aborted. Pass it to any request the task makes.
+	*/
+	addTask(phase, taskName, task, timeoutMs = 1e4) {
+		super.addTask(phase, taskName, task, timeoutMs);
+	}
+	canAddTask() {
+		if (this.#hasStarted) throw new SeedcordError(SeedcordErrorCode.LifecycleTaskChangeRejected, ["add", "finished"]);
+		if (this.#isStartingUp) throw new SeedcordError(SeedcordErrorCode.LifecycleTaskChangeRejected, ["add", "running"]);
+		return true;
+	}
+	canRemoveTask() {
+		if (this.#isStartingUp) throw new SeedcordError(SeedcordErrorCode.LifecycleTaskChangeRejected, ["remove", "running"]);
+		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(afterReady) {
+		if (this.#hasStarted) {
+			this.logger.warn("Startup sequence has already completed");
+			return;
+		}
+		if (this.#isStartingUp) {
+			this.logger.warn("Startup sequence already in progress");
+			return;
+		}
+		this.#isStartingUp = true;
+		this.beginRun();
+		this.logger.info(`${paint.mint.bold("Starting")} coordinated startup sequence`);
+		const steps = PHASE_ORDER.map((phase) => () => this.runPhase(phase));
+		if (afterReady) steps.push(afterReady);
+		try {
+			for (const step of steps) {
+				await step();
+				if (!this.#isStartingUp) {
+					this.logger.warn("Startup sequence aborted");
+					return;
+				}
+			}
+			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.abortRun();
+		this.logger.warn("Aborting coordinated startup sequence");
+	}
+	/** @internal */
+	get isReady() {
+		return this.#hasStarted;
+	}
+};
+
+//#endregion
+export { CoordinatedLifecycle as n, CoordinatedStartup as t };
+//# sourceMappingURL=CoordinatedStartup-CGnJrqcl.mjs.map

package/dist/CoordinatedStartup-CGnJrqcl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoordinatedStartup-CGnJrqcl.mjs","names":[],"sources":["../src/lifecycle/CoordinatedLifecycle.ts","../src/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    #run = new AbortController();\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: LifecycleTask['task'], 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    }\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        return initialLength !== filteredTasks.length;\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        const stopTask = new AbortController();\n        const signal = AbortSignal.any([stopTask.signal, this.#run.signal]);\n        try {\n            await withTimeout(task.name, () => task.task(signal), 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            stopTask.abort(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 beginRun(): void {\n        this.#run = new AbortController();\n    }\n\n    protected abortRun(): void {\n        this.#run.abort();\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 { SeedcordError } from '@seedcord/errors/internal';\n\nimport { StartupPhase } from '#src/lifecycle/phases';\n\nimport { CoordinatedLifecycle } from './CoordinatedLifecycle';\n\nimport type { LifecycleTask } from './LifecycleTypes';\nimport type { Promisable } from 'type-fest';\n\nconst PHASE_ORDER: StartupPhase[] = [StartupPhase.Configuration, StartupPhase.Login, StartupPhase.Ready];\n\nexport class CoordinatedStartup extends CoordinatedLifecycle<StartupPhase> {\n    #isStartingUp = false;\n    #hasStarted = false;\n\n    public constructor() {\n        super('Startup', PHASE_ORDER, StartupPhase);\n    }\n\n    /**\n     * Adds a task to a startup phase. The task gets a signal that aborts when it runs past `timeoutMs`\n     * or when startup is aborted. Pass it to any request the task makes.\n     */\n    public override addTask(\n        phase: StartupPhase,\n        taskName: string,\n        task: LifecycleTask['task'],\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.LifecycleTaskChangeRejected, ['add', 'finished']);\n        }\n\n        if (this.#isStartingUp) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleTaskChangeRejected, ['add', 'running']);\n        }\n\n        return true;\n    }\n\n    protected canRemoveTask(): boolean {\n        if (this.#isStartingUp) {\n            throw new SeedcordError(SeedcordErrorCode.LifecycleTaskChangeRejected, ['remove', 'running']);\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(afterReady?: () => Promisable<void>): 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.beginRun();\n        this.logger.info(`${paint.mint.bold('Starting')} coordinated startup sequence`);\n\n        const steps: (() => Promisable<void>)[] = PHASE_ORDER.map((phase) => () => this.runPhase(phase));\n        if (afterReady) steps.push(afterReady);\n\n        try {\n            for (const step of steps) {\n                await step();\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            }\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.abortRun();\n        this.logger.warn('Aborting coordinated startup sequence');\n    }\n\n    /** @internal */\n    public get isReady(): boolean {\n        return this.#hasStarted;\n    }\n}\n"],"mappings":"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"}

package/dist/{HmrModuleHandler-DOAtah3j.mjs → HmrModuleHandler-8ZC-UuZh.mjs}

@@ -1,7 +1,6 @@
 import { paint } from "@seedcord/errors";
+import { botFolder, vitePluginThrew } from "@seedcord/utils/internal";
 import { formatFilePath } from "@seedcord/utils";
-import { existsSync } from "node:fs";
-import { resolve, sep } from "node:path";
 import { pathToFileURL } from "node:url";
 
 //#region src/hmr/HmrModuleHandler.ts
@@ -30,19 +29,11 @@ var HmrModuleHandler = class {
 	/** Unloads or reloads the modules affected by an {@link HmrUpdateEvent}, scoped to the handler and middleware directories. */
 	async handle(event) {
 		const { file, affectedModules, type } = event;
-		const { logger } = this.options;
 		if (type === "delete" || type === "deleteDir") {
 			this.report("Unloaded", this.unload(file), [file]);
 			return;
 		}
 		if (type === "createDir") return;
-		if (type === "update" && !existsSync(file)) {
-			if (this.isTracked(file)) {
-				logger.debug(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);
-				this.report("Unloaded", this.unload(file), [file]);
-			}
-			return;
-		}
 		const rollbackEnabled = event.rollback ?? true;
 		const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];
 		const startedAt = Date.now();
@@ -59,8 +50,8 @@ var HmrModuleHandler = class {
 	}
 	inScope(file) {
 		const { handlersDir, middlewaresDir } = this.options;
-		if (file.startsWith(resolve(process.cwd(), handlersDir) + sep)) return true;
-		return middlewaresDir ? file.startsWith(resolve(process.cwd(), middlewaresDir) + sep) : false;
+		if (botFolder(handlersDir).holdsModule(file)) return true;
+		return middlewaresDir ? botFolder(middlewaresDir).holdsModule(file) : false;
 	}
 	report(verb, names, files, elapsedMs) {
 		if (names.length === 0) return;
@@ -101,9 +92,6 @@ var HmrModuleHandler = class {
 		}
 		set.add(middleware);
 	}
-	isTracked(file) {
-		return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);
-	}
 	unload(file) {
 		const names = [];
 		const handlers = this.store.fileToHandlers.get(file);
@@ -128,14 +116,13 @@ var HmrModuleHandler = class {
 	}
 	async reloadFile(file) {
 		const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;
-		if (!existsSync(file)) {
-			logger.debug(`File does not exist, skipping reload: ${formatFilePath(file)}`);
-			return null;
-		}
 		try {
 			let fileUrl = pathToFileURL(file).href;
 			if (process.env.VITEST === "true") fileUrl += `?update=${Date.now()}`;
-			const imported = await import(fileUrl);
+			const imported = await import(
+				/* @vite-ignore */
+				fileUrl
+);
 			const names = [];
 			for (const val of Object.values(imported)) if (isHandler(val)) {
 				registerHandler(val, file);
@@ -148,7 +135,7 @@ var HmrModuleHandler = class {
 			}
 			return names;
 		} catch (error) {
-			logger.error(`Failed to reload file: ${file}`, error);
+			logger.error(`Failed to reload file: ${formatFilePath(file)}`, vitePluginThrew(error) ?? error);
 			return null;
 		}
 	}
@@ -172,4 +159,4 @@ var HmrModuleHandler = class {
 
 //#endregion
 export { HmrModuleHandler as t };
-//# sourceMappingURL=HmrModuleHandler-DOAtah3j.mjs.map
+//# sourceMappingURL=HmrModuleHandler-8ZC-UuZh.mjs.map

package/dist/HmrModuleHandler-8ZC-UuZh.mjs.map

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