dt-common-device 9.1.5 → 9.1.7

package/dist/copilotQueue/examples/CopilotQueue.example.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CopilotQueueExample = void 0;
+const typedi_1 = require("typedi");
+const index_1 = require("../index");
+/**
+ * Example usage of CopilotQueueService
+ * This demonstrates how to use the queue system to handle API requests with FIFO ordering per property
+ */
+class CopilotQueueExample {
+    constructor() {
+        // Get the service instance from the DI container
+        this.copilotQueueService = typedi_1.Container.get(index_1.CopilotQueueService);
+    }
+    /**
+     * Example: Add a simple GET request to the queue
+     */
+    async addGetRequest(propertyId, url) {
+        const request = {
+            url,
+            method: 'GET',
+            propertyId,
+            headers: {
+                'Authorization': 'Bearer your-token-here',
+                'Accept': 'application/json',
+            },
+        };
+        const result = await this.copilotQueueService.addQueueRequest(request);
+        console.log(`GET request queued with job ID: ${result.jobId}`);
+        return result.jobId;
+    }
+    /**
+     * Example: Add a POST request with body to the queue
+     */
+    async addPostRequest(propertyId, url, data) {
+        const request = {
+            url,
+            method: 'POST',
+            propertyId,
+            headers: {
+                'Authorization': 'Bearer your-token-here',
+                'Content-Type': 'application/json',
+            },
+            body: data,
+        };
+        const options = {
+            priority: 1, // Higher priority
+            attempts: 5, // Retry up to 5 times
+            backoff: {
+                type: 'exponential',
+                delay: 3000,
+            },
+        };
+        const result = await this.copilotQueueService.addQueueRequest(request, options);
+        console.log(`POST request queued with job ID: ${result.jobId}`);
+        return result.jobId;
+    }
+    /**
+     * Example: Add multiple requests for different properties
+     * This demonstrates FIFO ordering per property
+     */
+    async addMultipleRequests() {
+        const requests = [
+            { propertyId: 'property-1', url: 'https://api.example.com/endpoint1', method: 'GET' },
+            { propertyId: 'property-2', url: 'https://api.example.com/endpoint2', method: 'POST', body: { data: 'test' } },
+            { propertyId: 'property-1', url: 'https://api.example.com/endpoint3', method: 'PUT', body: { update: 'data' } },
+            { propertyId: 'property-2', url: 'https://api.example.com/endpoint4', method: 'GET' },
+            { propertyId: 'property-1', url: 'https://api.example.com/endpoint5', method: 'DELETE' },
+        ];
+        const jobIds = [];
+        for (const req of requests) {
+            const request = {
+                url: req.url,
+                method: req.method,
+                propertyId: req.propertyId,
+                headers: {
+                    'Authorization': 'Bearer your-token-here',
+                },
+                body: req.body,
+            };
+            const result = await this.copilotQueueService.addQueueRequest(request);
+            jobIds.push(result.jobId);
+            console.log(`Request queued for ${req.propertyId}: ${req.method} ${req.url} (Job ID: ${result.jobId})`);
+        }
+        console.log('All requests queued. Jobs will be processed in FIFO order per property.');
+    }
+    /**
+     * Example: Monitor job status
+     */
+    async monitorJob(jobId) {
+        const status = await this.copilotQueueService.getJobStatus(jobId);
+        console.log('Job Status:', status);
+    }
+    /**
+     * Example: Get all jobs for a specific property
+     */
+    async getPropertyJobs(propertyId) {
+        const jobs = await this.copilotQueueService.getJobsByProperty(propertyId);
+        console.log(`Jobs for property ${propertyId}:`, jobs);
+    }
+    /**
+     * Example: Cancel a job
+     */
+    async cancelJob(jobId) {
+        const cancelled = await this.copilotQueueService.cancelJob(jobId);
+        console.log(`Job ${jobId} cancelled: ${cancelled}`);
+    }
+    /**
+     * Example: Graceful shutdown
+     */
+    async shutdown() {
+        await this.copilotQueueService.shutdown();
+        console.log('CopilotQueue service shutdown complete');
+    }
+}
+exports.CopilotQueueExample = CopilotQueueExample;
+// Usage example
+async function runExample() {
+    const example = new CopilotQueueExample();
+    try {
+        // Add some requests
+        await example.addMultipleRequests();
+        // Wait a bit for processing
+        await new Promise(resolve => setTimeout(resolve, 5000));
+        // Check job status
+        const jobId = await example.addGetRequest('property-1', 'https://api.example.com/test');
+        await example.monitorJob(jobId);
+        // Get jobs for a property
+        await example.getPropertyJobs('property-1');
+    }
+    catch (error) {
+        console.error('Example error:', error);
+    }
+    finally {
+        // Cleanup
+        await example.shutdown();
+    }
+}
+// Uncomment to run the example
+// runExample();

