@hotmeshio/hotmesh 0.12.1 → 0.14.0

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

@@ -1,4 +1,4 @@
-import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, ActivityInterceptorContext } from '../../types/durable';
+import { WorkflowInboundCallsInterceptor, InterceptorRegistry, WorkflowOutboundCallsInterceptor, WorkflowOutboundCallsInterceptorContext, ActivityInboundCallsInterceptor } from '../../types/durable';
 /**
  * Service for managing workflow interceptors that wrap workflow execution
  * in an onion-like pattern. Each interceptor can perform actions before
@@ -44,7 +44,7 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  * });
  *
  * // Execute workflow through interceptor chain
- * const result = await service.executeChain(context, async () => {
+ * const result = await service.executeInboundChain(context, async () => {
  *   return await workflowFn();
  * });
  * ```
@@ -52,7 +52,7 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  * ## Durable Interceptors with Durable Functions
  *
  * Interceptors run within the workflow's async local storage context, which means
- * they can use Durable functions like `sleepFor`, `entity`, `proxyActivities`, etc.
+ * they can use Durable functions like `sleep`, `entity`, `proxyActivities`, etc.
  * These interceptors participate in the HotMesh interruption/replay pattern.
  *
  * @example
@@ -60,16 +60,16 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  * import { Durable } from '@hotmeshio/hotmesh';
  *
  * // Rate limiting interceptor that sleeps before execution
- * const rateLimitInterceptor: WorkflowInterceptor = {
+ * const rateLimitInterceptor: WorkflowInboundCallsInterceptor = {
  *   async execute(ctx, next) {
  *     try {
  *       // This sleep will cause an interruption on first execution
- *       await Durable.workflow.sleepFor('1 second');
+ *       await Durable.workflow.sleep('1 second');
  *
  *       const result = await next();
  *
  *       // Another sleep after workflow completes
- *       await Durable.workflow.sleepFor('500 milliseconds');
+ *       await Durable.workflow.sleep('500 milliseconds');
  *
  *       return result;
  *     } catch (err) {
@@ -85,7 +85,7 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  * };
  *
  * // Entity-based audit interceptor
- * const auditInterceptor: WorkflowInterceptor = {
+ * const auditInterceptor: WorkflowInboundCallsInterceptor = {
  *   async execute(ctx, next) {
  *     try {
  *       const entity = await Durable.workflow.entity();
@@ -126,8 +126,8 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  * };
  *
  * // Register interceptors
- * Durable.registerInterceptor(rateLimitInterceptor);
- * Durable.registerInterceptor(auditInterceptor);
+ * Durable.registerInboundInterceptor(rateLimitInterceptor);
+ * Durable.registerInboundInterceptor(auditInterceptor);
  * ```
  *
  * ## Execution Pattern with Interruptions
@@ -135,7 +135,7 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  * When interceptors use Durable functions, the workflow will execute multiple times
  * due to the interruption/replay pattern:
  *
- * 1. **First execution**: Interceptor calls `sleepFor` → throws `DurableSleepError` → workflow pauses
+ * 1. **First execution**: Interceptor calls `sleep` → throws `DurableSleepError` → workflow pauses
  * 2. **Second execution**: Interceptor sleep replays (skipped), workflow runs → proxy activity throws `DurableProxyError` → workflow pauses
  * 3. **Third execution**: All previous operations replay, interceptor sleep after workflow → throws `DurableSleepError` → workflow pauses
  * 4. **Fourth execution**: Everything replays successfully, workflow completes
@@ -145,7 +145,7 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  * @example
  * ```typescript
  * // Interceptor with complex Durable operations
- * const complexInterceptor: WorkflowInterceptor = {
+ * const complexInterceptor: WorkflowInboundCallsInterceptor = {
  *   async execute(ctx, next) {
  *     try {
  *       // Get persistent state
@@ -154,7 +154,7 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  *
  *       // Conditional durable operations
  *       if (!state.preProcessed) {
- *         await Durable.workflow.sleepFor('100 milliseconds');
+ *         await Durable.workflow.sleep('100 milliseconds');
  *         await entity.merge({ preProcessed: true });
  *       }
  *
@@ -163,7 +163,7 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  *
  *       // Post-processing with child workflow
  *       if (!state.postProcessed) {
- *         await Durable.workflow.execChild({
+ *         await Durable.workflow.executeChild({
  *           taskQueue: 'cleanup',
  *           workflowName: 'cleanupWorkflow',
  *           args: [result]
@@ -199,11 +199,11 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  * @example
  * ```typescript
  * import { Durable } from '@hotmeshio/hotmesh';
- * import type { ActivityInterceptor } from '@hotmeshio/hotmesh/types/durable';
+ * import type { WorkflowOutboundCallsInterceptor } from '@hotmeshio/hotmesh/types/durable';
  * import * as activities from './activities';
  *
  * // Activity interceptor that publishes results via a proxy activity
- * const publishResultInterceptor: ActivityInterceptor = {
+ * const publishResultInterceptor: WorkflowOutboundCallsInterceptor = {
  *   async execute(activityCtx, workflowCtx, next) {
  *     try {
  *       // BEFORE: inspect or modify the activity input
@@ -221,7 +221,7 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  *           publishToSNS: (topic: string, payload: any) => Promise<void>;
  *         }>({
  *           taskQueue: 'shared-notifications',
- *           retryPolicy: { maximumAttempts: 3, throwOnError: true },
+ *           retry: { maximumAttempts: 3, throwOnError: true },
  *         });
  *
  *         await publishToSNS('activity-results', {
@@ -240,7 +240,7 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  *   },
  * };
  *
- * Durable.registerActivityInterceptor(publishResultInterceptor);
+ * Durable.registerOutboundInterceptor(publishResultInterceptor);
  * ```
  *
  * ## Activity Interceptor Replay Pattern
@@ -256,8 +256,9 @@ import { WorkflowInterceptor, InterceptorRegistry, ActivityInterceptor, Activity
  *    its stored result → interceptor returns → workflow continues
  */
 export declare class InterceptorService implements InterceptorRegistry {
-    interceptors: WorkflowInterceptor[];
-    activityInterceptors: ActivityInterceptor[];
+    inbound: WorkflowInboundCallsInterceptor[];
+    outbound: WorkflowOutboundCallsInterceptor[];
+    activityInbound: ActivityInboundCallsInterceptor[];
     /**
      * Register a new workflow interceptor that will wrap workflow execution.
      * Interceptors are executed in the order they are registered, with the
@@ -279,7 +280,7 @@ export declare class InterceptorService implements InterceptorRegistry {
      * });
      * ```
      */
-    register(interceptor: WorkflowInterceptor): void;
+    registerInbound(interceptor: WorkflowInboundCallsInterceptor): void;
     /**
      * Execute the interceptor chain around the workflow function.
      * The chain is built in an onion pattern where each interceptor
@@ -292,7 +293,7 @@ export declare class InterceptorService implements InterceptorRegistry {
      * @example
      * ```typescript
      * // Execute workflow with timing
-     * const result = await service.executeChain(context, async () => {
+     * const result = await service.executeInboundChain(context, async () => {
      *   const start = Date.now();
      *   try {
      *     return await workflowFn();
@@ -302,7 +303,7 @@ export declare class InterceptorService implements InterceptorRegistry {
      * });
      * ```
      */
-    executeChain(ctx: Map<string, any>, fn: () => Promise<any>): Promise<any>;
+    executeInboundChain(ctx: Map<string, any>, fn: () => Promise<any>): Promise<any>;
     /**
      * Register a new activity interceptor that will wrap individual
      * proxied activity calls. Interceptors are executed in the order
@@ -310,28 +311,37 @@ export declare class InterceptorService implements InterceptorRegistry {
      *
      * @param interceptor The activity interceptor to register
      */
-    registerActivity(interceptor: ActivityInterceptor): void;
+    registerOutbound(interceptor: WorkflowOutboundCallsInterceptor): void;
     /**
      * Execute the activity interceptor chain around an activity invocation.
-     * Uses the same onion/reduceRight pattern as executeChain.
+     * Uses the same onion/reduceRight pattern as executeInboundChain.
      *
      * @param activityCtx - Metadata about the activity (name, args, options)
      * @param workflowCtx - The workflow context Map
      * @param fn - The core activity function (registers with interruptionRegistry, sleeps, throws)
      * @returns The result of the activity (from replay or after future execution)
      */
-    executeActivityChain(activityCtx: ActivityInterceptorContext, workflowCtx: Map<string, any>, fn: () => Promise<any>): Promise<any>;
+    executeOutboundChain(activityCtx: WorkflowOutboundCallsInterceptorContext, workflowCtx: Map<string, any>, fn: () => Promise<any>): Promise<any>;
     /**
-     * Clear all registered activity interceptors.
+     * Register an activity inbound interceptor that wraps the actual
+     * activity function execution on the activity worker side.
      */
-    clearActivity(): void;
+    registerActivityInbound(interceptor: ActivityInboundCallsInterceptor): void;
     /**
-     * Clear all registered interceptors (both workflow and activity).
-     *
-     * @example
-     * ```typescript
-     * service.clear();
-     * ```
+     * Execute the activity inbound interceptor chain around the actual
+     * activity function invocation on the worker.
+     */
+    executeActivityInboundChain(activityName: string, args: any[], fn: () => Promise<any>): Promise<any>;
+    /**
+     * Clear all registered outbound interceptors.
+     */
+    clearOutbound(): void;
+    /**
+     * Clear all registered activity inbound interceptors.
+     */
+    clearActivityInbound(): void;
+    /**
+     * Clear all registered interceptors.
      */
     clear(): void;
 }

