@drip-apex/sdk 0.1.0 → 0.2.0

package/src/weekday-schedule-parity-corpus.json

@@ -0,0 +1,92 @@
+[
+  {
+    "name": "Europe Berlin DST start Sunday",
+    "schedule": {
+      "excludedDays": ["sunday"],
+      "timezone": "Europe/Berlin"
+    },
+    "instant": "2026-03-29T00:30:00.000Z",
+    "excluded": true
+  },
+  {
+    "name": "Europe Berlin local Monday after DST boundary",
+    "schedule": {
+      "excludedDays": ["monday"],
+      "timezone": "Europe/Berlin"
+    },
+    "instant": "2026-03-29T22:30:00.000Z",
+    "excluded": true
+  },
+  {
+    "name": "Los Angeles remains Wednesday before UTC Thursday",
+    "schedule": {
+      "excludedDays": ["wednesday"],
+      "timezone": "America/Los_Angeles"
+    },
+    "instant": "2026-01-01T07:30:00.000Z",
+    "excluded": true
+  },
+  {
+    "name": "Tokyo reaches Thursday before UTC",
+    "schedule": {
+      "excludedDays": ["thursday"],
+      "timezone": "Asia/Tokyo"
+    },
+    "instant": "2025-12-31T15:30:00.000Z",
+    "excluded": true
+  },
+  {
+    "name": "Configured active day delivers",
+    "schedule": {
+      "excludedDays": ["friday", "saturday"],
+      "timezone": "UTC"
+    },
+    "instant": "2026-08-03T12:00:00.000Z",
+    "excluded": false
+  },
+  {
+    "name": "Invalid timezone fails open",
+    "schedule": {
+      "excludedDays": ["monday"],
+      "timezone": "Mars/Olympus_Mons"
+    },
+    "instant": "2026-08-03T12:00:00.000Z",
+    "excluded": false
+  },
+  {
+    "name": "All seven excluded days fail open",
+    "schedule": {
+      "excludedDays": ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"],
+      "timezone": "UTC"
+    },
+    "instant": "2026-08-03T12:00:00.000Z",
+    "excluded": false
+  },
+  {
+    "name": "No excluded days fails open",
+    "schedule": {
+      "excludedDays": [],
+      "timezone": "UTC"
+    },
+    "instant": "2026-08-03T12:00:00.000Z",
+    "excluded": false
+  },
+  {
+    "name": "Unknown excluded day fails open",
+    "schedule": {
+      "excludedDays": ["funday"],
+      "timezone": "UTC"
+    },
+    "instant": "2026-08-03T12:00:00.000Z",
+    "excluded": false
+  },
+  {
+    "name": "Non-array excluded days fails open",
+    "schedule": {
+      "excludedDays": "monday",
+      "timezone": "UTC"
+    },
+    "instant": "2026-08-03T12:00:00.000Z",
+    "excluded": false
+  }
+]

package/src/weekday-schedule.test.ts

@@ -0,0 +1,69 @@
+import { describe, expect, it, vi } from "vitest";
+import corpus from "./weekday-schedule-parity-corpus.json";
+
+// Hermeticity: weekday tests pin the most recent UTC Monday at 12:00 instead
+// of a literal calendar date.
+const RECENT_MONDAY_NOON = (() => {
+  const d = new Date();
+  d.setUTCDate(d.getUTCDate() - ((d.getUTCDay() + 6) % 7));
+  d.setUTCHours(12, 0, 0, 0);
+  return d;
+})();
+import {
+  resetWeekdayScheduleWarningsForTests,
+  weekdayScheduleBlocksDelivery,
+} from "./weekday-schedule";
+
+describe("weekday schedule", () => {
+  it.each(corpus)("evaluates $name", ({ schedule, instant, excluded }) => {
+    expect(
+      weekdayScheduleBlocksDelivery(schedule as never, new Date(instant)),
+    ).toBe(excluded);
+  });
+
+  it("warns once and fails open for an invalid timezone", () => {
+    resetWeekdayScheduleWarningsForTests();
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => undefined);
+    const schedule = { excludedDays: ["monday"], timezone: "Mars/Olympus_Mons" };
+    expect(weekdayScheduleBlocksDelivery(schedule as never, new Date(RECENT_MONDAY_NOON))).toBe(false);
+    expect(weekdayScheduleBlocksDelivery(schedule as never, new Date(RECENT_MONDAY_NOON.getTime() + 3_600_000))).toBe(false);
+    expect(warn).toHaveBeenCalledTimes(1);
+    warn.mockRestore();
+  });
+
+  it.each([
+    [
+      "all seven excluded days",
+      [
+        "monday",
+        "tuesday",
+        "wednesday",
+        "thursday",
+        "friday",
+        "saturday",
+        "sunday",
+      ],
+    ],
+    ["no excluded days", []],
+    ["an unknown excluded day", ["funday"]],
+    ["non-array excluded days", "monday"],
+  ])("warns once and fails open for %s", (_name, excludedDays) => {
+    resetWeekdayScheduleWarningsForTests();
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => undefined);
+    const schedule = { excludedDays, timezone: "UTC" };
+    expect(
+      weekdayScheduleBlocksDelivery(
+        schedule as never,
+        new Date(RECENT_MONDAY_NOON),
+      ),
+    ).toBe(false);
+    expect(
+      weekdayScheduleBlocksDelivery(
+        schedule as never,
+        new Date(RECENT_MONDAY_NOON.getTime() + 3_600_000),
+      ),
+    ).toBe(false);
+    expect(warn).toHaveBeenCalledTimes(1);
+    warn.mockRestore();
+  });
+});

package/src/weekday-schedule.ts

@@ -0,0 +1,20 @@
+import {
+  weekdayScheduleBlocksDelivery as sharedWeekdayScheduleBlocksDelivery,
+} from "@drip/shared-runtime/weekday-schedule";
+
+export {
+  isWeekdayExcluded,
+  resetWeekdayScheduleWarningsForTests,
+  WEEKDAYS,
+} from "@drip/shared-runtime/weekday-schedule";
+export type {
+  Weekday,
+  WeekdaySchedule,
+} from "@drip/shared-runtime/weekday-schedule";
+
+export function weekdayScheduleBlocksDelivery(
+  schedule: unknown,
+  now: Date,
+): boolean {
+  return sharedWeekdayScheduleBlocksDelivery(schedule, now, "[drip]");
+}