arvo-event-handler 3.0.2 → 3.0.4

package/dist/ArvoOrchestrator/index.js

@@ -73,6 +73,7 @@ var error_1 = require("./error");
 var SyncEventResource_1 = require("../SyncEventResource");
 var AbstractArvoEventHandler_1 = __importDefault(require("../AbstractArvoEventHandler"));
 var errors_1 = require("../errors");
+var ArvoDomain_1 = require("../ArvoDomain");
 /**
  * Orchestrates state machine execution and lifecycle management.
  * Handles machine resolution, state management, event processing and error handling.
@@ -85,8 +86,9 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
      * @throws Error if machines in registry have different sources
      */
     function ArvoOrchestrator(_a) {
-        var executionunits = _a.executionunits, memory = _a.memory, registry = _a.registry, executionEngine = _a.executionEngine, requiresResourceLocking = _a.requiresResourceLocking;
+        var executionunits = _a.executionunits, memory = _a.memory, registry = _a.registry, executionEngine = _a.executionEngine, requiresResourceLocking = _a.requiresResourceLocking, systemErrorDomain = _a.systemErrorDomain;
         var _this = _super.call(this) || this;
+        _this.systemErrorDomain = [];
         _this.executionunits = executionunits;
         var representativeMachine = registry.machines[0];
         var lastSeenVersions = [];
@@ -103,6 +105,7 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
         _this.registry = registry;
         _this.executionEngine = executionEngine;
         _this.syncEventResource = new SyncEventResource_1.SyncEventResource(memory, requiresResourceLocking);
+        _this.systemErrorDomain = systemErrorDomain;
         return _this;
     }
     Object.defineProperty(ArvoOrchestrator.prototype, "source", {
@@ -147,7 +150,7 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
      * @throws {ExecutionViolation} On invalid parentSubject$$ format
      */
     ArvoOrchestrator.prototype.createEmittableEvent = function (event, machine, otelHeaders, orchestrationParentSubject, sourceEvent, initEventId, _domain) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
         (0, arvo_core_1.logToSpan)({
             level: 'INFO',
             message: "Creating emittable event: ".concat(event.type),
@@ -158,7 +161,12 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
         var contract = null;
         var subject = sourceEvent.subject;
         var parentId = sourceEvent.id;
-        var domain = _domain === undefined ? ((_b = (_a = sourceEvent.domain) !== null && _a !== void 0 ? _a : this.domain) !== null && _b !== void 0 ? _b : null) : _domain;
+        var domain = (0, ArvoDomain_1.resolveEventDomain)({
+            domainToResolve: _domain,
+            handlerSelfContract: selfContract,
+            eventContract: null,
+            triggeringEvent: sourceEvent,
+        });
         if (event.type === selfContract.metadata.completeEventType) {
             (0, arvo_core_1.logToSpan)({
                 level: 'INFO',
@@ -168,7 +176,12 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
             schema = selfContract.emits[selfContract.metadata.completeEventType];
             subject = orchestrationParentSubject !== null && orchestrationParentSubject !== void 0 ? orchestrationParentSubject : sourceEvent.subject;
             parentId = initEventId;
-            domain = _domain === undefined ? ((_e = (_d = (_c = selfContract.domain) !== null && _c !== void 0 ? _c : sourceEvent.domain) !== null && _d !== void 0 ? _d : this.domain) !== null && _e !== void 0 ? _e : null) : _domain;
+            domain = (0, ArvoDomain_1.resolveEventDomain)({
+                domainToResolve: _domain,
+                handlerSelfContract: selfContract,
+                eventContract: selfContract,
+                triggeringEvent: sourceEvent,
+            });
         }
         else if (serviceContract[event.type]) {
             (0, arvo_core_1.logToSpan)({
@@ -177,7 +190,12 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
             });
             contract = serviceContract[event.type];
             schema = serviceContract[event.type].accepts.schema;
-            domain = _domain === undefined ? ((_h = (_g = (_f = contract === null || contract === void 0 ? void 0 : contract.domain) !== null && _f !== void 0 ? _f : sourceEvent.domain) !== null && _g !== void 0 ? _g : this.domain) !== null && _h !== void 0 ? _h : null) : _domain;
+            domain = (0, ArvoDomain_1.resolveEventDomain)({
+                domainToResolve: _domain,
+                handlerSelfContract: selfContract,
+                eventContract: contract,
+                triggeringEvent: sourceEvent,
+            });
             // If the event is to call another orchestrator then, extract the parent subject
             // passed to it and then form an new subject. This allows for event chaining
             // between orchestrators
@@ -186,8 +204,8 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
                     try {
                         arvo_core_1.ArvoOrchestrationSubject.parse(event.data.parentSubject$$);
                     }
-                    catch (_v) {
-                        throw new errors_1.ExecutionViolation("Invalid parentSubject$$ for the event(type='".concat(event.type, "', uri='").concat((_j = event.dataschema) !== null && _j !== void 0 ? _j : arvo_core_1.EventDataschemaUtil.create(contract), "').It must be follow the ArvoOrchestrationSubject schema. The easiest way is to use the current orchestration subject by storing the subject via the context block in the machine definition."));
+                    catch (_m) {
+                        throw new errors_1.ExecutionViolation("Invalid parentSubject$$ for the event(type='".concat(event.type, "', uri='").concat((_a = event.dataschema) !== null && _a !== void 0 ? _a : arvo_core_1.EventDataschemaUtil.create(contract), "').It must be follow the ArvoOrchestrationSubject schema. The easiest way is to use the current orchestration subject by storing the subject via the context block in the machine definition."));
                     }
                 }
                 try {
@@ -198,7 +216,7 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
                             subject: event.data.parentSubject$$,
                             domain: domain !== null && domain !== void 0 ? domain : null,
                             meta: {
-                                redirectto: (_k = event.redirectto) !== null && _k !== void 0 ? _k : this.source,
+                                redirectto: (_b = event.redirectto) !== null && _b !== void 0 ? _b : this.source,
                             },
                         });
                     }
@@ -209,7 +227,7 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
                             initiator: this.source,
                             domain: domain !== null && domain !== void 0 ? domain : undefined,
                             meta: {
-                                redirectto: (_l = event.redirectto) !== null && _l !== void 0 ? _l : this.source,
+                                redirectto: (_c = event.redirectto) !== null && _c !== void 0 ? _c : this.source,
                             },
                         });
                     }
@@ -244,16 +262,16 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
             subject: subject,
             dataschema: finalDataschema !== null && finalDataschema !== void 0 ? finalDataschema : undefined,
             data: finalData,
-            to: (_m = event.to) !== null && _m !== void 0 ? _m : event.type,
-            accesscontrol: (_p = (_o = event.accesscontrol) !== null && _o !== void 0 ? _o : sourceEvent.accesscontrol) !== null && _p !== void 0 ? _p : undefined,
+            to: (_d = event.to) !== null && _d !== void 0 ? _d : event.type,
+            accesscontrol: (_f = (_e = event.accesscontrol) !== null && _e !== void 0 ? _e : sourceEvent.accesscontrol) !== null && _f !== void 0 ? _f : undefined,
             // The orchestrator does not respect redirectto from the source event
-            redirectto: (_q = event.redirectto) !== null && _q !== void 0 ? _q : this.source,
-            executionunits: (_r = event.executionunits) !== null && _r !== void 0 ? _r : this.executionunits,
-            traceparent: (_s = otelHeaders.traceparent) !== null && _s !== void 0 ? _s : undefined,
-            tracestate: (_t = otelHeaders.tracestate) !== null && _t !== void 0 ? _t : undefined,
+            redirectto: (_g = event.redirectto) !== null && _g !== void 0 ? _g : this.source,
+            executionunits: (_h = event.executionunits) !== null && _h !== void 0 ? _h : this.executionunits,
+            traceparent: (_j = otelHeaders.traceparent) !== null && _j !== void 0 ? _j : undefined,
+            tracestate: (_k = otelHeaders.tracestate) !== null && _k !== void 0 ? _k : undefined,
             parentid: parentId,
             domain: domain !== null && domain !== void 0 ? domain : undefined,
-        }, (_u = event.__extensions) !== null && _u !== void 0 ? _u : {});
+        }, (_l = event.__extensions) !== null && _l !== void 0 ? _l : {});
         (0, arvo_core_1.logToSpan)({
             level: 'INFO',
             message: "Event created successfully: ".concat(emittableEvent.type),
@@ -262,12 +280,6 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
     };
     /**
      * Core orchestration method that executes state machines in response to events.
-     * Manages the complete event lifecycle:
-     * 1. Acquires lock and state
-     * 2. Validates events and contracts
-     * 3. Executes state machine
-     * 4. Persists new state
-     * 5. Generates response events with domain-based segregation
      *
      * @param event - Event triggering the execution
      * @param opentelemetry - OpenTelemetry configuration
@@ -310,7 +322,8 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
                                 },
                             disableSpanManagement: true,
                             fn: function (span) { return __awaiter(_this, void 0, void 0, function () {
-                                var otelHeaders, orchestrationParentSubject, initEventId, acquiredLock, parsedEventSubject, machine, _a, name_1, version, inputValidation, state, executionResult, rawMachineEmittedEvents, emittables, _i, rawMachineEmittedEvents_1, item, domains, _b, _c, _dom, evt, _d, _e, _f, key, value, error_2, e, parsedEventSubject, result, _g, _h, _dom, _j, _k, _l, key, value;
+                                var otelHeaders, orchestrationParentSubject, initEventId, acquiredLock, parsedEventSubject, machine, _a, name_1, version, inputValidation, state, executionResult, rawMachineEmittedEvents, emittables, _i, rawMachineEmittedEvents_1, item, createdDomain, _b, _c, _dom, evt, _d, _e, _f, key, value, error_2, e, parsedEventSubject, result, _g, _h, _dom, _j, _k, _l, key, value;
+                                var _this = this;
                                 var _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z;
                                 return __generator(this, function (_0) {
                                     switch (_0.label) {
@@ -450,16 +463,22 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
                                                     to: (_t = (_s = parsedEventSubject.meta) === null || _s === void 0 ? void 0 : _s.redirectto) !== null && _t !== void 0 ? _t : parsedEventSubject.execution.initiator,
                                                     domain: orchestrationParentSubject
                                                         ? [arvo_core_1.ArvoOrchestrationSubject.parse(orchestrationParentSubject).execution.domain]
-                                                        : [undefined],
+                                                        : [null],
                                                 });
                                             }
                                             emittables = [];
                                             for (_i = 0, rawMachineEmittedEvents_1 = rawMachineEmittedEvents; _i < rawMachineEmittedEvents_1.length; _i++) {
                                                 item = rawMachineEmittedEvents_1[_i];
-                                                domains = (_u = item.domain) !== null && _u !== void 0 ? _u : [null];
-                                                for (_b = 0, _c = Array.from(new Set(domains)); _b < _c.length; _b++) {
+                                                createdDomain = new Set();
+                                                for (_b = 0, _c = Array.from(new Set((_u = item.domain) !== null && _u !== void 0 ? _u : [null])); _b < _c.length; _b++) {
                                                     _dom = _c[_b];
                                                     evt = this.createEmittableEvent(item, machine, otelHeaders, orchestrationParentSubject, event, initEventId, _dom);
+                                                    // Making sure the raw event broadcast is actually unique as the
+                                                    // domain resolution (especially for symbolic) can only happen
+                                                    // in the createEmittableEvent
+                                                    if (createdDomain.has(evt.domain))
+                                                        continue;
+                                                    createdDomain.add(evt.domain);
                                                     emittables.push(evt);
                                                     for (_d = 0, _e = Object.entries(emittables[emittables.length - 1].otelAttributes); _d < _e.length; _d++) {
                                                         _f = _e[_d], key = _f[0], value = _f[1];
@@ -532,7 +551,16 @@ var ArvoOrchestrator = /** @class */ (function (_super) {
                                                 });
                                             }
                                             result = [];
