@almadar/runtime 5.4.0 → 5.5.0

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

@@ -1,6 +1,6 @@
 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, 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';
+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-ByLpy6yj.js';
+import { EventPayload, EntityRow, OrbitalSchema, Orbital, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, Entity, TraitConfig, TraitTick } from '@almadar/core';
 
 /**
  * EventBus - Platform-Agnostic Pub/Sub Implementation
@@ -797,6 +797,34 @@ declare class InMemoryPersistence implements PersistenceAdapter {
  * @packageDocumentation
  */
 
+/**
+ * Client-side effect tuple shipped in `OrbitalEventResponse.clientEffects`.
+ * Restricted to the three effect kinds the client knows how to apply to the
+ * UI: render-ui (slot mutation), navigate (route change), notify (toast).
+ * Server-only effects (persist, set, fetch, ...) execute on the server and
+ * surface their results via `effectResults` and `emittedEvents`, not here.
+ *
+ * Shape note: the wire form is broader than `RenderUIEffect` /
+ * `NavigateEffect` / `NotifyEffect` from `@almadar/core/types/effect.ts` in
+ * two places — the runtime appends an interpolated `props` object plus an
+ * optional `priority` slot to render-ui (slot 4 + 5), and `navigate` /
+ * `notify` may surface their optional argument as `undefined` rather than
+ * absent. The local union spells those variants out explicitly so consumers
+ * (ServerBridge.tsx parser, debugger inspector) get accurate completions
+ * instead of `unknown[]`.
+ *
+ * `slot` is a plain `string` in this wire shape (not `UISlot`'s literal
+ * union) because the runtime forwards the raw string from the trait's
+ * `(render-ui slot ...)` SExpr without re-validating against the registry —
+ * registry validation lives in `orbital validate` / `lolo` parse, not here.
+ */
+type ClientRenderUITuple = ['render-ui', string, PatternConfig | null] | ['render-ui', string, PatternConfig | null, ResolvedPatternProps] | ['render-ui', string, PatternConfig | null, ResolvedPatternProps | undefined, number | undefined];
+type ClientNavigateTuple = ['navigate', string] | ['navigate', string, Record<string, string> | undefined];
+type ClientNotifyTuple = ['notify', string, string | SExpr | undefined] | ['notify', string, string | SExpr | undefined, {
+    type?: string;
+}];
+type ClientEffectTuple = ClientRenderUITuple | ClientNavigateTuple | ClientNotifyTuple;
+
 /** @deprecated Use OrbitalSchema from @almadar/core */
 type RuntimeOrbitalSchema = OrbitalSchema;
 /** @deprecated Use OrbitalDefinition from @almadar/core */
