@pristine-ts/local-scheduling 4.0.2

package/dist/lib/esm/builders/cron-expression.builder.js

@@ -0,0 +1,155 @@
+import { CronExpression } from "../models/cron-expression.model";
+import { CronSchedule } from "../schedules/cron.schedule";
+/**
+ * A fluent builder for cron expressions, so a caller can compose a schedule from typed,
+ * self-describing method calls instead of hand-writing (and mis-remembering) the five-field
+ * syntax.
+ *
+ * Every method returns `this` for chaining, and each field defaults to `*` ("every"), so you
+ * only set the fields you care about — a fresh builder is already "every minute". Each method
+ * sets exactly the field it names (last write wins per field); nothing is validated until
+ * {@link build} (or {@link toSchedule}) constructs a {@link CronExpression}, which throws an
+ * `InvalidCronExpressionError` on an out-of-range value.
+ *
+ * ```ts
+ * new CronExpressionBuilder().dailyAt(3).build();                 // 0 3 * * *
+ * new CronExpressionBuilder().everyMinutes(15).hoursBetween(9, 17)
+ *   .onDayOfWeek(DayOfWeekEnum.Monday, DayOfWeekEnum.Friday).build();
+ * new CronExpressionBuilder().weeklyOn(DayOfWeekEnum.Sunday, 2, 30).toSchedule();
+ * ```
+ *
+ * Month and day-of-week take plain numbers; {@link MonthEnum} and {@link DayOfWeekEnum} are
+ * exported so call sites can read `inMonth(MonthEnum.January)` instead of `inMonth(1)`.
+ */
+export class CronExpressionBuilder {
+    constructor() {
+        this.minuteField = "*";
+        this.hourField = "*";
+        this.dayOfMonthField = "*";
+        this.monthField = "*";
+        this.dayOfWeekField = "*";
+    }
+    // ── seconds (optional sixth field; setting any of these switches to 6-field form) ──────────
+    atSecond(second, ...more) {
+        this.secondField = [second, ...more].join(",");
+        return this;
+    }
+    everySeconds(step) {
+        this.secondField = CronExpressionBuilder.step(step);
+        return this;
+    }
+    secondsBetween(start, end, step) {
+        this.secondField = CronExpressionBuilder.range(start, end, step);
+        return this;
+    }
+    // ── minutes ────────────────────────────────────────────────────────────────────────────────
+    atMinute(minute, ...more) {
+        this.minuteField = [minute, ...more].join(",");
+        return this;
+    }
+    everyMinutes(step) {
+        this.minuteField = CronExpressionBuilder.step(step);
+        return this;
+    }
+    minutesBetween(start, end, step) {
+        this.minuteField = CronExpressionBuilder.range(start, end, step);
+        return this;
+    }
+    // ── hours ────────────────────────────────────────────────────────────────────────────────
+    atHour(hour, ...more) {
+        this.hourField = [hour, ...more].join(",");
+        return this;
+    }
+    everyHours(step) {
+        this.hourField = CronExpressionBuilder.step(step);
+        return this;
+    }
+    hoursBetween(start, end, step) {
+        this.hourField = CronExpressionBuilder.range(start, end, step);
+        return this;
+    }
+    // ── day of month ─────────────────────────────────────────────────────────────────────────
+    onDayOfMonth(day, ...more) {
+        this.dayOfMonthField = [day, ...more].join(",");
+        return this;
+    }
+    everyDaysOfMonth(step) {
+        this.dayOfMonthField = CronExpressionBuilder.step(step);
+        return this;
+    }
+    daysOfMonthBetween(start, end, step) {
+        this.dayOfMonthField = CronExpressionBuilder.range(start, end, step);
+        return this;
+    }
+    // ── month (1-12; pass MonthEnum values for readability) ──────────────────────────────────
+    inMonth(month, ...more) {
+        this.monthField = [month, ...more].join(",");
+        return this;
+    }
+    monthsBetween(start, end, step) {
+        this.monthField = CronExpressionBuilder.range(start, end, step);
+        return this;
+    }
+    // ── day of week (0-7, 0 and 7 = Sunday; pass DayOfWeekEnum values) ───────────────────────
+    onDayOfWeek(day, ...more) {
+        this.dayOfWeekField = [day, ...more].join(",");
+        return this;
+    }
+    daysOfWeekBetween(start, end, step) {
+        this.dayOfWeekField = CronExpressionBuilder.range(start, end, step);
+        return this;
+    }
+    // ── high-level helpers (each sets only the fields it names) ──────────────────────────────
+    /** Every hour, at the given minute — e.g. `hourlyAtMinute(30)` is "30 * * * *". */
+    hourlyAtMinute(minute) {
+        this.minuteField = String(minute);
+        this.hourField = "*";
+        return this;
+    }
+    /** Every day at the given hour and minute — e.g. `dailyAt(3, 30)` is "30 3 * * *". */
+    dailyAt(hour, minute = 0) {
+        this.minuteField = String(minute);
+        this.hourField = String(hour);
+        return this;
+    }
+    /** The given day-of-week each week, at the given hour and minute. */
+    weeklyOn(dayOfWeek, hour, minute = 0) {
+        this.minuteField = String(minute);
+        this.hourField = String(hour);
+        this.dayOfWeekField = String(dayOfWeek);
+        return this;
+    }
+    /** The given day-of-month each month, at the given hour and minute. */
+    monthlyOn(dayOfMonth, hour, minute = 0) {
+        this.minuteField = String(minute);
+        this.hourField = String(hour);
+        this.dayOfMonthField = String(dayOfMonth);
+        return this;
+    }
+    // ── terminals ────────────────────────────────────────────────────────────────────────────
+    /** The assembled cron string (5 fields, or 6 when a seconds field has been set). */
+    toString() {
+        const fields = [this.minuteField, this.hourField, this.dayOfMonthField, this.monthField, this.dayOfWeekField];
+        return (this.secondField !== undefined ? [this.secondField, ...fields] : fields).join(" ");
+    }
+    /**
+     * Parses and validates the assembled expression into a {@link CronExpression}.
+     * @throws {InvalidCronExpressionError} if any set value is out of range.
+     */
+    build() {
+        return new CronExpression(this.toString());
+    }
+    /** Convenience for the scheduler: the assembled expression as a {@link CronSchedule}. */
+    toSchedule() {
+        return new CronSchedule(this.build());
+    }
+    /** Assembles a step field (`*` every `step`). */
+    static step(step) {
+        return `*/${step}`;
+    }
+    /** Assembles a range field (`start-end`, optionally stepped `start-end/step`). */
+    static range(start, end, step) {
+        return step === undefined ? `${start}-${end}` : `${start}-${end}/${step}`;
+    }
+}
+//# sourceMappingURL=cron-expression.builder.js.map

