arvo-event-handler 3.0.7 → 3.0.10

package/dist/ArvoResumable/types.d.ts

@@ -1,6 +1,7 @@
-import type { VersionedArvoContract, ArvoSemanticVersion, InferVersionedArvoContract, ArvoContract, ArvoEvent, InferArvoEvent, CreateArvoEvent } from 'arvo-core';
-import type { EnqueueArvoEventActionParam } from '../ArvoMachine/types';
 import type { Span } from '@opentelemetry/api';
+import type { ArvoContract, ArvoEvent, ArvoSemanticVersion, CreateArvoEvent, InferArvoEvent, InferVersionedArvoContract, VersionedArvoContract } from 'arvo-core';
+import type { EnqueueArvoEventActionParam } from '../ArvoMachine/types';
+import type { OrchestrationExecutionMemoryRecord } from '../ArvoOrchestrationUtils/orchestrationExecutionState';
 type ExtractServiceEventTypes<TServiceContract extends Record<string, VersionedArvoContract<any, any>>> = {
     [K in keyof TServiceContract]: {
         [L in keyof InferVersionedArvoContract<TServiceContract[K]>['emits']]: {
@@ -88,7 +89,7 @@ type Handler<TState extends ArvoResumableState<Record<string, any>>, TSelfContra
 export type ArvoResumableHandler<TState extends ArvoResumableState<Record<string, any>>, TSelfContract extends ArvoContract, TServiceContract extends Record<string, VersionedArvoContract<any, any>>> = {
     [V in ArvoSemanticVersion & keyof TSelfContract['versions']]: Handler<TState, VersionedArvoContract<TSelfContract, V>, TServiceContract>;
 };
-export type ArvoResumableState<T extends Record<string, any>> = {
+export type ArvoResumableState<T extends Record<string, any>> = OrchestrationExecutionMemoryRecord<{
     /**
      * Current execution status of the orchestration workflow
      *
@@ -149,5 +150,5 @@ export type ArvoResumableState<T extends Record<string, any>> = {
     };
     /** The state used by the resumable */
     state$$: T | null;
-};
+}>;
 export {};

package/dist/IArvoEventHandler/index.d.ts

@@ -21,9 +21,8 @@ export default interface IArvoEventHandler {
      * @returns A promise that resolves to an array of resulting Arvo events.
      * These events represent the outcome of processing the input event.
      */
-    execute(event: ArvoEvent, opentelemetry: ArvoEventHandlerOpenTelemetryOptions): Promise<{
+    execute(event: ArvoEvent, opentelemetry?: ArvoEventHandlerOpenTelemetryOptions): Promise<{
         events: ArvoEvent[];
-        metadata?: Record<string, any>;
     }>;
     /**
      * Provides the schema for system error events.

package/dist/MachineExecutionEngine/index.d.ts

@@ -1,6 +1,6 @@
+import type { ArvoEventHandlerOpenTelemetryOptions } from '../types';
 import type { IMachineExectionEngine } from './interface';
 import type { ExecuteMachineInput, ExecuteMachineOutput } from './types';
-import type { ArvoEventHandlerOpenTelemetryOptions } from '../types';
 /**
  * Handles state machine execution, event processing, and lifecycle management.
  */

package/dist/MachineRegistry/index.d.ts

@@ -1,7 +1,7 @@
 import { type ArvoEvent } from 'arvo-core';
 import type ArvoMachine from '../ArvoMachine';
-import type { IMachineRegistry } from './interface';
 import type { ArvoEventHandlerOpenTelemetryOptions } from '../types';
+import type { IMachineRegistry } from './interface';
 /**
  * Registry for managing and resolving ArvoMachine instances.
  * Provides functionality to store multiple machine instances and resolve them based on events.

package/dist/SyncEventResource/index.d.ts

@@ -1,7 +1,7 @@
+import type { Span } from '@opentelemetry/api';
 import { type ArvoEvent } from 'arvo-core';
 import type { IMachineMemory } from '../MachineMemory/interface';
 import type { AcquiredLockStatusType, ReleasedLockStatusType } from './types';
-import type { Span } from '@opentelemetry/api';
 /**
  * A synchronous event resource that manages machine memory state based on event subjects.
  *

package/dist/SyncEventResource/index.js

@@ -38,7 +38,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SyncEventResource = void 0;
 var arvo_core_1 = require("arvo-core");
-var error_1 = require("../ArvoOrchestrator/error");
+var error_1 = require("../ArvoOrchestrationUtils/error");
 var errors_1 = require("../errors");
 /**
  * A synchronous event resource that manages machine memory state based on event subjects.

package/dist/index.d.ts

@@ -1,18 +1,20 @@
-import IArvoEventHandler from './IArvoEventHandler';
+import { assign, emit } from 'xstate';
+import { ArvoDomain, resolveEventDomain } from './ArvoDomain';
 import ArvoEventHandler from './ArvoEventHandler';
 import { createArvoEventHandler } from './ArvoEventHandler/helpers';
 import { ArvoEventHandlerFunction, ArvoEventHandlerFunctionInput, ArvoEventHandlerFunctionOutput } from './ArvoEventHandler/types';
-import { ConfigViolation, ContractViolation, ExecutionViolation } from './errors';
-import { ArvoEventHandlerOpenTelemetryOptions, EventHandlerFactory, PartialExcept } from './types';
-import { coalesce, coalesceOrDefault, getValueOrDefault, isNullOrUndefined } from './utils';
-import { assign, emit } from 'xstate';
 import ArvoMachine from './ArvoMachine';
 import { setupArvoMachine } from './ArvoMachine/createMachine';
 import { ArvoMachineContext, EnqueueArvoEventActionParam } from './ArvoMachine/types';
+import { TransactionViolation, TransactionViolationCause, isTransactionViolationError } from './ArvoOrchestrationUtils/error';
+import { OrchestrationExecutionStatus } from './ArvoOrchestrationUtils/orchestrationExecutionState';
 import { ArvoOrchestrator } from './ArvoOrchestrator';
-import { TransactionViolation, TransactionViolationCause } from './ArvoOrchestrator/error';
 import { createArvoOrchestrator } from './ArvoOrchestrator/factory';
 import { ArvoOrchestratorParam, MachineMemoryRecord } from './ArvoOrchestrator/types';
+import { ArvoResumable } from './ArvoResumable';
+import { createArvoResumable } from './ArvoResumable/factory';
+import { ArvoResumableHandler, ArvoResumableState } from './ArvoResumable/types';
+import IArvoEventHandler from './IArvoEventHandler';
 import { MachineExecutionEngine } from './MachineExecutionEngine';
 import { IMachineExectionEngine } from './MachineExecutionEngine/interface';
 import { ExecuteMachineInput, ExecuteMachineOutput } from './MachineExecutionEngine/types';
@@ -21,14 +23,13 @@ import { TelemetredSimpleMachineMemory } from './MachineMemory/TelemetredSimple'
 import { IMachineMemory } from './MachineMemory/interface';
 import { MachineRegistry } from './MachineRegistry';
 import { IMachineRegistry } from './MachineRegistry/interface';
+import { ConfigViolation, ContractViolation, ExecutionViolation } from './errors';
+import { ArvoEventHandlerOpenTelemetryOptions, ArvoEventHandlerOtelSpanOptions, EventHandlerFactory, PartialExcept } from './types';
+import { coalesce, coalesceOrDefault, getValueOrDefault, isNullOrUndefined } from './utils';
 import { SimpleEventBroker } from './utils/SimpleEventBroker';
 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, IArvoEventHandler as AbstractArvoEventHandler, ArvoEventHandlerOpenTelemetryOptions, EventHandlerFactory, ContractViolation, ConfigViolation, ExecutionViolation, ArvoMachine, setupArvoMachine, ArvoMachineContext, EnqueueArvoEventActionParam, IMachineRegistry, MachineRegistry, MachineExecutionEngine, IMachineExectionEngine, ExecuteMachineInput, ExecuteMachineOutput, IMachineMemory, SimpleMachineMemory, MachineMemoryRecord, ArvoOrchestratorParam as IArvoOrchestrator, TransactionViolation, TransactionViolationCause, ArvoOrchestrator, createArvoOrchestrator, SimpleEventBroker, createSimpleEventBroker, TelemetredSimpleMachineMemory, xstate, ArvoResumable, createArvoResumable, ArvoResumableHandler, ArvoResumableState, ArvoDomain, resolveEventDomain, };
+export { ArvoEventHandler, createArvoEventHandler, IArvoEventHandler, ArvoEventHandlerFunctionOutput, ArvoEventHandlerFunctionInput, ArvoEventHandlerFunction, PartialExcept, isNullOrUndefined, getValueOrDefault, coalesce, coalesceOrDefault, ArvoEventHandlerOpenTelemetryOptions, EventHandlerFactory, ContractViolation, ConfigViolation, ExecutionViolation, ArvoMachine, setupArvoMachine, ArvoMachineContext, EnqueueArvoEventActionParam, IMachineRegistry, MachineRegistry, MachineExecutionEngine, IMachineExectionEngine, ExecuteMachineInput, ExecuteMachineOutput, IMachineMemory, SimpleMachineMemory, MachineMemoryRecord, ArvoOrchestratorParam, TransactionViolation, TransactionViolationCause, ArvoOrchestrator, createArvoOrchestrator, SimpleEventBroker, createSimpleEventBroker, TelemetredSimpleMachineMemory, xstate, ArvoResumable, createArvoResumable, ArvoResumableHandler, ArvoResumableState, ArvoDomain, resolveEventDomain, isTransactionViolationError, OrchestrationExecutionStatus, ArvoEventHandlerOtelSpanOptions, };

package/dist/index.js

@@ -3,32 +3,33 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveEventDomain = exports.ArvoDomain = exports.createArvoResumable = exports.ArvoResumable = exports.xstate = exports.TelemetredSimpleMachineMemory = exports.createSimpleEventBroker = exports.SimpleEventBroker = exports.createArvoOrchestrator = exports.ArvoOrchestrator = exports.TransactionViolationCause = exports.TransactionViolation = exports.SimpleMachineMemory = exports.MachineExecutionEngine = exports.MachineRegistry = exports.setupArvoMachine = exports.ArvoMachine = exports.ExecutionViolation = exports.ConfigViolation = exports.ContractViolation = exports.coalesceOrDefault = exports.coalesce = exports.getValueOrDefault = exports.isNullOrUndefined = exports.createArvoEventHandler = exports.ArvoEventHandler = void 0;
+exports.OrchestrationExecutionStatus = exports.isTransactionViolationError = exports.resolveEventDomain = exports.ArvoDomain = exports.createArvoResumable = exports.ArvoResumable = exports.xstate = exports.TelemetredSimpleMachineMemory = exports.createSimpleEventBroker = exports.SimpleEventBroker = exports.createArvoOrchestrator = exports.ArvoOrchestrator = exports.TransactionViolationCause = exports.TransactionViolation = exports.SimpleMachineMemory = exports.MachineExecutionEngine = exports.MachineRegistry = exports.setupArvoMachine = exports.ArvoMachine = exports.ExecutionViolation = exports.ConfigViolation = exports.ContractViolation = exports.coalesceOrDefault = exports.coalesce = exports.getValueOrDefault = exports.isNullOrUndefined = exports.createArvoEventHandler = exports.ArvoEventHandler = void 0;
+var xstate_1 = require("xstate");
+var ArvoDomain_1 = require("./ArvoDomain");
+Object.defineProperty(exports, "ArvoDomain", { enumerable: true, get: function () { return ArvoDomain_1.ArvoDomain; } });
+Object.defineProperty(exports, "resolveEventDomain", { enumerable: true, get: function () { return ArvoDomain_1.resolveEventDomain; } });
 var ArvoEventHandler_1 = __importDefault(require("./ArvoEventHandler"));
 exports.ArvoEventHandler = ArvoEventHandler_1.default;
 var helpers_1 = require("./ArvoEventHandler/helpers");
 Object.defineProperty(exports, "createArvoEventHandler", { enumerable: true, get: function () { return helpers_1.createArvoEventHandler; } });
-var errors_1 = require("./errors");
-Object.defineProperty(exports, "ConfigViolation", { enumerable: true, get: function () { return errors_1.ConfigViolation; } });
-Object.defineProperty(exports, "ContractViolation", { enumerable: true, get: function () { return errors_1.ContractViolation; } });
-Object.defineProperty(exports, "ExecutionViolation", { enumerable: true, get: function () { return errors_1.ExecutionViolation; } });
-var utils_1 = require("./utils");
-Object.defineProperty(exports, "coalesce", { enumerable: true, get: function () { return utils_1.coalesce; } });
-Object.defineProperty(exports, "coalesceOrDefault", { enumerable: true, get: function () { return utils_1.coalesceOrDefault; } });
-Object.defineProperty(exports, "getValueOrDefault", { enumerable: true, get: function () { return utils_1.getValueOrDefault; } });
-Object.defineProperty(exports, "isNullOrUndefined", { enumerable: true, get: function () { return utils_1.isNullOrUndefined; } });
-var xstate_1 = require("xstate");
 var ArvoMachine_1 = __importDefault(require("./ArvoMachine"));
 exports.ArvoMachine = ArvoMachine_1.default;
 var createMachine_1 = require("./ArvoMachine/createMachine");
 Object.defineProperty(exports, "setupArvoMachine", { enumerable: true, get: function () { return createMachine_1.setupArvoMachine; } });
-var ArvoOrchestrator_1 = require("./ArvoOrchestrator");
-Object.defineProperty(exports, "ArvoOrchestrator", { enumerable: true, get: function () { return ArvoOrchestrator_1.ArvoOrchestrator; } });
-var error_1 = require("./ArvoOrchestrator/error");
+var error_1 = require("./ArvoOrchestrationUtils/error");
 Object.defineProperty(exports, "TransactionViolation", { enumerable: true, get: function () { return error_1.TransactionViolation; } });
 Object.defineProperty(exports, "TransactionViolationCause", { enumerable: true, get: function () { return error_1.TransactionViolationCause; } });
+Object.defineProperty(exports, "isTransactionViolationError", { enumerable: true, get: function () { return error_1.isTransactionViolationError; } });
+var orchestrationExecutionState_1 = require("./ArvoOrchestrationUtils/orchestrationExecutionState");
+Object.defineProperty(exports, "OrchestrationExecutionStatus", { enumerable: true, get: function () { return orchestrationExecutionState_1.OrchestrationExecutionStatus; } });
+var ArvoOrchestrator_1 = require("./ArvoOrchestrator");
+Object.defineProperty(exports, "ArvoOrchestrator", { enumerable: true, get: function () { return ArvoOrchestrator_1.ArvoOrchestrator; } });
 var factory_1 = require("./ArvoOrchestrator/factory");
 Object.defineProperty(exports, "createArvoOrchestrator", { enumerable: true, get: function () { return factory_1.createArvoOrchestrator; } });
+var ArvoResumable_1 = require("./ArvoResumable");
+Object.defineProperty(exports, "ArvoResumable", { enumerable: true, get: function () { return ArvoResumable_1.ArvoResumable; } });
+var factory_2 = require("./ArvoResumable/factory");
+Object.defineProperty(exports, "createArvoResumable", { enumerable: true, get: function () { return factory_2.createArvoResumable; } });
 var MachineExecutionEngine_1 = require("./MachineExecutionEngine");
 Object.defineProperty(exports, "MachineExecutionEngine", { enumerable: true, get: function () { return MachineExecutionEngine_1.MachineExecutionEngine; } });
 var Simple_1 = require("./MachineMemory/Simple");
@@ -37,17 +38,19 @@ var TelemetredSimple_1 = require("./MachineMemory/TelemetredSimple");
 Object.defineProperty(exports, "TelemetredSimpleMachineMemory", { enumerable: true, get: function () { return TelemetredSimple_1.TelemetredSimpleMachineMemory; } });
 var MachineRegistry_1 = require("./MachineRegistry");
 Object.defineProperty(exports, "MachineRegistry", { enumerable: true, get: function () { return MachineRegistry_1.MachineRegistry; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "ConfigViolation", { enumerable: true, get: function () { return errors_1.ConfigViolation; } });
+Object.defineProperty(exports, "ContractViolation", { enumerable: true, get: function () { return errors_1.ContractViolation; } });
+Object.defineProperty(exports, "ExecutionViolation", { enumerable: true, get: function () { return errors_1.ExecutionViolation; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "coalesce", { enumerable: true, get: function () { return utils_1.coalesce; } });
+Object.defineProperty(exports, "coalesceOrDefault", { enumerable: true, get: function () { return utils_1.coalesceOrDefault; } });
+Object.defineProperty(exports, "getValueOrDefault", { enumerable: true, get: function () { return utils_1.getValueOrDefault; } });
+Object.defineProperty(exports, "isNullOrUndefined", { enumerable: true, get: function () { return utils_1.isNullOrUndefined; } });
 var SimpleEventBroker_1 = require("./utils/SimpleEventBroker");
 Object.defineProperty(exports, "SimpleEventBroker", { enumerable: true, get: function () { return SimpleEventBroker_1.SimpleEventBroker; } });
 var helper_1 = require("./utils/SimpleEventBroker/helper");
 Object.defineProperty(exports, "createSimpleEventBroker", { enumerable: true, get: function () { return helper_1.createSimpleEventBroker; } });
-var ArvoResumable_1 = require("./ArvoResumable");
-Object.defineProperty(exports, "ArvoResumable", { enumerable: true, get: function () { return ArvoResumable_1.ArvoResumable; } });
-var factory_2 = require("./ArvoResumable/factory");
-Object.defineProperty(exports, "createArvoResumable", { enumerable: true, get: function () { return factory_2.createArvoResumable; } });
-var ArvoDomain_1 = require("./ArvoDomain");
-Object.defineProperty(exports, "ArvoDomain", { enumerable: true, get: function () { return ArvoDomain_1.ArvoDomain; } });
-Object.defineProperty(exports, "resolveEventDomain", { enumerable: true, get: function () { return ArvoDomain_1.resolveEventDomain; } });
 var xstate = {
     emit: xstate_1.emit,
     assign: xstate_1.assign,

package/dist/types.d.ts

@@ -1,3 +1,5 @@
+import type { SpanOptions } from '@opentelemetry/api';
+import type { ArvoEvent } from 'arvo-core';
 import type IArvoEventHandler from './IArvoEventHandler';
 /**
  * Makes properties optional except specified keys
@@ -30,3 +32,9 @@ export type ArvoEventHandlerOpenTelemetryOptions = {
  * @template T - Configuration object type
  */
 export type EventHandlerFactory<T = void> = T extends void ? () => IArvoEventHandler : (config: T) => IArvoEventHandler;
+export type ArvoEventHandlerOtelSpanOptions = SpanOptions & {
+    spanName?: (param: {
+        selfContractUri: string;
+        consumedEvent: ArvoEvent;
+    }) => string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arvo-event-handler",
-  "version": "3.0.7",
+  "version": "3.0.10",
   "description": "Type-safe event handler system with versioning, telemetry, and contract validation for distributed Arvo event-driven architectures, featuring routing and multi-handler support.",
   "main": "dist/index.js",
   "scripts": {
@@ -46,7 +46,7 @@
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/core": "^1.30.1",
-    "arvo-core": "^3.0.7",
+    "arvo-core": "^3.0.10",
     "uuid": "^11.1.0",
     "xstate": "^5.23.0",
     "zod": "^3.25.74",

package/dist/ArvoOrchestrator/error.d.ts

@@ -1,16 +0,0 @@
-import { type ArvoEvent, ViolationError } from 'arvo-core';
-export declare enum TransactionViolationCause {
-    READ_FAILURE = "READ_MACHINE_MEMORY_FAILURE",
-    LOCK_FAILURE = "LOCK_MACHINE_MEMORY_FAILURE",
-    WRITE_FAILURE = "WRITE_MACHINE_MEMORY_FAILURE",
-    LOCK_UNACQUIRED = "LOCK_UNACQUIRED",
-    INVALID_SUBJECT = "INVALID_SUBJECT"
-}
-export declare class TransactionViolation extends ViolationError<'OrchestratorTransaction'> {
-    readonly cause: TransactionViolationCause;
-    constructor(param: {
-        cause: TransactionViolationCause;
-        message: string;
-        initiatingEvent: ArvoEvent;
-    });
-}