arvo-core 2.2.6 → 2.2.8

package/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "quickfix.biome": "explicit"
+  },
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "typescript.enablePromptUseWorkspaceTsdk": true,
+  "typescript.preferences.importModuleSpecifier": "non-relative"
+}

package/CHANGELOG.md

@@ -88,3 +88,7 @@
 
 - Finalised the version 2 for Arvo core.
 
+## [2.2.7] - 2025-01-25
+
+- Added helper functions and added Biome for better linting
+

package/biome.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "vcs": {
+    "enabled": false,
+    "clientKind": "git",
+    "useIgnoreFile": false
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "ignore": [
+      "**/dist/**",
+      "**/node_modules/**",
+      "**/.turbo/**",
+      "**/coverage/**",
+      "**/.github/**",
+      "**/docs/**",
+      "*.md"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "formatWithErrors": false,
+    "ignore": [],
+    "attributePosition": "auto",
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120,
+    "lineEnding": "lf"
+  },
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "correctness": {
+        "noUnusedImports": "warn"
+      },
+      "suspicious": {
+        "noExplicitAny": "off"
+      }
+    }
+  },
+  "javascript": {
+    "jsxRuntime": "reactClassic",
+    "formatter": {
+      "quoteStyle": "single",
+      "arrowParentheses": "always",
+      "bracketSameLine": false,
+      "bracketSpacing": true,
+      "jsxQuoteStyle": "single",
+      "quoteProperties": "asNeeded",
+      "semicolons": "always",
+      "trailingCommas": "all"
+    }
+  }
+}

package/dist/ArvoContract/SimpleArvoContract/index.d.ts