package/dist/lib/esm/builders/cron-expression.builder.js.map

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

package/dist/lib/esm/enums/day-of-week.enum.js

@@ -0,0 +1,16 @@
+/**
+ * Days of the week, numbered as cron's day-of-week field expects (0 = Sunday … 6 = Saturday;
+ * cron also accepts 7 for Sunday). Use with {@link CronExpressionBuilder.onDayOfWeek} for
+ * readable call sites instead of raw numbers.
+ */
+export var DayOfWeekEnum;
+(function (DayOfWeekEnum) {
+    DayOfWeekEnum[DayOfWeekEnum["Sunday"] = 0] = "Sunday";
+    DayOfWeekEnum[DayOfWeekEnum["Monday"] = 1] = "Monday";
+    DayOfWeekEnum[DayOfWeekEnum["Tuesday"] = 2] = "Tuesday";
+    DayOfWeekEnum[DayOfWeekEnum["Wednesday"] = 3] = "Wednesday";
+    DayOfWeekEnum[DayOfWeekEnum["Thursday"] = 4] = "Thursday";
+    DayOfWeekEnum[DayOfWeekEnum["Friday"] = 5] = "Friday";
+    DayOfWeekEnum[DayOfWeekEnum["Saturday"] = 6] = "Saturday";
+})(DayOfWeekEnum || (DayOfWeekEnum = {}));
+//# sourceMappingURL=day-of-week.enum.js.map

package/dist/lib/esm/enums/day-of-week.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"day-of-week.enum.js","sourceRoot":"","sources":["../../../../src/enums/day-of-week.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,qDAAU,CAAA;IACV,qDAAU,CAAA;IACV,uDAAW,CAAA;IACX,2DAAa,CAAA;IACb,yDAAY,CAAA;IACZ,qDAAU,CAAA;IACV,yDAAY,CAAA;AACd,CAAC,EARW,aAAa,KAAb,aAAa,QAQxB"}

package/dist/lib/esm/enums/enums.js

@@ -0,0 +1,3 @@
+export * from "./day-of-week.enum";
+export * from "./month.enum";
+//# sourceMappingURL=enums.js.map

