@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/queue/scheduled-message-verifier.backend.service.js

@@ -0,0 +1,189 @@
+/**
+ * Scheduled Message Verifier Backend Service
+ *
+ * Verifies JWT signatures on scheduled job messages from crontabs-batches-manager.
+ * Only messages signed by the platform's crontabs-batches-manager are accepted.
+ *
+ * This prevents unauthorized job execution in horizontally scaled K8s environments.
+ */
+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 { JwtBackendService } from '../security/jwt/services/jwt.backend.service.js';
+import { JwtPublicKeys } from '../security/authentications/models/jwt.backend.schemas.js';
+import { ErrorBuilderBackendService } from '../errors/services/error-builder.backend.service.js';
+import { JobType, JobInitiator, ErrorType, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { z } from 'zod';
+/**
+ * Schema for the signed scheduled job token payload.
+ *
+ * This matches what ScheduledJobTokenSignerService in crontabs-batches-manager sends.
+ */
+const ScheduledJobTokenSchema = z.object({
+    /** Job ID (unique per execution) */
+    jobId: z.string().uuid(),
+    /** Application ID the job belongs to */
+    applicationId: z.string(),
+    /** Job type - always SCHEDULED_CRON */
+    jobType: z.literal(JobType.SCHEDULED_CRON),
+    /** Operation path key for resource operations (format: "resource | operation | variantType | variant | isBulk:false") */
+    operationPathKey: z.string().optional(),
+    /** Custom batch reference */
+    batchRef: z.string().optional(),
+    /** Input data for the job (JSON stringified) */
+    inputDataJson: z.string().optional(),
+    /** Token issued at (standard JWT claim) */
+    iat: z.number(),
+    /** Token expiry (standard JWT claim) */
+    exp: z.number(),
+    /** Issuer (should be PLATFORM_CRONTABS_BATCHES_MANAGER) */
+    iss: z.string(),
+    /** Audience (should be SCHEDULED_JOB) */
+    aud: z.string(),
+});
+let ScheduledMessageVerifierBackendService = class ScheduledMessageVerifierBackendService {
+    jwtService;
+    logger;
+    errorBuilder;
+    logDebug;
+    constructor(jwtService, logger, errorBuilder) {
+        this.jwtService = jwtService;
+        this.logger = logger;
+        this.errorBuilder = errorBuilder;
+        this.logDebug = this.logger.debugByType('ScheduledMessageVerifierBackendService');
+        this.logger.setDebugTypeLogging('ScheduledMessageVerifierBackendService', false);
+    }
+    /**
+     * Verify a scheduled job message token.
+     *
+     * @param token - The JWT token from the message
+     * @returns Verification result with token payload if valid
+     */
+    async verifyScheduledMessage(token) {
+        try {
+            // Verify the JWT using the crontabs-batches-manager public key
+            const decoded = await this.jwtService.verify(token, JwtPublicKeys.PLATFORM_CRONTABS_BATCHES_MANAGER);
+            // Parse and validate the token payload
+            const parseResult = ScheduledJobTokenSchema.safeParse(decoded);
+            if (!parseResult.success) {
+                this.logger.warn('Scheduled message token has invalid structure', {
+                    issues: parseResult.error.issues,
+                });
+                return {
+                    isValid: false,
+                    error: 'Invalid token structure',
+                };
+            }
+            const tokenPayload = parseResult.data;
+            // Validate issuer
+            if (tokenPayload.iss !== 'PLATFORM_CRONTABS_BATCHES_MANAGER') {
+                this.logger.warn('Scheduled message has invalid issuer', {
+                    issuer: tokenPayload.iss,
+                });
+                return {
+                    isValid: false,
+                    error: 'Invalid token issuer',
+                };
+            }
+            // Validate audience
+            if (tokenPayload.aud !== 'SCHEDULED_JOB') {
+                this.logger.warn('Scheduled message has invalid audience', {
+                    audience: tokenPayload.aud,
+                });
+                return {
+                    isValid: false,
+                    error: 'Invalid token audience',
+                };
+            }
+            this.logDebug('Scheduled message verified successfully', {
+                jobId: tokenPayload.jobId,
+                hasBatchRef: !!tokenPayload.batchRef,
+                hasOperationPathKey: !!tokenPayload.operationPathKey,
+                applicationId: tokenPayload.applicationId,
+            });
+            return {
+                isValid: true,
+                token: tokenPayload,
+            };
+        }
+        catch (error) {
+            this.logger.warn('Scheduled message verification failed', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return {
+                isValid: false,
+                error: error instanceof Error ? error.message : 'Token verification failed',
+            };
+        }
+    }
+    /**
+     * Convert a verified token to a JobPayload for execution.
+     *
+     * @param token - The verified token payload
+     * @returns JobPayload ready for execution
+     */
+    convertToJobPayload(token) {
+        const now = new Date();
+        return {
+            jobId: token.jobId,
+            jobType: JobType.SCHEDULED_CRON,
+            applicationId: token.applicationId,
+            // operationPathKey is the human-readable key format, NOT JSON
+            // The executor will parse it using ResourcesConfig_OperationPathUtils.parseOperationPathKey()
+            operationPathKey: token.operationPathKey,
+            batchRef: token.batchRef,
+            inputDataJson: token.inputDataJson,
+            initiatedBy: JobInitiator.CRONTAB,
+            priority: 'normal',
+            retryCount: 0,
+            maxRetries: 3,
+            retryDelayMs: 1000,
+            timeoutMs: 300000,
+            createdAt: now,
+        };
+    }
+    /**
+     * Verify and convert a scheduled message in one step.
+     * Throws if verification fails.
+     *
+     * @param token - The JWT token from the message
+     * @returns JobPayload ready for execution
+     * @throws WildoError if verification fails
+     */
+    async verifyAndConvert(token) {
+        const result = await this.verifyScheduledMessage(token);
+        if (!result.isValid || !result.token) {
+            throw this.errorBuilder.buildError(ErrorType.AUTHENTICATION, undefined, {
+                customMessageReference: ErrorCustomMessageReference.AUTHENTICATION_INVALID_TOKEN,
+                context: {
+                    reason: result.error || 'Scheduled message verification failed',
+                    source: 'crontabs-batches-manager',
+                },
+            });
+        }
+        return this.convertToJobPayload(result.token);
+    }
+};
+ScheduledMessageVerifierBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.JwtBackendService)),
+    __param(1, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(2, inject(SAAS_SERVICE_TYPES.ErrorBuilderService)),
+    __metadata("design:paramtypes", [JwtBackendService,
+        LoggerService,
+        ErrorBuilderBackendService])
+], ScheduledMessageVerifierBackendService);
+export { ScheduledMessageVerifierBackendService };
+//# sourceMappingURL=scheduled-message-verifier.backend.service.js.map

