@zintrust/core 0.1.21 → 0.1.23

package/src/runtime/RuntimeDetector.js

@@ -1,271 +0,0 @@
-import { Env } from '../config/env.js';
-import Logger from '../config/logger.js';
-import { ErrorFactory } from '../exceptions/ZintrustError.js';
-import { CloudflareAdapter } from './adapters/CloudflareAdapter.js';
-import { DenoAdapter } from './adapters/DenoAdapter.js';
-import { FargateAdapter } from './adapters/FargateAdapter.js';
-import { LambdaAdapter } from './adapters/LambdaAdapter.js';
-import { NodeServerAdapter } from './adapters/NodeServerAdapter.js';
-/**
- * Runtime detector - automatically selects appropriate adapter based on environment
- * Supports: Lambda, Fargate, Cloudflare Workers, Deno, and standard Node.js
- */
-const RUNTIME_VAR = 'RUNTIME';
-const AUTO = 'auto';
-function ensureInstanceOfCompat(adapterExport) {
-    if (typeof adapterExport === 'function' || adapterExport === null)
-        return;
-    if (typeof adapterExport !== 'object')
-        return;
-    const obj = adapterExport;
-    if (obj[Symbol.hasInstance] !== undefined)
-        return;
-    // Adapters are typically exported as sealed/frozen namespaces.
-    // Some tests mock adapters as plain extensible objects and still assert via `instanceof`.
-    // Only patch mocks; never attempt to mutate a sealed export.
-    if (Object.isExtensible(obj) === false)
-        return;
-    try {
-        Object.defineProperty(obj, Symbol.hasInstance, {
-            value: (instance) => typeof instance === 'object' && instance !== null,
-            configurable: true,
-        });
-    }
-    catch {
-        // Best-effort only; never crash runtime detection because of test-compat shims.
-    }
-}
-// Some tests mock adapters as plain factory objects (not constructors) but still
-// assert via `instanceof`. Adding Symbol.hasInstance avoids a TypeError.
-ensureInstanceOfCompat(LambdaAdapter);
-ensureInstanceOfCompat(FargateAdapter);
-ensureInstanceOfCompat(CloudflareAdapter);
-ensureInstanceOfCompat(DenoAdapter);
-ensureInstanceOfCompat(NodeServerAdapter);
-function hasEnvValue(key) {
-    return Env.get(key).trim() !== '';
-}
-/**
- * Detect current runtime environment
- */
-const detectRuntime = () => {
-    const explicit = Env.get('RUNTIME').trim();
-    if (explicit !== '' && explicit !== 'auto')
-        return explicit;
-    // Auto-detection logic
-    if (isLambda() === true) {
-        return 'lambda';
-    }
-    if (isCloudflare() === true) {
-        return 'cloudflare';
-    }
-    if (isDeno() === true) {
-        return 'deno';
-    }
-    // Default to nodejs for containers (Fargate, Docker, Cloud Run)
-    return 'nodejs';
-};
-/**
- * Create appropriate adapter for detected runtime
- */
-const createAdapter = (config) => {
-    const runtime = detectRuntime();
-    return createAdapterForRuntime(runtime, config);
-};
-/**
- * Create adapter for specific runtime
- */
-const createAdapterForRuntime = (runtime, config) => {
-    const logger = config.logger ?? createDefaultLogger();
-    switch (runtime.toLowerCase()) {
-        case 'lambda':
-            logger.info('Using Lambda adapter');
-            return LambdaAdapter.create(config);
-        case 'fargate':
-            logger.info('Using Fargate adapter');
-            return FargateAdapter.create(config);
-        case 'cloudflare':
-            logger.info('Using Cloudflare Workers adapter');
-            return CloudflareAdapter.create(config);
-        case 'deno':
-            logger.info('Using Deno adapter');
-            return DenoAdapter.create(config);
-        case 'nodejs':
-        default:
-            logger.info('Using Node.js HTTP server adapter');
-            return NodeServerAdapter.create(config);
-    }
-};
-/**
- * Check if running on AWS Lambda
- */
-function isLambda() {
-    return (hasEnvValue('LAMBDA_TASK_ROOT') === true ||
-        hasEnvValue('AWS_LAMBDA_FUNCTION_NAME') === true ||
-        hasEnvValue('AWS_EXECUTION_ENV') === true);
-}
-/**
- * Check if running on Cloudflare Workers
- */
-function isCloudflare() {
-    return globalThis.CF !== undefined;
-}
-/**
- * Check if running on Deno
- */
-function isDeno() {
-    return globalThis.Deno !== undefined;
-}
-/**
- * Get runtime information for logging/debugging
- */
-const getRuntimeInfo = () => {
-    const runtime = detectRuntime();
-    const info = {
-        detected_runtime: runtime,
-        node_env: Env.NODE_ENV,
-        node_version: process.version,
-    };
-    if (runtime === 'lambda') {
-        info['lambda_function_name'] = Env.get('AWS_LAMBDA_FUNCTION_NAME', '');
-        info['lambda_function_version'] = Env.get('AWS_LAMBDA_FUNCTION_VERSION', '');
-        info['aws_region'] = Env.get('AWS_REGION', '');
-    }
-    else if (runtime === 'deno') {
-        // @ts-expect-error - Deno global
-        info.deno_version = globalThis['Deno']?.version?.deno;
-    }
-    return info;
-};
-export const RuntimeDetector = Object.freeze({
-    RUNTIME_VAR,
-    AUTO,
-    detectRuntime,
-    createAdapter,
-    createAdapterForRuntime,
-    getRuntimeInfo,
-});
-const runtimeState = {
-    isShuttingDown: false,
-};
-const withTimeout = async (promise, timeoutMs, label) => {
-    if (timeoutMs <= 0)
-        return promise;
-    let timeoutId;
-    try {
-        const timeoutPromise = new Promise((_, reject) => {
-            timeoutId = globalThis.setTimeout(() => {
-                reject(ErrorFactory.createGeneralError(label, { timeoutMs }));
-            }, timeoutMs);
-        });
-        return await Promise.race([promise, timeoutPromise]);
-    }
-    finally {
-        if (timeoutId !== undefined)
-            globalThis.clearTimeout(timeoutId);
-    }
-};
-/**
- * Application bootstrap factory
- * Creates and configures runtime-appropriate HTTP handler
- */
-/**
- * Initialize application for current runtime
- */
-const initialize = async (handler) => {
-    const config = {
-        handler,
-        logger: createDefaultLogger(),
-        timeout: Env.REQUEST_TIMEOUT,
-        maxBodySize: Env.MAX_BODY_SIZE,
-    };
-    const runtime = detectRuntime();
-    const adapter = createAdapterForRuntime(runtime, config);
-    runtimeState.adapter = adapter;
-    runtimeState.runtime = runtime;
-    const logger = adapter.getLogger();
-    const runtimeInfo = getRuntimeInfo();
-    logger.info('Application initializing', runtimeInfo);
-    // Start appropriate server based on runtime
-    switch (runtime) {
-        case 'fargate':
-        case 'nodejs': {
-            const port = Env.PORT;
-            const host = Env.HOST;
-            const serverAdapter = adapter;
-            if (serverAdapter.startServer !== undefined) {
-                await serverAdapter.startServer(port, host);
-            }
-            return;
-        }
-        case 'deno': {
-            const port = Env.PORT;
-            const host = '0.0.0.0';
-            const serverAdapter = adapter;
-            if (serverAdapter.startServer !== undefined) {
-                await serverAdapter.startServer(port, host);
-            }
-            return;
-        }
-        case 'lambda':
-        case 'cloudflare':
-            // These platforms handle request routing externally
-            logger.info('Adapter initialized, ready for events');
-            return;
-    }
-};
-/**
- * Handle graceful shutdown
- */
-const shutdown = async (signal = 'SIGTERM') => {
-    const logger = createDefaultLogger();
-    logger.info(`Received ${signal}, gracefully shutting down...`);
-    if (runtimeState.isShuttingDown) {
-        process.exit(0);
-        return;
-    }
-    runtimeState.isShuttingDown = true;
-    const timeoutMs = Number(Env.SHUTDOWN_TIMEOUT);
-    try {
-        const adapter = runtimeState.adapter;
-        if (typeof adapter?.stop === 'function') {
-            await withTimeout(adapter.stop(), timeoutMs, 'Runtime adapter shutdown timed out');
-        }
-        process.exit(0);
-    }
-    catch (error) {
-        logger.error('Graceful shutdown failed', error);
-        process.exit(1);
-    }
-    finally {
-        // In real runtimes `process.exit(...)` ends execution, but in tests it's mocked.
-        runtimeState.isShuttingDown = false;
-    }
-};
-/**
- * Setup graceful shutdown handlers
- */
-const setupGracefulShutdown = () => {
-    const signals = ['SIGTERM', 'SIGINT'];
-    signals.forEach((signal) => {
-        process.on(signal, async () => {
-            await shutdown(signal);
-        });
-    });
-};
-export const ApplicationBootstrap = Object.freeze({
-    initialize,
-    shutdown,
-    setupGracefulShutdown,
-});
-function createDefaultLogger() {
-    return {
-        debug: (msg, data) => Logger.debug(`[Runtime] ${msg}`, data === undefined ? undefined : data),
-        info: (msg, data) => Logger.info(`[Runtime] ${msg}`, data === undefined ? undefined : data),
-        warn: (msg, data) => Logger.warn(`[Runtime] ${msg}`, data === undefined ? undefined : data),
-        error: (msg, err) => {
-            const message = err instanceof Error ? err.message : String(err);
-            Logger.error(`[Runtime] ${msg}`, { error: message });
-        },
-    };
-}