package/dist/lib/esm/enums/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../../src/enums/enums.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/lib/esm/enums/month.enum.js

@@ -0,0 +1,20 @@
+/**
+ * Calendar months, numbered as cron's month field expects (1 = January … 12 = December). Use
+ * with {@link CronExpressionBuilder.inMonth} for readable call sites instead of raw numbers.
+ */
+export var MonthEnum;
+(function (MonthEnum) {
+    MonthEnum[MonthEnum["January"] = 1] = "January";
+    MonthEnum[MonthEnum["February"] = 2] = "February";
+    MonthEnum[MonthEnum["March"] = 3] = "March";
+    MonthEnum[MonthEnum["April"] = 4] = "April";
+    MonthEnum[MonthEnum["May"] = 5] = "May";
+    MonthEnum[MonthEnum["June"] = 6] = "June";
+    MonthEnum[MonthEnum["July"] = 7] = "July";
+    MonthEnum[MonthEnum["August"] = 8] = "August";
+    MonthEnum[MonthEnum["September"] = 9] = "September";
+    MonthEnum[MonthEnum["October"] = 10] = "October";
+    MonthEnum[MonthEnum["November"] = 11] = "November";
+    MonthEnum[MonthEnum["December"] = 12] = "December";
+})(MonthEnum || (MonthEnum = {}));
+//# sourceMappingURL=month.enum.js.map

package/dist/lib/esm/enums/month.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"month.enum.js","sourceRoot":"","sources":["../../../../src/enums/month.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB,+CAAW,CAAA;IACX,iDAAY,CAAA;IACZ,2CAAS,CAAA;IACT,2CAAS,CAAA;IACT,uCAAO,CAAA;IACP,yCAAQ,CAAA;IACR,yCAAQ,CAAA;IACR,6CAAU,CAAA;IACV,mDAAa,CAAA;IACb,gDAAY,CAAA;IACZ,kDAAa,CAAA;IACb,kDAAa,CAAA;AACf,CAAC,EAbW,SAAS,KAAT,SAAS,QAapB"}

package/dist/lib/esm/errors/errors.js

@@ -0,0 +1,4 @@
+export * from "./invalid-cron-expression.error";
+export * from "./schedule-already-exists.error";
+export * from "./schedule-not-found.error";
+//# sourceMappingURL=errors.js.map

package/dist/lib/esm/errors/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC"}

package/dist/lib/esm/errors/invalid-cron-expression.error.js

@@ -0,0 +1,26 @@
+import { BadRequestError } from "@pristine-ts/common";
+/**
+ * Thrown when a cron expression cannot be parsed or is semantically invalid.
+ *
+ * It extends {@link BadRequestError} so that, if it propagates to an HTTP boundary (for
+ * example a controller that validates a user-submitted schedule), the framework's HTTP
+ * responder surfaces it as a **400 Bad Request** automatically. The `message` is written
+ * to be safe and precise enough to return verbatim to the caller, and the offending
+ * `expression` (plus optional field context) is carried in the error `details` bag.
+ */
+export class InvalidCronExpressionError extends BadRequestError {
+    /**
+     * @param message A precise, caller-safe description of what is wrong with the expression.
+     * @param expression The raw cron expression that failed to parse.
+     * @param field The name of the offending field (e.g. `"minute"`), when known.
+     */
+    constructor(message, expression, field) {
+        super(message, {
+            code: "INVALID_CRON_EXPRESSION",
+            details: Object.assign({ expression }, (field !== undefined ? { field } : {})),
+        });
+        this.expression = expression;
+        this.field = field;
+    }
+}
+//# sourceMappingURL=invalid-cron-expression.error.js.map

package/dist/lib/esm/errors/invalid-cron-expression.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-cron-expression.error.js","sourceRoot":"","sources":["../../../../src/errors/invalid-cron-expression.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,OAAO,0BAA2B,SAAQ,eAAe;IAC7D;;;;OAIG;IACH,YACE,OAAe,EACC,UAAkB,EAClB,KAAc;QAE9B,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,yBAAyB;YAC/B,OAAO,kBAAG,UAAU,IAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,KAAK,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC/D,CAAC,CAAC;QANa,eAAU,GAAV,UAAU,CAAQ;QAClB,UAAK,GAAL,KAAK,CAAS;IAMhC,CAAC;CACF"}

package/dist/lib/esm/errors/schedule-already-exists.error.js

