digitaltwin-core 0.14.2 → 1.0.0

package/dist/engine/health.js

@@ -0,0 +1,190 @@
+/**
+ * Health checker with support for custom checks
+ */
+export class HealthChecker {
+    #checks = new Map();
+    #componentCounts;
+    #version;
+    /**
+     * Register a custom health check
+     * @param name Unique name for the check
+     * @param checkFn Function that performs the check
+     *
+     * @example
+     * ```typescript
+     * healthChecker.registerCheck('external-api', async () => {
+     *     try {
+     *         await fetch('https://api.example.com/health')
+     *         return { status: 'up' }
+     *     } catch (error) {
+     *         return { status: 'down', error: error.message }
+     *     }
+     * })
+     * ```
+     */
+    registerCheck(name, checkFn) {
+        this.#checks.set(name, checkFn);
+    }
+    /**
+     * Remove a health check
+     * @param name Name of the check to remove
+     */
+    removeCheck(name) {
+        return this.#checks.delete(name);
+    }
+    /**
+     * Get list of registered check names
+     */
+    getCheckNames() {
+        return Array.from(this.#checks.keys());
+    }
+    /**
+     * Set component counts for health status
+     */
+    setComponentCounts(counts) {
+        this.#componentCounts = counts;
+    }
+    /**
+     * Set version for health status
+     */
+    setVersion(version) {
+        this.#version = version;
+    }
+    /**
+     * Perform all registered health checks
+     */
+    async performCheck() {
+        const checks = {};
+        // Run all checks in parallel
+        const entries = Array.from(this.#checks.entries());
+        const results = await Promise.all(entries.map(async ([name, checkFn]) => {
+            const start = Date.now();
+            try {
+                const result = await checkFn();
+                return [name, { ...result, latency: result.latency ?? Date.now() - start }];
+            }
+            catch (error) {
+                return [
+                    name,
+                    {
+                        status: 'down',
+                        latency: Date.now() - start,
+                        error: error instanceof Error ? error.message : 'Unknown error'
+                    }
+                ];
+            }
+        }));
+        results.forEach(([name, result]) => {
+            checks[name] = result;
+        });
+        // Determine overall status
+        const allChecks = Object.values(checks);
+        const anyDown = allChecks.some(c => c.status === 'down');
+        const databaseDown = checks['database']?.status === 'down';
+        let status;
+        if (databaseDown) {
+            status = 'unhealthy';
+        }
+        else if (anyDown) {
+            status = 'degraded';
+        }
+        else {
+            status = 'healthy';
+        }
+        return {
+            status,
+            timestamp: new Date().toISOString(),
+            uptime: process.uptime(),
+            ...(this.#version && { version: this.#version }),
+            checks,
+            ...(this.#componentCounts && { components: this.#componentCounts })
+        };
+    }
+}
+/**
+ * Create a database health check function
+ */
+export function createDatabaseCheck(db) {
+    return async () => {
+        const start = Date.now();
+        try {
+            // Use doesTableExists as a ping - it will fail if DB is unreachable
+            await db.doesTableExists('_health_check_ping');
+            return { status: 'up', latency: Date.now() - start };
+        }
+        catch (error) {
+            return {
+                status: 'down',
+                latency: Date.now() - start,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    };
+}
+/**
+ * Create a Redis health check function via QueueManager
+ */
+export function createRedisCheck(qm) {
+    return async () => {
+        const start = Date.now();
+        try {
+            await qm.getQueueStats();
+            return { status: 'up', latency: Date.now() - start };
+        }
+        catch (error) {
+            return {
+                status: 'down',
+                latency: Date.now() - start,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    };
+}
+/**
+ * Create a storage health check function
+ */
+export function createStorageCheck(storage) {
+    return async () => {
+        const start = Date.now();
+        try {
+            if ('checkConnection' in storage && typeof storage.checkConnection === 'function') {
+                await storage.checkConnection();
+            }
+            return { status: 'up', latency: Date.now() - start };
+        }
+        catch (error) {
+            return {
+                status: 'down',
+                latency: Date.now() - start,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    };
+}
+/**
+ * Perform deep health check on all services (convenience function)
+ */
+export async function performHealthCheck(database, queueManager, storage, componentCounts, version) {
+    const checker = new HealthChecker();
+    checker.registerCheck('database', createDatabaseCheck(database));
+    if (queueManager) {
+        checker.registerCheck('redis', createRedisCheck(queueManager));
+    }
+    if (storage) {
+        checker.registerCheck('storage', createStorageCheck(storage));
+    }
+    if (componentCounts) {
+        checker.setComponentCounts(componentCounts);
+    }
+    if (version) {
+        checker.setVersion(version);
+    }
+    return checker.performCheck();
+}
+/**
+ * Simple liveness check - always returns ok if process is running
+ */
+export function livenessCheck() {
+    return { status: 'ok' };
+}
+//# sourceMappingURL=health.js.map

package/dist/engine/health.js.map

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

package/dist/engine/initializer.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Component initialization utilities for the digital twin engine
+ *
+ * This module handles the setup and initialization of digital twin components,
+ * including database table creation and dependency injection.
+ */
+import type { Collector } from '../components/collector.js';
+import type { Harvester } from '../components/harvester.js';
+import type { AssetsManager } from '../components/assets_manager.js';
+import type { DatabaseAdapter } from '../database/database_adapter.js';
+import type { StorageService } from '../storage/storage_service.js';
+/**
+ * Initializes data collection and processing components with required dependencies.
+ *
+ * This function sets up collectors and harvesters by:
+ * 1. Creating necessary database tables for each component
+ * 2. Running automatic schema migrations if enabled
+ * 3. Injecting database and storage service dependencies
+ *
+ * @param components - Array of collectors and harvesters to initialize
+ * @param database - Database adapter instance for data storage
+ * @param storage - Storage service instance for file operations
+ * @param autoMigration - Enable automatic schema migration (default: true)
+ *
+ * @throws {Error} When database table creation fails
+ *
+ * @example
+ * ```typescript
+ * const components = [weatherCollector, trafficHarvester];
+ * const database = new KnexDatabaseAdapter(config);
+ * const storage = new LocalStorageService();
+ *
+ * await initializeComponents(components, database, storage, true);
+ * // Components are now ready to process data
+ * ```
+ */
+export declare function initializeComponents(components: Array<Collector | Harvester>, database: DatabaseAdapter, storage: StorageService, autoMigration?: boolean): Promise<void>;
+/**
+ * Initializes asset management components with required dependencies.
+ *
+ * Asset managers handle file-based resources (like 3D models, tilesets, maps)
+ * and require both database access for metadata and storage for file operations.
+ *
+ * @param assetsManagers - Array of asset managers to initialize
+ * @param database - Database adapter instance for metadata storage
+ * @param storage - Storage service instance for asset file operations
+ * @param autoMigration - Enable automatic schema migration (default: true)
+ *
+ * @throws {Error} When database table creation fails
+ *
+ * @example
+ * ```typescript
+ * const managers = [tilesetManager, pointCloudManager];
+ * const database = new KnexDatabaseAdapter(config);
+ * const storage = new OvhS3StorageService(credentials);
+ *
+ * await initializeAssetsManagers(managers, database, storage, true);
+ * // Asset managers are now ready to handle file operations
+ * ```
+ */
+export declare function initializeAssetsManagers(assetsManagers: AssetsManager[], database: DatabaseAdapter, storage: StorageService, autoMigration?: boolean): Promise<void>;
+//# sourceMappingURL=initializer.d.ts.map

package/dist/engine/initializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializer.d.ts","sourceRoot":"","sources":["../../src/engine/initializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,oBAAoB,CACtC,UAAU,EAAE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC,EACxC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,cAAc,EACvB,aAAa,GAAE,OAAc,GAC9B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,wBAAwB,CAC1C,cAAc,EAAE,aAAa,EAAE,EAC/B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,cAAc,EACvB,aAAa,GAAE,OAAc,GAC9B,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/engine/initializer.js

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview Component initialization utilities for the digital twin engine
+ *
+ * This module handles the setup and initialization of digital twin components,
+ * including database table creation and dependency injection.
+ */
+/**
+ * Initializes data collection and processing components with required dependencies.
+ *
+ * This function sets up collectors and harvesters by:
+ * 1. Creating necessary database tables for each component
+ * 2. Running automatic schema migrations if enabled
+ * 3. Injecting database and storage service dependencies
+ *
+ * @param components - Array of collectors and harvesters to initialize
+ * @param database - Database adapter instance for data storage
+ * @param storage - Storage service instance for file operations
+ * @param autoMigration - Enable automatic schema migration (default: true)
+ *
+ * @throws {Error} When database table creation fails
+ *
+ * @example
+ * ```typescript
+ * const components = [weatherCollector, trafficHarvester];
+ * const database = new KnexDatabaseAdapter(config);
+ * const storage = new LocalStorageService();
+ *
+ * await initializeComponents(components, database, storage, true);
+ * // Components are now ready to process data
+ * ```
+ */
+export async function initializeComponents(components, database, storage, autoMigration = true) {
+    for (const comp of components) {
+        const config = comp.getConfiguration();
+        await ensureTableExists(database, config.name, autoMigration);
+        comp.setDependencies(database, storage);
+    }
+}
+/**
+ * Initializes asset management components with required dependencies.
+ *
+ * Asset managers handle file-based resources (like 3D models, tilesets, maps)
+ * and require both database access for metadata and storage for file operations.
+ *
+ * @param assetsManagers - Array of asset managers to initialize
+ * @param database - Database adapter instance for metadata storage
+ * @param storage - Storage service instance for asset file operations
+ * @param autoMigration - Enable automatic schema migration (default: true)
+ *
+ * @throws {Error} When database table creation fails
+ *
+ * @example
+ * ```typescript
+ * const managers = [tilesetManager, pointCloudManager];
+ * const database = new KnexDatabaseAdapter(config);
+ * const storage = new OvhS3StorageService(credentials);
+ *
+ * await initializeAssetsManagers(managers, database, storage, true);
+ * // Asset managers are now ready to handle file operations
+ * ```
+ */
+export async function initializeAssetsManagers(assetsManagers, database, storage, autoMigration = true) {
+    for (const manager of assetsManagers) {
+        const config = manager.getConfiguration();
+        await ensureTableExists(database, config.name, autoMigration);
+        manager.setDependencies(database, storage);
+    }
+}
+/**
+ * Ensures a database table exists for the specified component.
+ *
+ * Checks if a table exists in the database and creates it if missing.
+ * If autoMigration is enabled and table exists, runs schema migration.
+ * This function is called during component initialization to ensure
+ * each component has its required storage table available.
+ *
+ * @param database - Database adapter to check/create table with
+ * @param tableName - Name of the table to ensure exists
+ * @param autoMigration - Enable automatic schema migration for existing tables
+ *
+ * @throws {Error} When table creation or migration fails
+ *
+ * @example
+ * ```typescript
+ * // Internal usage during component initialization
+ * await ensureTableExists(database, 'weather_data_collector', true);
+ * // Table now exists and schema is up-to-date
+ * ```
+ *
+ * @internal This function is used internally by initialization functions
+ */
+async function ensureTableExists(database, tableName, autoMigration = true) {
+    const exists = await database.doesTableExists(tableName);
+    if (!exists) {
+        await database.createTable(tableName);
+        if (process.env.NODE_ENV !== 'test') {
+            console.log(`[DigitalTwin] Created table "${tableName}"`);
+        }
+    }
+    else if (autoMigration) {
+        // Table exists, run migration to add missing columns/indexes
+        const migrations = await database.migrateTableSchema(tableName);
+        if (migrations.length > 0 && process.env.NODE_ENV !== 'test') {
+            console.log(`[DigitalTwin] Migrated "${tableName}": ${migrations.join(', ')}`);
+        }
+    }
+}
+//# sourceMappingURL=initializer.js.map

package/dist/engine/initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializer.js","sourceRoot":"","sources":["../../src/engine/initializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,UAAwC,EACxC,QAAyB,EACzB,OAAuB,EACvB,gBAAyB,IAAI;IAE7B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACtC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QAC7D,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,cAA+B,EAC/B,QAAyB,EACzB,OAAuB,EACvB,gBAAyB,IAAI;IAE7B,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAA;QACzC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;QAC7D,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,KAAK,UAAU,iBAAiB,CAC5B,QAAyB,EACzB,SAAiB,EACjB,gBAAyB,IAAI;IAE7B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;QACrC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,gCAAgC,SAAS,GAAG,CAAC,CAAA;QAC7D,CAAC;IACL,CAAC;SAAM,IAAI,aAAa,EAAE,CAAC;QACvB,6DAA6D;QAC7D,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAC/D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,2BAA2B,SAAS,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAClF,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/engine/queue_manager.d.ts

@@ -0,0 +1,87 @@
+import type { QueueOptions, ConnectionOptions } from 'bullmq';
+import { Queue } from 'bullmq';
+/**
+ * Configuration options for the Queue Manager
+ */
+export interface QueueConfig {
+    /** Number of workers for collectors (data collection) */
+    collectorWorkers?: number;
+    /** Number of workers for harvesters (data processing) */
+    harvesterWorkers?: number;
+    /** Redis connection configuration */
+    redis?: ConnectionOptions;
+    /** Advanced options for each queue type */
+    queueOptions?: {
+        collectors?: Partial<QueueOptions>;
+        harvesters?: Partial<QueueOptions>;
+        priority?: Partial<QueueOptions>;
+        uploads?: Partial<QueueOptions>;
+    };
+}
+/**
+ * Queue Manager - Manages BullMQ queues for different component types
+ *
+ * Handles three types of queues:
+ * - Collector queue: High priority, fast execution for data collection
+ * - Harvester queue: Medium priority, slower processing for data transformation
+ * - Priority queue: Urgent/manual jobs with highest priority
+ *
+ * @example
+ * ```typescript
+ * const queueManager = new QueueManager({
+ *   redis: { host: 'localhost', port: 6379 },
+ *   collectorWorkers: 3,
+ *   harvesterWorkers: 2
+ * })
+ *
+ * await queueManager.close()
+ * ```
+ */
+export declare class QueueManager {
+    #private;
+    readonly collectorQueue: Queue;
+    readonly harvesterQueue: Queue;
+    readonly priorityQueue: Queue;
+    readonly uploadQueue: Queue;
+    /**
+     * Creates a new Queue Manager instance
+     * @param config - Queue configuration options
+     */
+    constructor(config?: QueueConfig);
+    /**
+     * Closes all queues gracefully
+     * @returns Promise that resolves when all queues are closed
+     */
+    close(): Promise<void>;
+    /**
+     * Gets statistics for all queues
+     * @returns Object containing stats for each queue type
+     */
+    getQueueStats(): Promise<{
+        collectors: {
+            waiting: number;
+            active: number;
+            completed: number;
+            failed: number;
+        };
+        harvesters: {
+            waiting: number;
+            active: number;
+            completed: number;
+            failed: number;
+        };
+        priority: {
+            waiting: number;
+            active: number;
+            completed: number;
+            failed: number;
+        };
+        uploads: {
+            waiting: number;
+            active: number;
+            completed: number;
+            failed: number;
+        };
+    }>;
+}
+//# sourceMappingURL=queue_manager.d.ts.map

package/dist/engine/queue_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue_manager.d.ts","sourceRoot":"","sources":["../../src/engine/queue_manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qCAAqC;IACrC,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,2CAA2C;IAC3C,YAAY,CAAC,EAAE;QACX,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;QAClC,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;QAClC,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;QAChC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;KAClC,CAAA;CACJ;AAyCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;;IACrB,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAA;IAC9B,QAAQ,CAAC,cAAc,EAAE,KAAK,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAA;IAE3B;;;OAGG;gBACS,MAAM,GAAE,WAAgB;IA6EpC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B5B;;;OAGG;IACG,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BtB"}

package/dist/engine/queue_manager.js

@@ -0,0 +1,196 @@
+import { Queue } from 'bullmq';
+/**
+ * Queue configuration constants
+ */
+const QUEUE_DEFAULTS = {
+    REDIS: {
+        host: 'localhost',
+        port: 6379,
+        maxRetriesPerRequest: null,
+        enableReadyCheck: true,
+        retryStrategy: (times) => Math.min(times * 50, 2000)
+    },
+    COLLECTORS: {
+        name: 'dt-collectors',
+        attempts: 3,
+        backoffDelay: 2000,
+        keepCompleted: 100,
+        keepFailed: 50
+    },
+    HARVESTERS: {
+        name: 'dt-harvesters',
+        attempts: 5,
+        backoffDelay: 5000,
+        keepCompleted: 50,
+        keepFailed: 100
+    },
+    PRIORITY: {
+        name: 'dt-priority',
+        attempts: 2,
+        priority: 1
+    },
+    UPLOADS: {
+        name: 'dt-uploads',
+        attempts: 1, // No retries - temp file is deleted after first attempt
+        backoffDelay: 10000,
+        keepCompleted: 50,
+        keepFailed: 100
+    }
+};
+/**
+ * Queue Manager - Manages BullMQ queues for different component types
+ *
+ * Handles three types of queues:
+ * - Collector queue: High priority, fast execution for data collection
+ * - Harvester queue: Medium priority, slower processing for data transformation
+ * - Priority queue: Urgent/manual jobs with highest priority
+ *
+ * @example
+ * ```typescript
+ * const queueManager = new QueueManager({
+ *   redis: { host: 'localhost', port: 6379 },
+ *   collectorWorkers: 3,
+ *   harvesterWorkers: 2
+ * })
+ *
+ * await queueManager.close()
+ * ```
+ */
+export class QueueManager {
+    /**
+     * Creates a new Queue Manager instance
+     * @param config - Queue configuration options
+     */
+    constructor(config = {}) {
+        const baseConnection = config.redis || QUEUE_DEFAULTS.REDIS;
+        this.collectorQueue = this.#createCollectorQueue(baseConnection, config.queueOptions?.collectors);
+        this.harvesterQueue = this.#createHarvesterQueue(baseConnection, config.queueOptions?.harvesters);
+        this.priorityQueue = this.#createPriorityQueue(baseConnection, config.queueOptions?.priority);
+        this.uploadQueue = this.#createUploadQueue(baseConnection, config.queueOptions?.uploads);
+    }
+    /**
+     * Creates collector queue with optimized settings for data collection
+     * @private
+     */
+    #createCollectorQueue(connection, options) {
+        return new Queue(QUEUE_DEFAULTS.COLLECTORS.name, {
+            connection,
+            defaultJobOptions: {
+                attempts: QUEUE_DEFAULTS.COLLECTORS.attempts,
+                backoff: { type: 'exponential', delay: QUEUE_DEFAULTS.COLLECTORS.backoffDelay },
+                removeOnComplete: { count: QUEUE_DEFAULTS.COLLECTORS.keepCompleted },
+                removeOnFail: { count: QUEUE_DEFAULTS.COLLECTORS.keepFailed }
+            },
+            ...options
+        });
+    }
+    /**
+     * Creates harvester queue with settings optimized for data processing
+     * @private
+     */
+    #createHarvesterQueue(connection, options) {
+        return new Queue(QUEUE_DEFAULTS.HARVESTERS.name, {
+            connection,
+            defaultJobOptions: {
+                attempts: QUEUE_DEFAULTS.HARVESTERS.attempts,
+                backoff: { type: 'exponential', delay: QUEUE_DEFAULTS.HARVESTERS.backoffDelay },
+                removeOnComplete: { count: QUEUE_DEFAULTS.HARVESTERS.keepCompleted },
+                removeOnFail: { count: QUEUE_DEFAULTS.HARVESTERS.keepFailed }
+            },
+            ...options
+        });
+    }
+    /**
+     * Creates priority queue for urgent/manual jobs
+     * @private
+     */
+    #createPriorityQueue(connection, options) {
+        return new Queue(QUEUE_DEFAULTS.PRIORITY.name, {
+            connection,
+            defaultJobOptions: {
+                priority: QUEUE_DEFAULTS.PRIORITY.priority,
+                attempts: QUEUE_DEFAULTS.PRIORITY.attempts,
+                removeOnComplete: true,
+                removeOnFail: false
+            },
+            ...options
+        });
+    }
+    /**
+     * Creates upload queue for async file processing (tileset extraction, large uploads)
+     * @private
+     */
+    #createUploadQueue(connection, options) {
+        return new Queue(QUEUE_DEFAULTS.UPLOADS.name, {
+            connection,
+            defaultJobOptions: {
+                attempts: QUEUE_DEFAULTS.UPLOADS.attempts,
+                backoff: { type: 'exponential', delay: QUEUE_DEFAULTS.UPLOADS.backoffDelay },
+                removeOnComplete: { count: QUEUE_DEFAULTS.UPLOADS.keepCompleted },
+                removeOnFail: { count: QUEUE_DEFAULTS.UPLOADS.keepFailed }
+            },
+            ...options
+        });
+    }
+    /**
+     * Closes all queues gracefully
+     * @returns Promise that resolves when all queues are closed
+     */
+    async close() {
+        const closePromises = [];
+        // Close all queues with timeout protection
+        const queues = [this.collectorQueue, this.harvesterQueue, this.priorityQueue, this.uploadQueue];
+        for (const queue of queues) {
+            closePromises.push(Promise.race([
+                queue.close(),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('Queue close timeout')), 3000))
+            ]).catch(async () => {
+                // Force close if timeout - try to access Redis connection directly
+                try {
+                    const redisConnection = queue.redisConnection;
+                    if (redisConnection && typeof redisConnection.disconnect === 'function') {
+                        await redisConnection.disconnect();
+                    }
+                }
+                catch {
+                    // Ignore forced cleanup errors
+                }
+            }));
+        }
+        await Promise.all(closePromises);
+        // Wait for connections to fully close
+        await new Promise(resolve => setTimeout(resolve, 300));
+    }
+    /**
+     * Gets statistics for all queues
+     * @returns Object containing stats for each queue type
+     */
+    async getQueueStats() {
+        const [collectorStats, harvesterStats, priorityStats, uploadStats] = await Promise.all([
+            this.#getStats(this.collectorQueue),
+            this.#getStats(this.harvesterQueue),
+            this.#getStats(this.priorityQueue),
+            this.#getStats(this.uploadQueue)
+        ]);
+        return {
+            collectors: collectorStats,
+            harvesters: harvesterStats,
+            priority: priorityStats,
+            uploads: uploadStats
+        };
+    }
+    /**
+     * Gets statistics for a specific queue
+     * @private
+     */
+    async #getStats(queue) {
+        const [waiting, active, completed, failed] = await Promise.all([
+            queue.getWaitingCount(),
+            queue.getActiveCount(),
+            queue.getCompletedCount(),
+            queue.getFailedCount()
+        ]);
+        return { waiting, active, completed, failed };
+    }
+}
+//# sourceMappingURL=queue_manager.js.map

package/dist/engine/queue_manager.js.map

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