@almadar/runtime 1.2.3 → 2.0.0

package/LICENSE

@@ -1,72 +1,21 @@
-Business Source License 1.1
-
-Parameters
-
-Licensor:             Almadar FZE
-Licensed Work:        KFlow Builder / Almadar
-                      The Licensed Work is (c) 2025-2026 Almadar FZE.
-Additional Use Grant: You may make production use of the Licensed Work for
-                      non-commercial purposes and for internal evaluation.
-                      Production use for commercial purposes requires a
-                      commercial license from the Licensor.
-Change Date:          2030-02-01
-Change License:       Apache License, Version 2.0
-
-Terms
-
-The Licensor hereby grants you the right to copy, modify, create derivative
-works, redistribute, and make non-production use of the Licensed Work. The
-Licensor may make an Additional Use Grant, above, permitting limited
-production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly
-available distribution of a specific version of the Licensed Work under this
-License, whichever comes first, the Licensor hereby grants you rights under
-the terms of the Change License, and the rights granted in the paragraph
-above terminate.
-
-If your use of the Licensed Work does not comply with the requirements
-currently in effect as described in this License, you must purchase a
-commercial license from the Licensor, its affiliated entities, or authorized
-resellers, or you must refrain from using the Licensed Work.
-
-All copies of the original and modified Licensed Work, and derivative works
-of the Licensed Work, are subject to this License. This License applies
-separately for each version of the Licensed Work and the Change Date may vary
-for each version of the Licensed Work released by Licensor.
-
-You must conspicuously display this License on each original or modified copy
-of the Licensed Work. If you receive the Licensed Work in original or
-modified form from a third party, the terms and conditions set forth in this
-License apply to your use of that work.
-
-Any use of the Licensed Work in violation of this License will automatically
-terminate your rights under this License for the current and all other
-versions of the Licensed Work.
-
-This License does not grant you any right in any trademark or logo of
-Licensor or its affiliates (provided that you may use a trademark or logo of
-Licensor as expressly required by this License).
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
-AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
-EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
-TITLE.
-
----
-
-License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
-"Business Source License" is a trademark of MariaDB Corporation Ab.
-
-ADDITIONAL TERMS:
-
-Documentation (builder/packages/website/docs/) is licensed under CC BY 4.0.
-
-TRADEMARKS:
-
-"Orbital", "KFlow", "Almadar", and the Almadar logo are trademarks of
-Almadar FZE. You may not use these trademarks without prior written
-permission from Almadar FZE.
-
-For licensing inquiries: licensing@almadar.io
+MIT License
+
+Copyright (c) 2026 Almadar Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @almadar/runtime
+
+> Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)
+
+Part of the [Almadar](https://github.com/almadar-io/almadar) platform.
+
+## Installation
+
+```bash
+npm install @almadar/runtime
+```
+
+## Usage
+
+```typescript
+import { /* ... */ } from '@almadar/runtime';
+```
+
+## API
+
+<!-- Document public exports here -->
+
+## License
+
+MIT

package/dist/{OrbitalServerRuntime-Bp1YgmI1.d.ts → OrbitalServerRuntime-CNyOL8XD.d.ts}

@@ -1,5 +1,5 @@
 import { Router } from 'express';
-import { I as IEventBus, R as RuntimeEvent, e as EventListener, U as Unsubscribe, E as EffectHandlers, d as Effect, T as TraitState } from './types-LiBPiu-u.js';
+import { I as IEventBus, i as RuntimeEvent, h as EventListener, U as Unsubscribe, E as EffectHandlers, g as Effect, T as TraitState } from './types-9hbY6RWC.js';
 import { OrbitalSchema, Orbital, Trait } from '@almadar/core';
 
 /**
@@ -33,11 +33,20 @@ import { OrbitalSchema, Orbital, Trait } from '@almadar/core';
 declare class EventBus implements IEventBus {
     private listeners;
     private debug;
+    /** Maximum recursion depth before circuit breaker activates (RCG-05) */
+    private maxDepth;
+    /** Current emission depth for circular loop detection */
+    private depth;
     constructor(options?: {
         debug?: boolean;
+        maxDepth?: number;
     });
     /**
-     * Emit an event to all registered listeners
+     * Emit an event to all registered listeners.
+     *
+     * Includes circuit breaker (RCG-05): if emit is called recursively
+     * beyond `maxDepth`, the event is dropped and an error is logged.
+     * This prevents infinite loops from circular emit/listen chains.
      */
     emit(type: string, payload?: Record<string, unknown>, source?: RuntimeEvent['source']): void;
     /**
@@ -421,6 +430,8 @@ interface RuntimeOrbital {
             name: string;
             type: string;
         }>;
+        /** Pre-defined entity instances to seed on registration */
+        instances?: Array<Record<string, unknown>>;
     };
     traits: RuntimeTrait[];
 }

