arvo-core 1.2.0 → 1.2.2

package/dist/ArvoOrchestrationSubject/index.d.ts

@@ -46,6 +46,45 @@ export default class ArvoOrchestrationSubject {
         initiator: string;
         meta?: Record<string, string>;
     }): string;
+    /**
+     * Creates a new orchestration subject string from an existing parent subject.
+     * This method parses the parent subject, merges its metadata with new metadata (if available),
+     * and creates a new subject with updated orchestrator information while maintaining
+     * the relationship to the parent context.
+     *
+     * @param param - Configuration object for creating a new subject from a parent
+     * @param param.orchestator - Name identifier of the new orchestrator
+     * @param param.version - Version of the new orchestrator. If null, defaults to {@link WildCardMachineVersion}
+     * @param param.subject - Base64 encoded string of the parent orchestration subject
+     * @param param.meta - Optional additional metadata to merge with the parent's metadata
+     * @returns A new base64 encoded string containing the compressed orchestration subject data
+     * @throws Error if the parent subject is invalid or if the new parameters result in invalid subject content
+     *
+     * @example
+     * ```typescript
+     * // Create a parent subject
+     * const parentSubject = ArvoOrchestrationSubject.new({
+     *   orchestator: "parentProcess",
+     *   version: "1.0.0",
+     *   initiator: "systemA",
+     *   meta: { environment: "production" }
+     * });
+     *
+     * // Create a new subject from the parent
+     * const childSubject = ArvoOrchestrationSubject.from({
+     *   orchestator: "childProcess",
+     *   version: "2.0.0",
+     *   subject: parentSubject,
+     *   meta: { step: "processing" }  // Will be merged with parent's metadata
+     * });
+     * ```
+     */
+    static from(param: {
+        orchestator: string;
+        version: ArvoOrchestratorVersion | null;
+        subject: string;
+        meta?: Record<string, string>;
+    }): string;
     /**
      * Creates an Arvo orchestration subject from detailed content parameters.
      * The content is validated, compressed using zlib, and encoded in base64 format.

package/dist/ArvoOrchestrationSubject/index.js

@@ -1,4 +1,15 @@
 "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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -79,6 +90,49 @@ var ArvoOrchestrationSubject = /** @class */ (function () {
             meta: (_b = param.meta) !== null && _b !== void 0 ? _b : {}
         });
     };
+    /**
+     * Creates a new orchestration subject string from an existing parent subject.
+     * This method parses the parent subject, merges its metadata with new metadata (if available),
+     * and creates a new subject with updated orchestrator information while maintaining
+     * the relationship to the parent context.
+     *
+     * @param param - Configuration object for creating a new subject from a parent
+     * @param param.orchestator - Name identifier of the new orchestrator
+     * @param param.version - Version of the new orchestrator. If null, defaults to {@link WildCardMachineVersion}
+     * @param param.subject - Base64 encoded string of the parent orchestration subject
+     * @param param.meta - Optional additional metadata to merge with the parent's metadata
+     * @returns A new base64 encoded string containing the compressed orchestration subject data
+     * @throws Error if the parent subject is invalid or if the new parameters result in invalid subject content
+     *
+     * @example
+     * ```typescript
+     * // Create a parent subject
+     * const parentSubject = ArvoOrchestrationSubject.new({
+     *   orchestator: "parentProcess",
+     *   version: "1.0.0",
+     *   initiator: "systemA",
+     *   meta: { environment: "production" }
+     * });
+     *
+     * // Create a new subject from the parent
+     * const childSubject = ArvoOrchestrationSubject.from({
+     *   orchestator: "childProcess",
+     *   version: "2.0.0",
+     *   subject: parentSubject,
+     *   meta: { step: "processing" }  // Will be merged with parent's metadata
+     * });
+     * ```
+     */
+    ArvoOrchestrationSubject.from = function (param) {
+        var _a, _b, _c;
+        var parsedSubject = ArvoOrchestrationSubject.parse(param.subject);
+        return ArvoOrchestrationSubject.new({
+            initiator: parsedSubject.orchestrator.name,
+            version: (_a = param.version) !== null && _a !== void 0 ? _a : ArvoOrchestrationSubject.WildCardMachineVersion,
+            orchestator: param.orchestator,
+            meta: __assign(__assign({}, ((_b = parsedSubject.meta) !== null && _b !== void 0 ? _b : {})), ((_c = param.meta) !== null && _c !== void 0 ? _c : {}))
+        });
+    };
     /**
      * Creates an Arvo orchestration subject from detailed content parameters.
      * The content is validated, compressed using zlib, and encoded in base64 format.

package/dist/ArvoOrchestratorContract/helpers.d.ts

@@ -58,10 +58,10 @@ import ArvoOrchestratorContract from '.';
  * In this example, the actual init schema will be an intersection of the provided schema
  * and the OrchestrationInitEventBaseSchema, ensuring all necessary fields are included.
  */
-export declare const createArvoOrchestratorContract: <TUri extends string, TName extends string, TInit extends z.ZodTypeAny, TComplete extends z.ZodTypeAny>(param: ICreateArvoOrchestratorContract<TUri, TName, TInit, TComplete>) => ArvoOrchestratorContract<TUri, `arvo.orc.${TName}`, z.ZodIntersection<z.ZodObject<{
+export declare const createArvoOrchestratorContract: <TUri extends string, TName extends string, TInit extends z.AnyZodObject, TComplete extends z.AnyZodObject>(param: ICreateArvoOrchestratorContract<TUri, TName, TInit, TComplete>) => ArvoOrchestratorContract<TUri, `arvo.orc.${TName}`, z.ZodObject<z.objectUtil.extendShape<{
     parentSubject$$: z.ZodNullable<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    parentSubject$$: string | null;
-}, {
-    parentSubject$$: string | null;
-}>, TInit>, `arvo.orc.${TName}.done`, TComplete>;
+}, TInit["shape"]>, TInit["_def"]["unknownKeys"], TInit["_def"]["catchall"], z.objectOutputType<z.objectUtil.extendShape<{
+    parentSubject$$: z.ZodNullable<z.ZodString>;
+}, TInit["shape"]>, TInit["_def"]["catchall"], TInit["_def"]["unknownKeys"]>, z.objectInputType<z.objectUtil.extendShape<{
+    parentSubject$$: z.ZodNullable<z.ZodString>;
+}, TInit["shape"]>, TInit["_def"]["catchall"], TInit["_def"]["unknownKeys"]>>, `arvo.orc.${TName}.done`, TComplete>;

package/dist/ArvoOrchestratorContract/helpers.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createArvoOrchestratorContract = void 0;
-var zod_1 = require("zod");
 var _1 = __importDefault(require("."));
 var typegen_1 = require("./typegen");
 var schema_1 = require("./schema");
@@ -86,11 +85,12 @@ var createArvoOrchestratorContract = function (param) {
     if (!isLowerAlphanumeric(param.name)) {
         throw new Error("Invalid 'name' = '".concat(param.name, "'. The 'name' must only contain alphanumeric characters. e.g. test.orchestrator"));
     }
+    var mergedSchema = schema_1.OrchestrationInitEventBaseSchema.merge(param.schema.init);
     return new _1.default({
         uri: param.uri,
         init: {
             type: typegen_1.ArvoOrchestratorEventTypeGen.init(param.name),
-            schema: zod_1.z.intersection(schema_1.OrchestrationInitEventBaseSchema, param.schema.init),
+            schema: mergedSchema,
         },
         complete: {
             type: typegen_1.ArvoOrchestratorEventTypeGen.complete(param.name),

package/package.json

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