@zintrust/queue-monitor 2.0.0 → 2.1.3

package/dist/QueueMonitoringService.d.ts

@@ -1,4 +1,4 @@
-import type { IRequest, IResponse } from '@zintrust/core';
+import type { IRequest, IResponse } from '@zintrust/core/http';
 import type { QueueDriver } from './driver';
 import type { LockAnalytics, QueueMonitorSnapshot } from './index';
 import type { JobSummary, Metrics } from './metrics';

package/dist/QueueMonitoringService.js

@@ -1,4 +1,4 @@
-import { Logger } from '@zintrust/core';
+import { Logger } from '@zintrust/core/logger';
 export const ALL_QUEUES = '__all__';
 const subscriptions = new Map();
 const channels = new Map();

package/dist/api/workerClient.d.ts

@@ -0,0 +1,20 @@
+type WorkerApiResponse<T> = {
+    ok: boolean;
+    error?: string;
+} & T;
+export declare const WorkerClient: Readonly<{
+    listWorkers(): Promise<string[]>;
+    getWorker(name: string): Promise<unknown>;
+    getStatus(name: string): Promise<unknown>;
+    getHealth(name: string): Promise<unknown>;
+    startWorker(name: string): Promise<WorkerApiResponse<{
+        message?: string;
+    }>>;
+    stopWorker(name: string): Promise<WorkerApiResponse<{
+        message?: string;
+    }>>;
+    restartWorker(name: string): Promise<WorkerApiResponse<{
+        message?: string;
+    }>>;
+}>;
+export {};

package/dist/api/workerClient.js

@@ -0,0 +1,45 @@
+import { ErrorFactory, Logger } from '@zintrust/core';
+import { WorkerConfig } from '../config/workerConfig.js';
+const requestJson = async (path, options = {}) => {
+    const baseUrl = WorkerConfig.getWorkerBaseUrl();
+    const url = `${baseUrl}${path}`;
+    const response = await fetch(url, {
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers,
+        },
+    });
+    if (!response.ok) {
+        Logger.error('Worker API request failed', { url, status: response.status });
+        throw ErrorFactory.createWorkerError(`Worker API request failed (${response.status})`);
+    }
+    return (await response.json());
+};
+export const WorkerClient = Object.freeze({
+    async listWorkers() {
+        const response = await requestJson('/api/workers');
+        return response.workers ?? [];
+    },
+    async getWorker(name) {
+        const response = await requestJson(`/api/workers/${name}`);
+        return response.worker;
+    },
+    async getStatus(name) {
+        const response = await requestJson(`/api/workers/${name}/status`);
+        return response.status;
+    },
+    async getHealth(name) {
+        const response = await requestJson(`/api/workers/${name}/health`);
+        return response.health;
+    },
+    async startWorker(name) {
+        return requestJson(`/api/workers/${name}/start`, { method: 'POST' });
+    },
+    async stopWorker(name) {
+        return requestJson(`/api/workers/${name}/stop`, { method: 'POST' });
+    },
+    async restartWorker(name) {
+        return requestJson(`/api/workers/${name}/restart`, { method: 'POST' });
+    },
+});

package/dist/build-manifest.json

