digitaltwin-core 0.14.2 → 1.0.0

package/dist/index.js

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Main entry point for the digitaltwin-core package
+ *
+ * This module provides the core functionality for building digital twin applications,
+ * including data collection, processing, asset management, and real-time synchronization.
+ *
+ * @version 1.0.0
+ * @author FARI Team
+ *
+ * @example
+ * ```typescript
+ * import { DigitalTwinEngine, Collector, AssetsManager } from 'digitaltwin-core';
+ *
+ * const engine = new DigitalTwinEngine({ ... });
+ * await engine.start();
+ * ```
+ */
+// Core Engine
+export { DigitalTwinEngine } from './engine/digital_twin_engine.js';
+// Base Components
+export { Collector } from './components/collector.js';
+export { Harvester } from './components/harvester.js';
+export { Handler } from './components/handler.js';
+export { AssetsManager } from './components/assets_manager.js';
+export { GlobalAssetsHandler } from './components/global_assets_handler.js';
+export { CustomTableManager } from './components/custom_table_manager.js';
+export { TilesetManager } from './components/tileset_manager.js';
+export { isAsyncUploadable } from './components/async_upload.js';
+// Storage Services
+export { StorageService } from './storage/storage_service.js';
+export { LocalStorageService } from './storage/adapters/local_storage_service.js';
+export { OvhS3StorageService } from './storage/adapters/ovh_storage_service.js';
+export { StorageServiceFactory } from './storage/storage_factory.js';
+// Database Services
+export { DatabaseAdapter } from './database/database_adapter.js';
+export { KnexDatabaseAdapter } from './database/adapters/knex_database_adapter.js';
+// Types and Interfaces
+export * from './components/types.js';
+export * from './components/interfaces.js';
+export * from './types/data_record.js';
+// Authentication
+export * from './auth/index.js';
+// Errors
+export * from './errors/index.js';
+// Validation
+export * from './validation/index.js';
+// Utilities
+export { Logger, LogLevel } from './utils/logger.js';
+export { safeAsync, tryAsync, safeCleanup, retryAsync } from './utils/safe_async.js';
+export { setupGracefulShutdown } from './utils/graceful_shutdown.js';
+export { mapToDataRecord } from './utils/map_to_data_record.js';
+export { servableEndpoint } from './utils/servable_endpoint.js';
+export { HttpStatus, jsonResponse, successResponse, errorResponse, badRequestResponse, unauthorizedResponse, forbiddenResponse, notFoundResponse, textResponse, fileResponse, multiStatusResponse } from './utils/http_responses.js';
+// Engine Components
+export { QueueManager } from './engine/queue_manager.js';
+export { errorHandler, asyncHandler, notFoundHandler } from './engine/error_handler.js';
+export { HealthChecker, createDatabaseCheck, createRedisCheck, createStorageCheck, performHealthCheck, livenessCheck } from './engine/health.js';
+export { UploadProcessor } from './engine/upload_processor.js';
+export { initializeComponents } from './engine/initializer.js';
+export * from './engine/events.js';
+export * from './engine/endpoints.js';
+// OpenAPI Documentation Generation
+export * from './openapi/index.js';
+export { Env } from './env/env.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;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAEnE,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAA;AAC3E,OAAO,EACH,kBAAkB,EAGrB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAChE,OAAO,EAAwB,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAEtF,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAA;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAEpE,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAkC,MAAM,8CAA8C,CAAA;AAElH,uBAAuB;AACvB,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AAEtC,iBAAiB;AACjB,cAAc,iBAAiB,CAAA;AAE/B,SAAS;AACT,cAAc,mBAAmB,CAAA;AAEjC,aAAa;AACb,cAAc,uBAAuB,CAAA;AAErC,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACpF,OAAO,EAAE,qBAAqB,EAAwB,MAAM,8BAA8B,CAAA;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EACH,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACtB,MAAM,2BAA2B,CAAA;AAGlC,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AACvF,OAAO,EACH,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EAKhB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACH,eAAe,EAIlB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AAErC,mCAAmC;AACnC,cAAc,oBAAoB,CAAA;AAElC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA"}

