@almadar/runtime 6.0.4 → 6.2.0

package/dist/{OrbitalServerRuntime-D0ciuYXu.d.ts → OrbitalServerRuntime-BMRm0DUS.d.ts}

@@ -263,9 +263,16 @@ declare class StateMachineManager {
     /**
      * Send an event to all traits.
      *
+     * `entityByTrait` lets callers supply per-trait entity rows for guard
+     * evaluation when traits accumulate scalar state via `(set @entity.X)`
+     * effects across transitions. The runtime UI hook builds this map from
+     * its `traitFieldStatesRef` before each dispatch so guards reading
+     * `@entity.X` see prior step writes — required for [runtime] entities
+     * that have no persistence row to reload.
+     *
      * @returns Array of transition results (one per trait that had a matching transition)
      */
-    sendEvent(eventKey: string, payload?: EventPayload, entityData?: EntityRow): Array<{
+    sendEvent(eventKey: string, payload?: EventPayload, entityData?: EntityRow, entityByTrait?: Record<string, EntityRow>): Array<{
         traitName: string;
         result: TransitionResult;
     }>;
@@ -276,7 +283,7 @@ declare class StateMachineManager {
      * trait to process them sequentially (actor-model guarantee: one event
      * at a time per trait, effects fully awaited before the next event).
      */
-    enqueueEvent(eventKey: string, payload?: EventPayload, entityData?: EntityRow): void;
+    enqueueEvent(eventKey: string, payload?: EventPayload, entityData?: EntityRow, entityByTrait?: Record<string, EntityRow>): void;
     /**
      * Drain a single (trait, entity) pair's event queue, processing
      * events sequentially. Pass `entityId` to drain a specific entity

package/dist/OrbitalServerRuntime.d.ts

@@ -1,5 +1,5 @@
 import '@almadar/core';
 import 'express';
-export { C as ClientEffectTuple, B as ClientNavigateTuple, D as ClientNotifyTuple, F as ClientRenderUITuple, G as EffectResult, H as LoaderConfig, O as OrbitalEventRequest, e as OrbitalEventResponse, J as OrbitalServerRuntime, f as OrbitalServerRuntimeConfig, R as RegisteredOrbital, j as RuntimeOrbital, k as RuntimeOrbitalSchema, l as RuntimeTrait, K as RuntimeTraitTick, n as collectDeclaredConfigDefaults, M as createOrbitalServerRuntime } from './OrbitalServerRuntime-D0ciuYXu.js';
+export { C as ClientEffectTuple, B as ClientNavigateTuple, D as ClientNotifyTuple, F as ClientRenderUITuple, G as EffectResult, H as LoaderConfig, O as OrbitalEventRequest, e as OrbitalEventResponse, J as OrbitalServerRuntime, f as OrbitalServerRuntimeConfig, R as RegisteredOrbital, j as RuntimeOrbital, k as RuntimeOrbitalSchema, l as RuntimeTrait, K as RuntimeTraitTick, n as collectDeclaredConfigDefaults, M as createOrbitalServerRuntime } from './OrbitalServerRuntime-BMRm0DUS.js';
 import './types-cuy5gd29.js';
 export { I as InMemoryPersistence, P as PersistenceAdapter } from './PersistenceAdapter-B6dQCbbU.js';

package/dist/OrbitalServerRuntime.js

@@ -1,4 +1,4 @@
-export { InMemoryPersistence, OrbitalServerRuntime, collectDeclaredConfigDefaults, createOrbitalServerRuntime } from './chunk-BA4E5MG4.js';
+export { InMemoryPersistence, OrbitalServerRuntime, collectDeclaredConfigDefaults, createOrbitalServerRuntime } from './chunk-P3WRK4G3.js';
 import './chunk-PZ5AY32C.js';
 //# sourceMappingURL=OrbitalServerRuntime.js.map
 //# sourceMappingURL=OrbitalServerRuntime.js.map

package/dist/{chunk-BA4E5MG4.js → chunk-P3WRK4G3.js}

@@ -692,21 +692,29 @@ var StateMachineManager = class {
   /**
    * Send an event to all traits.
    *
+   * `entityByTrait` lets callers supply per-trait entity rows for guard
+   * evaluation when traits accumulate scalar state via `(set @entity.X)`
+   * effects across transitions. The runtime UI hook builds this map from
+   * its `traitFieldStatesRef` before each dispatch so guards reading
+   * `@entity.X` see prior step writes — required for [runtime] entities
+   * that have no persistence row to reload.
+   *
    * @returns Array of transition results (one per trait that had a matching transition)
    */
-  sendEvent(eventKey, payload, entityData) {
+  sendEvent(eventKey, payload, entityData, entityByTrait) {
     const results = [];
     const scope = scopeOf(entityData);
     for (const [traitName, trait] of this.traits) {
       const traitState = this.getOrInitState(traitName, scope);
       if (!traitState) continue;
       const key = compositeKey(traitName, scope);
+      const perTraitEntity = entityByTrait?.[traitName] ?? entityData;
       const result = processEvent({
         traitState,
         trait,
         eventKey,
         payload,
-        entityData,
+        entityData: perTraitEntity,
         config: this.traitConfigs.get(traitName),
         guardMode: this.config.guardMode,
         strictBindings: this.config.strictBindings,
@@ -746,12 +754,12 @@ var StateMachineManager = class {
    * trait to process them sequentially (actor-model guarantee: one event
    * at a time per trait, effects fully awaited before the next event).
    */
-  enqueueEvent(eventKey, payload, entityData) {
+  enqueueEvent(eventKey, payload, entityData, entityByTrait) {
     const scope = scopeOf(entityData);
     for (const [traitName] of this.traits) {
       const key = compositeKey(traitName, scope);
       const queue = this.queues.get(key) ?? [];
-      queue.push({ eventKey, payload, entityData });
+      queue.push({ eventKey, payload, entityData, entityByTrait });
       this.queues.set(key, queue);
     }
   }
@@ -771,12 +779,13 @@ var StateMachineManager = class {
       const trait = this.traits.get(traitName);
       const traitState = this.getOrInitState(traitName, scope);
       if (!trait || !traitState) continue;
+      const perTraitEntity = entry.entityByTrait?.[traitName] ?? entry.entityData;
       const result = processEvent({
         traitState,
         trait,
         eventKey: entry.eventKey,
         payload: entry.payload,
-        entityData: entry.entityData,
+        entityData: perTraitEntity,
         config: this.traitConfigs.get(traitName),
         guardMode: this.config.guardMode,
         strictBindings: this.config.strictBindings,
@@ -1732,6 +1741,10 @@ function buildEmitsFromTraits(traits, explicitEmits) {
 }
 var mockLog = createLogger("almadar:runtime:mock");
 var DEFAULT_MOCK_SEED = 42;
+function picsumUrl(entityName, fieldName, width = 400, height = 400) {
+  const seed = `${entityName}-${fieldName}-${faker.number.int({ min: 0, max: 1e3 })}`;
+  return `https://picsum.photos/seed/${encodeURIComponent(seed)}/${width}/${height}`;
+}
 var SEED_REFERENCE_TIMESTAMP = "2024-01-01T00:00:00.000Z";
 var MockPersistenceAdapter = class {
   stores = /* @__PURE__ */ new Map();
@@ -1922,18 +1935,24 @@ var MockPersistenceAdapter = class {
         return faker.date.recent().toISOString().split("T")[0];
       case "datetime":
         return faker.date.recent().toISOString();
-      default: {
-        const value = faker.lorem.words(2);
-        mockLog.warn("field:fallback-lorem", {
-          entityName,
-          fieldName: field.name,
-          hasValues: false,
-          format: field.format ?? null,
-          generated: value
-        });
-        return value;
-      }
+      case "image":
+      case "avatar":
+      case "thumbnail":
+        return picsumUrl(entityName, field.name);
     }
+    const lname = field.name.toLowerCase();
+    if (lname === "image" || lname === "imageurl" || lname === "image_url" || lname === "photo" || lname === "photourl" || lname === "photo_url" || lname === "avatar" || lname === "avatarurl" || lname === "avatar_url" || lname === "thumbnail" || lname === "thumbnailurl" || lname === "thumbnail_url" || lname === "picture" || lname === "pictureurl" || lname === "cover" || lname === "coverurl" || lname === "banner" || lname === "bannerurl") {
+      return picsumUrl(entityName, field.name);
+    }
+    const value = faker.lorem.words(2);
+    mockLog.warn("field:fallback-lorem", {
+      entityName,
+      fieldName: field.name,
+      hasValues: false,
+      format: field.format ?? null,
+      generated: value
+    });
+    return value;
   }
   /**
    * Generate a date value. Uses the field's `format` (date vs datetime) to
@@ -4419,7 +4438,18 @@ var OrbitalServerRuntime = class {
         entityData = stored;
       }
     }
-    const results = registered.manager.sendEvent(event, cleanPayload, entityData);
+    const entityByTrait = {};
+    for (const [name, fields] of registered.traitFieldStates) {
+      if (fields && Object.keys(fields).length > 0) {
+        entityByTrait[name] = fields;
+      }
+    }
+    const results = registered.manager.sendEvent(
+      event,
+      cleanPayload,
+      entityData,
+      entityByTrait
+    );
     const filteredResults = activeTraits && activeTraits.length > 0 ? results.filter(({ traitName }) => activeTraits.includes(traitName)) : results;
     if (this.config.debug && activeTraits) {
       console.log(`[OrbitalRuntime] Filtering traits: ${results.length} total, ${filteredResults.length} active (${activeTraits.join(", ")})`);
@@ -5342,5 +5372,5 @@ function buildMatcher(src, listenerOrbital) {
 }
 
 export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, OrbitalServerRuntime, StateMachineManager, buildEmitsFromTraits, collectDeclaredConfigDefaults, containsBindings, createContextFromBindings, createInitialTraitState, createLogger, createMockPersistence, createOrbitalServerRuntime, createTestExecutor, createUnifiedLoader, extractBindings, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, normalizeEventKey, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes };
-//# sourceMappingURL=chunk-BA4E5MG4.js.map
-//# sourceMappingURL=chunk-BA4E5MG4.js.map
+//# sourceMappingURL=chunk-P3WRK4G3.js.map
+//# sourceMappingURL=chunk-P3WRK4G3.js.map