arvo-core 1.2.3 → 2.0.2

package/dist/ArvoEventFactory/index.js

@@ -21,18 +21,20 @@ var __rest = (this && this.__rest) || function (s, e) {
         }
     return t;
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 var helpers_1 = require("../ArvoEvent/helpers");
 var schema_1 = require("../ArvoEvent/schema");
 var OpenTelemetry_1 = require("../OpenTelemetry");
 var api_1 = require("@opentelemetry/api");
+var ArvoOrchestrationSubject_1 = __importDefault(require("../ArvoOrchestrationSubject"));
 /**
- * A factory class for creating contractual ArvoEvents based on a given ArvoContract.
+ * Factory class for creating contractual ArvoEvents based on a given ArvoContract.
+ * This class handles the creation and validation of events according to contract specifications.
  *
- * @template TUri - The URI of the contract
- * @template TType - The accept type, defaults to string.
- * @template TAcceptSchema - The type of the data which the contract bound can accept
- * @template TEmits - The type of records the contract bound handler emits.
+ * @template TContract - The type of ArvoContract this factory is bound to
  */
 var ArvoEventFactory = /** @class */ (function () {
     /**
@@ -44,31 +46,39 @@ var ArvoEventFactory = /** @class */ (function () {
         this.contract = contract;
     }
     /**
-     * Creates an ArvoEvent as per the accept record of the contract.
+     * Creates a validated ArvoEvent that matches the contract's accept specifications.
+     * This method ensures the created event conforms to the contract's input schema.
+     *
+     * @template V - The semantic version of the contract to use
+     * @template TExtension - Additional custom properties to include in the event
+     *
+     * @param event - The event configuration object
+     * @param event.version - The semantic version of the contract to use
+     * @param event.data - The event payload that must conform to the contract's accept schema
+     * @param [extensions] - Optional additional properties to include in the event
+     * @param [opentelemetry] - Optional OpenTelemetry configuration for tracing
      *
-     * @template TExtension - The type of extensions to add to the event.
-     * @param event - The event to create. The field 'type' is automatically infered
-     * @param [extensions] - Optional extensions to add to the event.
-     * @param [opentelemetry] - Optional opentelemetry configuration object
-     * @returns The created ArvoEvent as per the accept record of the contract.
-     * @throws If the event data fails validation against the contract.
+     * @returns A validated ArvoEvent instance conforming to the contract's accept specifications
+     *
+     * @throws {Error} If event data validation fails against the contract schema
+     * @throws {Error} If OpenTelemetry operations fail
      */
     ArvoEventFactory.prototype.accepts = function (event, extensions, opentelemetry) {
         var _this = this;
         opentelemetry = opentelemetry !== null && opentelemetry !== void 0 ? opentelemetry : {
             tracer: (0, OpenTelemetry_1.fetchOpenTelemetryTracer)(),
         };
-        var span = opentelemetry.tracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.accepts<").concat(this.contract.accepts.type, ">.create"));
+        var span = opentelemetry.tracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, "/").concat(event.version, ">.accepts"));
         return api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), function () {
             var _a, _b, _c, _d;
             span.setStatus({ code: api_1.SpanStatusCode.OK });
             var otelHeaders = (0, OpenTelemetry_1.currentOpenTelemetryHeaders)();
             try {
-                var validationResult = _this.contract.validateAccepts(_this.contract.accepts.type, event.data);
+                var validationResult = _this.contract.validateAccepts(event.version, _this.contract.type, event.data);
                 if (!validationResult.success) {
                     throw new Error("Accept Event data validation failed: ".concat(validationResult.error.message));
                 }
-                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, type: _this.contract.accepts.type, datacontenttype: schema_1.ArvoDataContentType, dataschema: _this.contract.uri, data: validationResult.data }), extensions, opentelemetry);
+                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, type: _this.contract.type, datacontenttype: schema_1.ArvoDataContentType, dataschema: "".concat(_this.contract.uri, "/").concat(event.version), data: validationResult.data }), extensions, opentelemetry);
             }
             catch (error) {
                 (0, OpenTelemetry_1.exceptionToSpan)(error);
@@ -84,32 +94,42 @@ var ArvoEventFactory = /** @class */ (function () {
         });
     };
     /**
-     * Creates an ArvoEvent as per one of the emits record in the contract.
+     * Creates a validated ArvoEvent that matches one of the contract's emit specifications.
+     * This method ensures the created event conforms to the contract's output schema.
+     *
+     * @template V - The semantic version of the contract to use
+     * @template U - The specific emit event type from the contract
+     * @template TExtension - Additional custom properties to include in the event
+     *
+     * @param event - The event configuration object
+     * @param event.version - The semantic version of the contract to use
+     * @param event.type - The type of emit event to create
+     * @param event.data - The event payload that must conform to the contract's emit schema
+     * @param [extensions] - Optional additional properties to include in the event
+     * @param [opentelemetry] - Optional OpenTelemetry configuration for tracing
      *
-     * @template U - The specific event type from TEmits.
-     * @template TExtension - The type of extensions to add to the event.
-     * @param event - The event to create.
-     * @param [extensions] - Optional extensions to add to the event.
-     * @param [opentelemetry] - Optional opentelemetry configuration object
-     * @returns The created ArvoEvent as per one of the emits records of the contract.
-     * @throws If the event data fails validation against the contract.
+     * @returns A validated ArvoEvent instance conforming to the contract's emit specifications
+     *
+     * @throws {Error} If event data validation fails against the contract schema
+     * @throws {Error} If the specified emit type doesn't exist in the contract
+     * @throws {Error} If OpenTelemetry operations fail
      */
     ArvoEventFactory.prototype.emits = function (event, extensions, opentelemetry) {
         var _this = this;
         opentelemetry = opentelemetry !== null && opentelemetry !== void 0 ? opentelemetry : {
-            tracer: (0, OpenTelemetry_1.fetchOpenTelemetryTracer)()
+            tracer: (0, OpenTelemetry_1.fetchOpenTelemetryTracer)(),
         };
-        var span = opentelemetry.tracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.emits<").concat(event.type, ">.create"));
+        var span = opentelemetry.tracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, "/").concat(event.version, ">.emits<").concat(event.type, ">"));
         return api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), function () {
             var _a, _b, _c, _d;
             span.setStatus({ code: api_1.SpanStatusCode.OK });
             var otelHeaders = (0, OpenTelemetry_1.currentOpenTelemetryHeaders)();
             try {
-                var validationResult = _this.contract.validateEmits(event.type, event.data);
+                var validationResult = _this.contract.validateEmits(event.version, event.type, event.data);
                 if (!validationResult.success) {
                     throw new Error("Emit Event data validation failed: ".concat(validationResult.error.message));
                 }
-                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, datacontenttype: schema_1.ArvoDataContentType, dataschema: _this.contract.uri, data: validationResult.data }), extensions, opentelemetry);
+                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, datacontenttype: schema_1.ArvoDataContentType, dataschema: "".concat(_this.contract.uri, "/").concat(event.version), data: validationResult.data }), extensions, opentelemetry);
             }
             catch (error) {
                 (0, OpenTelemetry_1.exceptionToSpan)(error);
@@ -125,31 +145,37 @@ var ArvoEventFactory = /** @class */ (function () {
         });
     };
     /**
-     * Creates a system error ArvoEvent.
+     * Creates a system error ArvoEvent for handling and reporting errors within the system.
+     *
+     * @template TExtension - Additional custom properties to include in the error event
+     *
+     * @param event - The error event configuration object
+     * @param event.error - The Error instance to be converted into an event
+     * @param [extensions] - Optional additional properties to include in the event
+     * @param [opentelemetry] - Optional OpenTelemetry configuration for tracing
+     *
+     * @returns A system error ArvoEvent containing the error details
      *
-     * @template TExtension - The type of extensions to add to the event.
-     * @param event - The event to create, including the error.
-     * @param [extensions] - Optional extensions to add to the event.
-     * @param [opentelemetry] - Optional opentelemtry configuration object
-     * @returns The created system error ArvoEvent.
+     * @throws {Error} If event creation fails
+     * @throws {Error} If OpenTelemetry operations fail
      */
     ArvoEventFactory.prototype.systemError = function (event, extensions, opentelemetry) {
         var _this = this;
         opentelemetry = opentelemetry !== null && opentelemetry !== void 0 ? opentelemetry : {
             tracer: (0, OpenTelemetry_1.fetchOpenTelemetryTracer)(),
         };
-        var span = opentelemetry.tracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.systemError<sys.").concat(this.contract.accepts.type, ".error>.create"));
+        var span = opentelemetry.tracer.startSpan("ArvoEventFactory<".concat(this.contract.uri, ">.systemError"));
         return api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), function () {
             var _a, _b, _c, _d, _e;
             span.setStatus({ code: api_1.SpanStatusCode.OK });
             var otelHeaders = (0, OpenTelemetry_1.currentOpenTelemetryHeaders)();
             try {
                 var error = event.error, _event = __rest(event, ["error"]);
-                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, _event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, type: "sys.".concat(_this.contract.accepts.type, ".error"), data: {
+                return (0, helpers_1.createArvoEvent)(__assign(__assign({}, _event), { traceparent: (_b = (_a = event.traceparent) !== null && _a !== void 0 ? _a : otelHeaders.traceparent) !== null && _b !== void 0 ? _b : undefined, tracestate: (_d = (_c = event.tracestate) !== null && _c !== void 0 ? _c : otelHeaders.tracestate) !== null && _d !== void 0 ? _d : undefined, type: "sys.".concat(_this.contract.type, ".error"), data: {
                         errorName: error.name,
                         errorMessage: error.message,
                         errorStack: (_e = error.stack) !== null && _e !== void 0 ? _e : null,
-                    }, datacontenttype: schema_1.ArvoDataContentType, dataschema: _this.contract.uri }), extensions, opentelemetry);
+                    }, datacontenttype: schema_1.ArvoDataContentType, dataschema: "".concat(_this.contract.uri, "/").concat(ArvoOrchestrationSubject_1.default.WildCardMachineVersion) }), extensions, opentelemetry);
             }
             catch (error) {
                 (0, OpenTelemetry_1.exceptionToSpan)(error);

package/dist/ArvoOrchestrationSubject/index.d.ts

@@ -1,4 +1,5 @@
-import { ArvoOrchestratorVersion, ArvoOrchestrationSubjectContent } from './type';
+import { ArvoOrchestrationSubjectContent } from './type';
+import { ArvoSemanticVersion } from '../types';
 /**
  * Handles the creation and parsing of Arvo orchestration subjects.
  */
@@ -7,7 +8,7 @@ export default class ArvoOrchestrationSubject {
      * Represents a wildcard version number used when version matching is not required.
      * Format follows semantic versioning pattern.
      */
-    static readonly WildCardMachineVersion: ArvoOrchestratorVersion;
+    static readonly WildCardMachineVersion: ArvoSemanticVersion;
     /**
      * Creates a new Arvo orchestration subject with basic required parameters.
      * This is a convenience method that wraps the more detailed {@link create} method.
@@ -42,7 +43,7 @@ export default class ArvoOrchestrationSubject {
      */
     static new(param: {
         orchestator: string;
-        version: ArvoOrchestratorVersion | null;
+        version: ArvoSemanticVersion | null;
         initiator: string;
         meta?: Record<string, string>;
     }): string;
@@ -81,7 +82,7 @@ export default class ArvoOrchestrationSubject {
      */
     static from(param: {
         orchestator: string;
-        version: ArvoOrchestratorVersion | null;
+        version: ArvoSemanticVersion | null;
         subject: string;
         meta?: Record<string, string>;
     }): string;

package/dist/ArvoOrchestrationSubject/index.js

@@ -87,7 +87,7 @@ var ArvoOrchestrationSubject = /** @class */ (function () {
                 id: (0, uuid_1.v4)(),
                 initiator: param.initiator,
             },
-            meta: (_b = param.meta) !== null && _b !== void 0 ? _b : {}
+            meta: (_b = param.meta) !== null && _b !== void 0 ? _b : {},
         });
     };
     /**
@@ -130,7 +130,7 @@ var ArvoOrchestrationSubject = /** @class */ (function () {
             initiator: parsedSubject.orchestrator.name,
             version: (_a = param.version) !== null && _a !== void 0 ? _a : ArvoOrchestrationSubject.WildCardMachineVersion,
             orchestator: param.orchestator,
-            meta: __assign(__assign({}, ((_b = parsedSubject.meta) !== null && _b !== void 0 ? _b : {})), ((_c = param.meta) !== null && _c !== void 0 ? _c : {}))
+            meta: __assign(__assign({}, ((_b = parsedSubject.meta) !== null && _b !== void 0 ? _b : {})), ((_c = param.meta) !== null && _c !== void 0 ? _c : {})),
         });
     };
     /**

package/dist/ArvoOrchestrationSubject/schema.d.ts

@@ -1,9 +1,8 @@
 import { z } from 'zod';
-export declare const ArvoOrchestratorVersionSchema: z.ZodEffects<z.ZodString, string, string>;
 export declare const ArvoOrchestrationSubjectContentSchema: z.ZodObject<{
     orchestrator: z.ZodObject<{
         name: z.ZodEffects<z.ZodString, string, string>;
-        version: z.ZodEffects<z.ZodString, string, string>;
+        version: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         name: string;
         version: string;

package/dist/ArvoOrchestrationSubject/schema.js

@@ -1,14 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArvoOrchestrationSubjectContentSchema = exports.ArvoOrchestratorVersionSchema = void 0;
+exports.ArvoOrchestrationSubjectContentSchema = void 0;
 var zod_1 = require("zod");
 var utils_1 = require("../utils");
-// Zod schema for ArvoOchestratorVersion
-exports.ArvoOrchestratorVersionSchema = zod_1.z
-    .string()
-    .regex(/^\d+\.\d+\.\d+$/, 'Invalid version format')
-    .refine(function (value) { return !value.includes(';'); }, 'Version must not contain semicolon')
-    .describe('Semantic version of the Arvo Orchestrator in the format X.Y.Z');
+var schema_1 = require("../schema");
 // Zod schema for ArvoOrchestrationSubjectContent
 exports.ArvoOrchestrationSubjectContentSchema = zod_1.z
     .object({
@@ -19,7 +14,7 @@ exports.ArvoOrchestrationSubjectContentSchema = zod_1.z
             .regex(/^[a-z0-9]+(\.[a-z0-9]+)+\.[a-z0-9]+$/, 'Orchestrator name should be prefixed with a reverse-DNS name')
             .refine(function (value) { return !value.includes(';'); }, 'Orchestrator name must not contain semicolon')
             .describe('Name of the orchestrator'),
-        version: exports.ArvoOrchestratorVersionSchema,
+        version: schema_1.ArvoSemanticVersionSchema,
     })
         .describe('Information about the orchestrator'),
     execution: zod_1.z
@@ -36,8 +31,6 @@ exports.ArvoOrchestrationSubjectContentSchema = zod_1.z
             .describe('Entity or process that initiated the execution'),
     })
         .describe('Details about the current execution'),
-    meta: zod_1.z
-        .record(zod_1.z.string(), zod_1.z.string())
-        .describe((0, utils_1.cleanString)("\n        Additional metadata for the orchestration process. Store essential key-value pairs \n        that provide context or configuration details necessary for the orchestration. \n        Use selectively to maintain clarity and avoid storing unnecessary information.  \n      "))
+    meta: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).describe((0, utils_1.cleanString)("\n        Additional metadata for the orchestration process. Store essential key-value pairs \n        that provide context or configuration details necessary for the orchestration. \n        Use selectively to maintain clarity and avoid storing unnecessary information.  \n      ")),
 })
     .describe('Context information for Arvo orchestration');

package/dist/ArvoOrchestrationSubject/type.d.ts

@@ -1,14 +1,4 @@
-/**
- * Represents the version of the Arvo Orchestrator.
- *
- * @remark
- * The version follows the Semantic Versioning format: MAJOR.MINOR.PATCH
- * **Note**: The string must not contain ';'
- *
- * @example
- * "1.0.0", "2.3.1", "0.5.2"
- */
-export type ArvoOrchestratorVersion = `${number}.${number}.${number}`;
+import { ArvoSemanticVersion } from '../types';
 /**
  * Represents the content for Arvo orchestration subject.
  * This type provides information about the orchestrator and the current execution.
@@ -21,7 +11,6 @@ export type ArvoOrchestrationSubjectContent = {
         /**
          * The name of the orchestrator.
          *
-         * @remark
          * Should be prefixed with a reverse-DNS name.
          * **Note**: The string must not contain ';'
          *
@@ -32,7 +21,7 @@ export type ArvoOrchestrationSubjectContent = {
         /**
          * The version of the orchestrator.
          */