@@ -1,15 +1,15 @@
 {
   "name": "@zintrust/queue-monitor",
-  "version": "2.0.0",
-  "buildDate": "2026-05-20T20:03:20.173Z",
+  "version": "2.1.3",
+  "buildDate": "2026-05-27T04:06:48.857Z",
   "buildEnvironment": {
-    "node": "v20.20.2",
-    "platform": "linux",
-    "arch": "x64"
+    "node": "v22.22.1",
+    "platform": "darwin",
+    "arch": "arm64"
   },
   "git": {
-    "commit": "be96835b",
-    "branch": "master"
+    "commit": "c82f6263",
+    "branch": "release"
   },
   "package": {
     "engines": {
@@ -33,20 +33,56 @@
       "sha256": "33e57f6cec15b8dcb5886ca92644139d2e3ca1789aae1c3a4a066d75a273a6bb"
     },
     "QueueMonitoringService.d.ts": {
-      "size": 1684,
-      "sha256": "26a91f1b41d8a976a9e8fabaedc3fe6dc955c700499f0afc1a16fb91c9848665"
+      "size": 1689,
+      "sha256": "02c48a81818833e049fa8606014b0af2f8cbd04ec57f0be874873da24f72e2b9"
     },
     "QueueMonitoringService.js": {
-      "size": 8928,
-      "sha256": "fc408db720d5883821b169eabce66944295068cd6f2338f1884493c299f0a0f1"
+      "size": 8935,
+      "sha256": "c099e8922dd5642bce33a7db4b4a98641cab16e45a4ab76f989ef76a1178700e"
+    },
+    "api/workerClient.d.ts": {
+      "size": 597,
+      "sha256": "1d712bfa9127aa2df4f1fbd0efbb6d84069e1888ed73aca5542a41eee865d4bb"
+    },
+    "api/workerClient.js": {
+      "size": 1629,
+      "sha256": "60f993a42f4a9dd5000b01dae3b0f105a8f4348da8433a735b5cc1929a8f64ce"
+    },
+    "build-manifest.json": {
+      "size": 5228,
+      "sha256": "4950be04d3c30e53ac2abd01e6bfe05f6c3ffcdd7c7250f89fb067ad7db39896"
+    },
+    "config/queueMonitor.d.ts": {
+      "size": 407,
+      "sha256": "4541f47e64c8ede1bfd8fc0cb7edb76c4e885311b28b1f51c9be7639e5d87eca"
+    },
+    "config/queueMonitor.js": {
+      "size": 689,
+      "sha256": "0b95e6b65d4b6ffdd69788cdfd19e0e76400a39ad69dce018d8827a3b298e419"
+    },
+    "config/workerConfig.d.ts": {
+      "size": 86,
+      "sha256": "b669205d50c8844455a2d9b34a54f48a71118eb6ac99bad5372683ab666f5a22"
+    },
+    "config/workerConfig.js": {
+      "size": 628,
+      "sha256": "ca1c6dbaa751893f0e6b7c8a7fd41a80f7d5e8fc9aaaa4877ca12821bb25f56f"
     },
     "connection.d.ts": {
-      "size": 285,
-      "sha256": "02b8d856e6b905f10ac01fabe7c44560530878c0ec73924889e1d159018d317a"
+      "size": 287,
+      "sha256": "dcc6ea45e59b0a2e8844b27f466dff4849618c06b74aae62a99c8edd772d0db0"
     },
     "connection.js": {
-      "size": 171,
-      "sha256": "a4d2967491dc471a75c163f81b5c7199f9e3b34c7c958b65d5bc6bb11798fc6f"
+      "size": 178,
+      "sha256": "ff387351f5b8c7c14a7f2ef817fbbb065ad677faffcb47e5e8ddc4b064747e5b"
+    },
+    "dashboard-index.d.ts": {
+      "size": 180,
+      "sha256": "f78b4a0a83566640eca154f92d3f858ec41deb2521a500939ee3f0e58ee5db86"
+    },
+    "dashboard-index.js": {
+      "size": 183,
+      "sha256": "9d7c7fc63fe2919de0584d3f3d0ef74166d834af0a68caca2fe6fe64340652b9"
     },
     "dashboard-ui.d.ts": {
       "size": 219,
@@ -56,37 +92,77 @@
       "size": 53927,
       "sha256": "71bab126f20aea1165ee3aa3c82e896ebd89b1f1a815ef2716cd884b846ab34f"
     },
+    "driver-index.d.ts": {
+      "size": 280,
+      "sha256": "71a4dc5d823391fe16e966069aae8e6704d5c2d64aaceb447e138fdde7023690"
+    },
+    "driver-index.js": {
+      "size": 184,
+      "sha256": "fb91df973acd13a88cca443e50ecdd34944c66e1a1d48333f63099079a00f3c9"
+    },
     "driver.d.ts": {
       "size": 1102,
       "sha256": "70b74e7a0489da3a5545dfd8458ab5b4def1f3733c291a782c033fed0afd0bcf"
     },
     "driver.js": {
-      "size": 5165,
-      "sha256": "06a4aa4294ed0694146d184e8b0f1677ebe22a3d90bffa30b7c268657035c760"
+      "size": 5211,
+      "sha256": "e1ba94425ab8f00cb8c34fde73fa447fe239966f2e6484d470c09b23f0931c17"
     },
     "index.d.ts": {
-      "size": 2161,
-      "sha256": "2556c136641769f4e7cd81abd6ecae8663433aba74b09bc507b8fba01e3fc6f5"
+      "size": 2166,
+      "sha256": "384c5772e26ed721b5c0fffafe6a03f0385df8414058c9c944d742b4c0301ac4"
     },
     "index.js": {
-      "size": 14399,
-      "sha256": "18b28ec7b731fd8a68c05c008cbecfb59427c8bc157da938976b45c1adb117ad"
+      "size": 14603,
+      "sha256": "600478b203c190df631f01b04852d8e1e784bd7f18177b8a9218e99489ce527b"
+    },
+    "metrics-index.d.ts": {
+      "size": 233,
+      "sha256": "993ffe832f2914a81c81364f7b6d5c7247cd16da9bb9feb04caf8d770c14f9ec"
+    },
+    "metrics-index.js": {
+      "size": 171,
+      "sha256": "53e858995605858b819f2c48c701e3b8f7d028ec51c1b4814c46284c7fb3989e"
     },
     "metrics.d.ts": {
       "size": 910,
       "sha256": "6467795f6de818a1f295c42755005e394f25b145163c7678d6ac9ac1f9477fea"
     },
     "metrics.js": {
-      "size": 3472,
-      "sha256": "fab0e6d62ed694dcf57904a68b683280e4063c2fdcf97c60fdf5d933ae2b8f4f"
+      "size": 3478,
+      "sha256": "43cbce7fcf4db9c7e25806db716b6b20340fc29d0c29daec92bc40cc9f1e520d"
+    },
+    "routes/workers.d.ts": {
+      "size": 477,
+      "sha256": "cfcc3527c47d1a796a3ced2d4777b339dd767f7feb3ecc66c5ce0a91d8ff1bc8"
+    },
+    "routes/workers.js": {
+      "size": 901,
+      "sha256": "1ec48c0becc8c0628b1780fb400e957c5fe50da79f73112436c33ecde7d7d574"
+    },
+    "runtime-index.d.ts": {
+      "size": 2209,
+      "sha256": "e5d5c3475a7caec57f9e1a61bffb11038858e2c3f7be03e04ca28b8295e878fc"
+    },
+    "runtime-index.js": {
+      "size": 8924,
+      "sha256": "494757d540fe57507ac59ef2935ad683cb14fa57dbe188ffe3e6dd9fe3cb1ea9"
     },
     "worker.d.ts": {
       "size": 332,
       "sha256": "97cddbc991c6e6724950090cd92f06671932ab848c16dd94a030d9fba3fbae26"
     },
     "worker.js": {
-      "size": 1233,
-      "sha256": "da26c1b80da7473e1644a4e0f8d814097ce0adff14e36037164f9ae5855e656a"
+      "size": 1239,
+      "sha256": "46f116eb169fca1dc6dfd48d299001635c48a2da8d6e10115a98fcd33187b53e"
+    },
+    "workers-ui.d.ts": {
+      "size": 214,
+      "sha256": "4f5fd3bbd077d0dee2cc6c73d2c736fc52119b0d3a5f4a1878a4f3d3d3edf299"
+    },
+    "workers-ui.js": {
+      "size": 24928,
+      "sha256": "ba2c5cbf890fe875cc5336c76bd29b146089bc8ba3a70de4a2c383f395f9be73"
     }
   }
 }

