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

package/dist/{AutocompleteOptions-eKhIe6Qt.d.mts → AutocompleteOptions-DLp_B8as.d.mts}

@@ -1,8 +1,8 @@
-import { t as IsNever } from "./is-never-Ddaba1Su.mjs";
-import { f as CoreBase } from "./Plugin-CNyRKDHT.mjs";
+import { t as Constructor } from "./basic-D7bDlgSP.mjs";
+import { A as Notice, N as AckState, W as InteractionRoutes, j as ReplyTelemetry, y as CoreBase } from "./Plugin-3rlH0uxH.mjs";
 import { APIMessageTopLevelComponent, APIModalInteractionResponseCallbackData, ApplicationCommandType, ChannelType, Snowflake } from "discord-api-types/v10";
 import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, CheckboxBuilder, CheckboxGroupBuilder, CheckboxGroupOptionBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RadioGroupBuilder, RadioGroupOptionBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder } from "@discordjs/builders";
-import { DeferOpts, RenderContext, ReplyResponse, SendOpts } from "@seedcord/types";
+import { DeferOpts, ReplyResponse, SendOpts } from "@seedcord/types";
 
 //#region src/registries/SlashOptionRegistry.d.ts
 /** A slash option kind as a plain string union (`string`, `channel`, ...), keyed to the registry. */
@@ -152,13 +152,61 @@ declare abstract class RowComponent<RowKey extends RowType> extends BaseComponen
   get component(): InstantiatedActionRow<RowKey>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/basic.d.ts
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-never.d.ts
 /**
-Matches a [`class` constructor](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes).
+Returns a boolean for whether the given type is `never`.
 
-@category Class
+@link https://github.com/microsoft/TypeScript/issues/31751#issuecomment-498526919
+@link https://stackoverflow.com/a/53984913/10292952
+@link https://www.zhenghao.io/posts/ts-never
+
+Useful in type utilities, such as checking if something does not occur.
+
+@example
+```
+import type {IsNever, And} from 'type-fest';
+
+type A = IsNever<never>;
+//=> true
+
+type B = IsNever<any>;
+//=> false
+
+type C = IsNever<unknown>;
+//=> false
+
+type D = IsNever<never[]>;
+//=> false
+
+type E = IsNever<object>;
+//=> false
+
+type F = IsNever<string>;
+//=> false
+```
+
+@example
+```
+import type {IsNever} from 'type-fest';
+
+type IsTrue<T> = T extends true ? true : false;
+
+// When a distributive conditional is instantiated with `never`, the entire conditional results in `never`.
+type A = IsTrue<never>;
+//=> never
+
+// If you don't want that behaviour, you can explicitly add an `IsNever` check before the distributive conditional.
+type IsTrueFixed<T> =
+	IsNever<T> extends true ? false : T extends true ? true : false;
+
+type B = IsTrueFixed<never>;
+//=> false
+```
+
+@category Type Guard
+@category Utilities
 */
-type Constructor<T, Arguments extends unknown[] = any[]> = new (...arguments_: Arguments) => T;
+type IsNever<T> = [T] extends [never] ? true : false;
 //#endregion
 //#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/non-empty-tuple.d.ts
 /**
@@ -220,29 +268,6 @@ declare function RegisterCommand(scope: 'global'): (ctor: CommandCtor) => void;
  */
 declare function RegisterCommand(scope: 'guild', guilds: string[]): (ctor: CommandCtor) => void;
 //#endregion