-        version: ArvoOrchestratorVersion;
+        version: ArvoSemanticVersion;
     };
     /**
      * Details about the current execution.
@@ -41,7 +30,6 @@ export type ArvoOrchestrationSubjectContent = {
         /**
          * A unique identifier for the execution.
          *
-         * @remark
          * Should be a non-empty string. The recomendation
          * is to use uuid v4 to generate these ids.
          * **Note**: The string must not contain ';'
@@ -53,7 +41,6 @@ export type ArvoOrchestrationSubjectContent = {
         /**
          * The entity or process that initiated the execution.
          *
-         * @remark
          * Should be prefixed with a reverse-DNS name.
          * **Note**: The string must not contain ';'
          *

package/dist/ArvoOrchestratorContract/index.d.ts

@@ -1,68 +1,74 @@
 import { z } from 'zod';
-import ArvoContract from '../ArvoContract';
-import { IArvoOrchestratorContract } from './types';
+import { ICreateArvoOrchestratorContract, ArvoOrchestratorContract } from './types';
+import { ArvoSemanticVersion } from '../types';
 /**
- * Defines the contract for the Arvo Orchestrator, specifying accepted events and emitted events.
+ * Creates an ArvoOrchestratorContract with specified parameters.
  *
- * The ArvoOrchestratorContract is a specialized contract class designed to manage the lifecycle
- * of orchestration processes within the Arvo framework. It extends the base ArvoContract class
- * to provide specific functionality for orchestration scenarios.
+ * The ArvoOrchestratorContract is a specialized contract designed to manage the lifecycle
+ * of orchestration processes within the Arvo framework. It creates a contract with an init event
+ * type and a corresponding complete event type.
  *
  * Key features:
- * 1. Initialization: Defines the structure and validation for the initial event that starts the orchestration.
- * 2. Completion: Specifies the event type and data emitted when the orchestration process concludes.
- * 3. Type Safety: Utilizes TypeScript generics to ensure type consistency across the contract definition.
- * 4. Runtime Validation: Employs Zod schemas for robust runtime type checking and data validation.
+ * 1. Type Validation: Ensures the type parameter follows lowercase alphanumeric with dots format
+ * 2. Event Type Generation: Automatically generates init and complete event types based on the provided type
+ * 3. Schema Merging: Merges provided init schemas with the OrchestrationInitEventBaseSchema
+ * 4. Version Support: Handles multiple versions of the contract with their respective schemas
  *
- * This contract serves as a crucial component in maintaining consistency and type safety
- * throughout the orchestration process, from initiation to completion.
+ * @template TUri - The URI type for the contract
+ * @template TType - The type identifier for the contract events
+ * @template TVersions - Record of versions with their corresponding init and complete schemas
+ *
+ * @param param - Configuration object for the orchestrator contract
+ * @param param.uri - The URI that uniquely identifies this contract
+ * @param param.type - The base type identifier (must be lowercase alphanumeric with dots)
+ * @param param.versions - Record of version configurations
+ * @param param.versions[version].init - Zod schema for initialization event (merged with OrchestrationInitEventBaseSchema)
+ * @param param.versions[version].complete - Zod schema for completion event
+ *
+ * @throws {Error} If the type parameter contains invalid characters (must be lowercase alphanumeric with dots)
+ *
+ * @returns An ArvoOrchestratorContract instance configured with the specified parameters
  *
  * @example
  * ```typescript
- * import { createArvoOrchestratorContract } from 'arvo-core'
- * import { z } from 'zod'
- *
  * const contract = createArvoOrchestratorContract({
- *  uri: '#/example/contract',
- *  name: 'rag',
- *  schema: {
- *    init: z.object({
- *      request: z.string()
- *      vectorStore: z.string(),
- *      llm: z.string()
- *    }),
- *    complete: z.object({
- *      response: z.string()
- *    })
- *  }
- * })
+ *   uri: '#/orchestrators/data/processor',
+ *   type: 'data.processor',
+ *   versions: {
+ *     '1.0.0': {
+ *       init: z.object({
+ *         data: z.string(),
+ *         options: z.object({
+ *           format: z.string()
+ *         })
+ *       }),
+ *       complete: z.object({
+ *         processedData: z.string(),
+ *         metadata: z.record(z.string())
+ *       })
+ *     },
+ *     '1.1.0': {
+ *       init: z.object({
+ *         data: z.string(),
+ *         options: z.object({
+ *           format: z.string(),
+ *           compression: z.boolean().optional()
+ *         })
+ *       }),
+ *       complete: z.object({
+ *         processedData: z.string(),
+ *         metadata: z.record(z.string()),
+ *         performance: z.object({
+ *           duration: z.number(),
+ *           bytesProcessed: z.number()
+ *         })
+ *       })
+ *     }
+ *   }
+ * });
  * ```
  */