package/dist/esm/queue/scheduled-message-verifier.backend.service.js.map

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

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

@@ -0,0 +1,124 @@
+/**
+ * Worker Shutdown Manager Backend Service
+ *
+ * Handles graceful shutdown for queue workers in K8s environment.
+ *
+ * Kubernetes termination flow:
+ * 1. Pod receives SIGTERM
+ * 2. PreStop hook (if configured) gives extra time
+ * 3. terminationGracePeriodSeconds countdown begins
+ * 4. If not terminated, SIGKILL is sent
+ *
+ * Our handling:
+ * 1. Receive SIGTERM
+ * 2. Stop accepting new jobs (via registered stop handlers)
+ * 3. Wait for in-flight jobs to complete (with timeout)
+ * 4. Close connections
+ * 5. Exit cleanly
+ *
+ * Architecture: Uses Registry pattern to avoid circular dependencies.
+ * Components register themselves as "stoppable" via registerStopHandler().
+ */
+import { LoggerService } from '../monitoring/logger/services/logger.service.js';
+import { RabbitMQAdapterBackendService } from './adapters/rabbitmq-adapter.backend.service.js';
+/**
+ * Shutdown configuration.
+ */
+export interface ShutdownConfig {
+    /**
+     * Maximum time to wait for in-flight jobs (default: 25s)
+     * Should be less than K8s terminationGracePeriodSeconds
+     */
+    gracePeriodMs?: number;
+    /**
+     * Interval to check for job completion (default: 500ms)
+     */
+    checkIntervalMs?: number;
+    /**
+     * Exit code on successful shutdown (default: 0)
+     */
+    exitCode?: number;
+}
+/**
+ * Handler called during shutdown (e.g., to stop consuming).
+ * Called BEFORE waiting for in-flight jobs.
+ */
+type StopHandler = () => Promise<void>;
+/**
+ * Handler called during final cleanup (e.g., close connections).
+ * Called AFTER waiting for in-flight jobs.
+ */
+type ShutdownHandler = () => Promise<void>;
+export declare class WorkerShutdownManagerBackendService {
+    private readonly adapter;
+    private readonly logger;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    private isShuttingDown;
+    private inFlightJobCount;
+    /**
+     * Handlers to stop accepting new work (called first).
+     * E.g., JobConsumer.stopConsuming(), DomainQueueConsumer.stopAll()
+     */
+    private stopHandlers;
+    /**
+     * Handlers for final cleanup (called last, in LIFO order).
+     * E.g., close database connections, flush logs
+     */
+    private shutdownHandlers;
+    private signalsRegistered;
+    constructor(adapter: RabbitMQAdapterBackendService, logger: LoggerService);
+    /**
+     * Register shutdown signal handlers.
+     * Should be called once during worker startup.
+     */
+    registerSignalHandlers(config?: ShutdownConfig): void;
+    /**
+     * Register a stop handler (called first during shutdown).
+     * Use for stopping consumers, accepting new requests, etc.
+     * Handlers are called in order of registration.
+     *
+     * @example
+     * // JobConsumer registers itself
+     * shutdownManager.registerStopHandler(() => this.stopConsuming());
+     */
+    registerStopHandler(handler: StopHandler): void;
+    /**
+     * Register a custom shutdown handler (called last during shutdown).
+     * Handlers are called in LIFO order.
+     * Use for final cleanup: close connections, flush logs, etc.
+     */
+    onShutdown(handler: ShutdownHandler): void;
+    /**
+     * Increment in-flight job counter.
+     * Call when a job starts processing.
+     */
+    jobStarted(): void;
+    /**
+     * Decrement in-flight job counter.
+     * Call when a job completes (success or failure).
+     */
+    jobCompleted(): void;
+    /**
+     * Get current in-flight job count.
+     */
+    getInFlightCount(): number;
+    /**
+     * Check if shutdown is in progress.
+     */
+    isShutdownInProgress(): boolean;
+    /**
+     * Initiate graceful shutdown.
+     */
+    initiateShutdown(config: Required<ShutdownConfig>): Promise<void>;
+    /**
+     * Wait for in-flight jobs to complete.
+     * Returns true if all jobs completed, false if timeout.
+     */
+    private waitForInFlightJobs;
+    /**
+     * Force immediate shutdown.
+     */
+    private forceShutdown;
+}
+export {};
+//# sourceMappingURL=worker-shutdown-manager.backend.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-shutdown-manager.backend.service.d.ts","sourceRoot":"","sources":["../../../src/queue/worker-shutdown-manager.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAQD;;;GAGG;AACH,KAAK,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvC;;;GAGG;AACH,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3C,qBACa,mCAAmC;IAqB5C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAtBzB,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,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;OAGG;IACH,OAAO,CAAC,YAAY,CAAqB;IAEzC;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAyB;IAEjD,OAAO,CAAC,iBAAiB,CAAS;gBAIf,OAAO,EAAE,6BAA6B,EAEtC,MAAM,EAAE,aAAa;IAMxC;;;OAGG;IACH,sBAAsB,CAAC,MAAM,GAAE,cAAmB,GAAG,IAAI;IAyCzD;;;;;;;;OAQG;IACH,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAK/C;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;;OAGG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEvE;;;OAGG;YACW,mBAAmB;IAejC;;OAEG;YACW,aAAa;CAW5B"}