@@ -0,0 +1,21 @@
+import { ConflictError } from "@pristine-ts/common";
+/**
+ * Thrown by `schedule(id, ...)` when the id is already registered. Registration is
+ * intentionally not idempotent so that a duplicate id — almost always a bug in the
+ * consumer's bootstrap — surfaces loudly instead of silently double-arming a timer. To
+ * replace an existing schedule, call `unschedule(id)` first, or `reschedule(id, ...)` to
+ * only change its expression.
+ *
+ * It extends {@link ConflictError} so it surfaces as a **409 Conflict** if it reaches an
+ * HTTP boundary.
+ */
+export class ScheduleAlreadyExistsError extends ConflictError {
+    constructor(id) {
+        super(`A schedule is already registered with the id '${id}'.`, {
+            code: "SCHEDULE_ALREADY_EXISTS",
+            details: { id },
+        });
+        this.id = id;
+    }
+}
+//# sourceMappingURL=schedule-already-exists.error.js.map

package/dist/lib/esm/errors/schedule-already-exists.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-already-exists.error.js","sourceRoot":"","sources":["../../../../src/errors/schedule-already-exists.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,OAAO,0BAA2B,SAAQ,aAAa;IAC3D,YAAmC,EAAU;QAC3C,KAAK,CAAC,iDAAiD,EAAE,IAAI,EAAE;YAC7D,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,EAAC,EAAE,EAAC;SACd,CAAC,CAAC;QAJ8B,OAAE,GAAF,EAAE,CAAQ;IAK7C,CAAC;CACF"}

package/dist/lib/esm/errors/schedule-not-found.error.js

@@ -0,0 +1,18 @@
+import { NotFoundError } from "@pristine-ts/common";
+/**
+ * Thrown when an operation references a schedule id that is not registered (for example
+ * `reschedule(id, ...)` or `getNextExecutionDate(id)` on an unknown id).
+ *
+ * It extends {@link NotFoundError} so it surfaces as a **404 Not Found** if it reaches an
+ * HTTP boundary — convenient when a controller mutates schedules by id.
+ */
+export class ScheduleNotFoundError extends NotFoundError {
+    constructor(id) {
+        super(`No schedule is registered with the id '${id}'.`, {
+            code: "SCHEDULE_NOT_FOUND",
+            details: { id },
+        });
+        this.id = id;
+    }
+}
+//# sourceMappingURL=schedule-not-found.error.js.map

package/dist/lib/esm/errors/schedule-not-found.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-not-found.error.js","sourceRoot":"","sources":["../../../../src/errors/schedule-not-found.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAmC,EAAU;QAC3C,KAAK,CAAC,0CAA0C,EAAE,IAAI,EAAE;YACtD,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,EAAC,EAAE,EAAC;SACd,CAAC,CAAC;QAJ8B,OAAE,GAAF,EAAE,CAAQ;IAK7C,CAAC;CACF"}

package/dist/lib/esm/interfaces/interfaces.js

@@ -0,0 +1,6 @@
+export * from "./local-scheduler.interface";
+export * from "./schedulable.interface";
+export * from "./schedule.interface";
+export * from "./schedule-descriptor.interface";
+export * from "./schedule-options.interface";
+//# sourceMappingURL=interfaces.js.map

package/dist/lib/esm/interfaces/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC"}

package/dist/lib/esm/interfaces/local-scheduler.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=local-scheduler.interface.js.map

package/dist/lib/esm/interfaces/local-scheduler.interface.js.map

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

package/dist/lib/esm/interfaces/schedulable.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedulable.interface.js.map

package/dist/lib/esm/interfaces/schedulable.interface.js.map

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

package/dist/lib/esm/interfaces/schedule-descriptor.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedule-descriptor.interface.js.map

package/dist/lib/esm/interfaces/schedule-descriptor.interface.js.map

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

package/dist/lib/esm/interfaces/schedule-options.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedule-options.interface.js.map

package/dist/lib/esm/interfaces/schedule-options.interface.js.map

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

package/dist/lib/esm/interfaces/schedule-state.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedule-state.interface.js.map

package/dist/lib/esm/interfaces/schedule-state.interface.js.map

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

package/dist/lib/esm/interfaces/schedule.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schedule.interface.js.map

package/dist/lib/esm/interfaces/schedule.interface.js.map

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

package/dist/lib/esm/local-scheduling.module.js

