@almadar/runtime 6.22.0 → 6.23.0

package/dist/{OrbitalServerRuntime-CO0rEx3p.d.ts → OrbitalServerRuntime-h0NCwFuc.d.ts}

@@ -1,7 +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-BA7GoDni.js';
 import { EventPayload, EntityRow, DeclaredTraitConfig, TraitConfig, Entity, OrbitalSchema, Orbital, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, OrbitalDefinition, TraitTick } from '@almadar/core';
-import { P as PersistenceAdapter } from './PersistenceAdapter-B6dQCbbU.js';
 
 /**
  * EventBus - Platform-Agnostic Pub/Sub Implementation
@@ -605,7 +604,7 @@ interface EntitySharingMap {
         /** The entity name */
         entityName: string;
         /** Persistence type */
-        persistence: "persistent" | "runtime" | "singleton";
+        persistence: "persistent" | "runtime";
         /** Whether this entity is shared with other orbitals */
         isShared: boolean;
         /** Source orbital if imported */
@@ -680,7 +679,6 @@ declare function preprocessSchema(schema: OrbitalSchema, options: PreprocessOpti
  *
  * - `persistent` entities share the same collection
  * - `runtime` entities get isolated collections per orbital
- * - `singleton` entities share a single-record collection
  */
 declare function getIsolatedCollectionName(orbitalName: string, entitySharing: EntitySharingMap): string;
 /**
@@ -700,6 +698,69 @@ declare function parseNamespacedEvent(eventName: string): {
     event: string;
 };
 
+/**
+ * PersistenceAdapter — the storage contract for runtime effect handlers.
+ *
+ * The server-side runtime and the in-browser mock runtime both invoke
+ * `fetch` / `persist` / `ref` / `deref` / `swap!` effects against an
+ * implementation of this interface. Extracted from
+ * `OrbitalServerRuntime.ts` so it can be imported by browser code that
+ * cannot depend on the server module (which pulls in express).
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Storage contract for CRUD operations on runtime entity rows.
+ *
+ * Implementations:
+ * - `InMemoryPersistence` (this file) — simple Map-backed store, used by
+ *   the browser mock runtime and as the default when an adapter is not
+ *   supplied to `OrbitalServerRuntime`.
+ * - `MockPersistenceAdapter` — in-memory with faker-generated seed data
+ *   for realistic preview content.
+ * - Consumer-provided (e.g. Firestore, Postgres) for production servers.
+ */
+interface PersistenceAdapter {
+    create(entityType: string, data: EntityRow): Promise<{
+        id: string;
+    }>;
+    update(entityType: string, id: string, data: EntityRow): Promise<void>;
+    delete(entityType: string, id: string): Promise<void>;
+    getById(entityType: string, id: string): Promise<EntityRow | null>;
+    list(entityType: string): Promise<EntityRow[]>;
+}
+/**
+ * Simple in-memory persistence for dev/testing and offline previews.
+ * Keys each entity collection by type, rows by generated string id.
+ */
+declare class InMemoryPersistence implements PersistenceAdapter {
+    private data;
+    private idCounter;
+    /**
+     * Seed the store with pre-existing rows.
+     *
+     * Accepts either a plain `Record<entityType, EntityRow[]>` or an iterable
+     * of `[entityType, EntityRow[]]` entries. Rows without an `id` get one
+     * generated at insert time; rows with an `id` keep it (so re-seeding
+     * after a schema rebuild preserves identities used in render bindings).
+     */
+    seed(seedData: Record<string, EntityRow[]> | Iterable<[string, EntityRow[]]>): void;
+    create(entityType: string, data: EntityRow): Promise<{
+        id: string;
+    }>;
+    update(entityType: string, id: string, data: EntityRow): Promise<void>;
+    delete(entityType: string, id: string): Promise<void>;
+    getById(entityType: string, id: string): Promise<EntityRow | null>;
+    list(entityType: string): Promise<EntityRow[]>;
+    /**
+     * Snapshot the entire store as a plain object (entityType → rows).
+     * Useful for feeding a fresh render-time binding layer with the
+     * current persistence view.
+     */
+    snapshot(): Record<string, EntityRow[]>;
+}
+
 /**
  * OrbitalServerRuntime - Dynamic Server-Side Orbital Execution
  *
@@ -926,11 +987,6 @@ interface OrbitalServerRuntimeConfig {
      * Default: true
      */
     namespaceEvents?: boolean;
-    /**
-     * Root directory for `persistence: "local"` entities.
-     * Default: ~/.orb/data/
-     */
-    localStorageRoot?: string;
     /**
      * Additional fields to spread onto every EvaluationContext.
      * Use this to inject module contexts (e.g., { agent: AgentContext }).
@@ -953,7 +1009,6 @@ declare class OrbitalServerRuntime {
     private eventNamespaceMap;
     private osHandlers;
     private osHandlersPromise;
-    private localPersistence;
     private resolvedSchema;
     constructor(config?: OrbitalServerRuntimeConfig);
     /**
@@ -1197,4 +1252,4 @@ declare class OrbitalServerRuntime {
  */
 declare function createOrbitalServerRuntime(config?: OrbitalServerRuntimeConfig): OrbitalServerRuntime;
 
-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, OrbitalServerRuntime as K, type LoadResult as L, type RuntimeTraitTick as M, createOrbitalServerRuntime as N, type OrbitalEventRequest as O, type PreprocessOptions 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 PreprocessResult as g, type PreprocessedSchema as h, type ProcessEventOptions as i, type RuntimeOrbital as j, type RuntimeOrbitalSchema as k, type RuntimeTrait as l, StateMachineManager as m, collectDeclaredConfigDefaults as n, collectDeclaredEntityDefaults 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 { 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,5 +1,4 @@
 import 'express';
-export { C as ClientEffectTuple, D as ClientNavigateTuple, F as ClientNotifyTuple, G as ClientRenderUITuple, H as EffectResult, J as LoaderConfig, O as OrbitalEventRequest, e as OrbitalEventResponse, K as OrbitalServerRuntime, f as OrbitalServerRuntimeConfig, R as RegisteredOrbital, j as RuntimeOrbital, k as RuntimeOrbitalSchema, l as RuntimeTrait, M as RuntimeTraitTick, n as collectDeclaredConfigDefaults, N as createOrbitalServerRuntime } from './OrbitalServerRuntime-CO0rEx3p.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-h0NCwFuc.js';
 import './types-BA7GoDni.js';
 import '@almadar/core';
-export { I as InMemoryPersistence, P as PersistenceAdapter } from './PersistenceAdapter-B6dQCbbU.js';

package/dist/OrbitalServerRuntime.js

@@ -1,5 +1,5 @@
-import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, StateMachineManager, parseDurationString, createContextFromBindings, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-M7HMVDYF.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-M7HMVDYF.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, StateMachineManager, parseDurationString, createContextFromBindings, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-4SX6WJKY.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-4SX6WJKY.js';
 import { isValidCronExpression } from './chunk-U4PL237A.js';
 import './chunk-PZ5AY32C.js';
 import { createLogger } from '@almadar/logger';
@@ -25,7 +25,6 @@ function nodeRequire(modulePath) {
   }
   return _resolvedNodeRequire(modulePath);
 }
-var _nodeRequireExt = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
 var effectLog = createLogger("almadar:runtime:effects");
 var busLog = createLogger("almadar:runtime:bus");
 var renderLog = createLogger("almadar:runtime:render-ui");
@@ -70,7 +69,6 @@ var OrbitalServerRuntime = class {
   eventNamespaceMap = {};
   osHandlers = null;
   osHandlersPromise = null;
-  localPersistence = null;
   resolvedSchema = null;
   constructor(config = {}) {
     this.config = {
@@ -102,10 +100,6 @@ var OrbitalServerRuntime = class {
     } else {
       this.persistence = config.persistence || new InMemoryPersistence();
     }
-    if (config.localStorageRoot && isNodeEnv()) {
-      const { LocalPersistenceAdapter } = nodeRequire(`./LocalPersistenceAdapter${_nodeRequireExt}`);
-      this.localPersistence = new LocalPersistenceAdapter(config.localStorageRoot);
-    }
     this.osHandlers = { handlers: {}, cleanup: () => {
     } };
   }