arvo-event-handler 3.0.25 → 3.0.26

package/dist/ArvoEventHandler/helpers.d.ts

@@ -14,7 +14,6 @@ import type { ArvoEventHandlerParam } from './types';
  * ```ts
  * const handler = createArvoEventHandler({
  *   contract: userContract,
- *   executionunits: 1,
  *   handler: {
  *     '1.0.0': async ({ event, domain, span }) => {
  *       if (domain.event !== domain.self) {

package/dist/ArvoEventHandler/helpers.js

@@ -18,7 +18,6 @@ var _1 = __importDefault(require("."));
  * ```ts
  * const handler = createArvoEventHandler({
  *   contract: userContract,
- *   executionunits: 1,
  *   handler: {
  *     '1.0.0': async ({ event, domain, span }) => {
  *       if (domain.event !== domain.self) {

package/dist/ArvoEventHandler/index.js

@@ -72,18 +72,18 @@ var utils_1 = require("../utils");
 var ArvoEventHandler = /** @class */ (function () {
     function ArvoEventHandler(param) {
         var _a;
-        var _b, _c, _d;
+        var _b, _c, _d, _e;
         this.contract = param.contract;
-        this.executionunits = param.executionunits;
+        this.executionunits = (_b = param.executionunits) !== null && _b !== void 0 ? _b : 0;
         this.handler = param.handler;
-        this.defaultEventEmissionDomains = __assign({ systemError: [ArvoDomain_1.ArvoDomain.ORCHESTRATION_CONTEXT], emits: [ArvoDomain_1.ArvoDomain.ORCHESTRATION_CONTEXT] }, ((_b = param.defaultEventEmissionDomains) !== null && _b !== void 0 ? _b : {}));
-        for (var _i = 0, _e = Object.keys(this.contract.versions); _i < _e.length; _i++) {
-            var contractVersions = _e[_i];
+        this.defaultEventEmissionDomains = __assign({ systemError: [ArvoDomain_1.ArvoDomain.ORCHESTRATION_CONTEXT], emits: [ArvoDomain_1.ArvoDomain.ORCHESTRATION_CONTEXT] }, ((_c = param.defaultEventEmissionDomains) !== null && _c !== void 0 ? _c : {}));
+        for (var _i = 0, _f = Object.keys(this.contract.versions); _i < _f.length; _i++) {
+            var contractVersions = _f[_i];
             if (!this.handler[contractVersions]) {
                 throw new Error("Contract ".concat(this.contract.uri, " requires handler implementation for version ").concat(contractVersions));
             }
         }
-        this.spanOptions = __assign(__assign({ kind: api_1.SpanKind.CONSUMER }, param.spanOptions), { attributes: __assign(__assign((_a = {}, _a[arvo_core_1.ArvoExecution.ATTR_SPAN_KIND] = arvo_core_1.ArvoExecutionSpanKind.EVENT_HANDLER, _a[arvo_core_1.OpenInference.ATTR_SPAN_KIND] = arvo_core_1.OpenInferenceSpanKind.CHAIN, _a), ((_d = (_c = param.spanOptions) === null || _c === void 0 ? void 0 : _c.attributes) !== null && _d !== void 0 ? _d : {})), { 'arvo.handler.source': this.source, 'arvo.contract.uri': this.contract.uri }) });
+        this.spanOptions = __assign(__assign({ kind: api_1.SpanKind.CONSUMER }, param.spanOptions), { attributes: __assign(__assign((_a = {}, _a[arvo_core_1.ArvoExecution.ATTR_SPAN_KIND] = arvo_core_1.ArvoExecutionSpanKind.EVENT_HANDLER, _a[arvo_core_1.OpenInference.ATTR_SPAN_KIND] = arvo_core_1.OpenInferenceSpanKind.CHAIN, _a), ((_e = (_d = param.spanOptions) === null || _d === void 0 ? void 0 : _d.attributes) !== null && _e !== void 0 ? _e : {})), { 'arvo.handler.source': this.source, 'arvo.contract.uri': this.contract.uri }) });
     }
     Object.defineProperty(ArvoEventHandler.prototype, "source", {
         /** The source identifier for events produced by this handler */

package/dist/ArvoEventHandler/types.d.ts

@@ -70,7 +70,7 @@ export type ArvoEventHandlerParam<TContract extends ArvoContract> = {
      * The default execution cost of the function.
      * This can represent a dollar value or some other number with a rate card.
      */
-    executionunits: number;
+    executionunits?: number;
     /**
      * The functional handler of the event which takes the input, performs an action, and returns the result.
      * @param params - The input parameters for the handler function.

package/dist/ArvoMachine/createMachine.d.ts

@@ -138,17 +138,23 @@ export declare function setupArvoMachine<TContext extends MachineContext, TSelfC
     }, InferServiceContract<TServiceContracts>["emitted"], TMeta>>(config: TConfig & {
         id: string;
         version?: TSelfContract["version"];
-    }) => ArvoMachine<string, TSelfContract["version"], TSelfContract, TServiceContracts, import("xstate").StateMachine<TContext, { [K in keyof TServiceContracts]: import("./types").InferEmittableEventsFromVersionedArvoContract<TServiceContracts[K]>; }[keyof TServiceContracts], {}, never, import("xstate").IsNever<TActions & {
+    }) => ArvoMachine<string, TSelfContract["version"], TSelfContract, TServiceContracts, import("xstate").StateMachine<TContext, { [K in keyof TServiceContracts]: import("./types").InferEmittableEventsFromVersionedArvoContract<TServiceContracts[K]>; }[keyof TServiceContracts], {}, never, (TActions & {
         enqueueArvoEvent: EnqueueArvoEventActionParam;
-    }> extends true ? never : import("xstate").Values<{ [K_1 in (keyof TActions & string) | "enqueueArvoEvent"]: {
-        type: K_1;
-        params: (TActions & {
-            enqueueArvoEvent: EnqueueArvoEventActionParam;
-        })[K_1];
-    }; }>, import("xstate").IsNever<TGuards> extends true ? never : import("xstate").Values<{ [K_2 in keyof TGuards & string]: {
-        type: K_2;
+    } extends infer T extends Record<string, import("xstate").NonReducibleUnknown> ? { [K_1 in keyof T as K_1 & string]: {
+        type: K_1 & string;
+        params: T[K_1];
+    }; } : never)[keyof (TActions & {
+        enqueueArvoEvent: EnqueueArvoEventActionParam;
+    } extends infer T_1 extends Record<string, import("xstate").NonReducibleUnknown> ? { [K_1 in keyof T_1 as K_1 & string]: {
+        type: K_1 & string;
+        params: T_1[K_1];
+    }; } : never)], { [K_2 in keyof TGuards as K_2 & string]: {
+        type: K_2 & string;
+        params: TGuards[K_2];
+    }; }[keyof { [K_2 in keyof TGuards as K_2 & string]: {
+        type: K_2 & string;
         params: TGuards[K_2];
-    }; }>, never, {} | {
+    }; }], never, {} | {
         [x: string]: {} | /*elided*/ any | {
             [x: string]: {} | /*elided*/ any | /*elided*/ any;
         };
@@ -156,5 +162,8 @@ export declare function setupArvoMachine<TContext extends MachineContext, TSelfC
         [x: string]: {} | {
             [x: string]: {} | /*elided*/ any | /*elided*/ any;
         } | /*elided*/ any;
-    }, TTag, TSelfContract["accepts"]["schema"]["_output"], { [K_3 in string & keyof TSelfContract["emits"]]: import("arvo-core").InferArvoEvent<import("arvo-core").ArvoEvent<TSelfContract["emits"][K_3]["_output"], Record<string, any>, K_3>>; }[`arvo.orc.${ExtractOrchestratorType<TSelfContract["accepts"]["type"]>}.done`]["data"], { [K_4 in keyof TServiceContracts]: EnqueueArvoEventActionParam<z.input<TServiceContracts[K_4]["accepts"]["schema"]>, TServiceContracts[K_4]["accepts"]["type"], Record<string, string | number | boolean | null>>; }[keyof TServiceContracts], TMeta, any>>;
+    }, TTag, TSelfContract["accepts"]["schema"]["_output"], { [K_3 in string & keyof TSelfContract["emits"]]: import("arvo-core").InferArvoEvent<import("arvo-core").ArvoEvent<TSelfContract["emits"][K_3]["_output"], Record<string, any>, K_3>>; }[`arvo.orc.${ExtractOrchestratorType<TSelfContract["accepts"]["type"]>}.done`]["data"], { [K_4 in keyof TServiceContracts]: EnqueueArvoEventActionParam<z.input<TServiceContracts[K_4]["accepts"]["schema"]>, TServiceContracts[K_4]["accepts"]["type"], Record<string, string | number | boolean | null>>; }[keyof TServiceContracts], TMeta, {
+        id: any;
+        states: any;
+    }>>;
 };

package/dist/ArvoOrchestrator/factory.d.ts

@@ -18,7 +18,6 @@ import type { CreateArvoOrchestratorParam } from './types';
  * ```typescript
  * const orchestrator = createArvoOrchestrator({
  *   memory: new SimpleMachineMemory(),
- *   executionunits: 1,
  *   machines: [userOnboardingMachine, paymentMachine]
  * });
  *

package/dist/ArvoOrchestrator/factory.js

@@ -32,7 +32,6 @@ var errors_1 = require("../errors");
  * ```typescript
  * const orchestrator = createArvoOrchestrator({
  *   memory: new SimpleMachineMemory(),
- *   executionunits: 1,
  *   machines: [userOnboardingMachine, paymentMachine]
  * });
  *
@@ -51,16 +50,16 @@ var createArvoOrchestrator = function (_a) {
     var registry = new (MachineRegistry_1.MachineRegistry.bind.apply(MachineRegistry_1.MachineRegistry, __spreadArray([void 0], machines, false)))();
     var requiresResourceLocking = _locking !== null && _locking !== void 0 ? _locking : machines.some(function (machine) { return machine.requiresResourceLocking; });
     var representativeMachine = registry.machines[0];
-    var lastSeenVersions = [];
+    var lastSeenVersions = new Set();
     for (var _i = 0, _b = registry.machines; _i < _b.length; _i++) {
         var machine = _b[_i];
         if (representativeMachine.source !== machine.source) {
-            throw new errors_1.ConfigViolation("All the machines in the orchestrator must have type '".concat(representativeMachine.source, "'"));
+            throw new errors_1.ConfigViolation("All the machines in the orchestrator must have source '".concat(representativeMachine.source, "'. Make sure all machine are implementing versions of the same self contract"));
         }
-        if (lastSeenVersions.includes(machine.version)) {
+        if (lastSeenVersions.has(machine.version)) {
             throw new errors_1.ConfigViolation("An orchestrator must have unique machine versions. Machine ID:".concat(machine.id, " has duplicate version ").concat(machine.version, "."));
         }
-        lastSeenVersions.push(machine.version);
+        lastSeenVersions.add(machine.version);
     }
     return new _1.ArvoOrchestrator({
         executionunits: executionunits,

package/dist/ArvoOrchestrator/index.js

@@ -67,7 +67,7 @@ var ArvoOrchestrator = /** @class */ (function () {
         var _b;
         var executionunits = _a.executionunits, memory = _a.memory, registry = _a.registry, executionEngine = _a.executionEngine, requiresResourceLocking = _a.requiresResourceLocking, defaultEventEmissionDomains = _a.defaultEventEmissionDomains, spanOptions = _a.spanOptions;
         var _c, _d, _e, _f, _g, _h, _j;
-        this.executionunits = executionunits;
+        this.executionunits = executionunits !== null && executionunits !== void 0 ? executionunits : 0;
         this.registry = registry;
         this.executionEngine = executionEngine;
         this.syncEventResource = new SyncEventResource_1.SyncEventResource(memory, requiresResourceLocking);

package/dist/ArvoOrchestrator/types.d.ts

@@ -84,7 +84,7 @@ export type MachineMemoryRecord = OrchestrationExecutionMemoryRecord<{
  */
 export type ArvoOrchestratorParam = {
     /** Computational cost metric assigned to orchestrator operations */
-    executionunits: number;
+    executionunits?: number;
     /** Memory interface for state persistence and retrieval */
     memory: IMachineMemory<MachineMemoryRecord>;
     /** Registry for managing and resolving machine instances */

package/dist/ArvoResumable/factory.d.ts

@@ -29,7 +29,6 @@ import type { CreateArvoResumableParam } from './types';
  *       // Handler implementation
  *     }
  *   },
- *   executionunits: 1
  * });
  * ```
  *

package/dist/ArvoResumable/factory.js

@@ -31,7 +31,6 @@ var servicesValidation_1 = require("../ArvoOrchestrationUtils/servicesValidation
  *       // Handler implementation
  *     }
  *   },
- *   executionunits: 1
  * });
  * ```
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arvo-event-handler",
-  "version": "3.0.25",
+  "version": "3.0.26",
   "description": "A complete set of orthogonal event handler and orchestration primitives for Arvo based applications, featuring declarative state machines (XState), imperative resumables for agentic workflows, contract-based routing, OpenTelemetry observability, and in-memory event broker for building composable event-driven architectures.",
   "main": "dist/index.js",
   "repository": {
@@ -36,10 +36,12 @@
     "observability"
   ],
   "author": "Saad Ahmad <saadkwi12@hotmail.com>",
+  "homepage": "https://www.arvo.land",
   "license": "MIT",
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
     "@jest/globals": "29.7.0",
+    "@opentelemetry/core": "2.2.0",
     "@opentelemetry/auto-instrumentations-node": "0.49.1",
     "@opentelemetry/exporter-metrics-otlp-proto": "0.52.1",
     "@opentelemetry/exporter-trace-otlp-grpc": "0.53.0",
@@ -64,11 +66,10 @@
   },
   "dependencies": {
     "@opentelemetry/api": "1.9.0",
-    "@opentelemetry/core": "1.30.1",
-    "arvo-core": "3.0.25",
+    "arvo-core": "3.0.26",
     "uuid": "11.1.0",
-    "xstate": "5.24.0",
-    "zod": "3.25.74",
+    "xstate": "5.25.0",
+    "zod": "3.25.76",
     "zod-to-json-schema": "3.25.0"
   },
   "engines": {