package/build/services/durable/interceptor.js

@@ -46,7 +46,7 @@ exports.InterceptorService = void 0;
  * });
  *
  * // Execute workflow through interceptor chain
- * const result = await service.executeChain(context, async () => {
+ * const result = await service.executeInboundChain(context, async () => {
  *   return await workflowFn();
  * });
  * ```
@@ -54,7 +54,7 @@ exports.InterceptorService = void 0;
  * ## Durable Interceptors with Durable Functions
  *
  * Interceptors run within the workflow's async local storage context, which means
- * they can use Durable functions like `sleepFor`, `entity`, `proxyActivities`, etc.
+ * they can use Durable functions like `sleep`, `entity`, `proxyActivities`, etc.
  * These interceptors participate in the HotMesh interruption/replay pattern.
  *
  * @example
@@ -62,16 +62,16 @@ exports.InterceptorService = void 0;
  * import { Durable } from '@hotmeshio/hotmesh';
  *
  * // Rate limiting interceptor that sleeps before execution
- * const rateLimitInterceptor: WorkflowInterceptor = {
+ * const rateLimitInterceptor: WorkflowInboundCallsInterceptor = {
  *   async execute(ctx, next) {
  *     try {
  *       // This sleep will cause an interruption on first execution
- *       await Durable.workflow.sleepFor('1 second');
+ *       await Durable.workflow.sleep('1 second');
  *
  *       const result = await next();
  *
  *       // Another sleep after workflow completes
- *       await Durable.workflow.sleepFor('500 milliseconds');
+ *       await Durable.workflow.sleep('500 milliseconds');
  *
  *       return result;
  *     } catch (err) {
@@ -87,7 +87,7 @@ exports.InterceptorService = void 0;
  * };
  *
  * // Entity-based audit interceptor
- * const auditInterceptor: WorkflowInterceptor = {
+ * const auditInterceptor: WorkflowInboundCallsInterceptor = {
  *   async execute(ctx, next) {
  *     try {
  *       const entity = await Durable.workflow.entity();
@@ -128,8 +128,8 @@ exports.InterceptorService = void 0;
  * };
  *
  * // Register interceptors
- * Durable.registerInterceptor(rateLimitInterceptor);
- * Durable.registerInterceptor(auditInterceptor);
+ * Durable.registerInboundInterceptor(rateLimitInterceptor);
+ * Durable.registerInboundInterceptor(auditInterceptor);
  * ```
  *
  * ## Execution Pattern with Interruptions
@@ -137,7 +137,7 @@ exports.InterceptorService = void 0;
  * When interceptors use Durable functions, the workflow will execute multiple times
  * due to the interruption/replay pattern:
  *
- * 1. **First execution**: Interceptor calls `sleepFor` → throws `DurableSleepError` → workflow pauses
+ * 1. **First execution**: Interceptor calls `sleep` → throws `DurableSleepError` → workflow pauses
  * 2. **Second execution**: Interceptor sleep replays (skipped), workflow runs → proxy activity throws `DurableProxyError` → workflow pauses
  * 3. **Third execution**: All previous operations replay, interceptor sleep after workflow → throws `DurableSleepError` → workflow pauses
  * 4. **Fourth execution**: Everything replays successfully, workflow completes
@@ -147,7 +147,7 @@ exports.InterceptorService = void 0;
  * @example
  * ```typescript
  * // Interceptor with complex Durable operations
- * const complexInterceptor: WorkflowInterceptor = {
+ * const complexInterceptor: WorkflowInboundCallsInterceptor = {
  *   async execute(ctx, next) {
  *     try {
  *       // Get persistent state
@@ -156,7 +156,7 @@ exports.InterceptorService = void 0;
  *
  *       // Conditional durable operations
  *       if (!state.preProcessed) {
- *         await Durable.workflow.sleepFor('100 milliseconds');
+ *         await Durable.workflow.sleep('100 milliseconds');
  *         await entity.merge({ preProcessed: true });
  *       }
  *
@@ -165,7 +165,7 @@ exports.InterceptorService = void 0;
  *
  *       // Post-processing with child workflow
  *       if (!state.postProcessed) {
- *         await Durable.workflow.execChild({
+ *         await Durable.workflow.executeChild({
  *           taskQueue: 'cleanup',
  *           workflowName: 'cleanupWorkflow',
  *           args: [result]
@@ -201,11 +201,11 @@ exports.InterceptorService = void 0;
  * @example
  * ```typescript
  * import { Durable } from '@hotmeshio/hotmesh';
- * import type { ActivityInterceptor } from '@hotmeshio/hotmesh/types/durable';
+ * import type { WorkflowOutboundCallsInterceptor } from '@hotmeshio/hotmesh/types/durable';
  * import * as activities from './activities';
  *
  * // Activity interceptor that publishes results via a proxy activity
- * const publishResultInterceptor: ActivityInterceptor = {
+ * const publishResultInterceptor: WorkflowOutboundCallsInterceptor = {
  *   async execute(activityCtx, workflowCtx, next) {
  *     try {
  *       // BEFORE: inspect or modify the activity input
@@ -223,7 +223,7 @@ exports.InterceptorService = void 0;
  *           publishToSNS: (topic: string, payload: any) => Promise<void>;
  *         }>({
  *           taskQueue: 'shared-notifications',
- *           retryPolicy: { maximumAttempts: 3, throwOnError: true },
+ *           retry: { maximumAttempts: 3, throwOnError: true },
  *         });
  *
  *         await publishToSNS('activity-results', {
@@ -242,7 +242,7 @@ exports.InterceptorService = void 0;
  *   },
  * };
  *
- * Durable.registerActivityInterceptor(publishResultInterceptor);
+ * Durable.registerOutboundInterceptor(publishResultInterceptor);
  * ```
  *
  * ## Activity Interceptor Replay Pattern
@@ -259,8 +259,9 @@ exports.InterceptorService = void 0;
  */
 class InterceptorService {
     constructor() {
-        this.interceptors = [];
-        this.activityInterceptors = [];
+        this.inbound = [];
+        this.outbound = [];
+        this.activityInbound = [];
     }
     /**
      * Register a new workflow interceptor that will wrap workflow execution.
@@ -283,8 +284,8 @@ class InterceptorService {
      * });
      * ```
      */
-    register(interceptor) {
-        this.interceptors.push(interceptor);
+    registerInbound(interceptor) {
+        this.inbound.push(interceptor);
     }
     /**
      * Execute the interceptor chain around the workflow function.
@@ -298,7 +299,7 @@ class InterceptorService {
      * @example
      * ```typescript
      * // Execute workflow with timing
-     * const result = await service.executeChain(context, async () => {
+     * const result = await service.executeInboundChain(context, async () => {
      *   const start = Date.now();
      *   try {
      *     return await workflowFn();
@@ -308,9 +309,9 @@ class InterceptorService {
      * });
      * ```
      */
-    async executeChain(ctx, fn) {
+    async executeInboundChain(ctx, fn) {
         // Create the onion-like chain of interceptors
-        const chain = this.interceptors.reduceRight((next, interceptor) => {
+        const chain = this.inbound.reduceRight((next, interceptor) => {
             return () => interceptor.execute(ctx, next);
         }, fn);
         return chain();
@@ -322,41 +323,60 @@ class InterceptorService {
      *
      * @param interceptor The activity interceptor to register
      */
-    registerActivity(interceptor) {
-        this.activityInterceptors.push(interceptor);
+    registerOutbound(interceptor) {
+        this.outbound.push(interceptor);
     }
     /**
      * Execute the activity interceptor chain around an activity invocation.
-     * Uses the same onion/reduceRight pattern as executeChain.
+     * Uses the same onion/reduceRight pattern as executeInboundChain.
      *
      * @param activityCtx - Metadata about the activity (name, args, options)
      * @param workflowCtx - The workflow context Map
      * @param fn - The core activity function (registers with interruptionRegistry, sleeps, throws)
      * @returns The result of the activity (from replay or after future execution)
      */
-    async executeActivityChain(activityCtx, workflowCtx, fn) {
-        const chain = this.activityInterceptors.reduceRight((next, interceptor) => {
+    async executeOutboundChain(activityCtx, workflowCtx, fn) {
+        const chain = this.outbound.reduceRight((next, interceptor) => {
             return () => interceptor.execute(activityCtx, workflowCtx, next);
         }, fn);
         return chain();
     }
     /**
-     * Clear all registered activity interceptors.
+     * Register an activity inbound interceptor that wraps the actual
+     * activity function execution on the activity worker side.
      */
-    clearActivity() {
-        this.activityInterceptors = [];
+    registerActivityInbound(interceptor) {
+        this.activityInbound.push(interceptor);
     }
     /**
-     * Clear all registered interceptors (both workflow and activity).
-     *
-     * @example
-     * ```typescript
-     * service.clear();
-     * ```
+     * Execute the activity inbound interceptor chain around the actual
+     * activity function invocation on the worker.
+     */
+    async executeActivityInboundChain(activityName, args, fn) {
+        const chain = this.activityInbound.reduceRight((next, interceptor) => {
+            return () => interceptor.execute(activityName, args, next);
+        }, fn);
+        return chain();
+    }
+    /**
+     * Clear all registered outbound interceptors.
+     */
+    clearOutbound() {
+        this.outbound = [];
+    }
+    /**
+     * Clear all registered activity inbound interceptors.
+     */
+    clearActivityInbound() {
+        this.activityInbound = [];
+    }
+    /**
+     * Clear all registered interceptors.
      */
     clear() {
-        this.interceptors = [];
-        this.activityInterceptors = [];
+        this.inbound = [];
+        this.outbound = [];
+        this.activityInbound = [];
     }
 }
 exports.InterceptorService = InterceptorService;

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

@@ -2,8 +2,7 @@
  *********** HOTMESH 'DURABLE' MODULE APPLICATION GRAPH **********
  *
  * This HotMesh application spec uses 50 activities and 25 transitions
- * to model and emulate the Temporal Application & Query servers using
- * a pluggable backend.
+ * to model a durable workflow engine using a pluggable backend.
  *
  * This YAML file can also serve as a useful starting point for building
  * Integration/BPM/Workflow servers in general (MuleSoft, etc) without the need
@@ -17,7 +16,7 @@
  * * Service Meshes
  * * Master Data Management systems
  */
-declare const APP_VERSION = "8";
+declare const APP_VERSION = "11";
 declare const APP_ID = "durable";
 /**
  * returns a new durable workflow schema