package/dist/config/queueMonitor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Queue Monitor Configuration (default override)
+ *
+ * Keep this file declarative:
+ * - Core owns env parsing/default logic.
+ * - Projects can override config by editing values below.
+ */
+declare const _default: {
+    enabled: boolean;
+    basePath: string;
+    middleware: string[];
+    redis: {
+        host: string;
+        port: number;
+        password: string;
+    };
+};
+export default _default;

package/dist/config/queueMonitor.js

@@ -0,0 +1,21 @@
+import { Env } from '@zintrust/core';
+/**
+ * Queue Monitor Configuration (default override)
+ *
+ * Keep this file declarative:
+ * - Core owns env parsing/default logic.
+ * - Projects can override config by editing values below.
+ */
+export default {
+    enabled: Env.getBool('QUEUE_MONITOR_ENABLED', true),
+    basePath: Env.get('QUEUE_MONITOR_BASE_PATH', '/queue-monitor'),
+    middleware: Env.get('QUEUE_MONITOR_MIDDLEWARE', 'auth')
+        .split(',')
+        .map((m) => m.trim())
+        .filter((m) => m.length > 0),
+    redis: {
+        host: Env.get('REDIS_HOST', 'localhost'),
+        port: Env.getInt('REDIS_PORT', 6379),
+        password: Env.get('REDIS_PASSWORD', ''),
+    },
+};

package/dist/config/workerConfig.d.ts

@@ -0,0 +1,3 @@
+export declare const WorkerConfig: Readonly<{
+    getWorkerBaseUrl: () => string;
+}>;

package/dist/config/workerConfig.js

