@almadar/runtime 6.68.0 → 6.70.0

package/dist/{OrbitalServerRuntime-DOJDoqXu.d.ts → OrbitalServerRuntime-ut1b36Nv.d.ts}

@@ -1553,6 +1553,12 @@ declare class OrbitalServerRuntime {
         interval: number | string;
         hasGuard: boolean;
     }>;
+    /** Halt every registered tick's shared clock. Delegates to `TickScheduler.pause`. */
+    pauseTicks(): void;
+    /** Resume ticks halted by `pauseTicks()`. Delegates to `TickScheduler.resume`. */
+    resumeTicks(): void;
+    /** True while ticks are paused. Delegates to `TickScheduler.isPaused`. */
+    areTicksPaused(): boolean;
 }
 /**
  * Factory function to create a runtime instance

package/dist/OrbitalServerRuntime.d.ts

@@ -1,4 +1,4 @@
 import 'express';
-export { F as ClientEffectTuple, G as ClientNavigateBackTuple, H as ClientNavigateTuple, J as ClientNotifyTuple, K as ClientRenderUITuple, M as EffectResult, e as InMemoryPersistence, N as LiveBroadcastItem, Q as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, T as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, V as RuntimeTraitTick, p as collectDeclaredConfigDefaults, W as createOrbitalServerRuntime } from './OrbitalServerRuntime-DOJDoqXu.js';
+export { F as ClientEffectTuple, G as ClientNavigateBackTuple, H as ClientNavigateTuple, J as ClientNotifyTuple, K as ClientRenderUITuple, M as EffectResult, e as InMemoryPersistence, N as LiveBroadcastItem, Q as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, T as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, V as RuntimeTraitTick, p as collectDeclaredConfigDefaults, W as createOrbitalServerRuntime } from './OrbitalServerRuntime-ut1b36Nv.js';
 import './types-BaD_ox7e.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,5 +1,5 @@
-import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-XSWRK6DN.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-XSWRK6DN.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-PAEMYGKV.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-PAEMYGKV.js';
 import { isValidCronExpression } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, checkMutationAccess, resolveCallSitePayloadCaptures, applyRowAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
@@ -63,7 +63,7 @@ var dynamicLog = createLogger("almadar:runtime:dynamic");
 function isNodeEnv() {
   return typeof process !== "undefined" && Boolean(process.versions?.node);
 }
-var NO_ROW_KEY_IS_FATAL = false;
+var NO_ROW_KEY_IS_FATAL = true;
 function needsPreprocessing(schema) {
   for (const orbital of schema.orbitals) {
     const uses = orbital.uses;
@@ -1575,7 +1575,11 @@ var OrbitalServerRuntime = class {
                 resultData = updated || { id: updateId, ...data || {} };
               } else {
                 effectLog.error("persist:no-row-key", { action, entityType: type });
-                if (NO_ROW_KEY_IS_FATAL) ;
+                if (NO_ROW_KEY_IS_FATAL) {
+                  throw new Error(
+                    `persist ${action} ${type} resolved no row key \u2014 the id was neither on the row being written nor on the request. Bind it before the write, e.g. (set @entity.id ?row.id) on the transition that selects it.`
+                  );
+                }
               }
               break;
             case "delete": {
@@ -1594,7 +1598,11 @@ var OrbitalServerRuntime = class {
                 resultData = { id: deleteId, deleted: true };
               } else {
                 effectLog.error("persist:no-row-key", { action, entityType: type });
-                if (NO_ROW_KEY_IS_FATAL) ;
+                if (NO_ROW_KEY_IS_FATAL) {
+                  throw new Error(
+                    `persist ${action} ${type} resolved no row key \u2014 the id was neither on the row being written nor on the request. Bind it before the write, e.g. (set @entity.id ?row.id) on the transition that selects it.`
+                  );
+                }
               }
               break;
             }
@@ -2410,6 +2418,18 @@ var OrbitalServerRuntime = class {
       hasGuard: !!binding.tick.guard
     }));
   }
+  /** Halt every registered tick's shared clock. Delegates to `TickScheduler.pause`. */
+  pauseTicks() {
+    this.tickScheduler.pause();
+  }
+  /** Resume ticks halted by `pauseTicks()`. Delegates to `TickScheduler.resume`. */
+  resumeTicks() {
+    this.tickScheduler.resume();
+  }
+  /** True while ticks are paused. Delegates to `TickScheduler.isPaused`. */
+  areTicksPaused() {
+    return this.tickScheduler.isPaused;
+  }
 };
 function createOrbitalServerRuntime(config) {
   return new OrbitalServerRuntime(config);

package/dist/{chunk-XSWRK6DN.js → chunk-PAEMYGKV.js}

@@ -133,6 +133,7 @@ var TickScheduler = class {
   ticks = /* @__PURE__ */ new Map();
   nextId = 1;
   running = false;
+  paused = false;
   frameHandle = null;
   hasRaf;
   constructor() {
@@ -192,8 +193,38 @@ var TickScheduler = class {
     this.ticks.clear();
     this.maybeStop();
   }
+  /** True while the scheduler is paused (no tick callback fires and no backlog accumulates). */
+  get isPaused() {
+    return this.paused;
+  }
+  /**
+   * Halt the shared loop without dropping registered ticks. No `onDue`
+   * fires again until `resume()`. A no-op if already paused.
+   */
+  pause() {
+    if (this.paused) return;
+    this.paused = true;
+    this.stopLoop();
+  }
+  /**
+   * Restart the shared loop after `pause()`. Every registered tick's phase
+   * is reset (`lastTimestamp = null`) so the paused duration is never
+   * counted as elapsed time — the same "first pass just captures the
+   * timestamp" behavior a freshly `add()`-ed tick gets, which is what keeps
+   * resume from bursting a backlog of missed beats. A no-op if not paused.
+   */
+  resume() {
+    if (!this.paused) return;
+    this.paused = false;
+    for (const tick of this.ticks.values()) {
+      tick.lastTimestamp = null;
+    }
+    if (this.ticks.size > 0) {
+      this.ensureRunning();
+    }
+  }
   ensureRunning() {
-    if (this.running) return;
+    if (this.running || this.paused) return;
     this.running = true;
     if (this.hasRaf) {
       const loop = (timestamp) => {
@@ -208,6 +239,10 @@ var TickScheduler = class {
   }
   maybeStop() {
     if (this.ticks.size > 0 || !this.running) return;
+    this.stopLoop();
+  }
+  /** Cancel the active rAF/interval loop, if any, and clear the running flag. */
+  stopLoop() {
     this.running = false;
     if (this.frameHandle !== null) {
       if (this.hasRaf) {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { g as RuntimePatternValue, B as BindingContext, f as EvaluationContextExtensions, P as PatternProps, E as EffectHandlers, h as EffectContext, i as ExecutionEnvironment, j as EffectResult, S as ServiceCallContext, T as TraitDefinition } from './types-BaD_ox7e.js';
 export { k as BrowserFileMeta, l as BrowserFilePickerOptions, m as BrowserGeolocationOptions, n as BrowserGeolocationPosition, C as ConfigContext, o as Effect, a as EventListener, H as HANDLER_MANIFEST, I as IEventBus, b as RuntimeConfig, R as RuntimeEvent, d as TraitState, c as TransitionObserver, e as TransitionResult, U as Unsubscribe } from './types-BaD_ox7e.js';
-import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital, P as PersistenceAdapter } from './OrbitalServerRuntime-DOJDoqXu.js';
-export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, e as InMemoryPersistence, O as OrbitalEventRequest, f as OrbitalEventResponse, g as OrbitalServerRuntimeConfig, h as PreprocessOptions, i as PreprocessResult, j as PreprocessedSchema, k as ProcessEventOptions, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, o as StateMachineManager, p as collectDeclaredConfigDefaults, q as collectDeclaredEntityDefaults, r as createInitialTraitState, s as findInitialState, t as findTransition, u as getIsolatedCollectionName, v as getNamespacedEvent, w as isBrowser, x as isElectron, y as isNamespacedEvent, z as isNode, A as normalizeEventKey, B as parseNamespacedEvent, C as preprocessSchema, D as processEvent } from './OrbitalServerRuntime-DOJDoqXu.js';
+import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital, P as PersistenceAdapter } from './OrbitalServerRuntime-ut1b36Nv.js';
+export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, e as InMemoryPersistence, O as OrbitalEventRequest, f as OrbitalEventResponse, g as OrbitalServerRuntimeConfig, h as PreprocessOptions, i as PreprocessResult, j as PreprocessedSchema, k as ProcessEventOptions, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, o as StateMachineManager, p as collectDeclaredConfigDefaults, q as collectDeclaredEntityDefaults, r as createInitialTraitState, s as findInitialState, t as findTransition, u as getIsolatedCollectionName, v as getNamespacedEvent, w as isBrowser, x as isElectron, y as isNamespacedEvent, z as isNode, A as normalizeEventKey, B as parseNamespacedEvent, C as preprocessSchema, D as processEvent } from './OrbitalServerRuntime-ut1b36Nv.js';
 import { EvaluationContext, SExpressionEvaluator } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
 import { RenderBindingMarker, SExpr, RuntimeValue, TraitConfigObject, EventPayload, PatternConfig, EntityId, EntityField, EntityRow, EntityPersistence, ServiceParams, EntityAccessPolicies, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
@@ -168,6 +168,7 @@ declare class TickScheduler {
     private ticks;
     private nextId;
     private running;
+    private paused;
     private frameHandle;
     private readonly hasRaf;
     constructor();
@@ -187,8 +188,25 @@ declare class TickScheduler {
     addCron(expression: string, onDue: () => void): TickHandle;
     /** Stop every tick and the shared loop. */
     stopAll(): void;
+    /** True while the scheduler is paused (no tick callback fires and no backlog accumulates). */
+    get isPaused(): boolean;
+    /**
+     * Halt the shared loop without dropping registered ticks. No `onDue`
+     * fires again until `resume()`. A no-op if already paused.
+     */
+    pause(): void;
+    /**
+     * Restart the shared loop after `pause()`. Every registered tick's phase
+     * is reset (`lastTimestamp = null`) so the paused duration is never
+     * counted as elapsed time — the same "first pass just captures the
+     * timestamp" behavior a freshly `add()`-ed tick gets, which is what keeps
+     * resume from bursting a backlog of missed beats. A no-op if not paused.
+     */
+    resume(): void;
     private ensureRunning;
     private maybeStop;
+    /** Cancel the active rAF/interval loop, if any, and clear the running flag. */
+    private stopLoop;
     private advance;
     /** Cron ticks check calendar-match at most once a second, deduped per matching minute. */
     private advanceCron;

package/dist/index.js

@@ -1,5 +1,5 @@
-import { EffectExecutor } from './chunk-XSWRK6DN.js';
-export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-XSWRK6DN.js';
+import { EffectExecutor } from './chunk-PAEMYGKV.js';
+export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-PAEMYGKV.js';
 export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 export { CALLSITE_PAYLOAD_PREFIX, applyRowAccess, checkMutationAccess, containsBindings, createContextFromBindings, createMinimalContext, deferEntityBindings, extractBindings, interpolateProps, interpolateValue, resolveCallSitePayloadCaptures } from './chunk-ZJ62H3ES.js';
@@ -179,7 +179,7 @@ function createClientEffectHandlers(options) {
     }
   };
 }
-var NO_ROW_KEY_IS_FATAL = false;
+var NO_ROW_KEY_IS_FATAL = true;
 var effectLog = createLogger("almadar:runtime:effects");
 function createServerEffectHandlers(opts) {
   const {
@@ -384,7 +384,11 @@ function createServerEffectHandlers(opts) {
               resultData = updated ?? { id: idOrFallback, ...row };
             } else {
               effectLog.error("persist:no-row-key", { action, entityType: type });
-              if (NO_ROW_KEY_IS_FATAL) ;
+              if (NO_ROW_KEY_IS_FATAL) {
+                throw new Error(
+                  `persist ${action} ${type} resolved no row key \u2014 the id was neither on the row being written nor on the request. Bind it before the write, e.g. (set @entity.id ?row.id) on the transition that selects it.`
+                );
+              }
             }
             break;
           }
@@ -403,7 +407,11 @@ function createServerEffectHandlers(opts) {
               resultData = { id: deleteId, deleted: true };
             } else {
               effectLog.error("persist:no-row-key", { action, entityType: type });
-              if (NO_ROW_KEY_IS_FATAL) ;
+              if (NO_ROW_KEY_IS_FATAL) {
+                throw new Error(
+                  `persist ${action} ${type} resolved no row key \u2014 the id was neither on the row being written nor on the request. Bind it before the write, e.g. (set @entity.id ?row.id) on the transition that selects it.`
+                );
+              }
             }
             break;
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.68.0",
+  "version": "6.70.0",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,11 +57,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.78.0",
-    "@almadar/evaluator": "^2.43.0",
+    "@almadar/core": "^10.83.0",
+    "@almadar/evaluator": "^2.44.0",
     "@almadar/logger": "^1.12.0",
     "@almadar/server": "^2.39.0",
-    "@almadar/std": "^16.198.0"
+    "@almadar/std": "^16.203.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"