@almadar/runtime 5.0.0 → 5.2.0

package/dist/{OrbitalServerRuntime-D-b_dg8I.d.ts → OrbitalServerRuntime-BrJ7m0hz.d.ts}

@@ -1,5 +1,5 @@
 import { Router } from 'express';
-import { I as IEventBus, g as RuntimeEvent, f as EventListener, U as Unsubscribe, T as TraitDefinition, R as RuntimeConfig, i as TransitionObserver, h as TraitState, j as TransitionResult, E as EvaluationContextExtensions, a as EffectHandlers } from './types-DwDhc9Jt.js';
+import { I as IEventBus, g as RuntimeEvent, f as EventListener, U as Unsubscribe, T as TraitDefinition, R as RuntimeConfig, i as TransitionObserver, C as ConfigContext, h as TraitState, j as TransitionResult, E as EvaluationContextExtensions, a as EffectHandlers } from './types-SmmabGZk.js';
 import { EventPayload, EntityRow, OrbitalSchema, Orbital, Trait, OrbitalDefinition, Entity, TraitConfig, TraitTick } from '@almadar/core';
 
 /**
@@ -121,6 +121,17 @@ interface ProcessEventOptions {
     payload?: EventPayload;
     /** Entity data for binding resolution */
     entityData?: EntityRow;
+    /**
+     * Trait config for `@config.X` resolution inside guard expressions.
+     * Surfaced on the EvaluationContext so guards can write mode-aware
+     * predicates — e.g. std-modal's OPEN can require `@payload.row` only
+     * when `@config.mode === "edit"`. The validator (sigil_context.rs)
+     * allows `@config` in guard context as of v3.12.0; this field is
+     * the runtime side of the same contract. Threaded by the caller
+     * (typically `OrbitalServerRuntime.processEvent` reading from the
+     * trait's `RegisteredOrbital.configByTrait`).
+     */
+    config?: ConfigContext;
     /**
      * Guard evaluation error handling mode. (RCG-02)
      * - "permissive": Guard errors allow the transition (default, backwards-compatible)
@@ -169,6 +180,15 @@ interface ProcessEventOptions {
 declare function processEvent(options: ProcessEventOptions): TransitionResult;
 declare class StateMachineManager {
     private traits;
+    /**
+     * Per-trait call-site config, surfaced to guard expressions so
+     * `@config.X` resolves at runtime. Populated by the orbital's
+     * registration step (see `OrbitalServerRuntime.registerOrbital`'s
+     * `configByTrait` projection). Empty for atom-scope traits whose
+     * call-site config wasn't supplied — guards that read `@config.X`
+     * in that case will see `undefined` and short-circuit accordingly.
+     */
+    private traitConfigs;
     /**
      * State map keyed by `${traitName}::${entityId | __singleton__}`.
      *
@@ -198,6 +218,13 @@ declare class StateMachineManager {
      * Add a trait to the manager.
      */
     addTrait(trait: TraitDefinition): void;
+    /**
+     * Bind the call-site config for a trait so guard `@config.X`
+     * resolves at runtime. Typically called by the orbital
+     * registration step right after `addTrait`. Idempotent; passing
+     * `undefined` clears the binding.
+     */
+    setTraitConfig(traitName: string, config: ConfigContext | undefined): void;
     /**
      * Remove a trait from the manager.
      */

package/dist/OrbitalServerRuntime.d.ts

@@ -1,4 +1,4 @@
 import 'express';
-export { C as EffectResult, e as InMemoryPersistence, D as LoaderConfig, F as LocalPersistenceAdapter, O as OrbitalEventRequest, f as OrbitalEventResponse, G as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, H as RuntimeTraitTick, J as createOrbitalServerRuntime } from './OrbitalServerRuntime-D-b_dg8I.js';
-import './types-DwDhc9Jt.js';
+export { C as EffectResult, e as InMemoryPersistence, D as LoaderConfig, F as LocalPersistenceAdapter, O as OrbitalEventRequest, f as OrbitalEventResponse, G as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, H as RuntimeTraitTick, J as createOrbitalServerRuntime } from './OrbitalServerRuntime-BrJ7m0hz.js';
+import './types-SmmabGZk.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,5 +1,5 @@
-import { EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, StateMachineManager, createContextFromBindings, EffectExecutor } from './chunk-S5OLFFHT.js';
-export { InMemoryPersistence } from './chunk-S5OLFFHT.js';
+import { createLogger, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, StateMachineManager, createContextFromBindings, validateEventPayload, formatPayloadValidationError, EffectExecutor } from './chunk-OG2NHXES.js';
+export { InMemoryPersistence } from './chunk-OG2NHXES.js';
 import './chunk-PZ5AY32C.js';
 import { Router } from 'express';
 import * as fs from 'fs';
@@ -359,6 +359,8 @@ function createOsHandlers(ctx) {
 }
 
 // src/OrbitalServerRuntime.ts