@@ -852,13 +880,20 @@ interface OrbitalEventResponse {
      * typed against `@almadar/core`'s `EventPayload` — the recursive record of
      * primitive + nested EventPayload values the state machine already uses
      * internally. Kept as the single source of truth for emit-payload shape.
+     *
+     * Each entry carries a `source: BusEventSource` so the client-side
+     * ServerBridge can re-broadcast on the qualified `UI:Orbital.Trait.EVENT`
+     * bus key. Without source the re-broadcast skips the entry and downstream
+     * listeners (e.g. ContactBrowse waiting for ContactLoaded after a fetch)
+     * never fire — the dashboard-layout that ContactLoaded renders disappears.
      */
     emittedEvents: Array<{
         event: string;
         payload?: EventPayload;
+        source?: BusEventSource;
     }>;
     /** Client-side effects to execute (render-ui, navigate, notify) */
-    clientEffects?: Array<unknown>;
+    clientEffects?: ClientEffectTuple[];
     /**
      * Same effects as `clientEffects`, paired with the producing trait name.
      * Consumers that need per-trait attribution (e.g. `<TraitFrame>` resolving
@@ -869,7 +904,7 @@ interface OrbitalEventResponse {
      */
     clientEffectsByTrait?: Array<{
         traitName: string;
-        effect: unknown[];
+        effect: ClientEffectTuple;
     }>;
     /** Results from server-side effects (persist, call-service, set) */
     effectResults?: EffectResult[];
@@ -1196,4 +1231,4 @@ declare class OrbitalServerRuntime {
  */
 declare function createOrbitalServerRuntime(config?: OrbitalServerRuntimeConfig): OrbitalServerRuntime;
 
-export { preprocessSchema as A, processEvent as B, type EffectResult as C, type LoaderConfig as D, type EntitySharingMap as E, LocalPersistenceAdapter as F, OrbitalServerRuntime as G, type RuntimeTraitTick as H, type ImportChainLike as I, createOrbitalServerRuntime as J, type LoadResult as L, type OrbitalEventRequest as O, type PersistenceAdapter as P, type RegisteredOrbital as R, type SchemaLoader as S, type UnifiedLoaderOptions as U, type LoadedSchema as a, type LoadedOrbital as b, EventBus as c, type EventNamespaceMap as d, InMemoryPersistence as e, type OrbitalEventResponse as f, type OrbitalServerRuntimeConfig as g, type PreprocessOptions as h, type PreprocessResult as i, type PreprocessedSchema as j, type ProcessEventOptions as k, type RuntimeOrbital as l, type RuntimeOrbitalSchema as m, type RuntimeTrait as n, StateMachineManager as o, createInitialTraitState as p, findInitialState as q, findTransition as r, getIsolatedCollectionName as s, getNamespacedEvent as t, isBrowser as u, isElectron as v, isNamespacedEvent as w, isNode as x, normalizeEventKey as y, parseNamespacedEvent as z };
+export { preprocessSchema as A, processEvent as B, type ClientEffectTuple as C, type ClientNavigateTuple as D, type EntitySharingMap as E, type ClientNotifyTuple as F, type ClientRenderUITuple as G, type EffectResult as H, type ImportChainLike as I, type LoaderConfig as J, LocalPersistenceAdapter as K, type LoadResult as L, OrbitalServerRuntime as M, type RuntimeTraitTick as N, type OrbitalEventRequest as O, type PersistenceAdapter as P, createOrbitalServerRuntime as Q, type RegisteredOrbital as R, type SchemaLoader as S, type UnifiedLoaderOptions as U, type LoadedSchema as a, type LoadedOrbital as b, EventBus as c, type EventNamespaceMap as d, InMemoryPersistence as e, type OrbitalEventResponse as f, type OrbitalServerRuntimeConfig as g, type PreprocessOptions as h, type PreprocessResult as i, type PreprocessedSchema as j, type ProcessEventOptions as k, type RuntimeOrbital as l, type RuntimeOrbitalSchema as m, type RuntimeTrait as n, StateMachineManager as o, createInitialTraitState as p, findInitialState as q, findTransition as r, getIsolatedCollectionName as s, getNamespacedEvent as t, isBrowser as u, isElectron as v, isNamespacedEvent as w, isNode as x, normalizeEventKey as y, parseNamespacedEvent as z };

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-BrJ7m0hz.js';
-import './types-SmmabGZk.js';
+export { C as ClientEffectTuple, D as ClientNavigateTuple, F as ClientNotifyTuple, G as ClientRenderUITuple, H as EffectResult, e as InMemoryPersistence, J as LoaderConfig, K as LocalPersistenceAdapter, O as OrbitalEventRequest, f as OrbitalEventResponse, M as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, N as RuntimeTraitTick, Q as createOrbitalServerRuntime } from './OrbitalServerRuntime-BMOr7miw.js';
+import './types-ByLpy6yj.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,5 +1,5 @@
-import { createLogger, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, StateMachineManager, createContextFromBindings, validateEventPayload, formatPayloadValidationError, EffectExecutor } from './chunk-62BIUDUH.js';
-export { InMemoryPersistence } from './chunk-62BIUDUH.js';
+import { createLogger, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, StateMachineManager, createContextFromBindings, validateEventPayload, formatPayloadValidationError, EffectExecutor } from './chunk-TJKK3BLO.js';
+export { InMemoryPersistence } from './chunk-TJKK3BLO.js';
 import './chunk-PZ5AY32C.js';
 import { Router } from 'express';
 import * as fs from 'fs';
@@ -362,6 +362,7 @@ function createOsHandlers(ctx) {
 var effectLog = createLogger("almadar:runtime:effects");
 var busLog = createLogger("almadar:runtime:bus");
 var renderLog = createLogger("almadar:runtime:render-ui");
+var xOrbitalLog = createLogger("almadar:runtime:cross-orbital");
 function collectDeclaredConfigDefaults(trait) {
   if (!trait) return void 0;
   const schema = trait.config;
@@ -1128,6 +1129,14 @@ var OrbitalServerRuntime = class {
         }))
       )
     });
+    xOrbitalLog.info("processOrbitalEvent:enter", {
+      orbital: orbitalName,
+      event: request.event,
+      traitsInOrbital: registered.traits.map((t) => t.name).join(","),
+      payloadActiveTraits: JSON.stringify(
+        request.payload?.["_activeTraits"] ?? null
+      )
+    });
     const { event, payload, entityId, user } = request;
     const validationFailures = [];
     for (const trait of registered.traits) {
@@ -1240,13 +1249,19 @@ var OrbitalServerRuntime = class {
           trait: traitName
         };
         this.eventBus.emit(event, eventPayload, stamp);
-        emittedEvents.push({ event, payload: eventPayload });
+        emittedEvents.push({ event, payload: eventPayload, source: stamp });
         effectLog.debug("emit:push", {
           event,
           cumulativeEmittedCount: emittedEvents.length,
           sourceTrait: stamp.trait,
           sourceOrbital: stamp.orbital
         });
+        xOrbitalLog.info("emit:server", {
+          event,
+          sourceOrbital: stamp.orbital,
+          sourceTrait: stamp.trait,
+          dispatchOrbital: registered.schema.name
+        });
       },
       set: async (targetId, field, value) => {
         const id = targetId || entityId;