package/dist/copilotQueue/examples/index.d.ts

@@ -0,0 +1 @@
+export * from './CopilotQueue.example';

package/dist/copilotQueue/examples/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./CopilotQueue.example"), exports);

package/dist/copilotQueue/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./interfaces";
+export * from "./services";
+export * from "./types";
+export * from "./utils";

package/dist/copilotQueue/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Main copilot queue exports
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./utils"), exports);

package/dist/copilotQueue/interfaces/ICopilotQueueRequest.d.ts

@@ -0,0 +1,27 @@
+export interface ICopilotQueueRequest {
+    url: string;
+    method: "GET" | "POST" | "PUT" | "DELETE";
+    headers?: Record<string, string>;
+    params?: Record<string, string>;
+    query?: Record<string, string>;
+    body: any;
+    timestamp?: number;
+    jobId?: string;
+}
+export interface ICopilotQueueResponse {
+    success: boolean;
+    data?: any;
+    error?: string;
+    jobId: string;
+    propertyId: string;
+    processingTime?: number;
+}
+export interface ICopilotQueueOptions {
+    delay?: number;
+    priority?: number;
+    attempts?: number;
+    backoff?: {
+        type: "fixed" | "exponential";
+        delay: number;
+    };
+}

package/dist/copilotQueue/interfaces/ICopilotQueueRequest.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/copilotQueue/interfaces/ICopilotQueueService.d.ts

@@ -0,0 +1,24 @@
+import { ICopilotQueueRequest, ICopilotQueueOptions } from "./ICopilotQueueRequest";
+export interface ICopilotQueueService {
+    /**
+     * Add a request to the queue for processing
+     * @param request - The request data including URL, method, headers, and body (with propertyId)
+     * @param options - Optional queue configuration
+     * @returns Promise with job ID and queue response
+     */
+    addQueueRequest(request: ICopilotQueueRequest, options?: ICopilotQueueOptions): Promise<{
+        jobId: string;
+        queued: boolean;
+    }>;
+    /**
+     * Get the status of a queued job
+     * @param jobId - The job ID to check
+     * @returns Promise with job status
+     */
+    getJobStatus(jobId: string): Promise<any>;
+    /**
+     * Shutdown the queue service
+     * @returns Promise that resolves when shutdown is complete
+     */
+    shutdown(): Promise<void>;
+}

package/dist/copilotQueue/interfaces/ICopilotQueueService.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/copilotQueue/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./ICopilotQueueRequest";
+export * from "./ICopilotQueueService";

package/dist/copilotQueue/interfaces/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ICopilotQueueRequest"), exports);
+__exportStar(require("./ICopilotQueueService"), exports);

package/dist/copilotQueue/services/CopilotQueue.service.d.ts

@@ -0,0 +1,13 @@
+import { ICopilotQueueService, ICopilotQueueRequest, ICopilotQueueOptions } from "../interfaces";
+export declare class CopilotQueueService implements ICopilotQueueService {
+    private readonly copilotQueues;
+    private readonly workers;
+    constructor();
+    private processRequest;
+    addQueueRequest(request: ICopilotQueueRequest, options?: ICopilotQueueOptions): Promise<{
+        jobId: string;
+        queued: boolean;
+    }>;
+    getJobStatus(jobId: string): Promise<any>;
+    shutdown(): Promise<void>;
+}

package/dist/copilotQueue/services/CopilotQueue.service.js

