arvo-event-handler 3.0.6 → 3.0.8

package/dist/ArvoResumable/types.d.ts

@@ -1,6 +1,7 @@
-import type { VersionedArvoContract, ArvoSemanticVersion, InferVersionedArvoContract, ArvoContract, ArvoEvent, InferArvoEvent } 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']]: {
@@ -41,7 +42,9 @@ type Handler<TState extends ArvoResumableState<Record<string, any>>, TSelfContra
     context?: TState['state$$'];
     output?: {
         [L in keyof InferVersionedArvoContract<TSelfContract>['emits']]: EnqueueArvoEventActionParam<InferVersionedArvoContract<TSelfContract>['emits'][L]['data'], InferVersionedArvoContract<TSelfContract>['emits'][L]['type']>['data'];
-    }[keyof InferVersionedArvoContract<TSelfContract>['emits']];
+    }[keyof InferVersionedArvoContract<TSelfContract>['emits']] & {
+        __id?: CreateArvoEvent<Record<string, unknown>, string>['id'];
+    };
     services?: Array<{
         [K in keyof TServiceContract]: EnqueueArvoEventActionParam<InferVersionedArvoContract<TServiceContract[K]>['accepts']['data'], InferVersionedArvoContract<TServiceContract[K]>['accepts']['type']>;
     }[keyof TServiceContract]>;
@@ -86,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
      *
@@ -147,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

@@ -0,0 +1,36 @@
+import type { ArvoContractRecord, ArvoEvent } from 'arvo-core';
+import type { ArvoEventHandlerOpenTelemetryOptions } from '../types';
+/**
+ * The interface for Arvo event handlers.
+ *
+ * This class defines the basic structure for all Arvo event handlers.
+ * It provides an abstract method for executing events, which must be
+ * implemented by any concrete subclass.
+ */
+export default interface IArvoEventHandler {
+    /**
+     * Unique identifier for the event handler source system
+     */
+    source: string;
+    /**
+     * Executes the event handling logic for a given Arvo event.
+     *
+     * @param event - The Arvo event to be processed.
+     * @param opentelemetry - Configuration for OpenTelemetry integration
+     *
+     * @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<{
+        events: ArvoEvent[];
+    }>;
+    /**
+     * Provides the schema for system error events.
+     *
+     * @returns An object containing the error event type and schema.
+     *
+     * This defines the structure for system error events that may be emitted
+     * when an unexpected error occurs during event handling.
+     */
+    systemErrorSchema: ArvoContractRecord;
+}

package/dist/IArvoEventHandler/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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,19 @@
-import AbstractArvoEventHandler from './AbstractArvoEventHandler';
+import { assign, emit } from 'xstate';
+import { ArvoDomain, resolveEventDomain } from './ArvoDomain';
 import ArvoEventHandler from './ArvoEventHandler';
 import { createArvoEventHandler } from './ArvoEventHandler/helpers';
-import { ArvoEventHandlerFunction, ArvoEventHandlerFunctionInput, ArvoEventHandlerFunctionOutput, IArvoEventHandler } 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 { ArvoEventHandlerFunction, ArvoEventHandlerFunctionInput, ArvoEventHandlerFunctionOutput } from './ArvoEventHandler/types';
 import ArvoMachine from './ArvoMachine';
 import { setupArvoMachine } from './ArvoMachine/createMachine';
 import { ArvoMachineContext, EnqueueArvoEventActionParam } from './ArvoMachine/types';
+import { isTransactionViolationError, TransactionViolation, TransactionViolationCause } from './ArvoOrchestrationUtils/error';
 import { ArvoOrchestrator } from './ArvoOrchestrator';
-import { TransactionViolation, TransactionViolationCause } from './ArvoOrchestrator/error';
 import { createArvoOrchestrator } from './ArvoOrchestrator/factory';
-import { IArvoOrchestrator, MachineMemoryRecord } from './ArvoOrchestrator/types';
+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 +22,14 @@ 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, 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';
+import { OrchestrationExecutionStatus } from './ArvoOrchestrationUtils/orchestrationExecutionState';
 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, 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 };

package/dist/index.js

@@ -3,34 +3,31 @@ 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.AbstractArvoEventHandler = exports.coalesceOrDefault = exports.coalesce = exports.getValueOrDefault = exports.isNullOrUndefined = exports.createArvoEventHandler = exports.ArvoEventHandler = void 0;
-var AbstractArvoEventHandler_1 = __importDefault(require("./AbstractArvoEventHandler"));
-exports.AbstractArvoEventHandler = AbstractArvoEventHandler_1.default;
+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, "isTransactionViolationError", { enumerable: true, get: function () { return error_1.isTransactionViolationError; } });
 Object.defineProperty(exports, "TransactionViolation", { enumerable: true, get: function () { return error_1.TransactionViolation; } });
 Object.defineProperty(exports, "TransactionViolationCause", { enumerable: true, get: function () { return error_1.TransactionViolationCause; } });
