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

package/dist/hmr.index.cjs

@@ -1,166 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-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");
+const require_HmrModuleHandler = require('./HmrModuleHandler-CTBng7wV.cjs');
 
-//#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
-exports.HmrModuleHandler = HmrModuleHandler;
-//# sourceMappingURL=hmr.index.cjs.map
+exports.HmrModuleHandler = require_HmrModuleHandler.HmrModuleHandler;

package/dist/hmr.index.mjs

@@ -1,163 +1,3 @@
-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";
+import { t as HmrModuleHandler } from "./HmrModuleHandler-3sNgKHdf.mjs";
 
-//#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 };
-//# sourceMappingURL=hmr.index.mjs.map
+export { HmrModuleHandler };

package/dist/index-Dueqztyy.d.mts

@@ -0,0 +1,142 @@
+import { t as Constructor } from "./basic-D7bDlgSP.mjs";
+import { C as Subscriber, O as SubscriptionKey, y as CoreBase } from "./Plugin-3rlH0uxH.mjs";
+import { APIMessageTopLevelComponent } from "discord-api-types/v10";
+import { EventFrequency } from "@seedcord/types";
+
+//#region src/subscribers/decorators/Subscribe.d.ts
+/**
+ * Options accepted by the `@Subscribe` decorator.
+ */
+interface SubscribeOptions {
+  /**
+   * Frequency: `'once'` or `'on'`.
+   *
+   * @defaultValue `'on'`
+   */
+  readonly frequency?: EventFrequency | undefined;
+}
+/**
+ * Registers a subscriber handler class with a specific subscriber event.
+ *
+ * Associates the decorated class with a subscriber event type for automatic
+ * registration and execution when the subscriber is emitted.
+ *
+ * @typeParam TSubscriber - The subscriber event name to register for
+ * @param subscriber - The subscriber event name to register for
+ * @param options - Options to configure the subscriber handler registration.
+ * @decorator
+ * @example
+ * ```typescript
+ * \@Subscribe('userJoin')
+ * class WelcomeHandler extends Subscriber<'userJoin'> {
+ *   async execute() {
+ *     // Handle user join event
+ *   }
+ * }
+ * ```
+ * @example
+ * ```ts
+ * \@Subscribe('userJoin', { frequency: 'once' })
+ * // or
+ * \@Subscribe('userJoin')
+ * ```
+ */
+declare function Subscribe<TSubscriber extends SubscriptionKey>(subscriber: TSubscriber, options?: SubscribeOptions): <HandlerCtor extends Constructor<Subscriber<TSubscriber, CoreBase>>>(constructor: HandlerCtor) => void;
+//#endregion
+//#region src/subscribers/bases/WebhookSender.d.ts
+/**
+ * A file attached to a webhook report.
+ */
+interface WebhookFile {
+  name: string;
+  description: string;
+  /** A `Buffer` still satisfies this, it extends `Uint8Array`. */
+  data: Uint8Array | string;
+}
+/**
+ * The payload {@link WebhookSender.send} posts.
+ */
+interface WebhookSendOptions {
+  flags: number;
+  username: string;
+  components: readonly {
+    toJSON(): APIMessageTopLevelComponent;
+  }[];
+  files?: readonly WebhookFile[] | undefined;
+}
+/**
+ * Sends component messages to a Discord webhook through `@discordjs/rest`.
+ *
+ * @throws A `SeedcordError` when the url does not carry a webhook id and token.
+ */
+declare class WebhookSender {
+  private readonly rest;
+  private readonly route;
+  constructor(url: string);
+  /**
+   * Fetches the webhook object, sending no message. Returns `missing` on a 404 or 401 from
+   * Discord and `unreachable` on any other failure.
+   */
+  verify(): Promise<'ok' | 'missing' | 'unreachable'>;
+  send(options: WebhookSendOptions): Promise<void>;
+}
+//#endregion
+//#region src/subscribers/bases/WebhookLog.d.ts
+/**
+ * The content a reporter returns from {@link WebhookLog.report}.
+ */
+interface WebhookReport {
+  /** Shown as the webhook message author. Defaults to the reporter's class name. */
+  username?: string;
+  components: readonly {
+    toJSON(): APIMessageTopLevelComponent;
+  }[];
+  files?: readonly WebhookFile[] | undefined;
+}
+/**
+ * Base class for subscribers that deliver their event to a Discord webhook.
+ *
+ * Declare the url's environment variable with `@WebhookUrl` and implement {@link report}. Url
+ * resolution, validation, sender reuse, and sending run in the base. When the variable is unset
+ * the reporter is skipped at registration with a boot warning.
+ *
+ * @typeParam KeyOfSubscribers - The subscription key this reporter receives
+ * @typeParam TCore - The transport's Core
+ */
+declare abstract class WebhookLog<KeyOfSubscribers extends SubscriptionKey, TCore extends CoreBase> extends Subscriber<KeyOfSubscribers, TCore> {
+  private static readonly senders;
+  /** Builds the message for one published event. */
+  abstract report(): WebhookReport | Promise<WebhookReport>;
+  execute(): Promise<void>;
+  /** @internal */
+  static senderFor(url: string): WebhookSender;
+  /** @internal */
+  static envKeyOf(ctor: NewableFunction): string;
+  /** @internal Returns null when the env var is unset, throws when set but malformed. */
+  static urlOf(envKey: string): string | null;
+}
+//#endregion
+//#region src/subscribers/decorators/WebhookUrl.d.ts
+/**
+ * Declares the environment variable a {@link WebhookLog} reporter reads its webhook url from.
+ *
+ * An unset variable disables the reporter with a boot warning. A set but malformed value throws
+ * at boot.
+ *
+ * @param envKey - The environment variable name holding the webhook url
+ * @decorator
+ * @example
+ * ```ts
+ * \@Subscribe('memberBanned')
+ * \@WebhookUrl('BAN_LOG_WEBHOOK_URL')
+ * class BanLog extends WebhookLog<'memberBanned'> {
+ *   report() {
+ *     return { components: [new BanCard(this.data).component] };
+ *   }
+ * }
+ * ```
+ */
+declare function WebhookUrl(envKey: string): <HandlerCtor extends Constructor<WebhookLog<SubscriptionKey, CoreBase>>>(constructor: HandlerCtor) => void;
+//#endregion
+export { Subscribe as a, WebhookFile as i, WebhookLog as n, SubscribeOptions as o, WebhookReport as r, WebhookUrl as t };
+//# sourceMappingURL=index-Dueqztyy.d.mts.map