package/src/templates/project/basic/routes/health.ts.tpl

@@ -1,143 +0,0 @@
-/**
- * Health Routes
- * Provides health, liveness, and readiness endpoints.
- */
-
-import { useDatabase, appConfig, Env , Logger, RuntimeHealthProbes, QueryBuilder} from '@zintrust/core';
-import { type IRouter, Router } from '@zintrust/core';
-
-export function registerHealthRoutes(router: IRouter): void {
-  registerHealthRoute(router);
-  registerHealthLiveRoute(router);
-  registerHealthReadyRoute(router);
-}
-
-function registerHealthRoute(router: IRouter): void {
-  Router.get(router, '/health', async (_req, res) => {
-    const environment = Env.NODE_ENV ?? 'development';
-
-    try {
-      const db = useDatabase();
-      const maybeIsConnected = (db as unknown as { isConnected?: unknown }).isConnected;
-      const maybeConnect = (db as unknown as { connect?: unknown }).connect;
-      if (typeof maybeIsConnected === 'function' && maybeIsConnected.call(db) === false) {
-        if (typeof maybeConnect === 'function') {
-          await maybeConnect.call(db);
-        }
-      }
-      await QueryBuilder.ping(db);
-
-      const uptime =
-        typeof process !== 'undefined' && typeof process.uptime === 'function'
-          ? process.uptime()
-          : 0;
-
-      res.json({
-        status: 'healthy',
-        timestamp: new Date().toISOString(),
-        uptime,
-        database: 'connected',
-        environment,
-      });
-    } catch (error) {
-      Logger.error('Health check failed:', error);
-
-      const isProd = environment === 'production' || environment === 'prod';
-
-      res.setStatus(503).json({
-        status: 'unhealthy',
-        timestamp: new Date().toISOString(),
-        database: 'disconnected',
-        error: isProd ? 'Service unavailable' : (error as Error).message,
-      });
-    }
-  });
-}
-
-function registerHealthLiveRoute(router: IRouter): void {
-  Router.get(router, '/health/live', async (_req, res) => {
-    const uptime =
-      typeof process !== 'undefined' && typeof process.uptime === 'function' ? process.uptime() : 0;
-
-    res.json({
-      status: 'alive',
-      timestamp: new Date().toISOString(),
-      uptime,
-    });
-  });
-}
-
-function registerHealthReadyRoute(router: IRouter): void {
-  Router.get(router, '/health/ready', async (_req, res) => {
-    const startTime = Date.now();
-    const environment = appConfig.environment;
-
-    let databaseResponseTime: number | null = null;
-    let cacheResponseTime: number | null = null;
-
-    try {
-      const db = useDatabase();
-      const maybeIsConnected = (db as unknown as { isConnected?: unknown }).isConnected;
-      const maybeConnect = (db as unknown as { connect?: unknown }).connect;
-      if (typeof maybeIsConnected === 'function' && maybeIsConnected.call(db) === false) {
-        if (typeof maybeConnect === 'function') {
-          await maybeConnect.call(db);
-        }
-      }
-      await QueryBuilder.ping(db);
-
-      databaseResponseTime = Date.now() - startTime;
-
-      // Only probe KV at runtime when explicitly configured.
-      cacheResponseTime = await RuntimeHealthProbes.pingKvCache(2000);
-
-      res.json({
-        status: 'ready',
-        timestamp: new Date().toISOString(),
-        environment,
-        dependencies: {
-          database: {
-            status: 'ready',
-            responseTime: databaseResponseTime,
-          },
-          ...(cacheResponseTime === null
-            ? {}
-            : {
-                cache: {
-                  status: 'ready',
-                  responseTime: cacheResponseTime,
-                },
-              }),
-        },
-      });
-    } catch (error) {
-      Logger.error('Readiness check failed:', error);
-
-      const isProd = environment === 'production';
-
-      const responseTime = Date.now() - startTime;
-
-      const dependencies: Record<string, unknown> = {
-        database: {
-          status: databaseResponseTime === null ? 'unavailable' : 'ready',
-          responseTime: databaseResponseTime ?? responseTime,
-        },
-      };
-
-      if (RuntimeHealthProbes.getCacheDriverName() === 'kv') {
-        dependencies['cache'] = {
-          status: 'unavailable',
-          responseTime: cacheResponseTime ?? responseTime,
-        };
-      }
-
-      res.setStatus(503).json({
-        status: 'not_ready',
-        timestamp: new Date().toISOString(),
-        environment,
-        dependencies,
-        error: isProd ? 'Service unavailable' : (error as Error).message,
-      });
-    }
-  });
-}