+var effectLog = createLogger("almadar:runtime:effects");
+var renderLog = createLogger("almadar:runtime:render-ui");
 function collectDeclaredConfigDefaults(trait) {
   if (!trait) return void 0;
   const schema = trait.config;
@@ -751,6 +753,9 @@ var OrbitalServerRuntime = class {
     const manager = new StateMachineManager(traitDefs, {
       contextExtensions: this.config.contextExtensions
     });
+    for (const [traitName, traitConfig] of configByTrait) {
+      manager.setTraitConfig(traitName, traitConfig);
+    }
     const entityRef = orbital.entity;
     let entity;
     if (typeof entityRef === "string") {
@@ -1096,7 +1101,35 @@ var OrbitalServerRuntime = class {
         error: `Orbital not found: ${orbitalName}`
       };
     }
+    const payloadRow = request.payload?.["row"];
+    const payloadRowAsPayload = payloadRow !== null && typeof payloadRow === "object" && !Array.isArray(payloadRow) ? payloadRow : void 0;
+    const payloadRowId = payloadRowAsPayload?.["id"];
+    renderLog.debug("processOrbitalEvent:enter", {
+      orbital: orbitalName,
+      event: request.event,
+      hasPayloadRow: payloadRowAsPayload !== void 0,
+      payloadRowId: typeof payloadRowId === "string" || typeof payloadRowId === "number" ? payloadRowId : void 0,
+      entityId: request.entityId
+    });
     const { event, payload, entityId, user } = request;
+    const validationFailures = [];
+    for (const trait of registered.traits) {
+      const eventSchema = trait.stateMachine?.events?.find((e) => e.key === event);
+      if (eventSchema?.payloadSchema && eventSchema.payloadSchema.length > 0) {
+        validationFailures.push(
+          ...validateEventPayload(event, payload, eventSchema.payloadSchema)
+        );
+      }
+    }
+    if (validationFailures.length > 0) {
+      return {
+        success: false,
+        transitioned: false,
+        states: {},
+        emittedEvents: [],
+        error: formatPayloadValidationError(validationFailures)
+      };
+    }
     const emittedEvents = [];
     const fetchedData = {};
     const clientEffects = [];
@@ -1191,6 +1224,12 @@ var OrbitalServerRuntime = class {
         };
         this.eventBus.emit(event, eventPayload, stamp);
         emittedEvents.push({ event, payload: eventPayload });
+        effectLog.debug("emit:push", {
+          event,
+          cumulativeEmittedCount: emittedEvents.length,
+          sourceTrait: stamp.trait,
+          sourceOrbital: stamp.orbital
+        });
       },
       set: async (targetId, field, value) => {
         const id = targetId || entityId;
@@ -1289,6 +1328,7 @@ var OrbitalServerRuntime = class {
         }
         const type = targetEntityType || entityType;
         let resultData;
+        const sizeBefore = (await this.persistence.list(type)).length;
         try {
           if (action === "create" || action === "update") {
             this.validateRelationCardinality(type, data || {});
@@ -1319,6 +1359,15 @@ var OrbitalServerRuntime = class {
               break;
             }
           }
+          const sizeAfter = (await this.persistence.list(type)).length;
+          effectLog.debug("persist:store-mutate", {
+            action,
+            entityType: type,
+            resultId: resultData?.id,
+            sizeBefore,
+            sizeAfter,
+            delta: sizeAfter - sizeBefore
+          });
           effectResults.push({
             effect: "persist",
             action,
@@ -1327,6 +1376,11 @@ var OrbitalServerRuntime = class {
             success: true
           });
         } catch (err) {
+          effectLog.error("persist:store-mutate-error", {
+            action,
+            entityType: type,
+            error: err instanceof Error ? err.message : String(err)
+          });
           effectResults.push({
             effect: "persist",
             action,
@@ -1555,6 +1609,17 @@ var OrbitalServerRuntime = class {
       },
       // Client-side effects - collect for forwarding to client
       renderUI: (slot, pattern, props, priority) => {
+        const patternNode = pattern !== null && typeof pattern === "object" && !Array.isArray(pattern) ? pattern : null;
+        const patternEntity = patternNode?.entity;
+        const entityRow = patternEntity !== null && typeof patternEntity === "object" && !Array.isArray(patternEntity) ? patternEntity : null;
+        const patternTypeRaw = patternNode?.["type"];
+        renderLog.debug("renderUI:push", {
+          trait: traitName,
+          slot,
+          patternType: typeof patternTypeRaw === "string" ? patternTypeRaw : void 0,
+          entityRowId: typeof entityRow?.id === "string" ? entityRow.id : void 0,
+          entityIsObject: entityRow !== null
+        });
         pushClientEffect(["render-ui", slot, pattern, props, priority]);
       },
       navigate: (path2, params) => {