@cepseudo/engine 1.0.0

package/dist/loader/component_loader.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview Component auto-discovery and loading utilities
+ *
+ * Provides functions to automatically discover and load Digital Twin components
+ * from a directory based on file naming conventions.
+ */
+import type { LoadedComponents } from '../component_types.js';
+/**
+ * Options for component auto-discovery
+ */
+export interface LoadComponentsOptions {
+    /**
+     * File patterns to match by suffix.
+     * Keys are component types, values are file suffixes (without extension).
+     * @default Standard naming conventions
+     */
+    patterns?: {
+        collectors?: string;
+        harvesters?: string;
+        handlers?: string;
+        assetsManagers?: string;
+        customTableManagers?: string;
+    };
+    /**
+     * File extensions to scan for.
+     * @default ['.js', '.mjs']
+     */
+    extensions?: string[];
+    /**
+     * Whether to scan subdirectories recursively.
+     * @default true
+     */
+    recursive?: boolean;
+    /**
+     * Patterns to exclude (glob-like patterns applied to file names).
+     * @default ['*.spec.*', '*.test.*', 'index.*']
+     */
+    exclude?: string[];
+    /**
+     * Enable verbose logging during discovery.
+     * @default false
+     */
+    verbose?: boolean;
+    /**
+     * Custom logger function for verbose output.
+     * When provided, verbose messages are sent to this function instead of console.log.
+     */
+    logger?: (message: string) => void;
+}
+/**
+ * Result of component loading operation
+ */
+export interface LoadComponentsResult extends LoadedComponents {
+    /** Files that were scanned */
+    scannedFiles: string[];
+    /** Errors encountered during loading */
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+    /** Summary statistics */
+    summary: {
+        total: number;
+        collectors: number;
+        harvesters: number;
+        handlers: number;
+        assetsManagers: number;
+        customTableManagers: number;
+        errors: number;
+    };
+}
+/**
+ * Auto-discovers and loads Digital Twin components from a directory.
+ *
+ * This function scans the specified directory for component files following
+ * the naming conventions (*_collector.js, *_harvester.js, etc.), dynamically
+ * imports them, and instantiates any component classes found.
+ *
+ * ## Naming Conventions
+ *
+ * Component files should follow these naming patterns:
+ * - Collectors: `*_collector.js` (e.g., `weather_collector.js`)
+ * - Harvesters: `*_harvester.js` (e.g., `traffic_harvester.js`)
+ * - Handlers: `*_handler.js` (e.g., `api_handler.js`)
+ * - Assets Managers: `*_assets_manager.js` (e.g., `gltf_assets_manager.js`)
+ * - Custom Table Managers: `*_custom_table.js` (e.g., `wms_custom_table.js`)
+ *
+ * ## Component Export Requirements
+ *
+ * Components should be exported as default export or named export matching the class name:
+ * ```typescript
+ * // Default export (preferred)
+ * export default class WeatherCollector extends Collector { ... }
+ *
+ * // Named export matching file name
+ * export class WeatherCollector extends Collector { ... }
+ * ```
+ *
+ * @param directory - Directory path to scan for components (absolute or relative to cwd)
+ * @param options - Configuration options for discovery
+ * @returns Promise resolving to loaded components and metadata
+ *
+ * @example
+ * ```typescript
+ * import { loadComponents, DigitalTwinEngine } from 'digitaltwin-core'
+ *
+ * // Basic usage - scan compiled components
+ * const result = await loadComponents('./dist/components')
+ *
+ * console.log(`Loaded ${result.summary.total} components`)
+ *
+ * const engine = new DigitalTwinEngine({ storage, database })
+ * engine.registerComponents(result)
+ * await engine.start()
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Advanced usage with options
+ * const result = await loadComponents('./dist/components', {
+ *   recursive: true,
+ *   verbose: true,
+ *   extensions: ['.js'],
+ *   exclude: ['*.test.*', 'deprecated_*']
+ * })
+ *
+ * if (result.errors.length > 0) {
+ *   console.warn('Some components failed to load:', result.errors)
+ * }
+ * ```
+ */
+export declare function loadComponents(directory: string, options?: LoadComponentsOptions): Promise<LoadComponentsResult>;
+//# sourceMappingURL=component_loader.d.ts.map

