@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/queue/job-status-tracking.backend.service.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Job Status Tracking Backend Service
+ *
+ * Tracks job lifecycle in MongoDB for observability and querying.
+ *
+ * Uses the same pattern as FilesBackendService:
+ * - Get repository via RepositoriesRegistryHandlerBackendService
+ * - Create internal execution context via getOperationPathDefault
+ * - Use direct repository methods (create, read, update)
+ *
+ * This ensures proper authorization flow while keeping the implementation simple.
+ */
+import { LoggerService } from '../monitoring/logger/services/logger.service.js';
+import { RepositoriesRegistryHandlerBackendService } from '../base-classes/services/repositories/repositories-registry-handler.backend.service.js';
+import { ExecutionContextCreatorBackendService } from '../runtime/services/execution-context-creator.backend.service.js';
+import { ResourcesRegistryBackendService } from '../resources/services/resources-registry.backend.service.js';
+import { RepositoryOptions } from '../base-classes/models/repositories.backend.schemas.js';
+import { JobPayload, JobExecution, WildoError_Backend, CoreResourceType } from '@wildo-ai/saas-models';
+export declare class JobStatusTrackingBackendService {
+    private readonly logger;
+    private readonly repositoriesRegistry;
+    private readonly executionContextCreator;
+    private readonly resourcesRegistry;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    constructor(logger: LoggerService, repositoriesRegistry: RepositoriesRegistryHandlerBackendService, executionContextCreator: ExecutionContextCreatorBackendService, resourcesRegistry: ResourcesRegistryBackendService);
+    /**
+     * Get the resource type for this service.
+     */
+    static get resourceType(): CoreResourceType;
+    /**
+     * Get repository for job executions.
+     * Lazy getter to ensure repository is initialized.
+     */
+    private get jobExecutionRepository();
+    /**
+     * Create an internal execution context for job tracking operations.
+     * Uses default operation path (no variant) following FilesBackendService pattern.
+     */
+    private createInternalContext;
+    /**
+     * Create job execution record when job is enqueued.
+     *
+     * @param job - Job payload with metadata
+     * @param queueName - Name of queue job was published to
+     * @param options - Optional repository options (for transactions)
+     * @returns MongoDB document ID of created record
+     */
+    createJobRecord(job: JobPayload, queueName: string, options?: RepositoryOptions): Promise<string>;
+    /**
+     * Mark job as started when worker begins processing.
+     *
+     * @param jobId - Job identifier
+     * @param workerId - Worker/pod identifier
+     * @param options - Optional repository options
+     */
+    markStarted(jobId: string, workerId: string, options?: RepositoryOptions): Promise<void>;
+    /**
+     * Mark job as completed successfully.
+     *
+     * @param jobId - Job identifier
+     * @param outputPayloadStorageId - Optional storage ID for large output
+     * @param options - Optional repository options
+     */
+    markCompleted(jobId: string, outputPayloadStorageId?: string, options?: RepositoryOptions): Promise<void>;
+    /**
+     * Mark job as failed. Updates retry count and determines next status.
+     *
+     * @param jobId - Job identifier
+     * @param error - WildoError with failure details
+     * @param options - Optional repository options
+     */
+    markFailed(jobId: string, error: WildoError_Backend, options?: RepositoryOptions): Promise<void>;
+    /**
+     * Mark job as dead-lettered (moved to dead letter queue).
+     *
+     * @param jobId - Job identifier
+     * @param options - Optional repository options
+     */
+    markDeadLettered(jobId: string, options?: RepositoryOptions): Promise<void>;
+    /**
+     * Mark job as cancelled.
+     *
+     * @param jobId - Job identifier
+     * @param options - Optional repository options
+     */
+    markCancelled(jobId: string, options?: RepositoryOptions): Promise<void>;
+    /**
+     * Get job execution record by jobId.
+     * Useful for status queries and debugging.
+     *
+     * @param jobId - Job identifier
+     * @param options - Optional repository options
+     * @returns Job execution record or null if not found
+     */
+    getByJobId(jobId: string, options?: RepositoryOptions): Promise<JobExecution | null>;
+}
+//# sourceMappingURL=job-status-tracking.backend.service.d.ts.map