-export default class ArvoOrchestratorContract<TUri extends string = string, TInitType extends string = string, TInit extends z.ZodTypeAny = z.ZodTypeAny, TCompleteType extends string = string, TComplete extends z.ZodTypeAny = z.ZodTypeAny> extends ArvoContract<TUri, TInitType, TInit, {
-    [K in TCompleteType]: TComplete;
-}> {
-    /**
-     * Constructs a new ArvoOrchestratorContract instance.
-     *
-     * @param param - The configuration object for the contract.
-     */
-    constructor(param: IArvoOrchestratorContract<TUri, TInitType, TInit, TCompleteType, TComplete>);
-    /**
-     * Gets the initialization event configuration.
-     *
-     * @returns An object containing the type and schema for the initialization event.
-     */
-    get init(): {
-        type: TInitType;
-        schema: TInit;
-    };
-    /**
-     * Gets the completion event configuration.
-     *
-     * @returns An object containing the type and schema for the completion event.
-     */
-    get complete(): {
-        type: TCompleteType;
-        schema: TComplete;
-    };
-}
+export declare const createArvoOrchestratorContract: <TUri extends string, TType extends string, TVersions extends Record<ArvoSemanticVersion, {
+    init: z.ZodObject<any, any, any>;
+    complete: z.ZodObject<any, any, any>;
+}>>(param: ICreateArvoOrchestratorContract<TUri, TType, TVersions>) => ArvoOrchestratorContract<TUri, TType, TVersions>;