+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");
@@ -39,17 +36,21 @@ 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 orchestrationExecutionState_1 = require("./ArvoOrchestrationUtils/orchestrationExecutionState");
+Object.defineProperty(exports, "OrchestrationExecutionStatus", { enumerable: true, get: function () { return orchestrationExecutionState_1.OrchestrationExecutionStatus; } });
 var xstate = {
     emit: xstate_1.emit,
     assign: xstate_1.assign,

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type AbstractArvoEventHandler from './AbstractArvoEventHandler';
+import type IArvoEventHandler from './IArvoEventHandler';
 /**
  * Makes properties optional except specified keys
  *
@@ -29,4 +29,4 @@ export type ArvoEventHandlerOpenTelemetryOptions = {
  *
  * @template T - Configuration object type
  */
-export type EventHandlerFactory<T = void> = T extends void ? () => AbstractArvoEventHandler : (config: T) => AbstractArvoEventHandler;
+export type EventHandlerFactory<T = void> = T extends void ? () => IArvoEventHandler : (config: T) => IArvoEventHandler;

package/dist/utils/SimpleEventBroker/helper.d.ts

@@ -1,6 +1,6 @@
 import type { ArvoEvent } from 'arvo-core';
 import { SimpleEventBroker } from '.';
-import type AbstractArvoEventHandler from '../../AbstractArvoEventHandler';
+import type IArvoEventHandler from '../../IArvoEventHandler';
 /**
  * Creates a local event broker configured with domain event handlers and provides event resolution capabilities
  *
@@ -153,7 +153,7 @@ import type AbstractArvoEventHandler from '../../AbstractArvoEventHandler';
  * without requiring external message brokers, making test suites faster and
  * more reliable while maintaining production-like behavior patterns.
  */
-export declare const createSimpleEventBroker: (eventHandlers: AbstractArvoEventHandler[], options?: {
+export declare const createSimpleEventBroker: (eventHandlers: IArvoEventHandler[], options?: {
     onError?: (error: Error, event: ArvoEvent) => void;
     onDomainedEvents?: (param: {
         domain: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arvo-event-handler",
-  "version": "3.0.6",
+  "version": "3.0.8",
   "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,10 +46,11 @@
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/core": "^1.30.1",
-    "arvo-core": "^3.0.6",
+    "arvo-core": "^3.0.8",
     "uuid": "^11.1.0",
-    "xstate": "^5.20.1",
-    "zod": "^3.25.67"
+    "xstate": "^5.23.0",
+    "zod": "^3.25.74",
+    "zod-to-json-schema": "^3.24.6"
   },
   "engines": {
     "node": ">=18.0.0"

package/dist/AbstractArvoEventHandler/index.d.ts

@@ -1,91 +0,0 @@
-import type { ArvoContractRecord, ArvoEvent } from 'arvo-core';
-import type { ArvoEventHandlerOpenTelemetryOptions } from '../types';
-/**
- * Abstract base class for Arvo event handlers.
- *
- * @abstract
- * @description
- * This class defines the basic structure for all Arvo event handlers.
- * It provides an abstract method for executing events, which must be
- * implemented by any concrete subclass.
- * ```
- */
-export default abstract class AbstractArvoEventHandler {
-    /**
-     * Unique identifier for the event handler source system
-     */
-    abstract source: string;
-    /**
-     * Executes the event handling logic for a given Arvo event.
-     *
-     * @abstract
-     * @param event - The Arvo event to be processed. This event should conform
-     *                           to the expected schema for the specific handler implementation.
-     * @param opentelemetry - Configuration for OpenTelemetry integration
-     *
-     * @returns {Promise<ArvoEvent[]>} A promise that resolves to an array of resulting Arvo events.
-     *                                 These events represent the outcome of processing the input event.
-     *
-     * @description
-     * This method defines the core event processing logic that each concrete handler must implement.
-     * It should handle the complete lifecycle of an event, including:
-     * - Validation of the input event
-     * - Processing of the event according to business rules
-     * - Generation of any resulting events
-     * - Error handling and reporting
-     * - OpenTelemetry integration for observability
-     *
-     * @throws {Error}
-     * - When the input event fails validation
-     * - When processing encounters an unrecoverable error
-     * - When the handler is unable to properly execute the event
-     *
-     * @remarks
-     * Implementation considerations:
-     * - Ensure proper error handling and event validation
-     * - Implement appropriate retry logic for transient failures
-     * - Use the provided OpenTelemetry configuration for tracing
-     * - Consider performance implications for long-running operations
-     * - Maintain idempotency where appropriate
-     * - Document any specific requirements for event schemas
-     *
-     * The method should handle observability concerns by:
-     * - Creating appropriate spans for tracing
-     * - Recording relevant attributes and events
-     * - Properly handling span lifecycle (creation and completion)
-     * - Propagating context appropriately
-     */
-    abstract execute(event: ArvoEvent, opentelemetry: ArvoEventHandlerOpenTelemetryOptions): Promise<{
-        events: ArvoEvent[];
-        metadata?: Record<string, any>;
-    }>;
-    /**
-     * Provides the schema for system error events.
-     *
-     * @abstract
-     * @returns {ArvoContractRecord} An object containing the error event type and schema.
-     *
-     * @description
-     * This getter should define the structure for system error events that may be emitted
-     * when an unexpected error occurs during event handling.
-     *
-     * @remarks
-     * - The returned ArvoContractRecord typically includes:
-     *   - `type`: A string representing the error event type.
-     *   - `schema`: The schema definition for the error event.
-     * - Implementations should ensure that the error schema is consistent with the
-     *   overall system's error handling strategy.
-     * - The error event type often follows a pattern like 'sys.[eventType].error'.
-     *
-     * @example
-     * ```typescript
-     * public get systemErrorSchema(): ArvoContractRecord {
-     *   return {
-     *     type: 'sys.myEvent.error',
-     *     schema: MyCustomErrorSchema
-     *   };
-     * }
-     * ```
-     */
-    abstract get systemErrorSchema(): ArvoContractRecord;
-}

package/dist/AbstractArvoEventHandler/index.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Abstract base class for Arvo event handlers.
- *
- * @abstract
- * @description
- * This class defines the basic structure for all Arvo event handlers.
- * It provides an abstract method for executing events, which must be
- * implemented by any concrete subclass.
- * ```
- */
-var AbstractArvoEventHandler = /** @class */ (function () {
-    function AbstractArvoEventHandler() {
-    }
-    return AbstractArvoEventHandler;
-}());
-exports.default = AbstractArvoEventHandler;

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;
-    });
-}