package/dist/esm/queue/job-status-tracking.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-status-tracking.backend.service.d.ts","sourceRoot":"","sources":["../../../src/queue/job-status-tracking.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAE7F,OAAO,EAAE,yCAAyC,EAAE,MAAM,qGAAqG,CAAC;AAChK,OAAO,EAAE,qCAAqC,EAAE,MAAM,+EAA+E,CAAC;AACtI,OAAO,EAAE,+BAA+B,EAAE,MAAM,0EAA0E,CAAC;AAC3H,OAAO,EAAE,iBAAiB,EAAE,MAAM,qEAAqE,CAAC;AACxG,OAAO,EACL,UAAU,EACV,YAAY,EAGZ,kBAAkB,EAClB,gBAAgB,EAEjB,MAAM,uBAAuB,CAAC;AAG/B,qBACa,+BAA+B;IAKxC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IAErC,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IAExC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAVpC,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;gBAI9D,MAAM,EAAE,aAAa,EAErB,oBAAoB,EAAE,yCAAyC,EAE/D,uBAAuB,EAAE,qCAAqC,EAE9D,iBAAiB,EAAE,+BAA+B;IAMrE;;OAEG;IACH,MAAM,KAAK,YAAY,IAAI,gBAAgB,CAE1C;IAED;;;OAGG;IACH,OAAO,KAAK,sBAAsB,GAKjC;IAED;;;OAGG;YACW,qBAAqB;IAgBnC;;;;;;;OAOG;IACG,eAAe,CACnB,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC;IAyDlB;;;;;;OAMG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAoBhB;;;;;;OAMG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,sBAAsB,CAAC,EAAE,MAAM,EAC/B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAkChB;;;;;;OAMG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IA+DhB;;;;;OAKG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjF;;;;;OAKG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9E;;;;;;;OAOG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAW3F"}

package/dist/esm/queue/job-status-tracking.backend.service.js

