@almadar/runtime 6.12.0 → 6.14.0

package/dist/{OrbitalServerRuntime-D4UFgl5l.d.ts → OrbitalServerRuntime-Cg1CiUdz.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, C as ConfigContext, h as TraitState, j as TransitionResult, E as EvaluationContextExtensions, a as EffectHandlers } from './types-ymgqmXOq.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-GFwSbdv_.js';
 import { EventPayload, EntityRow, DeclaredTraitConfig, TraitConfig, OrbitalSchema, Orbital, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, Entity, TraitTick } from '@almadar/core';
 import { P as PersistenceAdapter } from './PersistenceAdapter-B6dQCbbU.js';
 
@@ -1104,8 +1104,23 @@ declare class OrbitalServerRuntime {
     resetMockPersistence(): void;
     /**
      * Process an event for an orbital
-     */
-    processOrbitalEvent(orbitalName: string, request: OrbitalEventRequest): Promise<OrbitalEventResponse>;
+     *
+     * @param onPush - Optional incremental-push callback. Called immediately
+     * when an event is emitted or a client effect fires, before the promise
+     * resolves. Used by the SSE streaming path to write items to the
+     * response as they arrive rather than buffering and flushing at the end.
+     */
+    processOrbitalEvent(orbitalName: string, request: OrbitalEventRequest, onPush?: (item: {
+        type: 'event';
+        data: {
+            event: string;
+            payload?: EventPayload;
+            source?: BusEventSource;
+        };
+    } | {
+        type: 'effect';
+        data: ClientEffectTuple;
+    }) => void): Promise<OrbitalEventResponse>;
     /**
      * Execute effects from a transition
      */

package/dist/OrbitalServerRuntime.d.ts

@@ -1,5 +1,5 @@
 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-D4UFgl5l.js';
-import './types-ymgqmXOq.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-Cg1CiUdz.js';
+import './types-GFwSbdv_.js';
 import '@almadar/core';
 export { I as InMemoryPersistence, P as PersistenceAdapter } from './PersistenceAdapter-B6dQCbbU.js';

package/dist/OrbitalServerRuntime.js

@@ -1,5 +1,5 @@
-import { EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, StateMachineManager, createContextFromBindings, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, EffectExecutor } from './chunk-QJ4UEHGC.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-QJ4UEHGC.js';
+import { EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, StateMachineManager, createContextFromBindings, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, EffectExecutor } from './chunk-QVGSVPYW.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-QVGSVPYW.js';
 import './chunk-PZ5AY32C.js';
 import { createLogger } from '@almadar/logger';
 import * as nodeModule from 'module';
@@ -789,8 +789,13 @@ var OrbitalServerRuntime = class {
   // ==========================================================================
   /**
    * Process an event for an orbital
+   *
+   * @param onPush - Optional incremental-push callback. Called immediately
+   * when an event is emitted or a client effect fires, before the promise
+   * resolves. Used by the SSE streaming path to write items to the
+   * response as they arrive rather than buffering and flushing at the end.
    */
-  async processOrbitalEvent(orbitalName, request) {
+  async processOrbitalEvent(orbitalName, request, onPush) {
     await this.ensureOsHandlers();
     const registered = this.orbitals.get(orbitalName);
     if (!registered) {
@@ -905,7 +910,8 @@ var OrbitalServerRuntime = class {
           clientEffects,
           effectResults,
           user,
-          clientEffectsByTrait
+          clientEffectsByTrait,
+          onPush
         );
       }
     }
@@ -933,11 +939,12 @@ var OrbitalServerRuntime = class {
   /**
    * Execute effects from a transition
    */
-  async executeEffects(registered, traitName, effects, payload, entityData, entityId, emittedEvents, fetchedData, clientEffects, effectResults, user, clientEffectsByTrait) {
+  async executeEffects(registered, traitName, effects, payload, entityData, entityId, emittedEvents, fetchedData, clientEffects, effectResults, user, clientEffectsByTrait, onPush) {
     const entityType = registered.entity.name;
     const pushClientEffect = (effect) => {
       clientEffects.push(effect);
       clientEffectsByTrait?.push({ traitName, effect });
+      onPush?.({ type: "effect", data: effect });
     };
     let bindingsRef = null;
     let contextRef = null;
@@ -956,7 +963,9 @@ var OrbitalServerRuntime = class {
           trait: traitName
         };
         this.eventBus.emit(event, eventPayload, stamp);
-        emittedEvents.push({ event, payload: eventPayload, source: stamp });
+        const emittedItem = { event, payload: eventPayload, source: stamp };
+        emittedEvents.push(emittedItem);
+        onPush?.({ type: "event", data: emittedItem });
         effectLog.debug("emit:push", {
           event,
           cumulativeEmittedCount: emittedEvents.length,
@@ -1771,15 +1780,10 @@ var OrbitalServerRuntime = class {
             ...firebaseUser,
             displayName: firebaseUser.name ?? firebaseUser.displayName
           } : void 0;
-          const result = await this.processOrbitalEvent(orbitalName, { ...req.body, user });
-          const ts = Date.now();
-          for (const emitted of result.emittedEvents) {
-            sendSSEEvent(res, { type: "event", data: emitted, timestamp: ts });
-          }
-          for (const effect of result.clientEffects ?? []) {
-            sendSSEEvent(res, { type: "effect", data: effect, timestamp: ts });
-          }
-          sendSSEEvent(res, { type: "complete", data: result, timestamp: ts });
+          const result = await this.processOrbitalEvent(orbitalName, { ...req.body, user }, (item) => {
+            sendSSEEvent(res, { type: item.type, data: item.data, timestamp: Date.now() });
+          });
+          sendSSEEvent(res, { type: "complete", data: result, timestamp: Date.now() });
           sendSSEDone(res);
           closeSSE(res);
         } catch (error) {