package/dist/OrbitalServerRuntime.d.ts

@@ -1,4 +1,4 @@
 import 'express';
-export { n as EffectResult, L as LoaderConfig, O as OrbitalEventRequest, c as OrbitalEventResponse, o as OrbitalServerRuntime, d as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RuntimeOrbital, h as RuntimeOrbitalSchema, i as RuntimeTrait, q as RuntimeTraitTick, r as createOrbitalServerRuntime } from './OrbitalServerRuntime-Bp1YgmI1.js';
-import './types-LiBPiu-u.js';
+export { n as EffectResult, L as LoaderConfig, O as OrbitalEventRequest, c as OrbitalEventResponse, o as OrbitalServerRuntime, d as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RuntimeOrbital, h as RuntimeOrbitalSchema, i as RuntimeTrait, q as RuntimeTraitTick, r as createOrbitalServerRuntime } from './OrbitalServerRuntime-CNyOL8XD.js';
+import './types-9hbY6RWC.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,4 +1,4 @@
-import { EventBus, createUnifiedLoader, preprocessSchema, StateMachineManager, createContextFromBindings, EffectExecutor } from './chunk-QBQSJJF6.js';
+import { EventBus, createUnifiedLoader, preprocessSchema, StateMachineManager, createContextFromBindings, EffectExecutor } from './chunk-EOMQVFFE.js';
 import { Router } from 'express';
 import { evaluateGuard } from '@almadar/evaluator';
 import { faker } from '@faker-js/faker';
@@ -877,6 +877,78 @@ var OrbitalServerRuntime = class {
         }
       },
       persist: async (action, targetEntityType, data) => {
+        if (action === "batch") {
+          const operations = data?.operations;
+          if (!Array.isArray(operations) || operations.length === 0) {
+            effectResults.push({
+              effect: "persist",
+              action: "batch",
+              success: false,
+              error: "Batch requires a non-empty operations array"
+            });
+            return;
+          }
+          const batchResults = [];
+          const completed = [];
+          let batchFailed = false;
+          let batchError = "";
+          for (const op of operations) {
+            if (!Array.isArray(op) || op.length < 2) {
+              batchFailed = true;
+              batchError = `Invalid batch operation format: ${JSON.stringify(op)}`;
+              break;
+            }
+            const [opAction, opEntityType, ...opRest] = op;
+            try {
+              switch (opAction) {
+                case "create": {
+                  const createData = opRest[0] || {};
+                  const { id: newId } = await this.persistence.create(opEntityType, createData);
+                  batchResults.push({ action: "create", entityType: opEntityType, id: newId, ...createData });
+                  completed.push({ action: "create", entityType: opEntityType, id: newId });
+                  break;
+                }
+                case "update": {
+                  const updateId = opRest[0];
+                  const updateData = opRest[1] || {};
+                  await this.persistence.update(opEntityType, updateId, updateData);
+                  const updated = await this.persistence.getById(opEntityType, updateId);
+                  batchResults.push({ action: "update", entityType: opEntityType, id: updateId, ...updated || updateData });
+                  completed.push({ action: "update", entityType: opEntityType, id: updateId });
+                  break;
+                }
+                case "delete": {
+                  const deleteId = opRest[0];
+                  await this.persistence.delete(opEntityType, deleteId);
+                  batchResults.push({ action: "delete", entityType: opEntityType, id: deleteId, deleted: true });
+                  completed.push({ action: "delete", entityType: opEntityType, id: deleteId });
+                  break;
+                }
+                default:
+                  batchFailed = true;
+                  batchError = `Unknown batch operation action: ${opAction}`;
+                  break;
+              }
+            } catch (err) {
+              batchFailed = true;
+              batchError = `Batch operation [${opAction}, ${opEntityType}] failed: ${err instanceof Error ? err.message : String(err)}`;
+              break;
+            }
+            if (batchFailed) break;
+          }
+          effectResults.push({
+            effect: "persist",
+            action: "batch",
+            data: {
+              operations: batchResults,
+              completedCount: completed.length,
+              totalCount: operations.length
+            },
+            success: !batchFailed,
+            ...batchFailed ? { error: batchError } : {}
+          });
+          return;
+        }
         const type = targetEntityType || entityType;
         let resultData;
         try {