@@ -0,0 +1,281 @@
+/**
+ * Job Status Tracking Backend Service
+ *
+ * Tracks job lifecycle in MongoDB for observability and querying.
+ *
+ * Uses the same pattern as FilesBackendService:
+ * - Get repository via RepositoriesRegistryHandlerBackendService
+ * - Create internal execution context via getOperationPathDefault
+ * - Use direct repository methods (create, read, update)
+ *
+ * This ensures proper authorization flow while keeping the implementation simple.
+ */
+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 * as os from 'os';
+import { SAAS_SERVICE_TYPES } from '../inject/models/service-types.js';
+import { LoggerService } from '../monitoring/logger/services/logger.service.js';
+import { RepositoriesRegistryHandlerBackendService } from '../base-classes/services/repositories/repositories-registry-handler.backend.service.js';
+import { ExecutionContextCreatorBackendService } from '../runtime/services/execution-context-creator.backend.service.js';
+import { ResourcesRegistryBackendService } from '../resources/services/resources-registry.backend.service.js';
+import { JobExecutionStatus, ResourceSerializationUtils, CoreResourceType, CoreResourceOperation, } from '@wildo-ai/saas-models';
+let JobStatusTrackingBackendService = class JobStatusTrackingBackendService {
+    logger;
+    repositoriesRegistry;
+    executionContextCreator;
+    resourcesRegistry;
+    logDebug;
+    constructor(logger, repositoriesRegistry, executionContextCreator, resourcesRegistry) {
+        this.logger = logger;
+        this.repositoriesRegistry = repositoriesRegistry;
+        this.executionContextCreator = executionContextCreator;
+        this.resourcesRegistry = resourcesRegistry;
+        this.logDebug = this.logger.debugByType('JobStatusTrackingBackendService');
+        this.logger.setDebugTypeLogging('JobStatusTrackingBackendService', false);
+    }
+    /**
+     * Get the resource type for this service.
+     */
+    static get resourceType() {
+        return CoreResourceType.JOB_EXECUTIONS;
+    }
+    /**
+     * Get repository for job executions.
+     * Lazy getter to ensure repository is initialized.
+     */
+    get jobExecutionRepository() {
+        return this.repositoriesRegistry.getRepositoryOrThrow(CoreResourceType.JOB_EXECUTIONS, {});
+    }
+    /**
+     * Create an internal execution context for job tracking operations.
+     * Uses default operation path (no variant) following FilesBackendService pattern.
+     */
+    async createInternalContext(operation) {
+        const operationPath = this.resourcesRegistry.getOperationPathDefault(CoreResourceType.JOB_EXECUTIONS, operation);
+        return this.executionContextCreator.createForInternalOperation({
+            operation: operationPath,
+            contextResourcesFieldIdentifier: new Map(),
+            initiatorIds: null,
+            initiatorRoles: [],
+        });
+    }
+    /**
+     * Create job execution record when job is enqueued.
+     *
+     * @param job - Job payload with metadata
+     * @param queueName - Name of queue job was published to
+     * @param options - Optional repository options (for transactions)
+     * @returns MongoDB document ID of created record
+     */
+    async createJobRecord(job, queueName, options) {
+        // Extract identifiers from execution context for querying
+        let organizationId;
+        let userId;
+        if (job.executionContextJson) {
+            try {
+                const ctxData = ResourceSerializationUtils.deserializeExecutionContextData(job.executionContextJson);
+                organizationId = ctxData.initiatorIds?.organizationId;
+                userId = ctxData.initiatorIds?.userId;
+            }
+            catch {
+                this.logger.warn('Failed to deserialize execution context for job tracking', { jobId: job.jobId });
+            }
+        }
+        const now = new Date();
+        // Build record data
+        const createData = {
+            jobId: job.jobId,
+            applicationId: job.applicationId,
+            jobType: job.jobType,
+            operationPathKey: job.operationPathKey,
+            batchRef: job.batchRef,
+            domainCategory: job.domainCategory,
+            organizationId,
+            userId,
+            initiatedBy: job.initiatedBy,
+            status: JobExecutionStatus.QUEUED,
+            queueName,
+            priority: job.priority,
+            maxRetries: job.maxRetries,
+            retryCount: 0,
+            createdAt: now,
+            queuedAt: now,
+            inputPayloadStorageId: job.inputPayloadStorageId,
+        };
+        // Create internal context and execute
+        const context = await this.createInternalContext(CoreResourceOperation.CREATE);
+        const created = await this.jobExecutionRepository.create(context, createData, options);
+        const insertedId = created._id?.toString() ?? created.jobId;
+        this.logDebug('Job execution record created', {
+            jobId: job.jobId,
+            insertedId,
+            queueName,
+        });
+        return insertedId;
+    }
+    /**
+     * Mark job as started when worker begins processing.
+     *
+     * @param jobId - Job identifier
+     * @param workerId - Worker/pod identifier
+     * @param options - Optional repository options
+     */
+    async markStarted(jobId, workerId, options) {
+        const context = await this.createInternalContext(CoreResourceOperation.UPDATE);
+        const updateData = {
+            status: JobExecutionStatus.PROCESSING,
+            startedAt: new Date(),
+            workerId,
+            workerHostname: os.hostname(),
+        };
+        await this.jobExecutionRepository.update(context, { jobId }, updateData, options);
+        this.logDebug('Job marked as started', { jobId, workerId });
+    }
+    /**
+     * Mark job as completed successfully.
+     *
+     * @param jobId - Job identifier
+     * @param outputPayloadStorageId - Optional storage ID for large output
+     * @param options - Optional repository options
+     */
+    async markCompleted(jobId, outputPayloadStorageId, options) {
+        const now = new Date();
+        // Read current state for duration calculation
+        const readContext = await this.createInternalContext(CoreResourceOperation.READ);
+        const execution = await this.jobExecutionRepository.read(readContext, { jobId }, options);
+        const durationMs = execution?.startedAt
+            ? now.getTime() - new Date(execution.startedAt).getTime()
+            : undefined;
+        // Update with completion data
+        const updateContext = await this.createInternalContext(CoreResourceOperation.UPDATE);
+        const updateData = {
+            status: JobExecutionStatus.COMPLETED,
+            completedAt: now,
+            durationMs,
+            outputPayloadStorageId,
+        };
+        await this.jobExecutionRepository.update(updateContext, { jobId }, updateData, options);
+        this.logDebug('Job marked as completed', { jobId, durationMs });
+    }
+    /**
+     * Mark job as failed. Updates retry count and determines next status.
+     *
+     * @param jobId - Job identifier
+     * @param error - WildoError with failure details
+     * @param options - Optional repository options
+     */
+    async markFailed(jobId, error, options) {
+        const now = new Date();
+        // Read current state
+        const readContext = await this.createInternalContext(CoreResourceOperation.READ);
+        const execution = await this.jobExecutionRepository.read(readContext, { jobId }, options);
+        if (!execution) {
+            this.logger.warn('Job execution record not found for failure', { jobId });
+            return;
+        }
+        const newRetryCount = (execution.retryCount ?? 0) + 1;
+        const willRetry = newRetryCount < (execution.maxRetries ?? 0);
+        const durationMs = execution.startedAt
+            ? now.getTime() - new Date(execution.startedAt).getTime()
+            : undefined;
+        // Update with failure data
+        const updateContext = await this.createInternalContext(CoreResourceOperation.UPDATE);
+        const updateData = {
+            status: willRetry ? JobExecutionStatus.RETRYING : JobExecutionStatus.FAILED,
+            completedAt: now,
+            durationMs,
+            retryCount: newRetryCount,
+            lastRetryAt: now,
+            error: {
+                type: error.type,
+                severity: error.severity,
+                operationPathKey: error.operationPathKey,
+                timestamp: error.timestamp,
+                context: error.context,
+                backendActions: error.backendActions,
+                customMessageReference: error.customMessageReference,
+                statusCode: error.statusCode,
+                stack: error.stack,
+                errorHandlingStrategy: error.errorHandlingStrategy,
+                retryPolicy: error.retryPolicy,
+                maxRetries: error.maxRetries,
+                initialDelay: error.initialDelay,
+                baseDelay: error.baseDelay,
+            },
+        };
+        await this.jobExecutionRepository.update(updateContext, { jobId }, updateData, options);
+        this.logDebug('Job marked as failed', {
+            jobId,
+            retryCount: newRetryCount,
+            willRetry,
+            errorType: error.type,
+        });
+    }
+    /**
+     * Mark job as dead-lettered (moved to dead letter queue).
+     *
+     * @param jobId - Job identifier
+     * @param options - Optional repository options
+     */
+    async markDeadLettered(jobId, options) {
+        const context = await this.createInternalContext(CoreResourceOperation.UPDATE);
+        const updateData = {
+            status: JobExecutionStatus.DEAD_LETTER,
+            completedAt: new Date(),
+        };
+        await this.jobExecutionRepository.update(context, { jobId }, updateData, options);
+        this.logDebug('Job marked as dead-lettered', { jobId });
+    }
+    /**
+     * Mark job as cancelled.
+     *
+     * @param jobId - Job identifier
+     * @param options - Optional repository options
+     */
+    async markCancelled(jobId, options) {
+        const context = await this.createInternalContext(CoreResourceOperation.UPDATE);
+        const updateData = {
+            status: JobExecutionStatus.CANCELLED,
+            completedAt: new Date(),
+        };
+        await this.jobExecutionRepository.update(context, { jobId }, updateData, options);
+        this.logDebug('Job marked as cancelled', { jobId });
+    }
+    /**
+     * Get job execution record by jobId.
+     * Useful for status queries and debugging.
+     *
+     * @param jobId - Job identifier
+     * @param options - Optional repository options
+     * @returns Job execution record or null if not found
+     */
+    async getByJobId(jobId, options) {
+        const context = await this.createInternalContext(CoreResourceOperation.READ);
+        const execution = await this.jobExecutionRepository.read(context, { jobId }, options);
+        return execution;
+    }
+};
+JobStatusTrackingBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.ExecutionContextCreatorBackendService)),
+    __param(3, inject(SAAS_SERVICE_TYPES.ResourceRegistryService)),
+    __metadata("design:paramtypes", [LoggerService,
+        RepositoriesRegistryHandlerBackendService,
+        ExecutionContextCreatorBackendService,
+        ResourcesRegistryBackendService])
+], JobStatusTrackingBackendService);
+export { JobStatusTrackingBackendService };
+//# sourceMappingURL=job-status-tracking.backend.service.js.map