@@ -0,0 +1,68 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { LoggingModule } from "@pristine-ts/logging";
+import { CoreModule } from "@pristine-ts/core";
+import { SchedulingModule } from "@pristine-ts/scheduling";
+import { LocalSchedulingModuleKeyname } from "./local-scheduling.module.keyname";
+import { LocalSchedulerRuntimeServer } from "./servers/local-scheduler.runtime-server";
+export * from "./builders/builders";
+export * from "./enums/enums";
+export * from "./errors/errors";
+export * from "./interfaces/interfaces";
+export * from "./managers/managers";
+export * from "./models/models";
+export * from "./schedules/schedules";
+export * from "./servers/servers";
+export * from "./types/types";
+export * from "./local-scheduling.module.keyname";
+/**
+ * The local-scheduling module. Import it into your application module to make
+ * {@link LocalSchedulerManager} injectable and to have every {@link SchedulableInterface} you
+ * tag with `@tag(ServiceDefinitionTagEnum.Schedulable)` auto-registered when the scheduler
+ * starts.
+ *
+ * You do not have to start the scheduler yourself: {@link LocalSchedulerRuntimeServer} is
+ * tagged as a {@link RuntimeServerInterface}, so `pristine start` starts it (and stops it on
+ * shutdown, via `onShutdown` below) alongside the HTTP/gRPC servers. Resolve
+ * {@link LocalSchedulerManager} directly only when you need the dynamic API (adding schedules
+ * from a database, mutating them from controllers).
+ *
+ * It builds on `@pristine-ts/scheduling` — a {@link SchedulableInterface} is a
+ * {@link ScheduledTaskInterface} that also declares its schedule — and is otherwise
+ * platform-neutral: it depends only on core, logging, and scheduling, and registers no event
+ * mappers or handlers. It coexists with `@pristine-ts/aws-scheduling` and the other scheduling
+ * drivers — none of them interfere with the others.
+ */
+export const LocalSchedulingModule = {
+    keyname: LocalSchedulingModuleKeyname,
+    importModules: [
+        CoreModule,
+        LoggingModule,
+        SchedulingModule,
+    ],
+    providerRegistrations: [],
+    configurationDefinitions: [],
+    onShutdown: (container) => __awaiter(void 0, void 0, void 0, function* () {
+        try {
+            // ── container.resolve, justified ────────────────────────────────────────
+            // Per CLAUDE.md: module lifecycle hook. `onShutdown` is a callback fired by the
+            // kernel with the container as its argument — there is no class to constructor-inject
+            // into. Resolving from the provided container is the framework's intended path (the
+            // same shape as HttpModule's onShutdown for KernelHttpServer).
+            const runtimeServer = container.resolve(LocalSchedulerRuntimeServer);
+            yield runtimeServer.stop();
+        }
+        catch (_a) {
+            // The scheduler may not be resolvable if the container is degraded during shutdown.
+            // Swallow so other modules' onShutdown still run; stop() is idempotent anyway.
+        }
+    }),
+};
+//# sourceMappingURL=local-scheduling.module.js.map

package/dist/lib/esm/local-scheduling.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-scheduling.module.js","sourceRoot":"","sources":["../../../src/local-scheduling.module.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAC,4BAA4B,EAAC,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAC,2BAA2B,EAAC,MAAM,0CAA0C,CAAC;AAErF,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAE9B,cAAc,mCAAmC,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoB;IACpD,OAAO,EAAE,4BAA4B;IACrC,aAAa,EAAE;QACb,UAAU;QACV,aAAa;QACb,gBAAgB;KACjB;IACD,qBAAqB,EAAE,EAAE;IACzB,wBAAwB,EAAE,EAAE;IAC5B,UAAU,EAAE,CAAO,SAAS,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,2EAA2E;YAC3E,gFAAgF;YAChF,sFAAsF;YACtF,oFAAoF;YACpF,+DAA+D;YAC/D,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;YACrE,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;QAAC,WAAM,CAAC;YACP,oFAAoF;YACpF,+EAA+E;QACjF,CAAC;IACH,CAAC,CAAA;CACF,CAAC"}

package/dist/lib/esm/local-scheduling.module.keyname.js

@@ -0,0 +1,2 @@
+export const LocalSchedulingModuleKeyname = "pristine.local-scheduling";
+//# sourceMappingURL=local-scheduling.module.keyname.js.map

package/dist/lib/esm/local-scheduling.module.keyname.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-scheduling.module.keyname.js","sourceRoot":"","sources":["../../../src/local-scheduling.module.keyname.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAW,2BAA2B,CAAC"}