@almadar/runtime 6.19.0 → 6.21.0

package/dist/{chunk-JZ4IDIUU.js → chunk-53VRCHPK.js}

@@ -1,3 +1,4 @@
+import { parseCron, cronMinuteKey, cronMatches } from './chunk-U4PL237A.js';
 import { createLogger } from '@almadar/logger';
 import { resolveBinding, evaluate, createMinimalContext, evaluateGuard } from '@almadar/evaluator';
 export { createMinimalContext } from '@almadar/evaluator';
@@ -5,7 +6,6 @@ import { isKnownStdOperator } from '@almadar/std/registry';
 import { faker } from '@faker-js/faker';
 import { OrbitalSchemaSchema, isInlineTrait, isEntityCall, isEntityReference, parseEntityRef, parseImportedTraitRef, isPageReference, isPageReferenceString, isPageReferenceObject, parsePageRef } from '@almadar/core';
 
-// src/EventBus.ts
 var log = createLogger("almadar:runtime:eventbus");
 var EventBus = class {
   listeners = /* @__PURE__ */ new Map();
@@ -125,6 +125,7 @@ var EventBus = class {
 
 // src/TickScheduler.ts
 var EVERY_PASS = 0;
+var CRON_CHECK_INTERVAL_MS = 1e3;
 var TickScheduler = class {
   ticks = /* @__PURE__ */ new Map();
   nextId = 1;
@@ -142,6 +143,7 @@ var TickScheduler = class {
   add(intervalMs, onDue) {
     const id = this.nextId++;
     this.ticks.set(id, {
+      kind: "interval",
       intervalMs: intervalMs > 0 ? intervalMs : EVERY_PASS,
       accumulatedMs: 0,
       lastTimestamp: null,
@@ -155,6 +157,33 @@ var TickScheduler = class {
       }
     };
   }
+  /**
+   * Register a cron-scheduled tick (`ticks { ... every "0 9 * * *" }`).
+   * Fires at most once per matching calendar minute — the same dedup shape
+   * `os/watch-cron` uses. Throws if `expression` isn't a valid 5-field cron
+   * string; callers on a path the compiler has already validated (e.g.
+   * generated code) won't hit this, but a raw runtime value might.
+   */
+  addCron(expression, onDue) {
+    const fields = parseCron(expression);
+    const id = this.nextId++;
+    this.ticks.set(id, {
+      kind: "cron",
+      fields,
+      accumulatedMs: CRON_CHECK_INTERVAL_MS,
+      // check on the first pass, not after a full second
+      lastTimestamp: null,
+      lastFiredMinuteKey: -1,
+      onDue
+    });
+    this.ensureRunning();
+    return {
+      stop: () => {
+        this.ticks.delete(id);
+        this.maybeStop();
+      }
+    };
+  }
   /** Stop every tick and the shared loop. */
   stopAll() {
     this.ticks.clear();
@@ -188,6 +217,10 @@ var TickScheduler = class {
   }
   advance(timestamp) {
     for (const tick of this.ticks.values()) {
+      if (tick.kind === "cron") {
+        this.advanceCron(tick, timestamp);
+        continue;
+      }
       if (tick.intervalMs <= EVERY_PASS) {
         tick.onDue();
         continue;
@@ -204,10 +237,54 @@ var TickScheduler = class {
       }
     }
   }
+  /** Cron ticks check calendar-match at most once a second, deduped per matching minute. */
+  advanceCron(tick, timestamp) {
+    if (tick.lastTimestamp === null) {
+      tick.lastTimestamp = timestamp;
+      return;
+    }
+    tick.accumulatedMs += timestamp - tick.lastTimestamp;
+    tick.lastTimestamp = timestamp;
+    if (tick.accumulatedMs < CRON_CHECK_INTERVAL_MS) return;
+    tick.accumulatedMs = 0;
+    const now = /* @__PURE__ */ new Date();
+    const minuteKey = cronMinuteKey(now);
+    if (minuteKey !== tick.lastFiredMinuteKey && cronMatches(tick.fields, now)) {
+      tick.lastFiredMinuteKey = minuteKey;
+      tick.onDue();
+    }
+  }
 };
 function createTickScheduler() {
   return new TickScheduler();
 }
+
+// src/duration.ts
+function parseDurationString(interval) {
+  const match = interval.match(/^(\d+)(ms|s|m|h)?$/);
+  if (!match) {
+    throw new Error(
+      `Invalid duration '${interval}': expected a shape like '5ms'/'5s'/'1m'/'1h'`
+    );
+  }
+  const value = parseInt(match[1], 10);
+  const unit = match[2] || "ms";
+  switch (unit) {
+    case "ms":
+      return value;
+    case "s":
+      return value * 1e3;
+    case "m":
+      return value * 60 * 1e3;
+    case "h":
+      return value * 60 * 60 * 1e3;
+    default:
+      return value;
+  }
+}
+function isValidDurationString(interval) {
+  return /^(\d+)(ms|s|m|h)?$/.test(interval);
+}
 var bindLog = createLogger("almadar:runtime:bindings");
 var renderLog = createLogger("almadar:runtime:render-ui");
 var CLIENT_ONLY_BINDING_ROOTS = /* @__PURE__ */ new Set(["trait"]);
@@ -3808,6 +3885,6 @@ var InMemoryPersistence = class {
   }
 };
 
-export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, containsBindings, createContextFromBindings, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, extractBindings, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, normalizeEventKey, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes };
-//# sourceMappingURL=chunk-JZ4IDIUU.js.map
-//# sourceMappingURL=chunk-JZ4IDIUU.js.map
+export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, containsBindings, createContextFromBindings, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, extractBindings, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes };
+//# sourceMappingURL=chunk-53VRCHPK.js.map
+//# sourceMappingURL=chunk-53VRCHPK.js.map