jcc-express-mvc 1.8.27 → 1.8.28

package/__tests__/ApplicationBuilder.test.js

@@ -15,7 +15,7 @@ const ApplicationBuilder_1 = require("../lib/Application/ApplicationBuilder");
         (0, vitest_1.expect)(app.config).toMatchObject({ custom: "value" });
         (0, vitest_1.expect)(app.has("Queue")).toBe(false);
     });
-    (0, vitest_1.it)("withConfig registers Queue when queue config is present", () => {
+    (0, vitest_1.it)("withConfig stores queue config without registering Queue (QueueServiceProvider handles that)", () => {
         const config = {
             queue: {
                 default: "memory",
@@ -26,9 +26,8 @@ const ApplicationBuilder_1 = require("../lib/Application/ApplicationBuilder");
         };
         const builder = new ApplicationBuilder_1.ApplicationBuilder(app);
         builder.withConfig(config);
-        (0, vitest_1.expect)(app.has("Queue")).toBe(true);
-        const queue = app.resolve("Queue");
-        (0, vitest_1.expect)(queue).toBeDefined();
+        (0, vitest_1.expect)(app.config.queue).toMatchObject(config.queue);
+        (0, vitest_1.expect)(app.has("Queue")).toBe(false);
     });
     (0, vitest_1.it)("withRouting maps route config with rootPath", () => {
         const builder = new ApplicationBuilder_1.ApplicationBuilder(app);

package/__tests__/Job.test.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const vitest_1 = require("vitest");
 const Job_1 = require("../lib/Queue/Job");
+const Queue_1 = require("../lib/Queue/Queue");
 const Application_1 = require("../lib/Application/Application");
-const ApplicationBuilder_1 = require("../lib/Application/ApplicationBuilder");
 const util_1 = require("../lib/util");
 class TestJob extends Job_1.Job {
     async handle() {
@@ -112,15 +112,8 @@ class NestedFolderJob extends Job_1.Job {
             app = Application_1.Application.getInstance();
             originalApp = globalThis.app;
             globalThis.app = app;
-            const config = {
-                queue: {
-                    default: "memory",
-                    connections: {
-                        memory: { driver: "memory", queue: "default" },
-                    },
-                },
-            };
-            new ApplicationBuilder_1.ApplicationBuilder(app).withConfig(config);
+            const q = new Queue_1.Queue({ driver: "memory", queue: "default" });
+            app.instance("Queue", q);
         });
         (0, vitest_1.afterEach)(() => {
             globalThis.app = originalApp;
@@ -145,16 +138,8 @@ class NestedFolderJob extends Job_1.Job {
         app = Application_1.Application.getInstance();
         originalApp = globalThis.app;
         globalThis.app = app;
-        const config = {
-            queue: {
-                default: "memory",
-                connections: {
-                    memory: { driver: "memory", queue: "default" },
-                },
-            },
-        };
-        new ApplicationBuilder_1.ApplicationBuilder(app).withConfig(config);
-        queue = app.resolve("Queue");
+        queue = new Queue_1.Queue({ driver: "memory", queue: "default" });
+        app.instance("Queue", queue);
     });
     (0, vitest_1.afterEach)(() => {
         globalThis.app = originalApp;

package/__tests__/Schedule.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Schedule.test.d.ts.map

package/__tests__/Schedule.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schedule.test.d.ts","sourceRoot":"","sources":["../../jcc-express-mvc/__tests__/Schedule.test.ts"],"names":[],"mappings":""}

package/__tests__/Schedule.test.js

@@ -0,0 +1,580 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const Schedule_1 = require("../lib/Schedule/Schedule");
+const Scheduler_1 = require("../lib/Schedule/Scheduler");
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function task(schedule) {
+    return schedule.getTasks()[0];
+}
+function makeScheduler(schedule) {
+    return new Scheduler_1.Scheduler(schedule);
+}
+// ─── Schedule.call / .command / .artisan / .exec ────────────────────────────
+(0, vitest_1.describe)("Schedule task registration", () => {
+    (0, vitest_1.it)("call() registers a callback task", () => {
+        const s = new Schedule_1.Schedule();
+        const cb = async () => { };
+        s.call(cb, "my-callback");
+        (0, vitest_1.expect)(task(s).callback).toBe(cb);
+        (0, vitest_1.expect)(task(s).description).toBe("my-callback");
+    });
+    (0, vitest_1.it)("command() prepends 'bun artisanNode'", () => {
+        const s = new Schedule_1.Schedule();
+        s.command("migrate", ["--fresh"]);
+        const cmd = task(s).command;
+        (0, vitest_1.expect)(cmd[0]).toBe("bun artisanNode migrate");
+        (0, vitest_1.expect)(cmd[1]).toEqual(["--fresh"]);
+    });
+    (0, vitest_1.it)("artisan() does NOT double-prefix artisanNode", () => {
+        const s = new Schedule_1.Schedule();
+        s.artisan("queue:work");
+        const cmd = task(s).command;
+        // must be "bun artisanNode queue:work", not "bun artisanNode artisanNode queue:work"
+        (0, vitest_1.expect)(cmd[0]).toBe("bun artisanNode queue:work");
+        (0, vitest_1.expect)(cmd[0]).not.toContain("artisanNode artisanNode");
+    });
+    (0, vitest_1.it)("exec() stores raw command without artisanNode prefix", () => {
+        const s = new Schedule_1.Schedule();
+        s.exec("node scripts/backup.js");
+        (0, vitest_1.expect)(task(s).command).toBe("node scripts/backup.js");
+    });
+    (0, vitest_1.it)("exec() with args stores [cmd, args]", () => {
+        const s = new Schedule_1.Schedule();
+        s.exec("node", ["scripts/backup.js", "--force"]);
+        const cmd = task(s).command;
+        (0, vitest_1.expect)(cmd[0]).toBe("node");
+        (0, vitest_1.expect)(cmd[1]).toEqual(["scripts/backup.js", "--force"]);
+    });
+    (0, vitest_1.it)("hasSubMinuteTasks() returns false when no sub-minute tasks", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyMinute();
+        (0, vitest_1.expect)(s.hasSubMinuteTasks()).toBe(false);
+    });
+    (0, vitest_1.it)("hasSubMinuteTasks() returns true when a sub-minute task is registered", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everySecond();
+        (0, vitest_1.expect)(s.hasSubMinuteTasks()).toBe(true);
+    });
+});
+// ─── Sub-minute ──────────────────────────────────────────────────────────────
+(0, vitest_1.describe)("Sub-minute frequencies", () => {
+    const cases = [
+        ["everySecond", () => new Schedule_1.Schedule().call(async () => { }).everySecond(), 1],
+        ["everyTwoSeconds", () => new Schedule_1.Schedule().call(async () => { }).everyTwoSeconds(), 2],
+        ["everyFiveSeconds", () => new Schedule_1.Schedule().call(async () => { }).everyFiveSeconds(), 5],
+        ["everyTenSeconds", () => new Schedule_1.Schedule().call(async () => { }).everyTenSeconds(), 10],
+        ["everyFifteenSeconds", () => new Schedule_1.Schedule().call(async () => { }).everyFifteenSeconds(), 15],
+        ["everyTwentySeconds", () => new Schedule_1.Schedule().call(async () => { }).everyTwentySeconds(), 20],
+        ["everyThirtySeconds", () => new Schedule_1.Schedule().call(async () => { }).everyThirtySeconds(), 30],
+    ];
+    for (const [name, build, seconds] of cases) {
+        (0, vitest_1.it)(`${name}() sets secondInterval = ${seconds}`, () => {
+            const s = new Schedule_1.Schedule();
+            s.call(async () => { })[name]();
+            (0, vitest_1.expect)(task(s).secondInterval).toBe(seconds);
+        });
+    }
+    (0, vitest_1.it)("sub-minute task has no cron expression side-effects on secondInterval", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyFiveSeconds();
+        // expression still defaults to every-minute; secondInterval drives the check
+        (0, vitest_1.expect)(task(s).secondInterval).toBe(5);
+    });
+});
+// ─── Minute frequencies ──────────────────────────────────────────────────────
+(0, vitest_1.describe)("Minute frequencies", () => {
+    (0, vitest_1.it)("everyMinute() → '* * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyMinute();
+        (0, vitest_1.expect)(task(s).expression).toBe("* * * * *");
+    });
+    (0, vitest_1.it)("everyTwoMinutes() → '*/2 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyTwoMinutes();
+        (0, vitest_1.expect)(task(s).expression).toBe("*/2 * * * *");
+    });
+    (0, vitest_1.it)("everyThreeMinutes() → '*/3 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyThreeMinutes();
+        (0, vitest_1.expect)(task(s).expression).toBe("*/3 * * * *");
+    });
+    (0, vitest_1.it)("everyFourMinutes() → '*/4 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyFourMinutes();
+        (0, vitest_1.expect)(task(s).expression).toBe("*/4 * * * *");
+    });
+    (0, vitest_1.it)("everyFiveMinutes() → '*/5 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyFiveMinutes();
+        (0, vitest_1.expect)(task(s).expression).toBe("*/5 * * * *");
+    });
+    (0, vitest_1.it)("everyTenMinutes() → '*/10 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyTenMinutes();
+        (0, vitest_1.expect)(task(s).expression).toBe("*/10 * * * *");
+    });
+    (0, vitest_1.it)("everyFifteenMinutes() → '*/15 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyFifteenMinutes();
+        (0, vitest_1.expect)(task(s).expression).toBe("*/15 * * * *");
+    });
+    (0, vitest_1.it)("everyThirtyMinutes() → '*/30 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyThirtyMinutes();
+        (0, vitest_1.expect)(task(s).expression).toBe("*/30 * * * *");
+    });
+    (0, vitest_1.it)("everyMinutes(7) → '*/7 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyMinutes(7);
+        (0, vitest_1.expect)(task(s).expression).toBe("*/7 * * * *");
+    });
+});
+// ─── Hour frequencies ────────────────────────────────────────────────────────
+(0, vitest_1.describe)("Hour frequencies", () => {
+    (0, vitest_1.it)("hourly() → '0 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).hourly();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 * * * *");
+    });
+    (0, vitest_1.it)("hourlyAt(17) → '17 * * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).hourlyAt(17);
+        (0, vitest_1.expect)(task(s).expression).toBe("17 * * * *");
+    });
+    (0, vitest_1.it)("everyOddHour() → '0 1-23/2 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyOddHour();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 1-23/2 * * *");
+    });
+    (0, vitest_1.it)("everyOddHour(30) → '30 1-23/2 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyOddHour(30);
+        (0, vitest_1.expect)(task(s).expression).toBe("30 1-23/2 * * *");
+    });
+    (0, vitest_1.it)("everyTwoHours() → '0 */2 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyTwoHours();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 */2 * * *");
+    });
+    (0, vitest_1.it)("everyTwoHours(15) → '15 */2 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyTwoHours(15);
+        (0, vitest_1.expect)(task(s).expression).toBe("15 */2 * * *");
+    });
+    (0, vitest_1.it)("everyThreeHours() → '0 */3 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyThreeHours();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 */3 * * *");
+    });
+    (0, vitest_1.it)("everyFourHours() → '0 */4 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everyFourHours();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 */4 * * *");
+    });
+    (0, vitest_1.it)("everySixHours() → '0 */6 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).everySixHours();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 */6 * * *");
+    });
+});
+// ─── Day frequencies ─────────────────────────────────────────────────────────
+(0, vitest_1.describe)("Day frequencies", () => {
+    (0, vitest_1.it)("daily() → '0 0 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 0 * * *");
+    });
+    (0, vitest_1.it)("dailyAt('13:00') → '0 13 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).dailyAt("13:00");
+        (0, vitest_1.expect)(task(s).expression).toBe("0 13 * * *");
+    });
+    (0, vitest_1.it)("dailyAt('2:30') → '30 2 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).dailyAt("2:30");
+        (0, vitest_1.expect)(task(s).expression).toBe("30 2 * * *");
+    });
+    (0, vitest_1.it)("twiceDaily(1, 13) → '0 1,13 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).twiceDaily(1, 13);
+        (0, vitest_1.expect)(task(s).expression).toBe("0 1,13 * * *");
+    });
+    (0, vitest_1.it)("twiceDailyAt(1, 13, 15) → '15 1,13 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).twiceDailyAt(1, 13, 15);
+        (0, vitest_1.expect)(task(s).expression).toBe("15 1,13 * * *");
+    });
+    (0, vitest_1.it)("twiceDailyAt() with defaults → '0 1,13 * * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).twiceDailyAt();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 1,13 * * *");
+    });
+});
+// ─── Day-of-month ────────────────────────────────────────────────────────────
+(0, vitest_1.describe)("Day-of-month frequencies", () => {
+    (0, vitest_1.it)("daysOfMonth([1, 10, 20]) sets day-of-month field", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().daysOfMonth([1, 10, 20]);
+        const parts = task(s).expression.split(" ");
+        (0, vitest_1.expect)(parts[2]).toBe("1,10,20");
+    });
+    (0, vitest_1.it)("lastDayOfMonth() sets lastDayOfMonth flag", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).lastDayOfMonth();
+        (0, vitest_1.expect)(task(s).lastDayOfMonth).toBe(true);
+    });
+    (0, vitest_1.it)("lastDayOfMonth('15:00') sets the correct time in expression", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).lastDayOfMonth("15:00");
+        (0, vitest_1.expect)(task(s).expression).toBe("0 15 * * *");
+        (0, vitest_1.expect)(task(s).lastDayOfMonth).toBe(true);
+    });
+});
+// ─── Week frequencies ────────────────────────────────────────────────────────
+(0, vitest_1.describe)("Week frequencies", () => {
+    (0, vitest_1.it)("weekly() → '0 0 * * 0'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).weekly();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 0 * * 0");
+    });
+    (0, vitest_1.it)("weeklyOn(1, '8:00') → '0 8 * * 1'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).weeklyOn(1, "8:00");
+        (0, vitest_1.expect)(task(s).expression).toBe("0 8 * * 1");
+    });
+    (0, vitest_1.it)("weeklyOn(5) defaults to midnight → '0 0 * * 5'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).weeklyOn(5);
+        (0, vitest_1.expect)(task(s).expression).toBe("0 0 * * 5");
+    });
+});
+// ─── Month frequencies ───────────────────────────────────────────────────────
+(0, vitest_1.describe)("Month frequencies", () => {
+    (0, vitest_1.it)("monthly() → '0 0 1 * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).monthly();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 0 1 * *");
+    });
+    (0, vitest_1.it)("monthlyOn(4, '15:00') → '0 15 4 * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).monthlyOn(4, "15:00");
+        (0, vitest_1.expect)(task(s).expression).toBe("0 15 4 * *");
+    });
+    (0, vitest_1.it)("twiceMonthly(1, 16, '13:00') → '0 13 1,16 * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).twiceMonthly(1, 16, "13:00");
+        (0, vitest_1.expect)(task(s).expression).toBe("0 13 1,16 * *");
+    });
+    (0, vitest_1.it)("twiceMonthly() with defaults → '0 0 1,16 * *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).twiceMonthly();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 0 1,16 * *");
+    });
+});
+// ─── Quarter / Year frequencies ──────────────────────────────────────────────
+(0, vitest_1.describe)("Quarter and year frequencies", () => {
+    (0, vitest_1.it)("quarterly() → '0 0 1 */3 *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).quarterly();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 0 1 */3 *");
+    });
+    (0, vitest_1.it)("quarterlyOn(4, '14:00') → '0 14 4 */3 *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).quarterlyOn(4, "14:00");
+        (0, vitest_1.expect)(task(s).expression).toBe("0 14 4 */3 *");
+    });
+    (0, vitest_1.it)("yearly() → '0 0 1 1 *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).yearly();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 0 1 1 *");
+    });
+    (0, vitest_1.it)("yearlyOn(6, 1, '17:00') → '0 17 1 6 *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).yearlyOn(6, 1, "17:00");
+        (0, vitest_1.expect)(task(s).expression).toBe("0 17 1 6 *");
+    });
+    (0, vitest_1.it)("yearlyOn() with defaults → '0 0 1 1 *'", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).yearlyOn();
+        (0, vitest_1.expect)(task(s).expression).toBe("0 0 1 1 *");
+    });
+});
+// ─── Custom / cron ───────────────────────────────────────────────────────────
+(0, vitest_1.describe)("Custom cron expression", () => {
+    (0, vitest_1.it)("cron() stores expression as-is", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).cron("0 6,12,18 * * *");
+        (0, vitest_1.expect)(task(s).expression).toBe("0 6,12,18 * * *");
+    });
+});
+// ─── Day filters ─────────────────────────────────────────────────────────────
+(0, vitest_1.describe)("Day filters", () => {
+    (0, vitest_1.it)("weekdays() sets day-of-week to 1-5", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().weekdays();
+        const parts = task(s).expression.split(" ");
+        (0, vitest_1.expect)(parts[4]).toBe("1-5");
+    });
+    (0, vitest_1.it)("weekends() sets day-of-week to 0,6", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().weekends();
+        const parts = task(s).expression.split(" ");
+        (0, vitest_1.expect)(parts[4]).toBe("0,6");
+    });
+    (0, vitest_1.it)("days([1,3,5]) sets day-of-week", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().days([1, 3, 5]);
+        const parts = task(s).expression.split(" ");
+        (0, vitest_1.expect)(parts[4]).toBe("1,3,5");
+    });
+    (0, vitest_1.it)("at('9:30') overrides hour and minute", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().at("9:30");
+        const parts = task(s).expression.split(" ");
+        (0, vitest_1.expect)(parts[0]).toBe("30"); // minute
+        (0, vitest_1.expect)(parts[1]).toBe("9"); // hour
+    });
+    (0, vitest_1.it)("between() stores betweenHours metadata", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).hourly().between(8, 17);
+        (0, vitest_1.expect)(task(s).betweenHours).toEqual([8, 17]);
+    });
+    // ─── Named day shortcuts ────────────────────────────────────────────────────
+    const namedDays = [
+        ["sundays", 0],
+        ["mondays", 1],
+        ["tuesdays", 2],
+        ["wednesdays", 3],
+        ["thursdays", 4],
+        ["fridays", 5],
+        ["saturdays", 6],
+    ];
+    for (const [method, dayIndex] of namedDays) {
+        (0, vitest_1.it)(`${method}() sets day-of-week to ${dayIndex}`, () => {
+            const s = new Schedule_1.Schedule();
+            s.call(async () => { }).daily()[method]();
+            const parts = task(s).expression.split(" ");
+            (0, vitest_1.expect)(parts[4]).toBe(String(dayIndex));
+        });
+    }
+    // ─── unlessBetween ──────────────────────────────────────────────────────────
+    (0, vitest_1.it)("unlessBetween() stores unlessBetweenHours", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).hourly().unlessBetween(23, 6);
+        (0, vitest_1.expect)(task(s).unlessBetweenHours).toEqual([23, 6]);
+    });
+    // ─── when ───────────────────────────────────────────────────────────────────
+    (0, vitest_1.it)("when() stores the predicate function", () => {
+        const s = new Schedule_1.Schedule();
+        const cond = () => true;
+        s.call(async () => { }).daily().when(cond);
+        (0, vitest_1.expect)(task(s).whenCondition).toBe(cond);
+    });
+    // ─── environments ────────────────────────────────────────────────────────────
+    (0, vitest_1.it)("environments() stores the environment list", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().environments("production", "staging");
+        (0, vitest_1.expect)(task(s).environments).toEqual(["production", "staging"]);
+    });
+    (0, vitest_1.it)("environments() accepts a single value", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().environments("production");
+        (0, vitest_1.expect)(task(s).environments).toEqual(["production"]);
+    });
+});
+// ─── Options ─────────────────────────────────────────────────────────────────
+(0, vitest_1.describe)("Task options", () => {
+    (0, vitest_1.it)("timezone() sets timezone", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().timezone("America/New_York");
+        (0, vitest_1.expect)(task(s).timezone).toBe("America/New_York");
+    });
+    (0, vitest_1.it)("withoutOverlapping() sets flag", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().withoutOverlapping();
+        (0, vitest_1.expect)(task(s).withoutOverlapping).toBe(true);
+    });
+    (0, vitest_1.it)("runInBackground() sets flag", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().runInBackground();
+        (0, vitest_1.expect)(task(s).runInBackground).toBe(true);
+    });
+    (0, vitest_1.it)("onOneServer() sets flag", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().onOneServer();
+        (0, vitest_1.expect)(task(s).onOneServer).toBe(true);
+    });
+    (0, vitest_1.it)("description() sets description", () => {
+        const s = new Schedule_1.Schedule();
+        s.call(async () => { }).daily().description("Nightly cleanup");
+        (0, vitest_1.expect)(task(s).description).toBe("Nightly cleanup");
+    });
+});
+// ─── Scheduler isDue — sub-minute ────────────────────────────────────────────
+(0, vitest_1.describe)("Scheduler isDue — secondInterval", () => {
+    (0, vitest_1.it)("fires immediately when lastRunAt is undefined", async () => {
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).everyTenSeconds();
+        const scheduler = makeScheduler(s);
+        await scheduler.run();
+        (0, vitest_1.expect)(ran).toBe(true);
+    });
+    (0, vitest_1.it)("does not fire again before the interval has elapsed", async () => {
+        const s = new Schedule_1.Schedule();
+        let count = 0;
+        s.call(async () => { count++; }).everyTenSeconds();
+        const scheduler = makeScheduler(s);
+        await scheduler.run(); // first run → sets lastRunAt
+        await scheduler.run(); // second run immediately → not due
+        (0, vitest_1.expect)(count).toBe(1);
+    });
+    (0, vitest_1.it)("fires again after the interval has elapsed", async () => {
+        const s = new Schedule_1.Schedule();
+        let count = 0;
+        s.call(async () => { count++; }).everyTenSeconds();
+        const t = task(s);
+        const scheduler = makeScheduler(s);
+        await scheduler.run(); // first run
+        t.lastRunAt = Date.now() - 11_000; // backdate by 11 seconds
+        await scheduler.run(); // should fire again
+        (0, vitest_1.expect)(count).toBe(2);
+    });
+});
+// ─── Scheduler isDue — lastDayOfMonth ────────────────────────────────────────
+(0, vitest_1.describe)("Scheduler isDue — lastDayOfMonth", () => {
+    (0, vitest_1.afterEach)(() => {
+        vitest_1.vi.useRealTimers();
+    });
+    (0, vitest_1.it)("runs when today is the last day of the month", async () => {
+        // Freeze time to Jan 31 at midnight
+        vitest_1.vi.useFakeTimers();
+        vitest_1.vi.setSystemTime(new Date("2024-01-31T00:00:00"));
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).lastDayOfMonth();
+        const scheduler = makeScheduler(s);
+        await scheduler.run();
+        (0, vitest_1.expect)(ran).toBe(true);
+    });
+    (0, vitest_1.it)("does not run when today is not the last day of the month", async () => {
+        vitest_1.vi.useFakeTimers();
+        vitest_1.vi.setSystemTime(new Date("2024-01-15T00:00:00"));
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).lastDayOfMonth();
+        const scheduler = makeScheduler(s);
+        await scheduler.run();
+        (0, vitest_1.expect)(ran).toBe(false);
+    });
+});
+// ─── Scheduler — unlessBetween ───────────────────────────────────────────────
+(0, vitest_1.describe)("Scheduler — unlessBetween", () => {
+    (0, vitest_1.afterEach)(() => vitest_1.vi.useRealTimers());
+    (0, vitest_1.it)("skips the task when current hour is inside the blocked window", async () => {
+        vitest_1.vi.useFakeTimers();
+        vitest_1.vi.setSystemTime(new Date("2024-01-15T02:00:00")); // 2am
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).everyMinute().unlessBetween(23, 6);
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(false);
+    });
+    (0, vitest_1.it)("runs the task when current hour is outside the blocked window", async () => {
+        vitest_1.vi.useFakeTimers();
+        vitest_1.vi.setSystemTime(new Date("2024-01-15T10:00:00")); // 10am
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).everyMinute().unlessBetween(23, 6);
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(true);
+    });
+});
+// ─── Scheduler — when ────────────────────────────────────────────────────────
+(0, vitest_1.describe)("Scheduler — when()", () => {
+    (0, vitest_1.it)("runs the task when the sync predicate returns true", async () => {
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).everyMinute().when(() => true);
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(true);
+    });
+    (0, vitest_1.it)("skips the task when the sync predicate returns false", async () => {
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).everyMinute().when(() => false);
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(false);
+    });
+    (0, vitest_1.it)("supports an async predicate", async () => {
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; })
+            .everyMinute()
+            .when(async () => Promise.resolve(true));
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(true);
+    });
+    (0, vitest_1.it)("skips when async predicate resolves false", async () => {
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; })
+            .everyMinute()
+            .when(async () => Promise.resolve(false));
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(false);
+    });
+});
+// ─── Scheduler — environments ─────────────────────────────────────────────────
+(0, vitest_1.describe)("Scheduler — environments()", () => {
+    const originalAppEnv = process.env.APP_ENV;
+    const originalNodeEnv = process.env.NODE_ENV;
+    (0, vitest_1.afterEach)(() => {
+        process.env.APP_ENV = originalAppEnv;
+        process.env.NODE_ENV = originalNodeEnv;
+    });
+    (0, vitest_1.it)("runs when APP_ENV matches", async () => {
+        process.env.APP_ENV = "production";
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).everyMinute().environments("production");
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(true);
+    });
+    (0, vitest_1.it)("skips when APP_ENV does not match", async () => {
+        process.env.APP_ENV = "local";
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).everyMinute().environments("production");
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(false);
+    });
+    (0, vitest_1.it)("matches any of multiple environments", async () => {
+        process.env.APP_ENV = "staging";
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; })
+            .everyMinute()
+            .environments("production", "staging");
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(true);
+    });
+    (0, vitest_1.it)("is case-insensitive", async () => {
+        process.env.APP_ENV = "Production";
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).everyMinute().environments("production");
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(true);
+    });
+    (0, vitest_1.it)("falls back to NODE_ENV when APP_ENV is not set", async () => {
+        delete process.env.APP_ENV;
+        process.env.NODE_ENV = "test";
+        const s = new Schedule_1.Schedule();
+        let ran = false;
+        s.call(async () => { ran = true; }).everyMinute().environments("test");
+        await makeScheduler(s).run();
+        (0, vitest_1.expect)(ran).toBe(true);
+    });
+});