@byok-sdk/core 0.27.0 → 0.28.0

package/dist/routine-schedule.d.ts

@@ -0,0 +1,49 @@
+export declare const ROUTINE_DAYS_OF_WEEK: readonly ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+export type RoutineDayOfWeek = (typeof ROUTINE_DAYS_OF_WEEK)[number];
+/**
+ * One local time per matching day. No daysOfWeek and no dayOfMonth: every
+ * day. daysOfWeek: those weekdays only. dayOfMonth: that day of every month,
+ * or of `month` only. daysOfWeek and dayOfMonth never appear together;
+ * `month` needs `dayOfMonth`.
+ */
+export interface RoutineSchedule {
+    readonly minute: number;
+    readonly hour: number;
+    readonly daysOfWeek?: readonly RoutineDayOfWeek[];
+    readonly dayOfMonth?: number;
+    readonly month?: number;
+    readonly tz: string;
+}
+/**
+ * 368 days: a yearly date can be 366 days plus a DST shift apart (leap year
+ * in between, DST state flips). The embedded wake limit must match this value.
+ */
+export declare const ROUTINE_HORIZON_MS: number;
+/**
+ * Supported `now`: [2000-01-01T00:00Z, 2200-01-01T00:00Z). Before 1972 some
+ * zones have second-level offsets (Africa/Monrovia); past 2200 tz rules are
+ * projections. Date and Intl themselves cover ±8.64e15 ms.
+ */
+export declare const ROUTINE_MIN_NOW: number;
+export declare const ROUTINE_MAX_NOW: number;
+export type RoutineScheduleIssueCode = 'schedule_invalid' | 'schedule_unreachable' | 'schedule_beyond_horizon' | 'tz_invalid';
+export type RoutineScheduleCheck = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly code: RoutineScheduleIssueCode;
+    readonly message: string;
+};
+/** Validation only. The Host calls it when it applies create_routine / update_routine. */
+export declare function checkRoutineSchedule(schedule: RoutineSchedule): RoutineScheduleCheck;
+/**
+ * The first occurrence strictly after `now` (epoch ms): the instant at which
+ * the zone's wall clock shows the schedule's whole local minute on a matching
+ * date. Null when none falls within ROUTINE_HORIZON_MS. Throws on an invalid
+ * schedule.
+ *
+ * Scan from the local date before `now`; keep the running minimum `best` of
+ * candidates after `now`; stop at the first unshifted candidate, because a
+ * later local time never resolves earlier. Assumes a gap is at most one day.
+ */
+export declare function nextRoutineOccurrence(schedule: RoutineSchedule, now: number): number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byok-sdk/core",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "BYOK SDK platform contracts: branded tenant identity, tenant-first store ports, device proof canonicalization, and the composition conformance reference",
   "type": "module",
   "license": "MIT",