@almadar/runtime 3.2.2 → 3.2.4

package/dist/{OrbitalServerRuntime-CQsVhY4Y.d.ts → OrbitalServerRuntime-DMRvEfcT.d.ts}

@@ -386,6 +386,46 @@ type LoadResult<T> = {
     success: false;
     error: string;
 };
+/**
+ * Base options for all loaders.
+ */
+interface BaseLoaderOptions {
+    /** Base path/URL for resolving relative imports */
+    basePath: string;
+    /** Standard library root path/URL */
+    stdLibPath?: string;
+    /** Scoped package roots (e.g., { "@game-lib": "/path/to/lib" }) */
+    scopedPaths?: Record<string, string>;
+}
+/**
+ * Options for file system loading.
+ */
+interface FileSystemLoaderOptions extends BaseLoaderOptions {
+    /** Whether to allow paths outside basePath (security) */
+    allowOutsideBasePath?: boolean;
+}
+/**
+ * Options for HTTP loading.
+ */
+interface HttpLoaderOptions extends BaseLoaderOptions {
+    /** Default fetch options */
+    fetchOptions?: RequestInit;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Whether to use credentials (cookies, auth headers) */
+    credentials?: RequestCredentials;
+}
+/**
+ * Combined options for unified loader.
+ */
+interface UnifiedLoaderOptions extends BaseLoaderOptions {
+    /** File system specific options */
+    fileSystem?: Omit<FileSystemLoaderOptions, keyof BaseLoaderOptions>;
+    /** HTTP specific options */
+    http?: Omit<HttpLoaderOptions, keyof BaseLoaderOptions>;
+    /** Force a specific loader type */
+    forceLoader?: "filesystem" | "http";
+}
 /**
  * Abstract interface for schema loaders.
  *
@@ -463,6 +503,18 @@ interface ImportChainLike {
      */
     clone(): ImportChainLike;
 }
+/**
+ * Detect if running in Electron.
+ */
+declare function isElectron(): boolean;
+/**
+ * Detect if running in browser (not Electron).
+ */
+declare function isBrowser(): boolean;
+/**
+ * Detect if running in Node.js (not browser).
+ */
+declare function isNode(): boolean;
 
 /**
  * Reference Resolver
@@ -706,6 +758,18 @@ interface OrbitalEventResponse {
     };
     /** Client-side effects to execute (render-ui, navigate, notify) */
     clientEffects?: Array<unknown>;
+    /**
+     * Same effects as `clientEffects`, paired with the producing trait name.
+     * Consumers that need per-trait attribution (e.g. `<TraitFrame>` resolving
+     * `@trait.X` bindings) read from this field; legacy consumers ignore it
+     * and continue with the flat `clientEffects` array unchanged.
+     *
+     * Same length and ordering as `clientEffects`; entries are 1:1 by index.
+     */
+    clientEffectsByTrait?: Array<{
+        traitName: string;
+        effect: unknown[];
+    }>;
     /** Results from server-side effects (persist, call-service, set) */
     effectResults?: EffectResult[];
     error?: string;