package/dist/openapi/generator.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview OpenAPI specification generator for Digital Twin components
+ *
+ * This module provides utilities to automatically generate OpenAPI 3.0
+ * documentation from Digital Twin components that implement OpenAPIDocumentable.
+ */
+import type { OpenAPIDocument, OpenAPIGeneratorOptions, OpenAPISchema } from './types.js';
+/**
+ * Generates OpenAPI 3.0 specifications from Digital Twin components.
+ *
+ * The generator aggregates OpenAPI specs from all components that implement
+ * the OpenAPIDocumentable interface and produces a complete OpenAPI document.
+ *
+ * @example
+ * ```typescript
+ * import { OpenAPIGenerator } from 'digitaltwin-core'
+ * import * as components from './src/components'
+ *
+ * const spec = OpenAPIGenerator.generate({
+ *   info: {
+ *     title: 'My Digital Twin API',
+ *     version: '1.0.0',
+ *     description: 'API documentation'
+ *   },
+ *   components: Object.values(components),
+ *   servers: [{ url: 'http://localhost:3000' }]
+ * })
+ *
+ * // Write to file
+ * OpenAPIGenerator.writeYAML(spec, './openapi.yaml')
+ * ```
+ */
+export declare class OpenAPIGenerator {
+    /**
+     * Generates an OpenAPI document from the provided components.
+     *
+     * @param options - Generation options including components and metadata
+     * @returns Complete OpenAPI document
+     */
+    static generate(options: OpenAPIGeneratorOptions): OpenAPIDocument;
+    /**
+     * Returns default security schemes for APISIX/Keycloak authentication.
+     */
+    private static getDefaultSecuritySchemes;
+    /**
+     * Converts an OpenAPI document to YAML string.
+     *
+     * @param document - OpenAPI document to convert
+     * @returns YAML string representation
+     */
+    static toYAML(document: OpenAPIDocument): string;
+    /**
+     * Converts an OpenAPI document to JSON string.
+     *
+     * @param document - OpenAPI document to convert
+     * @param pretty - Whether to format with indentation (default: true)
+     * @returns JSON string representation
+     */
+    static toJSON(document: OpenAPIDocument, pretty?: boolean): string;
+    /**
+     * Recursively converts an object to YAML format.
+     * Simple implementation without external dependencies.
+     */
+    private static objectToYAML;
+    /**
+     * Helper to create a simple schema reference.
+     */
+    static schemaRef(name: string): OpenAPISchema;
+    /**
+     * Helper to create a common response for 200 OK with content.
+     */
+    static successResponse(contentType: string, schema: OpenAPISchema, description?: string): {
+        '200': {
+            description: string;
+            content: {
+                [contentType]: {
+                    schema: OpenAPISchema;
+                };
+            };
+        };
+    };
+    /**
+     * Helper to create common error responses.
+     */
+    static errorResponses(codes?: Array<400 | 401 | 403 | 404 | 500>): Record<string, {
+        description: string;
+    }>;
+    /**
+     * Common schemas used across components.
+     */
+    static commonSchemas: Record<string, OpenAPISchema>;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/openapi/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/openapi/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACR,eAAe,EACf,uBAAuB,EAEvB,aAAa,EAGhB,MAAM,YAAY,CAAA;AAGnB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,gBAAgB;IACzB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,uBAAuB,GAAG,eAAe;IAqFlE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAWxC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM;IAIhD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAO,GAAG,MAAM;IAI/D;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAoF3B;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAI7C;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,SAAwB;;;;gBAKtF,CAAC,WAAW,CAAC;;kBAAY;;;;IAMzC;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,GAAE,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAwB;qBACnC,MAAM;;IAiBzD;;OAEG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAuClD;CACJ"}

package/dist/openapi/generator.js

@@ -0,0 +1,293 @@
+/**
+ * @fileoverview OpenAPI specification generator for Digital Twin components
+ *
+ * This module provides utilities to automatically generate OpenAPI 3.0
+ * documentation from Digital Twin components that implement OpenAPIDocumentable.
+ */
+import { isOpenAPIDocumentable } from './types.js';
+/**
+ * Generates OpenAPI 3.0 specifications from Digital Twin components.
+ *
+ * The generator aggregates OpenAPI specs from all components that implement
+ * the OpenAPIDocumentable interface and produces a complete OpenAPI document.
+ *
+ * @example
+ * ```typescript
+ * import { OpenAPIGenerator } from 'digitaltwin-core'
+ * import * as components from './src/components'
+ *
+ * const spec = OpenAPIGenerator.generate({
+ *   info: {
+ *     title: 'My Digital Twin API',
+ *     version: '1.0.0',
+ *     description: 'API documentation'
+ *   },
+ *   components: Object.values(components),
+ *   servers: [{ url: 'http://localhost:3000' }]
+ * })
+ *
+ * // Write to file
+ * OpenAPIGenerator.writeYAML(spec, './openapi.yaml')
+ * ```
+ */
+export class OpenAPIGenerator {
+    /**
+     * Generates an OpenAPI document from the provided components.
+     *
+     * @param options - Generation options including components and metadata
+     * @returns Complete OpenAPI document
+     */
+    static generate(options) {
+        const { info, servers, components, additionalSchemas, additionalTags, includeAuth = true } = options;
+        // Filter components that implement OpenAPIDocumentable
+        const documentableComponents = components.filter(isOpenAPIDocumentable);
+        // Aggregate paths, tags, and schemas from all components
+        const allPaths = {};
+        const allTags = additionalTags ? [...additionalTags] : [];
+        const allSchemas = additionalSchemas ? { ...additionalSchemas } : {};
+        const tagNames = new Set(additionalTags?.map(t => t.name) || []);
+        for (const component of documentableComponents) {
+            try {
+                const spec = component.getOpenAPISpec();
+                // Merge paths
+                for (const [path, pathItem] of Object.entries(spec.paths)) {
+                    if (allPaths[path]) {
+                        // Merge operations into existing path
+                        allPaths[path] = { ...allPaths[path], ...pathItem };
+                    }
+                    else {
+                        allPaths[path] = pathItem;
+                    }
+                }
+                // Merge tags (avoid duplicates)
+                if (spec.tags) {
+                    for (const tag of spec.tags) {
+                        if (!tagNames.has(tag.name)) {
+                            allTags.push(tag);
+                            tagNames.add(tag.name);
+                        }
+                    }
+                }
+                // Merge schemas
+                if (spec.schemas) {
+                    Object.assign(allSchemas, spec.schemas);
+                }
+            }
+            catch (error) {
+                const componentName = 'getConfiguration' in component
+                    ? component.getConfiguration().name
+                    : 'unknown';
+                console.warn(`Warning: Failed to get OpenAPI spec from component "${componentName}":`, error);
+            }
+        }
+        // Sort tags alphabetically
+        allTags.sort((a, b) => a.name.localeCompare(b.name));
+        // Build components section
+        const componentsSection = {};
+        if (Object.keys(allSchemas).length > 0) {
+            componentsSection.schemas = allSchemas;
+        }
+        if (includeAuth) {
+            componentsSection.securitySchemes = this.getDefaultSecuritySchemes();
+        }
+        // Build final document
+        const document = {
+            openapi: '3.0.3',
+            info,
+            paths: allPaths
+        };
+        if (servers && servers.length > 0) {
+            document.servers = servers;
+        }
+        if (allTags.length > 0) {
+            document.tags = allTags;
+        }
+        if (Object.keys(componentsSection).length > 0) {
+            document.components = componentsSection;
+        }
+        return document;
+    }
+    /**
+     * Returns default security schemes for APISIX/Keycloak authentication.
+     */
+    static getDefaultSecuritySchemes() {
+        return {
+            ApiKeyAuth: {
+                type: 'apiKey',
+                in: 'header',
+                name: 'x-user-id',
+                description: 'Keycloak user ID (forwarded by APISIX)'
+            }
+        };
+    }
+    /**
+     * Converts an OpenAPI document to YAML string.
+     *
+     * @param document - OpenAPI document to convert
+     * @returns YAML string representation
+     */
+    static toYAML(document) {
+        return this.objectToYAML(document, 0);
+    }
+    /**
+     * Converts an OpenAPI document to JSON string.
+     *
+     * @param document - OpenAPI document to convert
+     * @param pretty - Whether to format with indentation (default: true)
+     * @returns JSON string representation
+     */
+    static toJSON(document, pretty = true) {
+        return JSON.stringify(document, null, pretty ? 2 : undefined);
+    }
+    /**
+     * Recursively converts an object to YAML format.
+     * Simple implementation without external dependencies.
+     */
+    static objectToYAML(obj, indent) {
+        const spaces = '  '.repeat(indent);
+        if (obj === null || obj === undefined) {
+            return 'null';
+        }
+        if (typeof obj === 'string') {
+            // Check if string needs quoting
+            if (obj === '' ||
+                obj.includes(':') ||
+                obj.includes('#') ||
+                obj.includes('\n') ||
+                obj.includes('"') ||
+                obj.includes("'") ||
+                obj.startsWith(' ') ||
+                obj.endsWith(' ') ||
+                obj === 'true' ||
+                obj === 'false' ||
+                obj === 'null' ||
+                /^[\d.]+$/.test(obj)) {
+                // Use double quotes and escape
+                return `"${obj.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n')}"`;
+            }
+            return obj;
+        }
+        if (typeof obj === 'number' || typeof obj === 'boolean') {
+            return String(obj);
+        }
+        if (Array.isArray(obj)) {
+            if (obj.length === 0) {
+                return '[]';
+            }
+            const items = obj.map(item => {
+                const value = this.objectToYAML(item, indent + 1);
+                if (typeof item === 'object' && item !== null && !Array.isArray(item)) {
+                    // Object in array - put first property on same line as dash
+                    const lines = value.split('\n');
+                    if (lines.length > 0) {
+                        return `${spaces}- ${lines[0].trimStart()}\n${lines.slice(1).join('\n')}`;
+                    }
+                }
+                return `${spaces}- ${value}`;
+            });
+            return items.join('\n').replace(/\n+$/, '');
+        }
+        if (typeof obj === 'object') {
+            const entries = Object.entries(obj);
+            if (entries.length === 0) {
+                return '{}';
+            }
+            const lines = entries.map(([key, value]) => {
+                // Handle special keys that need quoting
+                const quotedKey = /[:\s#[\]{}]/.test(key) ? `"${key}"` : key;
+                if (value === null || value === undefined) {
+                    return `${spaces}${quotedKey}: null`;
+                }
+                if (typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length > 0) {
+                    return `${spaces}${quotedKey}:\n${this.objectToYAML(value, indent + 1)}`;
+                }
+                if (Array.isArray(value) && value.length > 0) {
+                    return `${spaces}${quotedKey}:\n${this.objectToYAML(value, indent + 1)}`;
+                }
+                return `${spaces}${quotedKey}: ${this.objectToYAML(value, indent + 1)}`;
+            });
+            return lines.join('\n');
+        }
+        return String(obj);
+    }
+    /**
+     * Helper to create a simple schema reference.
+     */
+    static schemaRef(name) {
+        return { $ref: `#/components/schemas/${name}` };
+    }
+    /**
+     * Helper to create a common response for 200 OK with content.
+     */
+    static successResponse(contentType, schema, description = 'Successful response') {
+        return {
+            '200': {
+                description,
+                content: {
+                    [contentType]: { schema }
+                }
+            }
+        };
+    }
+    /**
+     * Helper to create common error responses.
+     */
+    static errorResponses(codes = [400, 401, 404, 500]) {
+        const responses = {};
+        const descriptions = {
+            400: 'Bad request',
+            401: 'Unauthorized',
+            403: 'Forbidden',
+            404: 'Not found',
+            500: 'Internal server error'
+        };
+        for (const code of codes) {
+            responses[String(code)] = { description: descriptions[code] };
+        }
+        return responses;
+    }
+    /**
+     * Common schemas used across components.
+     */
+    static { this.commonSchemas = {
+        Error: {
+            type: 'object',
+            properties: {
+                error: { type: 'string' },
+                message: { type: 'string' }
+            }
+        },
+        Point: {
+            type: 'object',
+            required: ['type', 'coordinates'],
+            properties: {
+                type: { type: 'string', enum: ['Point'] },
+                coordinates: {
+                    type: 'array',
+                    items: { type: 'number' }
+                }
+            }
+        },
+        Feature: {
+            type: 'object',
+            required: ['type', 'geometry', 'properties'],
+            properties: {
+                type: { type: 'string', enum: ['Feature'] },
+                geometry: { type: 'object' },
+                properties: { type: 'object' }
+            }
+        },
+        FeatureCollection: {
+            type: 'object',
+            required: ['type', 'features'],
+            properties: {
+                type: { type: 'string', enum: ['FeatureCollection'] },
+                features: {
+                    type: 'array',
+                    items: { $ref: '#/components/schemas/Feature' }
+                }
+            }
+        }
+    }; }
+}
+//# sourceMappingURL=generator.js.map

package/dist/openapi/generator.js.map

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

package/dist/openapi/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview OpenAPI documentation generation module
+ *
+ * This module exports utilities for generating OpenAPI 3.0 specifications
+ * from Digital Twin components.
+ */
+export * from './types.js';
+export * from './generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/openapi/index.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview OpenAPI documentation generation module
+ *
+ * This module exports utilities for generating OpenAPI 3.0 specifications
+ * from Digital Twin components.
+ */
+export * from './types.js';
+export * from './generator.js';
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}