chore: import upstream snapshot with attribution

2026-07-13 13:32:57 +08:00
commit cd420f9332
4811 changed files with 884702 additions and 0 deletions
@@ -0,0 +1,59 @@
+import { parseExpression } from "cron-parser";
+
+export function calculateNextScheduledTimestampFromNow(schedule: string, timezone: string | null) {
+  return calculateNextScheduledTimestamp(schedule, timezone, new Date());
+}
+
+export function calculateNextScheduledTimestamp(
+  schedule: string,
+  timezone: string | null,
+  currentDate: Date = new Date()
+) {
+  return calculateNextStep(schedule, timezone, currentDate);
+}
+
+function calculateNextStep(schedule: string, timezone: string | null, currentDate: Date) {
+  return parseExpression(schedule, {
+    currentDate,
+    utc: timezone === null,
+    tz: timezone ?? undefined,
+  })
+    .next()
+    .toDate();
+}
+
+export function previousScheduledTimestamp(
+  schedule: string,
+  timezone: string | null,
+  fromTimestamp: Date = new Date()
+) {
+  return parseExpression(schedule, {
+    currentDate: fromTimestamp,
+    utc: timezone === null,
+    tz: timezone ?? undefined,
+  })
+    .prev()
+    .toDate();
+}
+
+export function nextScheduledTimestamps(
+  cron: string,
+  timezone: string | null,
+  lastScheduledTimestamp: Date,
+  count: number = 1
+) {
+  const result: Array<Date> = [];
+  let nextScheduledTimestamp = lastScheduledTimestamp;
+
+  for (let i = 0; i < count; i++) {
+    nextScheduledTimestamp = calculateNextScheduledTimestamp(
+      cron,
+      timezone,
+      nextScheduledTimestamp
+    );
+
+    result.push(nextScheduledTimestamp);
+  }
+
+  return result;
+}