@@ -1,6 +1,6 @@
-import { ArvoSemanticVersion } from '../../types';
-import { z } from 'zod';
-import { SimpleArvoContract } from './types';
+import type { z } from 'zod';
+import type { ArvoSemanticVersion } from '../../types';
+import type { SimpleArvoContract } from './types';
 /**
  * Creates an ArvoContract with standardized naming conventions and a simplified event pattern.
  * Use this to create contracts with one emit type only.

package/dist/ArvoContract/SimpleArvoContract/types.d.ts

@@ -1,6 +1,6 @@
-import { z } from 'zod';
-import ArvoContract from '..';
-import { ArvoSemanticVersion } from '../../types';
+import type { z } from 'zod';
+import type ArvoContract from '..';
+import type { ArvoSemanticVersion } from '../../types';
 export type SimpleArvoContractEmitType<T extends string> = `evt.${T}.success`;
 export type SimpleArvoContract<TUri extends string = string, TType extends string = string, TVersions extends Record<ArvoSemanticVersion, {
     accepts: z.ZodTypeAny;

package/dist/ArvoContract/VersionedArvoContract/index.d.ts

@@ -1,10 +1,10 @@
-import ArvoContract from '..';
-import { ArvoSemanticVersion } from '../../types';
-import { ArvoContractRecord } from '../types';
-import { IVersionedArvoContract, VersionedArvoContractJSONSchema } from './types';
-import { transformEmitsToArray } from './utils';
+import type ArvoContract from '..';
+import type { ArvoSemanticVersion } from '../../types';
 import { EventDataschemaUtil } from '../../utils';
 import { WildCardArvoSemanticVersion } from '../WildCardArvoSemanticVersion';
+import type { ArvoContractRecord } from '../types';
+import type { IVersionedArvoContract, VersionedArvoContractJSONSchema } from './types';
+import { transformEmitsToArray } from './utils';
 /**
  * Implements a version-specific view of an ArvoContract with type-safe schema validation
  * and JSON Schema generation capabilities.

package/dist/ArvoContract/VersionedArvoContract/index.js

@@ -16,10 +16,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VersionedArvoContract = void 0;
 var zod_to_json_schema_1 = __importDefault(require("zod-to-json-schema"));
-var utils_1 = require("./utils");
 var OpenTelemetry_1 = require("../../OpenTelemetry");
-var utils_2 = require("../../utils");
+var utils_1 = require("../../utils");
 var WildCardArvoSemanticVersion_1 = require("../WildCardArvoSemanticVersion");
+var utils_2 = require("./utils");
 /**
  * Implements a version-specific view of an ArvoContract with type-safe schema validation
  * and JSON Schema generation capabilities.
@@ -33,7 +33,7 @@ var VersionedArvoContract = /** @class */ (function () {
             schema: param.contract.versions[param.version].accepts,
         };
         this._emits = param.contract.versions[param.version].emits;
-        this._emitList = (0, utils_1.transformEmitsToArray)(this.emits);
+        this._emitList = (0, utils_2.transformEmitsToArray)(this.emits);
     }
     Object.defineProperty(VersionedArvoContract.prototype, "uri", {
         get: function () {
@@ -65,7 +65,7 @@ var VersionedArvoContract = /** @class */ (function () {
     });
     Object.defineProperty(VersionedArvoContract.prototype, "systemError", {
         get: function () {
-            return __assign(__assign({}, this._contract.systemError), { dataschema: utils_2.EventDataschemaUtil.build(this.uri, WildCardArvoSemanticVersion_1.WildCardArvoSemanticVersion) });
+            return __assign(__assign({}, this._contract.systemError), { dataschema: utils_1.EventDataschemaUtil.build(this.uri, WildCardArvoSemanticVersion_1.WildCardArvoSemanticVersion) });
         },
         enumerable: false,
         configurable: true
@@ -93,7 +93,7 @@ var VersionedArvoContract = /** @class */ (function () {
     });
     Object.defineProperty(VersionedArvoContract.prototype, "dataschema", {
         get: function () {
-            return utils_2.EventDataschemaUtil.build(this.uri, this.version);
+            return utils_1.EventDataschemaUtil.build(this.uri, this.version);
         },
         enumerable: false,
         configurable: true

package/dist/ArvoContract/VersionedArvoContract/types.d.ts

@@ -1,6 +1,6 @@
-import zodToJsonSchema from 'zod-to-json-schema';
-import ArvoContract from '..';
-import { ArvoSemanticVersion } from '../../types';
+import type zodToJsonSchema from 'zod-to-json-schema';
+import type ArvoContract from '..';
+import type { ArvoSemanticVersion } from '../../types';
 /**
  * Represents a version-specific view of an ArvoContract, providing type-safe access
  * to contract specifications for a particular semantic version. This interface acts as

package/dist/ArvoContract/VersionedArvoContract/utils.d.ts

@@ -1,4 +1,4 @@
-import ArvoContract from '..';
-import { ArvoSemanticVersion } from '../../types';
-import { ArvoContractRecord } from '../types';
+import type ArvoContract from '..';
+import type { ArvoSemanticVersion } from '../../types';
+import type { ArvoContractRecord } from '../types';
 export declare const transformEmitsToArray: <T extends ArvoContract, V extends ArvoSemanticVersion>(emitMap: T["versions"][V]["emits"]) => Array<{ [K in keyof T["versions"][V]["emits"] & string]: ArvoContractRecord<K, T["versions"][V]["emits"][K]>; }[keyof T["versions"][V]["emits"] & string]>;

package/dist/ArvoContract/WildCardArvoSemanticVersion.d.ts

@@ -1,4 +1,4 @@
-import { ArvoSemanticVersion } from '../types';
+import type { ArvoSemanticVersion } from '../types';
 /**
  * Special semantic version used as a wildcard matcher.
  * Represents version '0.0.0' which is reserved for system use.

package/dist/ArvoContract/WildCardArvoSemanticVersion.js

@@ -15,7 +15,6 @@ exports.WildCardArvoSemanticVersion = '0.0.0';
  * @returns True if version is the wildcard version, false otherwise
  */
 var isWildCardArvoSematicVersion = function (version) {
-    return (0, schema_1.isValidArvoSemanticVersion)(version) &&
-        version === exports.WildCardArvoSemanticVersion;
+    return (0, schema_1.isValidArvoSemanticVersion)(version) && version === exports.WildCardArvoSemanticVersion;
 };
 exports.isWildCardArvoSematicVersion = isWildCardArvoSematicVersion;

package/dist/ArvoContract/helpers.d.ts

@@ -1,6 +1,6 @@
+import type { z } from 'zod';
 import ArvoContract from '.';
-import { ArvoSemanticVersion } from '../types';
-import { z } from 'zod';
+import type { ArvoSemanticVersion } from '../types';
 /**
  * Creates a validated ArvoContract instance with full control over event types and schemas.
  *

package/dist/ArvoContract/index.d.ts

@@ -1,8 +1,8 @@
-import { z } from 'zod';
-import { ArvoContractJSONSchema, ArvoContractRecord, IArvoContract } from './types';
+import type { z } from 'zod';
 import { ArvoErrorSchema } from '../schema';
-import { ArvoSemanticVersion } from '../types';
+import type { ArvoSemanticVersion } from '../types';
 import { VersionedArvoContract } from './VersionedArvoContract';
+import type { ArvoContractJSONSchema, ArvoContractRecord, IArvoContract } from './types';
 /**
  * Represents a contract with defined input and output schemas for event-driven architectures.
  * The ArvoContract class provides type-safe validation and versioning capabilities for event handling,

package/dist/ArvoContract/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+var OpenTelemetry_1 = require("../OpenTelemetry");
 var schema_1 = require("../schema");
 var utils_1 = require("../utils");
 var VersionedArvoContract_1 = require("./VersionedArvoContract");
-var validators_1 = require("./validators");
 var WildCardArvoSemanticVersion_1 = require("./WildCardArvoSemanticVersion");
-var OpenTelemetry_1 = require("../OpenTelemetry");
+var validators_1 = require("./validators");
 /**
  * Represents a contract with defined input and output schemas for event-driven architectures.
  * The ArvoContract class provides type-safe validation and versioning capabilities for event handling,

package/dist/ArvoContract/types.d.ts

@@ -1,6 +1,6 @@
-import { z } from 'zod';
-import { ArvoSemanticVersion } from '../types';
-import { VersionedArvoContractJSONSchema } from './VersionedArvoContract/types';
+import type { z } from 'zod';
+import type { ArvoSemanticVersion } from '../types';
+import type { VersionedArvoContractJSONSchema } from './VersionedArvoContract/types';
 /**
  * Represents a record in an Arvo contract, containing a type identifier and its validation schema.
  *

package/dist/ArvoEvent/helpers.d.ts

@@ -1,5 +1,5 @@
 import ArvoEvent from '.';
-import { ArvoEventData, CloudEventExtension, CreateArvoEvent } from './types';
+import type { ArvoEventData, CloudEventExtension, CreateArvoEvent } from './types';
 /**
  * Creates a strongly-typed ArvoEvent with configurable telemetry options.
  *

package/dist/ArvoEvent/helpers.js

@@ -4,11 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createArvoEvent = void 0;
+var uuid_1 = require("uuid");
 var _1 = __importDefault(require("."));
 var OpenTelemetry_1 = require("../OpenTelemetry");
 var utils_1 = require("../utils");
 var schema_1 = require("./schema");
-var uuid_1 = require("uuid");
 /**
  * Internal generator function for creating  instances.
  */

package/dist/ArvoEvent/index.d.ts

@@ -1,5 +1,5 @@
-import { ArvoEventData, ArvoExtension, CloudEventContext, CloudEventExtension, OpenTelemetryExtension } from './types';
-import { InferArvoEvent } from '../types';
+import type { InferArvoEvent } from '../types';
+import type { ArvoEventData, ArvoExtension, CloudEventContext, CloudEventExtension, OpenTelemetryExtension } from './types';
 /**
  * Represents an ArvoEvent, which extends the CloudEvent specification.
  */

package/dist/ArvoEvent/index.js

@@ -22,8 +22,8 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-var schema_1 = require("./schema");
 var OpenTelemetry_1 = require("../OpenTelemetry");
+var schema_1 = require("./schema");
 /**
  * Represents an ArvoEvent, which extends the CloudEvent specification.
  */
@@ -50,9 +50,7 @@ var ArvoEvent = /** @class */ (function () {
         this.data = schema_1.ArvoDataSchema.parse(data);
         var arvoExtension = schema_1.ArvoExtensionSchema.parse(context);
         var otelExtension = schema_1.OpenTelemetryExtensionSchema.parse(context);
-        this._extensions = __assign(__assign({}, (extensions
-            ? schema_1.CloudEventExtensionSchema.parse(extensions)
-            : {})), { to: arvoExtension.to, accesscontrol: arvoExtension.accesscontrol, redirectto: arvoExtension.redirectto, executionunits: arvoExtension.executionunits, traceparent: otelExtension.traceparent, tracestate: otelExtension.tracestate });
+        this._extensions = __assign(__assign({}, (extensions ? schema_1.CloudEventExtensionSchema.parse(extensions) : {})), { to: arvoExtension.to, accesscontrol: arvoExtension.accesscontrol, redirectto: arvoExtension.redirectto, executionunits: arvoExtension.executionunits, traceparent: otelExtension.traceparent, tracestate: otelExtension.tracestate });
         if (this.datacontenttype === schema_1.ArvoDataContentType) {
             if (!this._extensions.to) {
                 throw new Error("The ArvoEvent must have a non-empty 'to' field");
@@ -195,7 +193,8 @@ var ArvoEvent = /** @class */ (function () {
          * For accessing the basic CloudEvent fields, use `<ArvoEvent>.cloudevent.default`.
          */
         get: function () {
-            var _a = this._extensions, traceparent = _a.traceparent, tracestate = _a.tracestate, to = _a.to, redirectto = _a.redirectto, accesscontrol = _a.accesscontrol, executionunits = _a.executionunits, rest = __rest(_a, ["traceparent", "tracestate", "to", "redirectto", "accesscontrol", "executionunits"]);
+            var _a = this
+                ._extensions, traceparent = _a.traceparent, tracestate = _a.tracestate, to = _a.to, redirectto = _a.redirectto, accesscontrol = _a.accesscontrol, executionunits = _a.executionunits, rest = __rest(_a, ["traceparent", "tracestate", "to", "redirectto", "accesscontrol", "executionunits"]);
             return rest;
         },
         enumerable: false,

package/dist/ArvoEvent/schema.d.ts

@@ -21,20 +21,20 @@ export declare const CloudEventContextSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: string;
     id: string;
+    time: string;
     source: string;
     specversion: "1.0";
     subject: string;
     datacontenttype: string;
     dataschema: string | null;
-    time: string;
 }, {
     type: string;
     id: string;
+    time: string;
     source: string;
     specversion: string;
     subject: string;
     dataschema: string | null;
-    time: string;
     datacontenttype?: string | undefined;
 }>;
 /**

package/dist/ArvoEvent/schema.js

@@ -16,10 +16,7 @@ exports.ArvoDataContentType = 'application/cloudevents+json;charset=UTF-8;profil
  */
 exports.CloudEventContextSchema = zod_1.z
     .object({
-    id: zod_1.z
-        .string()
-        .min(1, 'ID must be a non-empty string')
-        .describe('Unique identifier of the event.'),
+    id: zod_1.z.string().min(1, 'ID must be a non-empty string').describe('Unique identifier of the event.'),
     time: zod_1.z
         .string()
         .datetime({ offset: true })
@@ -47,10 +44,7 @@ exports.CloudEventContextSchema = zod_1.z
     datacontenttype: zod_1.z
         .string()
         .min(1, 'Data content type must be a non-empty string')
-        .refine(function (val) {
-        return Boolean(val === null || val === void 0 ? void 0 : val.includes('application/cloudevents+json')) ||
-            Boolean(val === null || val === void 0 ? void 0 : val.includes('application/json'));
-    }, (0, utils_1.cleanString)("\n          The content type must be a valid JSON e.g. it must contain \n          'application/cloudevents+json' or 'application/json'. \n          Arvo recommends using '".concat(exports.ArvoDataContentType, "'\n        ")))
+        .refine(function (val) { return Boolean(val === null || val === void 0 ? void 0 : val.includes('application/cloudevents+json')) || Boolean(val === null || val === void 0 ? void 0 : val.includes('application/json')); }, (0, utils_1.cleanString)("\n          The content type must be a valid JSON e.g. it must contain \n          'application/cloudevents+json' or 'application/json'. \n          Arvo recommends using '".concat(exports.ArvoDataContentType, "'\n        ")))
         .default(exports.ArvoDataContentType)
         .describe('Content type of the data value. Must adhere to RFC 2046 format if present.'),
     dataschema: zod_1.z

package/dist/ArvoEvent/types.d.ts

@@ -1,5 +1,5 @@
-import { z } from 'zod';
-import { CloudEventContextSchema, ArvoExtensionSchema, CloudEventExtensionSchema, ArvoDataSchema, OpenTelemetryExtensionSchema } from './schema';
+import type { z } from 'zod';
+import type { ArvoDataSchema, ArvoExtensionSchema, CloudEventContextSchema, CloudEventExtensionSchema, OpenTelemetryExtensionSchema } from './schema';
 /**
  * Represents the core properties of a CloudEvent.
  */

package/dist/ArvoEventFactory/Orchestrator.d.ts

@@ -1,7 +1,7 @@
+import type { z } from 'zod';
 import ArvoEventFactory from '.';
-import { z } from 'zod';
-import { CreateArvoEvent } from '../ArvoEvent/types';
-import { VersionedArvoContract } from '../ArvoContract/VersionedArvoContract';
+import type { VersionedArvoContract } from '../ArvoContract/VersionedArvoContract';
+import type { CreateArvoEvent } from '../ArvoEvent/types';
 /**
  * Factory class for creating and validating orchestrator-specific events with managed subject hierarchies.
  * Extends ArvoEventFactory with parent-child subject relationship handling and orchestration flows.

package/dist/ArvoEventFactory/Orchestrator.js

@@ -33,9 +33,9 @@ exports.ArvoOrchestratorEventFactory = void 0;
 var _1 = __importDefault(require("."));
 var helpers_1 = require("../ArvoEvent/helpers");
 var schema_1 = require("../ArvoEvent/schema");
+var ArvoOrchestrationSubject_1 = __importDefault(require("../ArvoOrchestrationSubject"));
 var OpenTelemetry_1 = require("../OpenTelemetry");
 var utils_1 = require("../utils");
-var ArvoOrchestrationSubject_1 = __importDefault(require("../ArvoOrchestrationSubject"));
 var utils_2 = require("./utils");
 /**
  * Factory class for creating and validating orchestrator-specific events with managed subject hierarchies.
@@ -54,7 +54,7 @@ var ArvoOrchestratorEventFactory = /** @class */ (function (_super) {
         var _this = this;
         var _a;
         if (((_a = contract.metadata) === null || _a === void 0 ? void 0 : _a.contractType) !== 'ArvoOrchestratorContract') {
-            throw new Error("This factory can only be used for ArvoOrchestratorContract");
+            throw new Error('This factory can only be used for ArvoOrchestratorContract');
         }
         _this = _super.call(this, contract) || this;
         _this._name = 'ArvoOrchestratorEventFactory';
@@ -90,8 +90,7 @@ var ArvoOrchestratorEventFactory = /** @class */ (function (_super) {
                         subject: parentSubject,
                         version: _this.contract.version,
                         meta: Object.fromEntries(Object.entries({
-                            redirectto: (_a = event.redirectto) !== null && _a !== void 0 ? _a : ArvoOrchestrationSubject_1.default.parse(parentSubject).execution
-                                .initiator,
+                            redirectto: (_a = event.redirectto) !== null && _a !== void 0 ? _a : ArvoOrchestrationSubject_1.default.parse(parentSubject).execution.initiator,
                         }).filter(function (item) { return Boolean(item[1]); })),
                     })
                     : ArvoOrchestrationSubject_1.default.new({

package/dist/ArvoEventFactory/helpers.d.ts

@@ -1,5 +1,5 @@
 import ArvoEventFactory from '.';
-import { VersionedArvoContract } from '../ArvoContract/VersionedArvoContract';
+import type { VersionedArvoContract } from '../ArvoContract/VersionedArvoContract';
 import { ArvoOrchestratorEventFactory } from './Orchestrator';
 /**
  * Creates an ArvoEventFactory for a specific version of a contract.

package/dist/ArvoEventFactory/helpers.js

@@ -19,7 +19,9 @@ var Orchestrator_1 = require("./Orchestrator");
  * const factory = createArvoEventFactory(v1Contract);
  * ```
  */
-var createArvoEventFactory = function (contract) { return new _1.default(contract); };
+var createArvoEventFactory = function (contract) {
+    return new _1.default(contract);
+};
 exports.createArvoEventFactory = createArvoEventFactory;
 /**
  * Creates an ArvoOrchestratorEventFactory instance for handling orchestration events.

package/dist/ArvoEventFactory/index.d.ts

@@ -1,6 +1,6 @@
-import { z } from 'zod';
-import { CreateArvoEvent } from '../ArvoEvent/types';
-import { VersionedArvoContract } from '../ArvoContract/VersionedArvoContract';
+import type { z } from 'zod';
+import type { VersionedArvoContract } from '../ArvoContract/VersionedArvoContract';
+import type { CreateArvoEvent } from '../ArvoEvent/types';
 /**
  * Factory class for creating and validating events based on a versioned Arvo contract.
  * Handles event creation, validation, and OpenTelemetry integration for a specific

package/dist/ArvoEventFactory/index.js

@@ -152,14 +152,10 @@ var ArvoEventFactory = /** @class */ (function () {
             name: "".concat(this._name, ".systemError"),
             spanOptions: (0, utils_2.createSpanOptions)(this.contract),
             fn: function (span) {
-                var _a, _b, _c, _d, _e;
+                var _a, _b, _c, _d;
                 var otelHeaders = (0, OpenTelemetry_1.currentOpenTelemetryHeaders)();
                 var error = event.error, _event = __rest(event, ["error"]);
-                var generatedEvent = (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.systemError.type, data: {
-                        errorName: error.name,
-                        errorMessage: error.message,
-                        errorStack: (_e = error.stack) !== null && _e !== void 0 ? _e : null,
-                    }, datacontenttype: schema_1.ArvoDataContentType, dataschema: utils_1.EventDataschemaUtil.createWithWildCardVersion(_this.contract) }), extensions, { disable: true });
+                var generatedEvent = (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.systemError.type, data: (0, utils_1.createArvoError)(error), datacontenttype: schema_1.ArvoDataContentType, dataschema: utils_1.EventDataschemaUtil.createWithWildCardVersion(_this.contract) }), extensions, { disable: true });
                 span.setAttributes(generatedEvent.otelAttributes);
                 return generatedEvent;
             },

package/dist/ArvoEventFactory/utils.d.ts

@@ -1,5 +1,5 @@
 import { SpanKind } from '@opentelemetry/api';
-import { VersionedArvoContract } from '../ArvoContract/VersionedArvoContract';
+import type { VersionedArvoContract } from '../ArvoContract/VersionedArvoContract';
 import { ArvoExecutionSpanKind } from '../OpenTelemetry/ArvoExecution/types';
 import { OpenInferenceSpanKind } from '../OpenTelemetry/OpenInference/types';
 export declare const createSpanOptions: (contract: VersionedArvoContract<any, any>) => {

package/dist/ArvoEventFactory/utils.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSpanOptions = void 0;
 var api_1 = require("@opentelemetry/api");
 var ArvoExecution_1 = __importDefault(require("../OpenTelemetry/ArvoExecution"));
-var OpenInference_1 = __importDefault(require("../OpenTelemetry/OpenInference"));
 var types_1 = require("../OpenTelemetry/ArvoExecution/types");
+var OpenInference_1 = __importDefault(require("../OpenTelemetry/OpenInference"));
 var types_2 = require("../OpenTelemetry/OpenInference/types");
 var createSpanOptions = function (contract) {
     var _a;

package/dist/ArvoOrchestrationSubject/index.d.ts

@@ -1,5 +1,5 @@
-import { ArvoOrchestrationSubjectContent } from './type';
-import { ArvoSemanticVersion } from '../types';
+import type { ArvoSemanticVersion } from '../types';
+import type { ArvoOrchestrationSubjectContent } from './type';
 /**
  * Handles the creation and parsing of Arvo orchestration subjects.
  */
@@ -120,4 +120,19 @@ export default class ArvoOrchestrationSubject {
      * ```
      */
     static parse(subject: string): ArvoOrchestrationSubjectContent;
+    /**
+     * Validates if a string represents a valid Arvo orchestration subject.
+     * A valid subject must:
+     * - Be base64 encoded
+     * - Contain zlib-compressed JSON data
+     * - Match the ArvoOrchestrationSubjectContent schema when decoded
+     * - Include valid orchestrator and execution details
+     *
+     * Use this method for validating subjects before processing them in
+     * orchestration workflows or when receiving subjects from external sources.
+     *
+     * @param data - The string to validate as an orchestration subject
+     * @returns boolean - True if string is a valid orchestration subject, false otherwise
+     */
+    static isValid(data: string): boolean;
 }

package/dist/ArvoOrchestrationSubject/index.js

@@ -10,38 +10,19 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-var schema_1 = require("./schema");
-var zlib = __importStar(require("node:zlib"));
-var utils_1 = require("../utils");
+var pako_1 = __importDefault(require("pako"));
 var uuid_1 = require("uuid");
 var WildCardArvoSemanticVersion_1 = require("../ArvoContract/WildCardArvoSemanticVersion");
+var utils_1 = require("../utils");
+var schema_1 = require("./schema");
 /**
  * Handles the creation and parsing of Arvo orchestration subjects.
  */
+// biome-ignore lint/complexity/noStaticOnlyClass: This needs to be a static class to group methods together
 var ArvoOrchestrationSubject = /** @class */ (function () {
     function ArvoOrchestrationSubject() {
     }
@@ -163,8 +144,8 @@ var ArvoOrchestrationSubject = /** @class */ (function () {
                 throw new Error("Invalid ArvoOrchestrationContextType: ".concat(validationResult.error));
             }
             var jsonString = JSON.stringify(param);
-            var compressed = zlib.deflateSync(jsonString);
-            return compressed.toString('base64');
+            var compressed = pako_1.default.deflate(new TextEncoder().encode(jsonString));
+            return Buffer.from(compressed).toString('base64');
         }
         catch (e) {
             throw new Error((0, utils_1.cleanString)("\n        Error creating orchestration subject string from the provided context. \n        Error -> ".concat(e.message, "  \n        Context -> ").concat(JSON.stringify(param, null, 2), "\n      ")));
@@ -188,7 +169,8 @@ var ArvoOrchestrationSubject = /** @class */ (function () {
     ArvoOrchestrationSubject.parse = function (subject) {
         try {
             var compressed = Buffer.from(subject, 'base64');
-            var jsonString = zlib.inflateSync(compressed).toString();
+            var decompressed = pako_1.default.inflate(compressed);
+            var jsonString = new TextDecoder().decode(decompressed);
             var parsed = JSON.parse(jsonString);
             var validationResult = schema_1.ArvoOrchestrationSubjectContentSchema.safeParse(parsed);
             if (!validationResult.success) {
@@ -200,6 +182,29 @@ var ArvoOrchestrationSubject = /** @class */ (function () {
             throw new Error((0, utils_1.cleanString)("\n        Error parsing orchestration subject string to the context. \n        Error -> ".concat(e.message, "  \n        subject -> ").concat(subject, "\n      ")));
         }
     };
+    /**
+     * Validates if a string represents a valid Arvo orchestration subject.
+     * A valid subject must:
+     * - Be base64 encoded
+     * - Contain zlib-compressed JSON data
+     * - Match the ArvoOrchestrationSubjectContent schema when decoded
+     * - Include valid orchestrator and execution details
+     *
+     * Use this method for validating subjects before processing them in
+     * orchestration workflows or when receiving subjects from external sources.
+     *
+     * @param data - The string to validate as an orchestration subject
+     * @returns boolean - True if string is a valid orchestration subject, false otherwise
+     */
+    ArvoOrchestrationSubject.isValid = function (data) {
+        try {
+            ArvoOrchestrationSubject.parse(data);
+            return false;
+        }
+        catch (_a) {
+            return false;
+        }
+    };
     return ArvoOrchestrationSubject;
 }());
 exports.default = ArvoOrchestrationSubject;

package/dist/ArvoOrchestrationSubject/schema.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ArvoOrchestrationSubjectContentSchema = void 0;
 var zod_1 = require("zod");
-var utils_1 = require("../utils");
 var schema_1 = require("../schema");
+var utils_1 = require("../utils");
 // Zod schema for ArvoOrchestrationSubjectContent
 exports.ArvoOrchestrationSubjectContentSchema = zod_1.z
     .object({

package/dist/ArvoOrchestrationSubject/type.d.ts

@@ -1,4 +1,4 @@
-import { ArvoSemanticVersion } from '../types';
+import type { ArvoSemanticVersion } from '../types';
 /**
  * Represents the content for Arvo orchestration subject.
  * This type provides information about the orchestrator and the current execution.

package/dist/ArvoOrchestratorContract/index.d.ts

@@ -1,6 +1,6 @@
-import { z } from 'zod';
-import { ICreateArvoOrchestratorContract, ArvoOrchestratorContract } from './types';
-import { ArvoSemanticVersion } from '../types';
+import type { z } from 'zod';
+import type { ArvoSemanticVersion } from '../types';
+import type { ArvoOrchestratorContract, ICreateArvoOrchestratorContract } from './types';
 /**
  * Creates an ArvoOrchestratorContract with specified parameters.
  *

package/dist/ArvoOrchestratorContract/index.js

@@ -15,9 +15,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createArvoOrchestratorContract = void 0;
-var typegen_1 = require("./typegen");
-var schema_1 = require("./schema");
 var ArvoContract_1 = __importDefault(require("../ArvoContract"));
+var schema_1 = require("./schema");
+var typegen_1 = require("./typegen");
 /**
  * Validates if a string contains only uppercase or lowercase alphanumeric characters.
  *

package/dist/ArvoOrchestratorContract/typegen.js

@@ -14,6 +14,7 @@ exports.ArvoOrchestratorEventTypeGen = void 0;
  * const errorEvent = ArvoOrchestratorEventTypeGen.systemError('payment') // 'sys.arvo.orc.payment.error'
  * ```
  */
+// biome-ignore lint/complexity/noStaticOnlyClass: This needs to be a static class to group methods together
 var ArvoOrchestratorEventTypeGen = /** @class */ (function () {
     function ArvoOrchestratorEventTypeGen() {
     }

package/dist/ArvoOrchestratorContract/types.d.ts

@@ -1,8 +1,8 @@
-import { z } from 'zod';
-import { ArvoSemanticVersion } from '../types';
-import ArvoContract from '../ArvoContract';
-import { ArvoOrchestratorEventTypeGen } from './typegen';
-import { OrchestrationInitEventBaseSchema } from './schema';
+import type { z } from 'zod';
+import type ArvoContract from '../ArvoContract';
+import type { ArvoSemanticVersion } from '../types';
+import type { OrchestrationInitEventBaseSchema } from './schema';
+import type { ArvoOrchestratorEventTypeGen } from './typegen';
 /**
  * A specialized ArvoContract type for orchestrating complex event flows.
  * Automatically generates appropriately typed init and complete events.

package/dist/OpenTelemetry/ArvoExecution/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * ArvoExection class containing attribute constants for OpenTelemetry.
  */
+// biome-ignore lint/complexity/noStaticOnlyClass: This needs to be a static class to group methods together
 var ArvoExecution = /** @class */ (function () {
     function ArvoExecution() {
     }

package/dist/OpenTelemetry/OpenInference/index.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * These attribute names are defined as per the OpenInference specification:
  * @see https://github.com/Arize-ai/openinference/blob/main/spec/semantic_conventions.md
  */
+// biome-ignore lint/complexity/noStaticOnlyClass: This needs to be a static class to group methods together
 var OpenInference = /** @class */ (function () {
     function OpenInference() {
     }

package/dist/OpenTelemetry/index.d.ts

@@ -1,5 +1,5 @@
-import { Span, Tracer, Context, SpanOptions } from '@opentelemetry/api';
-import { TelemetryLogLevel, OpenTelemetryHeaders } from './types';
+import { type Context, type Span, type SpanOptions, type Tracer } from '@opentelemetry/api';
+import type { OpenTelemetryHeaders, TelemetryLogLevel } from './types';
 /**
  * Singleton class for managing OpenTelemetry instrumentation across libraries
  */

package/dist/OpenTelemetry/index.js

@@ -91,8 +91,7 @@ var ArvoOpenTelemetry = /** @class */ (function () {
         if (!config.force) {
             var activeSpan = api_1.trace.getActiveSpan();
             if (activeSpan) {
-                throw new Error('Cannot reinitialize while spans are active. ' +
-                    'Either end all spans or use force: true (not recommended)');
+                throw new Error('Cannot reinitialize while spans are active. ' + 'Either end all spans or use force: true (not recommended)');
             }
         }
         // Create new instance
@@ -120,8 +119,7 @@ var ArvoOpenTelemetry = /** @class */ (function () {
         var _b, _c, _d;
         var parentContext;
         if (param.context) {
-            if (param.context.inheritFrom === 'TRACE_HEADERS' &&
-                param.context.traceHeaders.traceparent) {
+            if (param.context.inheritFrom === 'TRACE_HEADERS' && param.context.traceHeaders.traceparent) {
                 parentContext = (0, exports.makeOpenTelemetryContextContext)(param.context.traceHeaders.traceparent, param.context.traceHeaders.tracestate);
             }
             else if (param.context.inheritFrom === 'CONTEXT') {

package/dist/index.d.ts

@@ -1,34 +1,34 @@
+import ArvoContract from './ArvoContract';
+import { createArvoContract } from './ArvoContract/helpers';
 import ArvoEvent from './ArvoEvent';
-import { ArvoDataContentType } from './ArvoEvent/schema';
 import { createArvoEvent } from './ArvoEvent/helpers';
-import { CloudEventContext, CloudEventExtension, ArvoEventData, ArvoExtension, OpenTelemetryExtension, CreateArvoEvent } from './ArvoEvent/types';
-import { exceptionToSpan, logToSpan, OTelNull, currentOpenTelemetryHeaders, ArvoOpenTelemetry } from './OpenTelemetry';
+import { ArvoDataContentType } from './ArvoEvent/schema';
+import { ArvoEventData, ArvoExtension, CloudEventContext, CloudEventExtension, CreateArvoEvent, OpenTelemetryExtension } from './ArvoEvent/types';
+import { ArvoOpenTelemetry, OTelNull, currentOpenTelemetryHeaders, exceptionToSpan, logToSpan } from './OpenTelemetry';
 import { OpenTelemetryHeaders, TelemetryLogLevel } from './OpenTelemetry/types';
-import { validateURI, cleanString, compareSemanticVersions, parseSemanticVersion, EventDataschemaUtil } from './utils';
-import ArvoContract from './ArvoContract';
-import { createArvoContract } from './ArvoContract/helpers';
+import { EventDataschemaUtil, cleanString, compareSemanticVersions, createArvoError, parseSemanticVersion, validateURI } from './utils';
+import { createSimpleArvoContract } from './ArvoContract/SimpleArvoContract';
+import { SimpleArvoContract } from './ArvoContract/SimpleArvoContract/types';
+import { VersionedArvoContract } from './ArvoContract/VersionedArvoContract';
+import { WildCardArvoSemanticVersion, isWildCardArvoSematicVersion } from './ArvoContract/WildCardArvoSemanticVersion';
+import { ArvoContractJSONSchema, ArvoContractRecord, IArvoContract, ResolveArvoContractRecord } from './ArvoContract/types';
 import { ArvoContractValidators } from './ArvoContract/validators';
-import { ArvoContractRecord, IArvoContract, ResolveArvoContractRecord, ArvoContractJSONSchema } from './ArvoContract/types';
 import ArvoEventFactory from './ArvoEventFactory';
+import { ArvoOrchestratorEventFactory } from './ArvoEventFactory/Orchestrator';
 import { createArvoEventFactory, createArvoOrchestratorEventFactory } from './ArvoEventFactory/helpers';
-import { ArvoErrorSchema, ArvoSemanticVersionSchema, isValidArvoSemanticVersion } from './schema';
-import OpenInference from './OpenTelemetry/OpenInference';
-import ArvoExecution from './OpenTelemetry/ArvoExecution';
-import { ArvoExecutionSpanKind } from './OpenTelemetry/ArvoExecution/types';
-import { OpenInferenceSpanKind } from './OpenTelemetry/OpenInference/types';
 import ArvoOrchestrationSubject from './ArvoOrchestrationSubject';
 import { ArvoOrchestrationSubjectContentSchema } from './ArvoOrchestrationSubject/schema';
 import { ArvoOrchestrationSubjectContent } from './ArvoOrchestrationSubject/type';
-import { InferArvoEvent, ArvoSemanticVersion, ArvoErrorType, InferVersionedArvoContract } from './types';
 import { createArvoOrchestratorContract } from './ArvoOrchestratorContract';
-import { ICreateArvoOrchestratorContract, ArvoOrchestratorContract } from './ArvoOrchestratorContract/types';
 import { ArvoOrchestratorEventTypeGen } from './ArvoOrchestratorContract/typegen';
-import { VersionedArvoContract } from './ArvoContract/VersionedArvoContract';
-import { isWildCardArvoSematicVersion, WildCardArvoSemanticVersion } from './ArvoContract/WildCardArvoSemanticVersion';
-import { createSimpleArvoContract } from './ArvoContract/SimpleArvoContract';
-import { SimpleArvoContract } from './ArvoContract/SimpleArvoContract/types';
-import { ArvoOrchestratorEventFactory } from './ArvoEventFactory/Orchestrator';
+import { ArvoOrchestratorContract, ICreateArvoOrchestratorContract } from './ArvoOrchestratorContract/types';
+import ArvoExecution from './OpenTelemetry/ArvoExecution';
+import { ArvoExecutionSpanKind } from './OpenTelemetry/ArvoExecution/types';
+import OpenInference from './OpenTelemetry/OpenInference';
+import { OpenInferenceSpanKind } from './OpenTelemetry/OpenInference/types';
 import { ViolationError, ViolationErrorParam } from './errors';
+import { ArvoErrorSchema, ArvoSemanticVersionSchema, isValidArvoSemanticVersion } from './schema';
+import { ArvoErrorType, ArvoSemanticVersion, InferArvoEvent, InferVersionedArvoContract } from './types';
 /**
  * Collection of Zod schemas for validating various aspects of Arvo events.
  * @property {z.ZodObject} CloudEventContextSchema - Schema for core CloudEvent properties.
@@ -51,20 +51,20 @@ declare const ArvoEventSchema: {
     }, "strip", import("zod").ZodTypeAny, {
         type: string;
         id: string;
+        time: string;
         source: string;
         specversion: "1.0";
         subject: string;
         datacontenttype: string;
         dataschema: string | null;
-        time: string;
     }, {
         type: string;
         id: string;
+        time: string;
         source: string;
         specversion: string;
         subject: string;
         dataschema: string | null;
-        time: string;
         datacontenttype?: string | undefined;
     }>;
     CloudEventExtensionSchema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodBoolean, import("zod").ZodNumber, import("zod").ZodNull]>>;
@@ -103,4 +103,4 @@ declare const ArvoEventSchema: {
         parentSubject$$: string | null;
     }>;
 };
-export { ArvoEvent, createArvoEvent, ArvoDataContentType, ArvoEventData, CloudEventExtension, ArvoEventSchema, CloudEventContext, ArvoExtension, OpenTelemetryExtension, CreateArvoEvent, exceptionToSpan, logToSpan, OpenTelemetryHeaders, TelemetryLogLevel, OTelNull, validateURI, cleanString, ArvoContract, createArvoContract, ArvoContractValidators, ArvoContractRecord, IArvoContract, ResolveArvoContractRecord, ArvoEventFactory, createArvoEventFactory, currentOpenTelemetryHeaders, OpenInference, OpenInferenceSpanKind, ArvoExecution, ArvoExecutionSpanKind, ArvoContractJSONSchema, ArvoOrchestrationSubject, ArvoOrchestrationSubjectContent, ArvoSemanticVersion, InferArvoEvent, createArvoOrchestratorContract, ICreateArvoOrchestratorContract, ArvoOrchestratorEventTypeGen, EventDataschemaUtil, ArvoOrchestrationSubjectContentSchema, ArvoSemanticVersionSchema, ArvoErrorSchema, ArvoErrorType, compareSemanticVersions, parseSemanticVersion, createSimpleArvoContract, ArvoOrchestratorContract, VersionedArvoContract, InferVersionedArvoContract, isWildCardArvoSematicVersion, WildCardArvoSemanticVersion, isValidArvoSemanticVersion, SimpleArvoContract, ArvoOrchestratorEventFactory, createArvoOrchestratorEventFactory, ArvoOpenTelemetry, ViolationError, ViolationErrorParam, };
+export { ArvoEvent, createArvoEvent, ArvoDataContentType, ArvoEventData, CloudEventExtension, ArvoEventSchema, CloudEventContext, ArvoExtension, OpenTelemetryExtension, CreateArvoEvent, exceptionToSpan, logToSpan, OpenTelemetryHeaders, TelemetryLogLevel, OTelNull, validateURI, cleanString, ArvoContract, createArvoContract, ArvoContractValidators, ArvoContractRecord, IArvoContract, ResolveArvoContractRecord, ArvoEventFactory, createArvoEventFactory, currentOpenTelemetryHeaders, OpenInference, OpenInferenceSpanKind, ArvoExecution, ArvoExecutionSpanKind, ArvoContractJSONSchema, ArvoOrchestrationSubject, ArvoOrchestrationSubjectContent, ArvoSemanticVersion, InferArvoEvent, createArvoOrchestratorContract, ICreateArvoOrchestratorContract, ArvoOrchestratorEventTypeGen, EventDataschemaUtil, ArvoOrchestrationSubjectContentSchema, ArvoSemanticVersionSchema, ArvoErrorSchema, ArvoErrorType, compareSemanticVersions, parseSemanticVersion, createSimpleArvoContract, ArvoOrchestratorContract, VersionedArvoContract, InferVersionedArvoContract, isWildCardArvoSematicVersion, WildCardArvoSemanticVersion, isValidArvoSemanticVersion, SimpleArvoContract, ArvoOrchestratorEventFactory, createArvoOrchestratorEventFactory, ArvoOpenTelemetry, ViolationError, ViolationErrorParam, createArvoError, };

package/dist/index.js

@@ -3,68 +3,69 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ViolationError = exports.ArvoOpenTelemetry = exports.createArvoOrchestratorEventFactory = exports.ArvoOrchestratorEventFactory = exports.isValidArvoSemanticVersion = exports.WildCardArvoSemanticVersion = exports.isWildCardArvoSematicVersion = exports.VersionedArvoContract = exports.createSimpleArvoContract = exports.parseSemanticVersion = exports.compareSemanticVersions = exports.ArvoErrorSchema = exports.ArvoSemanticVersionSchema = exports.ArvoOrchestrationSubjectContentSchema = exports.EventDataschemaUtil = exports.ArvoOrchestratorEventTypeGen = exports.createArvoOrchestratorContract = exports.ArvoOrchestrationSubject = exports.ArvoExecutionSpanKind = exports.ArvoExecution = exports.OpenInferenceSpanKind = exports.OpenInference = exports.currentOpenTelemetryHeaders = exports.createArvoEventFactory = exports.ArvoEventFactory = exports.ArvoContractValidators = exports.createArvoContract = exports.ArvoContract = exports.cleanString = exports.validateURI = exports.OTelNull = exports.logToSpan = exports.exceptionToSpan = exports.ArvoEventSchema = exports.ArvoDataContentType = exports.createArvoEvent = exports.ArvoEvent = void 0;
+exports.createArvoError = exports.ViolationError = exports.ArvoOpenTelemetry = exports.createArvoOrchestratorEventFactory = exports.ArvoOrchestratorEventFactory = exports.isValidArvoSemanticVersion = exports.WildCardArvoSemanticVersion = exports.isWildCardArvoSematicVersion = exports.VersionedArvoContract = exports.createSimpleArvoContract = exports.parseSemanticVersion = exports.compareSemanticVersions = exports.ArvoErrorSchema = exports.ArvoSemanticVersionSchema = exports.ArvoOrchestrationSubjectContentSchema = exports.EventDataschemaUtil = exports.ArvoOrchestratorEventTypeGen = exports.createArvoOrchestratorContract = exports.ArvoOrchestrationSubject = exports.ArvoExecutionSpanKind = exports.ArvoExecution = exports.OpenInferenceSpanKind = exports.OpenInference = exports.currentOpenTelemetryHeaders = exports.createArvoEventFactory = exports.ArvoEventFactory = exports.ArvoContractValidators = exports.createArvoContract = exports.ArvoContract = exports.cleanString = exports.validateURI = exports.OTelNull = exports.logToSpan = exports.exceptionToSpan = exports.ArvoEventSchema = exports.ArvoDataContentType = exports.createArvoEvent = exports.ArvoEvent = void 0;
+var ArvoContract_1 = __importDefault(require("./ArvoContract"));
+exports.ArvoContract = ArvoContract_1.default;
+var helpers_1 = require("./ArvoContract/helpers");
+Object.defineProperty(exports, "createArvoContract", { enumerable: true, get: function () { return helpers_1.createArvoContract; } });
 var ArvoEvent_1 = __importDefault(require("./ArvoEvent"));
 exports.ArvoEvent = ArvoEvent_1.default;
+var helpers_2 = require("./ArvoEvent/helpers");
+Object.defineProperty(exports, "createArvoEvent", { enumerable: true, get: function () { return helpers_2.createArvoEvent; } });
 var schema_1 = require("./ArvoEvent/schema");
 Object.defineProperty(exports, "ArvoDataContentType", { enumerable: true, get: function () { return schema_1.ArvoDataContentType; } });
-var helpers_1 = require("./ArvoEvent/helpers");
-Object.defineProperty(exports, "createArvoEvent", { enumerable: true, get: function () { return helpers_1.createArvoEvent; } });
 var OpenTelemetry_1 = require("./OpenTelemetry");
-Object.defineProperty(exports, "exceptionToSpan", { enumerable: true, get: function () { return OpenTelemetry_1.exceptionToSpan; } });
-Object.defineProperty(exports, "logToSpan", { enumerable: true, get: function () { return OpenTelemetry_1.logToSpan; } });
+Object.defineProperty(exports, "ArvoOpenTelemetry", { enumerable: true, get: function () { return OpenTelemetry_1.ArvoOpenTelemetry; } });
 Object.defineProperty(exports, "OTelNull", { enumerable: true, get: function () { return OpenTelemetry_1.OTelNull; } });
 Object.defineProperty(exports, "currentOpenTelemetryHeaders", { enumerable: true, get: function () { return OpenTelemetry_1.currentOpenTelemetryHeaders; } });
-Object.defineProperty(exports, "ArvoOpenTelemetry", { enumerable: true, get: function () { return OpenTelemetry_1.ArvoOpenTelemetry; } });
+Object.defineProperty(exports, "exceptionToSpan", { enumerable: true, get: function () { return OpenTelemetry_1.exceptionToSpan; } });
+Object.defineProperty(exports, "logToSpan", { enumerable: true, get: function () { return OpenTelemetry_1.logToSpan; } });
 var utils_1 = require("./utils");
-Object.defineProperty(exports, "validateURI", { enumerable: true, get: function () { return utils_1.validateURI; } });
+Object.defineProperty(exports, "EventDataschemaUtil", { enumerable: true, get: function () { return utils_1.EventDataschemaUtil; } });
 Object.defineProperty(exports, "cleanString", { enumerable: true, get: function () { return utils_1.cleanString; } });
 Object.defineProperty(exports, "compareSemanticVersions", { enumerable: true, get: function () { return utils_1.compareSemanticVersions; } });
+Object.defineProperty(exports, "createArvoError", { enumerable: true, get: function () { return utils_1.createArvoError; } });
 Object.defineProperty(exports, "parseSemanticVersion", { enumerable: true, get: function () { return utils_1.parseSemanticVersion; } });
-Object.defineProperty(exports, "EventDataschemaUtil", { enumerable: true, get: function () { return utils_1.EventDataschemaUtil; } });
-var ArvoContract_1 = __importDefault(require("./ArvoContract"));
-exports.ArvoContract = ArvoContract_1.default;
-var helpers_2 = require("./ArvoContract/helpers");
-Object.defineProperty(exports, "createArvoContract", { enumerable: true, get: function () { return helpers_2.createArvoContract; } });
+Object.defineProperty(exports, "validateURI", { enumerable: true, get: function () { return utils_1.validateURI; } });
+var SimpleArvoContract_1 = require("./ArvoContract/SimpleArvoContract");
+Object.defineProperty(exports, "createSimpleArvoContract", { enumerable: true, get: function () { return SimpleArvoContract_1.createSimpleArvoContract; } });
+var VersionedArvoContract_1 = require("./ArvoContract/VersionedArvoContract");
+Object.defineProperty(exports, "VersionedArvoContract", { enumerable: true, get: function () { return VersionedArvoContract_1.VersionedArvoContract; } });
+var WildCardArvoSemanticVersion_1 = require("./ArvoContract/WildCardArvoSemanticVersion");
+Object.defineProperty(exports, "WildCardArvoSemanticVersion", { enumerable: true, get: function () { return WildCardArvoSemanticVersion_1.WildCardArvoSemanticVersion; } });
+Object.defineProperty(exports, "isWildCardArvoSematicVersion", { enumerable: true, get: function () { return WildCardArvoSemanticVersion_1.isWildCardArvoSematicVersion; } });
 var validators_1 = require("./ArvoContract/validators");
 Object.defineProperty(exports, "ArvoContractValidators", { enumerable: true, get: function () { return validators_1.ArvoContractValidators; } });
 var ArvoEventFactory_1 = __importDefault(require("./ArvoEventFactory"));
 exports.ArvoEventFactory = ArvoEventFactory_1.default;
+var Orchestrator_1 = require("./ArvoEventFactory/Orchestrator");
+Object.defineProperty(exports, "ArvoOrchestratorEventFactory", { enumerable: true, get: function () { return Orchestrator_1.ArvoOrchestratorEventFactory; } });
 var helpers_3 = require("./ArvoEventFactory/helpers");
 Object.defineProperty(exports, "createArvoEventFactory", { enumerable: true, get: function () { return helpers_3.createArvoEventFactory; } });
 Object.defineProperty(exports, "createArvoOrchestratorEventFactory", { enumerable: true, get: function () { return helpers_3.createArvoOrchestratorEventFactory; } });
-var schema_2 = require("./schema");
-Object.defineProperty(exports, "ArvoErrorSchema", { enumerable: true, get: function () { return schema_2.ArvoErrorSchema; } });
-Object.defineProperty(exports, "ArvoSemanticVersionSchema", { enumerable: true, get: function () { return schema_2.ArvoSemanticVersionSchema; } });
-Object.defineProperty(exports, "isValidArvoSemanticVersion", { enumerable: true, get: function () { return schema_2.isValidArvoSemanticVersion; } });
-var OpenInference_1 = __importDefault(require("./OpenTelemetry/OpenInference"));
-exports.OpenInference = OpenInference_1.default;
-var ArvoExecution_1 = __importDefault(require("./OpenTelemetry/ArvoExecution"));
-exports.ArvoExecution = ArvoExecution_1.default;
-var types_1 = require("./OpenTelemetry/ArvoExecution/types");
-Object.defineProperty(exports, "ArvoExecutionSpanKind", { enumerable: true, get: function () { return types_1.ArvoExecutionSpanKind; } });
-var types_2 = require("./OpenTelemetry/OpenInference/types");
-Object.defineProperty(exports, "OpenInferenceSpanKind", { enumerable: true, get: function () { return types_2.OpenInferenceSpanKind; } });
 var ArvoOrchestrationSubject_1 = __importDefault(require("./ArvoOrchestrationSubject"));
 exports.ArvoOrchestrationSubject = ArvoOrchestrationSubject_1.default;
-var schema_3 = require("./ArvoOrchestrationSubject/schema");
-Object.defineProperty(exports, "ArvoOrchestrationSubjectContentSchema", { enumerable: true, get: function () { return schema_3.ArvoOrchestrationSubjectContentSchema; } });
+var schema_2 = require("./ArvoOrchestrationSubject/schema");
+Object.defineProperty(exports, "ArvoOrchestrationSubjectContentSchema", { enumerable: true, get: function () { return schema_2.ArvoOrchestrationSubjectContentSchema; } });
 var ArvoOrchestratorContract_1 = require("./ArvoOrchestratorContract");
 Object.defineProperty(exports, "createArvoOrchestratorContract", { enumerable: true, get: function () { return ArvoOrchestratorContract_1.createArvoOrchestratorContract; } });
+var schema_3 = require("./ArvoOrchestratorContract/schema");
 var typegen_1 = require("./ArvoOrchestratorContract/typegen");
 Object.defineProperty(exports, "ArvoOrchestratorEventTypeGen", { enumerable: true, get: function () { return typegen_1.ArvoOrchestratorEventTypeGen; } });
-var schema_4 = require("./ArvoOrchestratorContract/schema");
-var VersionedArvoContract_1 = require("./ArvoContract/VersionedArvoContract");
-Object.defineProperty(exports, "VersionedArvoContract", { enumerable: true, get: function () { return VersionedArvoContract_1.VersionedArvoContract; } });
-var WildCardArvoSemanticVersion_1 = require("./ArvoContract/WildCardArvoSemanticVersion");
-Object.defineProperty(exports, "isWildCardArvoSematicVersion", { enumerable: true, get: function () { return WildCardArvoSemanticVersion_1.isWildCardArvoSematicVersion; } });
-Object.defineProperty(exports, "WildCardArvoSemanticVersion", { enumerable: true, get: function () { return WildCardArvoSemanticVersion_1.WildCardArvoSemanticVersion; } });
-var SimpleArvoContract_1 = require("./ArvoContract/SimpleArvoContract");
-Object.defineProperty(exports, "createSimpleArvoContract", { enumerable: true, get: function () { return SimpleArvoContract_1.createSimpleArvoContract; } });
-var Orchestrator_1 = require("./ArvoEventFactory/Orchestrator");
-Object.defineProperty(exports, "ArvoOrchestratorEventFactory", { enumerable: true, get: function () { return Orchestrator_1.ArvoOrchestratorEventFactory; } });
+var ArvoExecution_1 = __importDefault(require("./OpenTelemetry/ArvoExecution"));
+exports.ArvoExecution = ArvoExecution_1.default;
+var types_1 = require("./OpenTelemetry/ArvoExecution/types");
+Object.defineProperty(exports, "ArvoExecutionSpanKind", { enumerable: true, get: function () { return types_1.ArvoExecutionSpanKind; } });
+var OpenInference_1 = __importDefault(require("./OpenTelemetry/OpenInference"));
+exports.OpenInference = OpenInference_1.default;
+var types_2 = require("./OpenTelemetry/OpenInference/types");
+Object.defineProperty(exports, "OpenInferenceSpanKind", { enumerable: true, get: function () { return types_2.OpenInferenceSpanKind; } });
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "ViolationError", { enumerable: true, get: function () { return errors_1.ViolationError; } });
+var schema_4 = require("./schema");
+Object.defineProperty(exports, "ArvoErrorSchema", { enumerable: true, get: function () { return schema_4.ArvoErrorSchema; } });
+Object.defineProperty(exports, "ArvoSemanticVersionSchema", { enumerable: true, get: function () { return schema_4.ArvoSemanticVersionSchema; } });
+Object.defineProperty(exports, "isValidArvoSemanticVersion", { enumerable: true, get: function () { return schema_4.isValidArvoSemanticVersion; } });
 /**
  * Collection of Zod schemas for validating various aspects of Arvo events.
  * @property {z.ZodObject} CloudEventContextSchema - Schema for core CloudEvent properties.
@@ -80,6 +81,6 @@ var ArvoEventSchema = {
     ArvoDataSchema: schema_1.ArvoDataSchema,
     ArvoExtensionSchema: schema_1.ArvoExtensionSchema,
     OpenTelemetryExtensionSchema: schema_1.OpenTelemetryExtensionSchema,
-    OrchestrationInitEventBaseSchema: schema_4.OrchestrationInitEventBaseSchema,
+    OrchestrationInitEventBaseSchema: schema_3.OrchestrationInitEventBaseSchema,
 };
 exports.ArvoEventSchema = ArvoEventSchema;

package/dist/schema.js

@@ -19,7 +19,5 @@ exports.ArvoSemanticVersionSchema = zod_1.z
     .regex(/^\d+\.\d+\.\d+$/, 'Invalid version format of the semantic version')
     .describe('Semantic version of the Arvo component in the format X.Y.Z');
 // Check is the provided version is a valid arvo semantic version
-var isValidArvoSemanticVersion = function (version) {
-    return exports.ArvoSemanticVersionSchema.safeParse(version).success;
-};
+var isValidArvoSemanticVersion = function (version) { return exports.ArvoSemanticVersionSchema.safeParse(version).success; };
 exports.isValidArvoSemanticVersion = isValidArvoSemanticVersion;

package/dist/types.d.ts

@@ -1,8 +1,9 @@
-import { z } from 'zod';
-import ArvoEvent from './ArvoEvent';
-import { ArvoExtension, OpenTelemetryExtension } from './ArvoEvent/types';
-import { ArvoErrorSchema } from './schema';
-import { VersionedArvoContract } from './ArvoContract/VersionedArvoContract';
+import type { z } from 'zod';
+import type { VersionedArvoContract } from './ArvoContract/VersionedArvoContract';
+import type ArvoEvent from './ArvoEvent';
+import type { CloudEventExtensionSchema } from './ArvoEvent/schema';
+import type { ArvoExtension, OpenTelemetryExtension } from './ArvoEvent/types';
+import type { ArvoErrorSchema } from './schema';
 /**
  * Represents a semantic version string following the SemVer format (MAJOR.MINOR.PATCH).
  */
@@ -56,8 +57,8 @@ export type InferVersionedArvoContract<TVersion extends VersionedArvoContract<an
     version: TVersion['version'];
     description: TVersion['description'];
     metadata: TVersion['metadata'];
-    systemError: InferArvoEvent<ArvoEvent<InferZodSchema<TVersion['systemError']['schema']>, {}, TVersion['systemError']['type']>>;
-    accepts: InferArvoEvent<ArvoEvent<InferZodSchema<TVersion['accepts']['schema']>, {}, TVersion['accepts']['type']>>;
+    systemError: InferArvoEvent<ArvoEvent<InferZodSchema<TVersion['systemError']['schema']>, z.infer<typeof CloudEventExtensionSchema>, TVersion['systemError']['type']>>;
+    accepts: InferArvoEvent<ArvoEvent<InferZodSchema<TVersion['accepts']['schema']>, z.infer<typeof CloudEventExtensionSchema>, TVersion['accepts']['type']>>;
     emits: {
         [K in string & keyof TVersion['emits']]: InferArvoEvent<ArvoEvent<InferZodSchema<TVersion['emits'][K]>, Record<string, any>, K>>;
     };

package/dist/utils.d.ts

@@ -1,6 +1,6 @@
-import { VersionedArvoContract } from './ArvoContract/VersionedArvoContract';
-import ArvoEvent from './ArvoEvent';
-import { ArvoSemanticVersion } from './types';
+import type { VersionedArvoContract } from './ArvoContract/VersionedArvoContract';
+import type ArvoEvent from './ArvoEvent';
+import type { ArvoErrorType, ArvoSemanticVersion } from './types';
 /**
  * Cleans a string by removing leading/trailing whitespace from each line,
  * removing empty lines, and joining the remaining lines with newline characters.
@@ -115,5 +115,25 @@ export declare class EventDataschemaUtil {
         uri: string;
         version: ArvoSemanticVersion;
     } | null;
+    /**
+     * Validates if a given ArvoEvent or dataschema string represents a valid dataschema.
+     * A valid dataschema must:
+     * - Follow the format {uri}/{version}
+     * - Have a valid semantic version component
+     * - Contain a non-empty URI
+     *
+     * @param data - ArvoEvent object or dataschema string to validate
+     * @returns boolean - True if dataschema is valid, false otherwise
+     */
+    static isValid(data: ArvoEvent | string): boolean;
 }
+/**
+ * Creates a standardized ArvoError payload from an Error object. This utility
+ * ensures consistent error reporting across the event system by extracting and
+ * structuring key error information.
+ *
+ * @param error - The source Error object to convert
+ * @returns ArvoErrorType - The standardized error payload
+ */
+export declare const createArvoError: (error: Error) => ArvoErrorType;
 export {};

package/dist/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventDataschemaUtil = exports.createTimestamp = exports.validateURI = void 0;
+exports.createArvoError = exports.EventDataschemaUtil = exports.createTimestamp = exports.validateURI = void 0;
 exports.cleanString = cleanString;
 exports.parseSemanticVersion = parseSemanticVersion;
 exports.compareSemanticVersions = compareSemanticVersions;
@@ -84,8 +84,8 @@ var createTimestamp = function (offsetHours) {
 exports.createTimestamp = createTimestamp;
 function parseSemanticVersion(version) {
     var _a = version.split('.').map(function (part) {
-        var num = parseInt(part, 10);
-        if (isNaN(num)) {
+        var num = Number.parseInt(part, 10);
+        if (Number.isNaN(num)) {
             throw new Error("Invalid version number in ".concat(version));
         }
         return num;
@@ -117,6 +117,7 @@ function compareSemanticVersions(version1, version2) {
  * Manages event dataschema strings for versioned contracts.
  * Handles creation and parsing of dataschema identifiers.
  */
+// biome-ignore lint/complexity/noStaticOnlyClass: This needs to be a static class to group methods together
 var EventDataschemaUtil = /** @class */ (function () {
     function EventDataschemaUtil() {
     }
@@ -179,6 +180,36 @@ var EventDataschemaUtil = /** @class */ (function () {
             return null;
         }
     };
+    /**
+     * Validates if a given ArvoEvent or dataschema string represents a valid dataschema.
+     * A valid dataschema must:
+     * - Follow the format {uri}/{version}
+     * - Have a valid semantic version component
+     * - Contain a non-empty URI
+     *
+     * @param data - ArvoEvent object or dataschema string to validate
+     * @returns boolean - True if dataschema is valid, false otherwise
+     */
+    EventDataschemaUtil.isValid = function (data) {
+        return Boolean(EventDataschemaUtil.parse(data));
+    };
     return EventDataschemaUtil;
 }());
 exports.EventDataschemaUtil = EventDataschemaUtil;
+/**
+ * Creates a standardized ArvoError payload from an Error object. This utility
+ * ensures consistent error reporting across the event system by extracting and
+ * structuring key error information.
+ *
+ * @param error - The source Error object to convert
+ * @returns ArvoErrorType - The standardized error payload
+ */
+var createArvoError = function (error) {
+    var _a;
+    return ({
+        errorName: error.name,
+        errorMessage: error.message,
+        errorStack: (_a = error.stack) !== null && _a !== void 0 ? _a : null,
+    });
+};
+exports.createArvoError = createArvoError;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arvo-core",
-  "version": "2.2.6",
+  "version": "2.2.8",
   "description": "This core package contains all the core classes and components of the Arvo Event Driven System",
   "main": "dist/index.js",
   "scripts": {
@@ -8,21 +8,15 @@
     "start": "node ./dist/index.js",
     "dev": "ts-node ./src/index.ts",
     "test": "jest --passWithNoTests --runInBand --detectOpenHandles --forceExit",
-    "format": "npx prettier --write .",
+    "lint": "biome check --fix",
+    "format": "biome format --fix",
     "doc": "npx typedoc"
   },
-  "keywords": [
-    "arvo",
-    "event-driven architecture",
-    "xorca",
-    "core",
-    "cloudevent",
-    "opentelemetry",
-    "orchestrator"
-  ],
+  "keywords": ["arvo", "event-driven architecture", "xorca", "core", "cloudevent", "opentelemetry", "orchestrator"],
   "author": "Saad Ahmad <saadkwi12@hotmail.com>",
   "license": "MIT",
   "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
     "@jest/globals": "^29.7.0",
     "@opentelemetry/auto-instrumentations-node": "^0.49.1",
     "@opentelemetry/exporter-metrics-otlp-proto": "^0.52.1",
@@ -34,10 +28,10 @@
     "@opentelemetry/semantic-conventions": "^1.25.1",
     "@types/jest": "^29.5.12",
     "@types/node": "^22.5.0",
+    "@types/pako": "^2.0.3",
     "@types/uuid": "^10.0.0",
     "dotenv": "^16.4.5",
     "jest": "^29.7.0",
-    "prettier": "^3.3.3",
     "ts-jest": "^29.2.5",
     "ts-node": "^10.9.2",
     "typedoc": "^0.26.6",
@@ -48,6 +42,7 @@
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/core": "^1.28.0",
+    "pako": "^2.1.0",
     "uuid": "^10.0.0",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.5"