package/dist/esm/queue/worker-shutdown-manager.backend.service.js

@@ -0,0 +1,250 @@
+/**
+ * Worker Shutdown Manager Backend Service
+ *
+ * Handles graceful shutdown for queue workers in K8s environment.
+ *
+ * Kubernetes termination flow:
+ * 1. Pod receives SIGTERM
+ * 2. PreStop hook (if configured) gives extra time
+ * 3. terminationGracePeriodSeconds countdown begins
+ * 4. If not terminated, SIGKILL is sent
+ *
+ * Our handling:
+ * 1. Receive SIGTERM
+ * 2. Stop accepting new jobs (via registered stop handlers)
+ * 3. Wait for in-flight jobs to complete (with timeout)
+ * 4. Close connections
+ * 5. Exit cleanly
+ *
+ * Architecture: Uses Registry pattern to avoid circular dependencies.
+ * Components register themselves as "stoppable" via registerStopHandler().
+ */
+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 { RabbitMQAdapterBackendService } from './adapters/rabbitmq-adapter.backend.service.js';
+const DEFAULT_SHUTDOWN_CONFIG = {
+    gracePeriodMs: 25000, // 25 seconds (K8s default is 30s)
+    checkIntervalMs: 500,
+    exitCode: 0,
+};
+let WorkerShutdownManagerBackendService = class WorkerShutdownManagerBackendService {
+    adapter;
+    logger;
+    logDebug;
+    isShuttingDown = false;
+    inFlightJobCount = 0;
+    /**
+     * Handlers to stop accepting new work (called first).
+     * E.g., JobConsumer.stopConsuming(), DomainQueueConsumer.stopAll()
+     */
+    stopHandlers = [];
+    /**
+     * Handlers for final cleanup (called last, in LIFO order).
+     * E.g., close database connections, flush logs
+     */
+    shutdownHandlers = [];
+    signalsRegistered = false;
+    constructor(adapter, logger) {
+        this.adapter = adapter;
+        this.logger = logger;
+        this.logDebug = this.logger.debugByType('WorkerShutdownManagerBackendService');
+        this.logger.setDebugTypeLogging('WorkerShutdownManagerBackendService', false);
+    }
+    /**
+     * Register shutdown signal handlers.
+     * Should be called once during worker startup.
+     */
+    registerSignalHandlers(config = {}) {
+        if (this.signalsRegistered) {
+            this.logger.warn('Shutdown handlers already registered');
+            return;
+        }
+        const mergedConfig = { ...DEFAULT_SHUTDOWN_CONFIG, ...config };
+        // Handle SIGTERM (K8s termination signal)
+        process.on('SIGTERM', async () => {
+            this.logDebug('Received SIGTERM, initiating graceful shutdown');
+            await this.initiateShutdown(mergedConfig);
+        });
+        // Handle SIGINT (Ctrl+C in development)
+        process.on('SIGINT', async () => {
+            this.logDebug('Received SIGINT, initiating graceful shutdown');
+            await this.initiateShutdown(mergedConfig);
+        });
+        // Handle uncaught exceptions
+        process.on('uncaughtException', async (error) => {
+            this.logger.error('Uncaught exception, forcing shutdown', {
+                error: error.message,
+                stack: error.stack,
+            });
+            await this.forceShutdown(1);
+        });
+        // Handle unhandled promise rejections
+        process.on('unhandledRejection', async (reason) => {
+            this.logger.error('Unhandled rejection, forcing shutdown', {
+                reason: reason instanceof Error ? reason.message : String(reason),
+            });
+            await this.forceShutdown(1);
+        });
+        this.signalsRegistered = true;
+        this.logDebug('Shutdown signal handlers registered');
+    }
+    /**
+     * Register a stop handler (called first during shutdown).
+     * Use for stopping consumers, accepting new requests, etc.
+     * Handlers are called in order of registration.
+     *
+     * @example
+     * // JobConsumer registers itself
+     * shutdownManager.registerStopHandler(() => this.stopConsuming());
+     */
+    registerStopHandler(handler) {
+        this.stopHandlers.push(handler);
+        this.logDebug('Stop handler registered', { totalStopHandlers: this.stopHandlers.length });
+    }
+    /**
+     * Register a custom shutdown handler (called last during shutdown).
+     * Handlers are called in LIFO order.
+     * Use for final cleanup: close connections, flush logs, etc.
+     */
+    onShutdown(handler) {
+        this.shutdownHandlers.push(handler);
+    }
+    /**
+     * Increment in-flight job counter.
+     * Call when a job starts processing.
+     */
+    jobStarted() {
+        this.inFlightJobCount++;
+    }
+    /**
+     * Decrement in-flight job counter.
+     * Call when a job completes (success or failure).
+     */
+    jobCompleted() {
+        this.inFlightJobCount = Math.max(0, this.inFlightJobCount - 1);
+    }
+    /**
+     * Get current in-flight job count.
+     */
+    getInFlightCount() {
+        return this.inFlightJobCount;
+    }
+    /**
+     * Check if shutdown is in progress.
+     */
+    isShutdownInProgress() {
+        return this.isShuttingDown;
+    }
+    /**
+     * Initiate graceful shutdown.
+     */
+    async initiateShutdown(config) {
+        if (this.isShuttingDown) {
+            this.logger.warn('Shutdown already in progress');
+            return;
+        }
+        this.isShuttingDown = true;
+        const startTime = Date.now();
+        try {
+            // Step 1: Stop accepting new work (run all stop handlers)
+            this.logDebug('Running stop handlers...', { count: this.stopHandlers.length });
+            for (const handler of this.stopHandlers) {
+                try {
+                    await handler();
+                }
+                catch (error) {
+                    this.logger.error('Stop handler failed', {
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    });
+                }
+            }
+            this.logDebug('Stop handlers completed');
+            // Step 2: Wait for in-flight jobs to complete
+            this.logDebug('Waiting for in-flight jobs...', { count: this.inFlightJobCount });
+            const waitResult = await this.waitForInFlightJobs(config);
+            if (!waitResult) {
+                this.logger.warn('Grace period expired, some jobs may be lost', {
+                    remainingJobs: this.inFlightJobCount,
+                });
+            }
+            // Step 3: Run custom shutdown handlers (LIFO)
+            this.logDebug('Running shutdown handlers...');
+            for (const handler of [...this.shutdownHandlers].reverse()) {
+                try {
+                    await handler();
+                }
+                catch (error) {
+                    this.logger.error('Shutdown handler failed', {
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    });
+                }
+            }
+            // Step 4: Close RabbitMQ connection
+            this.logDebug('Closing RabbitMQ connection...');
+            await this.adapter.close();
+            // Step 5: Exit
+            const duration = Date.now() - startTime;
+            this.logDebug('Graceful shutdown complete', {
+                durationMs: duration,
+                remainingJobs: this.inFlightJobCount,
+            });
+            process.exit(config.exitCode);
+        }
+        catch (error) {
+            this.logger.error('Shutdown error, forcing exit', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            await this.forceShutdown(1);
+        }
+    }
+    /**
+     * Wait for in-flight jobs to complete.
+     * Returns true if all jobs completed, false if timeout.
+     */
+    async waitForInFlightJobs(config) {
+        const deadline = Date.now() + config.gracePeriodMs;
+        while (this.inFlightJobCount > 0 && Date.now() < deadline) {
+            await new Promise(resolve => setTimeout(resolve, config.checkIntervalMs));
+            this.logDebug('Waiting for jobs', {
+                inFlight: this.inFlightJobCount,
+                remainingMs: deadline - Date.now(),
+            });
+        }
+        return this.inFlightJobCount === 0;
+    }
+    /**
+     * Force immediate shutdown.
+     */
+    async forceShutdown(exitCode) {
+        this.logger.error('Forcing shutdown', { exitCode });
+        try {
+            await this.adapter.close();
+        }
+        catch {
+            // Ignore errors during force shutdown
+        }
+        process.exit(exitCode);
+    }
+};
+WorkerShutdownManagerBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.RabbitMQAdapterService)),
+    __param(1, inject(SAAS_SERVICE_TYPES.Logger)),
+    __metadata("design:paramtypes", [RabbitMQAdapterBackendService,
+        LoggerService])
+], WorkerShutdownManagerBackendService);
+export { WorkerShutdownManagerBackendService };
+//# sourceMappingURL=worker-shutdown-manager.backend.service.js.map

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

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

