arvo-core 2.2.5 → 2.2.7

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,7 +1,9 @@
-import ArvoContract from '..';
-import { ArvoSemanticVersion } from '../../types';
-import { ArvoContractRecord } from '../types';
-import { IVersionedArvoContract, VersionedArvoContractJSONSchema } from './types';
+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
@@ -17,10 +19,13 @@ export declare class VersionedArvoContract<TContract extends ArvoContract, TVers
     get version(): TVersion;
     get description(): TContract['description'];
     get metadata(): TContract['metadata'];
-    get systemError(): TContract['systemError'];
+    get systemError(): TContract['systemError'] & {
+        dataschema: ReturnType<typeof EventDataschemaUtil.build<TContract['uri'], typeof WildCardArvoSemanticVersion>>;
+    };
     get accepts(): ArvoContractRecord<TContract["type"], TContract["versions"][TVersion]["accepts"]>;
     get emits(): TContract["versions"][TVersion]["emits"];
     get emitList(): { [K in keyof TContract["versions"][TVersion]["emits"] & string]: ArvoContractRecord<K, TContract["versions"][TVersion]["emits"][K]>; }[keyof TContract["versions"][TVersion]["emits"] & string][];
+    get dataschema(): `${TContract["uri"]}/${TVersion}`;
     constructor(param: IVersionedArvoContract<TContract, TVersion>);
     /**
      * Converts the contract to JSON Schema format

package/dist/ArvoContract/VersionedArvoContract/index.js

@@ -1,12 +1,25 @@
 "use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": 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_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.
@@ -20,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 () {
@@ -52,7 +65,7 @@ var VersionedArvoContract = /** @class */ (function () {
     });
     Object.defineProperty(VersionedArvoContract.prototype, "systemError", {
         get: function () {
-            return this._contract.systemError;
+            return __assign(__assign({}, this._contract.systemError), { dataschema: utils_1.EventDataschemaUtil.build(this.uri, WildCardArvoSemanticVersion_1.WildCardArvoSemanticVersion) });
         },
         enumerable: false,
         configurable: true
@@ -78,6 +91,13 @@ var VersionedArvoContract = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(VersionedArvoContract.prototype, "dataschema", {
+        get: function () {
+            return utils_1.EventDataschemaUtil.build(this.uri, this.version);
+        },
+        enumerable: false,
+        configurable: true
+    });
     /**
      * Converts the contract to JSON Schema format
      * @returns Contract specification in JSON Schema format for documentation/serialization

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