arvo-event-handler 3.0.23 → 3.0.26

package/dist/ArvoResumable/index.js

@@ -69,16 +69,14 @@ var ArvoDomain_1 = require("../ArvoDomain");
 var ArvoResumable = /** @class */ (function () {
     function ArvoResumable(param) {
         var _a;
-        var _b, _c, _d;
-        /** Optional domains for routing system error events */
-        this.systemErrorDomain = undefined;
+        var _b, _c, _d, _e;
         this.executionunits = param.executionunits;
         this.source = param.contracts.self.type;
         this.syncEventResource = new index_1.SyncEventResource(param.memory, (_b = param.requiresResourceLocking) !== null && _b !== void 0 ? _b : true);
         this.contracts = param.contracts;
         this.handler = param.handler;
-        this.systemErrorDomain = param.systemErrorDomain;
-        this.spanOptions = __assign(__assign({ kind: api_1.SpanKind.PRODUCER }, param.spanOptions), { attributes: __assign(__assign((_a = {}, _a[arvo_core_1.ArvoExecution.ATTR_SPAN_KIND] = arvo_core_1.ArvoExecutionSpanKind.RESUMABLE, _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.contracts.self.uri }) });
+        this.defaultEventEmissionDomains = __assign({ systemError: [ArvoDomain_1.ArvoDomain.ORCHESTRATION_CONTEXT], services: [ArvoDomain_1.ArvoDomain.LOCAL], complete: [ArvoDomain_1.ArvoDomain.ORCHESTRATION_CONTEXT] }, ((_c = param.defaultEventEmissionDomains) !== null && _c !== void 0 ? _c : {}));
+        this.spanOptions = __assign(__assign({ kind: api_1.SpanKind.PRODUCER }, param.spanOptions), { attributes: __assign(__assign((_a = {}, _a[arvo_core_1.ArvoExecution.ATTR_SPAN_KIND] = arvo_core_1.ArvoExecutionSpanKind.RESUMABLE, _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.contracts.self.uri }) });
     }
     Object.defineProperty(ArvoResumable.prototype, "requiresResourceLocking", {
         /** Whether this resumable requires resource locking for concurrent safety */
@@ -156,15 +154,14 @@ var ArvoResumable = /** @class */ (function () {
                             source: this.source,
                             syncEventResource: this.syncEventResource,
                             executionunits: this.executionunits,
-                            systemErrorDomain: this.systemErrorDomain,
+                            systemErrorDomain: this.defaultEventEmissionDomains.systemError,
                             selfContract: this.contracts.self.version('latest'),
-                            domain: this.domain,
                         }, function (_a) { return __awaiter(_this, [_a], void 0, function (_b) {
-                            var inputValidation, contractType, eventTypeToExpectedEvent, _i, _c, _d, _, eventList, _e, eventList_1, _evt, handler, versionedSelfContract, executionResult, rawEvents, emittables, eventTrackingState, newState;
-                            var _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
+                            var inputValidation, contractType, eventTypeToExpectedEvent, _i, _c, _d, _, eventList, _e, eventList_1, _evt, handler, versionedSelfContract, executionResult, rawEvents, i, emittables, eventTrackingState, newState;
+                            var _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
                             var span = _b.span, otelHeaders = _b.otelHeaders, orchestrationParentSubject = _b.orchestrationParentSubject, initEventId = _b.initEventId, parsedEventSubject = _b.parsedEventSubject, state = _b.state;
-                            return __generator(this, function (_v) {
-                                switch (_v.label) {
+                            return __generator(this, function (_y) {
+                                switch (_y.label) {
                                     case 0:
                                         (0, arvo_core_1.logToSpan)({
                                             level: 'INFO',
@@ -231,17 +228,18 @@ var ArvoResumable = /** @class */ (function () {
                                                 },
                                             })];
                                     case 1:
-                                        executionResult = _v.sent();
+                                        executionResult = _y.sent();
                                         rawEvents = (_o = executionResult === null || executionResult === void 0 ? void 0 : executionResult.services) !== null && _o !== void 0 ? _o : [];
+                                        for (i = 0; i < rawEvents.length; i++) {
+                                            rawEvents[i].domain = (_p = rawEvents[i].domain) !== null && _p !== void 0 ? _p : this.defaultEventEmissionDomains.services;
+                                        }
                                         if (executionResult === null || executionResult === void 0 ? void 0 : executionResult.output) {
                                             rawEvents.push({
                                                 id: executionResult.output.__id,
                                                 data: executionResult.output,
                                                 type: this.contracts.self.metadata.completeEventType,
-                                                to: (_q = (_p = parsedEventSubject.meta) === null || _p === void 0 ? void 0 : _p.redirectto) !== null && _q !== void 0 ? _q : parsedEventSubject.execution.initiator,
-                                                domain: orchestrationParentSubject
-                                                    ? [arvo_core_1.ArvoOrchestrationSubject.parse(orchestrationParentSubject).execution.domain]
-                                                    : [ArvoDomain_1.ArvoDomain.LOCAL],
+                                                to: (_r = (_q = parsedEventSubject.meta) === null || _q === void 0 ? void 0 : _q.redirectto) !== null && _r !== void 0 ? _r : parsedEventSubject.execution.initiator,
+                                                domain: (_t = (_s = executionResult.output) === null || _s === void 0 ? void 0 : _s.__domain) !== null && _t !== void 0 ? _t : this.defaultEventEmissionDomains.complete,
                                                 executionunits: executionResult.output.__executionunits,
                                             });
                                         }
@@ -264,7 +262,7 @@ var ArvoResumable = /** @class */ (function () {
                                             consumed: event.toJSON(),
                                             expected: emittables.length
                                                 ? Object.fromEntries(emittables.map(function (item) { return [item.id, []]; }))
-                                                : ((_s = (_r = state === null || state === void 0 ? void 0 : state.events) === null || _r === void 0 ? void 0 : _r.expected) !== null && _s !== void 0 ? _s : null),
+                                                : ((_v = (_u = state === null || state === void 0 ? void 0 : state.events) === null || _u === void 0 ? void 0 : _u.expected) !== null && _v !== void 0 ? _v : null),
                                             produced: emittables.map(function (item) { return item.toJSON(); }),
                                         };
                                         newState = {
@@ -274,7 +272,7 @@ var ArvoResumable = /** @class */ (function () {
                                             parentSubject: orchestrationParentSubject,
                                             subject: event.subject,
                                             events: eventTrackingState,
-                                            state$$: (_u = (_t = executionResult === null || executionResult === void 0 ? void 0 : executionResult.context) !== null && _t !== void 0 ? _t : state === null || state === void 0 ? void 0 : state.state$$) !== null && _u !== void 0 ? _u : null,
+                                            state$$: (_x = (_w = executionResult === null || executionResult === void 0 ? void 0 : executionResult.context) !== null && _w !== void 0 ? _w : state === null || state === void 0 ? void 0 : state.state$$) !== null && _x !== void 0 ? _x : null,
                                         };
                                         return [2 /*return*/, { emittables: emittables, newState: newState }];
                                 }
@@ -287,7 +285,7 @@ var ArvoResumable = /** @class */ (function () {
     };
     Object.defineProperty(ArvoResumable.prototype, "systemErrorSchema", {
         get: function () {
-            return __assign(__assign({}, this.contracts.self.systemError), { domain: this.systemErrorDomain });
+            return this.contracts.self.systemError;
         },
         enumerable: false,
         configurable: true

package/dist/ArvoResumable/types.d.ts

@@ -3,7 +3,7 @@ import type { ArvoContract, ArvoEvent, ArvoOrchestratorContract, ArvoSemanticVer
 import type { EnqueueArvoEventActionParam } from '../ArvoMachine/types';
 import type { OrchestrationExecutionMemoryRecord } from '../ArvoOrchestrationUtils/orchestrationExecutionState';
 import type { IMachineMemory } from '../MachineMemory/interface';
-import type { ArvoEventHandlerOtelSpanOptions } from '../types';
+import type { ArvoEventHandlerOtelSpanOptions, NonEmptyArray } from '../types';
 /**
  * Extracts all possible event types (including system errors) from service contracts.
  */
@@ -98,6 +98,7 @@ type Handler<TState extends ArvoResumableState<Record<string, any>>, TSelfContra
     }[keyof InferVersionedArvoContract<TSelfContract>['emits']] & {
         __id?: CreateArvoEvent<Record<string, unknown>, string>['id'];
         __executionunits?: CreateArvoEvent<Record<string, unknown>, string>['executionunits'];
+        __domain?: NonEmptyArray<string | null>;
     };
     /**
      * Service call events to emit.
@@ -219,10 +220,47 @@ export type ArvoResumableParam<TMemory extends Record<string, any>, TSelfContrac
      * Each contract version maps to its corresponding handler implementation.
      */
     handler: ArvoResumableHandler<ArvoResumableState<TMemory>, TSelfContract, TServiceContract>;
-    /** Optional domains for system error event routing */
-    systemErrorDomain?: (string | null)[];
+    /**
+     * Optional domains for system error event routing
+     *
+     * @default [ArvoDomain.FROM_PARENT_SUBJECT]
+     */
+    systemErrorDomain?: NonEmptyArray<string | null>;
     /** OpenTelemetry span configuration for distributed tracing */
     spanOptions?: ArvoEventHandlerOtelSpanOptions;
+    /**
+     * Optional default domains for the events emitted
+     * by the orchestrator.
+     */
+    defaultEventEmissionDomains?: {
+        /**
+         * Default domains for system error events emitted by this orchestrator.
+         *
+         * System errors are routed through these domains when the handler encounters
+         * unhandled exceptions or critical failures.
+         *
+         * @default [ArvoDomain.ORCHESTRATION_CONTEXT]
+         */
+        systemError?: NonEmptyArray<string | null>;
+        /**
+         * Default domains for service events emitted by this orchestrator.
+         *
+         * The service xstate.emit function can over-ride this default.
+         *
+         * @default [ArvoDomain.LOCAL]
+         */
+        services?: NonEmptyArray<string | null>;
+        /**
+         * Defauld domain for the final completion event emitted by this orchestrator
+         *
+         * Completion event is routed through these domains when the orchestrator successfully
+         * processes an init event. The machine 'output' transform function implementations can override
+         * this default.
+         *
+         * @default [ArvoDomain.ORCHESTRATION_CONTEXT]
+         */
+        complete?: NonEmptyArray<string | null>;
+    };
 };
 /**
  * Configuration parameters for creating an ArvoResumable instance.
@@ -252,9 +290,8 @@ export type CreateArvoResumableParam<TMemory extends Record<string, any>, TSelfC
      * @default true if multiple service contracts, false otherwise
      */
     requiresResourceLocking?: boolean;
-    /** Optional domains for system error event routing */
-    systemErrorDomain?: (string | null)[];
     /** OpenTelemetry span configuration for distributed tracing */
     spanOptions?: ArvoEventHandlerOtelSpanOptions;
+    defaultEventEmissionDomains?: ArvoResumableParam<TMemory, TSelfContract, TServiceContract>['defaultEventEmissionDomains'];
 };
 export {};

package/dist/IArvoEventHandler/index.d.ts

@@ -42,9 +42,6 @@ export default interface IArvoEventHandler {
      *
      * @property type - The error event type identifier
      * @property schema - Zod schema defining the error event data structure
-     * @property domain - Optional domains for error event routing and distribution
      */
-    systemErrorSchema: ArvoContractRecord & {
-        domain?: (string | null)[];
-    };
+    systemErrorSchema: ArvoContractRecord;
 }

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 import type { SpanOptions } from '@opentelemetry/api';
 import type { ArvoEvent } from 'arvo-core';
 import type IArvoEventHandler from './IArvoEventHandler';
+export type NonEmptyArray<T> = [T, ...T[]];
 /**
  * Makes properties optional except specified keys
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arvo-event-handler",
-  "version": "3.0.23",
+  "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.23",
+    "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": {