@almadar/runtime 6.69.0 → 6.71.0

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

@@ -1362,6 +1362,32 @@ declare class OrbitalServerRuntime {
      * Register a single orbital (sync wrapper for backward compatibility)
      */
     private registerOrbital;
+    /**
+     * The id of the SOURCE event a `listens {}` entry names, derived from the
+     * emitting trait's own declared `emits[]` contract rather than trusted
+     * from `listener.eventId` alone.
+     *
+     * `TraitEventListener.eventId` is "optional until the Phase-7 flip" (see
+     * `@almadar/core`'s `trait.ts`) — the compose/resolve pipeline stamps a
+     * V4 ledger id onto every `emits[]` entry (the emitter's own contract)
+     * well before it stamps the matching id onto every `listens[]` entry that
+     * names that event (source-qualified `Trait.EVENT -> X` listens compiled
+     * from `uses`-resolved atoms carry `triggersId` for their OWN triggered
+     * event but no `eventId` for the event they're listening to). The emit
+     * handler (`executeEffects`'s `emit` closure below) always looks up and
+     * stamps `emittingTrait.emits[].eventId` when present, so during that
+     * transitional window the emit side routes under an id-qualified bus key
+     * while the listen side — reading only its own possibly-absent
+     * `eventId` — subscribes under the bare name, and the two never meet.
+     *
+     * Fix: derive the SAME id the emitter will stamp by resolving the
+     * listener's declared `source` (trait/orbital, name or id) to the actual
+     * registered trait and reading ITS `emits[]` contract for `listener.event`
+     * — the single canonical place an event's id lives. `kind: "any"` sources
+     * are left alone (no single emitter to resolve against; bare-name routing
+     * is already the correct, safe default there).
+     */
+    private resolveSourceEmitEventId;
     /**
      * Set up event listeners for cross-orbital communication
      */
@@ -1553,6 +1579,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-DnDJhpLS.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';
@@ -760,6 +760,40 @@ var OrbitalServerRuntime = class {
       });
     });
   }
+  /**
+   * The id of the SOURCE event a `listens {}` entry names, derived from the
+   * emitting trait's own declared `emits[]` contract rather than trusted
+   * from `listener.eventId` alone.
+   *
+   * `TraitEventListener.eventId` is "optional until the Phase-7 flip" (see
+   * `@almadar/core`'s `trait.ts`) — the compose/resolve pipeline stamps a
+   * V4 ledger id onto every `emits[]` entry (the emitter's own contract)
+   * well before it stamps the matching id onto every `listens[]` entry that
+   * names that event (source-qualified `Trait.EVENT -> X` listens compiled
+   * from `uses`-resolved atoms carry `triggersId` for their OWN triggered
+   * event but no `eventId` for the event they're listening to). The emit
+   * handler (`executeEffects`'s `emit` closure below) always looks up and
+   * stamps `emittingTrait.emits[].eventId` when present, so during that
+   * transitional window the emit side routes under an id-qualified bus key
+   * while the listen side — reading only its own possibly-absent
+   * `eventId` — subscribes under the bare name, and the two never meet.
+   *
+   * Fix: derive the SAME id the emitter will stamp by resolving the
+   * listener's declared `source` (trait/orbital, name or id) to the actual
+   * registered trait and reading ITS `emits[]` contract for `listener.event`
+   * — the single canonical place an event's id lives. `kind: "any"` sources
+   * are left alone (no single emitter to resolve against; bare-name routing
+   * is already the correct, safe default there).
+   */
+  resolveSourceEmitEventId(source, event, listenerOrbital) {
+    if (!source || source.kind === "any") return void 0;
+    const ownerOrbitalName = source.kind === "orbital" ? source.orbital : listenerOrbital;
+    const owner = this.orbitals.get(ownerOrbitalName);
+    if (!owner) return void 0;
+    const sourceTrait = source.traitId !== void 0 ? owner.traits.find((t) => t.id === source.traitId) : owner.traits.find((t) => t.name === source.trait);
+    if (!sourceTrait) return void 0;
+    return sourceTrait.emits?.find((e) => e.event === event)?.eventId;
+  }
   /**
    * Set up event listeners for cross-orbital communication
    */
@@ -773,7 +807,8 @@ var OrbitalServerRuntime = class {
         if (!trait.listens) continue;
         for (const listener of trait.listens) {
           const { bareEvent, matcher } = parseListenSource(listener, orbitalName);
-          const routeKey = eventRouteKey(bareEvent, listener.eventId);
+          const effectiveEventId = listener.eventId ?? this.resolveSourceEmitEventId(listener.source, bareEvent, orbitalName);
+          const routeKey = eventRouteKey(bareEvent, effectiveEventId);
           const cleanup = this.eventBus.on(routeKey, async (event) => {
             if (!matcher(event.source)) return;
             if (event.source?.originClientId !== void 0) {
@@ -2418,6 +2453,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-DnDJhpLS.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-DnDJhpLS.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';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.69.0",
+  "version": "6.71.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.79.0",
-    "@almadar/evaluator": "^2.43.0",
+    "@almadar/core": "^10.84.0",
+    "@almadar/evaluator": "^2.44.0",
     "@almadar/logger": "^1.12.0",
     "@almadar/server": "^2.39.0",
-    "@almadar/std": "^16.199.0"
+    "@almadar/std": "^16.204.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"