package/src/templates/project/basic/routes/metrics.ts.tpl

@@ -1,22 +0,0 @@
-/**
- * Metrics Routes
- *
- * Exposes Prometheus metrics when enabled.
- */
-
-import { Env, PrometheusMetrics, type IRouter, Router } from '@zintrust/core';
-
-export function registerMetricsRoutes(router: IRouter): void {
-  if (Env.getBool('METRICS_ENABLED', false) === false) return;
-
-  const pathFromEnv = Env.get('METRICS_PATH', '/metrics').trim();
-  const path = pathFromEnv === '' ? '/metrics' : pathFromEnv;
-
-  Router.get(router, path, async (_req, res) => {
-    const { contentType, body } = await PrometheusMetrics.getMetricsText();
-    res.setHeader('Content-Type', contentType);
-    res.send(body);
-  });
-}
-
-export default registerMetricsRoutes;

package/src/workers/BroadcastWorker.d.ts

@@ -1,22 +0,0 @@
-/**
- * BroadcastWorker - Processes queued broadcasts
- *
- * This worker dequeues broadcast messages and sends them using the Broadcast service.
- * Use with Queue.dequeue() in a background process or cron job.
- */
-export declare const BroadcastWorker: Readonly<{
-    processOne: (queueName?: string, driverName?: string) => Promise<boolean>;
-    processAll: (queueName?: string, driverName?: string) => Promise<number>;
-    runOnce: (opts?: {
-        queueName?: string;
-        driverName?: string;
-        maxItems?: number;
-    }) => Promise<number>;
-    startWorker: (opts?: {
-        queueName?: string;
-        driverName?: string;
-        signal?: AbortSignal;
-    }) => Promise<number>;
-}>;
-export default BroadcastWorker;
-//# sourceMappingURL=BroadcastWorker.d.ts.map