package/dist/loader/component_loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component_loader.d.ts","sourceRoot":"","sources":["../../src/loader/component_loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,uBAAuB,CAAA;AAS3E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAC/B,CAAA;IAED;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,8BAA8B;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAA;IAEtB,wCAAwC;IACxC,MAAM,EAAE,KAAK,CAAC;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;KAChB,CAAC,CAAA;IAEF,yBAAyB;IACzB,OAAO,EAAE;QACL,KAAK,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;QAChB,cAAc,EAAE,MAAM,CAAA;QACtB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,MAAM,EAAE,MAAM,CAAA;KACjB,CAAA;CACJ;AAkKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAsB,cAAc,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAA0B,GACpC,OAAO,CAAC,oBAAoB,CAAC,CA4J/B"}

package/dist/loader/component_loader.js

@@ -0,0 +1,340 @@
+/**
+ * @fileoverview Component auto-discovery and loading utilities
+ *
+ * Provides functions to automatically discover and load Digital Twin components
+ * from a directory based on file naming conventions.
+ */
+import { pathToFileURL } from 'node:url';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { isCollector, isHarvester, isHandler, isAssetsManager, isCustomTableManager } from '../component_types.js';
+/**
+ * Default file patterns for component detection based on naming conventions
+ */
+const DEFAULT_PATTERNS = {
+    collectors: '_collector',
+    harvesters: '_harvester',
+    handlers: '_handler',
+    assetsManagers: '_assets_manager',
+    customTableManagers: '_custom_table'
+};
+const DEFAULT_EXTENSIONS = ['.js', '.mjs'];
+const DEFAULT_EXCLUDE = ['*.spec.*', '*.test.*', 'index.*', '*.d.ts'];
+/**
+ * Check if a filename matches an exclusion pattern.
+ */
+function matchesExcludePattern(filename, patterns) {
+    const nameWithoutExt = filename.replace(/\.[^.]+$/, '');
+    for (const pattern of patterns) {
+        // Convert glob pattern to regex
+        const regexPattern = pattern.replace(/\./g, '\\.').replace(/\*/g, '.*');
+        const regex = new RegExp(`^${regexPattern}$`, 'i');
+        // Match against full filename and name without extension
+        if (regex.test(filename) || regex.test(nameWithoutExt)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Determine component type from filename based on patterns.
+ */
+function getComponentTypeFromFilename(filename, patterns) {
+    const baseName = path.basename(filename);
+    // Remove extension for matching
+    const nameWithoutExt = baseName.replace(/\.[^.]+$/, '');
+    if (nameWithoutExt.endsWith(patterns.collectors))
+        return 'collectors';
+    if (nameWithoutExt.endsWith(patterns.harvesters))
+        return 'harvesters';
+    if (nameWithoutExt.endsWith(patterns.handlers))
+        return 'handlers';
+    if (nameWithoutExt.endsWith(patterns.assetsManagers))
+        return 'assetsManagers';
+    if (nameWithoutExt.endsWith(patterns.customTableManagers))
+        return 'customTableManagers';
+    // Also check for *_manager pattern for tileset/map managers
+    if (nameWithoutExt.endsWith('_manager') ||
+        nameWithoutExt.endsWith('_tileset_manager') ||
+        nameWithoutExt.endsWith('_map_manager')) {
+        return 'assetsManagers';
+    }
+    return null;
+}
+/**
+ * Check if a value is a class constructor.
+ */
+function isClassConstructor(value) {
+    return typeof value === 'function' && value.prototype && value.prototype.constructor === value;
+}
+/**
+ * Check if an instance is a valid Digital Twin component.
+ */
+function isValidComponent(instance) {
+    if (!instance || typeof instance !== 'object')
+        return false;
+    if (typeof instance.getConfiguration !== 'function')
+        return false;
+    return (isCollector(instance) ||
+        isHarvester(instance) ||
+        isHandler(instance) ||
+        isAssetsManager(instance) ||
+        isCustomTableManager(instance));
+}
+/**
+ * Recursively scan a directory for component files.
+ */
+async function scanDirectory(dir, options) {
+    const results = [];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            // Skip hidden files/directories
+            if (entry.name.startsWith('.') || entry.name.startsWith('_')) {
+                continue;
+            }
+            if (entry.isDirectory() && options.recursive) {
+                const subResults = await scanDirectory(fullPath, options);
+                results.push(...subResults);
+            }
+            else if (entry.isFile()) {
+                // Check extension
+                const ext = path.extname(entry.name);
+                if (!options.extensions.includes(ext)) {
+                    continue;
+                }
+                // Check exclusions
+                if (matchesExcludePattern(entry.name, options.exclude)) {
+                    options.log?.(`[loadComponents] Excluding ${entry.name}`);
+                    continue;
+                }
+                // Determine component type
+                const componentType = getComponentTypeFromFilename(entry.name, options.patterns);
+                if (componentType) {
+                    results.push({ path: fullPath, type: componentType });
+                }
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read - return empty array
+    }
+    return results;
+}
+/**
+ * Convert a snake_case or kebab-case string to PascalCase.
+ */
+function toPascalCase(str) {
+    return str
+        .split(/[-_]/)
+        .map(part => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
+        .join('');
+}
+/**
+ * Auto-discovers and loads Digital Twin components from a directory.
+ *
+ * This function scans the specified directory for component files following
+ * the naming conventions (*_collector.js, *_harvester.js, etc.), dynamically
+ * imports them, and instantiates any component classes found.
+ *
+ * ## Naming Conventions
+ *
+ * Component files should follow these naming patterns:
+ * - Collectors: `*_collector.js` (e.g., `weather_collector.js`)
+ * - Harvesters: `*_harvester.js` (e.g., `traffic_harvester.js`)
+ * - Handlers: `*_handler.js` (e.g., `api_handler.js`)
+ * - Assets Managers: `*_assets_manager.js` (e.g., `gltf_assets_manager.js`)
+ * - Custom Table Managers: `*_custom_table.js` (e.g., `wms_custom_table.js`)
+ *
+ * ## Component Export Requirements
+ *
+ * Components should be exported as default export or named export matching the class name:
+ * ```typescript
+ * // Default export (preferred)
+ * export default class WeatherCollector extends Collector { ... }
+ *
+ * // Named export matching file name
+ * export class WeatherCollector extends Collector { ... }
+ * ```
+ *
+ * @param directory - Directory path to scan for components (absolute or relative to cwd)
+ * @param options - Configuration options for discovery
+ * @returns Promise resolving to loaded components and metadata
+ *
+ * @example
+ * ```typescript
+ * import { loadComponents, DigitalTwinEngine } from 'digitaltwin-core'
+ *
+ * // Basic usage - scan compiled components
+ * const result = await loadComponents('./dist/components')
+ *
+ * console.log(`Loaded ${result.summary.total} components`)
+ *
+ * const engine = new DigitalTwinEngine({ storage, database })
+ * engine.registerComponents(result)
+ * await engine.start()
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Advanced usage with options
+ * const result = await loadComponents('./dist/components', {
+ *   recursive: true,
+ *   verbose: true,
+ *   extensions: ['.js'],
+ *   exclude: ['*.test.*', 'deprecated_*']
+ * })
+ *
+ * if (result.errors.length > 0) {
+ *   console.warn('Some components failed to load:', result.errors)
+ * }
+ * ```
+ */
+export async function loadComponents(directory, options = {}) {
+    const patterns = { ...DEFAULT_PATTERNS, ...options.patterns };
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    const exclude = options.exclude ?? DEFAULT_EXCLUDE;
+    const recursive = options.recursive ?? true;
+    const verbose = options.verbose ?? false;
+    const log = options.logger ?? console.log;
+    const result = {
+        collectors: [],
+        harvesters: [],
+        handlers: [],
+        assetsManagers: [],
+        customTableManagers: [],
+        scannedFiles: [],
+        errors: [],
+        summary: {
+            total: 0,
+            collectors: 0,
+            harvesters: 0,
+            handlers: 0,
+            assetsManagers: 0,
+            customTableManagers: 0,
+            errors: 0
+        }
+    };
+    // Resolve directory path
+    const absoluteDir = path.isAbsolute(directory) ? directory : path.resolve(process.cwd(), directory);
+    // Check if directory exists
+    try {
+        await fs.access(absoluteDir);
+    }
+    catch {
+        if (verbose) {
+            log(`[loadComponents] Directory not found: ${absoluteDir}`);
+        }
+        return result;
+    }
+    if (verbose) {
+        log(`[loadComponents] Loading components from ${absoluteDir}`);
+    }
+    // Scan for component files
+    const files = await scanDirectory(absoluteDir, {
+        extensions, exclude, recursive, patterns,
+        log: verbose ? log : undefined
+    });
+    result.scannedFiles = files.map(f => f.path);
+    if (verbose) {
+        log(`[loadComponents] Found ${files.length} potential component files`);
+    }
+    // Load each component file
+    for (const { path: filePath, type: expectedType } of files) {
+        try {
+            // Convert to file URL for ESM import
+            const fileUrl = pathToFileURL(filePath).href;
+            const module = await import(fileUrl);
+            // Find component class in module exports
+            let ComponentClass = null;
+            // Try default export first
+            if (module.default && isClassConstructor(module.default)) {
+                ComponentClass = module.default;
+            }
+            else {
+                // Try named exports
+                const fileName = path.basename(filePath, path.extname(filePath));
+                const expectedClassName = toPascalCase(fileName);
+                if (module[expectedClassName] && isClassConstructor(module[expectedClassName])) {
+                    ComponentClass = module[expectedClassName];
+                }
+                else {
+                    // Try to find any class export that's a valid component
+                    for (const [, value] of Object.entries(module)) {
+                        if (isClassConstructor(value)) {
+                            try {
+                                const testInstance = new value();
+                                if (isValidComponent(testInstance)) {
+                                    ComponentClass = value;
+                                    break;
+                                }
+                            }
+                            catch {
+                                // Skip if instantiation fails
+                            }
+                        }
+                    }
+                }
+            }
+            if (!ComponentClass) {
+                result.errors.push({
+                    file: filePath,
+                    error: 'No valid component class found in module exports'
+                });
+                continue;
+            }
+            // Instantiate the component
+            const instance = new ComponentClass();
+            if (!isValidComponent(instance)) {
+                result.errors.push({
+                    file: filePath,
+                    error: 'Instantiated class is not a valid Digital Twin component'
+                });
+                continue;
+            }
+            // Add to appropriate array based on actual type (not expected type)
+            if (isCollector(instance)) {
+                result.collectors.push(instance);
+                result.summary.collectors++;
+            }
+            else if (isHarvester(instance)) {
+                result.harvesters.push(instance);
+                result.summary.harvesters++;
+            }
+            else if (isHandler(instance)) {
+                result.handlers.push(instance);
+                result.summary.handlers++;
+            }
+            else if (isCustomTableManager(instance)) {
+                result.customTableManagers.push(instance);
+                result.summary.customTableManagers++;
+            }
+            else if (isAssetsManager(instance)) {
+                result.assetsManagers.push(instance);
+                result.summary.assetsManagers++;
+            }
+            result.summary.total++;
+            if (verbose) {
+                const config = instance.getConfiguration();
+                log(`[loadComponents] Loaded: ${config.name} (${expectedType})`);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            result.errors.push({
+                file: filePath,
+                error: `Failed to import: ${errorMessage}`
+            });
+            result.summary.errors++;
+            if (verbose) {
+                log(`[loadComponents] Error loading ${filePath}: ${errorMessage}`);
+            }
+        }
+    }
+    if (verbose) {
+        log(`[loadComponents] Loaded components: ${result.summary.total} total`);
+    }
+    return result;
+}
+//# sourceMappingURL=component_loader.js.map

package/dist/loader/component_loader.js.map

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

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 '@cepseudo/shared';
+/**
+ * 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,kBAAkB,CAAA;AAGzB;;;;;;;;;;;;;;;;;;;;;;;;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"}