@almadar/runtime 6.32.0 → 6.34.0

package/dist/{OrbitalServerRuntime-DpAwIrmv.d.ts → OrbitalServerRuntime-BrHSXDfp.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-D-9feVsj.js';
-import { EventPayload, EntityRow, Orbital, ServiceCallResult, TraitConfig, DeclaredTraitConfig, Entity, CallSiteConfig, OrbitalSchema, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, TraitTick } from '@almadar/core';
+import { I as IEventBus, R as RuntimeEvent, a as EventListener, U as Unsubscribe, T as TraitDefinition, b as RuntimeConfig, c as TransitionObserver, d as TraitState, C as ConfigContext, e as TransitionResult, f as EvaluationContextExtensions, E as EffectHandlers } from './types-C8RsO0xa.js';
+import { EventPayload, EventId, EntityRow, Orbital, ServiceCallResult, TraitConfig, DeclaredTraitConfig, Entity, OrbitalSchema, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, TraitTick } from '@almadar/core';
 
 /**
  * EventBus - Platform-Agnostic Pub/Sub Implementation
@@ -47,7 +47,7 @@ declare class EventBus implements IEventBus {
      * beyond `maxDepth`, the event is dropped and an error is logged.
      * This prevents infinite loops from circular emit/listen chains.
      */
-    emit(type: string, payload?: EventPayload, source?: RuntimeEvent['source']): void;
+    emit(type: string, payload?: EventPayload, source?: RuntimeEvent['source'], routingKey?: string): void;
     /**
      * Subscribe to an event type
      */
@@ -101,7 +101,7 @@ declare function createInitialTraitState(trait: TraitDefinition): TraitState;
  * when multiple sibling transitions share the same `from`/`event` and
  * disambiguate by guard.
  */
-declare function findTransition(trait: TraitDefinition, currentState: string, eventKey: string): TraitDefinition['transitions'][0] | undefined;
+declare function findTransition(trait: TraitDefinition, currentState: string, eventKey: string, eventId?: EventId): TraitDefinition['transitions'][0] | undefined;
 /**
  * Normalize event key - strip UI: prefix if present.
  */
@@ -116,6 +116,12 @@ interface ProcessEventOptions {
     trait: TraitDefinition;
     /** Event key to process */
     eventKey: string;
+    /**
+     * V4 dual-carry id sibling of `eventKey` — the id of the fired event,
+     * when known. Threaded to `findMatchingTransitions` for id-primary
+     * matching; absent means name-only dispatch (legacy).
+     */
+    eventId?: EventId;
     /** Event payload */
     payload?: EventPayload;
     /** Entity data for binding resolution */
@@ -179,6 +185,15 @@ interface ProcessEventOptions {
 declare function processEvent(options: ProcessEventOptions): TransitionResult;
 declare class StateMachineManager {
     private traits;
+    /**
+     * V4 identity index: trait id → trait name. Populated for traits that
+     * carry an `id` (ledger-backed schemas). Lets callers resolve a trait's
+     * state by its stable id, which survives a mid-session rename — the
+     * name-keyed maps are re-pointed on rename via {@link renameTrait}, but
+     * an id holder never has to observe the rename at all. Empty for legacy
+     * id-free schemas, where every lookup stays name-keyed (unchanged).
+     */
+    private traitIdToName;
     /**
      * Per-trait call-site config, surfaced to guard expressions so
      * `@config.X` resolves at runtime. Populated by the orbital's
@@ -217,6 +232,26 @@ declare class StateMachineManager {
      * Add a trait to the manager.
      */
     addTrait(trait: TraitDefinition): void;
+    /**
+     * Resolve a trait by its V4 id. Returns undefined when no trait carries
+     * that id (legacy schema, or unknown id). Exact-match only — no name
+     * similarity.
+     */
+    getTraitById(traitId: string): TraitDefinition | undefined;
+    /**
+     * Get a trait's current state by its V4 id (id-first lookup). Falls back
+     * to `undefined` when the id is unknown. The id survives a rename, so a
+     * holder of the id reads the right state without ever seeing the new name.
+     */
+    getStateById(traitId: string, entityId?: string): TraitState | undefined;
+    /**
+     * Apply a mid-session trait rename: re-point the name-keyed maps from
+     * `oldName` to `newName`, preserving live state, queues, and the id
+     * index. A no-op when the trait isn't registered under `oldName`. This
+     * is the interpreter-side of a ledger `curName` edit for the trait's own
+     * name-keyed storage; id-keyed references need no update.
+     */
+    renameTrait(oldName: string, newName: string): void;
     /**
      * Bind the call-site config for a trait so guard `@config.X`
      * resolves at runtime. Typically called by the orbital
@@ -256,7 +291,7 @@ declare class StateMachineManager {
     /**
      * Check if a trait can handle an event from its current state.
      */
-    canHandleEvent(traitName: string, eventKey: string, entityId?: string): boolean;
+    canHandleEvent(traitName: string, eventKey: string, entityId?: string, eventId?: EventId): boolean;
     /**
      * Send an event to all traits.
      *
@@ -267,9 +302,13 @@ declare class StateMachineManager {
      * `@entity.X` see prior step writes — required for [runtime] entities
      * that have no persistence row to reload.
      *
+     * `eventId` is the V4 dual-carry id sibling of `eventKey` (see
+     * {@link ProcessEventOptions.eventId}) — additive and optional, threaded
+     * through to `processEvent` for id-primary transition matching.
+     *
      * @returns Array of transition results (one per trait that had a matching transition)
      */
-    sendEvent(eventKey: string, payload?: EventPayload, entityData?: EntityRow, entityByTrait?: Record<string, EntityRow>): Array<{
+    sendEvent(eventKey: string, payload?: EventPayload, entityData?: EntityRow, entityByTrait?: Record<string, EntityRow>, eventId?: EventId): Array<{
         traitName: string;
         result: TransitionResult;
     }>;
@@ -280,7 +319,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, entityByTrait?: Record<string, EntityRow>): void;
+    enqueueEvent(eventKey: string, payload?: EventPayload, entityData?: EntityRow, entityByTrait?: Record<string, EntityRow>, eventId?: EventId): void;
     /**
      * Drain a single (trait, entity) pair's event queue, processing
      * events sequentially. Pass `entityId` to drain a specific entity
@@ -358,17 +397,6 @@ interface SubstrateServices {
 declare function collectDeclaredConfigDefaults(trait: {
     config?: DeclaredTraitConfig;
 } | undefined): TraitConfig | undefined;
-/**
- * Convert a call-site config map into plain runtime values.
- *
- * A `CallSiteConfig` may contain either plain wiring values
- * (`TraitConfigValue`) or annotated `ConfigFieldDeclaration` objects
- * (`{ type, default, label, ... }`). The runtime binding context expects
- * only values, so this helper extracts `.default` from declarations and
- * passes plain values through unchanged. Entries that are not recognized as
- * declarations by `isCallSiteConfigDeclaration` are returned as-is.
- */
-declare function normalizeCallSiteConfigToValues(config: CallSiteConfig | undefined): TraitConfig | undefined;
 /**
  * Walk an entity's `fields` array and return a flat `{ fieldName: default, … }`
  * map. Seeds the `@entity` binding context with declared field defaults before
@@ -909,6 +937,12 @@ interface RegisteredOrbital {
  */
 interface OrbitalEventRequest {
     event: string;
+    /**
+     * V4 dual-carry id sibling of `event` — the fired event's id, when known
+     * (e.g. threaded from a `listens[].triggersId`). Optional; absent means
+     * the state machine dispatches by name only (legacy).
+     */
+    eventId?: EventId;
     payload?: EventPayload;
     entityId?: string;
     /** User context for @user bindings (from Firebase auth) */
@@ -1063,6 +1097,16 @@ declare class OrbitalServerRuntime {
     private substrateHandlers;
     private substrateHandlersPromise;
     private resolvedSchema;
+    /**
+     * Trait name -> resolved `TraitConfig`, computed once per `register()` via
+     * `buildResolvedTraitConfigs` (`@almadar/core`). An embedded sub-trait's
+     * OWN declared config schema (`registered.traits` / `collectDeclaredConfigDefaults`)
+     * carries `@config.X` forwards verbatim — this map chains those through to
+     * the trait that actually embeds it (see `embedded-trait-config.ts` for the
+     * full rationale). Used as a fallback layer in `buildBindingContext` behind
+     * `declaredDefaults` and ahead of `callSiteOverride`.
+     */
+    private resolvedTraitConfigs;
     constructor(config?: OrbitalServerRuntimeConfig);
     /**
      * Lazily wire the OS-level effect handlers (fs/net/child_process), merging
@@ -1311,4 +1355,4 @@ declare class OrbitalServerRuntime {
  */
 declare function createOrbitalServerRuntime(config?: OrbitalServerRuntimeConfig): OrbitalServerRuntime;
 
-export { normalizeCallSiteConfigToValues as A, normalizeEventKey as B, parseNamespacedEvent as C, preprocessSchema as D, type EntitySharingMap as E, processEvent as F, type ClientEffectTuple as G, type ClientNavigateTuple as H, type ImportChainLike as I, type ClientNotifyTuple as J, type ClientRenderUITuple as K, type LoadResult as L, type EffectResult as M, type LoaderConfig as N, type OrbitalEventRequest as O, type PersistenceAdapter as P, OrbitalServerRuntime as Q, type RegisteredOrbital as R, type SchemaLoader as S, type RuntimeTraitTick as T, type UnifiedLoaderOptions as U, createOrbitalServerRuntime as V, 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, collectDeclaredConfigDefaults as p, collectDeclaredEntityDefaults as q, createInitialTraitState as r, findInitialState as s, findTransition as t, getIsolatedCollectionName as u, getNamespacedEvent as v, isBrowser as w, isElectron as x, isNamespacedEvent as y, isNode as z };
+export { normalizeEventKey as A, parseNamespacedEvent as B, preprocessSchema as C, processEvent as D, type EntitySharingMap as E, type ClientEffectTuple as F, type ClientNavigateTuple as G, type ClientNotifyTuple as H, type ImportChainLike as I, type ClientRenderUITuple as J, type EffectResult as K, type LoadResult as L, type LoaderConfig as M, OrbitalServerRuntime as N, type OrbitalEventRequest as O, type PersistenceAdapter as P, type RuntimeTraitTick as Q, type RegisteredOrbital as R, type SchemaLoader as S, createOrbitalServerRuntime as T, 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, collectDeclaredConfigDefaults as p, collectDeclaredEntityDefaults as q, createInitialTraitState as r, findInitialState as s, findTransition as t, getIsolatedCollectionName as u, getNamespacedEvent as v, isBrowser as w, isElectron as x, isNamespacedEvent as y, isNode as z };

package/dist/OrbitalServerRuntime.d.ts

@@ -1,4 +1,4 @@
 import 'express';
-export { G as ClientEffectTuple, H as ClientNavigateTuple, J as ClientNotifyTuple, K as ClientRenderUITuple, M as EffectResult, e as InMemoryPersistence, N as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, Q as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, T as RuntimeTraitTick, p as collectDeclaredConfigDefaults, V as createOrbitalServerRuntime } from './OrbitalServerRuntime-DpAwIrmv.js';
-import './types-D-9feVsj.js';
+export { F as ClientEffectTuple, G as ClientNavigateTuple, H as ClientNotifyTuple, J as ClientRenderUITuple, K as EffectResult, e as InMemoryPersistence, M as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, N as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, Q as RuntimeTraitTick, p as collectDeclaredConfigDefaults, T as createOrbitalServerRuntime } from './OrbitalServerRuntime-BrHSXDfp.js';
+import './types-C8RsO0xa.js';
 import '@almadar/core';