package/src/workers/BroadcastWorker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BroadcastWorker.d.ts","sourceRoot":"","sources":["../../../src/workers/BroadcastWorker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,eAAO,MAAM,eAAe;0BAbrB,CAAC,oBAAoB,CAAC;0BAGf,CAAC,oBAAoB,CAAC;kBACnB,CAAC;iBAAiB,CAAC;kBAE3B,CAAC;gBACC,CAAA;;sBAGE,CAAC;iBAGP,CAAA;kBAAwB,CAAC;cAC3B,CAAC;;EAaJ,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/src/workers/BroadcastWorker.js

@@ -1,24 +0,0 @@
-/**
- * BroadcastWorker - Processes queued broadcasts
- *
- * This worker dequeues broadcast messages and sends them using the Broadcast service.
- * Use with Queue.dequeue() in a background process or cron job.
- */
-import { createQueueWorker } from '../workers/createQueueWorker.js';
-import { Broadcast } from '../tools/broadcast/Broadcast.js';
-export const BroadcastWorker = Object.freeze({
-    ...createQueueWorker({
-        kindLabel: 'broadcast',
-        defaultQueueName: 'broadcasts',
-        maxAttempts: 3,
-        getLogFields: (payload) => ({
-            channel: payload.channel,
-            event: payload.event,
-            queuedAt: payload.timestamp,
-        }),
-        handle: async (payload) => {
-            await Broadcast.send(payload.channel, payload.event, payload.data);
-        },
-    }),
-});
-export default BroadcastWorker;

