@cepseudo/engine 1.0.0

package/dist/health.d.ts

@@ -0,0 +1,112 @@
+import type { DatabaseAdapter } from '@cepseudo/database';
+import type { QueueManager } from './queue_manager.js';
+import type { StorageService } from '@cepseudo/storage';
+/**
+ * Individual health check result
+ */
+export interface HealthCheck {
+    /** Status of the check */
+    status: 'up' | 'down';
+    /** Response latency in milliseconds */
+    latency?: number;
+    /** Error message if status is down */
+    error?: string;
+}
+/**
+ * Component counts for health status
+ */
+export interface ComponentCounts {
+    collectors: number;
+    harvesters: number;
+    handlers: number;
+    assetsManagers: number;
+}
+/**
+ * Full health status response
+ */
+export interface HealthStatus {
+    /** Overall status */
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    /** ISO timestamp of the check */
+    timestamp: string;
+    /** Process uptime in seconds */
+    uptime: number;
+    /** Package version if available */
+    version?: string;
+    /** Individual service checks */
+    checks: Record<string, HealthCheck>;
+    /** Component counts */
+    components?: ComponentCounts;
+}
+/**
+ * Custom health check function type
+ */
+export type HealthCheckFn = () => Promise<HealthCheck>;
+/**
+ * Health checker with support for custom checks
+ */
+export declare class HealthChecker {
+    #private;
+    /**
+     * 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: string, checkFn: HealthCheckFn): void;
+    /**
+     * Remove a health check
+     * @param name Name of the check to remove
+     */
+    removeCheck(name: string): boolean;
+    /**
+     * Get list of registered check names
+     */
+    getCheckNames(): string[];
+    /**
+     * Set component counts for health status
+     */
+    setComponentCounts(counts: ComponentCounts): void;
+    /**
+     * Set version for health status
+     */
+    setVersion(version: string): void;
+    /**
+     * Perform all registered health checks
+     */
+    performCheck(): Promise<HealthStatus>;
+}
+/**
+ * Create a database health check function
+ */
+export declare function createDatabaseCheck(db: DatabaseAdapter): HealthCheckFn;
+/**
+ * Create a Redis health check function via QueueManager
+ */
+export declare function createRedisCheck(qm: QueueManager): HealthCheckFn;
+/**
+ * Create a storage health check function
+ */
+export declare function createStorageCheck(storage: StorageService): HealthCheckFn;
+/**
+ * Perform deep health check on all services (convenience function)
+ */
+export declare function performHealthCheck(database: DatabaseAdapter, queueManager?: QueueManager | null, storage?: StorageService, componentCounts?: ComponentCounts, version?: string): Promise<HealthStatus>;
+/**
+ * Simple liveness check - always returns ok if process is running
+ */
+export declare function livenessCheck(): {
+    status: 'ok';
+};
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,0BAA0B;IAC1B,MAAM,EAAE,IAAI,GAAG,MAAM,CAAA;IACrB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,qBAAqB;IACrB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;IAC5C,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACnC,uBAAuB;IACvB,UAAU,CAAC,EAAE,eAAe,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;AAEtD;;GAEG;AACH,qBAAa,aAAa;;IAKtB;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAIzD;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIjD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;CAmD9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,eAAe,GAAG,aAAa,CAetE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,aAAa,CAchE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAgBzE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,eAAe,EACzB,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,EAClC,OAAO,CAAC,EAAE,cAAc,EACxB,eAAe,CAAC,EAAE,eAAe,EACjC,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,CAAC,CAsBvB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAEhD"}

