@azurioh/discord-kernel 0.1.0

package/dist/logger.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A single log call. Mirrors the pino calling convention so call sites can pass
+ * either a bare message or a structured record followed by a message:
+ * `logger.error({ err }, "Failed to do the thing")`.
+ */
+export interface LogFn {
+    (record: unknown, message?: string, ...args: unknown[]): void;
+    (message: string, ...args: unknown[]): void;
+}
+/**
+ * Structured application logger port.
+ *
+ * Declared structurally on purpose: `core` owns the contract and stays free of
+ * any vendor SDK, so the concrete implementation (pino, Sentry, a test double)
+ * lives in `infrastructure/logging` and can be swapped without touching call
+ * sites.
+ */
+export interface Logger {
+    trace: LogFn;
+    debug: LogFn;
+    info: LogFn;
+    warn: LogFn;
+    error: LogFn;
+    fatal: LogFn;
+    /** Derive a logger that stamps `bindings` onto every record it emits. */
+    child(bindings: Record<string, unknown>): Logger;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,KAAK;IACrB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC9D,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,yEAAyE;IACzE,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CACjD"}

package/dist/logger.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":""}

package/dist/module/module.d.ts

@@ -0,0 +1,42 @@
+import type { ContextMenuCommand, SlashCommand } from "../discord/command/types";
+import type { ComponentHandler } from "../discord/components/component-router";
+import type { DiscordEvent } from "../discord/events/types";
+import type { Catalog } from "../i18n";
+import type { ScheduledJob } from "../scheduler/scheduler";
+/**
+ * A self-contained vertical feature slice. A module bundles everything it
+ * contributes to the bot — commands, gateway events, scheduled jobs — and an
+ * optional async `setup` for one-off work (creating indexes, migrations…).
+ *
+ * Modules are produced by factories that receive the application container (see
+ * `bootstrap/container.ts`), so all dependencies are injected — never imported
+ * as singletons. The core depends only on this output contract, never on how a
+ * module is wired.
+ */
+export interface BotModule {
+    /** Stable identifier, used in logs. */
+    readonly name: string;
+    readonly commands?: readonly SlashCommand[];
+    /** Right-click entries on a member or a message (the Apps submenu). */
+    readonly contextMenuCommands?: readonly ContextMenuCommand[];
+    /** Persistent component/modal handlers (routed by `customId`). */
+    readonly components?: readonly ComponentHandler[];
+    readonly events?: readonly DiscordEvent[];
+    readonly jobs?: readonly ScheduledJob[];
+    /**
+     * The module's translation catalog (keys namespaced by module name). The
+     * composition root registers it into the shared registry at boot — a
+     * duplicate key across modules fails the boot, never a runtime lookup.
+     */
+    readonly translations?: Catalog;
+    /** One-off initialisation run once at boot, after the client is ready. */
+    setup?(): Promise<void> | void;
+    /**
+     * Symmetric counterpart of {@link setup}, awaited during graceful shutdown
+     * before the client and the database are closed. Release what the module owns
+     * and the framework cannot see — timers, collectors, third-party connections.
+     * A rejecting teardown is logged and never aborts the shutdown of the others.
+     */
+    teardown?(): Promise<void> | void;
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/module/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/module/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACzB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,uEAAuE;IACvE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC7D,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,0EAA0E;IAC1E,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClC"}

package/dist/module/module.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=module.js.map

package/dist/module/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/module/module.ts"],"names":[],"mappings":""}

package/dist/persistence/database.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Driver-agnostic persistence port. It exists so the framework (boot, graceful
+ * shutdown) can own a database lifecycle without ever naming a vendor: adding a
+ * SQL or Redis driver must not require touching this file, only adding an
+ * adapter that satisfies this contract.
+ *
+ * Deliberately narrow: querying is not part of it. Query APIs differ too much
+ * between engines to be usefully abstracted here, so each adapter exposes its
+ * own (Mongo collections, SQL statements…) and repositories in the module
+ * `infrastructure/` layer are the only code allowed to use it.
+ */
+export interface DatabaseConnection {
+    /**
+     * Discriminant identifying the concrete driver. Adapters narrow it to a
+     * string literal so consumers can select an implementation by comparison
+     * rather than by `instanceof`, which would force a vendor import.
+     */
+    readonly driver: string;
+    /** Open the connection. Idempotent: safe to call from several call sites. */
+    connect(): Promise<void>;
+    /** Release the connection on graceful shutdown. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/persistence/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/persistence/database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,mDAAmD;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/persistence/database.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=database.js.map

package/dist/persistence/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/persistence/database.ts"],"names":[],"mappings":""}

package/dist/resilience/retry.d.ts

@@ -0,0 +1,36 @@
+export interface RetryOptions {
+    /** Total number of tries, first attempt included. */
+    attempts?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffFactor?: number;
+    jitterRatio?: number;
+    /** Decide whether a failure is worth another try. Default: anything but a permanent failure. */
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    /** Injected so tests advance instantly instead of waiting on real timers. */
+    sleep?: (delayMs: number) => Promise<void>;
+    /** Injected randomness keeps the jitter deterministic under test. */
+    random?: () => number;
+}
+/** Everything the backoff needs once caller defaults have been resolved. */
+export interface BackoffOptions {
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffFactor: number;
+    jitterRatio: number;
+    random: () => number;
+}
+/**
+ * Exponential backoff with jitter. The jitter matters more than the curve itself:
+ * without it every caller that failed during the same outage retries in lockstep
+ * and hammers the dependency back down.
+ */
+export declare function computeBackoffDelay(attempt: number, options: BackoffOptions): number;
+/**
+ * Run `task`, retrying transient failures until the attempt budget is spent, then
+ * rethrowing the last error. Vendor-free by design: callers pass their own
+ * `shouldRetry` (e.g. built on the Discord API predicates) so this stays usable
+ * for any I/O.
+ */
+export declare function withRetry<T>(task: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/resilience/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/resilience/retry.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,YAAY;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,6EAA6E;IAC7E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,MAAM,CAAC;CACrB;AAiBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAKpF;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkCjG"}

package/dist/resilience/retry.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeBackoffDelay = computeBackoffDelay;
+exports.withRetry = withRetry;
+const errors_1 = require("../errors");
+const MIN_ATTEMPTS = 1;
+const DEFAULT_ATTEMPTS = 3;
+const DEFAULT_INITIAL_DELAY_MS = 200;
+const DEFAULT_MAX_DELAY_MS = 5_000;
+const DEFAULT_BACKOFF_FACTOR = 2;
+/** Share of the computed delay kept fixed; the rest is randomised (full jitter on 1 - RATIO). */
+const DEFAULT_JITTER_RATIO = 0.5;
+/**
+ * A {@link BusinessError} describes an expected, user-facing failure (bad input,
+ * missing entity, conflict): repeating the call cannot change the outcome, so it
+ * is never retried. Everything else is assumed transient until proven otherwise.
+ */
+function isTransient(error) {
+    return !(error instanceof errors_1.BusinessError);
+}
+function defaultSleep(delayMs) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, delayMs);
+    });
+}
+/**
+ * Exponential backoff with jitter. The jitter matters more than the curve itself:
+ * without it every caller that failed during the same outage retries in lockstep
+ * and hammers the dependency back down.
+ */
+function computeBackoffDelay(attempt, options) {
+    const exponential = options.initialDelayMs * options.backoffFactor ** (attempt - 1);
+    const capped = Math.min(exponential, options.maxDelayMs);
+    const fixed = capped * options.jitterRatio;
+    return Math.round(fixed + (capped - fixed) * options.random());
+}
+/**
+ * Run `task`, retrying transient failures until the attempt budget is spent, then
+ * rethrowing the last error. Vendor-free by design: callers pass their own
+ * `shouldRetry` (e.g. built on the Discord API predicates) so this stays usable
+ * for any I/O.
+ */
+async function withRetry(task, options = {}) {
+    // `Math.max` propagates NaN, and `attempt <= NaN` is false on the first pass:
+    // an unusable budget would skip the task entirely and reject with `undefined`.
+    // Floor to a valid count so a bad config still runs the task once.
+    const requested = options.attempts ?? DEFAULT_ATTEMPTS;
+    const attempts = Number.isFinite(requested)
+        ? Math.max(MIN_ATTEMPTS, Math.floor(requested))
+        : DEFAULT_ATTEMPTS;
+    const shouldRetry = options.shouldRetry ?? isTransient;
+    const sleep = options.sleep ?? defaultSleep;
+    const backoff = {
+        initialDelayMs: options.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS,
+        maxDelayMs: options.maxDelayMs ?? DEFAULT_MAX_DELAY_MS,
+        backoffFactor: options.backoffFactor ?? DEFAULT_BACKOFF_FACTOR,
+        jitterRatio: options.jitterRatio ?? DEFAULT_JITTER_RATIO,
+        random: options.random ?? Math.random,
+    };
+    let lastError;
+    for (let attempt = MIN_ATTEMPTS; attempt <= attempts; attempt += 1) {
+        try {
+            return await task();
+        }
+        catch (error) {
+            lastError = error;
+            const isLastAttempt = attempt === attempts;
+            if (isLastAttempt || !shouldRetry(error, attempt)) {
+                throw error;
+            }
+            await sleep(computeBackoffDelay(attempt, backoff));
+        }
+    }
+    // Unreachable — the loop always returns or throws — but the compiler cannot
+    // prove the budget is non-empty, and a silent `undefined` would be worse.
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/resilience/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/resilience/retry.ts"],"names":[],"mappings":";;AAsDA,kDAKC;AAQD,8BAkCC;AArGD,qCAAyC;AAEzC,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,iGAAiG;AACjG,MAAM,oBAAoB,GAAG,GAAG,CAAC;AA0BjC;;;;GAIG;AACH,SAAS,WAAW,CAAC,KAAc;IAClC,OAAO,CAAC,CAAC,KAAK,YAAY,sBAAa,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,OAAe,EAAE,OAAuB;IAC3E,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,SAAS,CAAI,IAAsB,EAAE,UAAwB,EAAE;IACpF,8EAA8E;IAC9E,+EAA+E;IAC/E,mEAAmE;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC1C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC,CAAC,gBAAgB,CAAC;IACpB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,MAAM,OAAO,GAAmB;QAC/B,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,wBAAwB;QAClE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,oBAAoB;QACtD,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,sBAAsB;QAC9D,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,oBAAoB;QACxD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;KACrC,CAAC;IAEF,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,YAAY,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC;YACJ,OAAO,MAAM,IAAI,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,aAAa,GAAG,OAAO,KAAK,QAAQ,CAAC;YAC3C,IAAI,aAAa,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;gBACnD,MAAM,KAAK,CAAC;YACb,CAAC;YACD,MAAM,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACpD,CAAC;IACF,CAAC;IACD,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,SAAS,CAAC;AACjB,CAAC"}

package/dist/scheduler/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Failures raised while a job's schedule is resolved. They live apart from the
+ * scheduler so a composition root can catch or re-map them without importing the
+ * scheduling logic, and so the scheduler file stays focused on behaviour.
+ */
+/** Base class for every malformed-schedule failure, so callers can catch the family. */
+export declare abstract class JobScheduleError extends Error {
+}
+/** Raised when a job declares both a cron expression and a fixed interval. */
+export declare class AmbiguousJobScheduleError extends JobScheduleError {
+    constructor(jobName: string);
+}
+/** Raised when a job declares neither a cron expression nor a fixed interval. */
+export declare class MissingJobScheduleError extends JobScheduleError {
+    constructor(jobName: string);
+}
+/** Raised when a fixed interval is not a usable delay (non-finite or non-positive). */
+export declare class InvalidJobIntervalError extends JobScheduleError {
+    constructor(jobName: string, intervalMs: number);
+}
+/** Raised when two jobs declare the same stable identifier. */
+export declare class DuplicateJobNameError extends JobScheduleError {
+    constructor(jobName: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/scheduler/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/scheduler/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wFAAwF;AACxF,8BAAsB,gBAAiB,SAAQ,KAAK;CAAG;AAEvD,8EAA8E;AAC9E,qBAAa,yBAA0B,SAAQ,gBAAgB;gBAClD,OAAO,EAAE,MAAM;CAI3B;AAED,iFAAiF;AACjF,qBAAa,uBAAwB,SAAQ,gBAAgB;gBAChD,OAAO,EAAE,MAAM;CAI3B;AAED,uFAAuF;AACvF,qBAAa,uBAAwB,SAAQ,gBAAgB;gBAChD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAI/C;AAED,+DAA+D;AAC/D,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC9C,OAAO,EAAE,MAAM;CAI3B"}

package/dist/scheduler/errors.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Failures raised while a job's schedule is resolved. They live apart from the
+ * scheduler so a composition root can catch or re-map them without importing the
+ * scheduling logic, and so the scheduler file stays focused on behaviour.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DuplicateJobNameError = exports.InvalidJobIntervalError = exports.MissingJobScheduleError = exports.AmbiguousJobScheduleError = exports.JobScheduleError = void 0;
+/** Base class for every malformed-schedule failure, so callers can catch the family. */
+class JobScheduleError extends Error {
+}
+exports.JobScheduleError = JobScheduleError;
+/** Raised when a job declares both a cron expression and a fixed interval. */
+class AmbiguousJobScheduleError extends JobScheduleError {
+    constructor(jobName) {
+        super(`Job ${jobName} declares both "cron" and "intervalMs": pick exactly one`);
+        this.name = "AmbiguousJobScheduleError";
+    }
+}
+exports.AmbiguousJobScheduleError = AmbiguousJobScheduleError;
+/** Raised when a job declares neither a cron expression nor a fixed interval. */
+class MissingJobScheduleError extends JobScheduleError {
+    constructor(jobName) {
+        super(`Job ${jobName} declares no schedule: it needs either "cron" or "intervalMs"`);
+        this.name = "MissingJobScheduleError";
+    }
+}
+exports.MissingJobScheduleError = MissingJobScheduleError;
+/** Raised when a fixed interval is not a usable delay (non-finite or non-positive). */
+class InvalidJobIntervalError extends JobScheduleError {
+    constructor(jobName, intervalMs) {
+        super(`Job ${jobName} declares an invalid "intervalMs" (${intervalMs}): expected > 0`);
+        this.name = "InvalidJobIntervalError";
+    }
+}
+exports.InvalidJobIntervalError = InvalidJobIntervalError;
+/** Raised when two jobs declare the same stable identifier. */
+class DuplicateJobNameError extends JobScheduleError {
+    constructor(jobName) {
+        super(`Job ${jobName} is declared more than once: scheduled job names must be unique`);
+        this.name = "DuplicateJobNameError";
+    }
+}
+exports.DuplicateJobNameError = DuplicateJobNameError;
+//# sourceMappingURL=errors.js.map

package/dist/scheduler/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/scheduler/errors.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,wFAAwF;AACxF,MAAsB,gBAAiB,SAAQ,KAAK;CAAG;AAAvD,4CAAuD;AAEvD,8EAA8E;AAC9E,MAAa,yBAA0B,SAAQ,gBAAgB;IAC9D,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,OAAO,0DAA0D,CAAC,CAAC;QAChF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IACzC,CAAC;CACD;AALD,8DAKC;AAED,iFAAiF;AACjF,MAAa,uBAAwB,SAAQ,gBAAgB;IAC5D,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,OAAO,+DAA+D,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACvC,CAAC;CACD;AALD,0DAKC;AAED,uFAAuF;AACvF,MAAa,uBAAwB,SAAQ,gBAAgB;IAC5D,YAAY,OAAe,EAAE,UAAkB;QAC9C,KAAK,CAAC,OAAO,OAAO,sCAAsC,UAAU,iBAAiB,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACvC,CAAC;CACD;AALD,0DAKC;AAED,+DAA+D;AAC/D,MAAa,qBAAsB,SAAQ,gBAAgB;IAC1D,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,OAAO,iEAAiE,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACrC,CAAC;CACD;AALD,sDAKC"}

package/dist/scheduler/scheduler.d.ts

@@ -0,0 +1,68 @@
+import type { Logger } from "../logger";
+/** What every job carries, whatever schedule drives it. */
+interface BaseScheduledJob {
+    /** Stable identifier, used in logs. */
+    readonly name: string;
+    /**
+     * Also run once when the scheduler starts, on top of the recurring schedule —
+     * the usual need for state reconciliation after a restart.
+     */
+    readonly runOnStart?: boolean;
+    run(): Promise<void> | void;
+}
+/** A job driven by a cron expression. */
+export interface CronScheduledJob extends BaseScheduledJob {
+    /** Standard cron expression (5 or 6 fields). */
+    readonly cron: string;
+    readonly intervalMs?: never;
+}
+/** A job driven by a plain fixed delay between two runs. */
+export interface IntervalScheduledJob extends BaseScheduledJob {
+    /** Delay between two runs, in milliseconds. */
+    readonly intervalMs: number;
+    readonly cron?: never;
+}
+/**
+ * A recurring job declared by a module. Kept free of any scheduling-library
+ * type so modules depend only on this contract, not on node-cron. The union
+ * makes `cron` and `intervalMs` mutually exclusive at compile time; the
+ * scheduler re-checks at runtime because a job may be built from untyped config.
+ */
+export type ScheduledJob = CronScheduledJob | IntervalScheduledJob;
+export interface SchedulerOptions {
+    /** IANA timezone the cron expressions are evaluated against. */
+    timezone?: string;
+}
+/** Scheduler control exposed to modules through dependency injection. */
+export interface Scheduler {
+    readonly started: boolean;
+    start(jobs: Iterable<ScheduledJob>): void;
+    isValidCron(expression: string): boolean;
+    rescheduleCron(jobName: string, expression: string): boolean;
+    stop(): void;
+}
+/**
+ * Schedules {@link ScheduledJob}s via node-cron, wrapping each run so a thrown
+ * error is logged rather than crashing the process. The concrete library is an
+ * implementation detail confined to this file.
+ */
+export declare class CronScheduler implements Scheduler {
+    private readonly logger;
+    private readonly options;
+    private readonly tasks;
+    private running;
+    constructor(logger: Logger, options?: SchedulerOptions);
+    get started(): boolean;
+    start(jobs: Iterable<ScheduledJob>): void;
+    isValidCron(expression: string): boolean;
+    /** Replace one running cron task without restarting the scheduler or the bot. */
+    rescheduleCron(jobName: string, expression: string): boolean;
+    private scheduleCron;
+    private scheduleInterval;
+    /** Run a job so a thrown error is logged instead of reaching the process. */
+    private runIsolated;
+    /** Stop every scheduled task (used on graceful shutdown). */
+    stop(): void;
+}
+export {};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/scheduler/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AASvC,2DAA2D;AAC3D,UAAU,gBAAgB;IACzB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5B;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACzD,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC;CAC5B;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC7D,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAChC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD,yEAAyE;AACzE,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC1C,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,IAAI,IAAI,IAAI,CAAC;CACb;AAwCD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,SAAS;IAK7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IALzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,OAAO,CAAS;gBAGN,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB;IAGhD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IA4BzC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC,iFAAiF;IACjF,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAyB5D,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,gBAAgB;IA+BxB,6EAA6E;YAC/D,WAAW;IAQzB,6DAA6D;IAC7D,IAAI,IAAI,IAAI;CAOZ"}

package/dist/scheduler/scheduler.js

@@ -0,0 +1,162 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CronScheduler = void 0;
+const node_cron_1 = __importDefault(require("node-cron"));
+const errors_1 = require("../scheduler/errors");
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * The schedule failure of a single job, or `null` when it is well-formed.
+ * Returned rather than thrown: `start()` runs inside the `ready` handler, on an
+ * already-online bot, so one malformed job must not cancel every other module's
+ * jobs. The caller logs it and skips that job alone.
+ */
+function scheduleFailure(job) {
+    const { name, cron: expression, intervalMs } = job;
+    const hasCron = expression !== undefined;
+    const hasInterval = intervalMs !== undefined;
+    if (hasCron && hasInterval) {
+        return new errors_1.AmbiguousJobScheduleError(name);
+    }
+    if (!hasCron && !hasInterval) {
+        return new errors_1.MissingJobScheduleError(name);
+    }
+    if (intervalMs !== undefined && (!Number.isFinite(intervalMs) || intervalMs <= 0)) {
+        return new errors_1.InvalidJobIntervalError(name, intervalMs);
+    }
+    return null;
+}
+/**
+ * Schedules {@link ScheduledJob}s via node-cron, wrapping each run so a thrown
+ * error is logged rather than crashing the process. The concrete library is an
+ * implementation detail confined to this file.
+ */
+class CronScheduler {
+    logger;
+    options;
+    tasks = new Map();
+    running = false;
+    constructor(logger, options = {}) {
+        this.logger = logger;
+        this.options = options;
+    }
+    get started() {
+        return this.running;
+    }
+    start(jobs) {
+        this.running = true;
+        const declared = [...jobs];
+        for (const job of declared) {
+            if (this.tasks.has(job.name)) {
+                const failure = new errors_1.DuplicateJobNameError(job.name);
+                this.logger.error({ job: job.name, err: failure.message }, "Job schedule invalid, skipped");
+                continue;
+            }
+            // A malformed schedule disables that job only. Skipping is logged at
+            // error level so it is not mistaken for a working job.
+            const failure = scheduleFailure(job);
+            if (failure !== null) {
+                this.logger.error({ job: job.name, err: failure.message }, "Job schedule invalid, skipped");
+                continue;
+            }
+            const stopTask = job.cron !== undefined ? this.scheduleCron(job) : this.scheduleInterval(job);
+            // An unusable schedule already disabled the job, so a boot run would
+            // fire something the caller has been told is not running.
+            if (stopTask !== null) {
+                this.tasks.set(job.name, { job, stop: stopTask });
+            }
+            if (stopTask !== null && job.runOnStart === true) {
+                void this.runIsolated(job);
+            }
+        }
+    }
+    isValidCron(expression) {
+        return node_cron_1.default.validate(expression);
+    }
+    /** Replace one running cron task without restarting the scheduler or the bot. */
+    rescheduleCron(jobName, expression) {
+        const current = this.tasks.get(jobName);
+        if (current === undefined || current.job.cron === undefined) {
+            this.logger.error({ job: jobName }, "Cron job not found, reschedule skipped");
+            return false;
+        }
+        if (!this.isValidCron(expression)) {
+            this.logger.error({ job: jobName, cron: expression }, "Invalid cron expression, reschedule skipped");
+            return false;
+        }
+        const replacement = { ...current.job, cron: expression };
+        const replacementStop = this.scheduleCron(replacement, false);
+        if (replacementStop === null) {
+            return false;
+        }
+        current.stop();
+        this.tasks.set(jobName, { job: replacement, stop: replacementStop });
+        this.logger.info({ job: jobName, cron: expression }, "Scheduled cron job updated");
+        return true;
+    }
+    scheduleCron(job, logRegistration = true) {
+        if (!this.isValidCron(job.cron)) {
+            this.logger.error({ job: job.name, cron: job.cron }, "Invalid cron expression, job skipped");
+            return null;
+        }
+        const task = node_cron_1.default.schedule(job.cron, () => this.runIsolated(job), this.options.timezone ? { timezone: this.options.timezone } : undefined);
+        const stop = () => {
+            task.stop();
+        };
+        if (logRegistration) {
+            this.logger.info({ job: job.name, cron: job.cron }, "Scheduled job registered");
+        }
+        return stop;
+    }
+    scheduleInterval(job) {
+        // Rescheduled after each run rather than `setInterval`: a run slower than
+        // its own interval would otherwise overlap itself, and a reconciliation job
+        // racing a previous pass is exactly the interleaving the KeyedQueue exists
+        // to prevent. The contract is "at most one run at a time".
+        let timer = null;
+        let stopped = false;
+        const scheduleNext = () => {
+            if (stopped) {
+                return;
+            }
+            timer = setTimeout(() => {
+                void this.runIsolated(job).finally(scheduleNext);
+            }, job.intervalMs);
+            // Nothing here should hold the event loop open by itself; `stop()` clears
+            // the timer on shutdown, and unref keeps a forgotten job from doing so.
+            timer.unref?.();
+        };
+        scheduleNext();
+        const stop = () => {
+            stopped = true;
+            if (timer !== null) {
+                clearTimeout(timer);
+            }
+        };
+        this.logger.info({ job: job.name, intervalMs: job.intervalMs }, "Scheduled job registered");
+        return stop;
+    }
+    /** Run a job so a thrown error is logged instead of reaching the process. */
+    async runIsolated(job) {
+        try {
+            await job.run();
+        }
+        catch (error) {
+            this.logger.error({ job: job.name, err: describeError(error) }, "Scheduled job failed");
+        }
+    }
+    /** Stop every scheduled task (used on graceful shutdown). */
+    stop() {
+        for (const task of this.tasks.values()) {
+            task.stop();
+        }
+        this.tasks.clear();
+        this.running = false;
+    }
+}
+exports.CronScheduler = CronScheduler;
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/scheduler/scheduler.ts"],"names":[],"mappings":"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"}