-                                            for (_g = 0, _h = Array.from(new Set([event.domain, this.domain, null])); _g < _h.length; _g++) {
+                                            for (_g = 0, _h = Array.from(new Set(this.systemErrorDomain
+                                                ? this.systemErrorDomain.map(function (item) {
+                                                    return (0, ArvoDomain_1.resolveEventDomain)({
+                                                        domainToResolve: item,
+                                                        triggeringEvent: event,
+                                                        handlerSelfContract: _this.registry.machines[0].contracts.self,
+                                                        eventContract: _this.registry.machines[0].contracts.self,
+                                                    });
+                                                })
+                                                : [event.domain, this.domain, null])); _g < _h.length; _g++) {
                                                 _dom = _h[_g];
                                                 result.push((0, arvo_core_1.createArvoOrchestratorEventFactory)(this.registry.machines[0].contracts.self).systemError({
                                                     source: this.source,

package/dist/ArvoOrchestrator/types.d.ts

@@ -81,6 +81,10 @@ export interface IArvoOrchestrator {
     /** Engine responsible for machine execution */
     executionEngine: IMachineExectionEngine;
     requiresResourceLocking: boolean;
+    /**
+     * Optional configuration to customize where system error events are emitted.
+     */
+    systemErrorDomain?: (string | null)[];
 }
 /**
  * Configuration interface for creating an Arvo orchestrator instance.
@@ -95,4 +99,18 @@ export interface ICreateArvoOrchestrator {
      * All machines must have the same source identifier.
      */
     machines: ArvoMachine<any, any, any, any, any>[];
+    /**
+     * Optional configuration to customize where system error events are emitted.
+     *
+     * This overrides the default system error domain fallback of:
+     * `[event.domain, self.contract.domain, null]`
+     *
+     * Use this to precisely control the set of domains that should receive structured
+     * `sys.*.error` events when uncaught exceptions occur in the handler.
+     *
+     * Symbolic constants from {@link ArvoDomain} are supported.
+     *
+     * @default undefined — uses standard fallback broadcast domains
+     */
+    systemErrorDomain?: (string | null)[];
 }

package/dist/ArvoResumable/factory.d.ts

@@ -19,21 +19,12 @@ import { ArvoResumable } from '.';
  * @param param.handler - Versioned orchestration logic handlers mapped by semantic version
  * @param param.executionunits - Resource allocation cost for this orchestrator's execution (default: 0)
  * @param param.requiresResourceLocking - Enable distributed locking for concurrent safety (default: auto-determined by service count)
+ * @param param.systemErrorDomain - The domain override of the system error events. (default [event.domain, self.contract.domain, null])
  *
  * @returns A new ArvoResumable orchestrator instance configured with the provided parameters
  *
  * @throws {Error} Service contracts have duplicate URIs - Multiple versions of the same contract are not allowed
  * @throws {Error} Circular dependency detected - Self contract is registered as a service, creating execution loops
- *
- * @remarks
- * **Resource Locking:**
- * When `requiresResourceLocking` is not specified, it defaults to `true` when multiple
- * services are configured (indicating potential concurrent operations) and `false` for
- * single-service orchestrations.
- *
- * **Contract Validation:**
- * The factory validates that all service contracts have unique URIs and prevents
- * circular dependencies where the orchestrator's own contract is registered as a service.
  */
 export declare const createArvoResumable: <TMemory extends Record<string, any>, TSelfContract extends ArvoOrchestratorContract = ArvoOrchestratorContract, TServiceContract extends Record<string, VersionedArvoContract<any, any>> = Record<string, VersionedArvoContract<any, any>>>(param: {
     types?: {
@@ -47,4 +38,5 @@ export declare const createArvoResumable: <TMemory extends Record<string, any>,
     handler: ArvoResumableHandler<ArvoResumableState<TMemory>, TSelfContract, TServiceContract>;
     executionunits?: number;
     requiresResourceLocking?: boolean;
+    systemErrorDomain?: (string | null)[];
 }) => ArvoResumable<TMemory, TSelfContract, TServiceContract>;

package/dist/ArvoResumable/factory.js

@@ -32,21 +32,12 @@ var uuid_1 = require("uuid");
  * @param param.handler - Versioned orchestration logic handlers mapped by semantic version
  * @param param.executionunits - Resource allocation cost for this orchestrator's execution (default: 0)
  * @param param.requiresResourceLocking - Enable distributed locking for concurrent safety (default: auto-determined by service count)
+ * @param param.systemErrorDomain - The domain override of the system error events. (default [event.domain, self.contract.domain, null])
  *
  * @returns A new ArvoResumable orchestrator instance configured with the provided parameters
  *
  * @throws {Error} Service contracts have duplicate URIs - Multiple versions of the same contract are not allowed
  * @throws {Error} Circular dependency detected - Self contract is registered as a service, creating execution loops
- *
- * @remarks
- * **Resource Locking:**
- * When `requiresResourceLocking` is not specified, it defaults to `true` when multiple
- * services are configured (indicating potential concurrent operations) and `false` for
- * single-service orchestrations.
- *
- * **Contract Validation:**
- * The factory validates that all service contracts have unique URIs and prevents
- * circular dependencies where the orchestrator's own contract is registered as a service.
  */
 var createArvoResumable = function (param) {
     var _a;
@@ -65,6 +56,7 @@ var createArvoResumable = function (param) {
         handler: param.handler,
         executionunits: (_b = param.executionunits) !== null && _b !== void 0 ? _b : 0,
         requiresResourceLocking: (_c = param.requiresResourceLocking) !== null && _c !== void 0 ? _c : Object.keys(param.contracts.services).length > 1,
+        systemErrorDomain: param.systemErrorDomain,
     });
 };
 exports.createArvoResumable = createArvoResumable;

package/dist/ArvoResumable/index.d.ts

@@ -42,6 +42,7 @@ export declare class ArvoResumable<TMemory extends Record<string, any> = Record<
     readonly syncEventResource: SyncEventResource<ArvoResumableState<TMemory>>;
     readonly source: string;
     readonly handler: ArvoResumableHandler<ArvoResumableState<TMemory>, TSelfContract, TServiceContract>;
+    readonly systemErrorDomain?: (string | null)[];
     readonly contracts: {
         self: TSelfContract;
         services: TServiceContract;
@@ -58,6 +59,7 @@ export declare class ArvoResumable<TMemory extends Record<string, any> = Record<
         memory: IMachineMemory<ArvoResumableState<TMemory>>;
         requiresResourceLocking?: boolean;
         handler: ArvoResumableHandler<ArvoResumableState<TMemory>, TSelfContract, TServiceContract>;
+        systemErrorDomain?: (string | null)[];
     });
     protected validateInput(event: ArvoEvent): {
         contractType: 'self' | 'service';
@@ -75,23 +77,10 @@ export declare class ArvoResumable<TMemory extends Record<string, any> = Record<
      * @throws {ContractViolation} On schema/contract mismatch
      * @throws {ExecutionViolation} On invalid parentSubject$$ format
      */
-    protected createEmittableEvent(event: EnqueueArvoEventActionParam, otelHeaders: OpenTelemetryHeaders, orchestrationParentSubject: string | null, sourceEvent: ArvoEvent, selfVersionedContract: VersionedArvoContract<TSelfContract, ArvoSemanticVersion>, initEventId: string, _domain: string | null | undefined): ArvoEvent;
+    protected createEmittableEvent(event: EnqueueArvoEventActionParam, otelHeaders: OpenTelemetryHeaders, orchestrationParentSubject: string | null, sourceEvent: ArvoEvent, selfVersionedContract: VersionedArvoContract<TSelfContract, ArvoSemanticVersion>, initEventId: string, _domain: string | null): ArvoEvent;
     /**
      * Executes the orchestration workflow for an incoming event
      *
-     * This is the main orchestration entry point that coordinates the complete event
-     * processing lifecycle. It implements the core workflow execution pattern including
-     * validation, locking, state management, handler invocation, event creation, and
-     * persistence with comprehensive error handling and observability.
-     *
-     * The execution process follows these phases:
-     * 1. **Validation & Setup** - Subject parsing, handler resolution, contract validation
-     * 2. **Resource Management** - Distributed lock acquisition and state loading
-     * 3. **Handler Execution** - Context preparation and user handler invocation
-     * 4. **Event Processing** - Result transformation and emittable event creation
-     * 5. **State Persistence** - Atomic state updates and event tracking
-     * 6. **Cleanup & Return** - Resource release and structured result return
-     *
      * @param event - The triggering event to process
      * @param opentelemetry - OpenTelemetry configuration for trace inheritance
      *
@@ -101,26 +90,6 @@ export declare class ArvoResumable<TMemory extends Record<string, any> = Record<
      * @throws {ConfigViolation} When handler resolution or contract validation fails
      * @throws {ContractViolation} When event schema validation fails
      * @throws {ExecutionViolation} When workflow execution encounters critical errors
-     *
-     * @remarks
-     * **Execution Safety:**
-     * The method implements comprehensive error recovery with proper resource cleanup
-     * in all execution paths. ViolationErrors are rethrown for system handling while
-     * workflow errors become system error events for graceful degradation.
-     *
-     * **State Management:**
-     * Workflow state is managed atomically with optimistic concurrency control.
-     * Status transitions from 'active' to 'done' occur only when completion events
-     * are generated, ensuring proper workflow lifecycle management.
-     *
-     * **Observability:**
-     * Complete execution is traced using OpenTelemetry with detailed span attributes
-     * for debugging and monitoring. Event metadata includes processing context and
-     * routing information for operational visibility.
-     *
-     * **Terminal State Handling:**
-     * Workflows in 'done' status ignore additional events to prevent state corruption
-     * while preserving audit trails for completed workflow executions.
      */
     execute(event: ArvoEvent, opentelemetry: ArvoEventHandlerOpenTelemetryOptions): Promise<{
         events: ArvoEvent[];

package/dist/ArvoResumable/index.js

@@ -82,6 +82,7 @@ var index_1 = require("../SyncEventResource/index");
 var index_2 = require("../utils/index");
 var AbstractArvoEventHandler_1 = __importDefault(require("../AbstractArvoEventHandler"));
 var errors_1 = require("../errors");
+var ArvoDomain_1 = require("../ArvoDomain");
 /**
  * ArvoResumable - A stateful orchestration handler for managing distributed workflows
  *
@@ -118,11 +119,13 @@ var ArvoResumable = /** @class */ (function (_super) {
     function ArvoResumable(param) {
         var _a;
         var _this = _super.call(this) || this;
+        _this.systemErrorDomain = [];
         _this.executionunits = param.executionunits;
         _this.source = param.contracts.self.type;
         _this.syncEventResource = new index_1.SyncEventResource(param.memory, (_a = param.requiresResourceLocking) !== null && _a !== void 0 ? _a : true);
         _this.contracts = param.contracts;
         _this.handler = param.handler;
+        _this.systemErrorDomain = param.systemErrorDomain;
         return _this;
     }
     Object.defineProperty(ArvoResumable.prototype, "requiresResourceLocking", {
@@ -208,7 +211,7 @@ var ArvoResumable = /** @class */ (function (_super) {
      * @throws {ExecutionViolation} On invalid parentSubject$$ format
      */
     ArvoResumable.prototype.createEmittableEvent = function (event, otelHeaders, orchestrationParentSubject, sourceEvent, selfVersionedContract, initEventId, _domain) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
         (0, arvo_core_1.logToSpan)({
             level: 'INFO',
             message: "Creating emittable event: ".concat(event.type),
@@ -218,7 +221,12 @@ var ArvoResumable = /** @class */ (function (_super) {
         var contract = null;
         var subject = sourceEvent.subject;
         var parentId = sourceEvent.id;
-        var domain = _domain === undefined ? ((_b = (_a = sourceEvent.domain) !== null && _a !== void 0 ? _a : this.domain) !== null && _b !== void 0 ? _b : null) : _domain;
+        var domain = (0, ArvoDomain_1.resolveEventDomain)({
+            domainToResolve: _domain,
+            handlerSelfContract: selfVersionedContract,
+            eventContract: null,
+            triggeringEvent: sourceEvent,
+        });
         if (event.type === selfVersionedContract.metadata.completeEventType) {
             (0, arvo_core_1.logToSpan)({
                 level: 'INFO',
@@ -228,8 +236,12 @@ var ArvoResumable = /** @class */ (function (_super) {
             schema = selfVersionedContract.emits[selfVersionedContract.metadata.completeEventType];
             subject = orchestrationParentSubject !== null && orchestrationParentSubject !== void 0 ? orchestrationParentSubject : sourceEvent.subject;
             parentId = initEventId;
-            domain =
-                _domain === undefined ? ((_e = (_d = (_c = selfVersionedContract.domain) !== null && _c !== void 0 ? _c : sourceEvent.domain) !== null && _d !== void 0 ? _d : this.domain) !== null && _e !== void 0 ? _e : null) : _domain;
+            domain = (0, ArvoDomain_1.resolveEventDomain)({
+                domainToResolve: _domain,
+                handlerSelfContract: selfVersionedContract,
+                eventContract: selfVersionedContract,
+                triggeringEvent: sourceEvent,
+            });
         }
         else if (serviceContract[event.type]) {
             (0, arvo_core_1.logToSpan)({
@@ -238,7 +250,12 @@ var ArvoResumable = /** @class */ (function (_super) {
             });
             contract = serviceContract[event.type];
             schema = serviceContract[event.type].accepts.schema;
-            domain = _domain === undefined ? ((_h = (_g = (_f = contract === null || contract === void 0 ? void 0 : contract.domain) !== null && _f !== void 0 ? _f : sourceEvent.domain) !== null && _g !== void 0 ? _g : this.domain) !== null && _h !== void 0 ? _h : null) : _domain;
+            domain = (0, ArvoDomain_1.resolveEventDomain)({
+                domainToResolve: _domain,
+                handlerSelfContract: selfVersionedContract,
+                eventContract: contract,
+                triggeringEvent: sourceEvent,
+            });
             // If the event is to call another orchestrator then, extract the parent subject
             // passed to it and then form an new subject. This allows for event chaining
             // between orchestrators
@@ -247,8 +264,8 @@ var ArvoResumable = /** @class */ (function (_super) {
                     try {
                         arvo_core_1.ArvoOrchestrationSubject.parse(event.data.parentSubject$$);
                     }
-                    catch (_v) {
-                        throw new errors_1.ExecutionViolation("Invalid parentSubject$$ for the event(type='".concat(event.type, "', uri='").concat((_j = event.dataschema) !== null && _j !== void 0 ? _j : arvo_core_1.EventDataschemaUtil.create(contract), "').It must be follow the ArvoOrchestrationSubject schema. The easiest way is to use the current orchestration subject by storing the subject via the context block in the machine definition."));
+                    catch (_m) {
+                        throw new errors_1.ExecutionViolation("Invalid parentSubject$$ for the event(type='".concat(event.type, "', uri='").concat((_a = event.dataschema) !== null && _a !== void 0 ? _a : arvo_core_1.EventDataschemaUtil.create(contract), "').It must be follow the ArvoOrchestrationSubject schema. The easiest way is to use the current orchestration subject by storing the subject via the context block in the machine definition."));
                     }
                 }
                 try {
@@ -259,7 +276,7 @@ var ArvoResumable = /** @class */ (function (_super) {
                             subject: event.data.parentSubject$$,
                             domain: domain !== null && domain !== void 0 ? domain : null,
                             meta: {
-                                redirectto: (_k = event.redirectto) !== null && _k !== void 0 ? _k : this.source,
+                                redirectto: (_b = event.redirectto) !== null && _b !== void 0 ? _b : this.source,
                             },
                         });
                     }
@@ -270,7 +287,7 @@ var ArvoResumable = /** @class */ (function (_super) {
                             initiator: this.source,
                             domain: domain !== null && domain !== void 0 ? domain : undefined,
                             meta: {
-                                redirectto: (_l = event.redirectto) !== null && _l !== void 0 ? _l : this.source,
+                                redirectto: (_c = event.redirectto) !== null && _c !== void 0 ? _c : this.source,
                             },
                         });
                     }
@@ -305,16 +322,16 @@ var ArvoResumable = /** @class */ (function (_super) {
             subject: subject,
             dataschema: finalDataschema !== null && finalDataschema !== void 0 ? finalDataschema : undefined,
             data: finalData,
-            to: (_m = event.to) !== null && _m !== void 0 ? _m : event.type,
-            accesscontrol: (_p = (_o = event.accesscontrol) !== null && _o !== void 0 ? _o : sourceEvent.accesscontrol) !== null && _p !== void 0 ? _p : undefined,
+            to: (_d = event.to) !== null && _d !== void 0 ? _d : event.type,
+            accesscontrol: (_f = (_e = event.accesscontrol) !== null && _e !== void 0 ? _e : sourceEvent.accesscontrol) !== null && _f !== void 0 ? _f : undefined,
             // The orchestrator/ resumable does not respect redirectto from the source event
-            redirectto: (_q = event.redirectto) !== null && _q !== void 0 ? _q : this.source,
-            executionunits: (_r = event.executionunits) !== null && _r !== void 0 ? _r : this.executionunits,
-            traceparent: (_s = otelHeaders.traceparent) !== null && _s !== void 0 ? _s : undefined,
-            tracestate: (_t = otelHeaders.tracestate) !== null && _t !== void 0 ? _t : undefined,
+            redirectto: (_g = event.redirectto) !== null && _g !== void 0 ? _g : this.source,
+            executionunits: (_h = event.executionunits) !== null && _h !== void 0 ? _h : this.executionunits,
+            traceparent: (_j = otelHeaders.traceparent) !== null && _j !== void 0 ? _j : undefined,
+            tracestate: (_k = otelHeaders.tracestate) !== null && _k !== void 0 ? _k : undefined,
             parentid: parentId,
             domain: domain !== null && domain !== void 0 ? domain : undefined,
-        }, (_u = event.__extensions) !== null && _u !== void 0 ? _u : {});
+        }, (_l = event.__extensions) !== null && _l !== void 0 ? _l : {});
         (0, arvo_core_1.logToSpan)({
             level: 'INFO',
             message: "Event created successfully: ".concat(emittableEvent.type),
@@ -324,19 +341,6 @@ var ArvoResumable = /** @class */ (function (_super) {
     /**
      * Executes the orchestration workflow for an incoming event
      *
-     * This is the main orchestration entry point that coordinates the complete event
-     * processing lifecycle. It implements the core workflow execution pattern including
-     * validation, locking, state management, handler invocation, event creation, and
-     * persistence with comprehensive error handling and observability.
-     *
-     * The execution process follows these phases:
-     * 1. **Validation & Setup** - Subject parsing, handler resolution, contract validation
-     * 2. **Resource Management** - Distributed lock acquisition and state loading
-     * 3. **Handler Execution** - Context preparation and user handler invocation
-     * 4. **Event Processing** - Result transformation and emittable event creation
-     * 5. **State Persistence** - Atomic state updates and event tracking
-     * 6. **Cleanup & Return** - Resource release and structured result return
-     *
      * @param event - The triggering event to process
      * @param opentelemetry - OpenTelemetry configuration for trace inheritance
      *
@@ -346,26 +350,6 @@ var ArvoResumable = /** @class */ (function (_super) {
      * @throws {ConfigViolation} When handler resolution or contract validation fails
      * @throws {ContractViolation} When event schema validation fails
      * @throws {ExecutionViolation} When workflow execution encounters critical errors
-     *
-     * @remarks
-     * **Execution Safety:**
-     * The method implements comprehensive error recovery with proper resource cleanup
-     * in all execution paths. ViolationErrors are rethrown for system handling while
-     * workflow errors become system error events for graceful degradation.
-     *
-     * **State Management:**
-     * Workflow state is managed atomically with optimistic concurrency control.
-     * Status transitions from 'active' to 'done' occur only when completion events
-     * are generated, ensuring proper workflow lifecycle management.
-     *
-     * **Observability:**
-     * Complete execution is traced using OpenTelemetry with detailed span attributes
-     * for debugging and monitoring. Event metadata includes processing context and
-     * routing information for operational visibility.
-     *
-     * **Terminal State Handling:**
-     * Workflows in 'done' status ignore additional events to prevent state corruption
-     * while preserving audit trails for completed workflow executions.
      */
     ArvoResumable.prototype.execute = function (event, opentelemetry) {
         return __awaiter(this, void 0, void 0, function () {
@@ -373,7 +357,7 @@ var ArvoResumable = /** @class */ (function (_super) {
             var _this = this;
             return __generator(this, function (_b) {
                 return [2 /*return*/, arvo_core_1.ArvoOpenTelemetry.getInstance().startActiveSpan({
-                        name: "ArvoResumable<".concat(this.contracts.self.uri, ">@<").concat(event.type, ">"),
+                        name: "Resumable<".concat(this.contracts.self.uri, ">@<").concat(event.type, ">"),
                         spanOptions: {
                             kind: api_1.SpanKind.PRODUCER,
                             attributes: __assign((_a = {}, _a[arvo_core_1.ArvoExecution.ATTR_SPAN_KIND] = arvo_core_1.ArvoExecutionSpanKind.ORCHESTRATOR, _a[arvo_core_1.OpenInference.ATTR_SPAN_KIND] = arvo_core_1.OpenInferenceSpanKind.CHAIN, _a), Object.fromEntries(Object.entries(event.otelAttributes).map(function (_a) {
@@ -395,7 +379,8 @@ var ArvoResumable = /** @class */ (function (_super) {
                             },
                         disableSpanManagement: true,
                         fn: function (span) { return __awaiter(_this, void 0, void 0, function () {
-                            var otelHeaders, orchestrationParentSubject, acquiredLock, initEventId, parsedEventSubject, contractType, state, eventTypeToExpectedEvent, _i, _a, _b, _, eventList, _c, eventList_1, _evt, handler, executionResult, emittables, _d, _e, item, domains, _f, _g, _dom, evt, _h, _j, _k, key, value, eventTrackingState, error_2, e, parsedEventSubject, result, _l, _m, _dom, _o, _p, _q, key, value;
+                            var otelHeaders, orchestrationParentSubject, acquiredLock, initEventId, parsedEventSubject, contractType, state, eventTypeToExpectedEvent, _i, _a, _b, _, eventList, _c, eventList_1, _evt, handler, executionResult, emittables, _d, _e, item, createdDomain, _f, _g, _dom, evt, _h, _j, _k, key, value, eventTrackingState, error_2, e, parsedEventSubject, result, _l, _m, _dom, _o, _p, _q, key, value;
+                            var _this = this;
                             var _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12;
                             return __generator(this, function (_13) {
                                 switch (_13.label) {
@@ -536,6 +521,10 @@ var ArvoResumable = /** @class */ (function (_super) {
                                                 context: (_1 = state === null || state === void 0 ? void 0 : state.state$$) !== null && _1 !== void 0 ? _1 : null,
                                                 metadata: state !== null && state !== void 0 ? state : null,
                                                 collectedEvents: eventTypeToExpectedEvent,
+                                                domain: {
+                                                    event: event.domain,
+                                                    self: this.contracts.self.domain,
+                                                },
                                                 input: contractType === 'self' ? event.toJSON() : null,
                                                 service: contractType === 'service' ? event.toJSON() : null,
                                                 contracts: {
@@ -554,15 +543,21 @@ var ArvoResumable = /** @class */ (function (_super) {
                                                     to: (_3 = (_2 = parsedEventSubject.meta) === null || _2 === void 0 ? void 0 : _2.redirectto) !== null && _3 !== void 0 ? _3 : parsedEventSubject.execution.initiator,
                                                     domain: orchestrationParentSubject
                                                         ? [arvo_core_1.ArvoOrchestrationSubject.parse(orchestrationParentSubject).execution.domain]
-                                                        : [undefined],
+                                                        : [null],
                                                 },
                                             ]
                                             : []), true), ((_4 = executionResult === null || executionResult === void 0 ? void 0 : executionResult.services) !== null && _4 !== void 0 ? _4 : []), true); _d < _e.length; _d++) {
                                             item = _e[_d];
-                                            domains = (_5 = item.domain) !== null && _5 !== void 0 ? _5 : [null];
-                                            for (_f = 0, _g = Array.from(new Set(domains)); _f < _g.length; _f++) {
+                                            createdDomain = new Set(null);
+                                            for (_f = 0, _g = Array.from(new Set((_5 = item.domain) !== null && _5 !== void 0 ? _5 : [null])); _f < _g.length; _f++) {
                                                 _dom = _g[_f];
                                                 evt = this.createEmittableEvent(item, otelHeaders, orchestrationParentSubject, event, this.contracts.self.version(parsedEventSubject.orchestrator.version), initEventId, _dom);
+                                                // Making sure the raw event broadcast is actually unique as the
+                                                // domain resolution (especially for symbolic) can only happen
+                                                // in the createEmittableEvent
+                                                if (createdDomain.has(evt.domain))
+                                                    continue;
+                                                createdDomain.add(evt.domain);
                                                 emittables.push(evt);
                                                 for (_h = 0, _j = Object.entries(emittables[emittables.length - 1].otelAttributes); _h < _j.length; _h++) {
                                                     _k = _j[_h], key = _k[0], value = _k[1];
@@ -637,9 +632,18 @@ var ArvoResumable = /** @class */ (function (_super) {
                                             });
                                         }
                                         result = [];
-                                        for (_l = 0, _m = Array.from(new Set([event.domain, this.domain, null])); _l < _m.length; _l++) {
+                                        for (_l = 0, _m = Array.from(new Set(this.systemErrorDomain
+                                            ? this.systemErrorDomain.map(function (item) {
+                                                return (0, ArvoDomain_1.resolveEventDomain)({
+                                                    domainToResolve: item,
+                                                    handlerSelfContract: _this.contracts.self.version('latest'),
+                                                    eventContract: _this.contracts.self.version('latest'),
+                                                    triggeringEvent: event,
+                                                });
+                                            })
+                                            : [event.domain, this.domain, null])); _l < _m.length; _l++) {
                                             _dom = _m[_l];
-                                            result.push((0, arvo_core_1.createArvoOrchestratorEventFactory)(this.contracts.self.version('any')).systemError({
+                                            result.push((0, arvo_core_1.createArvoOrchestratorEventFactory)(this.contracts.self.version('latest')).systemError({
                                                 source: this.source,
                                                 // If the initiator of the workflow exist then match the
                                                 // subject so that it can incorporate it in its state. If

package/dist/ArvoResumable/types.d.ts

@@ -22,6 +22,10 @@ type Handler<TState extends ArvoResumableState<Record<string, any>>, TSelfContra
     collectedEvents: Partial<{
         [K in AllServiceEventTypes<TServiceContract>]: ServiceEventTypeMap<TServiceContract>[K][];
     }>;
+    domain: {
+        event: string | null;
+        self: string | null;
+    };
     context: TState['state$$'] | null;
     input: InferVersionedArvoContract<TSelfContract>['accepts'] | null;
     service: {

package/dist/index.d.ts

@@ -26,8 +26,9 @@ import { createSimpleEventBroker } from './utils/SimpleEventBroker/helper';
 import { ArvoResumable } from './ArvoResumable';
 import { createArvoResumable } from './ArvoResumable/factory';
 import { ArvoResumableHandler, ArvoResumableState } from './ArvoResumable/types';
+import { ArvoDomain, resolveEventDomain } from './ArvoDomain';
 declare const xstate: {
     emit: typeof emit;
     assign: typeof assign;
 };
-export { ArvoEventHandler, createArvoEventHandler, IArvoEventHandler, ArvoEventHandlerFunctionOutput, ArvoEventHandlerFunctionInput, ArvoEventHandlerFunction, PartialExcept, isNullOrUndefined, getValueOrDefault, coalesce, coalesceOrDefault, AbstractArvoEventHandler, ArvoEventHandlerOpenTelemetryOptions, EventHandlerFactory, ContractViolation, ConfigViolation, ExecutionViolation, ArvoMachine, setupArvoMachine, ArvoMachineContext, EnqueueArvoEventActionParam, IMachineRegistry, MachineRegistry, MachineExecutionEngine, IMachineExectionEngine, ExecuteMachineInput, ExecuteMachineOutput, IMachineMemory, SimpleMachineMemory, MachineMemoryRecord, IArvoOrchestrator, TransactionViolation, TransactionViolationCause, ArvoOrchestrator, createArvoOrchestrator, SimpleEventBroker, createSimpleEventBroker, TelemetredSimpleMachineMemory, xstate, ArvoResumable, createArvoResumable, ArvoResumableHandler, ArvoResumableState, };
+export { ArvoEventHandler, createArvoEventHandler, IArvoEventHandler, ArvoEventHandlerFunctionOutput, ArvoEventHandlerFunctionInput, ArvoEventHandlerFunction, PartialExcept, isNullOrUndefined, getValueOrDefault, coalesce, coalesceOrDefault, AbstractArvoEventHandler, ArvoEventHandlerOpenTelemetryOptions, EventHandlerFactory, ContractViolation, ConfigViolation, ExecutionViolation, ArvoMachine, setupArvoMachine, ArvoMachineContext, EnqueueArvoEventActionParam, IMachineRegistry, MachineRegistry, MachineExecutionEngine, IMachineExectionEngine, ExecuteMachineInput, ExecuteMachineOutput, IMachineMemory, SimpleMachineMemory, MachineMemoryRecord, IArvoOrchestrator, TransactionViolation, TransactionViolationCause, ArvoOrchestrator, createArvoOrchestrator, SimpleEventBroker, createSimpleEventBroker, TelemetredSimpleMachineMemory, xstate, ArvoResumable, createArvoResumable, ArvoResumableHandler, ArvoResumableState, ArvoDomain, resolveEventDomain, };