@@ -997,4 +1061,4 @@ declare class OrbitalServerRuntime {
  */
 declare function createOrbitalServerRuntime(config?: OrbitalServerRuntimeConfig): OrbitalServerRuntime;
 
-export { type EntitySharingMap as E, type LoaderConfig as L, type OrbitalEventRequest as O, type PersistenceAdapter as P, type RegisteredOrbital as R, StateMachineManager as S, EventBus as a, type EventNamespaceMap as b, type OrbitalEventResponse as c, type OrbitalServerRuntimeConfig as d, type PreprocessOptions as e, type PreprocessResult as f, type PreprocessedSchema as g, type ProcessEventOptions as h, type RuntimeOrbital as i, type RuntimeOrbitalSchema as j, type RuntimeTrait as k, createInitialTraitState as l, findInitialState as m, findTransition as n, getIsolatedCollectionName as o, getNamespacedEvent as p, isNamespacedEvent as q, normalizeEventKey as r, parseNamespacedEvent as s, preprocessSchema as t, processEvent as u, type EffectResult as v, LocalPersistenceAdapter as w, OrbitalServerRuntime as x, type RuntimeTraitTick as y, createOrbitalServerRuntime as z };
+export { processEvent as A, type EffectResult as B, type LoaderConfig as C, LocalPersistenceAdapter as D, type EntitySharingMap as E, OrbitalServerRuntime as F, type RuntimeTraitTick as G, createOrbitalServerRuntime as H, type ImportChainLike as I, 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, type OrbitalEventResponse as e, type OrbitalServerRuntimeConfig as f, type PreprocessOptions as g, type PreprocessResult as h, type PreprocessedSchema as i, type ProcessEventOptions as j, type RuntimeOrbital as k, type RuntimeOrbitalSchema as l, type RuntimeTrait as m, StateMachineManager as n, createInitialTraitState as o, findInitialState as p, findTransition as q, getIsolatedCollectionName as r, getNamespacedEvent as s, isBrowser as t, isElectron as u, isNamespacedEvent as v, isNode as w, normalizeEventKey as x, parseNamespacedEvent as y, preprocessSchema as z };

package/dist/OrbitalServerRuntime.d.ts

@@ -1,4 +1,4 @@
 import 'express';
-export { v as EffectResult, L as LoaderConfig, w as LocalPersistenceAdapter, O as OrbitalEventRequest, c as OrbitalEventResponse, x as OrbitalServerRuntime, d as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, i as RuntimeOrbital, j as RuntimeOrbitalSchema, k as RuntimeTrait, y as RuntimeTraitTick, z as createOrbitalServerRuntime } from './OrbitalServerRuntime-CQsVhY4Y.js';
+export { B as EffectResult, C as LoaderConfig, D as LocalPersistenceAdapter, O as OrbitalEventRequest, e as OrbitalEventResponse, F as OrbitalServerRuntime, f as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, k as RuntimeOrbital, l as RuntimeOrbitalSchema, m as RuntimeTrait, G as RuntimeTraitTick, H as createOrbitalServerRuntime } from './OrbitalServerRuntime-DMRvEfcT.js';
 import './types-B8OfRFfV.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,4 +1,4 @@
-import { EventBus, createUnifiedLoader, preprocessSchema, StateMachineManager, createContextFromBindings, EffectExecutor } from './chunk-PXASRZKG.js';
+import { EventBus, createUnifiedLoader, preprocessSchema, StateMachineManager, createContextFromBindings, EffectExecutor } from './chunk-JMMXSTWF.js';
 import './chunk-PZ5AY32C.js';
 import { Router } from 'express';
 import * as fs from 'fs';
@@ -1177,6 +1177,7 @@ var OrbitalServerRuntime = class {
     const emittedEvents = [];
     const fetchedData = {};
     const clientEffects = [];
+    const clientEffectsByTrait = [];
     const effectResults = [];
     const activeTraits = payload?._activeTraits;
     const cleanPayload = payload ? { ...payload } : void 0;
@@ -1211,7 +1212,8 @@ var OrbitalServerRuntime = class {
           fetchedData,
           clientEffects,
           effectResults,
-          user
+          user,
+          clientEffectsByTrait
         );
       }
     }
@@ -1257,6 +1259,9 @@ var OrbitalServerRuntime = class {
     if (clientEffects.length > 0) {
       response.clientEffects = clientEffects;
     }
+    if (clientEffectsByTrait.length > 0) {
+      response.clientEffectsByTrait = clientEffectsByTrait;
+    }
     if (effectResults.length > 0) {
       response.effectResults = effectResults;
     }
@@ -1265,8 +1270,12 @@ var OrbitalServerRuntime = class {
   /**
    * Execute effects from a transition
    */
-  async executeEffects(registered, traitName, effects, payload, entityData, entityId, emittedEvents, fetchedData, clientEffects, effectResults, user) {
+  async executeEffects(registered, traitName, effects, payload, entityData, entityId, emittedEvents, fetchedData, clientEffects, effectResults, user, clientEffectsByTrait) {
     const entityType = registered.entity.name;
+    const pushClientEffect = (effect) => {
+      clientEffects.push(effect);
+      clientEffectsByTrait?.push({ traitName, effect });
+    };
     let bindingsRef = null;
     let contextRef = null;
     const handlers = {
@@ -1637,16 +1646,16 @@ var OrbitalServerRuntime = class {
       },
       // Client-side effects - collect for forwarding to client
       renderUI: (slot, pattern, props, priority) => {
-        clientEffects.push(["render-ui", slot, pattern, props, priority]);
+        pushClientEffect(["render-ui", slot, pattern, props, priority]);
       },
       navigate: (path2, params) => {
-        clientEffects.push(["navigate", path2, params]);
+        pushClientEffect(["navigate", path2, params]);
       },
       notify: (message, type) => {
         if (this.config.debug) {
           console.log(`[OrbitalRuntime] Notification (${type}): ${message}`);
         }
-        clientEffects.push(["notify", message, { type }]);
+        pushClientEffect(["notify", message, { type }]);
       },
       log: (message, level) => {
         const logFn = level === "error" ? console.error : level === "warn" ? console.warn : console.log;