@zintrust/workers 0.1.27 → 0.1.29

package/dist/PriorityQueue.js

@@ -3,8 +3,7 @@
  * BullMQ priority levels with datacenter affinity
  * Sealed namespace for immutability
  */
-import { ErrorFactory, Logger } from '@zintrust/core';
-import { BullMQRedisQueue } from '@zintrust/queue-redis';
+import { ErrorFactory, Logger, NodeSingletons } from '@zintrust/core';
 // Priority mappings
 const PRIORITY_VALUES = {
     critical: 10,
@@ -12,11 +11,33 @@ const PRIORITY_VALUES = {
     normal: 1,
     low: 0,
 };
+const require = NodeSingletons.module.createRequire(import.meta.url);
+let queueRedisModule;
+let hasWarnedMissingQueueRedis = false;
+const loadQueueRedisModule = () => {
+    if (queueRedisModule)
+        return queueRedisModule;
+    try {
+        queueRedisModule = require('@zintrust/queue-redis');
+        return queueRedisModule;
+    }
+    catch (error) {
+        if (!hasWarnedMissingQueueRedis) {
+            hasWarnedMissingQueueRedis = true;
+            Logger.warn('Optional package "@zintrust/queue-redis" is not installed. PriorityQueue features are disabled until it is installed.', error);
+        }
+        return undefined;
+    }
+};
 /**
  * Helper: Get or create queue via shared driver
  */
 const getQueue = (queueName) => {
-    return BullMQRedisQueue.getQueue(queueName);
+    const queueRedis = loadQueueRedisModule();
+    if (!queueRedis) {
+        throw ErrorFactory.createWorkerError('Optional package "@zintrust/queue-redis" is required for PriorityQueue. Install it to use queue features.');
+    }
+    return queueRedis.BullMQRedisQueue.getQueue(queueName);
 };
 /**
  * Helper: Build job options with priority
@@ -179,7 +200,10 @@ export const PriorityQueue = Object.freeze({
      * Get all queue names
      */
     getQueueNames() {
-        return BullMQRedisQueue.getQueueNames();
+        const queueRedis = loadQueueRedisModule();
+        if (!queueRedis)
+            return [];
+        return queueRedis.BullMQRedisQueue.getQueueNames();
     },
     /**
      * Drain queue (remove all jobs)
@@ -204,7 +228,10 @@ export const PriorityQueue = Object.freeze({
     async obliterate(queueName, force = false) {
         const queue = getQueue(queueName);
         await queue.obliterate({ force });
-        await BullMQRedisQueue.closeQueue(queueName);
+        const queueRedis = loadQueueRedisModule();
+        if (queueRedis) {
+            await queueRedis.BullMQRedisQueue.closeQueue(queueName);
+        }
         Logger.warn(`Obliterated queue "${queueName}"`);
     },
     /**
@@ -229,7 +256,10 @@ export const PriorityQueue = Object.freeze({
      * Close a queue
      */
     async closeQueue(queueName) {
-        await BullMQRedisQueue.closeQueue(queueName);
+        const queueRedis = loadQueueRedisModule();
+        if (!queueRedis)
+            return;
+        await queueRedis.BullMQRedisQueue.closeQueue(queueName);
         Logger.info(`Closed queue "${queueName}"`);
     },
     /**
@@ -237,7 +267,10 @@ export const PriorityQueue = Object.freeze({
      */
     async shutdown() {
         Logger.info('PriorityQueue shutting down via BullMQRedisQueue...');
-        await BullMQRedisQueue.shutdown();
+        const queueRedis = loadQueueRedisModule();
+        if (!queueRedis)
+            return;
+        await queueRedis.BullMQRedisQueue.shutdown();
         Logger.info('PriorityQueue shutdown complete');
     },
 });

package/dist/WorkerFactory.d.ts

