@hotmeshio/hotmesh 0.14.2 → 0.14.4

package/build/services/stream/registry.d.ts

@@ -23,6 +23,7 @@ declare class StreamConsumerRegistry {
     }, logger: ILogger, config?: {
         reclaimDelay?: number;
         reclaimCount?: number;
+        readonly?: boolean;
         retry?: any;
     }): Promise<void>;
     /**

package/build/services/stream/registry.js

@@ -29,6 +29,7 @@ class StreamConsumerRegistry {
                 topic: taskQueue,
                 reclaimDelay: config?.reclaimDelay,
                 reclaimCount: config?.reclaimCount,
+                readonly: config?.readonly || false,
                 throttle,
                 retry: config?.retry,
             }, stream, logger);
@@ -39,14 +40,17 @@ class StreamConsumerRegistry {
                 logger,
             };
             StreamConsumerRegistry.workerConsumers.set(key, entry);
-            // Create the dispatch callback that routes by workflow_name
-            const dispatchCallback = StreamConsumerRegistry.createWorkerDispatcher(key);
-            // Start consuming from the task queue stream
-            const streamKey = stream.mintKey(key_1.KeyType.STREAMS, {
-                appId,
-                topic: taskQueue,
-            });
-            router.consumeMessages(streamKey, 'WORKER', guid, dispatchCallback);
+            // Only start consuming if not readonly
+            if (!config?.readonly) {
+                // Create the dispatch callback that routes by workflow_name
+                const dispatchCallback = StreamConsumerRegistry.createWorkerDispatcher(key);
+                // Start consuming from the task queue stream
+                const streamKey = stream.mintKey(key_1.KeyType.STREAMS, {
+                    appId,
+                    topic: taskQueue,
+                });
+                router.consumeMessages(streamKey, 'WORKER', guid, dispatchCallback);
+            }
         }
         // Register the callback for this workflow name
         entry.callbacks.set(workflowName, callback);

package/build/services/worker/index.js

@@ -51,6 +51,7 @@ class WorkerService {
                     await registry_1.StreamConsumerRegistry.registerWorker(namespace, appId, guid, worker.topic, worker.workflowName, worker.callback, service.stream, service.store, logger, {
                         reclaimDelay: worker.reclaimDelay,
                         reclaimCount: worker.reclaimCount,
+                        readonly: worker.readonly,
                         retry: worker.retry,
                     });
                     // Still need a router for publishing responses back to engine
@@ -86,7 +87,7 @@ class WorkerService {
      * @private
      */
     async initStoreChannel(service, store) {
-        service.store = await factory_4.StoreServiceFactory.init(store, service.namespace, service.appId, service.logger);
+        service.store = await factory_4.StoreServiceFactory.init(store, service.namespace, service.appId, service.logger, service.guid, 'worker');
     }
     /**
      * @private
@@ -114,6 +115,7 @@ class WorkerService {
             reclaimDelay: worker.reclaimDelay,
             reclaimCount: worker.reclaimCount,
             throttle,
+            readonly: worker.readonly || false,
             retry: worker.retry,
         }, this.stream, logger);
     }

package/build/types/hotmesh.d.ts

@@ -284,6 +284,14 @@ type HotMeshWorker = {
         user: string;
         password: string;
     };
+    /**
+     * If true, the worker's router will not consume messages from the
+     * stream. The worker can still publish responses but will never
+     * dequeue or process messages. This is inherited from the
+     * connection's `readonly` flag by the Durable layer.
+     * @default false
+     */
+    readonly?: boolean;
 };
 type HotMeshConfig = {
     appId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotmeshio/hotmesh",
-  "version": "0.14.2",
+  "version": "0.14.4",
   "description": "Durable Workflow",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",
@@ -14,8 +14,8 @@
     "obfuscate": "ts-node scripts/obfuscate.ts",
     "clean-build": "npm run clean && npm run build",
     "clean-build-obfuscate": "npm run clean-build && npm run obfuscate",
-    "docs": "typedoc",
-    "docs:clean": "rimraf ./docs/hotmesh && typedoc",
+    "docs": "typedoc && cp -R docs/hotmesh/* docs/ && rm -rf docs/hotmesh",
+    "docs:clean": "rimraf ./docs/hotmesh && typedoc && cp -R docs/hotmesh/* docs/ && rm -rf docs/hotmesh",
     "lint": "eslint . --ext .ts",
     "lint:fix": "eslint . --fix --ext .ts",
     "start": "ts-node src/index.ts",
@@ -47,6 +47,7 @@
     "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:readonly": "docker compose --profile readonly up -d --build && docker compose exec hotmesh-readonly npx vitest run --config tests/durable/readonly/vitest.config.mts",
     "test:durable:unknown": "vitest run tests/durable/unknown/postgres.test.ts",
     "test:durable:exporter": "HMSH_LOGLEVEL=info vitest run tests/durable/exporter",
     "test:durable:exporter:debug": "EXPORT_DEBUG=1 HMSH_LOGLEVEL=error vitest run tests/durable/basic/postgres.test.ts",
@@ -85,6 +86,7 @@
     "test:unit": "vitest run tests/unit"
   },
   "keywords": [
+    "Invisible Infrastructure",
     "Headless Orchestration",
     "Durable Workflows",
     "Data in Motion",

package/vitest.config.mts

@@ -5,7 +5,7 @@ export default defineConfig({
     globals: true,
     environment: 'node',
     include: ['tests/**/*.test.ts'],
-    exclude: ['node_modules', 'build', 'config'],
+    exclude: ['node_modules', 'build', 'config', 'tests/durable/readonly/**'],
     testTimeout: 60_000,
     hookTimeout: 120_000,
     fileParallelism: false,