@hotmeshio/hotmesh 0.8.0 → 0.10.0

package/build/modules/errors.d.ts

@@ -1,6 +1,6 @@
 import { ActivityDuplex } from '../types/activity';
 import { CollationFaultType, CollationStage } from '../types/collator';
-import { MemFlowChildErrorType, MemFlowProxyErrorType, MemFlowSleepErrorType, MemFlowWaitForAllErrorType, MemFlowWaitForErrorType } from '../types/error';
+import { DurableChildErrorType, DurableProxyErrorType, DurableSleepErrorType, DurableWaitForAllErrorType, DurableWaitForErrorType } from '../types/error';
 declare class GetStateError extends Error {
     jobId: string;
     code: number;
@@ -9,16 +9,16 @@ declare class GetStateError extends Error {
 declare class SetStateError extends Error {
     constructor();
 }
-declare class MemFlowWaitForError extends Error {
+declare class DurableWaitForError extends Error {
     code: number;
     signalId: string;
     workflowId: string;
     index: number;
     workflowDimension: string;
     type: string;
-    constructor(params: MemFlowWaitForErrorType);
+    constructor(params: DurableWaitForErrorType);
 }
-declare class MemFlowProxyError extends Error {
+declare class DurableProxyError extends Error {
     activityName: string;
     arguments: string[];
     backoffCoefficient: number;
@@ -33,9 +33,9 @@ declare class MemFlowProxyError extends Error {
     workflowId: string;
     workflowTopic: string;
     type: string;
-    constructor(params: MemFlowProxyErrorType);
+    constructor(params: DurableProxyErrorType);
 }
-declare class MemFlowChildError extends Error {
+declare class DurableChildError extends Error {
     await: boolean;
     entity: string;
     arguments: string[];
@@ -53,9 +53,9 @@ declare class MemFlowChildError extends Error {
     workflowId: string;
     workflowTopic: string;
     type: string;
-    constructor(params: MemFlowChildErrorType);
+    constructor(params: DurableChildErrorType);
 }
-declare class MemFlowWaitForAllError extends Error {
+declare class DurableWaitForAllError extends Error {
     items: any[];
     code: number;
     workflowDimension: string;
@@ -66,33 +66,33 @@ declare class MemFlowWaitForAllError extends Error {
     workflowId: string;
     workflowTopic: string;
     type: string;
-    constructor(params: MemFlowWaitForAllErrorType);
+    constructor(params: DurableWaitForAllErrorType);
 }
-declare class MemFlowSleepError extends Error {
+declare class DurableSleepError extends Error {
     workflowId: string;
     code: number;
     duration: number;
     index: number;
     workflowDimension: string;
     type: string;
-    constructor(params: MemFlowSleepErrorType);
+    constructor(params: DurableSleepErrorType);
 }
-declare class MemFlowTimeoutError extends Error {
+declare class DurableTimeoutError extends Error {
     code: number;
     type: string;
     constructor(message: string, stack?: string);
 }
-declare class MemFlowMaxedError extends Error {
+declare class DurableMaxedError extends Error {
     code: number;
     type: string;
     constructor(message: string, stackTrace?: string);
 }
-declare class MemFlowFatalError extends Error {
+declare class DurableFatalError extends Error {
     code: number;
     type: string;
     constructor(message: string, stackTrace?: string);
 }
-declare class MemFlowRetryError extends Error {
+declare class DurableRetryError extends Error {
     code: number;
     type: string;
     constructor(message: string, stackTrace?: string);
@@ -131,4 +131,4 @@ declare class CollationError extends Error {
     fault: CollationFaultType;
     constructor(status: number, leg: ActivityDuplex, stage: CollationStage, fault?: CollationFaultType);
 }
-export { CollationError, MemFlowChildError, MemFlowFatalError, MemFlowMaxedError, MemFlowProxyError, MemFlowRetryError, MemFlowSleepError, MemFlowTimeoutError, MemFlowWaitForAllError, MemFlowWaitForError, DuplicateJobError, ExecActivityError, GenerationalError, GetStateError, InactiveJobError, MapDataError, RegisterTimeoutError, SetStateError, };
+export { CollationError, DurableChildError, DurableFatalError, DurableMaxedError, DurableProxyError, DurableRetryError, DurableSleepError, DurableTimeoutError, DurableWaitForAllError, DurableWaitForError, DuplicateJobError, ExecActivityError, GenerationalError, GetStateError, InactiveJobError, MapDataError, RegisterTimeoutError, SetStateError, };

package/build/modules/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SetStateError = exports.RegisterTimeoutError = exports.MapDataError = exports.InactiveJobError = exports.GetStateError = exports.GenerationalError = exports.ExecActivityError = exports.DuplicateJobError = exports.MemFlowWaitForError = exports.MemFlowWaitForAllError = exports.MemFlowTimeoutError = exports.MemFlowSleepError = exports.MemFlowRetryError = exports.MemFlowProxyError = exports.MemFlowMaxedError = exports.MemFlowFatalError = exports.MemFlowChildError = exports.CollationError = void 0;
+exports.SetStateError = exports.RegisterTimeoutError = exports.MapDataError = exports.InactiveJobError = exports.GetStateError = exports.GenerationalError = exports.ExecActivityError = exports.DuplicateJobError = exports.DurableWaitForError = exports.DurableWaitForAllError = exports.DurableTimeoutError = exports.DurableSleepError = exports.DurableRetryError = exports.DurableProxyError = exports.DurableMaxedError = exports.DurableFatalError = exports.DurableChildError = exports.CollationError = void 0;
 const enums_1 = require("./enums");
 class GetStateError extends Error {
     constructor(jobId) {
@@ -16,21 +16,21 @@ class SetStateError extends Error {
     }
 }
 exports.SetStateError = SetStateError;
-class MemFlowWaitForError extends Error {
+class DurableWaitForError extends Error {
     constructor(params) {
         super(`WaitFor Interruption`);
-        this.type = 'MemFlowWaitForError';
+        this.type = 'DurableWaitForError';
         this.signalId = params.signalId;
         this.index = params.index;
         this.workflowDimension = params.workflowDimension;
-        this.code = enums_1.HMSH_CODE_MEMFLOW_WAIT;
+        this.code = enums_1.HMSH_CODE_DURABLE_WAIT;
     }
 }
-exports.MemFlowWaitForError = MemFlowWaitForError;
-class MemFlowProxyError extends Error {
+exports.DurableWaitForError = DurableWaitForError;
+class DurableProxyError extends Error {
     constructor(params) {
         super(`ProxyActivity Interruption`);
-        this.type = 'MemFlowProxyError';
+        this.type = 'DurableProxyError';
         this.arguments = params.arguments;
         this.workflowId = params.workflowId;
         this.workflowTopic = params.workflowTopic;
@@ -43,14 +43,14 @@ class MemFlowProxyError extends Error {
         this.backoffCoefficient = params.backoffCoefficient;
         this.maximumAttempts = params.maximumAttempts;
         this.maximumInterval = params.maximumInterval;
-        this.code = enums_1.HMSH_CODE_MEMFLOW_PROXY;
+        this.code = enums_1.HMSH_CODE_DURABLE_PROXY;
     }
 }
-exports.MemFlowProxyError = MemFlowProxyError;
-class MemFlowChildError extends Error {
+exports.DurableProxyError = DurableProxyError;
+class DurableChildError extends Error {
     constructor(params) {
         super(`ExecChild Interruption`);
-        this.type = 'MemFlowChildError';
+        this.type = 'DurableChildError';
         this.arguments = params.arguments;
         this.workflowId = params.workflowId;
         this.workflowTopic = params.workflowTopic;
@@ -62,18 +62,18 @@ class MemFlowChildError extends Error {
         this.entity = params.entity;
         this.index = params.index;
         this.workflowDimension = params.workflowDimension;
-        this.code = enums_1.HMSH_CODE_MEMFLOW_CHILD;
+        this.code = enums_1.HMSH_CODE_DURABLE_CHILD;
         this.await = params.await;
         this.backoffCoefficient = params.backoffCoefficient;
         this.maximumAttempts = params.maximumAttempts;
         this.maximumInterval = params.maximumInterval;
     }
 }
-exports.MemFlowChildError = MemFlowChildError;
-class MemFlowWaitForAllError extends Error {
+exports.DurableChildError = DurableChildError;
+class DurableWaitForAllError extends Error {
     constructor(params) {
         super(`Collation Interruption`);
-        this.type = 'MemFlowWaitForAllError';
+        this.type = 'DurableWaitForAllError';
         this.items = params.items;
         this.size = params.size;
         this.workflowId = params.workflowId;
@@ -82,66 +82,66 @@ class MemFlowWaitForAllError extends Error {
         this.originJobId = params.originJobId;
         this.index = params.index;
         this.workflowDimension = params.workflowDimension;
-        this.code = enums_1.HMSH_CODE_MEMFLOW_ALL;
+        this.code = enums_1.HMSH_CODE_DURABLE_ALL;
     }
 }
-exports.MemFlowWaitForAllError = MemFlowWaitForAllError;
-class MemFlowSleepError extends Error {
+exports.DurableWaitForAllError = DurableWaitForAllError;
+class DurableSleepError extends Error {
     constructor(params) {
         super(`SleepFor Interruption`);
-        this.type = 'MemFlowSleepError';
+        this.type = 'DurableSleepError';
         this.duration = params.duration;
         this.workflowId = params.workflowId;
         this.index = params.index;
         this.workflowDimension = params.workflowDimension;
-        this.code = enums_1.HMSH_CODE_MEMFLOW_SLEEP;
+        this.code = enums_1.HMSH_CODE_DURABLE_SLEEP;
     }
 }
-exports.MemFlowSleepError = MemFlowSleepError;
-class MemFlowTimeoutError extends Error {
+exports.DurableSleepError = DurableSleepError;
+class DurableTimeoutError extends Error {
     constructor(message, stack) {
         super(message);
-        this.type = 'MemFlowTimeoutError';
+        this.type = 'DurableTimeoutError';
         if (this.stack) {
             this.stack = stack;
         }
-        this.code = enums_1.HMSH_CODE_MEMFLOW_TIMEOUT;
+        this.code = enums_1.HMSH_CODE_DURABLE_TIMEOUT;
     }
 }
-exports.MemFlowTimeoutError = MemFlowTimeoutError;
-class MemFlowMaxedError extends Error {
+exports.DurableTimeoutError = DurableTimeoutError;
+class DurableMaxedError extends Error {
     constructor(message, stackTrace) {
         super(message);
-        this.type = 'MemFlowMaxedError';
+        this.type = 'DurableMaxedError';
         if (stackTrace) {
             this.stack = stackTrace;
         }
-        this.code = enums_1.HMSH_CODE_MEMFLOW_MAXED;
+        this.code = enums_1.HMSH_CODE_DURABLE_MAXED;
     }
 }
-exports.MemFlowMaxedError = MemFlowMaxedError;
-class MemFlowFatalError extends Error {
+exports.DurableMaxedError = DurableMaxedError;
+class DurableFatalError extends Error {
     constructor(message, stackTrace) {
         super(message);
-        this.type = 'MemFlowFatalError';
+        this.type = 'DurableFatalError';
         if (stackTrace) {
             this.stack = stackTrace;
         }
-        this.code = enums_1.HMSH_CODE_MEMFLOW_FATAL;
+        this.code = enums_1.HMSH_CODE_DURABLE_FATAL;
     }
 }
-exports.MemFlowFatalError = MemFlowFatalError;
-class MemFlowRetryError extends Error {
+exports.DurableFatalError = DurableFatalError;
+class DurableRetryError extends Error {
     constructor(message, stackTrace) {
         super(message);
-        this.type = 'MemFlowRetryError';
+        this.type = 'DurableRetryError';
         if (stackTrace) {
             this.stack = stackTrace;
         }
-        this.code = enums_1.HMSH_CODE_MEMFLOW_RETRYABLE;
+        this.code = enums_1.HMSH_CODE_DURABLE_RETRYABLE;
     }
 }
-exports.MemFlowRetryError = MemFlowRetryError;
+exports.DurableRetryError = DurableRetryError;
 class MapDataError extends Error {
     constructor() {
         super('Error occurred while mapping data');

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hotmeshio/hotmesh",
-    "version": "0.8.0",
+    "version": "0.10.0",
     "description": "Permanent-Memory Workflows & AI Agents",
     "main": "./build/index.js",
     "types": "./build/index.d.ts",
@@ -19,72 +19,70 @@
         "lint": "eslint . --ext .ts",
         "lint:fix": "eslint . --fix --ext .ts",
         "start": "ts-node src/index.ts",
-        "test": "NODE_ENV=test jest --detectOpenHandles --forceExit --verbose",
-        "test:await": "NODE_ENV=test jest ./tests/functional/awaiter/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:compile": "NODE_ENV=test jest ./tests/functional/compile/index.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:connect": "NODE_ENV=test jest ./tests/unit/services/connector/* --detectOpenHandles --forceExit --verbose",
-        "test:connect:postgres": "NODE_ENV=test jest ./tests/unit/services/connector/providers/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:connect:nats": "NODE_ENV=test jest ./tests/unit/services/connector/providers/nats.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow": "NODE_ENV=test jest ./tests/memflow/*/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:postgres": "HMSH_LOGLEVEL=info NODE_ENV=test jest ./tests/memflow/*/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:basic": "HMSH_LOGLEVEL=info NODE_ENV=test jest ./tests/memflow/basic/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:collision": "NODE_ENV=test jest ./tests/memflow/collision/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:fatal": "NODE_ENV=test jest ./tests/memflow/fatal/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:goodbye": "NODE_ENV=test HMSH_LOGLEVEL=debug jest ./tests/memflow/goodbye/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:interceptor": "NODE_ENV=test HMSH_LOGLEVEL=info jest ./tests/memflow/interceptor/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:entity": "NODE_ENV=test HMSH_LOGLEVEL=debug jest ./tests/memflow/entity/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:agent": "NODE_ENV=test HMSH_LOGLEVEL=debug jest ./tests/memflow/agent/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:hello": "HMSH_TELEMETRY=debug HMSH_LOGLEVEL=debug NODE_ENV=test jest ./tests/memflow/helloworld/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:hook": "NODE_ENV=test jest ./tests/memflow/hook/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:interrupt": "NODE_ENV=test jest ./tests/memflow/interrupt/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:loopactivity": "NODE_ENV=test jest ./tests/memflow/loopactivity/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:nested": "NODE_ENV=test jest ./tests/memflow/nested/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:pipeline": "NODE_ENV=test jest ./tests/memflow/pipeline/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:retry": "NODE_ENV=test jest ./tests/memflow/retry/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:retrypolicy": "NODE_ENV=test jest ./tests/memflow/retry-policy/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:sleep": "NODE_ENV=test jest ./tests/memflow/sleep/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:signal": "NODE_ENV=test jest ./tests/memflow/signal/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:memflow:unknown": "NODE_ENV=test jest ./tests/memflow/unknown/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:cycle": "NODE_ENV=test jest ./tests/functional/cycle/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:functional": "NODE_ENV=test jest ./tests/functional/**/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:emit": "NODE_ENV=test jest ./tests/functional/emit/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:pending": "NODE_ENV=test jest ./tests/functional/pending/index.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:hmsh": "NODE_ENV=test jest ./tests/functional/postgres.test.ts --detectOpenHandles --verbose --forceExit",
-        "test:hook": "NODE_ENV=test jest ./tests/functional/hook/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:interrupt": "NODE_ENV=test jest ./tests/functional/interrupt/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:parallel": "NODE_ENV=test jest ./tests/functional/parallel/index.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:pipe": "NODE_ENV=test jest ./tests/unit/services/pipe/index.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:quorum": "NODE_ENV=test jest ./tests/functional/quorum/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:reclaim": "NODE_ENV=test jest ./tests/functional/reclaim/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:redeploy": "NODE_ENV=test jest ./tests/functional/redeploy/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:reporter": "NODE_ENV=test jest ./tests/unit/services/reporter/index.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:reentrant": "NODE_ENV=test jest ./tests/functional/reentrant/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:retry": "NODE_ENV=test jest ./tests/functional/retry/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:retrypolicy": "NODE_ENV=test jest ./tests/functional/retry-policy/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:sequence": "NODE_ENV=test HMSH_LOGLEVEL=info jest ./tests/functional/sequence/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:signal": "NODE_ENV=test jest ./tests/functional/signal/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:status": "NODE_ENV=test jest ./tests/functional/status/index.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:providers": "NODE_ENV=test jest ./tests/functional/*/providers/*/*.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:store:postgres": "NODE_ENV=test jest ./tests/functional/store/providers/postgres/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:stream:postgres": "NODE_ENV=test jest ./tests/functional/stream/providers/postgres/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:stream:nats": "NODE_ENV=test jest ./tests/functional/stream/providers/nats/nats.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:sub:postgres": "NODE_ENV=test jest ./tests/functional/sub/providers/postgres/postgres.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:sub:nats": "NODE_ENV=test jest ./tests/functional/sub/providers/nats/nats.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:trigger": "NODE_ENV=test jest ./tests/unit/services/activities/trigger.test.ts --detectOpenHandles --forceExit --verbose",
-        "test:meshcall": "NODE_ENV=test jest ./tests/meshcall/*.test.ts --forceExit --verbose --detectOpenHandles",
-        "test:unit": "NODE_ENV=test jest ./tests/unit/*/*/index.test.ts --detectOpenHandles --forceExit --verbose"
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:await": "vitest run tests/functional/awaiter/postgres.test.ts",
+        "test:compile": "vitest run tests/functional/compile/index.test.ts",
+        "test:connect": "vitest run tests/unit/services/connector",
+        "test:connect:postgres": "vitest run tests/unit/services/connector/providers/postgres.test.ts",
+        "test:connect:nats": "vitest run tests/unit/services/connector/providers/nats.test.ts",
+        "test:durable": "vitest run tests/durable",
+        "test:durable:postgres": "HMSH_LOGLEVEL=info vitest run tests/durable",
+        "test:durable:basic": "HMSH_LOGLEVEL=info vitest run tests/durable/basic/postgres.test.ts",
+        "test:durable:collision": "vitest run tests/durable/collision/postgres.test.ts",
+        "test:durable:fatal": "vitest run tests/durable/fatal",
+        "test:durable:goodbye": "HMSH_LOGLEVEL=debug vitest run tests/durable/goodbye/postgres.test.ts",
+        "test:durable:interceptor": "HMSH_LOGLEVEL=info vitest run tests/durable/interceptor/postgres.test.ts",
+        "test:durable:entity": "HMSH_LOGLEVEL=debug vitest run tests/durable/entity/postgres.test.ts",
+        "test:durable:agent": "HMSH_LOGLEVEL=debug vitest run tests/durable/agent/postgres.test.ts",
+        "test:durable:hello": "HMSH_TELEMETRY=debug HMSH_LOGLEVEL=info vitest run tests/durable/helloworld/postgres.test.ts",
+        "test:durable:hook": "vitest run tests/durable/hook/postgres.test.ts",
+        "test:durable:interrupt": "vitest run tests/durable/interrupt/postgres.test.ts",
+        "test:durable:loopactivity": "vitest run tests/durable/loopactivity/postgres.test.ts",
+        "test:durable:nested": "vitest run tests/durable/nested/postgres.test.ts",
+        "test:durable:pipeline": "vitest run tests/durable/pipeline/postgres.test.ts",
+        "test:durable:retry": "vitest run tests/durable/retry/postgres.test.ts",
+        "test:durable:retrypolicy": "vitest run tests/durable/retry-policy",
+        "test:durable:sleep": "vitest run tests/durable/sleep/postgres.test.ts",
+        "test:durable:signal": "vitest run tests/durable/signal/postgres.test.ts",
+        "test:durable:unknown": "vitest run tests/durable/unknown/postgres.test.ts",
+        "test:dba": "vitest run tests/dba",
+        "test:cycle": "vitest run tests/functional/cycle",
+        "test:functional": "vitest run tests/functional",
+        "test:emit": "vitest run tests/functional/emit",
+        "test:pending": "vitest run tests/functional/pending/index.test.ts",
+        "test:hmsh": "vitest run tests/functional/postgres.test.ts",
+        "test:hook": "vitest run tests/functional/hook/postgres.test.ts",
+        "test:interrupt": "vitest run tests/functional/interrupt/postgres.test.ts",
+        "test:parallel": "vitest run tests/functional/parallel/index.test.ts",
+        "test:pipe": "vitest run tests/unit/services/pipe/index.test.ts",
+        "test:quorum": "vitest run tests/functional/quorum/postgres.test.ts",
+        "test:reclaim": "vitest run tests/functional/reclaim/postgres.test.ts",
+        "test:redeploy": "vitest run tests/functional/redeploy/postgres.test.ts",
+        "test:reporter": "vitest run tests/unit/services/reporter/index.test.ts",
+        "test:reentrant": "vitest run tests/functional/reentrant/postgres.test.ts",
+        "test:retry": "vitest run tests/functional/retry/postgres.test.ts",
+        "test:retrypolicy": "vitest run tests/functional/retry-policy",
+        "test:sequence": "HMSH_LOGLEVEL=info vitest run tests/functional/sequence/postgres.test.ts",
+        "test:signal": "vitest run tests/functional/signal/postgres.test.ts",
+        "test:status": "vitest run tests/functional/status/index.test.ts",
+        "test:providers": "vitest run tests/functional/*/providers",
+        "test:store:postgres": "vitest run tests/functional/store/providers/postgres/postgres.test.ts",
+        "test:stream:postgres": "vitest run tests/functional/stream/providers/postgres/postgres.test.ts",
+        "test:stream:nats": "vitest run tests/functional/stream/providers/nats/nats.test.ts",
+        "test:sub:postgres": "vitest run tests/functional/sub/providers/postgres/postgres.test.ts",
+        "test:sub:nats": "vitest run tests/functional/sub/providers/nats/nats.test.ts",
+        "test:trigger": "vitest run tests/unit/services/activities/trigger.test.ts",
+        "test:virtual": "vitest run tests/virtual",
+        "test:unit": "vitest run tests/unit"
     },
     "keywords": [
         "Headless Orchestration",
-        "Persistent Workflow",
-        "Durable Workflow",
-        "Operational Data",
+        "Durable Workflows",
+        "Data in Motion",
         "Service Mesh",
         "HotMesh",
-        "Postgres",
-        "OLAP",
-        "OLTP",
-        "HTAP"
+        "Postgres"
     ],
     "author": "luke.birdeau@gmail.com",
     "license": "SEE LICENSE IN LICENSE",
@@ -99,8 +97,7 @@
         "winston": "^3.8.2"
     },
     "devDependencies": {
-        "@types/jest": "^29.5.0",
-        "@types/node": "^18.15.11",
+        "@types/node": "^20.19.33",
         "@types/pg": "^8.10.0",
         "@typescript-eslint/eslint-plugin": "^5.62.0",
         "@typescript-eslint/parser": "^5.62.0",
@@ -110,17 +107,16 @@
         "eslint-plugin-import": "^2.29.1",
         "eslint-plugin-prettier": "^5.1.3",
         "javascript-obfuscator": "^0.6.2",
-        "jest": "^29.5.0",
         "nats": "^2.28.0",
         "openai": "^5.9.0",
         "pg": "^8.10.0",
         "rimraf": "^4.4.1",
         "terser": "^5.37.0",
-        "ts-jest": "^29.0.5",
         "ts-node": "^10.9.1",
         "ts-node-dev": "^2.0.0",
         "typedoc": "^0.26.4",
-        "typescript": "^5.0.4"
+        "typescript": "^5.0.4",
+        "vitest": "^2.1.9"
     },
     "peerDependencies": {
         "nats": "^2.0.0",

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

@@ -7,13 +7,69 @@ import { JobState, JobStatus } from '../../types/job';
 import { StringAnyType } from '../../types/serializer';
 import { StreamCode, StreamData, StreamStatus } from '../../types/stream';
 /**
- * The base class for all activities
+ * Base class for all HotMesh activity types. Activities are the execution
+ * units within a YAML-defined workflow graph. Each activity represents a
+ * node in a Directed Acyclic Graph (DAG) that the engine orchestrates.
+ *
+ * ## Activity Categories
+ *
+ * Activities fall into three execution categories:
+ *
+ * - **Category A (Duplex)**: Two-phase activities with Leg 1 (dispatch) and
+ *   Leg 2 (response). Used by `Worker` and `Await`. Leg 1
+ *   publishes a message and waits; Leg 2 handles the response via
+ *   `processEvent` and transitions to adjacent activities.
+ *
+ * - **Category B (Leg1-only with children)**: Single-phase activities that
+ *   execute work and transition to children using the crash-safe
+ *   `executeLeg1StepProtocol`. Used by `Hook` (passthrough mode),
+ *   `Signal`, and `Interrupt` (target mode).
+ *
+ * - **Category C (Leg1-only, no children)**: Terminal activities that
+ *   execute without spawning children. Used by `Interrupt` (self mode).
+ *
+ * ## Shared YAML Configuration
+ *
+ * All activity types support these base properties in the YAML descriptor:
+ *
+ * | Property             | Type    | Description |
+ * |----------------------|---------|-------------|
+ * | `type`               | string  | Activity type: `trigger`, `worker`, `await`, `hook`, `signal`, `interrupt`, `cycle` |
+ * | `title`              | string  | Human-readable label for the activity |
+ * | `input.schema`       | object  | JSON Schema for input validation |
+ * | `input.maps`         | object  | Maps data from other activities into this activity's input |
+ * | `output.schema`      | object  | JSON Schema for output validation |
+ * | `output.maps`        | object  | Maps/transforms the activity's own output data |
+ * | `job.maps`           | object  | Maps activity data to the shared job state |
+ * | `emit`               | boolean | If `true`, emits a message to the graph's `publishes` topic |
+ * | `persist`            | boolean | If `true`, emits the job-completed event while keeping the job active |
+ * | `expire`             | number  | Seconds until the job expires after completion (`-1` = forever) |
+ * | `statusThreshold`    | number  | Custom semaphore threshold for Dynamic Activation Control |
+ * | `cycle`              | boolean | If `true`, leaves Leg 2 open so the activity can be re-entered |
+ *
+ * ## Data Mapping Syntax
+ *
+ * Mapping expressions use curly-brace references to bind data between
+ * activities and the shared job state:
+ *
+ * ```yaml
+ * input:
+ *   maps:
+ *     x: '{t1.output.data.fieldName}'      # reference another activity's output
+ *     y: '{$self.output.data.fieldName}'    # reference own output
+ *     z: '{$job.data.fieldName}'            # reference shared job state
+ *     s: '{$app.settings.configKey}'        # reference app-level settings
+ * ```
+ *
+ * @see {@link https://hotmeshio.github.io/sdk-typescript/docs/quickstart | Quick Start Guide}
+ * @see [Model Driven Development](https://hotmeshio.github.io/sdk-typescript/docs/model_driven_development)
  */
 declare class Activity {
     config: ActivityType;
     data: ActivityData;
     hook: ActivityData;
     metadata: ActivityMetadata;
+    /** @hidden */
     store: StoreService<ProviderClient, ProviderTransaction>;
     context: JobState;
     engine: EngineService;
@@ -95,7 +151,7 @@ declare class Activity {
     getTriggerConfig(): Promise<ActivityType>;
     getJobStatus(): null | number;
     setStatus(amount: number, transaction?: ProviderTransaction): Promise<void | any>;
-    authorizeEntry(state: StringAnyType): string[];
+    authorizeEntry(_state: StringAnyType): string[];
     bindDimensionalAddress(state: StringAnyType): void;
     setState(transaction?: ProviderTransaction): Promise<string>;
     bindJobMetadata(): void;
@@ -127,11 +183,6 @@ declare class Activity {
      * @private
      */
     shouldPersistJob(): boolean;
-    /**
-     * Transition method for Category C (Leg1-only, no children, no semaphore change)
-     * and Category D (Trigger) activities. NOT used by the Leg2 step protocol.
-     */
-    transition(adjacencyList: StreamData[], jobStatus: JobStatus): Promise<string[]>;
     /**
      * A job with a vale < -100_000_000 is considered interrupted,
      * as the interruption event decrements the job status by 1billion.