@hotmeshio/hotmesh 0.12.1 → 0.14.0

package/build/services/activities/cycle.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Cycle = void 0;
-const errors_1 = require("../../modules/errors");
 const utils_1 = require("../../modules/utils");
 const collator_1 = require("../collator");
 const telemetry_1 = require("../telemetry");
@@ -89,10 +88,6 @@ const activity_1 = require("./activity");
  * @see {@link CycleActivity} for the TypeScript interface
  */
 class Cycle extends activity_1.Activity {
-    constructor(config, data, metadata, hook, engine, context) {
-        super(config, data, metadata, hook, engine, context);
-    }
-    //********  LEG 1 ENTRY  ********//
     async process() {
         this.logger.debug('cycle-process', {
             jid: this.context.metadata.jid,
@@ -105,10 +100,9 @@ class Cycle extends activity_1.Activity {
             telemetry = new telemetry_1.TelemetryService(this.engine.appId, this.config, this.metadata, this.context);
             telemetry.startActivitySpan(this.leg);
             this.mapInputData();
-            //set state/status, cycle ancestor, and mark Leg1 complete — single transaction
             const transaction = this.store.transact();
             await this.setState(transaction);
-            await this.setStatus(0, transaction); //leg 1 never changes job status
+            await this.setStatus(0, transaction);
             const messageId = await this.cycleAncestorActivity(transaction);
             await collator_1.CollatorService.notarizeLeg1Completion(this, transaction);
             const txResponse = (await transaction.exec());
@@ -121,34 +115,8 @@ class Cycle extends activity_1.Activity {
             return this.context.metadata.aid;
         }
         catch (error) {
-            if (error instanceof errors_1.InactiveJobError) {
-                this.logger.error('cycle-inactive-job-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.GenerationalError) {
-                this.logger.info('process-event-generational-job-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.GetStateError) {
-                this.logger.error('cycle-get-state-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.CollationError) {
-                if (error.fault === 'duplicate') {
-                    this.logger.info('cycle-collation-overage', {
-                        job_id: this.context.metadata.jid,
-                        guid: this.context.metadata.guid,
-                    });
-                    return;
-                }
-                //unknown collation error
-                this.logger.error('cycle-collation-error', { error });
-            }
-            else {
-                this.logger.error('cycle-process-error', { error });
-            }
-            telemetry?.setActivityError(error.message);
-            throw error;
+            this.handleProcessError(error, telemetry, 'cycle');
+            return;
         }
         finally {
             telemetry?.endActivitySpan();
@@ -159,18 +127,7 @@ class Cycle extends activity_1.Activity {
             });
         }
     }
-    /**
-     * Trigger the target ancestor to execute in a cycle,
-     * without violating the constraints of the DAG. Immutable
-     * `individual activity state` will execute in a new dimensional
-     * thread while `shared job state` can change. This
-     * pattern allows for retries without violating the DAG.
-     */
     async cycleAncestorActivity(transaction) {
-        //Cycle activity L1 is a standin for the target ancestor L1.
-        //Input data mapping (mapInputData) allows for the
-        //next dimensonal thread to execute with different
-        //input data than the current dimensional thread
         this.mapInputData();
         const streamData = {
             metadata: {

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

@@ -1,8 +1,7 @@
-import { EngineService } from '../engine';
 import { TelemetryService } from '../telemetry';
-import { ActivityData, ActivityMetadata, ActivityType, HookActivity } from '../../types/activity';
+import { HookActivity } from '../../types/activity';
 import { HookRule } from '../../types/hook';
-import { JobState, JobStatus } from '../../types/job';
+import { JobStatus } from '../../types/job';
 import { ProviderTransaction } from '../../types/provider';
 import { StreamCode, StreamStatus } from '../../types/stream';
 import { Activity } from './activity';
@@ -149,16 +148,8 @@ import { Activity } from './activity';
  */
 declare class Hook extends Activity {
     config: HookActivity;
-    constructor(config: ActivityType, data: ActivityData, metadata: ActivityMetadata, hook: ActivityData | null, engine: EngineService, context?: JobState);
     process(): Promise<string>;
-    /**
-     * Static config check: does this activity have a hook or sleep config?
-     * Used for routing before context is loaded.
-     */
     isConfiguredAsHook(): boolean;
-    /**
-     * does this activity use a time-hook or web-hook
-     */
     doesHook(): boolean;
     doHook(telemetry: TelemetryService): Promise<void>;
     doPassThrough(telemetry: TelemetryService): Promise<void>;

package/build/services/activities/hook.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Hook = void 0;
-const errors_1 = require("../../modules/errors");
 const collator_1 = require("../collator");
 const pipe_1 = require("../pipe");
 const task_1 = require("../task");
@@ -150,10 +149,6 @@ const activity_1 = require("./activity");
  * @see {@link HookActivity} for the TypeScript interface
  */
 class Hook extends activity_1.Activity {
-    constructor(config, data, metadata, hook, engine, context) {
-        super(config, data, metadata, hook, engine, context);
-    }
-    //********  INITIAL ENTRY POINT (A)  ********//
     async process() {
         this.logger.debug('hook-process', {
             jid: this.context.metadata.jid,
@@ -173,7 +168,6 @@ class Hook extends activity_1.Activity {
                 if (!isResume) {
                     await this.doHook(telemetry);
                 }
-                //If resume, Leg1 already ran — Leg2 will handle completion
             }
             else {
                 //Category B: passthrough with crash-safe step protocol + GUID ledger
@@ -182,34 +176,8 @@ class Hook extends activity_1.Activity {
             return this.context.metadata.aid;
         }
         catch (error) {
-            if (error instanceof errors_1.InactiveJobError) {
-                this.logger.error('hook-inactive-job-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.GenerationalError) {
-                this.logger.info('process-event-generational-job-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.GetStateError) {
-                this.logger.error('hook-get-state-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.CollationError) {
-                if (error.fault === 'duplicate') {
-                    this.logger.info('hook-collation-overage', {
-                        job_id: this.context.metadata.jid,
-                        guid: this.context.metadata.guid,
-                    });
-                    return;
-                }
-                //unknown collation error
-                this.logger.error('hook-collation-error', { error });
-            }
-            else {
-                this.logger.error('hook-process-error', { error });
-            }
-            telemetry?.setActivityError(error.message);
-            throw error;
+            this.handleProcessError(error, telemetry, 'hook');
+            return;
         }
         finally {
             telemetry?.endActivitySpan();
@@ -220,22 +188,18 @@ class Hook extends activity_1.Activity {
             });
         }
     }
-    /**
-     * Static config check: does this activity have a hook or sleep config?
-     * Used for routing before context is loaded.
-     */
     isConfiguredAsHook() {
         return !!this.config.sleep || !!this.config.hook?.topic;
     }
-    /**
-     * does this activity use a time-hook or web-hook
-     */
     doesHook() {
+        if (this.config.hook?.topic) {
+            return true;
+        }
         if (this.config.sleep) {
             const duration = pipe_1.Pipe.resolve(this.config.sleep, this.context);
             return !isNaN(duration) && Number(duration) > 0;
         }
-        return !!this.config.hook?.topic;
+        return false;
     }
     async doHook(telemetry) {
         const transaction = this.store.transact();
@@ -252,7 +216,6 @@ class Hook extends activity_1.Activity {
         this.adjacencyList = await this.filterAdjacent();
         this.mapOutputData();
         this.mapJobData();
-        //Category B: use Leg1 step protocol for crash-safe edge capture
         await this.executeLeg1StepProtocol(this.adjacencyList.length - 1);
         telemetry.mapActivityAttributes();
         telemetry.setActivityAttributes({});
@@ -262,16 +225,20 @@ class Hook extends activity_1.Activity {
         return rules?.[topic]?.[0];
     }
     async registerHook(transaction) {
+        let result;
         if (this.config.hook?.topic) {
-            return await this.engine.taskService.registerWebHook(this.config.hook.topic, this.context, this.resolveDad(), this.context.metadata.expire, transaction);
+            result = await this.engine.taskService.registerWebHook(this.config.hook.topic, this.context, this.resolveDad(), this.context.metadata.expire, transaction);
         }
-        else if (this.config.sleep) {
+        if (this.config.sleep) {
             const duration = pipe_1.Pipe.resolve(this.config.sleep, this.context);
-            await this.engine.taskService.registerTimeHook(this.context.metadata.jid, this.context.metadata.gid, `${this.metadata.aid}${this.metadata.dad || ''}`, 'sleep', duration, this.metadata.dad || '', transaction);
-            return this.context.metadata.jid;
+            if (!isNaN(duration) && Number(duration) > 0) {
+                await this.engine.taskService.registerTimeHook(this.context.metadata.jid, this.context.metadata.gid, `${this.metadata.aid}${this.metadata.dad || ''}`, 'sleep', duration, this.metadata.dad || '', transaction);
+                if (!result)
+                    result = this.context.metadata.jid;
+            }
         }
+        return result;
     }
-    //********  SIGNAL RE-ENTRY POINT  ********//
     async processWebHookEvent(status = stream_1.StreamStatus.SUCCESS, code = 200) {
         this.logger.debug('hook-process-web-hook-event', {
             topic: this.config.hook.topic,
@@ -290,8 +257,8 @@ class Hook extends activity_1.Activity {
             await this.processEvent(status, code, 'hook');
             if (code === 200) {
                 await taskService.deleteWebHookSignal(this.config.hook.topic, data);
-            } //else => 202/keep alive
-        } //else => already resolved
+            }
+        }
     }
     async processTimeHookEvent(jobId) {
         this.logger.debug('hook-process-time-hook-event', {
@@ -299,6 +266,19 @@ class Hook extends activity_1.Activity {
             gid: this.context.metadata.gid,
             aid: this.metadata.aid,
         });
+        //if combined hook+sleep, clean up the webhook signal (timeout won the race)
+        if (this.config.hook?.topic) {
+            try {
+                const taskService = new task_1.TaskService(this.store, this.logger);
+                await taskService.deleteWebHookSignal(this.config.hook.topic, this.data);
+            }
+            catch (e) {
+                this.logger.debug('hook-timeout-signal-cleanup', {
+                    topic: this.config.hook.topic,
+                    error: e.message,
+                });
+            }
+        }
         await this.processEvent(stream_1.StreamStatus.SUCCESS, 200, 'hook');
     }
 }

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

@@ -1,7 +1,6 @@
-import { EngineService } from '../engine';
 import { TelemetryService } from '../telemetry';
-import { ActivityData, ActivityMetadata, ActivityType, InterruptActivity } from '../../types/activity';
-import { JobInterruptOptions, JobState } from '../../types/job';
+import { InterruptActivity } from '../../types/activity';
+import { JobInterruptOptions } from '../../types/job';
 import { Activity } from './activity';
 /**
  * Terminates a flow by sending an interrupt signal. The `interrupt` activity
@@ -117,7 +116,6 @@ import { Activity } from './activity';
  */
 declare class Interrupt extends Activity {
     config: InterruptActivity;
-    constructor(config: ActivityType, data: ActivityData, metadata: ActivityMetadata, hook: ActivityData | null, engine: EngineService, context?: JobState);
     process(): Promise<string>;
     interruptSelf(telemetry: TelemetryService): Promise<string>;
     interruptAnother(telemetry: TelemetryService): Promise<string>;

package/build/services/activities/interrupt.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Interrupt = void 0;
-const errors_1 = require("../../modules/errors");
 const collator_1 = require("../collator");
 const pipe_1 = require("../pipe");
 const telemetry_1 = require("../telemetry");
@@ -119,10 +118,6 @@ const activity_1 = require("./activity");
  * @see {@link InterruptActivity} for the TypeScript interface
  */
 class Interrupt extends activity_1.Activity {
-    constructor(config, data, metadata, hook, engine, context) {
-        super(config, data, metadata, hook, engine, context);
-    }
-    //********  LEG 1 ENTRY  ********//
     async process() {
         this.logger.debug('interrupt-process', {
             jid: this.context.metadata.jid,
@@ -147,34 +142,8 @@ class Interrupt extends activity_1.Activity {
             }
         }
         catch (error) {
-            if (error instanceof errors_1.InactiveJobError) {
-                this.logger.error('interrupt-inactive-job-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.GenerationalError) {
-                this.logger.info('process-event-generational-job-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.GetStateError) {
-                this.logger.error('interrupt-get-state-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.CollationError) {
-                if (error.fault === 'duplicate') {
-                    this.logger.info('interrupt-collation-overage', {
-                        job_id: this.context.metadata.jid,
-                        guid: this.context.metadata.guid,
-                    });
-                    return;
-                }
-                //unknown collation error
-                this.logger.error('interrupt-collation-error', { error });
-            }
-            else {
-                this.logger.error('interrupt-process-error', { error });
-            }
-            telemetry?.setActivityError(error.message);
-            throw error;
+            this.handleProcessError(error, telemetry, 'interrupt');
+            return;
         }
         finally {
             telemetry?.endActivitySpan();
@@ -189,7 +158,6 @@ class Interrupt extends activity_1.Activity {
         if (this.config.job?.maps) {
             this.mapJobData();
         }
-        // Bundle state + Leg1 completion + semaphore in one transaction
         telemetry.mapActivityAttributes();
         const transaction = this.store.transact();
         if (this.config.job?.maps) {
@@ -199,7 +167,7 @@ class Interrupt extends activity_1.Activity {
         await this.setStatus(-1, transaction);
         const txResponse = (await transaction.exec());
         const jobStatus = this.resolveStatus(txResponse);
-        // Interrupt fires AFTER proof commits (best-effort)
+        //interrupt fires AFTER proof commits (best-effort)
         const messageId = await this.interrupt();
         telemetry.setActivityAttributes({
             'app.activity.mid': messageId,
@@ -208,15 +176,13 @@ class Interrupt extends activity_1.Activity {
         return this.context.metadata.aid;
     }
     async interruptAnother(telemetry) {
-        // Interrupt ANOTHER job (best-effort, fires before step protocol)
+        //interrupt ANOTHER job (best-effort, fires before step protocol)
         await this.interrupt();
-        // Apply updates to THIS job's state
         this.adjacencyList = await this.filterAdjacent();
         if (this.config.job?.maps || this.config.output?.maps) {
             this.mapOutputData();
             this.mapJobData();
         }
-        //Category B: use Leg1 step protocol for crash-safe edge capture
         await this.executeLeg1StepProtocol(this.adjacencyList.length - 1);
         telemetry.mapActivityAttributes();
         telemetry.setActivityAttributes({});

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

@@ -1,6 +1,4 @@
-import { EngineService } from '../engine';
-import { ActivityData, ActivityMetadata, ActivityType, SignalActivity } from '../../types/activity';
-import { JobState } from '../../types/job';
+import { SignalActivity } from '../../types/activity';
 import { ProviderTransaction } from '../../types/provider';
 import { Activity } from './activity';
 /**
@@ -110,18 +108,10 @@ import { Activity } from './activity';
  */
 declare class Signal extends Activity {
     config: SignalActivity;
-    constructor(config: ActivityType, data: ActivityData, metadata: ActivityMetadata, hook: ActivityData | null, engine: EngineService, context?: JobState);
     process(): Promise<string>;
     mapSignalData(): Record<string, any>;
     mapResolverData(): Record<string, any>;
-    /**
-     * The signal activity will hook one. Accepts an optional transaction
-     * so the hook publish can be bundled with the Leg1 completion marker.
-     */
     signalOne(transaction?: ProviderTransaction): Promise<string>;
-    /**
-     * Signals all paused jobs that share the same job key, resuming their execution.
-     */
     signalAll(): Promise<string[]>;
 }
 export { Signal };

package/build/services/activities/signal.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Signal = void 0;
-const errors_1 = require("../../modules/errors");
 const collator_1 = require("../collator");
 const mapper_1 = require("../mapper");
 const pipe_1 = require("../pipe");
@@ -113,10 +112,6 @@ const activity_1 = require("./activity");
  * @see {@link SignalActivity} for the TypeScript interface
  */
 class Signal extends activity_1.Activity {
-    constructor(config, data, metadata, hook, engine, context) {
-        super(config, data, metadata, hook, engine, context);
-    }
-    //********  LEG 1 ENTRY  ********//
     async process() {
         this.logger.debug('signal-process', {
             jid: this.context.metadata.jid,
@@ -125,7 +120,6 @@ class Signal extends activity_1.Activity {
         });
         let telemetry;
         try {
-            //Category B: entry with step resume
             await this.verifyLeg1Entry();
             telemetry = new telemetry_1.TelemetryService(this.engine.appId, this.config, this.metadata, this.context);
             telemetry.startActivitySpan(this.leg);
@@ -133,7 +127,7 @@ class Signal extends activity_1.Activity {
             this.mapOutputData();
             this.mapJobData();
             //Step A: Bundle signal hook with Leg1 completion marker.
-            //hookOne is transactional; hookAll is best-effort (complex multi-step).
+            //signalOne is transactional; signalAll is best-effort.
             if (!collator_1.CollatorService.isGuidStep1Done(this.guidLedger)) {
                 const txn1 = this.store.transact();
                 if (this.config.subtype === 'all') {
@@ -148,7 +142,6 @@ class Signal extends activity_1.Activity {
                 }
                 await collator_1.CollatorService.notarizeStep1(this, this.context.metadata.guid, txn1);
                 await txn1.exec();
-                //update in-memory guidLedger so executeLeg1StepProtocol skips Step A
                 this.guidLedger += collator_1.CollatorService.WEIGHTS.STEP1_WORK;
             }
             //Steps B and C: spawn children + semaphore + edge capture
@@ -158,34 +151,8 @@ class Signal extends activity_1.Activity {
             return this.context.metadata.aid;
         }
         catch (error) {
-            if (error instanceof errors_1.InactiveJobError) {
-                this.logger.error('signal-inactive-job-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.GenerationalError) {
-                this.logger.info('process-event-generational-job-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.GetStateError) {
-                this.logger.error('signal-get-state-error', { error });
-                return;
-            }
-            else if (error instanceof errors_1.CollationError) {
-                if (error.fault === 'duplicate') {
-                    this.logger.info('signal-collation-overage', {
-                        job_id: this.context.metadata.jid,
-                        guid: this.context.metadata.guid,
-                    });
-                    return;
-                }
-                //unknown collation error
-                this.logger.error('signal-collation-error', { error });
-            }
-            else {
-                this.logger.error('signal-process-error', { error });
-            }
-            telemetry?.setActivityError(error.message);
-            throw error;
+            this.handleProcessError(error, telemetry, 'signal');
+            return;
         }
         finally {
             telemetry?.endActivitySpan();
@@ -208,10 +175,6 @@ class Signal extends activity_1.Activity {
             return mapper.mapRules();
         }
     }
-    /**
-     * The signal activity will hook one. Accepts an optional transaction
-     * so the hook publish can be bundled with the Leg1 completion marker.
-     */
     async signalOne(transaction) {
         const topic = pipe_1.Pipe.resolve(this.config.topic, this.context);
         const signalInputData = this.mapSignalData();
@@ -219,23 +182,15 @@ class Signal extends activity_1.Activity {
         const code = pipe_1.Pipe.resolve(this.config.code, this.context);
         return await this.engine.signal(topic, signalInputData, status, code, transaction);
     }
-    /**
-     * Signals all paused jobs that share the same job key, resuming their execution.
-     */
     async signalAll() {
-        //prep 1) generate `input signal data` (essentially the webhook payload)
         const signalInputData = this.mapSignalData();
-        //prep 2) generate data that resolves the job key (per the YAML config)
         const keyResolverData = this.mapResolverData();
         if (this.config.scrub) {
-            //self-clean the indexes upon use if configured
             keyResolverData.scrub = true;
         }
-        //prep 3) jobKeys can contain multiple indexes (per the YAML config)
         const key_name = pipe_1.Pipe.resolve(this.config.key_name, this.context);
         const key_value = pipe_1.Pipe.resolve(this.config.key_value, this.context);
         const indexQueryFacets = [`${key_name}:${key_value}`];
-        //execute: `signalAll` will now resume all paused jobs that share the same job key
         return await this.engine.signalAll(this.config.topic, signalInputData, keyResolverData, indexQueryFacets);
     }
 }

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

@@ -1,5 +1,4 @@
-import { EngineService } from '../engine';
-import { ActivityData, ActivityMetadata, ActivityType, TriggerActivity } from '../../types/activity';
+import { TriggerActivity } from '../../types/activity';
 import { JobState, ExtensionType } from '../../types/job';
 import { ProviderTransaction } from '../../types/provider';
 import { Activity } from './activity';
@@ -60,7 +59,6 @@ import { Activity } from './activity';
  */
 declare class Trigger extends Activity {
     config: TriggerActivity;
-    constructor(config: ActivityType, data: ActivityData, metadata: ActivityMetadata, hook: ActivityData | null, engine: EngineService, context?: JobState);
     process(options?: ExtensionType): Promise<string>;
     /**
      * `pending` flows will not transition from the trigger to adjacent children until resumed

package/build/services/activities/trigger.js

@@ -66,9 +66,6 @@ const activity_1 = require("./activity");
  * @see {@link TriggerActivity} for the TypeScript interface
  */
 class Trigger extends activity_1.Activity {
-    constructor(config, data, metadata, hook, engine, context) {
-        super(config, data, metadata, hook, engine, context);
-    }
     async process(options) {
         this.logger.debug('trigger-process', {
             subscribes: this.config.subscribes,

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

@@ -1,6 +1,4 @@
-import { EngineService } from '../engine';
-import { ActivityData, ActivityMetadata, ActivityType, WorkerActivity } from '../../types/activity';
-import { JobState } from '../../types/job';
+import { WorkerActivity } from '../../types/activity';
 import { ProviderTransaction } from '../../types/provider';
 import { Activity } from './activity';
 /**
@@ -70,7 +68,7 @@ import { Activity } from './activity';
  * ## Retry Policy
  *
  * Retry behavior is configured at the **worker level** (not in YAML) via
- * the `retryPolicy` option. Failed callbacks are retried with exponential
+ * the `retry` option. Failed callbacks are retried with exponential
  * backoff until `maximumAttempts` is exhausted. The `maximumInterval` caps
  * the delay between retries.
  *
@@ -81,7 +79,7 @@ import { Activity } from './activity';
  *   workers: [{
  *     topic: 'work.backoff',
  *     connection,
- *     retryPolicy: {
+ *     retry: {
  *       maximumAttempts: 5,          // retry up to 5 times
  *       backoffCoefficient: 2,       // exponential: 2^0, 2^1, 2^2, ... seconds
  *       maximumInterval: '30s',      // cap delay at 30 seconds
@@ -112,7 +110,6 @@ import { Activity } from './activity';
  */
 declare class Worker extends Activity {
     config: WorkerActivity;
-    constructor(config: ActivityType, data: ActivityData, metadata: ActivityMetadata, hook: ActivityData | null, engine: EngineService, context?: JobState);
     process(): Promise<string>;
     execActivity(transaction: ProviderTransaction): Promise<string>;
 }