-//#region src/metadataKeys.d.ts
-declare enum InteractionRoutes {
-  Slash = "slash",
-  Button = "button",
-  Modal = "modal",
-  StringMenu = "stringMenu",
-  UserMenu = "userMenu",
-  RoleMenu = "roleMenu",
-  ChannelMenu = "channelMenu",
-  MentionableMenu = "mentionableMenu",
-  MessageContextMenu = "messageContextMenu",
-  UserContextMenu = "userContextMenu",
-  Autocomplete = "autocomplete"
-}
-declare const InteractionMetadataKey: unique symbol;
-declare const InteractionRouteKeys: Record<InteractionRoutes, symbol>;
-declare const MiddlewareMetadataKey: unique symbol;
-declare const EventMetadataKey: unique symbol;
-declare const CommandMetadataKey: unique symbol;
-declare const GatedMetadataKey: unique symbol;
-declare const SubscribeMetadataKey: unique symbol;
-declare const WebhookUrlMetadataKey: unique symbol;
-//#endregion
 //#region src/customId/Field.d.ts
 /**
  * One field in a customId shape, its wire kind plus the type it decodes to.
@@ -433,19 +458,6 @@ declare function storeComponentRoute(route: InteractionRoutes, defs: readonly An
 declare function selectMenuRouteOf(kind: SelectMenuKind): InteractionRoutes;
 declare function contextMenuRouteOf(kind: ApplicationCommandType.User | ApplicationCommandType.Message): InteractionRoutes;
 //#endregion
-//#region src/reply/AckTrace.d.ts
-/** The first ack's stack, passed as the throw cause so a double-ack points to both lines. */
-declare class AckTrace extends Error {
-  constructor(method: ReplyMethod);
-}
-//#endregion
-//#region src/reply/ackLegality.d.ts
-type AckState = 'unacked' | 'deferred-reply' | 'deferred-update' | 'replied';
-type ReplyMethod = 'reply' | 'defer' | 'deferUpdate' | 'update' | 'followUp' | 'edit' | 'delete' | 'send' | 'showModal';
-/** Throws before any API call. `ackedBy` becomes the throw cause, its stack points at the first ack. */
-declare function checkAckLegality(method: ReplyMethod, state: AckState, routeId: string, ackedBy?: AckTrace): void;
-declare function sendTarget(state: AckState): 'reply' | 'edit' | 'followUp';
-//#endregion
 //#region src/reply/serializeReply.d.ts
 /** Serialized message data the transport wire writers consume. */
 interface SerializedReply {
@@ -471,10 +483,13 @@ declare abstract class BaseReplySender<TMessage extends {
   id: string;
 }> {
   protected readonly routeId: string;
+  private readonly telemetry?;
   private state;
   private readonly sent;
   private ackedBy?;
-  protected constructor(routeId: string, initialState?: AckState);
+  protected constructor(routeId: string, initialState?: AckState, telemetry?: ReplyTelemetry | undefined);
+  private report;
+  private attempt;
   reply(response: ReplyResponse | string, opts?: SendOpts): Promise<TMessage>;
   defer(opts?: DeferOpts): Promise<void>;
   deferUpdate(): Promise<void>;
@@ -722,72 +737,6 @@ declare function defineEffectGate<const Name extends string, Ctx extends GateCon
  */
 type RequiredOf<TGate> = TGate extends Gate<infer Ctx> ? Ctx : never;
 //#endregion
-//#region src/stops/Notice.d.ts
-/**
- * Base class for a user-facing refusal or a reported fault.
- *
- * Throw a `Notice` to stop a handler and reply to the user. The framework catches it at the controller
- * boundary and renders {@link Notice.render}, which always decides what the user sees. With `report`
- * false that render is all that happens. With `report` true the framework also logs the fault and
- * publishes it to the `handledException` bus. A raw, non-Notice throw shows the generic message.
- *
- * @example
- * ```ts
- * import { Notice, BuilderComponent, type RenderContext, type ReplyResponse } from '@seedcord/gateway';
- * import { TextDisplayBuilder } from '@discordjs/builders';
- *
- * // reading `.component` applies the configured bot color to the container accent
- * class TooPoorCard extends BuilderComponent<'container'> {
- *     constructor(balance: number) {
- *         super('container');
- *         this.instance.addTextDisplayComponents(
- *             new TextDisplayBuilder().setContent(`### Insufficient balance\nYou need more than ${balance} coins.`)
- *         );
- *     }
- * }
- *
- * class TooPoor extends Notice {
- *     constructor(private readonly balance: number) {
- *         super(`balance ${balance} is below the cost`);
- *     }
- *
- *     render(_ctx: RenderContext): ReplyResponse {
- *         return { components: [new TooPoorCard(this.balance).component] };
- *     }
- * }
- *
- * // in a handler, throwing stops the handler and replies with render(ctx)
- * if (wallet.balance < cost) throw new TooPoor(wallet.balance);
- * ```
- */
-declare abstract class Notice extends Error {
-  /**
-   * Whether this denial is a reported fault. True also logs it and publishes it to the `handledException`
-   * bus. The user always sees {@link Notice.render} either way.
-   *
-   * @defaultValue `false`
-   */
-  report: boolean;
-  /**
-   * Whether the reply is ephemeral, so only the invoking user sees it. Set it false for a refusal the
-   * whole channel should see.
-   *
-   * @defaultValue `true`
-   */
-  ephemeral: boolean;
-  /**
-   * A short one-line reason. When every arm of an `or` gate refuses and each refusal sets this, `or`
-   * lists them instead of showing a neutral message.
-   */
-  summary?: string;
-  protected constructor(message: string, options?: ErrorOptions);
-  /**
-   * Builds what the user sees. Called fresh each time the denial is shown, so the builders are new
-   * and the bot color resolves at render time rather than at construction time.
-   */
-  abstract render(ctx: RenderContext): ReplyResponse;
-}
-//#endregion
 //#region src/gates/matching.d.ts
 type IntersectRequired<Gates extends readonly Gate<GateContextBase>[]> = Gates extends readonly [infer First extends Gate<GateContextBase>, ...infer Rest extends readonly Gate<GateContextBase>[]] ? RequiredOf<First> & IntersectRequired<Rest> : unknown;
 type TwoOrMore<Item> = readonly [Item, Item, ...Item[]];
@@ -989,5 +938,5 @@ type Getter<Route extends keyof SlashOptionRegistry, Kind extends OptionKind, Me
  */
 type AutocompleteOptions<Route extends keyof SlashOptionRegistry> = Getter<Route, 'string', 'getString'> & Getter<Route, 'integer', 'getInteger'> & Getter<Route, 'number', 'getNumber'> & Getter<Route, 'boolean', 'getBoolean'>;
 //#endregion
-export { InteractionMetadataKey as $, serializeReply as A, interactionRoutesOf as B, GuildPermissionsContext as C, BaseReplySender as D, defineGate as E, AckTrace as F, CustomId as G, storeComponentRoute as H, RoutableConstructor as I, CustomIdField as J, decodeFor as K, SelectMenuKind as L, ReplyMethod as M, checkAckLegality as N, ModalLike as O, sendTarget as P, GatedMetadataKey as Q, areRoutes as R, GateContextBase as S, defineEffectGate as T, storeInteractionRoute as U, selectMenuRouteOf as V, AnyCustomId as W, CommandMetadataKey as X, DecodedParams as Y, EventMetadataKey as Z, JoinNames as _, FocusedField as a, CommandMeta as at, EffectGate as b, RequireBotPermissions as c, BuilderComponent as ct, RequireRole as d, RowType as dt, InteractionRouteKeys as et, RequireRoleOptions as f, OptionKind as ft, IntersectRequired as g, GateFitsWith as h, EntryFor as i, WebhookUrlMetadataKey as it, AckState as j, SerializedReply as k, RequirePermissions as l, RowComponent as lt, pickNotice as m, SlashOptionRegistry as mt, AutocompleteOptions as n, MiddlewareMetadataKey as nt, PermissionNames as o, RegisterCommand as ot, GateNoticeOptions as p, SlashOption as pt, prefixOf as q, ChoiceValueOf as r, SubscribeMetadataKey as rt, PermissionScope as s, Constructor as st, AutocompletableNames as t, InteractionRoutes as tt, RequirePermissionsOptions as u, BuilderType as ut, TwoOrMore as v, RequiredOf as w, Gate as x, Notice as y, contextMenuRouteOf as z };
-//# sourceMappingURL=AutocompleteOptions-eKhIe6Qt.d.mts.map
+export { SlashOptionRegistry as $, RoutableConstructor as A, decodeFor as B, RequiredOf as C, ModalLike as D, BaseReplySender as E, selectMenuRouteOf as F, RegisterCommand as G, CustomIdField as H, storeComponentRoute as I, RowComponent as J, IsNever as K, storeInteractionRoute as L, areRoutes as M, contextMenuRouteOf as N, SerializedReply as O, interactionRoutesOf as P, SlashOption as Q, AnyCustomId as R, GuildPermissionsContext as S, defineGate as T, DecodedParams as U, prefixOf as V, CommandMeta as W, RowType as X, BuilderType as Y, OptionKind as Z, JoinNames as _, FocusedField as a, Gate as b, RequireBotPermissions as c, RequireRole as d, RequireRoleOptions as f, IntersectRequired as g, GateFitsWith as h, EntryFor as i, SelectMenuKind as j, serializeReply as k, RequirePermissions as l, pickNotice as m, AutocompleteOptions as n, PermissionNames as o, GateNoticeOptions as p, BuilderComponent as q, ChoiceValueOf as r, PermissionScope as s, AutocompletableNames as t, RequirePermissionsOptions as u, TwoOrMore as v, defineEffectGate as w, GateContextBase as x, EffectGate as y, CustomId as z };
+//# sourceMappingURL=AutocompleteOptions-DLp_B8as.d.mts.map

package/dist/HmrModuleHandler-3sNgKHdf.mjs

@@ -0,0 +1,163 @@
+import { formatFilePath } from "@seedcord/utils";
+import chalk from "chalk";
+import { existsSync } from "node:fs";
+import { resolve, sep } from "node:path";
+import { pathToFileURL } from "node:url";
+
+//#region src/hmr/HmrModuleHandler.ts
+const displayName = (unit, fallback) => unit.name ?? fallback;
+/**
+* Reloads THandler and optional TMiddleware modules on HMR updates.
+*
+* Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.
+*
+* This is only useful during development.
+*/
+var HmrModuleHandler = class {
+	store;
+	options;
+	constructor(options) {
+		this.options = {
+			...options,
+			logger: options.logger.inChannel("hmr")
+		};
+		this.store = {
+			fileToHandlers: /* @__PURE__ */ new Map(),
+			fileToMiddlewares: /* @__PURE__ */ new Map(),
+			handlerArtifacts: /* @__PURE__ */ new Map()
+		};
+	}
+	/** 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, handlersDir, middlewaresDir } = this.options;
+		if (type === "delete" || type === "deleteDir") {
+			this.unload(file);
+			return;
+		}
+		if (type === "createDir") return;
+		if (type === "update" && !existsSync(file)) {
+			if (this.isTracked(file)) {
+				logger.info(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);
+				this.unload(file);
+			}
+			return;
+		}
+		const rollbackEnabled = event.rollback ?? true;
+		const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];
+		const absHandlersDir = resolve(process.cwd(), handlersDir);
+		const absMiddlewaresDir = middlewaresDir ? resolve(process.cwd(), middlewaresDir) : null;
+		for (const fileToReload of filesToReload) {
+			const isHandler = fileToReload.startsWith(absHandlersDir + sep);
+			const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + sep) : false;
+			if (!isHandler && !isMiddleware) continue;
+			await this.reloadWithRollback(fileToReload, rollbackEnabled);
+		}
+	}
+	async reloadWithRollback(file, rollbackEnabled) {
+		const { logger } = this.options;
+		const snapshot = this.snapshotUnits(file);
+		this.unload(file);
+		if (await this.reloadFile(file)) return;
+		this.unload(file);
+		if (!rollbackEnabled) return;
+		if (snapshot.handlers.length === 0 && snapshot.middlewares.length === 0) return;
+		this.restoreUnits(file, snapshot);
+		logger.warn(`${chalk.yellow.bold("Rolled back")} ${chalk.gray(formatFilePath(file))} to the last-good version`);
+	}
+	/** Links the handler to its source file so a later update can unload it. */
+	trackHandler(file, handler) {
+		let set = this.store.fileToHandlers.get(file);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.store.fileToHandlers.set(file, set);
+		}
+		set.add(handler);
+		if (this.options.getArtifacts) {
+			const artifacts = this.options.getArtifacts(handler);
+			this.store.handlerArtifacts.set(handler, artifacts);
+		}
+	}
+	/** Links the middleware to its source file so a later update can unload it. */
+	trackMiddleware(file, middleware) {
+		let set = this.store.fileToMiddlewares.get(file);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.store.fileToMiddlewares.set(file, set);
+		}
+		set.add(middleware);
+	}
+	isTracked(file) {
+		return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);
+	}
+	unload(file) {
+		const { logger } = this.options;
+		const handlers = this.store.fileToHandlers.get(file);
+		if (handlers) {
+			for (const handler of handlers) {
+				const artifacts = this.store.handlerArtifacts.get(handler);
+				this.options.unregisterHandler(handler, artifacts);
+				this.store.handlerArtifacts.delete(handler);
+				const name = displayName(handler, "Handler");
+				logger.info(`${chalk.red.bold("Unloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
+			}
+			this.store.fileToHandlers.delete(file);
+		}
+		const middlewares = this.store.fileToMiddlewares.get(file);
+		if (middlewares) {
+			for (const middleware of middlewares) {
+				this.options.unregisterMiddleware?.(middleware);
+				const name = displayName(middleware, "Middleware");
+				logger.info(`${chalk.red.bold("Unloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
+			}
+			this.store.fileToMiddlewares.delete(file);
+		}
+	}
+	async reloadFile(file) {
+		const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;
+		if (!existsSync(file)) {
+			logger.info(`File does not exist, skipping reload: ${formatFilePath(file)}`);
+			return false;
+		}
+		try {
+			let fileUrl = pathToFileURL(file).href;
+			if (process.env.VITEST === "true") fileUrl += `?update=${Date.now()}`;
+			const imported = await import(fileUrl);
+			for (const val of Object.values(imported)) if (isHandler(val)) {
+				registerHandler(val, file);
+				this.trackHandler(file, val);
+				const name = displayName(val, "Handler");
+				logger.info(`${chalk.blue.bold("Reloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
+			} else if (isMiddleware && registerMiddleware && isMiddleware(val)) {
+				registerMiddleware(val, file);
+				this.trackMiddleware(file, val);
+				const name = displayName(val, "Middleware");
+				logger.info(`${chalk.blue.bold("Reloaded")} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`);
+			}
+			return true;
+		} catch (error) {
+			logger.error(`Failed to reload file: ${file}`, error);
+			return false;
+		}
+	}
+	snapshotUnits(file) {
+		return {
+			handlers: [...this.store.fileToHandlers.get(file) ?? []],
+			middlewares: [...this.store.fileToMiddlewares.get(file) ?? []]
+		};
+	}
+	restoreUnits(file, snapshot) {
+		for (const handler of snapshot.handlers) {
+			this.options.registerHandler(handler, file);
+			this.trackHandler(file, handler);
+		}
+		if (this.options.registerMiddleware) for (const middleware of snapshot.middlewares) {
+			this.options.registerMiddleware(middleware, file);
+			this.trackMiddleware(file, middleware);
+		}
+	}
+};
+
+//#endregion
+export { HmrModuleHandler as t };
+//# sourceMappingURL=HmrModuleHandler-3sNgKHdf.mjs.map

package/dist/HmrModuleHandler-3sNgKHdf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HmrModuleHandler-3sNgKHdf.mjs","names":[],"sources":["../src/hmr/HmrModuleHandler.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { resolve, sep } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\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        // the caller's options object stays unmutated\n        this.options = { ...options, logger: options.logger.inChannel('hmr') };\n\n        // no import.meta.hot.data stash needed, a leaf reload never reconstructs the singleton that holds 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        const { logger, handlersDir, middlewaresDir } = this.options;\n\n        if (type === 'delete' || type === 'deleteDir') {\n            this.unload(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        if (type === 'update' && !existsSync(file)) {\n            if (this.isTracked(file)) {\n                logger.info(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);\n                this.unload(file);\n            }\n            return;\n        }\n\n        const rollbackEnabled = event.rollback ?? true;\n        const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];\n        const absHandlersDir = resolve(process.cwd(), handlersDir);\n        const absMiddlewaresDir = middlewaresDir ? resolve(process.cwd(), middlewaresDir) : null;\n\n        for (const fileToReload of filesToReload) {\n            // the separator keeps a sibling dir sharing the prefix (commands-extra vs commands) out\n            const isHandler = fileToReload.startsWith(absHandlersDir + sep);\n            const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + sep) : false;\n\n            if (!isHandler && !isMiddleware) {\n                continue;\n            }\n\n            await this.reloadWithRollback(fileToReload, rollbackEnabled);\n        }\n    }\n\n    private async reloadWithRollback(file: string, rollbackEnabled: boolean): Promise<void> {\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) return;\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 them live until the next good save\n        this.restoreUnits(file, snapshot);\n        logger.warn(`${chalk.yellow.bold('Rolled back')} ${chalk.gray(formatFilePath(file))} to the last-good version`);\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) {\n            const artifacts = this.options.getArtifacts(handler);\n            this.store.handlerArtifacts.set(handler, artifacts);\n        }\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 isTracked(file: string): boolean {\n        return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);\n    }\n\n    private unload(file: string): void {\n        const { logger } = this.options;\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                const name = displayName(handler, 'Handler');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\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                const name = displayName(middleware, 'Middleware');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToMiddlewares.delete(file);\n        }\n    }\n\n    private async reloadFile(file: string): Promise<boolean> {\n        const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;\n\n        if (!existsSync(file)) {\n            logger.info(`File does not exist, skipping reload: ${formatFilePath(file)}`);\n            return false;\n        }\n\n        try {\n            let fileUrl = pathToFileURL(file).href;\n            // vitest has no real vite server managing the module graph, so bust the import cache manually.\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(fileUrl)) as Record<string, unknown>;\n\n            for (const val of Object.values(imported)) {\n                if (isHandler(val)) {\n                    registerHandler(val, file);\n                    this.trackHandler(file, val);\n                    const name = displayName(val, 'Handler');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                } else if (isMiddleware && registerMiddleware && isMiddleware(val)) {\n                    registerMiddleware(val, file);\n                    this.trackMiddleware(file, val);\n                    const name = displayName(val, 'Middleware');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                }\n            }\n\n            return true;\n        } catch (error) {\n            logger.error(`Failed to reload file: ${file}`, error);\n            return false;\n        }\n    }\n\n    // restoring re-registers the same class objects, so a live db connection survives 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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"}

package/dist/HmrModuleHandler-CTBng7wV.cjs

@@ -0,0 +1,170 @@
+const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
+let _seedcord_utils = require("@seedcord/utils");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk, 1);
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let node_url = require("node:url");
+
+//#region src/hmr/HmrModuleHandler.ts
+const displayName = (unit, fallback) => unit.name ?? fallback;
+/**
+* Reloads THandler and optional TMiddleware modules on HMR updates.
+*
+* Call `handle()` from your `HmrAware.onHmr()` for standard reload behavior, or write a fully custom `onHmr()` and skip this class.
+*
+* This is only useful during development.
+*/
+var HmrModuleHandler = class {
+	store;
+	options;
+	constructor(options) {
+		this.options = {
+			...options,
+			logger: options.logger.inChannel("hmr")
+		};
+		this.store = {
+			fileToHandlers: /* @__PURE__ */ new Map(),
+			fileToMiddlewares: /* @__PURE__ */ new Map(),
+			handlerArtifacts: /* @__PURE__ */ new Map()
+		};
+	}
+	/** 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, handlersDir, middlewaresDir } = this.options;
+		if (type === "delete" || type === "deleteDir") {
+			this.unload(file);
+			return;
+		}
+		if (type === "createDir") return;
+		if (type === "update" && !(0, node_fs.existsSync)(file)) {
+			if (this.isTracked(file)) {
+				logger.info(`Received update for non-existent file: ${(0, _seedcord_utils.formatFilePath)(file)}, treating as delete`);
+				this.unload(file);
+			}
+			return;
+		}
+		const rollbackEnabled = event.rollback ?? true;
+		const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];
+		const absHandlersDir = (0, node_path.resolve)(process.cwd(), handlersDir);
+		const absMiddlewaresDir = middlewaresDir ? (0, node_path.resolve)(process.cwd(), middlewaresDir) : null;
+		for (const fileToReload of filesToReload) {
+			const isHandler = fileToReload.startsWith(absHandlersDir + node_path.sep);
+			const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + node_path.sep) : false;
+			if (!isHandler && !isMiddleware) continue;
+			await this.reloadWithRollback(fileToReload, rollbackEnabled);
+		}
+	}
+	async reloadWithRollback(file, rollbackEnabled) {
+		const { logger } = this.options;
+		const snapshot = this.snapshotUnits(file);
+		this.unload(file);
+		if (await this.reloadFile(file)) return;
+		this.unload(file);
+		if (!rollbackEnabled) return;
+		if (snapshot.handlers.length === 0 && snapshot.middlewares.length === 0) return;
+		this.restoreUnits(file, snapshot);
+		logger.warn(`${chalk.default.yellow.bold("Rolled back")} ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))} to the last-good version`);
+	}
+	/** Links the handler to its source file so a later update can unload it. */
+	trackHandler(file, handler) {
+		let set = this.store.fileToHandlers.get(file);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.store.fileToHandlers.set(file, set);
+		}
+		set.add(handler);
+		if (this.options.getArtifacts) {
+			const artifacts = this.options.getArtifacts(handler);
+			this.store.handlerArtifacts.set(handler, artifacts);
+		}
+	}
+	/** Links the middleware to its source file so a later update can unload it. */
+	trackMiddleware(file, middleware) {
+		let set = this.store.fileToMiddlewares.get(file);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.store.fileToMiddlewares.set(file, set);
+		}
+		set.add(middleware);
+	}
+	isTracked(file) {
+		return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);
+	}
+	unload(file) {
+		const { logger } = this.options;
+		const handlers = this.store.fileToHandlers.get(file);
+		if (handlers) {
+			for (const handler of handlers) {
+				const artifacts = this.store.handlerArtifacts.get(handler);
+				this.options.unregisterHandler(handler, artifacts);
+				this.store.handlerArtifacts.delete(handler);
+				const name = displayName(handler, "Handler");
+				logger.info(`${chalk.default.red.bold("Unloaded")} ${chalk.default.cyan.bold(name)} from ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))}`);
+			}
+			this.store.fileToHandlers.delete(file);
+		}
+		const middlewares = this.store.fileToMiddlewares.get(file);
+		if (middlewares) {
+			for (const middleware of middlewares) {
+				this.options.unregisterMiddleware?.(middleware);
+				const name = displayName(middleware, "Middleware");
+				logger.info(`${chalk.default.red.bold("Unloaded")} ${chalk.default.cyan.bold(name)} from ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))}`);
+			}
+			this.store.fileToMiddlewares.delete(file);
+		}
+	}
+	async reloadFile(file) {
+		const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;
+		if (!(0, node_fs.existsSync)(file)) {
+			logger.info(`File does not exist, skipping reload: ${(0, _seedcord_utils.formatFilePath)(file)}`);
+			return false;
+		}
+		try {
+			let fileUrl = (0, node_url.pathToFileURL)(file).href;
+			if (process.env.VITEST === "true") fileUrl += `?update=${Date.now()}`;
+			const imported = await import(fileUrl);
+			for (const val of Object.values(imported)) if (isHandler(val)) {
+				registerHandler(val, file);
+				this.trackHandler(file, val);
+				const name = displayName(val, "Handler");
+				logger.info(`${chalk.default.blue.bold("Reloaded")} ${chalk.default.cyan.bold(name)} from ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))}`);
+			} else if (isMiddleware && registerMiddleware && isMiddleware(val)) {
+				registerMiddleware(val, file);
+				this.trackMiddleware(file, val);
+				const name = displayName(val, "Middleware");
+				logger.info(`${chalk.default.blue.bold("Reloaded")} ${chalk.default.cyan.bold(name)} from ${chalk.default.gray((0, _seedcord_utils.formatFilePath)(file))}`);
+			}
+			return true;
+		} catch (error) {
+			logger.error(`Failed to reload file: ${file}`, error);
+			return false;
+		}
+	}
+	snapshotUnits(file) {
+		return {
+			handlers: [...this.store.fileToHandlers.get(file) ?? []],
+			middlewares: [...this.store.fileToMiddlewares.get(file) ?? []]
+		};
+	}
+	restoreUnits(file, snapshot) {
+		for (const handler of snapshot.handlers) {
+			this.options.registerHandler(handler, file);
+			this.trackHandler(file, handler);
+		}
+		if (this.options.registerMiddleware) for (const middleware of snapshot.middlewares) {
+			this.options.registerMiddleware(middleware, file);
+			this.trackMiddleware(file, middleware);
+		}
+	}
+};
+
+//#endregion
+Object.defineProperty(exports, 'HmrModuleHandler', {
+  enumerable: true,
+  get: function () {
+    return HmrModuleHandler;
+  }
+});
+//# sourceMappingURL=HmrModuleHandler-CTBng7wV.cjs.map

package/dist/HmrModuleHandler-CTBng7wV.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"HmrModuleHandler-CTBng7wV.cjs","names":["sep"],"sources":["../src/hmr/HmrModuleHandler.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { resolve, sep } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { formatFilePath } from '@seedcord/utils';\nimport chalk from 'chalk';\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        // the caller's options object stays unmutated\n        this.options = { ...options, logger: options.logger.inChannel('hmr') };\n\n        // no import.meta.hot.data stash needed, a leaf reload never reconstructs the singleton that holds 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        const { logger, handlersDir, middlewaresDir } = this.options;\n\n        if (type === 'delete' || type === 'deleteDir') {\n            this.unload(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        if (type === 'update' && !existsSync(file)) {\n            if (this.isTracked(file)) {\n                logger.info(`Received update for non-existent file: ${formatFilePath(file)}, treating as delete`);\n                this.unload(file);\n            }\n            return;\n        }\n\n        const rollbackEnabled = event.rollback ?? true;\n        const filesToReload = affectedModules && affectedModules.length > 0 ? affectedModules : [file];\n        const absHandlersDir = resolve(process.cwd(), handlersDir);\n        const absMiddlewaresDir = middlewaresDir ? resolve(process.cwd(), middlewaresDir) : null;\n\n        for (const fileToReload of filesToReload) {\n            // the separator keeps a sibling dir sharing the prefix (commands-extra vs commands) out\n            const isHandler = fileToReload.startsWith(absHandlersDir + sep);\n            const isMiddleware = absMiddlewaresDir ? fileToReload.startsWith(absMiddlewaresDir + sep) : false;\n\n            if (!isHandler && !isMiddleware) {\n                continue;\n            }\n\n            await this.reloadWithRollback(fileToReload, rollbackEnabled);\n        }\n    }\n\n    private async reloadWithRollback(file: string, rollbackEnabled: boolean): Promise<void> {\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) return;\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 them live until the next good save\n        this.restoreUnits(file, snapshot);\n        logger.warn(`${chalk.yellow.bold('Rolled back')} ${chalk.gray(formatFilePath(file))} to the last-good version`);\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) {\n            const artifacts = this.options.getArtifacts(handler);\n            this.store.handlerArtifacts.set(handler, artifacts);\n        }\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 isTracked(file: string): boolean {\n        return this.store.fileToHandlers.has(file) || this.store.fileToMiddlewares.has(file);\n    }\n\n    private unload(file: string): void {\n        const { logger } = this.options;\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                const name = displayName(handler, 'Handler');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\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                const name = displayName(middleware, 'Middleware');\n                logger.info(\n                    `${chalk.red.bold('Unloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                );\n            }\n            this.store.fileToMiddlewares.delete(file);\n        }\n    }\n\n    private async reloadFile(file: string): Promise<boolean> {\n        const { logger, isHandler, isMiddleware, registerHandler, registerMiddleware } = this.options;\n\n        if (!existsSync(file)) {\n            logger.info(`File does not exist, skipping reload: ${formatFilePath(file)}`);\n            return false;\n        }\n\n        try {\n            let fileUrl = pathToFileURL(file).href;\n            // vitest has no real vite server managing the module graph, so bust the import cache manually.\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(fileUrl)) as Record<string, unknown>;\n\n            for (const val of Object.values(imported)) {\n                if (isHandler(val)) {\n                    registerHandler(val, file);\n                    this.trackHandler(file, val);\n                    const name = displayName(val, 'Handler');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                } else if (isMiddleware && registerMiddleware && isMiddleware(val)) {\n                    registerMiddleware(val, file);\n                    this.trackMiddleware(file, val);\n                    const name = displayName(val, 'Middleware');\n                    logger.info(\n                        `${chalk.blue.bold('Reloaded')} ${chalk.cyan.bold(name)} from ${chalk.gray(formatFilePath(file))}`\n                    );\n                }\n            }\n\n            return true;\n        } catch (error) {\n            logger.error(`Failed to reload file: ${file}`, error);\n            return false;\n        }\n    }\n\n    // restoring re-registers the same class objects, so a live db connection survives 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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"}