@@ -0,0 +1,19 @@
+import { Env } from '@zintrust/core';
+const normalizeBaseUrl = (value) => {
+    let end = value.length;
+    while (end > 0 && value.charAt(end - 1) === '/') {
+        end--;
+    }
+    return value.slice(0, end);
+};
+const withHttpScheme = (value) => value.startsWith('http://') || value.startsWith('https://') ? value : `http://${value}`;
+const resolveWorkerApiUrl = () => {
+    const workerApiUrl = Env.get('WORKER_API_URL');
+    if (workerApiUrl) {
+        return normalizeBaseUrl(withHttpScheme(workerApiUrl));
+    }
+    return '';
+};
+export const WorkerConfig = Object.freeze({
+    getWorkerBaseUrl: resolveWorkerApiUrl,
+});

package/dist/connection.d.ts

@@ -1,3 +1,3 @@
-import { createRedisConnection as createCoreRedisConnection } from '@zintrust/core';
-export type { RedisConfig } from '@zintrust/core';
+import { createRedisConnection as createCoreRedisConnection, type RedisConfig } from '@zintrust/core/redis';
+export type { RedisConfig };
 export declare const createRedisConnection: (...args: Parameters<typeof createCoreRedisConnection>) => ReturnType<typeof createCoreRedisConnection>;

package/dist/connection.js

@@ -1,2 +1,2 @@
-import { createRedisConnection as createCoreRedisConnection } from '@zintrust/core';
+import { createRedisConnection as createCoreRedisConnection, } from '@zintrust/core/redis';
 export const createRedisConnection = (...args) => createCoreRedisConnection(...args);

package/dist/dashboard-index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Queue Monitor Dashboard UI - Non-runtime entrypoint
+ * Contains the dashboard UI components for development/admin use
+ */
+export { getDashboardHtml } from './dashboard-ui';

package/dist/dashboard-index.js

@@ -0,0 +1,5 @@
+/**
+ * Queue Monitor Dashboard UI - Non-runtime entrypoint
+ * Contains the dashboard UI components for development/admin use
+ */
+export { getDashboardHtml } from './dashboard-ui';

package/dist/driver-index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Queue Monitor Driver - Runtime-only entrypoint
+ * Contains only the core queue driver functionality for production Workers
+ */
+export type { JobPayload, JobCounts, RetrySnapshot, RetryJobResult, QueueDriver } from './driver';
+export { createBullMQDriver } from './driver';

package/dist/driver-index.js

@@ -0,0 +1,5 @@
+/**
+ * Queue Monitor Driver - Runtime-only entrypoint
+ * Contains only the core queue driver functionality for production Workers
+ */
+export { createBullMQDriver } from './driver';

package/dist/driver.js

