skedyul 1.7.5 → 1.7.6

package/dist/.build-stamp

@@ -1 +1 @@
-1785810690937
+1785913911217

package/dist/esm/index.mjs

@@ -8027,7 +8027,15 @@ var WaitInputRelativeSchema = z15.object({
   mode: z15.literal("relative"),
   amount: z15.number(),
   unit: WaitUnitSchema,
-  windows: z15.array(TimeWindowSlotSchema).optional()
+  windows: z15.array(TimeWindowSlotSchema).optional(),
+  /**
+   * Optional ISO datetime to use as the base for the relative delay instead of
+   * wall-clock `now`. Used for cadence chaining (schedule relative to a prior
+   * message's scheduledAt). `waitTime` is still measured from wall-clock `now`.
+   */
+  from: z15.union([z15.string(), z15.date()]).optional().describe(
+    "ISO datetime base for the relative delay (e.g. previous message scheduledAt)"
+  )
 });
 var WaitInputAbsoluteSchema = z15.object({
   mode: z15.literal("absolute"),
@@ -8140,10 +8148,12 @@ function calculateWaitTime(step, now) {
       };
     }
     case "relative": {
+      const baseTime = step.from != null ? new Date(step.from).getTime() : nowTime;
+      const baseDate = new Date(baseTime);
       if (!step.amount && (!step.windows || step.windows.length === 0)) {
         return {
-          waitTime: 0,
-          scheduledAt: now
+          waitTime: Math.max(0, baseTime - nowTime),
+          scheduledAt: baseDate
         };
       }
       let relativeDelay = 0;
@@ -8182,17 +8192,18 @@ function calculateWaitTime(step, now) {
         }
       }
       if (!step.windows || step.windows.length === 0) {
+        const scheduledAt = new Date(baseTime + relativeDelay);
         return {
-          waitTime: relativeDelay,
-          scheduledAt: new Date(nowTime + relativeDelay)
+          waitTime: Math.max(0, scheduledAt.getTime() - nowTime),
+          scheduledAt
         };
       }
-      const targetDate = new Date(nowTime + relativeDelay);
+      const targetDate = new Date(baseTime + relativeDelay);
       for (const window of step.windows) {
         if (isTimeInWindowSlot(targetDate, window)) {
           return {
-            waitTime: relativeDelay,
-            scheduledAt: new Date(nowTime + relativeDelay)
+            waitTime: Math.max(0, targetDate.getTime() - nowTime),
+            scheduledAt: targetDate
           };
         }
       }
@@ -8237,8 +8248,8 @@ function calculateWaitTime(step, now) {
           msUntilWindowStart = daysMs + hoursAdjustment + minutesAdjustment;
         }
         const windowStartTimeMs = targetDate.getTime() + msUntilWindowStart;
-        const sameLocalDayAsNow = getLocalDateKey(now, tz) === getLocalDateKey(targetDate, tz);
-        const windowScheduledTime = sameLocalDayAsNow ? new Date(windowStartTimeMs + relativeDelay) : new Date(windowStartTimeMs);
+        const sameLocalDayAsBase = getLocalDateKey(baseDate, tz) === getLocalDateKey(targetDate, tz);
+        const windowScheduledTime = sameLocalDayAsBase ? new Date(windowStartTimeMs + relativeDelay) : new Date(windowStartTimeMs);
         const waitFromNow = windowScheduledTime.getTime() - nowTime;
         if (waitFromNow < earliestWaitFromNow) {
           earliestWaitFromNow = waitFromNow;

package/dist/index.js

@@ -8401,7 +8401,15 @@ var WaitInputRelativeSchema = import_v413.z.object({
   mode: import_v413.z.literal("relative"),
   amount: import_v413.z.number(),
   unit: WaitUnitSchema,
-  windows: import_v413.z.array(TimeWindowSlotSchema).optional()
+  windows: import_v413.z.array(TimeWindowSlotSchema).optional(),
+  /**
+   * Optional ISO datetime to use as the base for the relative delay instead of
+   * wall-clock `now`. Used for cadence chaining (schedule relative to a prior
+   * message's scheduledAt). `waitTime` is still measured from wall-clock `now`.
+   */
+  from: import_v413.z.union([import_v413.z.string(), import_v413.z.date()]).optional().describe(
+    "ISO datetime base for the relative delay (e.g. previous message scheduledAt)"
+  )
 });
 var WaitInputAbsoluteSchema = import_v413.z.object({
   mode: import_v413.z.literal("absolute"),
@@ -8514,10 +8522,12 @@ function calculateWaitTime(step, now) {
       };
     }
     case "relative": {
+      const baseTime = step.from != null ? new Date(step.from).getTime() : nowTime;
+      const baseDate = new Date(baseTime);
       if (!step.amount && (!step.windows || step.windows.length === 0)) {
         return {
-          waitTime: 0,
-          scheduledAt: now
+          waitTime: Math.max(0, baseTime - nowTime),
+          scheduledAt: baseDate
         };
       }
       let relativeDelay = 0;
@@ -8556,17 +8566,18 @@ function calculateWaitTime(step, now) {
         }
       }
       if (!step.windows || step.windows.length === 0) {
+        const scheduledAt = new Date(baseTime + relativeDelay);
         return {
-          waitTime: relativeDelay,
-          scheduledAt: new Date(nowTime + relativeDelay)
+          waitTime: Math.max(0, scheduledAt.getTime() - nowTime),
+          scheduledAt
         };
       }
-      const targetDate = new Date(nowTime + relativeDelay);
+      const targetDate = new Date(baseTime + relativeDelay);
       for (const window of step.windows) {
         if (isTimeInWindowSlot(targetDate, window)) {
           return {
-            waitTime: relativeDelay,
-            scheduledAt: new Date(nowTime + relativeDelay)
+            waitTime: Math.max(0, targetDate.getTime() - nowTime),
+            scheduledAt: targetDate
           };
         }
       }
@@ -8611,8 +8622,8 @@ function calculateWaitTime(step, now) {
           msUntilWindowStart = daysMs + hoursAdjustment + minutesAdjustment;
         }
         const windowStartTimeMs = targetDate.getTime() + msUntilWindowStart;
-        const sameLocalDayAsNow = getLocalDateKey(now, tz) === getLocalDateKey(targetDate, tz);
-        const windowScheduledTime = sameLocalDayAsNow ? new Date(windowStartTimeMs + relativeDelay) : new Date(windowStartTimeMs);
+        const sameLocalDayAsBase = getLocalDateKey(baseDate, tz) === getLocalDateKey(targetDate, tz);
+        const windowScheduledTime = sameLocalDayAsBase ? new Date(windowStartTimeMs + relativeDelay) : new Date(windowStartTimeMs);
         const waitFromNow = windowScheduledTime.getTime() - nowTime;
         if (waitFromNow < earliestWaitFromNow) {
           earliestWaitFromNow = waitFromNow;

package/dist/scheduling/calculateWaitTime.d.ts

@@ -9,8 +9,10 @@
 import type { WaitInputType, CalculateWaitTimeResult } from './types-workflow';
 /**
  * Calculate the wait time for a wait step
- * @param step The input parameters for the wait step
- * @param now The current date/time
+ * @param step The input parameters for the wait step. Relative mode may include
+ *   optional `from` (ISO datetime / Date) as the base for the delay instead of `now`.
+ * @param now Wall-clock current date/time. Used as the default relative base and
+ *   always used to compute `waitTime` (ms until `scheduledAt`).
  * @returns The time to wait in milliseconds and the scheduled date
  */
 export declare function calculateWaitTime(step: WaitInputType, now: Date): CalculateWaitTimeResult;

package/dist/scheduling/index.js

@@ -128,10 +128,12 @@ function calculateWaitTime(step, now) {
       };
     }
     case "relative": {
+      const baseTime = step.from != null ? new Date(step.from).getTime() : nowTime;
+      const baseDate = new Date(baseTime);
       if (!step.amount && (!step.windows || step.windows.length === 0)) {
         return {
-          waitTime: 0,
-          scheduledAt: now
+          waitTime: Math.max(0, baseTime - nowTime),
+          scheduledAt: baseDate
         };
       }
       let relativeDelay = 0;
@@ -170,17 +172,18 @@ function calculateWaitTime(step, now) {
         }
       }
       if (!step.windows || step.windows.length === 0) {
+        const scheduledAt = new Date(baseTime + relativeDelay);
         return {
-          waitTime: relativeDelay,
-          scheduledAt: new Date(nowTime + relativeDelay)
+          waitTime: Math.max(0, scheduledAt.getTime() - nowTime),
+          scheduledAt
         };
       }
-      const targetDate = new Date(nowTime + relativeDelay);
+      const targetDate = new Date(baseTime + relativeDelay);
       for (const window of step.windows) {
         if (isTimeInWindowSlot(targetDate, window)) {
           return {
-            waitTime: relativeDelay,
-            scheduledAt: new Date(nowTime + relativeDelay)
+            waitTime: Math.max(0, targetDate.getTime() - nowTime),
+            scheduledAt: targetDate
           };
         }
       }
@@ -225,8 +228,8 @@ function calculateWaitTime(step, now) {
           msUntilWindowStart = daysMs + hoursAdjustment + minutesAdjustment;
         }
         const windowStartTimeMs = targetDate.getTime() + msUntilWindowStart;
-        const sameLocalDayAsNow = getLocalDateKey(now, tz) === getLocalDateKey(targetDate, tz);
-        const windowScheduledTime = sameLocalDayAsNow ? new Date(windowStartTimeMs + relativeDelay) : new Date(windowStartTimeMs);
+        const sameLocalDayAsBase = getLocalDateKey(baseDate, tz) === getLocalDateKey(targetDate, tz);
+        const windowScheduledTime = sameLocalDayAsBase ? new Date(windowStartTimeMs + relativeDelay) : new Date(windowStartTimeMs);
         const waitFromNow = windowScheduledTime.getTime() - nowTime;
         if (waitFromNow < earliestWaitFromNow) {
           earliestWaitFromNow = waitFromNow;

package/dist/scheduling/index.mjs

@@ -100,10 +100,12 @@ function calculateWaitTime(step, now) {
       };
     }
     case "relative": {
+      const baseTime = step.from != null ? new Date(step.from).getTime() : nowTime;
+      const baseDate = new Date(baseTime);
       if (!step.amount && (!step.windows || step.windows.length === 0)) {
         return {
-          waitTime: 0,
-          scheduledAt: now
+          waitTime: Math.max(0, baseTime - nowTime),
+          scheduledAt: baseDate
         };
       }
       let relativeDelay = 0;
@@ -142,17 +144,18 @@ function calculateWaitTime(step, now) {
         }
       }
       if (!step.windows || step.windows.length === 0) {
+        const scheduledAt = new Date(baseTime + relativeDelay);
         return {
-          waitTime: relativeDelay,
-          scheduledAt: new Date(nowTime + relativeDelay)
+          waitTime: Math.max(0, scheduledAt.getTime() - nowTime),
+          scheduledAt
         };
       }
-      const targetDate = new Date(nowTime + relativeDelay);
+      const targetDate = new Date(baseTime + relativeDelay);
       for (const window of step.windows) {
         if (isTimeInWindowSlot(targetDate, window)) {
           return {
-            waitTime: relativeDelay,
-            scheduledAt: new Date(nowTime + relativeDelay)
+            waitTime: Math.max(0, targetDate.getTime() - nowTime),
+            scheduledAt: targetDate
           };
         }
       }
@@ -197,8 +200,8 @@ function calculateWaitTime(step, now) {
           msUntilWindowStart = daysMs + hoursAdjustment + minutesAdjustment;
         }
         const windowStartTimeMs = targetDate.getTime() + msUntilWindowStart;
-        const sameLocalDayAsNow = getLocalDateKey(now, tz) === getLocalDateKey(targetDate, tz);
-        const windowScheduledTime = sameLocalDayAsNow ? new Date(windowStartTimeMs + relativeDelay) : new Date(windowStartTimeMs);
+        const sameLocalDayAsBase = getLocalDateKey(baseDate, tz) === getLocalDateKey(targetDate, tz);
+        const windowScheduledTime = sameLocalDayAsBase ? new Date(windowStartTimeMs + relativeDelay) : new Date(windowStartTimeMs);
         const waitFromNow = windowScheduledTime.getTime() - nowTime;
         if (waitFromNow < earliestWaitFromNow) {
           earliestWaitFromNow = waitFromNow;

package/dist/scheduling/types-workflow.d.ts

@@ -33,6 +33,13 @@ export interface WaitInputRelative {
     amount: number;
     unit: WaitUnit;
     windows?: TimeWindowSlot[];
+    /**
+     * Optional ISO datetime (or Date) to use as the base for the relative delay
+     * instead of wall-clock `now`. Used for cadence chaining: schedule message N
+     * relative to message N-1's `scheduledAt`.
+     * `waitTime` in the result is still measured from wall-clock `now`.
+     */
+    from?: string | Date;
 }
 export interface WaitInputAbsolute {
     mode: 'absolute';

package/dist/scheduling/types.d.ts

@@ -107,6 +107,7 @@ export declare const WaitInputRelativeSchema: z.ZodObject<{
         }>>;
         timezone: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    from: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodDate]>>;
 }, z.core.$strip>;
 export declare const WaitInputAbsoluteSchema: z.ZodObject<{
     mode: z.ZodLiteral<"absolute">;
@@ -153,6 +154,7 @@ export declare const WaitInputSchema: z.ZodUnion<readonly [z.ZodObject<{
         }>>;
         timezone: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    from: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodDate]>>;
 }, z.core.$strip>, z.ZodObject<{
     mode: z.ZodLiteral<"absolute">;
     scheduleAt: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.7.5",
+  "version": "1.7.6",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",