@hotmeshio/hotmesh 0.1.10 → 0.1.11

package/build/modules/errors.d.ts

@@ -27,6 +27,7 @@ declare class DurableProxyError extends Error {
     maximumInterval: number;
     originJobId: string | null;
     parentWorkflowId: string;
+    expire: number;
     workflowDimension: string;
     workflowId: string;
     workflowTopic: string;
@@ -37,6 +38,8 @@ declare class DurableChildError extends Error {
     arguments: string[];
     backoffCoefficient: number;
     code: number;
+    expire: number;
+    signalIn: boolean;
     workflowDimension: string;
     index: number;
     maximumAttempts: number;

package/build/modules/errors.js

@@ -33,6 +33,7 @@ class DurableProxyError extends Error {
         this.workflowId = params.workflowId;
         this.workflowTopic = params.workflowTopic;
         this.parentWorkflowId = params.parentWorkflowId;
+        this.expire = params.expire;
         this.originJobId = params.originJobId;
         this.index = params.index;
         this.activityName = params.activityName;
@@ -51,6 +52,8 @@ class DurableChildError extends Error {
         this.workflowId = params.workflowId;
         this.workflowTopic = params.workflowTopic;
         this.parentWorkflowId = params.parentWorkflowId;
+        this.expire = params.expire;
+        this.signalIn = params.signalIn;
         this.originJobId = params.originJobId;
         this.index = params.index;
         this.workflowDimension = params.workflowDimension;

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hotmeshio/hotmesh",
-    "version": "0.1.10",
+    "version": "0.1.11",
     "description": "Unbreakable Workflows",
     "main": "./build/index.js",
     "types": "./build/index.d.ts",

package/build/services/durable/client.d.ts

@@ -7,7 +7,7 @@ export declare class ClientService {
     static topics: string[];
     static instances: Map<string, HotMesh | Promise<HotMesh>>;
     constructor(config: ClientConfig);
-    getHotMeshClient: (workflowTopic: string, namespace?: string) => Promise<HotMesh>;
+    getHotMeshClient: (workflowTopic: string | null, namespace?: string) => Promise<HotMesh>;
     /**
      * Creates a stream (Redis `XGROUP.CREATE`) where events can be published (XADD).
      * It is possible that the worker that will read from this stream channel
@@ -38,6 +38,11 @@ export declare class ClientService {
         getHandle: (taskQueue: string, workflowName: string, workflowId: string, namespace?: string) => Promise<WorkflowHandleService>;
         search: (taskQueue: string, workflowName: string, namespace: null | string, index: string, ...query: string[]) => Promise<string[]>;
     };
+    /**
+     * Any point of presence can be used to deploy and activate the HotMesh
+     * distributed executable to the active quorum.
+     */
+    deployAndActivate(namespace?: string, version?: string): Promise<void>;
     verifyWorkflowActive(hotMesh: HotMesh, appId?: string, count?: number): Promise<boolean>;
     activateWorkflow(hotMesh: HotMesh, appId?: string, version?: string): Promise<void>;
     static shutdown(): Promise<void>;

package/build/services/durable/client.js

@@ -151,6 +151,17 @@ class ClientService {
         };
         this.connection = config.connection;
     }
+    /**
+     * Any point of presence can be used to deploy and activate the HotMesh
+     * distributed executable to the active quorum.
+     */
+    async deployAndActivate(namespace = factory_1.APP_ID, version = factory_1.APP_VERSION) {
+        if (isNaN(Number(version))) {
+            throw new Error('Invalid version number');
+        }
+        const hotMesh = await this.getHotMeshClient('', namespace);
+        await this.activateWorkflow(hotMesh, namespace, version);
+    }
     async verifyWorkflowActive(hotMesh, appId = factory_1.APP_ID, count = 0) {
         const app = await hotMesh.engine.store.getApp(appId);
         const appVersion = app?.version;
@@ -166,24 +177,24 @@ class ClientService {
     async activateWorkflow(hotMesh, appId = factory_1.APP_ID, version = factory_1.APP_VERSION) {
         const app = await hotMesh.engine.store.getApp(appId);
         const appVersion = app?.version;
-        if (isNaN(appVersion)) {
+        if (appVersion === version && !app.active) {
             try {
-                await hotMesh.deploy((0, factory_1.getWorkflowYAML)(appId, version));
                 await hotMesh.activate(version);
             }
             catch (error) {
-                hotMesh.engine.logger.error('durable-client-deploy-activate-err', {
-                    ...error,
-                });
+                hotMesh.engine.logger.error('durable-client-activate-err', { error });
                 throw error;
             }
         }
-        else if (app && !app.active) {
+        else if (isNaN(Number(appVersion)) || appVersion <= version) {
             try {
+                await hotMesh.deploy((0, factory_1.getWorkflowYAML)(appId, version));
                 await hotMesh.activate(version);
             }
             catch (error) {
-                hotMesh.engine.logger.error('durable-client-activate-err', { error });
+                hotMesh.engine.logger.error('durable-client-deploy-activate-err', {
+                    ...error,
+                });
                 throw error;
             }
         }

package/build/services/durable/schemas/factory.js

@@ -235,6 +235,10 @@ const getWorkflowYAML = (app, version) => {
                     type: number
                   maximumInterval:
                     type: number
+                  expire:
+                    type: number
+                  signalIn:
+                    type: boolean
                   await:
                     type: string
                     description: when set to false, do not await the child flow's completion
@@ -338,6 +342,8 @@ const getWorkflowYAML = (app, version) => {
                   type: number
                 expire:
                   type: number
+                signalIn:
+                  type: boolean
                 parentWorkflowId:
                   type: string
                   description: used to forge the cleanup key
@@ -358,6 +364,8 @@ const getWorkflowYAML = (app, version) => {
               index: '{worker.output.data.index}'
               originJobId: '{worker.output.data.originJobId}'
               parentWorkflowId: '{worker.output.data.parentWorkflowId}'
+              expire: '{worker.output.data.expire}'
+              signalIn: '{worker.output.data.signalIn}'
               workflowId: '{worker.output.data.workflowId}'
               workflowName: '{worker.output.data.workflowName}'
               workflowTopic: '{worker.output.data.workflowTopic}'
@@ -515,6 +523,8 @@ const getWorkflowYAML = (app, version) => {
                   description: the arguments to pass to the activity
                   items:
                     type: string
+                expire:
+                  type: number
                 backoffCoefficient:
                   type: number
                 maximumAttempts:
@@ -530,6 +540,7 @@ const getWorkflowYAML = (app, version) => {
               parentWorkflowId: '{worker.output.data.workflowId}'
               workflowId: '{worker.output.data.workflowId}'
               workflowTopic: '{worker.output.data.workflowTopic}'
+              expire: '{worker.output.data.expire}'
               backoffCoefficient:
                 '@pipe':
                   - ['{worker.output.data.backoffCoefficient}','{trigger.output.data.backoffCoefficient}']
@@ -757,6 +768,17 @@ const getWorkflowYAML = (app, version) => {
                     - ['{trigger.output.data.maximumInterval}', 120]
                     - ['{@logical.or}']
                   - ['{@math.min}']
+        ender:
+          title: Sets job data; ignores the \`Signal In\` Hook Channel which was suppressed
+          type: hook
+          job:
+            maps:
+              done: true
+              $error: '{worker.output.data.$error}'
+              jc: '{$job.metadata.jc}'
+              ju:
+                '@pipe':
+                  - ['{@date.toISOXString}']
 
         closer:
           title: Closes the \`Signal In\` Hook Channel, so the workflow can exit
@@ -942,6 +964,11 @@ const getWorkflowYAML = (app, version) => {
                   maximumInterval:
                     type: number
                     description: the maximum time in seconds to wait between retries; provides a fixed limit to exponential backoff growth
+                  expire:
+                    type: number
+                  signalIn:
+                    type: boolean
+                    description: if false, the spawned child will not support subordinated hooks
                   await:
                     type: string
                     description: when set to false, do not await the child flow's completion
@@ -969,6 +996,8 @@ const getWorkflowYAML = (app, version) => {
                     type: string
                   originJobId:
                     type: string
+                  expire:
+                    type: number
                   backoffCoefficient:
                     type: number
                   maximumAttempts:
@@ -1042,6 +1071,8 @@ const getWorkflowYAML = (app, version) => {
                   type: number
                 expire:
                   type: number
+                signalIn:
+                  type: boolean
                 parentWorkflowId:
                   type: string
                   description: used to forge the cleanup key
@@ -1062,6 +1093,8 @@ const getWorkflowYAML = (app, version) => {
               index: '{signaler_worker.output.data.index}'
               originJobId: '{signaler_worker.output.data.originJobId}'
               parentWorkflowId: '{signaler_worker.output.data.parentWorkflowId}'
+              expire: '{signaler_worker.output.data.expire}'
+              signalIn: '{signaler_worker.output.data.signalIn}'
               workflowId: '{signaler_worker.output.data.workflowId}'
               workflowName: '{signaler_worker.output.data.workflowName}'
               workflowTopic: '{signaler_worker.output.data.workflowTopic}'
@@ -1219,6 +1252,8 @@ const getWorkflowYAML = (app, version) => {
                   description: the arguments to pass to the activity
                   items:
                     type: string
+                expire:
+                  type: number
                 backoffCoefficient:
                   type: number
                 maximumAttempts:
@@ -1234,6 +1269,7 @@ const getWorkflowYAML = (app, version) => {
               parentWorkflowId: '{signaler_worker.output.data.workflowId}'
               workflowId: '{signaler_worker.output.data.workflowId}'
               workflowTopic: '{signaler_worker.output.data.workflowTopic}'
+              expire: '{signaler_worker.output.data.expire}'
               backoffCoefficient:
                 '@pipe':
                   - ['{signaler_worker.output.data.backoffCoefficient}','{trigger.output.data.backoffCoefficient}']
@@ -1479,9 +1515,24 @@ const getWorkflowYAML = (app, version) => {
         throttler:
           - to: worker
         worker:
+          - to: ender
+            conditions:
+              code: [200, 596, 597, 598]
+              match:
+                - expected: false
+                  actual: 
+                    '@pipe':
+                      - ['{trigger.output.data.signalIn}', true]
+                      - ['{@conditional.nullish}']
           - to: closer
             conditions:
               code: [200, 596, 597, 598]
+              match:
+                - expected: true
+                  actual: 
+                    '@pipe':
+                      - ['{trigger.output.data.signalIn}', true]
+                      - ['{@conditional.nullish}']
           - to: sleeper
             conditions:
               code: 588

package/build/services/durable/worker.js

@@ -310,6 +310,7 @@ class WorkerService {
                             index: err.index,
                             originJobId: err.originJobId,
                             parentWorkflowId: err.parentWorkflowId,
+                            expire: err.expire,
                             workflowId: err.workflowId,
                             workflowTopic: err.workflowTopic,
                             activityName: err.activityName,
@@ -342,6 +343,8 @@ class WorkerService {
                             maximumInterval: err.maximumInterval || (0, ms_1.default)(enums_1.HMSH_DURABLE_MAX_INTERVAL) / 1000,
                             originJobId: err.originJobId,
                             parentWorkflowId: err.parentWorkflowId,
+                            expire: err.expire,
+                            signalIn: err.signalIn,
                             workflowDimension: err.workflowDimension,
                             workflowId: err.workflowId,
                             workflowTopic: err.workflowTopic,

package/build/services/durable/workflow.js

@@ -190,6 +190,8 @@ class WorkflowService {
             maximumInterval: (0, ms_1.default)(options?.config?.maximumInterval ?? enums_1.HMSH_DURABLE_MAX_INTERVAL) /
                 1000,
             originJobId: originJobId ?? workflowId,
+            expire: options.expire,
+            signalIn: options.signalIn,
             parentWorkflowId,
             workflowDimension: workflowDimension,
             workflowId: childJobId,
@@ -303,6 +305,7 @@ class WorkflowService {
             workflowId: activityJobId,
             workflowTopic: activityTopic,
             activityName,
+            expire: options.expire,
             backoffCoefficient: options?.retryPolicy?.backoffCoefficient ?? undefined,
             maximumAttempts: options?.retryPolicy?.maximumAttempts ?? undefined,
             maximumInterval: maximumInterval ?? undefined,

package/build/types/durable.d.ts

@@ -426,6 +426,8 @@ type ProxyType<ACT> = {
  * Configuration settings for activities within a workflow.
  */
 type ActivityConfig = {
+    /** place holder setting; unused at this time (re: activity workflow expire configuration) */
+    expire?: number;
     /** Start to close timeout for the activity; not yet implemented */
     startToCloseTimeout?: string;
     /** Configuration for specific activities, type not yet specified */

package/build/types/error.d.ts

@@ -3,6 +3,8 @@ export type DurableChildErrorType = {
     await?: boolean;
     backoffCoefficient?: number;
     index: number;
+    expire?: number;
+    signalIn?: boolean;
     maximumAttempts?: number;
     maximumInterval?: number;
     originJobId: string | null;
@@ -26,6 +28,7 @@ export type DurableProxyErrorType = {
     activityName: string;
     backoffCoefficient?: number;
     index: number;
+    expire?: number;
     maximumAttempts?: number;
     maximumInterval?: number;
     originJobId: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotmeshio/hotmesh",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Unbreakable Workflows",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",

package/types/durable.ts

@@ -521,6 +521,9 @@ type ProxyType<ACT> = {
  * Configuration settings for activities within a workflow.
  */
 type ActivityConfig = {
+  /** place holder setting; unused at this time (re: activity workflow expire configuration) */
+  expire?: number;
+
   /** Start to close timeout for the activity; not yet implemented */
   startToCloseTimeout?: string;
 

package/types/error.ts

@@ -3,6 +3,8 @@ export type DurableChildErrorType = {
   await?: boolean;
   backoffCoefficient?: number;
   index: number;
+  expire?: number;
+  signalIn?: boolean;
   maximumAttempts?: number;
   maximumInterval?: number;
   originJobId: string | null;
@@ -28,6 +30,7 @@ export type DurableProxyErrorType = {
   activityName: string;
   backoffCoefficient?: number;
   index: number;
+  expire?: number;
   maximumAttempts?: number;
   maximumInterval?: number;
   originJobId: string | null;