@@ -1,4 +1,5 @@
-import { ErrorFactory, getBullMQSafeQueueName } from '@zintrust/core';
+import { ErrorFactory } from '@zintrust/core/errors';
+import { getBullMQSafeQueueName } from '@zintrust/core/redis';
 import { Queue } from 'bullmq';
 import { createRedisConnection } from './connection';
 async function enrichJobsWithState(jobs) {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { type IRouter } from '@zintrust/core';
+import { type IRouter } from '@zintrust/core/http';
 import { type RedisConfig } from './connection';
 import { type QueueDriver } from './driver';
 import { type Metrics } from './metrics';

package/dist/index.js

@@ -1,4 +1,9 @@
-import { Env, isNonEmptyString, Logger, queueConfig, resolveLockPrefix, Router, ShutdownTrace, } from '@zintrust/core';
+import { Env, queueConfig } from '@zintrust/core/config';
+import { Router, } from '@zintrust/core/http';
+import { Logger } from '@zintrust/core/logger';
+import { resolveLockPrefix } from '@zintrust/core/queue';
+import { isNonEmptyString } from '@zintrust/core/utils';
+import { ShutdownTrace } from '@zintrust/core/workers';
 import { createRedisConnection } from './connection';
 import { getDashboardHtml } from './dashboard-ui';
 import { createBullMQDriver } from './driver';

package/dist/metrics-index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Queue Monitor Metrics - Runtime-only entrypoint
+ * Contains only the metrics functionality for production Workers
+ */
+export type { JobStatus, JobSummary, Metrics } from './metrics';
+export { createMetrics } from './metrics';

package/dist/metrics-index.js

@@ -0,0 +1,5 @@
+/**
+ * Queue Monitor Metrics - Runtime-only entrypoint
+ * Contains only the metrics functionality for production Workers
+ */
+export { createMetrics } from './metrics';

package/dist/metrics.js

@@ -1,4 +1,4 @@
-import { RedisKeys } from '@zintrust/core';
+import { RedisKeys } from '@zintrust/core/queue';
 import { createRedisConnection } from './connection';
 /**
  * Creates a queue monitoring key using singleton RedisKeys

package/dist/routes/workers.d.ts

@@ -0,0 +1,10 @@
+import { type IRouter } from '@zintrust/core';
+import { type WorkerUiOptions } from '../workers-ui';
+type RouteOptions = {
+    middleware?: ReadonlyArray<string>;
+} | undefined;
+export declare const registerWorkerUiRoutes: (router: IRouter, options: WorkerUiOptions, routeOptions: RouteOptions) => void;
+declare const _default: Readonly<{
+    registerWorkerUiRoutes: (router: IRouter, options: WorkerUiOptions, routeOptions: RouteOptions) => void;
+}>;
+export default _default;

package/dist/routes/workers.js

@@ -0,0 +1,20 @@
+import { Router } from '@zintrust/core';
+import { WorkerConfig } from '../config/workerConfig.js';
+import { getWorkersHtml } from '../workers-ui.js';
+const registerWorkerUiPage = (router, options, routeOptions) => {
+    const handler = (_req, res) => {
+        res.html(getWorkersHtml({
+            basePath: options.basePath,
+            apiBaseUrl: WorkerConfig.getWorkerBaseUrl(),
+            autoRefresh: options.autoRefresh,
+            refreshIntervalMs: options.refreshIntervalMs,
+        }));
+    };
+    Router.get(router, `${options.basePath}/workers`, handler, routeOptions);
+    Router.get(router, '/workers', handler, routeOptions);
+    Router.get(router, '/workers/', handler, routeOptions);
+};
+export const registerWorkerUiRoutes = (router, options, routeOptions) => {
+    registerWorkerUiPage(router, options, routeOptions);
+};
+export default Object.freeze({ registerWorkerUiRoutes });

package/dist/runtime-index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Queue Monitor - Runtime-only entrypoint for production Workers
+ * Excludes dashboard UI components that are not needed for runtime
+ */
+import { type RedisConfig } from './connection';
+import { type QueueDriver } from './driver';
+import { type Metrics } from './metrics';
+export type { JobPayload } from './driver';
+export { createMetrics, type JobStatus, type JobSummary, type Metrics } from './metrics';
+export { createWorker as createQueueWorker, type QueueWorker } from './worker';
+export type QueueMonitorConfig = {
+    enabled?: boolean;
+    basePath?: string;
+    middleware?: ReadonlyArray<string>;
+    autoRefresh?: boolean;
+    refreshIntervalMs?: number;
+    redis?: RedisConfig;
+    knownQueues?: ReadonlyArray<string> | (() => Promise<ReadonlyArray<string>> | ReadonlyArray<string>);
+};
+export type QueueCounts = {
+    waiting: number;
+    active: number;
+    completed: number;
+    failed: number;
+    delayed: number;
+    paused: number;
+};
+export type QueueMonitorSnapshot = {
+    status: 'ok';
+    startedAt: string;
+    queues: Array<{
+        name: string;
+        counts: QueueCounts;
+    }>;
+};
+export type LockSummary = {
+    key: string;
+    ttl?: number;
+    expires?: string;
+};
+export type LockMetrics = {
+    active: number;
+    attempts: number;
+    acquired: number;
+    collisions: number;
+    collisionRate: number;
+};
+export type LockHistogramBucket = {
+    label: string;
+    count: number;
+};
+export type LockAnalytics = {
+    locks: LockSummary[];
+    metrics: LockMetrics;
+    histogram: LockHistogramBucket[];
+};
+export type QueueMonitorApi = {
+    getSnapshot: () => Promise<QueueMonitorSnapshot>;
+    getLocks: (pattern?: string) => Promise<LockAnalytics>;
+    driver: QueueDriver;
+    metrics: Metrics;
+    close: () => Promise<void>;
+};
+export declare const QueueMonitor: Readonly<{
+    create(config: QueueMonitorConfig): QueueMonitorApi;
+}>;
+export default QueueMonitor;
+export { createBullMQDriver } from './driver';
+/**
+ * Package version and build metadata
+ * Available at runtime for debugging and health checks
+ */
+export declare const _ZINTRUST_QUEUE_MONITOR_VERSION = "0.1.0";
+export declare const _ZINTRUST_QUEUE_MONITOR_BUILD_DATE = "__BUILD_DATE__";