npm - @wildo-ai/saas-backend-lib - Versions diffs - 1.1.1 → 1.1.3 - Mend

@wildo-ai/saas-backend-lib 1.1.1 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (972) hide show

package/dist/esm/queue/queue-monitoring.backend.service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"queue-monitoring.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/queue/queue-monitoring.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAE7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAC/G,OAAO,EAAE,~~6BAA6B~~,EAAE,MAAM,~~6CAA6C~~,CAAC;~~AAC5F~~,OAAO,EACL,YAAY,EACZ,kBAAkB,EAElB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,qBACa,6BAA6B;IAStC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,~~eAAe~~;~~IAZlC~~,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjF,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,YAAY,CAAS;gBAIV,MAAM,EAAE,aAAa,EAErB,aAAa,EAAE,uBAAuB,EAEtC,~~eAAe~~,EAAE,~~6BAA6B~~;~~IAMjE~~;;OAEG;IACH,eAAe,CAAC,UAAU,GAAE,MAAc,GAAG,IAAI;IA2BjD;;OAEG;IACH,cAAc,IAAI,IAAI;IAStB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI3C;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI;IAK1E;;;OAGG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;~~IAwC~~/D;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAsErD~~;;OAEG~~;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsC3B;;OAEG;YACW,cAAc;IAmB5B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgB3B"}
1	+ {"version":3,"file":"queue-monitoring.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/queue/queue-monitoring.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAE7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAC/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EACL,YAAY,EACZ,kBAAkB,EAElB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,qBACa,6BAA6B;IAStC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAE9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAZ/B,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjF,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,YAAY,CAAS;gBAIV,MAAM,EAAE,aAAa,EAErB,aAAa,EAAE,uBAAuB,EAEtC,YAAY,EAAE,YAAY;IAM7C;;OAEG;IACH,eAAe,CAAC,UAAU,GAAE,MAAc,GAAG,IAAI;IA2BjD;;OAEG;IACH,cAAc,IAAI,IAAI;IAStB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI3C;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI;IAK1E;;;OAGG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA4C/D;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAsErD;;;;;;OAMG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAsC3B;;OAEG;YACW,cAAc;IAmB5B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgB3B"}

package/dist/esm/queue/queue-monitoring.backend.service.js CHANGED Viewed

@@ -21,21 +21,20 @@ import { SAAS_SERVICE_TYPES } from '../inject/models/service-types.js';
 import { LoggerService } from '../monitoring/logger/services/logger.service.js';
 import { describeCaughtError, projectCaughtErrorLogFields } from '../errors/utils/error-log-level-classification.backend.utils.js';
 import { AppConfigurationService } from '../config/services/app-configuration.backend.service.js';
