digitaltwin-core 0.14.0 → 0.14.2

package/dist/openapi/generator.js

@@ -1,293 +0,0 @@
-/**
- * @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

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

package/dist/openapi/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,9 +0,0 @@
-/**
- * @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

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

package/dist/openapi/types.d.ts

@@ -1,182 +0,0 @@
-/**
- * @fileoverview OpenAPI 3.0 type definitions for automatic documentation generation
- *
- * These types provide a structured way to define OpenAPI specifications
- * for digital twin components.
- */
-/**
- * OpenAPI Info object
- */
-export interface OpenAPIInfo {
-    title: string;
-    description?: string;
-    version: string;
-}
-/**
- * OpenAPI Server object
- */
-export interface OpenAPIServer {
-    url: string;
-    description?: string;
-}
-/**
- * OpenAPI Tag object
- */
-export interface OpenAPITag {
-    name: string;
-    description?: string;
-}
-/**
- * OpenAPI Parameter object
- */
-export interface OpenAPIParameter {
-    name: string;
-    in: 'path' | 'query' | 'header' | 'cookie';
-    description?: string;
-    required?: boolean;
-    schema: OpenAPISchema;
-}
-/**
- * OpenAPI Schema object (simplified)
- */
-export interface OpenAPISchema {
-    type?: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
-    format?: string;
-    items?: OpenAPISchema;
-    properties?: Record<string, OpenAPISchema>;
-    required?: string[];
-    $ref?: string;
-    description?: string;
-    nullable?: boolean;
-    enum?: string[];
-    default?: unknown;
-    additionalProperties?: boolean | OpenAPISchema;
-}
-/**
- * OpenAPI Media Type object
- */
-export interface OpenAPIMediaType {
-    schema: OpenAPISchema;
-}
-/**
- * OpenAPI Request Body object
- */
-export interface OpenAPIRequestBody {
-    description?: string;
-    required?: boolean;
-    content: Record<string, OpenAPIMediaType>;
-}
-/**
- * OpenAPI Response object
- */
-export interface OpenAPIResponse {
-    description: string;
-    content?: Record<string, OpenAPIMediaType>;
-    headers?: Record<string, {
-        description?: string;
-        schema: OpenAPISchema;
-    }>;
-}
-/**
- * OpenAPI Security Requirement object
- */
-export interface OpenAPISecurityRequirement {
-    [name: string]: string[];
-}
-/**
- * OpenAPI Operation object
- */
-export interface OpenAPIOperation {
-    summary?: string;
-    description?: string;
-    operationId?: string;
-    tags?: string[];
-    parameters?: OpenAPIParameter[];
-    requestBody?: OpenAPIRequestBody;
-    responses: Record<string, OpenAPIResponse>;
-    security?: OpenAPISecurityRequirement[];
-    deprecated?: boolean;
-}
-/**
- * OpenAPI Path Item object
- */
-export interface OpenAPIPathItem {
-    get?: OpenAPIOperation;
-    post?: OpenAPIOperation;
-    put?: OpenAPIOperation;
-    delete?: OpenAPIOperation;
-    patch?: OpenAPIOperation;
-    options?: OpenAPIOperation;
-    head?: OpenAPIOperation;
-}
-/**
- * OpenAPI Security Scheme object
- */
-export interface OpenAPISecurityScheme {
-    type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
-    description?: string;
-    name?: string;
-    in?: 'query' | 'header' | 'cookie';
-    scheme?: string;
-    bearerFormat?: string;
-}
-/**
- * OpenAPI Components object
- */
-export interface OpenAPIComponents {
-    schemas?: Record<string, OpenAPISchema>;
-    securitySchemes?: Record<string, OpenAPISecurityScheme>;
-}
-/**
- * Complete OpenAPI Document
- */
-export interface OpenAPIDocument {
-    openapi: string;
-    info: OpenAPIInfo;
-    servers?: OpenAPIServer[];
-    tags?: OpenAPITag[];
-    paths: Record<string, OpenAPIPathItem>;
-    components?: OpenAPIComponents;
-}
-/**
- * Specification returned by a component's getOpenAPISpec() method
- */
-export interface OpenAPIComponentSpec {
-    /** Paths contributed by this component */
-    paths: Record<string, OpenAPIPathItem>;
-    /** Tags used by this component */
-    tags?: OpenAPITag[];
-    /** Schemas contributed by this component */
-    schemas?: Record<string, OpenAPISchema>;
-}
-/**
- * Options for OpenAPI generation
- */
-export interface OpenAPIGeneratorOptions {
-    /** API information */
-    info: OpenAPIInfo;
-    /** Server URLs */
-    servers?: OpenAPIServer[];
-    /** Components to document */
-    components: OpenAPIDocumentable[];
-    /** Additional schemas to merge (e.g., from external file) */
-    additionalSchemas?: Record<string, OpenAPISchema>;
-    /** Additional tags to include */
-    additionalTags?: OpenAPITag[];
-    /** Include security scheme for authentication */
-    includeAuth?: boolean;
-}
-/**
- * Interface for components that can provide OpenAPI documentation
- */
-export interface OpenAPIDocumentable {
-    /**
-     * Returns the OpenAPI specification for this component's endpoints
-     */
-    getOpenAPISpec(): OpenAPIComponentSpec;
-}
-/**
- * Type guard to check if an object implements OpenAPIDocumentable
- */
-export declare function isOpenAPIDocumentable(obj: unknown): obj is OpenAPIDocumentable;
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/openapi/types.js