@@ -0,0 +1,196 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
+    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
+    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CopilotQueueService = void 0;
+const typedi_1 = require("typedi");
+const axios_1 = __importDefault(require("axios"));
+const config_1 = require("../../config/config");
+const utils_1 = require("../utils");
+let CopilotQueueService = (() => {
+    let _classDecorators = [(0, typedi_1.Service)()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    var CopilotQueueService = _classThis = class {
+        constructor() {
+            this.copilotQueues = new Map(); // BullMQ Queue instances
+            this.workers = new Map(); // BullMQ Worker instances
+        }
+        async processRequest(job) {
+            const { url, method, headers, body } = job.data;
+            const propertyId = body?.propertyId;
+            const startTime = Date.now();
+            try {
+                (0, config_1.getConfig)().LOGGER.info(`Processing request for property ${propertyId}: ${method} ${url}`);
+                // Prepare axios request configuration
+                const axiosConfig = {
+                    method: method.toLowerCase(),
+                    url,
+                    headers: {
+                        "Content-Type": "application/json",
+                        ...headers,
+                    },
+                    timeout: 30000, // 30 second timeout
+                };
+                // Add body for POST, PUT, PATCH requests
+                if (body && ["post", "put", "patch"].includes(method.toLowerCase())) {
+                    axiosConfig.data = body;
+                }
+                // Execute the HTTP request (fire and forget - no response processing)
+                await (0, axios_1.default)(axiosConfig);
+                const responseTime = Date.now() - startTime;
+                (0, config_1.getConfig)().LOGGER.info(`Request executed for property ${propertyId}: ${method} ${url} (${responseTime}ms)`);
+                return {
+                    success: true,
+                    responseTime,
+                };
+            }
+            catch (error) {
+                const responseTime = Date.now() - startTime;
+                const errorMessage = error.response?.data?.message || error.message || "Unknown error";
+                (0, config_1.getConfig)().LOGGER.error(`Request failed for property ${propertyId}: ${errorMessage} (${responseTime}ms)`);
+                return {
+                    success: false,
+                    error: errorMessage,
+                    statusCode: error.response?.status || 500,
+                    responseTime,
+                };
+            }
+        }
+        async addQueueRequest(request, options) {
+            try {
+                // Validate required fields
+                if (!request.url ||
+                    !request.method ||
+                    !request.body ||
+                    !request.body.propertyId) {
+                    throw new Error("Missing required fields: url, method, and body with propertyId are required");
+                }
+                const propertyId = request.body.propertyId;
+                const queueName = utils_1.QueueManager.generateQueueName(propertyId);
+                // Get or create queue and worker using the QueueManager
+                const queue = await utils_1.QueueManager.getOrCreateQueue(queueName, this.copilotQueues);
+                // Create worker for this queue if it doesn't exist
+                await utils_1.QueueManager.getOrCreateWorker(queueName, this.workers, this.copilotQueues, this.processRequest.bind(this));
+                // Prepare job data
+                const jobData = {
+                    url: request.url,
+                    method: request.method,
+                    headers: request.headers,
+                    body: request.body,
+                    timestamp: Date.now(),
+                };
+                // Add job to queue with TTL (similar to WebhookQueueService)
+                const job = await queue.add("copilot-request", jobData, {
+                    removeOnComplete: { age: 5 * 60 }, // Remove after 5 minutes
+                    removeOnFail: { age: 10 * 60 }, // Remove failed jobs after 10 minutes
+                    attempts: 1, // No retries - execute only once
+                    delay: options?.delay || 0,
+                    priority: options?.priority || 0,
+                    // Use propertyId as job group to ensure FIFO ordering per property
+                    jobId: utils_1.QueueManager.generateJobId(propertyId),
+                });
+                (0, config_1.getConfig)().LOGGER.info(`Request queued for property ${propertyId}: ${request.method} ${request.url} (Job ID: ${job.id})`);
+                return {
+                    jobId: job.id,
+                    queued: true,
+                };
+            }
+            catch (error) {
+                (0, config_1.getConfig)().LOGGER.error("Failed to add request to queue:", error.message);
+                throw error;
+            }
+        }
+        async getJobStatus(jobId) {
+            try {
+                // Extract propertyId from jobId (format: propertyId-timestamp-random)
+                const propertyId = utils_1.QueueManager.extractPropertyIdFromJobId(jobId);
+                const queueName = utils_1.QueueManager.generateQueueName(propertyId);
+                // Get or create queue
+                const queue = await utils_1.QueueManager.getOrCreateQueue(queueName, this.copilotQueues);
+                const job = await queue.getJob(jobId);
+                if (!job) {
+                    return { exists: false };
+                }
+                const state = await job.getState();
+                return {
+                    exists: true,
+                    id: job.id,
+                    state,
+                    data: job.data,
+                    progress: job.progress,
+                    returnvalue: job.returnvalue,
+                    failedReason: job.failedReason,
+                    processedOn: job.processedOn,
+                    finishedOn: job.finishedOn,
+                };
+            }
+            catch (error) {
+                (0, config_1.getConfig)().LOGGER.error(`Failed to get job status for ${jobId}:`, error.message);
+                throw error;
+            }
+        }
+        async shutdown() {
+            try {
+                (0, config_1.getConfig)().LOGGER.info("Shutting down CopilotQueue service...");
+                // Close all workers and queues using QueueManager
+                await utils_1.QueueManager.closeAllWorkersAndQueues(this.workers, this.copilotQueues);
+                (0, config_1.getConfig)().LOGGER.info("CopilotQueue service shutdown complete");
+            }
+            catch (error) {
+                (0, config_1.getConfig)().LOGGER.error("Error during CopilotQueue shutdown:", error.message);
+                throw error;
+            }
+        }
+    };
+    __setFunctionName(_classThis, "CopilotQueueService");
+    (() => {
+        const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+        __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+        CopilotQueueService = _classThis = _classDescriptor.value;
+        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        __runInitializers(_classThis, _classExtraInitializers);
+    })();
+    return CopilotQueueService = _classThis;
+})();
+exports.CopilotQueueService = CopilotQueueService;

package/dist/copilotQueue/services/index.d.ts

@@ -0,0 +1 @@
+export * from "./CopilotQueue.service";

package/dist/copilotQueue/services/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./CopilotQueue.service"), exports);

package/dist/copilotQueue/types/copilot.types.d.ts

@@ -0,0 +1,13 @@
+import { Job, Queue, Worker } from "bullmq";
+export interface CopilotJobData {
+    url: string;
+    method: "GET" | "POST" | "PUT" | "DELETE";
+    params?: Record<string, string>;
+    query?: Record<string, string>;
+    headers?: Record<string, string>;
+    body: any;
+    timestamp?: number;
+}
+export type CopilotQueue = Queue<CopilotJobData>;
+export type CopilotWorker = Worker<CopilotJobData>;
+export type CopilotJob = Job<CopilotJobData>;

package/dist/copilotQueue/types/copilot.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/copilotQueue/types/index.d.ts

@@ -0,0 +1 @@
+export * from "./copilot.types";

package/dist/copilotQueue/types/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./copilot.types"), exports);

package/dist/copilotQueue/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./queueManager";

package/dist/copilotQueue/utils/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./queueManager"), exports);

package/dist/copilotQueue/utils/queueManager.d.ts

@@ -0,0 +1,31 @@
+import { Job } from "bullmq";
+export declare class QueueManager {
+    /**
+     * Get or create a BullMQ queue
+     */
+    static getOrCreateQueue(queueKey: string, queues: Map<string, any>): Promise<any>;
+    /**
+     * Get or create a BullMQ worker
+     */
+    static getOrCreateWorker(queueKey: string, workers: Map<string, any>, queues: Map<string, any>, processor: (job: Job) => Promise<any>): Promise<any>;
+    /**
+     * Check if queue is empty and cleanup worker if no jobs are pending
+     */
+    static checkAndCleanupWorker(queueKey: string, workers: Map<string, any>, queues: Map<string, any>): Promise<void>;
+    /**
+     * Close all workers and queues
+     */
+    static closeAllWorkersAndQueues(workers: Map<string, any>, queues: Map<string, any>): Promise<void>;
+    /**
+     * Generate queue name for a property
+     */
+    static generateQueueName(propertyId: string): string;
+    /**
+     * Extract property ID from job ID
+     */
+    static extractPropertyIdFromJobId(jobId: string): string;
+    /**
+     * Generate unique job ID
+     */
+    static generateJobId(propertyId: string): string;
+}