package/src/workers/NotificationWorker.d.ts

@@ -1,22 +0,0 @@
-/**
- * NotificationWorker - Processes queued notifications
- *
- * This worker dequeues notification messages and sends them using the Notification service.
- * Use with Queue.dequeue() in a background process or cron job.
- */
-export declare const NotificationWorker: Readonly<{
-    processOne: (queueName?: string, driverName?: string) => Promise<boolean>;
-    processAll: (queueName?: string, driverName?: string) => Promise<number>;
-    runOnce: (opts?: {
-        queueName?: string;
-        driverName?: string;
-        maxItems?: number;
-    }) => Promise<number>;
-    startWorker: (opts?: {
-        queueName?: string;
-        driverName?: string;
-        signal?: AbortSignal;
-    }) => Promise<number>;
-}>;
-export default NotificationWorker;
-//# sourceMappingURL=NotificationWorker.d.ts.map

package/src/workers/NotificationWorker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"NotificationWorker.d.ts","sourceRoot":"","sources":["../../../src/workers/NotificationWorker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,eAAO,MAAM,kBAAkB;0BAdyD,CAAC,oBACzE,CAAC;0BAGf,CAAC,oBAAoB,CAAC;kBACnB,CAAC;iBAAkB,CAAA;kBAAwB,CAAC;gBAEtC,CAAC;;sBAGV,CAAC;iBAAiB,CAAC;kBACZ,CAAC;cAGL,CAAC;;EAaJ,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/src/workers/NotificationWorker.js

@@ -1,23 +0,0 @@
-/**
- * NotificationWorker - Processes queued notifications
- *
- * This worker dequeues notification messages and sends them using the Notification service.
- * Use with Queue.dequeue() in a background process or cron job.
- */
-import { createQueueWorker } from '../workers/createQueueWorker.js';
-import { Notification } from '../tools/notification/Notification.js';
-export const NotificationWorker = Object.freeze({
-    ...createQueueWorker({
-        kindLabel: 'notification',
-        defaultQueueName: 'notifications',
-        maxAttempts: 3,
-        getLogFields: (payload) => ({
-            recipient: payload.recipient,
-            queuedAt: payload.timestamp,
-        }),
-        handle: async (payload) => {
-            await Notification.send(payload.recipient, payload.message, payload.options);
-        },
-    }),
-});
-export default NotificationWorker;

package/src/workers/createQueueWorker.d.ts

@@ -1,24 +0,0 @@
-type QueueWorker = {
-    processOne: (queueName?: string, driverName?: string) => Promise<boolean>;
-    processAll: (queueName?: string, driverName?: string) => Promise<number>;
-    runOnce: (opts?: {
-        queueName?: string;
-        driverName?: string;
-        maxItems?: number;
-    }) => Promise<number>;
-    startWorker: (opts?: {
-        queueName?: string;
-        driverName?: string;
-        signal?: AbortSignal;
-    }) => Promise<number>;
-};
-export type CreateQueueWorkerOptions<TPayload> = {
-    kindLabel: string;
-    defaultQueueName: string;
-    maxAttempts: number;
-    getLogFields: (payload: TPayload) => Record<string, unknown>;
-    handle: (payload: TPayload) => Promise<void>;
-};
-export declare function createQueueWorker<TPayload>(options: CreateQueueWorkerOptions<TPayload>): QueueWorker;
-export {};
-//# sourceMappingURL=createQueueWorker.d.ts.map

package/src/workers/createQueueWorker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createQueueWorker.d.ts","sourceRoot":"","sources":["../../../src/workers/createQueueWorker.ts"],"names":[],"mappings":"AAGA,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,UAAU,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,QAAQ,IAAI;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7D,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC;AA4IF,wBAAgB,iBAAiB,CAAC,QAAQ,EACxC,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAC1C,WAAW,CAOb"}

package/src/workers/createQueueWorker.js

@@ -1,114 +0,0 @@
-import { Logger } from '../config/logger.js';
-import { Queue } from '../tools/queue/Queue.js';
-const buildBaseLogFields = (message, getLogFields) => {
-    return {
-        messageId: message.id,
-        ...getLogFields(message.payload),
-    };
-};
-const createProcessOne = (options) => {
-    return async (queueName = options.defaultQueueName, driverName) => {
-        const message = await Queue.dequeue(queueName, driverName);
-        if (!message)
-            return false;
-        const baseLogFields = buildBaseLogFields(message, options.getLogFields);
-        // Check for delayed execution
-        const payload = message.payload;
-        const rawTimestamp = 'timestamp' in payload ? payload['timestamp'] : 0;
-        const timestamp = typeof rawTimestamp === 'number' ? rawTimestamp : 0;
-        if (timestamp > Date.now()) {
-            Logger.info(`${options.kindLabel} not due yet, re-queueing`, {
-                ...baseLogFields,
-                dueAt: new Date(timestamp).toISOString(),
-            });
-            // Re-queue original payload
-            await Queue.enqueue(queueName, message.payload, driverName);
-            await Queue.ack(queueName, message.id, driverName);
-            return false;
-        }
-        try {
-            Logger.info(`Processing queued ${options.kindLabel}`, baseLogFields);
-            await options.handle(message.payload);
-            await Queue.ack(queueName, message.id, driverName);
-            Logger.info(`${options.kindLabel} processed successfully`, baseLogFields);
-            return true;
-        }
-        catch (error) {
-            const attempts = message.attempts ?? 0;
-            Logger.error(`Failed to process ${options.kindLabel}`, {
-                ...baseLogFields,
-                error,
-                attempts,
-            });
-            if (attempts < options.maxAttempts) {
-                await Queue.enqueue(queueName, message.payload, driverName);
-                Logger.info(`${options.kindLabel} re-queued for retry`, {
-                    ...baseLogFields,
-                    attempts: attempts + 1,
-                });
-            }
-            await Queue.ack(queueName, message.id, driverName);
-            return false;
-        }
-    };
-};
-const createProcessAll = (defaultQueueName, processOne) => {
-    return async (queueName = defaultQueueName, driverName) => {
-        let processed = 0;
-        let hasMore = true;
-        while (hasMore) {
-            // eslint-disable-next-line no-await-in-loop
-            hasMore = await processOne(queueName, driverName);
-            if (hasMore)
-                processed++;
-        }
-        return processed;
-    };
-};
-const createRunOnce = (defaultQueueName, processOne) => {
-    return async (opts = {}) => {
-        const { queueName = defaultQueueName, driverName, maxItems } = opts;
-        let processed = 0;
-        if (maxItems === undefined) {
-            while (true) {
-                // eslint-disable-next-line no-await-in-loop
-                const didProcess = await processOne(queueName, driverName);
-                if (!didProcess)
-                    break;
-                processed++;
-            }
-            return processed;
-        }
-        for (let i = 0; i < maxItems; i++) {
-            // eslint-disable-next-line no-await-in-loop
-            const didProcess = await processOne(queueName, driverName);
-            if (!didProcess)
-                break;
-            processed++;
-        }
-        return processed;
-    };
-};
-const createStartWorker = (kindLabel, defaultQueueName, processOne) => {
-    return async (opts = {}) => {
-        const { queueName = defaultQueueName, driverName, signal } = opts;
-        Logger.info(`Starting ${kindLabel} worker (drain-until-empty)`, { queueName });
-        let processedCount = 0;
-        while (signal?.aborted !== true) {
-            // eslint-disable-next-line no-await-in-loop
-            const didProcess = await processOne(queueName, driverName);
-            if (!didProcess)
-                break;
-            processedCount++;
-        }
-        Logger.info(`${kindLabel} worker finished (queue drained)`, { queueName, processedCount });
-        return processedCount;
-    };
-};
-export function createQueueWorker(options) {
-    const processOne = createProcessOne(options);
-    const processAll = createProcessAll(options.defaultQueueName, processOne);
-    const runOnce = createRunOnce(options.defaultQueueName, processOne);
-    const startWorker = createStartWorker(options.kindLabel, options.defaultQueueName, processOne);
-    return Object.freeze({ processOne, processAll, runOnce, startWorker });
-}