paperclip/ui/src/lib/cron-fires.test.ts

import { describe, expect, it } from "vitest";
import { nextCronFires, parseCronExpression, previewFirePolicies } from "./cron-fires";

describe("parseCronExpression", () => {
  it("parses a standard 5-field expression", () => {
    const parsed = parseCronExpression("0 14 * * 1-5");
    expect(parsed).not.toBeNull();
    expect(parsed?.minutes).toEqual([0]);
    expect(parsed?.hours).toEqual([14]);
    expect(parsed?.daysOfWeek).toEqual([1, 2, 3, 4, 5]);
  });

  it("returns null for malformed expressions", () => {
    expect(parseCronExpression("not a cron")).toBeNull();
    expect(parseCronExpression("0 14 * *")).toBeNull();
    expect(parseCronExpression("")).toBeNull();
    expect(parseCronExpression(null)).toBeNull();
  });
});

describe("nextCronFires", () => {
  it("computes the next N daily fires in UTC", () => {
    const after = new Date("2026-06-09T10:00:00Z");
    const fires = nextCronFires("0 14 * * *", 3, { after, timeZone: "UTC" });
    expect(fires.map((d) => d.toISOString())).toEqual([
      "2026-06-09T14:00:00.000Z",
      "2026-06-10T14:00:00.000Z",
      "2026-06-11T14:00:00.000Z",
    ]);
  });

  it("skips weekends for a weekday schedule", () => {
    // 2026-06-12 is a Friday; the next weekday fire after Fri is Mon 2026-06-15.
    const after = new Date("2026-06-12T15:00:00Z");
    const fires = nextCronFires("0 14 * * 1-5", 2, { after, timeZone: "UTC" });
    expect(fires.map((d) => d.toISOString())).toEqual([
      "2026-06-15T14:00:00.000Z",
      "2026-06-16T14:00:00.000Z",
    ]);
  });

  it("uses OR semantics when day-of-month and day-of-week are both restricted", () => {
    const after = new Date("2026-06-09T10:00:00Z");
    const fires = nextCronFires("0 9 15 * 5", 3, { after, timeZone: "UTC" });
    expect(fires.map((d) => d.toISOString())).toEqual([
      "2026-06-12T09:00:00.000Z",
      "2026-06-15T09:00:00.000Z",
      "2026-06-19T09:00:00.000Z",
    ]);
  });

  it("interprets cron fields in the trigger timezone", () => {
    // 14:00 in New York (EDT, UTC-4 in June) is 18:00 UTC.
    const after = new Date("2026-06-09T10:00:00Z");
    const fires = nextCronFires("0 14 * * *", 1, { after, timeZone: "America/New_York" });
    expect(fires[0]?.toISOString()).toBe("2026-06-09T18:00:00.000Z");
  });

  it("returns an empty list for an unparseable expression", () => {
    expect(nextCronFires("garbage", 5)).toEqual([]);
    expect(nextCronFires("0 14 * * *", 0)).toEqual([]);
  });
});

describe("previewFirePolicies", () => {
  const fires = [
    new Date("2026-06-09T14:00:00Z"),
    new Date("2026-06-10T14:00:00Z"),
    new Date("2026-06-11T14:00:00Z"),
  ];

  it("always queues the first fire regardless of policy", () => {
    for (const policy of ["coalesce_if_active", "always_enqueue", "skip_if_active"]) {
      expect(previewFirePolicies(fires, policy)[0]?.disposition).toBe("queued");
    }
  });

  it("coalesces subsequent fires under coalesce_if_active", () => {
    const preview = previewFirePolicies(fires, "coalesce_if_active");
    expect(preview.map((e) => e.disposition)).toEqual(["queued", "coalesced", "coalesced"]);
    expect(preview[1]?.label).toBe("would be coalesced");
  });

  it("skips subsequent fires under skip_if_active", () => {
    const preview = previewFirePolicies(fires, "skip_if_active");
    expect(preview.map((e) => e.disposition)).toEqual(["queued", "skipped", "skipped"]);
  });

  it("queues every fire under always_enqueue", () => {
    const preview = previewFirePolicies(fires, "always_enqueue");
    expect(preview.every((e) => e.disposition === "queued")).toBe(true);
  });

  it("defaults unknown policies to coalesce", () => {
    const preview = previewFirePolicies(fires, "mystery");
    expect(preview[1]?.disposition).toBe("coalesced");
  });
});