arvo-core 3.0.7 → 3.0.9

package/dist/ArvoEvent/helpers.js

@@ -7,8 +7,8 @@ exports.createArvoEvent = void 0;
 var _1 = __importDefault(require("."));
 var OpenTelemetry_1 = require("../OpenTelemetry");
 var utils_1 = require("../utils");
-var schema_1 = require("./schema");
 var id_1 = require("./id");
+var schema_1 = require("./schema");
 /**
  * Internal generator function for creating  instances.
  */

package/dist/ArvoEvent/id.d.ts

@@ -1,5 +1,5 @@
-import { CreateArvoEvent } from './types';
 import { z } from 'zod';
+import type { CreateArvoEvent } from './types';
 export declare const ArvoEventIdObjectSchema: z.ZodObject<{
     uuid: z.ZodString;
     value: z.ZodString;

package/dist/ArvoOrchestrationSubject/schema.d.ts

@@ -4,11 +4,11 @@ export declare const ArvoOrchestrationSubjectContentSchema: z.ZodObject<{
         name: z.ZodEffects<z.ZodString, string, string>;
         version: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        version: string;
         name: string;
-    }, {
         version: string;
+    }, {
         name: string;
+        version: string;
     }>;
     execution: z.ZodObject<{
         id: z.ZodEffects<z.ZodString, string, string>;
@@ -26,8 +26,8 @@ export declare const ArvoOrchestrationSubjectContentSchema: z.ZodObject<{
     meta: z.ZodRecord<z.ZodString, z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     orchestrator: {
-        version: string;
         name: string;
+        version: string;
     };
     execution: {
         id: string;
@@ -37,8 +37,8 @@ export declare const ArvoOrchestrationSubjectContentSchema: z.ZodObject<{
     meta: Record<string, string>;
 }, {
     orchestrator: {
-        version: string;
         name: string;
+        version: string;
     };
     execution: {
         id: string;

package/dist/errors.d.ts

@@ -26,6 +26,8 @@ export declare class ViolationError<T extends string = string> extends Error {
     readonly type: T;
     /** Additional structured data about the violation */
     readonly metadata: Record<string, any> | null;
+    /** An additional flag to determine if it is an Arvo specific violation error */
+    readonly isArvoViolationError = true;
     /**
      * The error name, formatted as ViolationError<TYPE>
      * This helps with error identification in logs and stack traces
@@ -33,3 +35,22 @@ export declare class ViolationError<T extends string = string> extends Error {
     readonly name: `ViolationError<${T}>`;
     constructor({ type, message, metadata }: ViolationErrorParam<T>);
 }
+/**
+ * Type guard to determine if an unknown value is a ViolationError, an instance
+ * of a class that inherits from ViolationError.
+ *
+ * @param e - The value to check, typically an unknown error or exception
+ * @returns `true` if the value is a ViolationError, inherits from it, or has the isArvoViolationError flag, `false` otherwise
+ *
+ * ```typescript
+ * const error = new ViolationError({
+ *   type: 'RATE_LIMIT',
+ *   message: 'API rate limit exceeded'
+ * });
+ *
+ * console.log(isViolationError(error)); // true
+ * console.log(isViolationError(new Error())); // false
+ * console.log(isViolationError(null)); // false
+ * ```
+ */
+export declare const isViolationError: (e: unknown) => boolean;

package/dist/errors.js

@@ -14,8 +14,12 @@ var __extends = (this && this.__extends) || (function () {
         d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ViolationError = void 0;
+exports.isViolationError = exports.ViolationError = void 0;
+var zod_1 = __importDefault(require("zod"));
 /**
  * ViolationError represents errors that require explicit handling in the system.
  * These are distinct from recoverable errors that can be automatically handled
@@ -33,6 +37,8 @@ var ViolationError = /** @class */ (function (_super) {
     function ViolationError(_a) {
         var type = _a.type, message = _a.message, metadata = _a.metadata;
         var _this = _super.call(this, "ViolationError<".concat(type, "> ").concat(message)) || this;
+        /** An additional flag to determine if it is an Arvo specific violation error */
+        _this.isArvoViolationError = true;
         _this.type = type;
         _this.name = "ViolationError<".concat(_this.type, ">");
         _this.metadata = metadata !== null && metadata !== void 0 ? metadata : null;
@@ -41,3 +47,31 @@ var ViolationError = /** @class */ (function (_super) {
     return ViolationError;
 }(Error));
 exports.ViolationError = ViolationError;
+/**
+ * Type guard to determine if an unknown value is a ViolationError, an instance
+ * of a class that inherits from ViolationError.
+ *
+ * @param e - The value to check, typically an unknown error or exception
+ * @returns `true` if the value is a ViolationError, inherits from it, or has the isArvoViolationError flag, `false` otherwise
+ *
+ * ```typescript
+ * const error = new ViolationError({
+ *   type: 'RATE_LIMIT',
+ *   message: 'API rate limit exceeded'
+ * });
+ *
+ * console.log(isViolationError(error)); // true
+ * console.log(isViolationError(new Error())); // false
+ * console.log(isViolationError(null)); // false
+ * ```
+ */
+var isViolationError = function (e) {
+    var ViolationErrorSchema = zod_1.default.object({
+        isArvoViolationError: zod_1.default.literal(true),
+        type: zod_1.default.string().min(1),
+        name: zod_1.default.string().min(1),
+        message: zod_1.default.string().min(1),
+    });
+    return e instanceof Error && ViolationErrorSchema.safeParse(e).success;
+};
+exports.isViolationError = isViolationError;

package/dist/index.d.ts

@@ -13,6 +13,7 @@ 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 { ArvoEventIdObject, ArvoEventIdObjectSchema, createArvoEventId, parseArvoEventId } from './ArvoEvent/id';
 import ArvoEventFactory from './ArvoEventFactory';
 import { ArvoOrchestratorEventFactory } from './ArvoEventFactory/Orchestrator';
 import { createArvoEventFactory, createArvoOrchestratorEventFactory } from './ArvoEventFactory/helpers';
@@ -26,10 +27,9 @@ 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 { ViolationError, ViolationErrorParam, isViolationError } from './errors';
 import { ArvoErrorSchema, ArvoSemanticVersionSchema, isValidArvoSemanticVersion } from './schema';
 import { ArvoErrorType, ArvoSemanticVersion, InferArvoEvent, InferVersionedArvoContract } from './types';
-import { ArvoEventIdObjectSchema, createArvoEventId, parseArvoEventId, ArvoEventIdObject } from './ArvoEvent/id';
 /**
  * Collection of Zod schemas for validating various aspects of Arvo events.
  * @property {z.ZodObject} CloudEventContextSchema - Schema for core CloudEvent properties.
@@ -110,4 +110,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, createArvoError, createArvoEventId, parseArvoEventId, ArvoEventIdObjectSchema, ArvoEventIdObject, };
+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, createArvoEventId, parseArvoEventId, ArvoEventIdObjectSchema, ArvoEventIdObject, isViolationError, };

package/dist/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArvoEventIdObjectSchema = exports.parseArvoEventId = exports.createArvoEventId = 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;
+exports.isViolationError = exports.ArvoEventIdObjectSchema = exports.parseArvoEventId = exports.createArvoEventId = 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");
@@ -36,6 +36,10 @@ Object.defineProperty(exports, "WildCardArvoSemanticVersion", { enumerable: true
 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 id_1 = require("./ArvoEvent/id");
+Object.defineProperty(exports, "ArvoEventIdObjectSchema", { enumerable: true, get: function () { return id_1.ArvoEventIdObjectSchema; } });
+Object.defineProperty(exports, "createArvoEventId", { enumerable: true, get: function () { return id_1.createArvoEventId; } });
+Object.defineProperty(exports, "parseArvoEventId", { enumerable: true, get: function () { return id_1.parseArvoEventId; } });
 var ArvoEventFactory_1 = __importDefault(require("./ArvoEventFactory"));
 exports.ArvoEventFactory = ArvoEventFactory_1.default;
 var Orchestrator_1 = require("./ArvoEventFactory/Orchestrator");
@@ -62,14 +66,11 @@ 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; } });
+Object.defineProperty(exports, "isViolationError", { enumerable: true, get: function () { return errors_1.isViolationError; } });
 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; } });
-var id_1 = require("./ArvoEvent/id");
-Object.defineProperty(exports, "ArvoEventIdObjectSchema", { enumerable: true, get: function () { return id_1.ArvoEventIdObjectSchema; } });
-Object.defineProperty(exports, "createArvoEventId", { enumerable: true, get: function () { return id_1.createArvoEventId; } });
-Object.defineProperty(exports, "parseArvoEventId", { enumerable: true, get: function () { return id_1.parseArvoEventId; } });
 /**
  * Collection of Zod schemas for validating various aspects of Arvo events.
  * @property {z.ZodObject} CloudEventContextSchema - Schema for core CloudEvent properties.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arvo-core",
-  "version": "3.0.7",
+  "version": "3.0.9",
   "description": "This core package contains all the core classes and components of the Arvo Event Driven System",
   "main": "dist/index.js",
   "scripts": {