@hotmeshio/hotmesh 0.1.9 → 0.1.10

package/build/package.json

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

package/build/services/activities/activity.d.ts

@@ -26,6 +26,12 @@ declare class Activity {
     adjacentIndex: number;
     constructor(config: ActivityType, data: ActivityData, metadata: ActivityMetadata, hook: ActivityData | null, engine: EngineService, context?: JobState);
     setLeg(leg: ActivityLeg): void;
+    /**
+     * A job is assumed to be complete when its status (a semaphore)
+     * reaches `0`. A different threshold can be set in the
+     * activity YAML, in support of Dynamic Activation Control.
+     */
+    mapStatusThreshold(): number;
     /**
      * Upon entering leg 1 of a duplexed activity
      */
@@ -55,7 +61,7 @@ declare class Activity {
     bindJobError(data: Record<string, unknown>): void;
     getTriggerConfig(): Promise<ActivityType>;
     getJobStatus(): null | number;
-    setStatus(amount: number, multi?: RedisMulti): Promise<void>;
+    setStatus(amount: number, multi?: RedisMulti): Promise<void | any>;
     authorizeEntry(state: StringAnyType): string[];
     bindDimensionalAddress(state: StringAnyType): void;
     setState(multi?: RedisMulti): Promise<string>;

package/build/services/activities/activity.js

@@ -30,13 +30,44 @@ class Activity {
     setLeg(leg) {
         this.leg = leg;
     }
+    /**
+     * A job is assumed to be complete when its status (a semaphore)
+     * reaches `0`. A different threshold can be set in the
+     * activity YAML, in support of Dynamic Activation Control.
+     */
+    mapStatusThreshold() {
+        if (this.config.statusThreshold !== undefined) {
+            const threshold = pipe_1.Pipe.resolve(this.config.statusThreshold, this.context);
+            if (threshold !== undefined && !isNaN(Number(threshold))) {
+                return threshold;
+            }
+        }
+        return 0;
+    }
     /**
      * Upon entering leg 1 of a duplexed activity
      */
     async verifyEntry() {
         this.setLeg(1);
         await this.getState();
-        collator_1.CollatorService.assertJobActive(this.context.metadata.js, this.context.metadata.jid, this.metadata.aid);
+        const threshold = this.mapStatusThreshold();
+        try {
+            collator_1.CollatorService.assertJobActive(this.context.metadata.js, this.context.metadata.jid, this.metadata.aid, threshold);
+        }
+        catch (error) {
+            if (threshold > 0) {
+                if (this.context.metadata.js === threshold) {
+                    //conclude job EXACTLY ONCE
+                    const status = await this.setStatus(-threshold);
+                    if (Number(status) === 0) {
+                        await this.engine.runJobCompletionTasks(this.context);
+                    }
+                }
+            }
+            else {
+                throw error;
+            }
+        }
         await collator_1.CollatorService.notarizeEntry(this);
     }
     /**
@@ -247,7 +278,7 @@ class Activity {
     }
     async setStatus(amount, multi) {
         const { id: appId } = await this.engine.getVID();
-        await this.store.setStatus(amount, this.context.metadata.jid, appId, multi);
+        return await this.store.setStatus(amount, this.context.metadata.jid, appId, multi);
     }
     authorizeEntry(state) {
         //pre-authorize activity state to allow entry for adjacent activities

package/build/services/collator/index.d.ts

@@ -9,7 +9,7 @@ declare class CollatorService {
     /**
      * Upon re/entry, verify that the job status is active
      */
-    static assertJobActive(status: number, jobId: string, activityId: string): void;
+    static assertJobActive(status: number, jobId: string, activityId: string, threshold?: number): void;
     /**
      * returns the dimensional address (dad) for the target; due
      * to the nature of the notary system, the dad for leg 2 entry

package/build/services/collator/index.js

@@ -7,8 +7,8 @@ class CollatorService {
     /**
      * Upon re/entry, verify that the job status is active
      */
-    static assertJobActive(status, jobId, activityId) {
-        if (status <= 0) {
+    static assertJobActive(status, jobId, activityId, threshold = 0) {
+        if (status <= threshold) {
             throw new errors_1.InactiveJobError(jobId, status, activityId);
         }
     }

package/build/services/durable/client.js

@@ -78,6 +78,7 @@ class ClientService {
                     arguments: [...options.args],
                     originJobId: options.originJobId,
                     expire: options.expire ?? enums_1.HMSH_EXPIRE_JOB_SECONDS,
+                    signalIn: options.signalIn,
                     parentWorkflowId: options.parentWorkflowId,
                     workflowId: options.workflowId || hotmesh_1.HotMeshService.guid(),
                     workflowTopic: workflowTopic,

package/build/services/durable/schemas/factory.d.ts

@@ -21,7 +21,7 @@
  * * Service Meshes
  * * Master Data Management systems
  */
-declare const APP_VERSION = "1";
+declare const APP_VERSION = "2";
 declare const APP_ID = "durable";
 /**
  * returns a new durable workflow schema

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

@@ -24,7 +24,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.APP_ID = exports.APP_VERSION = exports.getWorkflowYAML = void 0;
-const APP_VERSION = '1';
+const APP_VERSION = '2';
 exports.APP_VERSION = APP_VERSION;
 const APP_ID = 'durable';
 exports.APP_ID = APP_ID;
@@ -81,6 +81,9 @@ const getWorkflowYAML = (app, version) => {
             expire:
               description: the time in seconds to expire the workflow in Redis once it completes
               type: number
+            signalIn:
+              description: if false, the job will not support subordinated hooks
+              type: boolean
 
       output:
         schema:
@@ -806,6 +809,7 @@ const getWorkflowYAML = (app, version) => {
         signaler:
           title: Signal-In Reentry point for subordinated hook flows
           type: hook
+          statusThreshold: 1
           hook:
             type: object
             properties:
@@ -1462,6 +1466,13 @@ const getWorkflowYAML = (app, version) => {
         trigger:
           - to: cycle_hook
           - to: signaler
+            conditions:
+              match:
+                - expected: true
+                  actual: 
+                    '@pipe':
+                      - ['{$self.output.data.signalIn}', true]
+                      - ['{@conditional.nullish}']
         ## MAIN PROCESS TRANSITIONS ##
         cycle_hook:
           - to: throttler

package/build/services/pipe/functions/conditional.d.ts

@@ -2,6 +2,8 @@ declare class ConditionalHandler {
     ternary(condition: boolean, valueIfTrue: any, valueIfFalse: any): any;
     equality(value1: any, value2: any): boolean;
     strict_equality(value1: any, value2: any): boolean;
+    inequality(value1: any, value2: any): boolean;
+    strict_inequality(value1: any, value2: any): boolean;
     greater_than(value1: number, value2: number): boolean;
     less_than(value1: number, value2: number): boolean;
     greater_than_or_equal(value1: number, value2: number): boolean;

package/build/services/pipe/functions/conditional.js

@@ -11,6 +11,12 @@ class ConditionalHandler {
     strict_equality(value1, value2) {
         return value1 === value2;
     }
+    inequality(value1, value2) {
+        return value1 != value2;
+    }
+    strict_inequality(value1, value2) {
+        return value1 !== value2;
+    }
     greater_than(value1, value2) {
         return value1 > value2;
     }

package/build/types/activity.d.ts

@@ -6,6 +6,8 @@ interface BaseActivity {
     title?: string;
     type?: ActivityExecutionType;
     subtype?: string;
+    statusThreshold?: number;
+    statusThresholdType?: 'stop' | 'throw' | 'stall';
     input?: Record<string, any>;
     output?: Record<string, any>;
     settings?: Record<string, any>;

package/build/types/durable.d.ts

@@ -260,6 +260,10 @@ type WorkflowOptions = {
      * sets the number of seconds a workflow may exist after completion. As the process engine is an in-memory cache, the default policy is to expire and scrub the job hash as soon as it completes.
      */
     expire?: number;
+    /**
+     * default is true; set to false to optimize workflows that do not require a `signal in`
+     */
+    signalIn?: boolean;
     /**
      * default is true; if false, will not await the execution
      */

package/package.json

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

package/types/activity.ts

@@ -18,6 +18,8 @@ interface BaseActivity {
   title?: string;
   type?: ActivityExecutionType;
   subtype?: string;
+  statusThreshold?: number; //default is 0; set to 1 to ensure not last standing; message will be ignored as if too late to process
+  statusThresholdType?: 'stop' | 'throw' | 'stall'; //default is stop; must explicitly set to throw to throw an error or stall to stall
   input?: Record<string, any>;
   output?: Record<string, any>;
   settings?: Record<string, any>;

package/types/durable.ts

@@ -314,6 +314,11 @@ type WorkflowOptions = {
    */
   expire?: number;
 
+  /**
+   * default is true; set to false to optimize workflows that do not require a `signal in`
+   */
+  signalIn?: boolean;
+
   /**
    * default is true; if false, will not await the execution
    */