package/dist/esm/queue/job-status-tracking.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-status-tracking.backend.service.js","sourceRoot":"","sources":["../../../src/queue/job-status-tracking.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAE7F,OAAO,EAAE,yCAAyC,EAAE,MAAM,qGAAqG,CAAC;AAChK,OAAO,EAAE,qCAAqC,EAAE,MAAM,+EAA+E,CAAC;AACtI,OAAO,EAAE,+BAA+B,EAAE,MAAM,0EAA0E,CAAC;AAE3H,OAAO,EAGL,kBAAkB,EAClB,0BAA0B,EAE1B,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAIxB,IAAM,+BAA+B,GAArC,MAAM,+BAA+B;IAKvB;IAEA;IAEA;IAEA;IAVT,QAAQ,CAA+D;IAEjF,YAEmB,MAAqB,EAErB,oBAA+D,EAE/D,uBAA8D,EAE9D,iBAAkD;QANlD,WAAM,GAAN,MAAM,CAAe;QAErB,yBAAoB,GAApB,oBAAoB,CAA2C;QAE/D,4BAAuB,GAAvB,uBAAuB,CAAuC;QAE9D,sBAAiB,GAAjB,iBAAiB,CAAiC;QAEnE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,iCAAiC,CAAC,CAAC;QAC3E,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,MAAM,KAAK,YAAY;QACrB,OAAO,gBAAgB,CAAC,cAAc,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,IAAY,sBAAsB;QAChC,OAAO,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,CACnD,gBAAgB,CAAC,cAAc,EAC/B,EAA2B,CAC5B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,qBAAqB,CACjC,SAAgC;QAEhC,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,CAClE,gBAAgB,CAAC,cAAc,EAC/B,SAAS,CACV,CAAC;QAEF,OAAO,IAAI,CAAC,uBAAuB,CAAC,0BAA0B,CAAC;YAC7D,SAAS,EAAE,aAAa;YACxB,+BAA+B,EAAE,IAAI,GAAG,EAAE;YAC1C,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,EAAE;SACnB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CACnB,GAAe,EACf,SAAiB,EACjB,OAA2B;QAE3B,0DAA0D;QAC1D,IAAI,cAAkC,CAAC;QACvC,IAAI,MAA0B,CAAC;QAE/B,IAAI,GAAG,CAAC,oBAAoB,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,0BAA0B,CAAC,+BAA+B,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;gBACrG,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC;gBACtD,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0DAA0D,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YACrG,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,oBAAoB;QACpB,MAAM,UAAU,GAA0B;YACxC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,cAAc;YACd,MAAM;YACN,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,MAAM,EAAE,kBAAkB,CAAC,MAAM;YACjC,SAAS;YACT,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,GAAG;YACd,QAAQ,EAAE,GAAG;YACb,qBAAqB,EAAE,GAAG,CAAC,qBAAqB;SACjD,CAAC;QAEF,sCAAsC;QACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CACtD,OAAO,EACP,UAA0B,EAC1B,OAAO,CACR,CAAC;QAEF,MAAM,UAAU,GAAI,OAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC;QAErE,IAAI,CAAC,QAAQ,CAAC,8BAA8B,EAAE;YAC5C,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,UAAU;YACV,SAAS;SACV,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CACf,KAAa,EACb,QAAgB,EAChB,OAA2B;QAE3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE/E,MAAM,UAAU,GAA0B;YACxC,MAAM,EAAE,kBAAkB,CAAC,UAAU;YACrC,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ;YACR,cAAc,EAAE,EAAE,CAAC,QAAQ,EAAE;SAC9B,CAAC;QAEF,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CACtC,OAAO,EACP,EAAE,KAAK,EAAE,EACT,UAAU,EACV,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,uBAAuB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CACjB,KAAa,EACb,sBAA+B,EAC/B,OAA2B;QAE3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,8CAA8C;QAC9C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,IAAI,CACtD,WAAW,EACX,EAAE,KAAK,EAAE,EACT,OAAO,CACR,CAAC;QAEF,MAAM,UAAU,GAAG,SAAS,EAAE,SAAS;YACrC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;YACzD,CAAC,CAAC,SAAS,CAAC;QAEd,8BAA8B;QAC9B,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACrF,MAAM,UAAU,GAA0B;YACxC,MAAM,EAAE,kBAAkB,CAAC,SAAS;YACpC,WAAW,EAAE,GAAG;YAChB,UAAU;YACV,sBAAsB;SACvB,CAAC;QAEF,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CACtC,aAAa,EACb,EAAE,KAAK,EAAE,EACT,UAAU,EACV,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,KAAa,EACb,KAAyB,EACzB,OAA2B;QAE3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAEvB,qBAAqB;QACrB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,IAAI,CACtD,WAAW,EACX,EAAE,KAAK,EAAE,EACT,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,aAAa,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS;YACpC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;YACzD,CAAC,CAAC,SAAS,CAAC;QAEd,2BAA2B;QAC3B,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACrF,MAAM,UAAU,GAA0B;YACxC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM;YAC3E,WAAW,EAAE,GAAG;YAChB,UAAU;YACV,UAAU,EAAE,aAAa;YACzB,WAAW,EAAE,GAAG;YAChB,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,cAAc,EAAE,KAAK,CAAC,cAAc;gBACpC,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;gBACpD,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,qBAAqB,EAAE,KAAK,CAAC,qBAAqB;gBAClD,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B;SACF,CAAC;QAEF,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CACtC,aAAa,EACb,EAAE,KAAK,EAAE,EACT,UAAU,EACV,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,sBAAsB,EAAE;YACpC,KAAK;YACL,UAAU,EAAE,aAAa;YACzB,SAAS;YACT,SAAS,EAAE,KAAK,CAAC,IAAI;SACtB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAAa,EAAE,OAA2B;QAC/D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE/E,MAAM,UAAU,GAA0B;YACxC,MAAM,EAAE,kBAAkB,CAAC,WAAW;YACtC,WAAW,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC;QAEF,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CACtC,OAAO,EACP,EAAE,KAAK,EAAE,EACT,UAAU,EACV,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,KAAa,EAAE,OAA2B;QAC5D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAE/E,MAAM,UAAU,GAA0B;YACxC,MAAM,EAAE,kBAAkB,CAAC,SAAS;YACpC,WAAW,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC;QAEF,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CACtC,OAAO,EACP,EAAE,KAAK,EAAE,EACT,UAAU,EACV,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,OAA2B;QACzD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAE7E,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,IAAI,CACtD,OAAO,EACP,EAAE,KAAK,EAAE,EACT,OAAO,CACR,CAAC;QAEF,OAAO,SAAS,CAAC;IACnB,CAAC;CACF,CAAA;AArVY,+BAA+B;IAD3C,UAAU,EAAE;IAKR,WAAA,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAEjC,WAAA,MAAM,CAAC,kBAAkB,CAAC,kCAAkC,CAAC,CAAA;IAE7D,WAAA,MAAM,CAAC,kBAAkB,CAAC,qCAAqC,CAAC,CAAA;IAEhE,WAAA,MAAM,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAA;qCAL1B,aAAa;QAEC,yCAAyC;QAEtC,qCAAqC;QAE3C,+BAA+B;GAX1D,+BAA+B,CAqV3C"}

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