@@ -1,16 +0,0 @@
-/**
- * @fileoverview OpenAPI 3.0 type definitions for automatic documentation generation
- *
- * These types provide a structured way to define OpenAPI specifications
- * for digital twin components.
- */
-/**
- * Type guard to check if an object implements OpenAPIDocumentable
- */
-export function isOpenAPIDocumentable(obj) {
-    return (typeof obj === 'object' &&
-        obj !== null &&
-        'getOpenAPISpec' in obj &&
-        typeof obj.getOpenAPISpec === 'function');
-}
-//# sourceMappingURL=types.js.map

package/dist/openapi/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/openapi/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2LH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAC9C,OAAO,CACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,gBAAgB,IAAI,GAAG;QACvB,OAAQ,GAA2B,CAAC,cAAc,KAAK,UAAU,CACpE,CAAA;AACL,CAAC"}

package/dist/storage/adapters/local_storage_service.d.ts

@@ -1,51 +0,0 @@
-import { StorageService } from '../storage_service.js';
-/**
- * Local filesystem-based implementation of the StorageService.
- * Saves files in a configured folder using a timestamp as filename.
- */
-export declare class LocalStorageService extends StorageService {
-    private baseDir;
-    constructor(baseDir?: string);
-    /**
-     * Saves the given buffer to disk under a unique filename.
-     * @param buffer - Content to save
-     * @param collectorName - Name of the collector (used for folder)
-     * @param extension - Optional file extension (e.g. 'json', 'txt')
-     * @returns Relative path to the saved file
-     */
-    save(buffer: Buffer, collectorName: string, extension?: string): Promise<string>;
-    /**
-     * Retrieves a file as buffer using its relative path.
-     * @param relativePath - Filename previously returned by `save`
-     * @returns File content as Buffer
-     */
-    retrieve(relativePath: string): Promise<Buffer>;
-    /**
-     * Deletes a stored file.
-     * @param relativePath - Filename previously returned by `save`
-     */
-    delete(relativePath: string): Promise<void>;
-    /**
-     * Saves the given buffer to disk at a specific path (preserves filename).
-     * Unlike save(), this method does not auto-generate a timestamp filename.
-     * @param buffer - Content to save
-     * @param relativePath - Full relative path including filename (e.g., 'tilesets/123/tileset.json')
-     * @returns The same relative path that was provided
-     */
-    saveWithPath(buffer: Buffer, relativePath: string): Promise<string>;
-    /**
-     * Returns a local file path for the stored file.
-     * Note: For local storage, this returns a relative file path, not an HTTP URL.
-     * In production, use a cloud storage service (OVH, S3) for public URLs.
-     * @param relativePath - The storage path of the file
-     * @returns The file path (relative to baseDir)
-     */
-    getPublicUrl(relativePath: string): string;
-    /**
-     * Deletes all files under a given prefix (folder).
-     * @param prefix - The folder/prefix to delete (e.g., 'tilesets/123')
-     * @returns Number of files deleted
-     */
-    deleteByPrefix(prefix: string): Promise<number>;
-}
-//# sourceMappingURL=local_storage_service.d.ts.map

package/dist/storage/adapters/local_storage_service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"local_storage_service.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters/local_storage_service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAItD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACvC,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,MAAe;IAI5C;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAetF;;;;OAIG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrD;;;OAGG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD;;;;;;OAMG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUzE;;;;;;OAMG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAM1C;;;;OAIG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAgCxD"}