package/dist/esm/requests/models/api-routes.backend.defintions.d.ts

@@ -0,0 +1,34 @@
+export declare const API_ROUTES_BACKEND_DEFINITIONS: {
+    APPS_MANAGER: {
+        GET_APPLICATION_CONFIG: () => string;
+        GET_APPLICATION_SECRETS: () => string;
+        UPDATE_APPLICATION_CONFIG: () => string;
+        UPDATE_APPLICATION_SECRETS: () => string;
+        GET_PLATFORM_SERVICE_CONFIG_SECRETS: () => string;
+        ADMIN_PLATFORM_INITIALIZE: () => string;
+        ADMIN_PLATFORM_PROVISION_SERVICE: () => string;
+        ADMIN_PLATFORM_REFRESH: () => string;
+        ADMIN_APPS_INITIALIZE: () => string;
+        ADMIN_APP_INITIALIZE: (appSlug: string) => string;
+        ADMIN_APP_REFRESH: (appSlug: string) => string;
+        ADMIN_APP_DEPLOY: (appSlug: string) => string;
+        ADMIN_APP_UNDEPLOY: (appSlug: string) => string;
+        ADMIN_APP_STATUS: (appSlug: string) => string;
+        ADMIN_APP_CREDENTIALS: (appSlug: string, env: string) => string;
+        ADMIN_STATUS: () => string;
+    };
+    LIFECYCLE_API: {
+        BASE_PATH: string;
+        HEALTH: () => string;
+        RESOURCES_REGISTRY: () => string;
+        STRUCTURE: () => string;
+        FILES_UPDATE: () => string;
+        FILE_GET: () => string;
+        FILES_LIST: () => string;
+        LABELLING_GENERATE_APP_SPECIFIC: () => string;
+    };
+    FILE_STORAGE: {
+        STORAGE_KEY_APPLICATION_FILE: (appId: string, fileId: string) => string;
+    };
+};
+//# sourceMappingURL=api-routes.backend.defintions.d.ts.map