@@ -0,0 +1,71 @@
+/**
+ * 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.
+ */
+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 { QueueMetrics, QueueHealthSummary, QueueAlertThreshold } from '@wildo-ai/saas-models';
+/**
+ * Alert callback type for queue monitoring.
+ */
+export type QueueAlertCallback = (alertType: string, queueName: string, details: Record<string, unknown>) => void | Promise<void>;
+export declare class QueueMonitoringBackendService {
+    private readonly logger;
+    private readonly configService;
+    private readonly rabbitMQAdapter;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    private alertCallbacks;
+    private alertThresholds;
+    private monitoringInterval;
+    private isMonitoring;
+    constructor(logger: LoggerService, configService: AppConfigurationService, rabbitMQAdapter: RabbitMQAdapterBackendService);
+    /**
+     * Start monitoring queues at the specified interval.
+     */
+    startMonitoring(intervalMs?: number): void;
+    /**
+     * Stop monitoring queues.
+     */
+    stopMonitoring(): void;
+    /**
+     * Register an alert callback.
+     */
+    onAlert(callback: QueueAlertCallback): void;
+    /**
+     * Set alert thresholds for a queue.
+     */
+    setAlertThreshold(queueName: string, threshold: QueueAlertThreshold): void;
+    /**
+     * Get metrics for a specific queue.
+     * Also checks the corresponding dead letter queue if it exists.
+     */
+    getQueueMetrics(queueName: string): Promise<QueueMetrics>;
+    /**
+     * Get health summary for all monitored queues.
+     */
+    getHealthSummary(): Promise<QueueHealthSummary>;
+    /**
+     * Check if RabbitMQ connection is healthy.
+     */
+    isRabbitMQHealthy(): Promise<boolean>;
+    /**
+     * Evaluate queue health based on thresholds.
+     */
+    private evaluateQueueHealth;
+    /**
+     * Check all queues and trigger alerts if needed.
+     */
+    private checkAllQueues;
+    /**
+     * Trigger an alert to all registered callbacks.
+     */
+    private triggerAlert;
+    /**
+     * Create empty metrics for a queue.
+     */
+    private createEmptyMetrics;
+}
+//# sourceMappingURL=queue-monitoring.backend.service.d.ts.map

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

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