-import { RabbitMQAdapterBackendService } from './adapters/rabbitmq-adapter.backend.service.js';
 import { QueueHealthStatus, } from '@wildo-ai/saas-models';
 let QueueMonitoringBackendService = class QueueMonitoringBackendService {
     logger;
     configService;
-    rabbitMQAdapter;
+    queueAdapter;
     logDebug;
     alertCallbacks = [];
     alertThresholds = new Map();
     monitoringInterval = null;
     isMonitoring = false;
-    constructor(logger, configService, rabbitMQAdapter) {
+    constructor(logger, configService, queueAdapter) {
         this.logger = logger;
         this.configService = configService;
-        this.rabbitMQAdapter = rabbitMQAdapter;
+        this.queueAdapter = queueAdapter;
         this.logDebug = this.logger.debugByType('QueueMonitoringBackendService');
         this.logger.setDebugTypeLogging('QueueMonitoringBackendService', false);
     }
@@ -95,20 +94,26 @@ let QueueMonitoringBackendService = class QueueMonitoringBackendService {
      * Also checks the corresponding dead letter queue if it exists.
      */
     async getQueueMetrics(queueName) {
-        const channel = this.rabbitMQAdapter.getChannel();
-        if (!channel) {
+        /*
+         * Asks the ADAPTER how deep the queue is, rather than reaching through it for an amqplib
+         * channel (#502). Behaviour is unchanged for RabbitMQ — `null` here is what a null channel
+         * produced before, and it still yields empty metrics — but the question is now one every
+         * adapter can answer about itself, so a broker-free runtime reports real numbers instead of
+         * being structurally unable to be monitored.
+         *
+         * Dead-letter depth stays unreported: on RabbitMQ `checkQueue` CLOSES the channel when the
+         * queue does not exist, and only specific DLQs exist (`operations.deadletter`, not the
+         * per-variant `operations.priority.deadletter`). That needs an explicit queue-name list, and it
+         * is unrelated to this change.
+         */
+        const pendingCount = await this.queueAdapter.getQueueDepth(queueName);
+        if (pendingCount === null) {
             return this.createEmptyMetrics(queueName);
         }
         try {
-            // Get queue info from RabbitMQ
-            const queueInfo = await channel.checkQueue(queueName);
-            // Note: Dead letter queue check is skipped because channel.checkQueue() closes the channel
-            // if the queue doesn't exist. Only specific DLQ queues exist (operations.deadletter, etc.),
-            // not per-variant (operations.priority.deadletter). DLQ monitoring should be done via
-            // explicit queue name list instead.
             return {
                 queueName,
-                pendingCount: queueInfo.messageCount,
+                pendingCount,
                 processingCount: 0, // Would need consumer tracking
                 deadLetterCount: 0, // Skipped - see note above
                 publishRatePerMinute: 0, // Would need historical tracking
@@ -195,10 +200,14 @@ let QueueMonitoringBackendService = class QueueMonitoringBackendService {
         };
     }
     /**
-     * Check if RabbitMQ connection is healthy.
+     * Whether the queue substrate this runtime uses is connected.
+     *
+     * Named `isRabbitMQHealthy` for its callers' sake and answered by whichever adapter is bound
+     * (#502) — an in-memory queue reports connected once `connect()` has run, which is the honest
+     * answer to "can this runtime enqueue work" regardless of what is behind it.
      */
     async isRabbitMQHealthy() {
-        return this.rabbitMQAdapter.isConnected();
+        return this.queueAdapter.isConnected();
     }
     /**
      * Evaluate queue health based on thresholds.
@@ -291,8 +300,7 @@ QueueMonitoringBackendService = __decorate([
     __param(1, inject(SAAS_SERVICE_TYPES.AppConfigService)),
     __param(2, inject(SAAS_SERVICE_TYPES.RabbitMQAdapterService)),
     __metadata("design:paramtypes", [LoggerService,
-        AppConfigurationService,
-        RabbitMQAdapterBackendService])
+        AppConfigurationService, Object])
 ], QueueMonitoringBackendService);
 export { QueueMonitoringBackendService };
 //# sourceMappingURL=queue-monitoring.backend.service.js.map

package/dist/esm/queue/queue-monitoring.backend.service.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"queue-monitoring.backend.service.js","sourceRoot":"","sources":["../../../../src/queue/queue-monitoring.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Queue Monitoring Backend Service\n \n Provides metrics, health checks, and alerting for the queue system.\n * Integrates with RabbitMQ for queue statistics and the job tracking system.\n /\n\nimport { injectable, inject } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { describeCaughtError, projectCaughtErrorLogFields } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { AppConfigurationService } from '~wildo-backend-lib/config/services/app-configuration.backend.service';\nimport { RabbitMQAdapterBackendService } from './adapters/rabbitmq-adapter.backend.service';\nimport {\n QueueMetrics,\n QueueHealthSummary,\n QueueHealthStatus,\n QueueAlertThreshold,\n} from '@wildo-ai/saas-models';\n\n/\n Alert callback type for queue monitoring.\n /\nexport type QueueAlertCallback = (\n alertType: string,\n queueName: string,\n details: Record<string, unknown>\n) => void \| Promise<void>;\n\n@injectable()\nexport class QueueMonitoringBackendService {\n protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n private alertCallbacks: QueueAlertCallback[] = [];\n private alertThresholds: Map<string, QueueAlertThreshold> = new Map();\n private monitoringInterval: NodeJS.Timeout \| null = null;\n private isMonitoring = false;\n\n constructor(\n @inject(SAAS_SERVICE_TYPES.Logger)\n private readonly logger: LoggerService,\n @inject(SAAS_SERVICE_TYPES.AppConfigService)\n private readonly configService: AppConfigurationService,\n @inject(SAAS_SERVICE_TYPES.RabbitMQAdapterService)\n private readonly rabbitMQAdapter: RabbitMQAdapterBackendService,\n ) {\n this.logDebug = this.logger.debugByType('QueueMonitoringBackendService');\n this.logger.setDebugTypeLogging('QueueMonitoringBackendService', false);\n }\n\n /\n Start monitoring queues at the specified interval.\n /\n startMonitoring(intervalMs: number = 30000): void {\n if (this.isMonitoring) {\n this.logger.warn('Queue monitoring is already running');\n return;\n }\n\n this.isMonitoring = true;\n this.logDebug('Starting queue monitoring', { intervalMs });\n\n this.monitoringInterval = setInterval(async () => {\n try {\n await this.checkAllQueues();\n } catch (error) {\n this.logger.error('Error during queue monitoring check', {\n ...projectCaughtErrorLogFields(error),\n });\n }\n }, intervalMs);\n\n // Initial check\n this.checkAllQueues().catch((error) => {\n this.logger.error('Error during initial queue monitoring check', {\n ...projectCaughtErrorLogFields(error),\n });\n });\n }\n\n /\n Stop monitoring queues.\n /\n stopMonitoring(): void {\n if (this.monitoringInterval) {\n clearInterval(this.monitoringInterval);\n this.monitoringInterval = null;\n }\n this.isMonitoring = false;\n this.logDebug('Queue monitoring stopped');\n }\n\n /\n Register an alert callback.\n /\n onAlert(callback: QueueAlertCallback): void {\n this.alertCallbacks.push(callback);\n }\n\n /\n Set alert thresholds for a queue.\n /\n setAlertThreshold(queueName: string, threshold: QueueAlertThreshold): void {\n this.alertThresholds.set(queueName, threshold);\n this.logDebug('Alert threshold set', { queueName, threshold });\n }\n\n /\n Get metrics for a specific queue.\n * Also checks the corresponding dead letter queue if it exists.\n /\n async getQueueMetrics(queueName: string): Promise<QueueMetrics> {\n const channel = this.rabbitMQAdapter.getChannel();\n\n if (!channel) {\n return this.createEmptyMetrics(queueName);\n }\n\n try {\n // Get queue info from RabbitMQ\n const queueInfo = await channel.checkQueue(queueName);\n\n // Note: Dead letter queue check is skipped because channel.checkQueue() closes the channel\n // if the queue doesn't exist. Only specific DLQ queues exist (operations.deadletter, etc.),\n // not per-variant (operations.priority.deadletter). DLQ monitoring should be done via\n // explicit queue name list instead.\n\n return {\n queueName,\n pendingCount: queueInfo.messageCount,\n processingCount: 0, // Would need consumer tracking\n deadLetterCount: 0, // Skipped - see note above\n publishRatePerMinute: 0, // Would need historical tracking\n consumeRatePerMinute: 0,\n avgProcessingTimeMs: 0,\n p95ProcessingTimeMs: 0,\n p99ProcessingTimeMs: 0,\n errorRate: 0,\n retryRate: 0,\n collectedAt: new Date(),\n };\n } catch (error) {\n // Queue might not exist yet\n this.logDebug('Could not get queue metrics', {\n queueName,\n error: describeCaughtError(error),\n });\n return this.createEmptyMetrics(queueName);\n }\n }\n\n /\n Get health summary for all monitored queues.\n /\n async getHealthSummary(): Promise<QueueHealthSummary> {\n const appId = this.configService.applicationId;\n // Mono-env: queue names are wildo.queue.{appId}.{category}[.{variant}]\n const queues = [\n `wildo.queue.${appId}.operations`,\n `wildo.queue.${appId}.operations.priority`,\n `wildo.queue.${appId}.scheduled`,\n `wildo.queue.${appId}.callbacks`,\n ];\n\n let overallStatus: QueueHealthStatus = QueueHealthStatus.HEALTHY;\n let healthyQueues = 0;\n let degradedQueues = 0;\n let unhealthyQueues = 0;\n const activeAlerts: Array<{\n queueName: string;\n alertType: string;\n value: number;\n threshold: number;\n triggeredAt: Date;\n }> = [];\n\n for (const queueName of queues) {\n const metrics = await this.getQueueMetrics(queueName);\n\n // Check thresholds\n const threshold = this.alertThresholds.get(queueName);\n if (threshold) {\n const status = this.evaluateQueueHealth(metrics, threshold);\n\n if (status === QueueHealthStatus.UNHEALTHY) {\n overallStatus = QueueHealthStatus.UNHEALTHY;\n unhealthyQueues++;\n activeAlerts.push({\n queueName,\n alertType: 'pending_count_exceeded',\n value: metrics.pendingCount,\n threshold: threshold.pendingCountThreshold ?? 0,\n triggeredAt: new Date(),\n });\n } else if (status === QueueHealthStatus.DEGRADED) {\n if (overallStatus === QueueHealthStatus.HEALTHY) {\n overallStatus = QueueHealthStatus.DEGRADED;\n }\n degradedQueues++;\n activeAlerts.push({\n queueName,\n alertType: 'queue_degraded',\n value: metrics.pendingCount,\n threshold: threshold.pendingCountThreshold ?? 0,\n triggeredAt: new Date(),\n });\n } else {\n healthyQueues++;\n }\n } else {\n healthyQueues++;\n }\n }\n\n return {\n status: overallStatus,\n healthyQueues,\n degradedQueues,\n unhealthyQueues,\n activeAlerts,\n checkedAt: new Date(),\n };\n }\n\n /\n Check if RabbitMQ connection is healthy.\n /\n async isRabbitMQHealthy(): Promise<boolean> {\n return this.rabbitMQAdapter.isConnected();\n }\n\n /\n Evaluate queue health based on thresholds.\n /\n private evaluateQueueHealth(\n metrics: QueueMetrics,\n threshold: QueueAlertThreshold\n ): QueueHealthStatus {\n // Check pending count threshold\n if (threshold.pendingCountThreshold !== undefined) {\n if (metrics.pendingCount >= threshold.pendingCountThreshold 2) {\n return QueueHealthStatus.UNHEALTHY;\n }\n if (metrics.pendingCount >= threshold.pendingCountThreshold) {\n return QueueHealthStatus.DEGRADED;\n }\n }\n\n // Check dead letter threshold\n if (threshold.deadLetterThreshold !== undefined) {\n if (metrics.deadLetterCount >= threshold.deadLetterThreshold) {\n return QueueHealthStatus.UNHEALTHY;\n }\n }\n\n // Check error rate threshold\n if (threshold.errorRateThreshold !== undefined) {\n if (metrics.errorRate >= threshold.errorRateThreshold) {\n return QueueHealthStatus.DEGRADED;\n }\n }\n\n // Check latency threshold\n if (threshold.latencyThresholdMs !== undefined) {\n if (metrics.p95ProcessingTimeMs >= threshold.latencyThresholdMs) {\n return QueueHealthStatus.DEGRADED;\n }\n }\n\n return QueueHealthStatus.HEALTHY;\n }\n\n /*\n Check all queues and trigger alerts if needed.\n /\n private async checkAllQueues(): Promise<void> {\n const summary = await this.getHealthSummary();\n\n if (summary.status !== QueueHealthStatus.HEALTHY) {\n for (const alert of summary.activeAlerts) {\n await this.triggerAlert(\n summary.status === QueueHealthStatus.UNHEALTHY ? 'critical' : 'warning',\n alert.queueName,\n {\n alertType: alert.alertType,\n value: alert.value,\n threshold: alert.threshold,\n summary,\n }\n );\n }\n }\n }\n\n /\n Trigger an alert to all registered callbacks.\n /\n private async triggerAlert(\n alertType: string,\n queueName: string,\n details: Record<string, unknown>\n ): Promise<void> {\n this.logger.warn('Queue alert triggered', { alertType, queueName, details });\n\n for (const callback of this.alertCallbacks) {\n try {\n await callback(alertType, queueName, details);\n } catch (error) {\n this.logger.error('Error in alert callback', {\n ...projectCaughtErrorLogFields(error),\n });\n }\n }\n }\n\n /\n Create empty metrics for a queue.\n */\n private createEmptyMetrics(queueName: string): QueueMetrics {\n return {\n queueName,\n pendingCount: 0,\n processingCount: 0,\n deadLetterCount: 0,\n publishRatePerMinute: 0,\n consumeRatePerMinute: 0,\n avgProcessingTimeMs: 0,\n p95ProcessingTimeMs: 0,\n p99ProcessingTimeMs: 0,\n errorRate: 0,\n retryRate: 0,\n collectedAt: new Date(),\n };\n }\n}\n"]}
1	+ {"version":3,"file":"queue-monitoring.backend.service.js","sourceRoot":"","sources":["../../../../src/queue/queue-monitoring.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Queue Monitoring Backend Service\n \n Provides metrics, health checks, and alerting for the queue system.\n * Integrates with RabbitMQ for queue statistics and the job tracking system.\n /\n\nimport { injectable, inject } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { describeCaughtError, projectCaughtErrorLogFields } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { AppConfigurationService } from '~wildo-backend-lib/config/services/app-configuration.backend.service';\nimport type { QueueAdapter } from './adapters/queue-adapter.backend.interface';\nimport {\n QueueMetrics,\n QueueHealthSummary,\n QueueHealthStatus,\n QueueAlertThreshold,\n} from '@wildo-ai/saas-models';\n\n/\n Alert callback type for queue monitoring.\n /\nexport type QueueAlertCallback = (\n alertType: string,\n queueName: string,\n details: Record<string, unknown>\n) => void \| Promise<void>;\n\n@injectable()\nexport class QueueMonitoringBackendService {\n protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n private alertCallbacks: QueueAlertCallback[] = [];\n private alertThresholds: Map<string, QueueAlertThreshold> = new Map();\n private monitoringInterval: NodeJS.Timeout \| null = null;\n private isMonitoring = false;\n\n constructor(\n @inject(SAAS_SERVICE_TYPES.Logger)\n private readonly logger: LoggerService,\n @inject(SAAS_SERVICE_TYPES.AppConfigService)\n private readonly configService: AppConfigurationService,\n @inject(SAAS_SERVICE_TYPES.RabbitMQAdapterService)\n private readonly queueAdapter: QueueAdapter,\n ) {\n this.logDebug = this.logger.debugByType('QueueMonitoringBackendService');\n this.logger.setDebugTypeLogging('QueueMonitoringBackendService', false);\n }\n\n /\n Start monitoring queues at the specified interval.\n /\n startMonitoring(intervalMs: number = 30000): void {\n if (this.isMonitoring) {\n this.logger.warn('Queue monitoring is already running');\n return;\n }\n\n this.isMonitoring = true;\n this.logDebug('Starting queue monitoring', { intervalMs });\n\n this.monitoringInterval = setInterval(async () => {\n try {\n await this.checkAllQueues();\n } catch (error) {\n this.logger.error('Error during queue monitoring check', {\n ...projectCaughtErrorLogFields(error),\n });\n }\n }, intervalMs);\n\n // Initial check\n this.checkAllQueues().catch((error) => {\n this.logger.error('Error during initial queue monitoring check', {\n ...projectCaughtErrorLogFields(error),\n });\n });\n }\n\n /\n Stop monitoring queues.\n /\n stopMonitoring(): void {\n if (this.monitoringInterval) {\n clearInterval(this.monitoringInterval);\n this.monitoringInterval = null;\n }\n this.isMonitoring = false;\n this.logDebug('Queue monitoring stopped');\n }\n\n /\n Register an alert callback.\n /\n onAlert(callback: QueueAlertCallback): void {\n this.alertCallbacks.push(callback);\n }\n\n /\n Set alert thresholds for a queue.\n /\n setAlertThreshold(queueName: string, threshold: QueueAlertThreshold): void {\n this.alertThresholds.set(queueName, threshold);\n this.logDebug('Alert threshold set', { queueName, threshold });\n }\n\n /\n Get metrics for a specific queue.\n * Also checks the corresponding dead letter queue if it exists.\n /\n async getQueueMetrics(queueName: string): Promise<QueueMetrics> {\n /\n * Asks the ADAPTER how deep the queue is, rather than reaching through it for an amqplib\n * channel (#502). Behaviour is unchanged for RabbitMQ — `null` here is what a null channel\n * produced before, and it still yields empty metrics — but the question is now one every\n * adapter can answer about itself, so a broker-free runtime reports real numbers instead of\n * being structurally unable to be monitored.\n \n Dead-letter depth stays unreported: on RabbitMQ `checkQueue` CLOSES the channel when the\n * queue does not exist, and only specific DLQs exist (`operations.deadletter`, not the\n * per-variant `operations.priority.deadletter`). That needs an explicit queue-name list, and it\n * is unrelated to this change.\n /\n const pendingCount = await this.queueAdapter.getQueueDepth(queueName);\n\n if (pendingCount === null) {\n return this.createEmptyMetrics(queueName);\n }\n\n try {\n return {\n queueName,\n pendingCount,\n processingCount: 0, // Would need consumer tracking\n deadLetterCount: 0, // Skipped - see note above\n publishRatePerMinute: 0, // Would need historical tracking\n consumeRatePerMinute: 0,\n avgProcessingTimeMs: 0,\n p95ProcessingTimeMs: 0,\n p99ProcessingTimeMs: 0,\n errorRate: 0,\n retryRate: 0,\n collectedAt: new Date(),\n };\n } catch (error) {\n // Queue might not exist yet\n this.logDebug('Could not get queue metrics', {\n queueName,\n error: describeCaughtError(error),\n });\n return this.createEmptyMetrics(queueName);\n }\n }\n\n /\n Get health summary for all monitored queues.\n /\n async getHealthSummary(): Promise<QueueHealthSummary> {\n const appId = this.configService.applicationId;\n // Mono-env: queue names are wildo.queue.{appId}.{category}[.{variant}]\n const queues = [\n `wildo.queue.${appId}.operations`,\n `wildo.queue.${appId}.operations.priority`,\n `wildo.queue.${appId}.scheduled`,\n `wildo.queue.${appId}.callbacks`,\n ];\n\n let overallStatus: QueueHealthStatus = QueueHealthStatus.HEALTHY;\n let healthyQueues = 0;\n let degradedQueues = 0;\n let unhealthyQueues = 0;\n const activeAlerts: Array<{\n queueName: string;\n alertType: string;\n value: number;\n threshold: number;\n triggeredAt: Date;\n }> = [];\n\n for (const queueName of queues) {\n const metrics = await this.getQueueMetrics(queueName);\n\n // Check thresholds\n const threshold = this.alertThresholds.get(queueName);\n if (threshold) {\n const status = this.evaluateQueueHealth(metrics, threshold);\n\n if (status === QueueHealthStatus.UNHEALTHY) {\n overallStatus = QueueHealthStatus.UNHEALTHY;\n unhealthyQueues++;\n activeAlerts.push({\n queueName,\n alertType: 'pending_count_exceeded',\n value: metrics.pendingCount,\n threshold: threshold.pendingCountThreshold ?? 0,\n triggeredAt: new Date(),\n });\n } else if (status === QueueHealthStatus.DEGRADED) {\n if (overallStatus === QueueHealthStatus.HEALTHY) {\n overallStatus = QueueHealthStatus.DEGRADED;\n }\n degradedQueues++;\n activeAlerts.push({\n queueName,\n alertType: 'queue_degraded',\n value: metrics.pendingCount,\n threshold: threshold.pendingCountThreshold ?? 0,\n triggeredAt: new Date(),\n });\n } else {\n healthyQueues++;\n }\n } else {\n healthyQueues++;\n }\n }\n\n return {\n status: overallStatus,\n healthyQueues,\n degradedQueues,\n unhealthyQueues,\n activeAlerts,\n checkedAt: new Date(),\n };\n }\n\n /\n Whether the queue substrate this runtime uses is connected.\n \n Named `isRabbitMQHealthy` for its callers' sake and answered by whichever adapter is bound\n * (#502) — an in-memory queue reports connected once `connect()` has run, which is the honest\n * answer to \"can this runtime enqueue work\" regardless of what is behind it.\n /\n async isRabbitMQHealthy(): Promise<boolean> {\n return this.queueAdapter.isConnected();\n }\n\n /\n Evaluate queue health based on thresholds.\n /\n private evaluateQueueHealth(\n metrics: QueueMetrics,\n threshold: QueueAlertThreshold\n ): QueueHealthStatus {\n // Check pending count threshold\n if (threshold.pendingCountThreshold !== undefined) {\n if (metrics.pendingCount >= threshold.pendingCountThreshold 2) {\n return QueueHealthStatus.UNHEALTHY;\n }\n if (metrics.pendingCount >= threshold.pendingCountThreshold) {\n return QueueHealthStatus.DEGRADED;\n }\n }\n\n // Check dead letter threshold\n if (threshold.deadLetterThreshold !== undefined) {\n if (metrics.deadLetterCount >= threshold.deadLetterThreshold) {\n return QueueHealthStatus.UNHEALTHY;\n }\n }\n\n // Check error rate threshold\n if (threshold.errorRateThreshold !== undefined) {\n if (metrics.errorRate >= threshold.errorRateThreshold) {\n return QueueHealthStatus.DEGRADED;\n }\n }\n\n // Check latency threshold\n if (threshold.latencyThresholdMs !== undefined) {\n if (metrics.p95ProcessingTimeMs >= threshold.latencyThresholdMs) {\n return QueueHealthStatus.DEGRADED;\n }\n }\n\n return QueueHealthStatus.HEALTHY;\n }\n\n /*\n Check all queues and trigger alerts if needed.\n /\n private async checkAllQueues(): Promise<void> {\n const summary = await this.getHealthSummary();\n\n if (summary.status !== QueueHealthStatus.HEALTHY) {\n for (const alert of summary.activeAlerts) {\n await this.triggerAlert(\n summary.status === QueueHealthStatus.UNHEALTHY ? 'critical' : 'warning',\n alert.queueName,\n {\n alertType: alert.alertType,\n value: alert.value,\n threshold: alert.threshold,\n summary,\n }\n );\n }\n }\n }\n\n /\n Trigger an alert to all registered callbacks.\n /\n private async triggerAlert(\n alertType: string,\n queueName: string,\n details: Record<string, unknown>\n ): Promise<void> {\n this.logger.warn('Queue alert triggered', { alertType, queueName, details });\n\n for (const callback of this.alertCallbacks) {\n try {\n await callback(alertType, queueName, details);\n } catch (error) {\n this.logger.error('Error in alert callback', {\n ...projectCaughtErrorLogFields(error),\n });\n }\n }\n }\n\n /\n Create empty metrics for a queue.\n */\n private createEmptyMetrics(queueName: string): QueueMetrics {\n return {\n queueName,\n pendingCount: 0,\n processingCount: 0,\n deadLetterCount: 0,\n publishRatePerMinute: 0,\n consumeRatePerMinute: 0,\n avgProcessingTimeMs: 0,\n p95ProcessingTimeMs: 0,\n p99ProcessingTimeMs: 0,\n errorRate: 0,\n retryRate: 0,\n collectedAt: new Date(),\n };\n }\n}\n"]}

package/dist/esm/queue/queue-worker-initializer.backend.service.d.ts CHANGED Viewed

@@ -1,8 +1,21 @@
 /**
+ * @wildo_source:part:start saas.backend.queue.worker-topology facet:layer:backend facet:audience:app-developer
+ *
+ * Where an application's background jobs actually run.
+ *
+ * ⚠️ **Queue consumers are NOT a separate tier.** They run inside each backend API pod, so every pod
+ * both ENQUEUES jobs (as an API handler) and CONSUMES them (as a worker). The consequence is the one
+ * that matters when a queue backs up: **scaling job processing means scaling the BACKEND**, not
+ * adding worker processes.
+ *
+ * ⚠️ **A declared `workers:` entry is a different thing entirely, and its name misleads.** That is a
+ * standalone HTTP service the backend CALLS — it never connects to the broker, has no database and
+ * no cache, and cannot read or write application resources except through what the caller puts in the
+ * request. Adding one does not add queue capacity.
+ *
  * Queue Worker Initializer Backend Service
  *
  * Initializes queue workers within the backend API application.
- * Workers are NOT separate microservices - they run inside each backend API pod.
  *
  * This service is called during application startup to:
  * 1. Connect to RabbitMQ
@@ -13,6 +26,8 @@
  * Every backend API pod can both:
  * - Enqueue jobs (as API handlers)
  * - Consume and execute jobs (as workers)
+ *
+ * @wildo_source:part:end saas.backend.queue.worker-topology
  */
 import { LoggerService } from '../monitoring/logger/services/logger.service';
 import { AppConfigurationService } from '../config/services/app-configuration.backend.service';

package/dist/esm/queue/queue-worker-initializer.backend.service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"queue-worker-initializer.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/queue/queue-worker-initializer.backend.service.ts"],"names":[],"mappings":"AAAA~~;;;;;;;;;;;;;;;GAeG~~;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAE7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAC/G,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AASD,qBACa,oCAAoC;IAO7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAEjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAhB7B,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjF,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAA+C;gBAI1C,MAAM,EAAE,aAAa,EAErB,gBAAgB,EAAE,uBAAuB,EAEzC,YAAY,EAAE,mBAAmB,EAEjC,WAAW,EAAE,yBAAyB,EAEtC,eAAe,EAAE,mCAAmC,EAEpD,UAAU,EAAE,6BAA6B;IAM5D;;;;;OAKG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkF3D;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBhC"}
1	+ {"version":3,"file":"queue-worker-initializer.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/queue/queue-worker-initializer.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAE7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAC/G,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AAChG,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AASD,qBACa,oCAAoC;IAO7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAEjC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAEhC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAhB7B,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjF,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAA+C;gBAI1C,MAAM,EAAE,aAAa,EAErB,gBAAgB,EAAE,uBAAuB,EAEzC,YAAY,EAAE,mBAAmB,EAEjC,WAAW,EAAE,yBAAyB,EAEtC,eAAe,EAAE,mCAAmC,EAEpD,UAAU,EAAE,6BAA6B;IAM5D;;;;;OAKG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkF3D;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBhC"}

package/dist/esm/queue/queue-worker-initializer.backend.service.js CHANGED Viewed

@@ -1,8 +1,21 @@
 /**
+ * @wildo_source:part:start saas.backend.queue.worker-topology facet:layer:backend facet:audience:app-developer
+ *
+ * Where an application's background jobs actually run.
+ *
+ * ⚠️ **Queue consumers are NOT a separate tier.** They run inside each backend API pod, so every pod
+ * both ENQUEUES jobs (as an API handler) and CONSUMES them (as a worker). The consequence is the one
+ * that matters when a queue backs up: **scaling job processing means scaling the BACKEND**, not
+ * adding worker processes.
+ *
+ * ⚠️ **A declared `workers:` entry is a different thing entirely, and its name misleads.** That is a
+ * standalone HTTP service the backend CALLS — it never connects to the broker, has no database and
+ * no cache, and cannot read or write application resources except through what the caller puts in the
+ * request. Adding one does not add queue capacity.
+ *
  * Queue Worker Initializer Backend Service
  *
  * Initializes queue workers within the backend API application.
- * Workers are NOT separate microservices - they run inside each backend API pod.
  *
  * This service is called during application startup to:
  * 1. Connect to RabbitMQ
@@ -13,6 +26,8 @@
  * Every backend API pod can both:
  * - Enqueue jobs (as API handlers)
  * - Consume and execute jobs (as workers)
+ *
+ * @wildo_source:part:end saas.backend.queue.worker-topology
  */
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;

package/dist/esm/queue/queue-worker-initializer.backend.service.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"queue-worker-initializer.backend.service.js","sourceRoot":"","sources":["../../../../src/queue/queue-worker-initializer.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Queue Worker Initializer Backend Service\n \n Initializes queue workers within the backend API application.\n * Workers are NOT separate microservices - they run inside each backend API pod.\n \n This service is called during application startup to:\n * 1. Connect to RabbitMQ\n * 2. Start job consumers for operations queues\n * 3. Start monitoring\n * 4. Register graceful shutdown handlers\n \n Every backend API pod can both:\n * - Enqueue jobs (as API handlers)\n * - Consume and execute jobs (as workers)\n /\n\nimport { injectable, inject } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { projectCaughtErrorLogFields } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { AppConfigurationService } from '~wildo-backend-lib/config/services/app-configuration.backend.service';\nimport { QueueBackendService } from './queue.backend.service';\nimport { JobConsumerBackendService } from './job-consumer.backend.service';\nimport { WorkerShutdownManagerBackendService } from './worker-shutdown-manager.backend.service';\nimport { QueueMonitoringBackendService } from './queue-monitoring.backend.service';\n\n/\n Configuration for queue worker initialization.\n /\nexport interface QueueWorkerConfig {\n /* Whether to enable queue workers (default: true) /\n enabled?: boolean;\n\n /\n Whether to start the shared application job consumers — the subscriptions\n * on the `operations` / `operations.priority` / `scheduled` / `callbacks`\n * queues drained by {@link JobConsumerBackendService} (default: `true`).\n \n Headless runtimes that connect to RabbitMQ ONLY for their own dedicated\n * topology — the canonical case is a `BackgroundRuntimeType.MINION`, which\n * consumes just its `wildo.queue.<appId>.minion-tick.<name>` queue — set this\n * to `false`. When `false`, {@link initializeForWorker} still runs (the\n * broker connection + topology channel are required by the minion's own tick\n * consumer) but {@link JobConsumerBackendService.startConsuming} is skipped.\n \n WHY THIS MATTERS: a minion reuses the full backend startup lifecycle. If it\n * also subscribed to the shared `scheduled` queue, RabbitMQ would round-robin\n * every scheduled-cron tick between the backend-api pod and the minion, and\n * the minion — which only understands its own tick tokens — would nack every\n * foreign message straight to the dead-letter queue (≈50% loss of scheduled\n * work for any app that runs a minion).\n /\n startJobConsumers?: boolean;\n\n /* Whether to start queue monitoring (default: true) /\n enableMonitoring?: boolean;\n\n /* Monitoring interval in milliseconds (default: 30000) /\n monitoringIntervalMs?: number;\n}\n\nconst DEFAULT_CONFIG: Required<QueueWorkerConfig> = {\n enabled: true,\n startJobConsumers: true,\n enableMonitoring: true,\n monitoringIntervalMs: 30000,\n};\n\n@injectable()\nexport class QueueWorkerInitializerBackendService {\n protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n private isInitialized = false;\n private config: Required<QueueWorkerConfig> = DEFAULT_CONFIG;\n\n constructor(\n @inject(SAAS_SERVICE_TYPES.Logger)\n private readonly logger: LoggerService,\n @inject(SAAS_SERVICE_TYPES.AppConfigService)\n private readonly appConfigService: AppConfigurationService,\n @inject(SAAS_SERVICE_TYPES.QueueBackendService)\n private readonly queueService: QueueBackendService,\n @inject(SAAS_SERVICE_TYPES.JobConsumerService)\n private readonly jobConsumer: JobConsumerBackendService,\n @inject(SAAS_SERVICE_TYPES.WorkerShutdownManagerService)\n private readonly shutdownManager: WorkerShutdownManagerBackendService,\n @inject(SAAS_SERVICE_TYPES.QueueMonitoringService)\n private readonly monitoring: QueueMonitoringBackendService,\n ) {\n this.logDebug = this.logger.debugByType('QueueWorkerInitializerBackendService');\n this.logger.setDebugTypeLogging('QueueWorkerInitializerBackendService', false);\n }\n\n /\n Initialize queue workers.\n * Called during application startup after all other services are ready.\n \n @param config - Optional configuration overrides\n /\n async initialize(config?: QueueWorkerConfig): Promise<void> {\n if (this.isInitialized) {\n this.logger.warn('Queue workers already initialized');\n return;\n }\n\n // Merge config with defaults\n this.config = { ...DEFAULT_CONFIG, ...config };\n\n // Check if queue workers are disabled\n if (!this.config.enabled) {\n this.logger.info('Queue workers disabled by configuration');\n this.isInitialized = true;\n return;\n }\n\n // Check if RabbitMQ is configured\n const appConfig = this.appConfigService.config;\n if (!appConfig.database?.rabbitmq) {\n this.logDebug('RabbitMQ not configured, skipping queue worker initialization');\n this.isInitialized = true;\n return;\n }\n\n try {\n this.logDebug('Initializing queue workers...');\n\n // Step 1: Initialize queue service (connects to RabbitMQ)\n await this.queueService.initializeForWorker();\n this.logDebug('RabbitMQ connected');\n\n // Step 2: Register shutdown handlers\n // Stop handlers are called FIRST (stop accepting new work)\n // Shutdown handlers are called LAST (final cleanup)\n this.shutdownManager.registerSignalHandlers();\n\n // Register stop handler to stop consuming new jobs.\n // Registered UNCONDITIONALLY (regardless of startJobConsumers /\n // enableMonitoring): both `stopConsuming()` and `stopMonitoring()`\n // short-circuit to a no-op when their subsystem never started, so a\n // runtime that opted out still gets a correct, side-effect-free stop\n // handler without leaking a monitoring interval on shutdown.\n this.shutdownManager.registerStopHandler(async () => {\n this.logDebug('Stopping queue consumers...');\n await this.jobConsumer.stopConsuming();\n this.monitoring.stopMonitoring();\n });\n\n // Step 3: Start consuming jobs — unless this runtime opted out via\n // `startJobConsumers: false`. A minion connects (Step 1) for its own\n // dedicated tick queue only and must NOT drain the shared\n // operations/scheduled/callbacks queues (see the field JSDoc above).\n if (this.config.startJobConsumers) {\n this.logDebug('Starting job consumers...');\n await this.jobConsumer.startConsuming();\n this.logDebug('Job consumers started');\n } else {\n this.logDebug(\n 'Job consumers disabled for this runtime — the shared application job '\n + 'queues (operations/scheduled/callbacks) are left to the backend-api pod',\n );\n }\n\n // Step 4: Start monitoring (optional)\n if (this.config.enableMonitoring) {\n this.monitoring.startMonitoring(this.config.monitoringIntervalMs);\n this.logDebug('Queue monitoring started');\n }\n\n this.isInitialized = true;\n this.logDebug('Queue workers initialized successfully');\n\n } catch (error) {\n this.logger.error('❌ Queue worker initialization failed', {\n ...projectCaughtErrorLogFields(error),\n });\n // Don't throw - queue workers failing shouldn't prevent the app from starting\n // The app can still function, just without background job processing\n this.logger.warn('⚠️ Application will continue without queue workers');\n }\n }\n\n /\n Check if queue workers are initialized and running.\n /\n isRunning(): boolean {\n return this.isInitialized && this.config.enabled;\n }\n\n /\n Gracefully shutdown queue workers.\n * Note: This stops consumers and monitoring but does NOT exit the process.\n * Process exit is handled by WorkerShutdownManager's signal handlers.\n */\n async shutdown(): Promise<void> {\n if (!this.isInitialized) {\n return;\n }\n\n this.logger.info('🛑 Shutting down queue workers...');\n\n try {\n // Stop consumers (this is also called by shutdown handlers, but safe to call twice)\n await this.jobConsumer.stopConsuming();\n\n // Stop monitoring\n this.monitoring.stopMonitoring();\n\n this.logger.info('✅ Queue workers shut down');\n } catch (error) {\n this.logger.error('❌ Queue worker shutdown error', {\n ...projectCaughtErrorLogFields(error),\n });\n }\n\n this.isInitialized = false;\n }\n}\n"]}
1	+ {"version":3,"file":"queue-worker-initializer.backend.service.js","sourceRoot":"","sources":["../../../../src/queue/queue-worker-initializer.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n @wildo_source:part:start saas.backend.queue.worker-topology facet:layer:backend facet:audience:app-developer\n \n Where an application's background jobs actually run.\n \n ⚠️ Queue consumers are NOT a separate tier. They run inside each backend API pod, so every pod\n * both ENQUEUES jobs (as an API handler) and CONSUMES them (as a worker). The consequence is the one\n * that matters when a queue backs up: scaling job processing means scaling the BACKEND, not\n * adding worker processes.\n \n ⚠️ A declared `workers:` entry is a different thing entirely, and its name misleads. That is a\n * standalone HTTP service the backend CALLS — it never connects to the broker, has no database and\n * no cache, and cannot read or write application resources except through what the caller puts in the\n * request. Adding one does not add queue capacity.\n \n Queue Worker Initializer Backend Service\n \n Initializes queue workers within the backend API application.\n \n This service is called during application startup to:\n * 1. Connect to RabbitMQ\n * 2. Start job consumers for operations queues\n * 3. Start monitoring\n * 4. Register graceful shutdown handlers\n \n Every backend API pod can both:\n * - Enqueue jobs (as API handlers)\n * - Consume and execute jobs (as workers)\n \n @wildo_source:part:end saas.backend.queue.worker-topology\n /\n\nimport { injectable, inject } from 'inversify';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { projectCaughtErrorLogFields } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { AppConfigurationService } from '~wildo-backend-lib/config/services/app-configuration.backend.service';\nimport { QueueBackendService } from './queue.backend.service';\nimport { JobConsumerBackendService } from './job-consumer.backend.service';\nimport { WorkerShutdownManagerBackendService } from './worker-shutdown-manager.backend.service';\nimport { QueueMonitoringBackendService } from './queue-monitoring.backend.service';\n\n/\n Configuration for queue worker initialization.\n /\nexport interface QueueWorkerConfig {\n /* Whether to enable queue workers (default: true) /\n enabled?: boolean;\n\n /\n Whether to start the shared application job consumers — the subscriptions\n * on the `operations` / `operations.priority` / `scheduled` / `callbacks`\n * queues drained by {@link JobConsumerBackendService} (default: `true`).\n \n Headless runtimes that connect to RabbitMQ ONLY for their own dedicated\n * topology — the canonical case is a `BackgroundRuntimeType.MINION`, which\n * consumes just its `wildo.queue.<appId>.minion-tick.<name>` queue — set this\n * to `false`. When `false`, {@link initializeForWorker} still runs (the\n * broker connection + topology channel are required by the minion's own tick\n * consumer) but {@link JobConsumerBackendService.startConsuming} is skipped.\n \n WHY THIS MATTERS: a minion reuses the full backend startup lifecycle. If it\n * also subscribed to the shared `scheduled` queue, RabbitMQ would round-robin\n * every scheduled-cron tick between the backend-api pod and the minion, and\n * the minion — which only understands its own tick tokens — would nack every\n * foreign message straight to the dead-letter queue (≈50% loss of scheduled\n * work for any app that runs a minion).\n /\n startJobConsumers?: boolean;\n\n /* Whether to start queue monitoring (default: true) /\n enableMonitoring?: boolean;\n\n /* Monitoring interval in milliseconds (default: 30000) /\n monitoringIntervalMs?: number;\n}\n\nconst DEFAULT_CONFIG: Required<QueueWorkerConfig> = {\n enabled: true,\n startJobConsumers: true,\n enableMonitoring: true,\n monitoringIntervalMs: 30000,\n};\n\n@injectable()\nexport class QueueWorkerInitializerBackendService {\n protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n private isInitialized = false;\n private config: Required<QueueWorkerConfig> = DEFAULT_CONFIG;\n\n constructor(\n @inject(SAAS_SERVICE_TYPES.Logger)\n private readonly logger: LoggerService,\n @inject(SAAS_SERVICE_TYPES.AppConfigService)\n private readonly appConfigService: AppConfigurationService,\n @inject(SAAS_SERVICE_TYPES.QueueBackendService)\n private readonly queueService: QueueBackendService,\n @inject(SAAS_SERVICE_TYPES.JobConsumerService)\n private readonly jobConsumer: JobConsumerBackendService,\n @inject(SAAS_SERVICE_TYPES.WorkerShutdownManagerService)\n private readonly shutdownManager: WorkerShutdownManagerBackendService,\n @inject(SAAS_SERVICE_TYPES.QueueMonitoringService)\n private readonly monitoring: QueueMonitoringBackendService,\n ) {\n this.logDebug = this.logger.debugByType('QueueWorkerInitializerBackendService');\n this.logger.setDebugTypeLogging('QueueWorkerInitializerBackendService', false);\n }\n\n /\n Initialize queue workers.\n * Called during application startup after all other services are ready.\n \n @param config - Optional configuration overrides\n /\n async initialize(config?: QueueWorkerConfig): Promise<void> {\n if (this.isInitialized) {\n this.logger.warn('Queue workers already initialized');\n return;\n }\n\n // Merge config with defaults\n this.config = { ...DEFAULT_CONFIG, ...config };\n\n // Check if queue workers are disabled\n if (!this.config.enabled) {\n this.logger.info('Queue workers disabled by configuration');\n this.isInitialized = true;\n return;\n }\n\n // Check if RabbitMQ is configured\n const appConfig = this.appConfigService.config;\n if (!appConfig.database?.rabbitmq) {\n this.logDebug('RabbitMQ not configured, skipping queue worker initialization');\n this.isInitialized = true;\n return;\n }\n\n try {\n this.logDebug('Initializing queue workers...');\n\n // Step 1: Initialize queue service (connects to RabbitMQ)\n await this.queueService.initializeForWorker();\n this.logDebug('RabbitMQ connected');\n\n // Step 2: Register shutdown handlers\n // Stop handlers are called FIRST (stop accepting new work)\n // Shutdown handlers are called LAST (final cleanup)\n this.shutdownManager.registerSignalHandlers();\n\n // Register stop handler to stop consuming new jobs.\n // Registered UNCONDITIONALLY (regardless of startJobConsumers /\n // enableMonitoring): both `stopConsuming()` and `stopMonitoring()`\n // short-circuit to a no-op when their subsystem never started, so a\n // runtime that opted out still gets a correct, side-effect-free stop\n // handler without leaking a monitoring interval on shutdown.\n this.shutdownManager.registerStopHandler(async () => {\n this.logDebug('Stopping queue consumers...');\n await this.jobConsumer.stopConsuming();\n this.monitoring.stopMonitoring();\n });\n\n // Step 3: Start consuming jobs — unless this runtime opted out via\n // `startJobConsumers: false`. A minion connects (Step 1) for its own\n // dedicated tick queue only and must NOT drain the shared\n // operations/scheduled/callbacks queues (see the field JSDoc above).\n if (this.config.startJobConsumers) {\n this.logDebug('Starting job consumers...');\n await this.jobConsumer.startConsuming();\n this.logDebug('Job consumers started');\n } else {\n this.logDebug(\n 'Job consumers disabled for this runtime — the shared application job '\n + 'queues (operations/scheduled/callbacks) are left to the backend-api pod',\n );\n }\n\n // Step 4: Start monitoring (optional)\n if (this.config.enableMonitoring) {\n this.monitoring.startMonitoring(this.config.monitoringIntervalMs);\n this.logDebug('Queue monitoring started');\n }\n\n this.isInitialized = true;\n this.logDebug('Queue workers initialized successfully');\n\n } catch (error) {\n this.logger.error('❌ Queue worker initialization failed', {\n ...projectCaughtErrorLogFields(error),\n });\n // Don't throw - queue workers failing shouldn't prevent the app from starting\n // The app can still function, just without background job processing\n this.logger.warn('⚠️ Application will continue without queue workers');\n }\n }\n\n /\n Check if queue workers are initialized and running.\n /\n isRunning(): boolean {\n return this.isInitialized && this.config.enabled;\n }\n\n /\n Gracefully shutdown queue workers.\n * Note: This stops consumers and monitoring but does NOT exit the process.\n * Process exit is handled by WorkerShutdownManager's signal handlers.\n */\n async shutdown(): Promise<void> {\n if (!this.isInitialized) {\n return;\n }\n\n this.logger.info('🛑 Shutting down queue workers...');\n\n try {\n // Stop consumers (this is also called by shutdown handlers, but safe to call twice)\n await this.jobConsumer.stopConsuming();\n\n // Stop monitoring\n this.monitoring.stopMonitoring();\n\n this.logger.info('✅ Queue workers shut down');\n } catch (error) {\n this.logger.error('❌ Queue worker shutdown error', {\n ...projectCaughtErrorLogFields(error),\n });\n }\n\n this.isInitialized = false;\n }\n}\n"]}

package/dist/esm/queue/queue.backend.service.d.ts CHANGED Viewed

@@ -7,7 +7,7 @@
 import { LoggerService } from '../monitoring/logger/services/logger.service';
 import { AppConfigurationService } from '../config/services/app-configuration.backend.service';
 import { AuthorizationsBackendService } from '../security/authorizations/services/authorizations.backend.service';
-import { RabbitMQAdapterBackendService } from './adapters/rabbitmq-adapter.backend.service';
+import type { QueueAdapter } from './adapters/queue-adapter.backend.interface';
 import { JobStatusTrackingBackendService } from './job-status-tracking.backend.service';
 import { JobPayloadStorageBackendService } from './job-payload-storage.backend.service';
 import { ExecutionContext } from '../runtime/models/execution-context.backend.schemas';
@@ -33,7 +33,7 @@ export declare class QueueBackendService {
     private replyQueueName;
     private readonly pendingReplies;
     private initialized;
-    constructor(appConfigService: AppConfigurationService, authorizationsService: AuthorizationsBackendService, logger: LoggerService, adapter: RabbitMQAdapterBackendService, jobStatusTracking: JobStatusTrackingBackendService, payloadStorage: JobPayloadStorageBackendService);
+    constructor(appConfigService: AppConfigurationService, authorizationsService: AuthorizationsBackendService, logger: LoggerService, adapter: QueueAdapter, jobStatusTracking: JobStatusTrackingBackendService, payloadStorage: JobPayloadStorageBackendService);
     /** Lazy getter for applicationId - avoids accessing config in constructor */
     private get appId();
     /**
@@ -101,7 +101,7 @@ export declare class QueueBackendService {
     /**
      * Get RabbitMQ adapter for direct operations.
      */
-    getAdapter(): RabbitMQAdapterBackendService;
+    getAdapter(): QueueAdapter;
     /**
      * Close queue service gracefully.
      */

package/dist/esm/queue/queue.backend.service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"queue.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/queue/queue.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAC/G,OAAO,EAAE,4BAA4B,EAAE,MAAM,oFAAoF,CAAC;~~AAClI~~,OAAO,EAAE,~~6BAA6B~~,EAAE,MAAM,~~6CAA6C~~,CAAC;~~AAC5F~~,OAAO,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qEAAqE,CAAC;AAEvG,OAAO,EAIL,WAAW,EAIX,uBAAuB,EAMxB,MAAM,uBAAuB,CAAC;AAG/B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBACa,mBAAmB;IAa5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAEjC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAEtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAtBjC,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjF,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAIhB;IACf,OAAO,CAAC,WAAW,CAAS;gBAIT,gBAAgB,EAAE,uBAAuB,EAEzC,qBAAqB,EAAE,4BAA4B,EAEnD,MAAM,EAAE,aAAa,EAErB,OAAO,EAAE,~~6BAA6B~~,~~EAEtC~~,iBAAiB,EAAE,+BAA+B,EAElD,cAAc,EAAE,+BAA+B;IAOlE,6EAA6E;IAC7E,OAAO,KAAK,KAAK,GAKhB;IAED;;;OAGG;IACU,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;~~IAuDjD~~;;;;;;;;OAQG;IACU,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;~~IAgHjD~~;;;OAGG;IACU,gBAAgB,CAC3B,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,EACvC,SAAS,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC;IA4BzB;;;OAGG;IACU,cAAc,CAAC,CAAC,EAC3B,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,EACvC,SAAS,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC;IAgDb;;;OAGG;IACU,mBAAmB,CAC9B,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,EACvC,SAAS,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC;IAwBzB;;;OAGG;YACW,eAAe;IAyE7B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;;;;;;;;OAUG;IACU,kBAAkB,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,WAAW,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,mEAAmE;QACnE,WAAW,CAAC,EAAE,uBAAuB,CAAC;KACvC,GACA,OAAO,CAAC,aAAa,CAAC;IA6EzB;;OAEG;IACI,UAAU,IAAI,~~6BAA6B~~;~~IAIlD~~;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAcpC"}
1	+ {"version":3,"file":"queue.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/queue/queue.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/queue/queue.backend.service.js CHANGED Viewed

@@ -75,6 +75,22 @@ let QueueBackendService = class QueueBackendService {
         // source keeps the topology self-consistent. This queue is TERMINAL: it has
         // no dead-letter args of its own (a parked message stays here until a human /
         // tool inspects it — the queue has no consumer).
+        //
+        // ## Dead-letter inspection is a BROKER-level concern — decided 2026-09-08 (#469)
+        //
+        // Having no consumer is deliberate, not unfinished. Wildo ships no listing of parked jobs, no
+        // replay verb and no queue-depth health signal, and it is not going to: an operator inspects and
+        // replays a parked message with the broker's own tooling (the RabbitMQ management UI or CLI
+        // against this queue by name).
+        //
+        // Do not read the absence as an oversight and wire a surface here. A job-execution read surface
+        // exposes job PAYLOADS, which may carry personal data, and would need its own authorization and
+        // privacy classification — which is why the decision went the other way. The display behaviour
+        // that used to be authored for `jobExecutions` / `jobPayloadStorage` was deleted in the same
+        // change, because it rendered nowhere and made this absence look accidental.
+        //
+        // If this ever bites, the option to revisit FIRST is queue DEPTH as a health signal — it catches
+        // the fleet-level problem without exposing a single payload.
         const deadLetterQueue = buildQueueName(this.appId, 'operations', QueueVariant.DEADLETTER);
         await this.adapter.assertQueue(deadLetterQueue, {
             durable: true,
@@ -122,7 +138,15 @@ let QueueBackendService = class QueueBackendService {
         // Configure RabbitMQ adapter from app config
         const appConfig = this.appConfigService.config;
         const appSecrets = this.appConfigService.secrets;
-        if (appConfig.database?.rabbitmq) {
+        /*
+         * Broker connection settings apply to the BROKER adapter, and to nothing else (#502).
+         *
+         * `configure()` takes a `RabbitMQConfig` and is deliberately absent from `QueueAdapter` — an
+         * in-memory queue has no host, port or vhost to be told about. Narrowing here rather than
+         * widening the port keeps that honest: the alternative was a `configure(config: unknown)` every
+         * adapter must accept and most must ignore, which is a hole in the port wearing a signature.
+         */
+        if (appConfig.database?.rabbitmq && this.adapter instanceof RabbitMQAdapterBackendService) {
             // Credentials from secrets first, then env vars, then defaults
             const username = appSecrets.database?.rabbitmq?.username
                 || process.env.RABBITMQ_USERNAME
@@ -498,9 +522,7 @@ QueueBackendService = __decorate([
     __param(5, inject(SAAS_SERVICE_TYPES.JobPayloadStorageService)),
     __metadata("design:paramtypes", [AppConfigurationService,
         AuthorizationsBackendService,
-        LoggerService,
-        RabbitMQAdapterBackendService,
-        JobStatusTrackingBackendService,
+        LoggerService, Object, JobStatusTrackingBackendService,
         JobPayloadStorageBackendService])
 ], QueueBackendService);
 export { QueueBackendService };