package/dist/esm/requests/models/api-routes.backend.defintions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-routes.backend.defintions.d.ts","sourceRoot":"","sources":["../../../../src/requests/models/api-routes.backend.defintions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B;;;;;;;;;;;wCAgBH,MAAM;qCACT,MAAM;oCACP,MAAM;sCACJ,MAAM;oCACR,MAAM;yCACD,MAAM,OAAO,MAAM;;;;;;;;;;;;;;8CAoBd,MAAM,UAAU,MAAM;;CAGnE,CAAA"}

package/dist/esm/requests/models/api-routes.backend.defintions.js

@@ -0,0 +1,42 @@
+export const API_ROUTES_BACKEND_DEFINITIONS = {
+    APPS_MANAGER: {
+        // Wildo Applications (called by wildo apps)
+        GET_APPLICATION_CONFIG: () => `/apps-to-manager/application-config`,
+        GET_APPLICATION_SECRETS: () => `/apps-to-manager/application-secrets`,
+        UPDATE_APPLICATION_CONFIG: () => `/apps-to-manager/application-config`,
+        UPDATE_APPLICATION_SECRETS: () => `/apps-to-manager/application-secrets`,
+        // Platform Services (called by platform microservices)
+        GET_PLATFORM_SERVICE_CONFIG_SECRETS: () => `/platform-services-to-manager/config-secrets`,
+        // Admin endpoints (secret-gated, workflow-oriented)
+        ADMIN_PLATFORM_INITIALIZE: () => `/admin/platform/initialize`,
+        ADMIN_PLATFORM_PROVISION_SERVICE: () => `/admin/platform/provision-service`,
+        ADMIN_PLATFORM_REFRESH: () => `/admin/platform/refresh`,
+        ADMIN_APPS_INITIALIZE: () => `/admin/apps/initialize`,
+        ADMIN_APP_INITIALIZE: (appSlug) => `/admin/apps/${appSlug}/initialize`,
+        ADMIN_APP_REFRESH: (appSlug) => `/admin/apps/${appSlug}/refresh`,
+        ADMIN_APP_DEPLOY: (appSlug) => `/admin/apps/${appSlug}/deploy`,
+        ADMIN_APP_UNDEPLOY: (appSlug) => `/admin/apps/${appSlug}/undeploy`,
+        ADMIN_APP_STATUS: (appSlug) => `/admin/apps/${appSlug}/status`,
+        ADMIN_APP_CREDENTIALS: (appSlug, env) => `/admin/apps/${appSlug}/credentials/${env}`,
+        ADMIN_STATUS: () => `/admin/status`,
+    },
+    LIFECYCLE_API: {
+        BASE_PATH: `/api/lifecycle`,
+        // Health
+        HEALTH: () => `/`,
+        // Meta endpoints
+        RESOURCES_REGISTRY: () => `/_meta/resources-registry`,
+        // Structure endpoints
+        STRUCTURE: () => `/structure`,
+        // File operations
+        FILES_UPDATE: () => `/files/update`,
+        FILE_GET: () => `/file`,
+        FILES_LIST: () => `/files/list`,
+        // Labelling operations
+        LABELLING_GENERATE_APP_SPECIFIC: () => `/labelling/generate-app-specific`,
+    },
+    FILE_STORAGE: {
+        STORAGE_KEY_APPLICATION_FILE: (appId, fileId) => `applications/${appId}/files/${fileId}`,
+    },
+};
+//# sourceMappingURL=api-routes.backend.defintions.js.map