@almadar/runtime 3.3.0 → 4.0.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { B as BindingContext, E as EvaluationContextExtensions, P as PatternProps, a as EffectHandlers, b as EffectContext, c as ExecutionEnvironment, d as EffectResult, T as TraitDefinition } from './types-B8OfRFfV.js';
-export { e as Effect, f as EventListener, H as HANDLER_MANIFEST, I as IEventBus, R as RuntimeConfig, g as RuntimeEvent, h as TraitState, i as TransitionObserver, j as TransitionResult, U as Unsubscribe } from './types-B8OfRFfV.js';
-import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital } from './OrbitalServerRuntime-DMRvEfcT.js';
-export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, O as OrbitalEventRequest, e as OrbitalEventResponse, f as OrbitalServerRuntimeConfig, P as PersistenceAdapter, g as PreprocessOptions, h as PreprocessResult, i as PreprocessedSchema, j as ProcessEventOptions, R as RegisteredOrbital, k as RuntimeOrbital, l as RuntimeOrbitalSchema, m as RuntimeTrait, n as StateMachineManager, o as createInitialTraitState, p as findInitialState, q as findTransition, r as getIsolatedCollectionName, s as getNamespacedEvent, t as isBrowser, u as isElectron, v as isNamespacedEvent, w as isNode, x as normalizeEventKey, y as parseNamespacedEvent, z as preprocessSchema, A as processEvent } from './OrbitalServerRuntime-DMRvEfcT.js';
+import { B as BindingContext, E as EvaluationContextExtensions, P as PatternProps, a as EffectHandlers, b as EffectContext, c as ExecutionEnvironment, d as EffectResult, T as TraitDefinition } from './types-CVSBlnzV.js';
+export { e as Effect, f as EventListener, H as HANDLER_MANIFEST, I as IEventBus, R as RuntimeConfig, g as RuntimeEvent, h as TraitState, i as TransitionObserver, j as TransitionResult, U as Unsubscribe } from './types-CVSBlnzV.js';
+import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital } from './OrbitalServerRuntime-DMe0zqCc.js';
+export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, O as OrbitalEventRequest, e as OrbitalEventResponse, f as OrbitalServerRuntimeConfig, P as PersistenceAdapter, g as PreprocessOptions, h as PreprocessResult, i as PreprocessedSchema, j as ProcessEventOptions, R as RegisteredOrbital, k as RuntimeOrbital, l as RuntimeOrbitalSchema, m as RuntimeTrait, n as StateMachineManager, o as createInitialTraitState, p as findInitialState, q as findTransition, r as getIsolatedCollectionName, s as getNamespacedEvent, t as isBrowser, u as isElectron, v as isNamespacedEvent, w as isNode, x as normalizeEventKey, y as parseNamespacedEvent, z as preprocessSchema, A as processEvent } from './OrbitalServerRuntime-DMe0zqCc.js';
 import { EvaluationContext } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
 import { EventPayload, EntityRow, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
@@ -290,6 +290,8 @@ declare class EffectExecutor {
      */
     executeWithResults(effects: unknown[]): Promise<EffectResult[]>;
     private extractEmitConfig;
+    /** Build the source metadata stamp for an emit fired from this trait. */
+    private sourceStamp;
     private emitSuccess;
     private emitFailure;
     /**

package/dist/index.js

@@ -1,4 +1,4 @@
-export { EffectExecutor, EventBus, HANDLER_MANIFEST, StateMachineManager, containsBindings, createContextFromBindings, createInitialTraitState, createMinimalContext, createTestExecutor, createUnifiedLoader, extractBindings, findInitialState, findTransition, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, normalizeEventKey, parseNamespacedEvent, preprocessSchema, processEvent } from './chunk-II3JSETH.js';
+export { EffectExecutor, EventBus, HANDLER_MANIFEST, StateMachineManager, containsBindings, createContextFromBindings, createInitialTraitState, createMinimalContext, createTestExecutor, createUnifiedLoader, extractBindings, findInitialState, findTransition, getIsolatedCollectionName, getNamespacedEvent, interpolateProps, interpolateValue, isBrowser, isElectron, isNamespacedEvent, isNode, normalizeEventKey, parseNamespacedEvent, preprocessSchema, processEvent } from './chunk-7WP4AE6X.js';
 import { __export } from './chunk-PZ5AY32C.js';
 import { isInlineTrait } from '@almadar/core';
 

package/dist/{types-B8OfRFfV.d.ts → types-CVSBlnzV.d.ts}

@@ -115,8 +115,16 @@ interface TraitDefinition {
  * Server: Express, database, integrators
  */
 interface EffectHandlers {
-    /** Emit an event to the event bus */
-    emit: (event: string, payload?: EventPayload) => void;
+    /**
+     * Emit an event to the event bus.
+     *
+     * `source` carries the emitter's identity (orbital + trait) so that
+     * source-scoped listeners (`TraitName EVENT -> TRIGGER` and
+     * `Orbital.TraitName EVENT -> TRIGGER` in .lolo) can filter incoming
+     * events by their originating trait. Omitted when the emit is
+     * synthesized by a non-trait context (e.g. test harness).
+     */
+    emit: (event: string, payload?: EventPayload, source?: RuntimeEvent['source']) => void;
     /** Persist data (create/update/delete/batch) */
     persist: (action: 'create' | 'update' | 'delete' | 'batch', entityType: string, data?: EntityRow) => Promise<void>;
     /** Set a field value on an entity */
@@ -235,6 +243,11 @@ type Effect = [string, ...unknown[]];
 interface EffectContext {
     /** Trait name */
     traitName: string;
+    /** Orbital that owns the firing trait. Used to stamp the source
+     * metadata on emits so source-scoped listens (`TraitName EVENT` for
+     * intra-orbital, `Orbital.TraitName EVENT` for cross-orbital) can
+     * filter by emitter identity. */
+    orbitalName?: string;
     /** Current state */
     state: string;
     /** Transition description */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "3.3.0",
+  "version": "4.0.1",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,7 +38,7 @@
   "dependencies": {
     "@almadar/evaluator": ">=2.8.1",
     "@almadar/std": ">=6.5.0",
-    "@almadar/core": ">=4.8.2",
+    "@almadar/core": ">=5.0.0",
     "@faker-js/faker": "^9.3.0"
   },
   "peerDependencies": {