@@ -73,9 +73,9 @@ export type WorkerInstance = {
     connectionState?: 'disconnected' | 'connecting' | 'connected' | 'error';
 };
 type RedisEnvConfig = {
-    env: true;
+    env?: true;
     host?: string;
-    port?: string;
+    port?: number;
     password?: string;
     db?: string;
 };

package/dist/WorkerFactory.js

@@ -502,8 +502,8 @@ const resolveRedisFallbacks = () => {
 const resolveRedisConfigFromEnv = (config, context) => {
     const fallback = resolveRedisFallbacks();
     const host = requireRedisHost(resolveEnvString(config.host ?? 'REDIS_HOST', fallback.host), context);
-    const port = resolveEnvInt(config.port ?? 'REDIS_PORT', fallback.port);
-    const db = resolveEnvInt(config.db ?? 'REDIS_DB', fallback.db);
+    const port = resolveEnvInt(String(config.port ?? 'REDIS_PORT'), fallback.port);
+    const db = config.db ? Number(config.db) : Env.getInt('REDIS_DB', fallback.db);
     const password = resolveEnvString(config.password ?? 'REDIS_PASSWORD', fallback.password);
     return {
         host,
@@ -944,25 +944,49 @@ const initializeDatacenter = (config) => {
 };
 const setupWorkerEventListeners = (worker, workerName, workerVersion, features) => {
     worker.on('completed', (job) => {
-        Logger.debug(`Job completed: ${workerName}`, { jobId: job.id });
-        if (features?.observability === true) {
-            Observability.incrementCounter('worker.jobs.completed', 1, {
-                worker: workerName,
-                version: workerVersion,
-            });
+        try {
+            Logger.debug(`Job completed: ${workerName}`, { jobId: job.id });
+            if (features?.observability === true) {
+                Observability.incrementCounter('worker.jobs.completed', 1, {
+                    worker: workerName,
+                    version: workerVersion,
+                });
+            }
+        }
+        catch (error) {
+            // Isolate error - don't let it bubble up
+            Logger.error(`Error in worker completed event handler: ${workerName}`, error, 'workers');
         }
     });
     worker.on('failed', (job, error) => {
-        Logger.error(`Job failed: ${workerName}`, { error, jobId: job?.id }, 'workers');
-        if (features?.observability === true) {
-            Observability.incrementCounter('worker.jobs.failed', 1, {
-                worker: workerName,
-                version: workerVersion,
-            });
+        try {
+            Logger.error(`Job failed: ${workerName}`, { error, jobId: job?.id }, 'workers');
+            if (features?.observability === true) {
+                Observability.incrementCounter('worker.jobs.failed', 1, {
+                    worker: workerName,
+                    version: workerVersion,
+                });
+            }
+        }
+        catch (handlerError) {
+            // Isolate error - don't let it bubble up
+            Logger.error(`Error in worker failed event handler: ${workerName}`, handlerError, 'workers');
         }
     });
     worker.on('error', (error) => {
-        Logger.error(`Worker error: ${workerName}`, error);
+        try {
+            Logger.error(`Worker error: ${workerName}`, error);
+            // Check if this is a Redis connection error that should be handled gracefully
+            if (error.message.includes('ERR value is not an integer') ||
+                error.message.includes('NOAUTH') ||
+                error.message.includes('ECONNREFUSED')) {
+                Logger.warn(`Worker ${workerName} encountered Redis configuration error - worker will remain failed but server will continue running`);
+            }
+        }
+        catch (handlerError) {
+            // Isolate error - don't let it bubble up
+            Logger.error(`Error in worker error event handler: ${workerName}`, handlerError, 'workers');
+        }
     });
 };
 const registerWorkerInstance = (params) => {

package/dist/WorkerMetrics.js

@@ -3,11 +3,7 @@
  * Time-series metrics persistence with Redis Sorted Sets
  * Sealed namespace for immutability
  */
-import { ErrorFactory, Logger, appConfig, createRedisConnection, } from '@zintrust/core';
-const PREFIX = appConfig.prefix;
-// Redis key prefixes
-const METRICS_PREFIX = `${PREFIX}:worker:metrics:`;
-const HEALTH_PREFIX = `${PREFIX}:worker:health:`;
+import { ErrorFactory, Logger, RedisKeys, createRedisConnection, } from '@zintrust/core';
 // Retention periods (in seconds)
 const RETENTION = {
     hourly: 7 * 24 * 60 * 60, // 7 days
@@ -18,15 +14,17 @@ const RETENTION = {
 let redisClient = null;
 /**
  * Helper: Get Redis key for metrics
+ * Uses singleton RedisKeys for consistent key management
  */
 const getMetricsKey = (workerName, metricType, granularity) => {
-    return `${METRICS_PREFIX}${workerName}:${metricType}:${granularity}`;
+    return RedisKeys.createMetricsKey(workerName, metricType, granularity);
 };
 /**
  * Helper: Get Redis key for health scores
+ * Uses singleton RedisKeys for consistent key management
  */
 const getHealthKey = (workerName) => {
-    return `${HEALTH_PREFIX}${workerName}`;
+    return RedisKeys.createHealthKey(workerName);
 };
 /**
  * Helper: Round timestamp to granularity
@@ -428,9 +426,9 @@ export const WorkerMetrics = Object.freeze({
         }
         try {
             // Find all unique worker names from health keys
-            const pattern = `${HEALTH_PREFIX}*`;
+            const pattern = `${RedisKeys.healthPrefix}*`;
             const keys = await redisClient.keys(pattern);
-            const workerNames = keys.map((key) => key.replace(HEALTH_PREFIX, ''));
+            const workerNames = keys.map((key) => key.replace(RedisKeys.healthPrefix, ''));
             const summaries = await Promise.all(workerNames.map(async (workerName) => {
                 const now = new Date();
                 const oneHourAgo = new Date(now.getTime() - 60 * 60 * 1000);
@@ -478,7 +476,7 @@ export const WorkerMetrics = Object.freeze({
             throw ErrorFactory.createWorkerError('WorkerMetrics not initialized');
         }
         try {
-            const pattern = `${METRICS_PREFIX}${workerName}:*`;
+            const pattern = `${RedisKeys.metricsPrefix}${workerName}:*`;
             const keys = await redisClient.keys(pattern);
             if (keys.length > 0) {
                 await redisClient.del(...keys);

package/dist/WorkerShutdown.js

@@ -111,15 +111,11 @@ function registerShutdownHandlers() {
         }
         process.exit(1);
     });
-    process.on('unhandledRejection', async (reason) => {
-        Logger.error('💥 Unhandled promise rejection during worker operations', reason);
-        try {
-            await shutdown({ signal: 'unhandledRejection', timeout: 10000, forceExit: true });
-        }
-        catch {
-            // Ignore errors during emergency shutdown
-        }
-        process.exit(1);
+    process.on('unhandledRejection', (reason) => {
+        // Only log the error - don't shut down the entire application
+        Logger.error('💥 Unhandled promise rejection detected', reason);
+        Logger.warn('⚠️  This error has been logged but will not shut down the server');
+        Logger.warn('⚠️  Check the error context and fix the underlying issue');
     });
     shutdownHandlersRegistered = true;
     Logger.debug('Worker management system shutdown handlers registered');

package/dist/build-manifest.json

@@ -1,14 +1,14 @@
 {
   "name": "@zintrust/workers",
-  "version": "0.1.0",
-  "buildDate": "2026-01-28T12:31:48.108Z",
+  "version": "0.1.27",
+  "buildDate": "2026-01-29T10:20:40.563Z",
   "buildEnvironment": {
     "node": "v22.20.0",
     "platform": "darwin",
     "arch": "arm64"
   },
   "git": {
-    "commit": "2d1585bf",
+    "commit": "15551a6c",
     "branch": "dev"
   },
   "package": {
@@ -17,8 +17,6 @@
     },
     "dependencies": [
       "@opentelemetry/api",
-      "@zintrust/queue-redis",
-      "@zintrust/queue-monitor",
       "hot-shots",
       "ioredis",
       "ml.js",
@@ -155,8 +153,8 @@
       "sha256": "c7610ac74b5e1ce9cae991d15b8eeecadc1a7732fcf42a8a4a95ecbea29f19de"
     },
     "PriorityQueue.js": {
-      "size": 7417,
-      "sha256": "f21084e292eba33c37446b40542be392a97ae37af3c98b097e09f5f93e68fe8e"
+      "size": 8689,
+      "sha256": "348cce03da64d4b2b6131dfb37903c81e9005781951485f4a6afaf925fe8f2ce"
     },
     "ResourceMonitor.d.ts": {
       "size": 4019,
@@ -175,12 +173,12 @@
       "sha256": "3785712c1cc30f4cfbdaebfc738f5e2b4dc0dd80134f78c42e24287909803b2c"
     },
     "WorkerFactory.d.ts": {
-      "size": 6404,
-      "sha256": "f5072fe1f60313e2aebc80223a9329d38d3b7e71b76a77047bdacf702ffa2fe3"
+      "size": 6405,
+      "sha256": "8cfd3b1743f21b11c16a1f8f6285354626ecbe957e3e5b79801165a42289b716"
     },
     "WorkerFactory.js": {
-      "size": 59444,
-      "sha256": "83076f126fd1d81f08ba9f58ff3f78baab17bb962c29bac105444a21ba143e34"
+      "size": 60631,
+      "sha256": "a285c6d9f3405d805cc90245994bbef55d041f18b7e86b6bde00dbf8dd5035bd"
     },
     "WorkerInit.d.ts": {
       "size": 2391,
@@ -195,8 +193,8 @@
       "sha256": "e68d3abf7e83bb3c0317c518325653ef3468a2a989a888ff997ce56ccc64e50f"
     },
     "WorkerMetrics.js": {
-      "size": 18881,
-      "sha256": "b51273d4aeacf7744da11c6b0c898d2bc70433892fe31107ee337ebd408cb0bb"
+      "size": 18875,
+      "sha256": "a95f130989a9ffccbd77a8955568c0b603ef89a04c8f166b14fac8814407086f"
     },
     "WorkerRegistry.d.ts": {
       "size": 3753,
@@ -211,8 +209,8 @@
       "sha256": "f7c77d325f325729976206e1666d6d084ae486e08e047e5cea6ce8bfafbb3359"
     },
     "WorkerShutdown.js": {
-      "size": 5369,
-      "sha256": "6e2001b4335516217c3a5ff022e85461c7b1c3c2c8fbe7c24c115d1e5f7ab9c5"
+      "size": 5371,
+      "sha256": "6c25fe18b27b881acfd2b424d31bbbcbb57ae2bd3c0d86d4ee54b8a28e3e9cb9"
     },
     "WorkerVersioning.d.ts": {
       "size": 2881,
@@ -223,8 +221,8 @@
       "sha256": "8af20d462270e7044c6ea983821f5b6e6ce8a5caf39b6e8fefff07c9a0bf071e"
     },
     "build-manifest.json": {
-      "size": 16016,
-      "sha256": "7019b7f79ae21a5639c4f6830bf446b3755dba2fd466501897d3b3692cde63c0"
+      "size": 16012,
+      "sha256": "a0f6ef230375ffbef2eac3f2275ff5c34327b10806a4a2c057f8bbad566f33ed"
     },
     "config/workerConfig.d.ts": {
       "size": 86,
@@ -415,8 +413,8 @@
       "sha256": "333d1433cf26d6e4d0ab1a5b0da4400846fd924aacce8e7d8e5305b4253290c6"
     },
     "index.js": {
-      "size": 2141,
-      "sha256": "0999553bfaf3ee9c0d46e2cd7d6af6d8ed8f48470b98df4134b722d87fe0bfcd"
+      "size": 2142,
+      "sha256": "afe0657df6f04542ca71e7a8d827f122075f22a073b76e17b7c2a2b1bd007913"
     },
     "routes/workers.d.ts": {
       "size": 498,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/workers",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,7 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "@zintrust/core": "^0.1.27"
+    "@zintrust/core": "^0.1.34"
   },
   "publishConfig": {
     "access": "public"
@@ -42,12 +42,14 @@
   },
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@zintrust/queue-redis": "file:../queue-redis",
-    "@zintrust/queue-monitor": "file:../queue-monitor",
     "hot-shots": "^10.2.1",
     "ioredis": "^5.9.2",
     "ml.js": "^0.0.1",
     "prom-client": "^15.1.3",
     "simple-statistics": "^7.8.8"
+  },
+  "optionalDependencies": {
+    "@zintrust/queue-redis": "^0.1.27",
+    "@zintrust/queue-monitor": "^0.1.27"
   }
 }

package/src/PriorityQueue.ts

@@ -4,8 +4,7 @@
  * Sealed namespace for immutability
  */
 
-import { ErrorFactory, Logger, type RedisConfig } from '@zintrust/core';
-import { BullMQRedisQueue } from '@zintrust/queue-redis';
+import { ErrorFactory, Logger, NodeSingletons, type RedisConfig } from '@zintrust/core';
 import type { Queue } from 'bullmq';
 
 export type PriorityLevel = 'critical' | 'high' | 'normal' | 'low';
@@ -54,11 +53,41 @@ const PRIORITY_VALUES: Record<PriorityLevel, number> = {
   low: 0,
 };
 
+type QueueRedisModule = typeof import('@zintrust/queue-redis');
+
+const require = NodeSingletons.module.createRequire(import.meta.url);
+let queueRedisModule: QueueRedisModule | undefined;
+let hasWarnedMissingQueueRedis = false;
+
+const loadQueueRedisModule = (): QueueRedisModule | undefined => {
+  if (queueRedisModule) return queueRedisModule;
+
+  try {
+    queueRedisModule = require('@zintrust/queue-redis') as QueueRedisModule;
+    return queueRedisModule;
+  } catch (error) {
+    if (!hasWarnedMissingQueueRedis) {
+      hasWarnedMissingQueueRedis = true;
+      Logger.warn(
+        'Optional package "@zintrust/queue-redis" is not installed. PriorityQueue features are disabled until it is installed.',
+        error as Error
+      );
+    }
+    return undefined;
+  }
+};
+
 /**
  * Helper: Get or create queue via shared driver
  */
 const getQueue = (queueName: string): Queue => {
-  return BullMQRedisQueue.getQueue(queueName) as Queue;
+  const queueRedis = loadQueueRedisModule();
+  if (!queueRedis) {
+    throw ErrorFactory.createWorkerError(
+      'Optional package "@zintrust/queue-redis" is required for PriorityQueue. Install it to use queue features.'
+    );
+  }
+  return queueRedis.BullMQRedisQueue.getQueue(queueName) as Queue;
 };
 
 /**
@@ -269,7 +298,9 @@ export const PriorityQueue = Object.freeze({
    * Get all queue names
    */
   getQueueNames(): string[] {
-    return BullMQRedisQueue.getQueueNames();
+    const queueRedis = loadQueueRedisModule();
+    if (!queueRedis) return [];
+    return queueRedis.BullMQRedisQueue.getQueueNames();
   },
 
   /**
@@ -304,7 +335,10 @@ export const PriorityQueue = Object.freeze({
   async obliterate(queueName: string, force = false): Promise<void> {
     const queue = getQueue(queueName);
     await queue.obliterate({ force });
-    await BullMQRedisQueue.closeQueue(queueName);
+    const queueRedis = loadQueueRedisModule();
+    if (queueRedis) {
+      await queueRedis.BullMQRedisQueue.closeQueue(queueName);
+    }
 
     Logger.warn(`Obliterated queue "${queueName}"`);
   },
@@ -334,7 +368,9 @@ export const PriorityQueue = Object.freeze({
    * Close a queue
    */
   async closeQueue(queueName: string): Promise<void> {
-    await BullMQRedisQueue.closeQueue(queueName);
+    const queueRedis = loadQueueRedisModule();
+    if (!queueRedis) return;
+    await queueRedis.BullMQRedisQueue.closeQueue(queueName);
     Logger.info(`Closed queue "${queueName}"`);
   },
 
@@ -343,7 +379,9 @@ export const PriorityQueue = Object.freeze({
    */
   async shutdown(): Promise<void> {
     Logger.info('PriorityQueue shutting down via BullMQRedisQueue...');
-    await BullMQRedisQueue.shutdown();
+    const queueRedis = loadQueueRedisModule();
+    if (!queueRedis) return;
+    await queueRedis.BullMQRedisQueue.shutdown();
     Logger.info('PriorityQueue shutdown complete');
   },
 });

package/src/WorkerFactory.ts

@@ -161,9 +161,9 @@ export type WorkerInstance = {
 };
 
 type RedisEnvConfig = {
-  env: true;
+  env?: true;
   host?: string;
-  port?: string;
+  port?: number;
   password?: string;
   db?: string;
 };
@@ -836,8 +836,8 @@ const resolveRedisConfigFromEnv = (config: RedisEnvConfig, context: string): Red
     resolveEnvString(config.host ?? 'REDIS_HOST', fallback.host),
     context
   );
-  const port = resolveEnvInt(config.port ?? 'REDIS_PORT', fallback.port);
-  const db = resolveEnvInt(config.db ?? 'REDIS_DB', fallback.db);
+  const port = resolveEnvInt(String(config.port ?? 'REDIS_PORT'), fallback.port);
+  const db = config.db ? Number(config.db) : Env.getInt('REDIS_DB', fallback.db);
   const password = resolveEnvString(config.password ?? 'REDIS_PASSWORD', fallback.password);
 
   return {
@@ -1408,29 +1408,55 @@ const setupWorkerEventListeners = (
   features?: WorkerFactoryConfig['features']
 ): void => {
   worker.on('completed', (job: Job) => {
-    Logger.debug(`Job completed: ${workerName}`, { jobId: job.id });
+    try {
+      Logger.debug(`Job completed: ${workerName}`, { jobId: job.id });
 
-    if (features?.observability === true) {
-      Observability.incrementCounter('worker.jobs.completed', 1, {
-        worker: workerName,
-        version: workerVersion,
-      });
+      if (features?.observability === true) {
+        Observability.incrementCounter('worker.jobs.completed', 1, {
+          worker: workerName,
+          version: workerVersion,
+        });
+      }
+    } catch (error) {
+      // Isolate error - don't let it bubble up
+      Logger.error(`Error in worker completed event handler: ${workerName}`, error, 'workers');
     }
   });
 
   worker.on('failed', (job: Job | undefined, error: Error) => {
-    Logger.error(`Job failed: ${workerName}`, { error, jobId: job?.id }, 'workers');
+    try {
+      Logger.error(`Job failed: ${workerName}`, { error, jobId: job?.id }, 'workers');
 
-    if (features?.observability === true) {
-      Observability.incrementCounter('worker.jobs.failed', 1, {
-        worker: workerName,
-        version: workerVersion,
-      });
+      if (features?.observability === true) {
+        Observability.incrementCounter('worker.jobs.failed', 1, {
+          worker: workerName,
+          version: workerVersion,
+        });
+      }
+    } catch (handlerError) {
+      // Isolate error - don't let it bubble up
+      Logger.error(`Error in worker failed event handler: ${workerName}`, handlerError, 'workers');
     }
   });
 
   worker.on('error', (error: Error) => {
-    Logger.error(`Worker error: ${workerName}`, error);
+    try {
+      Logger.error(`Worker error: ${workerName}`, error);
+
+      // Check if this is a Redis connection error that should be handled gracefully
+      if (
+        error.message.includes('ERR value is not an integer') ||
+        error.message.includes('NOAUTH') ||
+        error.message.includes('ECONNREFUSED')
+      ) {
+        Logger.warn(
+          `Worker ${workerName} encountered Redis configuration error - worker will remain failed but server will continue running`
+        );
+      }
+    } catch (handlerError) {
+      // Isolate error - don't let it bubble up
+      Logger.error(`Error in worker error event handler: ${workerName}`, handlerError, 'workers');
+    }
   });
 };
 

package/src/WorkerMetrics.ts

@@ -7,14 +7,12 @@
 import {
   ErrorFactory,
   Logger,
-  appConfig,
+  RedisKeys,
   createRedisConnection,
   type RedisConfig,
 } from '@zintrust/core';
 import type IORedis from 'ioredis';
 
-const PREFIX = appConfig.prefix;
-
 export type MetricType =
   | 'processed'
   | 'errors'
@@ -76,10 +74,6 @@ export type WorkerHealthScore = {
   status: 'healthy' | 'degraded' | 'unhealthy';
 };
 
-// Redis key prefixes
-const METRICS_PREFIX = `${PREFIX}:worker:metrics:`;
-const HEALTH_PREFIX = `${PREFIX}:worker:health:`;
-
 // Retention periods (in seconds)
 const RETENTION = {
   hourly: 7 * 24 * 60 * 60, // 7 days
@@ -92,20 +86,22 @@ let redisClient: IORedis | null = null;
 
 /**
  * Helper: Get Redis key for metrics
+ * Uses singleton RedisKeys for consistent key management
  */
 const getMetricsKey = (
   workerName: string,
   metricType: MetricType,
   granularity: MetricGranularity
 ): string => {
-  return `${METRICS_PREFIX}${workerName}:${metricType}:${granularity}`;
+  return RedisKeys.createMetricsKey(workerName, metricType, granularity);
 };
 
 /**
  * Helper: Get Redis key for health scores
+ * Uses singleton RedisKeys for consistent key management
  */
 const getHealthKey = (workerName: string): string => {
-  return `${HEALTH_PREFIX}${workerName}`;
+  return RedisKeys.createHealthKey(workerName);
 };
 
 /**
@@ -613,9 +609,9 @@ export const WorkerMetrics = Object.freeze({
 
     try {
       // Find all unique worker names from health keys
-      const pattern = `${HEALTH_PREFIX}*`;
+      const pattern = `${RedisKeys.healthPrefix}*`;
       const keys = await redisClient.keys(pattern);
-      const workerNames = keys.map((key) => key.replace(HEALTH_PREFIX, ''));
+      const workerNames = keys.map((key) => key.replace(RedisKeys.healthPrefix, ''));
 
       const summaries = await Promise.all(
         workerNames.map(async (workerName) => {
@@ -671,7 +667,7 @@ export const WorkerMetrics = Object.freeze({
     }
 
     try {
-      const pattern = `${METRICS_PREFIX}${workerName}:*`;
+      const pattern = `${RedisKeys.metricsPrefix}${workerName}:*`;
       const keys = await redisClient.keys(pattern);
 
       if (keys.length > 0) {

package/src/WorkerShutdown.ts

@@ -155,14 +155,11 @@ function registerShutdownHandlers(): void {
     process.exit(1);
   });
 
-  process.on('unhandledRejection', async (reason: unknown) => {
-    Logger.error('💥 Unhandled promise rejection during worker operations', reason);
-    try {
-      await shutdown({ signal: 'unhandledRejection', timeout: 10000, forceExit: true });
-    } catch {
-      // Ignore errors during emergency shutdown
-    }
-    process.exit(1);
+  process.on('unhandledRejection', (reason: unknown) => {
+    // Only log the error - don't shut down the entire application
+    Logger.error('💥 Unhandled promise rejection detected', reason);
+    Logger.warn('⚠️  This error has been logged but will not shut down the server');
+    Logger.warn('⚠️  Check the error context and fix the underlying issue');
   });
 
   shutdownHandlersRegistered = true;