@wildo-ai/saas-backend-lib 1.0.1

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

@@ -0,0 +1,297 @@
+/**
+ * Queue Monitoring Backend Service
+ *
+ * Provides metrics, health checks, and alerting for the queue system.
+ * Integrates with RabbitMQ for queue statistics and the job tracking system.
+ */
+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;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'inversify';
+import { SAAS_SERVICE_TYPES } from '../inject/models/service-types.js';
+import { LoggerService } from '../monitoring/logger/services/logger.service.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;
+    logDebug;
+    alertCallbacks = [];
+    alertThresholds = new Map();
+    monitoringInterval = null;
+    isMonitoring = false;
+    constructor(logger, configService, rabbitMQAdapter) {
+        this.logger = logger;
+        this.configService = configService;
+        this.rabbitMQAdapter = rabbitMQAdapter;
+        this.logDebug = this.logger.debugByType('QueueMonitoringBackendService');
+        this.logger.setDebugTypeLogging('QueueMonitoringBackendService', false);
+    }
+    /**
+     * Start monitoring queues at the specified interval.
+     */
+    startMonitoring(intervalMs = 30000) {
+        if (this.isMonitoring) {
+            this.logger.warn('Queue monitoring is already running');
+            return;
+        }
+        this.isMonitoring = true;
+        this.logDebug('Starting queue monitoring', { intervalMs });
+        this.monitoringInterval = setInterval(async () => {
+            try {
+                await this.checkAllQueues();
+            }
+            catch (error) {
+                this.logger.error('Error during queue monitoring check', {
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+            }
+        }, intervalMs);
+        // Initial check
+        this.checkAllQueues().catch((error) => {
+            this.logger.error('Error during initial queue monitoring check', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        });
+    }
+    /**
+     * Stop monitoring queues.
+     */
+    stopMonitoring() {
+        if (this.monitoringInterval) {
+            clearInterval(this.monitoringInterval);
+            this.monitoringInterval = null;
+        }
+        this.isMonitoring = false;
+        this.logDebug('Queue monitoring stopped');
+    }
+    /**
+     * Register an alert callback.
+     */
+    onAlert(callback) {
+        this.alertCallbacks.push(callback);
+    }
+    /**
+     * Set alert thresholds for a queue.
+     */
+    setAlertThreshold(queueName, threshold) {
+        this.alertThresholds.set(queueName, threshold);
+        this.logDebug('Alert threshold set', { queueName, threshold });
+    }
+    /**
+     * Get metrics for a specific queue.
+     * Also checks the corresponding dead letter queue if it exists.
+     */
+    async getQueueMetrics(queueName) {
+        const channel = this.rabbitMQAdapter.getChannel();
+        if (!channel) {
+            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,
+                processingCount: 0, // Would need consumer tracking
+                deadLetterCount: 0, // Skipped - see note above
+                publishRatePerMinute: 0, // Would need historical tracking
+                consumeRatePerMinute: 0,
+                avgProcessingTimeMs: 0,
+                p95ProcessingTimeMs: 0,
+                p99ProcessingTimeMs: 0,
+                errorRate: 0,
+                retryRate: 0,
+                collectedAt: new Date(),
+            };
+        }
+        catch (error) {
+            // Queue might not exist yet
+            this.logDebug('Could not get queue metrics', {
+                queueName,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return this.createEmptyMetrics(queueName);
+        }
+    }
+    /**
+     * Get health summary for all monitored queues.
+     */
+    async getHealthSummary() {
+        const appId = this.configService.applicationId;
+        // Mono-env: queue names are wildo.queue.{appId}.{category}[.{variant}]
+        const queues = [
+            `wildo.queue.${appId}.operations`,
+            `wildo.queue.${appId}.operations.priority`,
+            `wildo.queue.${appId}.scheduled`,
+            `wildo.queue.${appId}.callbacks`,
+        ];
+        let overallStatus = QueueHealthStatus.HEALTHY;
+        let healthyQueues = 0;
+        let degradedQueues = 0;
+        let unhealthyQueues = 0;
+        const activeAlerts = [];
+        for (const queueName of queues) {
+            const metrics = await this.getQueueMetrics(queueName);
+            // Check thresholds
+            const threshold = this.alertThresholds.get(queueName);
+            if (threshold) {
+                const status = this.evaluateQueueHealth(metrics, threshold);
+                if (status === QueueHealthStatus.UNHEALTHY) {
+                    overallStatus = QueueHealthStatus.UNHEALTHY;
+                    unhealthyQueues++;
+                    activeAlerts.push({
+                        queueName,
+                        alertType: 'pending_count_exceeded',
+                        value: metrics.pendingCount,
+                        threshold: threshold.pendingCountThreshold ?? 0,
+                        triggeredAt: new Date(),
+                    });
+                }
+                else if (status === QueueHealthStatus.DEGRADED) {
+                    if (overallStatus === QueueHealthStatus.HEALTHY) {
+                        overallStatus = QueueHealthStatus.DEGRADED;
+                    }
+                    degradedQueues++;
+                    activeAlerts.push({
+                        queueName,
+                        alertType: 'queue_degraded',
+                        value: metrics.pendingCount,
+                        threshold: threshold.pendingCountThreshold ?? 0,
+                        triggeredAt: new Date(),
+                    });
+                }
+                else {
+                    healthyQueues++;
+                }
+            }
+            else {
+                healthyQueues++;
+            }
+        }
+        return {
+            status: overallStatus,
+            healthyQueues,
+            degradedQueues,
+            unhealthyQueues,
+            activeAlerts,
+            checkedAt: new Date(),
+        };
+    }
+    /**
+     * Check if RabbitMQ connection is healthy.
+     */
+    async isRabbitMQHealthy() {
+        return this.rabbitMQAdapter.isConnected();
+    }
+    /**
+     * Evaluate queue health based on thresholds.
+     */
+    evaluateQueueHealth(metrics, threshold) {
+        // Check pending count threshold
+        if (threshold.pendingCountThreshold !== undefined) {
+            if (metrics.pendingCount >= threshold.pendingCountThreshold * 2) {
+                return QueueHealthStatus.UNHEALTHY;
+            }
+            if (metrics.pendingCount >= threshold.pendingCountThreshold) {
+                return QueueHealthStatus.DEGRADED;
+            }
+        }
+        // Check dead letter threshold
+        if (threshold.deadLetterThreshold !== undefined) {
+            if (metrics.deadLetterCount >= threshold.deadLetterThreshold) {
+                return QueueHealthStatus.UNHEALTHY;
+            }
+        }
+        // Check error rate threshold
+        if (threshold.errorRateThreshold !== undefined) {
+            if (metrics.errorRate >= threshold.errorRateThreshold) {
+                return QueueHealthStatus.DEGRADED;
+            }
+        }
+        // Check latency threshold
+        if (threshold.latencyThresholdMs !== undefined) {
+            if (metrics.p95ProcessingTimeMs >= threshold.latencyThresholdMs) {
+                return QueueHealthStatus.DEGRADED;
+            }
+        }
+        return QueueHealthStatus.HEALTHY;
+    }
+    /**
+     * Check all queues and trigger alerts if needed.
+     */
+    async checkAllQueues() {
+        const summary = await this.getHealthSummary();
+        if (summary.status !== QueueHealthStatus.HEALTHY) {
+            for (const alert of summary.activeAlerts) {
+                await this.triggerAlert(summary.status === QueueHealthStatus.UNHEALTHY ? 'critical' : 'warning', alert.queueName, {
+                    alertType: alert.alertType,
+                    value: alert.value,
+                    threshold: alert.threshold,
+                    summary,
+                });
+            }
+        }
+    }
+    /**
+     * Trigger an alert to all registered callbacks.
+     */
+    async triggerAlert(alertType, queueName, details) {
+        this.logger.warn('Queue alert triggered', { alertType, queueName, details });
+        for (const callback of this.alertCallbacks) {
+            try {
+                await callback(alertType, queueName, details);
+            }
+            catch (error) {
+                this.logger.error('Error in alert callback', {
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+            }
+        }
+    }
+    /**
+     * Create empty metrics for a queue.
+     */
+    createEmptyMetrics(queueName) {
+        return {
+            queueName,
+            pendingCount: 0,
+            processingCount: 0,
+            deadLetterCount: 0,
+            publishRatePerMinute: 0,
+            consumeRatePerMinute: 0,
+            avgProcessingTimeMs: 0,
+            p95ProcessingTimeMs: 0,
+            p99ProcessingTimeMs: 0,
+            errorRate: 0,
+            retryRate: 0,
+            collectedAt: new Date(),
+        };
+    }
+};
+QueueMonitoringBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.AppConfigService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.RabbitMQAdapterService)),
+    __metadata("design:paramtypes", [LoggerService,
+        AppConfigurationService,
+        RabbitMQAdapterBackendService])
+], QueueMonitoringBackendService);
+export { QueueMonitoringBackendService };
+//# sourceMappingURL=queue-monitoring.backend.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-monitoring.backend.service.js","sourceRoot":"","sources":["../../../src/queue/queue-monitoring.backend.service.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,63 @@
+/**
+ * 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
+ * 2. Start job consumers for operations queues
+ * 3. Start monitoring
+ * 4. Register graceful shutdown handlers
+ *
+ * Every backend API pod can both:
+ * - Enqueue jobs (as API handlers)
+ * - Consume and execute jobs (as workers)
+ */
+import { LoggerService } from '../monitoring/logger/services/logger.service.js';
+import { AppConfigurationService } from '../config/services/app-configuration.backend.service.js';
+import { QueueBackendService } from './queue.backend.service.js';
+import { JobConsumerBackendService } from './job-consumer.backend.service.js';
+import { WorkerShutdownManagerBackendService } from './worker-shutdown-manager.backend.service.js';
+import { QueueMonitoringBackendService } from './queue-monitoring.backend.service.js';
+/**
+ * Configuration for queue worker initialization.
+ */
+export interface QueueWorkerConfig {
+    /** Whether to enable queue workers (default: true) */
+    enabled?: boolean;
+    /** Whether to start queue monitoring (default: true) */
+    enableMonitoring?: boolean;
+    /** Monitoring interval in milliseconds (default: 30000) */
+    monitoringIntervalMs?: number;
+}
+export declare class QueueWorkerInitializerBackendService {
+    private readonly logger;
+    private readonly appConfigService;
+    private readonly queueService;
+    private readonly jobConsumer;
+    private readonly shutdownManager;
+    private readonly monitoring;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    private isInitialized;
+    private config;
+    constructor(logger: LoggerService, appConfigService: AppConfigurationService, queueService: QueueBackendService, jobConsumer: JobConsumerBackendService, shutdownManager: WorkerShutdownManagerBackendService, monitoring: QueueMonitoringBackendService);
+    /**
+     * Initialize queue workers.
+     * Called during application startup after all other services are ready.
+     *
+     * @param config - Optional configuration overrides
+     */
+    initialize(config?: QueueWorkerConfig): Promise<void>;
+    /**
+     * Check if queue workers are initialized and running.
+     */
+    isRunning(): boolean;
+    /**
+     * Gracefully shutdown queue workers.
+     * Note: This stops consumers and monitoring but does NOT exit the process.
+     * Process exit is handled by WorkerShutdownManager's signal handlers.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=queue-worker-initializer.backend.service.d.ts.map

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

@@ -0,0 +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;AAC7F,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,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAQD,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;IAmE3D;;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

@@ -0,0 +1,171 @@
+/**
+ * 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
+ * 2. Start job consumers for operations queues
+ * 3. Start monitoring
+ * 4. Register graceful shutdown handlers
+ *
+ * Every backend API pod can both:
+ * - Enqueue jobs (as API handlers)
+ * - Consume and execute jobs (as workers)
+ */
+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;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'inversify';
+import { SAAS_SERVICE_TYPES } from '../inject/models/service-types.js';
+import { LoggerService } from '../monitoring/logger/services/logger.service.js';
+import { AppConfigurationService } from '../config/services/app-configuration.backend.service.js';
+import { QueueBackendService } from './queue.backend.service.js';
+import { JobConsumerBackendService } from './job-consumer.backend.service.js';
+import { WorkerShutdownManagerBackendService } from './worker-shutdown-manager.backend.service.js';
+import { QueueMonitoringBackendService } from './queue-monitoring.backend.service.js';
+const DEFAULT_CONFIG = {
+    enabled: true,
+    enableMonitoring: true,
+    monitoringIntervalMs: 30000,
+};
+let QueueWorkerInitializerBackendService = class QueueWorkerInitializerBackendService {
+    logger;
+    appConfigService;
+    queueService;
+    jobConsumer;
+    shutdownManager;
+    monitoring;
+    logDebug;
+    isInitialized = false;
+    config = DEFAULT_CONFIG;
+    constructor(logger, appConfigService, queueService, jobConsumer, shutdownManager, monitoring) {
+        this.logger = logger;
+        this.appConfigService = appConfigService;
+        this.queueService = queueService;
+        this.jobConsumer = jobConsumer;
+        this.shutdownManager = shutdownManager;
+        this.monitoring = monitoring;
+        this.logDebug = this.logger.debugByType('QueueWorkerInitializerBackendService');
+        this.logger.setDebugTypeLogging('QueueWorkerInitializerBackendService', false);
+    }
+    /**
+     * Initialize queue workers.
+     * Called during application startup after all other services are ready.
+     *
+     * @param config - Optional configuration overrides
+     */
+    async initialize(config) {
+        if (this.isInitialized) {
+            this.logger.warn('Queue workers already initialized');
+            return;
+        }
+        // Merge config with defaults
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // Check if queue workers are disabled
+        if (!this.config.enabled) {
+            this.logger.info('Queue workers disabled by configuration');
+            this.isInitialized = true;
+            return;
+        }
+        // Check if RabbitMQ is configured
+        const appConfig = this.appConfigService.config;
+        if (!appConfig.database?.rabbitmq) {
+            this.logDebug('RabbitMQ not configured, skipping queue worker initialization');
+            this.isInitialized = true;
+            return;
+        }
+        try {
+            this.logDebug('Initializing queue workers...');
+            // Step 1: Initialize queue service (connects to RabbitMQ)
+            await this.queueService.initializeForWorker();
+            this.logDebug('RabbitMQ connected');
+            // Step 2: Register shutdown handlers
+            // Stop handlers are called FIRST (stop accepting new work)
+            // Shutdown handlers are called LAST (final cleanup)
+            this.shutdownManager.registerSignalHandlers();
+            // Register stop handler to stop consuming new jobs
+            this.shutdownManager.registerStopHandler(async () => {
+                this.logDebug('Stopping queue consumers...');
+                await this.jobConsumer.stopConsuming();
+                this.monitoring.stopMonitoring();
+            });
+            // Step 3: Start consuming jobs
+            this.logDebug('Starting job consumers...');
+            await this.jobConsumer.startConsuming();
+            this.logDebug('Job consumers started');
+            // Step 4: Start monitoring (optional)
+            if (this.config.enableMonitoring) {
+                this.monitoring.startMonitoring(this.config.monitoringIntervalMs);
+                this.logDebug('Queue monitoring started');
+            }
+            this.isInitialized = true;
+            this.logDebug('Queue workers initialized successfully');
+        }
+        catch (error) {
+            this.logger.error('❌ Queue worker initialization failed', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            // Don't throw - queue workers failing shouldn't prevent the app from starting
+            // The app can still function, just without background job processing
+            this.logger.warn('⚠️ Application will continue without queue workers');
+        }
+    }
+    /**
+     * Check if queue workers are initialized and running.
+     */
+    isRunning() {
+        return this.isInitialized && this.config.enabled;
+    }
+    /**
+     * Gracefully shutdown queue workers.
+     * Note: This stops consumers and monitoring but does NOT exit the process.
+     * Process exit is handled by WorkerShutdownManager's signal handlers.
+     */
+    async shutdown() {
+        if (!this.isInitialized) {
+            return;
+        }
+        this.logger.info('🛑 Shutting down queue workers...');
+        try {
+            // Stop consumers (this is also called by shutdown handlers, but safe to call twice)
+            await this.jobConsumer.stopConsuming();
+            // Stop monitoring
+            this.monitoring.stopMonitoring();
+            this.logger.info('✅ Queue workers shut down');
+        }
+        catch (error) {
+            this.logger.error('❌ Queue worker shutdown error', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+        }
+        this.isInitialized = false;
+    }
+};
+QueueWorkerInitializerBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.AppConfigService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.QueueBackendService)),
+    __param(3, inject(SAAS_SERVICE_TYPES.JobConsumerService)),
+    __param(4, inject(SAAS_SERVICE_TYPES.WorkerShutdownManagerService)),
+    __param(5, inject(SAAS_SERVICE_TYPES.QueueMonitoringService)),
+    __metadata("design:paramtypes", [LoggerService,
+        AppConfigurationService,
+        QueueBackendService,
+        JobConsumerBackendService,
+        WorkerShutdownManagerBackendService,
+        QueueMonitoringBackendService])
+], QueueWorkerInitializerBackendService);
+export { QueueWorkerInitializerBackendService };
+//# sourceMappingURL=queue-worker-initializer.backend.service.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,108 @@
+/**
+ * Queue Backend Service
+ *
+ * Main entry point for queue operations.
+ * Handles enqueuing jobs with authorization checks.
+ */
+import { LoggerService } from '../monitoring/logger/services/logger.service.js';
+import { AppConfigurationService } from '../config/services/app-configuration.backend.service.js';
+import { AuthorizationsBackendService } from '../security/authorizations/services/authorizations.backend.service.js';
+import { RabbitMQAdapterBackendService } from './adapters/rabbitmq-adapter.backend.service.js';
+import { JobStatusTrackingBackendService } from './job-status-tracking.backend.service.js';
+import { JobPayloadStorageBackendService } from './job-payload-storage.backend.service.js';
+import { ExecutionContext } from '../runtime/models/execution-context.backend.schemas.js';
+import { JobPriority } from '@wildo-ai/saas-models';
+/**
+ * Result of an enqueue operation.
+ */
+export interface EnqueueResult {
+    /** Unique job identifier */
+    jobId: string;
+    /** Queue the job was published to */
+    queueName: string;
+}
+export declare class QueueBackendService {
+    private readonly appConfigService;
+    private readonly authorizationsService;
+    private readonly logger;
+    private readonly adapter;
+    private readonly jobStatusTracking;
+    private readonly payloadStorage;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    private _appId;
+    private replyQueueName;
+    private readonly pendingReplies;
+    private initialized;
+    constructor(appConfigService: AppConfigurationService, authorizationsService: AuthorizationsBackendService, logger: LoggerService, adapter: RabbitMQAdapterBackendService, jobStatusTracking: JobStatusTrackingBackendService, payloadStorage: JobPayloadStorageBackendService);
+    /** Lazy getter for applicationId - avoids accessing config in constructor */
+    private get appId();
+    /**
+     * Initialize queue service for API pod.
+     * Sets up reply queue for RPC pattern.
+     */
+    initializeForApiPod(): Promise<void>;
+    /**
+     * Initialize queue service for worker pod.
+     *
+     * This method initializes all queue infrastructure needed for a pod that:
+     * - Consumes and processes jobs (worker functionality)
+     * - Enqueues jobs and receives RPC replies (API functionality)
+     *
+     * Every backend API pod serves both roles, hence this comprehensive initialization.
+     */
+    initializeForWorker(): Promise<void>;
+    /**
+     * Enqueue operation (fire and forget).
+     * Returns immediately after publishing.
+     */
+    enqueueOperation(executionContext: ExecutionContext<any>, inputData: unknown, inputId?: string): Promise<EnqueueResult>;
+    /**
+     * Enqueue operation and wait for result (RPC pattern).
+     * Used for QUEUED runtime mode.
+     */
+    enqueueAndWait<T>(executionContext: ExecutionContext<any>, inputData: unknown, inputId?: string, timeoutMs?: number): Promise<T>;
+    /**
+     * Enqueue with callback (for BACKGROUND_JOB).
+     * Returns job ID immediately, result delivered via callback mechanism.
+     */
+    enqueueWithCallback(executionContext: ExecutionContext<any>, inputData: unknown, inputId?: string): Promise<EnqueueResult>;
+    /**
+     * Build job payload from execution context and input data.
+     * Stores large payloads (>100KB) externally and stores only the storage ID.
+     */
+    private buildJobPayload;
+    /**
+     * Get operations queue name based on priority.
+     * Accepts string because job.priority from schema is a string union.
+     */
+    private getOperationsQueueName;
+    /**
+     * Handle RPC reply from worker.
+     */
+    private handleReply;
+    /**
+     * Enqueue a custom batch job.
+     *
+     * This method is used for fire-and-forget batch operations that don't
+     * need to go through the standard resource operation flow.
+     *
+     * @param batchType - Identifier for the batch type (e.g., 'email.batch-send')
+     * @param payload - The batch job payload (must be serializable)
+     * @param options - Optional configuration for the job
+     * @returns The job ID and queue name
+     */
+    enqueueCustomBatch(batchType: string, payload: unknown, options?: {
+        priority?: JobPriority;
+        maxRetries?: number;
+        timeoutMs?: number;
+    }): Promise<EnqueueResult>;
+    /**
+     * Get RabbitMQ adapter for direct operations.
+     */
+    getAdapter(): RabbitMQAdapterBackendService;
+    /**
+     * Close queue service gracefully.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=queue.backend.service.d.ts.map