package/dist/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/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAiDA;;GAEG;AACH,MAAM,OAAO,aAAa;IACb,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAA;IACnD,gBAAgB,CAAkB;IAClC,QAAQ,CAAS;IAEjB;;;;;;;;;;;;;;;;OAgBG;IACH,aAAa,CAAC,IAAY,EAAE,OAAsB;QAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACnC,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAED;;OAEG;IACH,aAAa;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAAuB;QACtC,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QACd,MAAM,MAAM,GAAgC,EAAE,CAAA;QAE9C,6BAA6B;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QAClD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACxB,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAA;gBAC9B,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAU,CAAA;YACxF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO;oBACH,IAAI;oBACJ;wBACI,MAAM,EAAE,MAAe;wBACvB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;wBAC3B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;qBAClE;iBACK,CAAA;YACd,CAAC;QACL,CAAC,CAAC,CACL,CAAA;QAED,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;YAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAA;QACzB,CAAC,CAAC,CAAA;QAEF,2BAA2B;QAC3B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACvC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAA;QACxD,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;QAE1D,IAAI,MAA8B,CAAA;QAClC,IAAI,YAAY,EAAE,CAAC;YACf,MAAM,GAAG,WAAW,CAAA;QACxB,CAAC;aAAM,IAAI,OAAO,EAAE,CAAC;YACjB,MAAM,GAAG,UAAU,CAAA;QACvB,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,SAAS,CAAA;QACtB,CAAC;QAED,OAAO;YACH,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;YACxB,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChD,MAAM;YACN,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;SACtE,CAAA;IACL,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAmB;IACnD,OAAO,KAAK,IAAI,EAAE;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,IAAI,CAAC;YACD,oEAAoE;YACpE,MAAM,EAAE,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAA;YAC9C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC3B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAClE,CAAA;QACL,CAAC;IACL,CAAC,CAAA;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAgB;IAC7C,OAAO,KAAK,IAAI,EAAE;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,IAAI,CAAC;YACD,MAAM,EAAE,CAAC,aAAa,EAAE,CAAA;YACxB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC3B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAClE,CAAA;QACL,CAAC;IACL,CAAC,CAAA;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAuB;IACtD,OAAO,KAAK,IAAI,EAAE;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,IAAI,CAAC;YACD,IAAI,iBAAiB,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;gBAChF,MAAO,OAAgD,CAAC,eAAe,EAAE,CAAA;YAC7E,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC3B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAClE,CAAA;QACL,CAAC;IACL,CAAC,CAAA;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,QAAyB,EACzB,YAAkC,EAClC,OAAwB,EACxB,eAAiC,EACjC,OAAgB;IAEhB,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAA;IAEnC,OAAO,CAAC,aAAa,CAAC,UAAU,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEhE,IAAI,YAAY,EAAE,CAAC;QACf,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAA;IAClE,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAA;IACjE,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QAClB,OAAO,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO,OAAO,CAAC,YAAY,EAAE,CAAA;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { DigitalTwinEngine } from './digital_twin_engine.js';
+export type { EngineOptions, ComponentValidationResult } from './digital_twin_engine.js';
+export { scheduleComponents } from './scheduler.js';
+export { QueueManager } from './queue_manager.js';
+export type { QueueConfig } from './queue_manager.js';
+export { detectComponentType, isCollector, isHarvester, isHandler, isAssetsManager, isCustomTableManager, isActiveComponent } from './component_types.js';
+export type { AnyComponent, ComponentTypeName, SchedulableComponent, ActiveComponent, ComponentTypeMap, LoadedComponents } from './component_types.js';
+export { initializeComponents, initializeAssetsManagers } from './initializer.js';
+export { exposeEndpoints } from './endpoints.js';
+export { HealthChecker, createDatabaseCheck, createRedisCheck, createStorageCheck, performHealthCheck, livenessCheck } from './health.js';
+export type { HealthCheckFn, HealthCheck, HealthStatus, ComponentCounts } from './health.js';
+export { errorHandler, asyncHandler, notFoundHandler } from './error_handler.js';
+export { setupGracefulShutdown } from './graceful_shutdown.js';
+export type { ShutdownOptions } from './graceful_shutdown.js';
+export { GlobalAssetsHandler } from './global_assets_handler.js';
+export { loadComponents } from './loader/component_loader.js';
+export type { LoadComponentsOptions, LoadComponentsResult } from './loader/component_loader.js';
+export { OpenAPIGenerator } from './openapi/generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,YAAY,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAGxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGrD,OAAO,EACH,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACpB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACR,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EACnB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAGjF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGhD,OAAO,EACH,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EAChB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAG5F,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAG7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAG/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -0,0 +1,25 @@
+// Engine
+export { DigitalTwinEngine } from './digital_twin_engine.js';
+// Scheduler
+export { scheduleComponents } from './scheduler.js';
+// Queue Manager
+export { QueueManager } from './queue_manager.js';
+// Component Types & Guards
+export { detectComponentType, isCollector, isHarvester, isHandler, isAssetsManager, isCustomTableManager, isActiveComponent } from './component_types.js';
+// Initializer
+export { initializeComponents, initializeAssetsManagers } from './initializer.js';
+// Endpoints
+export { exposeEndpoints } from './endpoints.js';
+// Health
+export { HealthChecker, createDatabaseCheck, createRedisCheck, createStorageCheck, performHealthCheck, livenessCheck } from './health.js';
+// Error Handler
+export { errorHandler, asyncHandler, notFoundHandler } from './error_handler.js';
+// Graceful Shutdown
+export { setupGracefulShutdown } from './graceful_shutdown.js';
+// Global Assets Handler
+export { GlobalAssetsHandler } from './global_assets_handler.js';
+// Component Loader
+export { loadComponents } from './loader/component_loader.js';
+// OpenAPI Generator
+export { OpenAPIGenerator } from './openapi/generator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAG5D,YAAY;AACZ,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEnD,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGjD,2BAA2B;AAC3B,OAAO,EACH,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACpB,MAAM,sBAAsB,CAAA;AAU7B,cAAc;AACd,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAEjF,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD,SAAS;AACT,OAAO,EACH,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EAChB,MAAM,aAAa,CAAA;AAGpB,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEhF,oBAAoB;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAG9D,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAG7D,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/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, Harvester } from '@cepseudo/components';
+import type { AssetsManager } from '@cepseudo/assets';
+import type { DatabaseAdapter } from '@cepseudo/database';
+import type { StorageService } from '@cepseudo/storage';
+import type { AuthMiddleware } from '@cepseudo/auth';
+/**
+ * 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, authMiddleware?: AuthMiddleware): Promise<void>;
+//# sourceMappingURL=initializer.d.ts.map

package/dist/initializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializer.d.ts","sourceRoot":"","sources":["../src/initializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;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,CAQf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,wBAAwB,CAC1C,cAAc,EAAE,aAAa,EAAE,EAC/B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,cAAc,EACvB,aAAa,GAAE,OAAc,EAC7B,cAAc,CAAC,EAAE,cAAc,GAChC,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/initializer.js

@@ -0,0 +1,110 @@
+/**
+ * @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) {
+    // Create all tables in parallel for faster startup
+    await Promise.all(components.map(comp => ensureTableExists(database, comp.getConfiguration().name, autoMigration)));
+    // Inject dependencies (synchronous, fast)
+    for (const comp of components) {
+        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, authMiddleware) {
+    // Create all tables in parallel for faster startup
+    await Promise.all(assetsManagers.map(manager => ensureTableExists(database, manager.getConfiguration().name, autoMigration)));
+    // Inject dependencies (synchronous, fast)
+    for (const manager of assetsManagers) {
+        manager.setDependencies(database, storage, authMiddleware);
+    }
+}
+/**
+ * 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/initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializer.js","sourceRoot":"","sources":["../src/initializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,UAAwC,EACxC,QAAyB,EACzB,OAAuB,EACvB,gBAAyB,IAAI;IAE7B,mDAAmD;IACnD,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAEnH,0CAA0C;IAC1C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC5B,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,EAC7B,cAA+B;IAE/B,mDAAmD;IACnD,MAAM,OAAO,CAAC,GAAG,CACb,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAC7G,CAAA;IAED,0CAA0C;IAC1C,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACnC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,CAAA;IAC9D,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"}