arvo-core 1.2.0 → 1.2.1

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/package.json

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