@zintrust/workers 0.4.0 → 0.4.3

package/README.md

@@ -36,6 +36,15 @@ npm install brain.js ml.js simple-statistics
 npm install @tensorflow/tfjs-node
 ```
 
+For queue integrations that are lazy-loaded by the workers package:
+
+```bash
+npm install @zintrust/queue-redis
+npm install @zintrust/queue-monitor
+```
+
+These integrations are not auto-installed. `@zintrust/workers` will run without them and enable the related features only when they are present.
+
 ## Quick Start
 
 ### Basic Worker Creation

package/dist/AnomalyDetection.js

@@ -4,8 +4,8 @@
  * Sealed namespace for immutability
  */
 import { ErrorFactory, Logger, generateUuid } from '@zintrust/core';
-import { ResourceMonitor } from './ResourceMonitor';
-import { WorkerMetrics } from './WorkerMetrics';
+import { ResourceMonitor } from './ResourceMonitor.js';
+import { WorkerMetrics } from './WorkerMetrics.js';
 const configs = new Map();
 const models = new Map();
 const updateStats = (stats, value) => {

package/dist/BroadcastWorker.js

@@ -5,7 +5,7 @@
  * Use with Queue.dequeue() in a background process or cron job.
  */
 import { Broadcast } from '@zintrust/core';
-import { createQueueWorker } from './createQueueWorker';
+import { createQueueWorker } from './createQueueWorker.js';
 export const BroadcastWorker = Object.freeze({
     ...createQueueWorker({
         kindLabel: 'broadcast',

package/dist/CanaryController.js

@@ -4,7 +4,7 @@
  * Sealed namespace for immutability
  */
 import { ErrorFactory, Logger } from '@zintrust/core';
-import { CircuitBreaker } from './CircuitBreaker';
+import { CircuitBreaker } from './CircuitBreaker.js';
 // Internal state
 const canaryDeployments = new Map();
 const canaryTimers = new Map();

package/dist/ChaosEngineering.js

@@ -4,10 +4,10 @@
  * Sealed namespace for immutability
  */
 import { ErrorFactory, Logger, generateUuid } from '@zintrust/core';
-import { CircuitBreaker } from './CircuitBreaker';
-import { Observability } from './Observability';
-import { ResourceMonitor } from './ResourceMonitor';
-import { WorkerRegistry } from './WorkerRegistry';
+import { CircuitBreaker } from './CircuitBreaker.js';
+import { Observability } from './Observability.js';
+import { ResourceMonitor } from './ResourceMonitor.js';
+import { WorkerRegistry } from './WorkerRegistry.js';
 const experiments = new Map();
 const EXPERIMENT_RETENTION_MS = 24 * 60 * 60 * 1000;
 const cleanupExpiredExperiments = () => {

package/dist/DatacenterOrchestrator.js

@@ -4,7 +4,7 @@
  * Sealed namespace for immutability
  */
 import { ErrorFactory, Logger } from '@zintrust/core';
-import { ClusterLock } from './ClusterLock';
+import { ClusterLock } from './ClusterLock.js';
 // Internal state
 const regions = new Map();
 const workerPlacements = new Map();

package/dist/DeadLetterQueue.js

@@ -4,7 +4,7 @@
  * Sealed namespace for immutability
  */
 import { ErrorFactory, Logger, createRedisConnection } from '@zintrust/core';
-import { keyPrefix } from './config/workerConfig';
+import { keyPrefix } from './config/workerConfig.js';
 // Redis key prefixes - using workers package prefix system
 const getDLQPrefix = () => {
     return keyPrefix() + ':dlq:';

package/dist/HealthMonitor.js

@@ -1,5 +1,5 @@
 import { ErrorFactory, Logger } from '@zintrust/core';
-import { WorkerCreationStatus, WorkerFactory } from './WorkerFactory';
+import { WorkerCreationStatus, WorkerFactory } from './WorkerFactory.js';
 const DEFAULT_CONFIG = {
     enabled: true,
     tickIntervalMs: 1000,

package/dist/MultiQueueWorker.js

@@ -5,7 +5,7 @@
  */
 import { ErrorFactory, Logger } from '@zintrust/core';
 import { Worker } from 'bullmq';
-import { PriorityQueue } from './PriorityQueue';
+import { PriorityQueue } from './PriorityQueue.js';
 // Internal state
 const multiQueueWorkers = new Map();
 /**

package/dist/NotificationWorker.js

@@ -5,7 +5,7 @@
  * Use with Queue.dequeue() in a background process or cron job.
  */
 import { Notification } from '@zintrust/core';
-import { createQueueWorker } from './createQueueWorker';
+import { createQueueWorker } from './createQueueWorker.js';
 export const NotificationWorker = Object.freeze({
     ...createQueueWorker({
         kindLabel: 'notification',

package/dist/SLAMonitor.js

@@ -4,8 +4,8 @@
  * Sealed namespace for immutability
  */
 import { ErrorFactory, Logger, generateUuid } from '@zintrust/core';
-import { HealthMonitor } from './HealthMonitor';
-import { WorkerMetrics } from './WorkerMetrics';
+import { HealthMonitor } from './HealthMonitor.js';
+import { WorkerMetrics } from './WorkerMetrics.js';
 const slaConfigs = new Map();
 const violationHistory = new Map();
 const lastAlertAt = new Map();

package/dist/WorkerFactory.js

@@ -5,24 +5,24 @@
  */
 import { Cloudflare, createRedisConnection, databaseConfig, Env, ErrorFactory, generateUuid, getBullMQSafeQueueName, JobStateTracker, Logger, NodeSingletons, queueConfig, registerDatabasesFromRuntimeConfig, useEnsureDbConnected, workersConfig, ZintrustLang, } from '@zintrust/core';
 import { Worker } from 'bullmq';
-import { AutoScaler } from './AutoScaler';
-import { CanaryController } from './CanaryController';
-import { CircuitBreaker } from './CircuitBreaker';
-import { ClusterLock } from './ClusterLock';
-import { ComplianceManager } from './ComplianceManager';
-import { DatacenterOrchestrator } from './DatacenterOrchestrator';
-import { DeadLetterQueue } from './DeadLetterQueue';
-import { HealthMonitor } from './HealthMonitor';
-import { MultiQueueWorker } from './MultiQueueWorker';
-import { Observability } from './Observability';
-import { PluginManager } from './PluginManager';
-import { PriorityQueue } from './PriorityQueue';
-import { ResourceMonitor } from './ResourceMonitor';
-import { WorkerMetrics } from './WorkerMetrics';
-import { WorkerRegistry } from './WorkerRegistry';
-import { WorkerVersioning } from './WorkerVersioning';
-import { keyPrefix } from './config/workerConfig';
-import { DbWorkerStore, InMemoryWorkerStore, RedisWorkerStore, } from './storage/WorkerStore';
+import { AutoScaler } from './AutoScaler.js';
+import { CanaryController } from './CanaryController.js';
+import { CircuitBreaker } from './CircuitBreaker.js';
+import { ClusterLock } from './ClusterLock.js';
+import { ComplianceManager } from './ComplianceManager.js';
+import { DatacenterOrchestrator } from './DatacenterOrchestrator.js';
+import { DeadLetterQueue } from './DeadLetterQueue.js';
+import { HealthMonitor } from './HealthMonitor.js';
+import { MultiQueueWorker } from './MultiQueueWorker.js';
+import { Observability } from './Observability.js';
+import { PluginManager } from './PluginManager.js';
+import { PriorityQueue } from './PriorityQueue.js';
+import { ResourceMonitor } from './ResourceMonitor.js';
+import { WorkerMetrics } from './WorkerMetrics.js';
+import { WorkerRegistry } from './WorkerRegistry.js';
+import { WorkerVersioning } from './WorkerVersioning.js';
+import { keyPrefix } from './config/workerConfig.js';
+import { DbWorkerStore, InMemoryWorkerStore, RedisWorkerStore, } from './storage/WorkerStore.js';
 const path = NodeSingletons.path;
 const isNodeRuntime = () => typeof process !== 'undefined' && Boolean(process.versions?.node);
 const resolveProjectRoot = () => {

package/dist/WorkerInit.js

@@ -8,10 +8,10 @@
  * - Ensures graceful startup and shutdown
  */
 import { Env, Logger } from '@zintrust/core';
-import { ResourceMonitor } from './ResourceMonitor';
-import { WorkerFactory } from './WorkerFactory';
-import { WorkerShutdown } from './WorkerShutdown';
-import { keyPrefix } from './config/workerConfig';
+import { ResourceMonitor } from './ResourceMonitor.js';
+import { WorkerFactory } from './WorkerFactory.js';
+import { WorkerShutdown } from './WorkerShutdown.js';
+import { keyPrefix } from './config/workerConfig.js';
 // ============================================================================
 // State
 // ============================================================================

package/dist/WorkerRegistry.js

@@ -4,7 +4,7 @@
  * Sealed namespace for immutability
  */
 import { ErrorFactory, Logger } from '@zintrust/core';
-import { AnomalyDetection } from './AnomalyDetection';
+import { AnomalyDetection } from './AnomalyDetection.js';
 // Internal storage
 const workers = new Map();
 const registrations = new Map();

package/dist/WorkerShutdown.js

@@ -5,7 +5,7 @@
  * Coordinates orderly shutdown of all worker modules and the WorkerFactory.
  */
 import { Logger } from '@zintrust/core';
-import { WorkerFactory } from './WorkerFactory';
+import { WorkerFactory } from './WorkerFactory.js';
 // ============================================================================
 // Implementation
 // ============================================================================

package/dist/WorkerShutdownDurableObject.d.ts

@@ -0,0 +1,12 @@
+type DurableObjectState = {
+    storage: {
+        get: (key: string) => Promise<unknown>;
+        put: (key: string, value: unknown) => Promise<void>;
+    };
+};
+export declare class ZinTrustWorkerShutdownDurableObject {
+    private readonly state;
+    constructor(state: DurableObjectState);
+    fetch(request: Request): Promise<Response>;
+}
+export {};

package/dist/WorkerShutdownDurableObject.js

@@ -0,0 +1,41 @@
+import { Logger } from '@zintrust/core';
+const loadState = async (state) => {
+    const stored = (await state.storage.get('shutdown'));
+    return stored ?? { shuttingDown: false };
+};
+const saveState = async (state, value) => {
+    await state.storage.put('shutdown', value);
+};
+// eslint-disable-next-line no-restricted-syntax
+export class ZinTrustWorkerShutdownDurableObject {
+    state;
+    constructor(state) {
+        this.state = state;
+    }
+    async fetch(request) {
+        const url = new URL(request.url);
+        const path = url.pathname;
+        if (request.method === 'GET' && path === '/status') {
+            const current = await loadState(this.state);
+            return new Response(JSON.stringify(current), {
+                status: 200,
+                headers: { 'content-type': 'application/json' },
+            });
+        }
+        if (request.method === 'POST' && path === '/shutdown') {
+            const payload = (await request.json().catch(() => ({})));
+            const next = {
+                shuttingDown: true,
+                startedAt: new Date().toISOString(),
+                reason: payload.reason ?? 'manual',
+            };
+            await saveState(this.state, next);
+            Logger.info('Worker shutdown requested via Durable Object', next);
+            return new Response(JSON.stringify({ ok: true }), {
+                status: 202,
+                headers: { 'content-type': 'application/json' },
+            });
+        }
+        return new Response('Not Found', { status: 404 });
+    }
+}