digitaltwin-core 0.8.2 → 0.8.3

package/dist/engine/initializer.js

@@ -1,3 +1,32 @@
+/**
+ * @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. 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
+ *
+ * @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);
+ * // Components are now ready to process data
+ * ```
+ */
 export async function initializeComponents(components, database, storage) {
     for (const comp of components) {
         const config = comp.getConfiguration();
@@ -5,6 +34,28 @@ export async function initializeComponents(components, database, storage) {
         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
+ *
+ * @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);
+ * // Asset managers are now ready to handle file operations
+ * ```
+ */
 export async function initializeAssetsManagers(assetsManagers, database, storage) {
     for (const manager of assetsManagers) {
         const config = manager.getConfiguration();
@@ -12,6 +63,27 @@ export async function initializeAssetsManagers(assetsManagers, database, storage
         manager.setDependencies(database, storage);
     }
 }
+/**
+ * Ensures a database table exists for the specified component.
+ *
+ * Checks if a table exists in the database and creates it if missing.
+ * 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
+ *
+ * @throws {Error} When table creation fails
+ *
+ * @example
+ * ```typescript
+ * // Internal usage during component initialization
+ * await ensureTableExists(database, 'weather_data_collector');
+ * // Table now exists and is ready for use
+ * ```
+ *
+ * @internal This function is used internally by initialization functions
+ */
 async function ensureTableExists(database, tableName) {
     const exists = await database.doesTableExists(tableName);
     if (!exists) {

package/dist/engine/initializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"initializer.js","sourceRoot":"","sources":["../../src/engine/initializer.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,UAAwC,EACxC,QAAyB,EACzB,OAAuB;IAEvB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACtC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,cAA+B,EAC/B,QAAyB,EACzB,OAAuB;IAEvB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAA;QACzC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9C,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;AACL,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAyB,EAAE,SAAiB;IACzE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,iCAAiC,SAAS,MAAM,CAAC,CAAA;QAC7D,MAAM,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;QACrC,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,wBAAwB,CAAC,CAAA;IAC9D,CAAC;AACL,CAAC"}
+{"version":3,"file":"initializer.js","sourceRoot":"","sources":["../../src/engine/initializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,UAAwC,EACxC,QAAyB,EACzB,OAAuB;IAEvB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACtC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC1C,cAA+B,EAC/B,QAAyB,EACzB,OAAuB;IAEvB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAA;QACzC,MAAM,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9C,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,KAAK,UAAU,iBAAiB,CAAC,QAAyB,EAAE,SAAiB;IACzE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,iCAAiC,SAAS,MAAM,CAAC,CAAA;QAC7D,MAAM,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;QACrC,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,wBAAwB,CAAC,CAAA;IAC9D,CAAC;AACL,CAAC"}

package/dist/env/env.d.ts

@@ -1,5 +1,45 @@
+/**
+ * @fileoverview Environment variable validation and configuration management
+ *
+ * This utility class provides type-safe environment variable parsing with
+ * validation rules for string, number, boolean, and enum types.
+ */
+/**
+ * Environment variable validation and configuration utility.
+ *
+ * The Env class provides a schema-based approach to validating and parsing
+ * environment variables with type safety and format validation.
+ *
+ * @example
+ * ```typescript
+ * const config = Env.validate({
+ *   PORT: Env.schema.number({ optional: true, default: 3000 }),
+ *   API_URL: Env.schema.string({ format: 'url' }),
+ *   DEBUG: Env.schema.boolean({ optional: true, default: false }),
+ *   NODE_ENV: Env.schema.enum(['development', 'production', 'test'])
+ * });
+ *
+ * // config is now type-safe and validated
+ * console.log(config.PORT); // number
+ * console.log(config.API_URL); // validated URL string
+ * ```
+ */
 export declare class Env {
+    /**
+     * Schema builders for different environment variable types.
+     *
+     * Provides factory methods for creating validation rules for different
+     * data types that can be parsed from environment variables.
+     */
     static schema: {
+        /**
+         * Creates a string validation rule.
+         *
+         * @param opts - Optional configuration for string validation
+         * @param opts.optional - Whether the environment variable is optional
+         * @param opts.format - Format validation ('url' or 'email')
+         * @returns String validation rule object
+         */
         string: (opts?: {
             optional?: boolean;
             format?: "url" | "email";
@@ -8,12 +48,29 @@ export declare class Env {
             format?: "url" | "email";
             type: "string";
         };
+        /**
+         * Creates a number validation rule.
+         *
+         * @param opts - Optional configuration for number validation
+         * @param opts.optional - Whether the environment variable is optional
+         * @returns Number validation rule object
+         */
         number: (opts?: {
             optional?: boolean;
         }) => {
             optional?: boolean;
             type: "number";
         };
+        /**
+         * Creates a boolean validation rule.
+         *
+         * Accepts 'true'/'false' or '1'/'0' as valid boolean values.
+         *
+         * @param opts - Optional configuration for boolean validation
+         * @param opts.optional - Whether the environment variable is optional
+         * @param opts.default - Default value if the variable is missing
+         * @returns Boolean validation rule object
+         */
         boolean: (opts?: {
             optional?: boolean;
             default?: boolean;
@@ -22,12 +79,56 @@ export declare class Env {
             default?: boolean;
             type: "boolean";
         };
+        /**
+         * Creates an enum validation rule.
+         *
+         * @template T - Array of allowed string values
+         * @param values - Array of allowed values for this environment variable
+         * @returns Enum validation rule object
+         */
         enum: <T extends string[]>(values: T) => {
             type: "enum";
             values: T;
         };
     };
+    /**
+     * Stores the last validated configuration.
+     *
+     * This static property holds the most recently validated environment
+     * configuration for reference by other parts of the application.
+     */
     static config: Record<string, any>;
+    /**
+     * Validates environment variables against a schema definition.
+     *
+     * Parses and validates environment variables according to the provided
+     * schema, returning a type-safe configuration object.
+     *
+     * @template T - The expected type of the returned configuration object
+     * @param schema - Object mapping environment variable names to validation rules
+     * @param rawEnv - Environment variables object (defaults to process.env)
+     * @returns Validated and parsed configuration object
+     *
+     * @throws {Error} When required environment variables are missing
+     * @throws {Error} When environment variables fail format validation
+     *
+     * @example
+     * ```typescript
+     * interface Config {
+     *   DATABASE_URL: string;
+     *   PORT: number;
+     *   DEBUG: boolean;
+     *   NODE_ENV: 'development' | 'production';
+     * }
+     *
+     * const config: Config = Env.validate({
+     *   DATABASE_URL: Env.schema.string({ format: 'url' }),
+     *   PORT: Env.schema.number({ optional: true }),
+     *   DEBUG: Env.schema.boolean({ optional: true, default: false }),
+     *   NODE_ENV: Env.schema.enum(['development', 'production'])
+     * });
+     * ```
+     */
     static validate<T extends Record<string, any>>(schema: Record<string, any>, rawEnv?: NodeJS.ProcessEnv): T;
 }
 //# sourceMappingURL=env.d.ts.map

package/dist/env/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env/env.ts"],"names":[],"mappings":"AAAA,qBAAa,GAAG;IACZ,MAAM,CAAC,MAAM;wBACO;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,CAAA;SAAE;uBAAnC,OAAO;qBAAW,KAAK,GAAG,OAAO;;;wBAK9C;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE;uBAAT,OAAO;;;yBAKnB;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE;uBAA5B,OAAO;sBAAY,OAAO;;;eAKjD,CAAC,SAAS,MAAM,EAAE,UAAU,CAAC;;;;MAIvC;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAK;IAEvC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,oBAAc,GAAG,CAAC;CA2DvG"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/env/env.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,GAAG;IACZ;;;;;OAKG;IACH,MAAM,CAAC,MAAM;QACT;;;;;;;WAOG;wBACa;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,CAAA;SAAE;uBAAnC,OAAO;qBAAW,KAAK,GAAG,OAAO;;;QAK9D;;;;;;WAMG;wBACa;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE;uBAAT,OAAO;;;QAKpC;;;;;;;;;WASG;yBACc;YAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE;uBAA5B,OAAO;sBAAY,OAAO;;;QAKxD;;;;;;WAMG;eACI,CAAC,SAAS,MAAM,EAAE,UAAU,CAAC;;;;MAIvC;IAED;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAK;IAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,oBAAc,GAAG,CAAC;CA2DvG"}

package/dist/env/env.js

@@ -1,23 +1,124 @@
+/**
+ * @fileoverview Environment variable validation and configuration management
+ *
+ * This utility class provides type-safe environment variable parsing with
+ * validation rules for string, number, boolean, and enum types.
+ */
+/**
+ * Environment variable validation and configuration utility.
+ *
+ * The Env class provides a schema-based approach to validating and parsing
+ * environment variables with type safety and format validation.
+ *
+ * @example
+ * ```typescript
+ * const config = Env.validate({
+ *   PORT: Env.schema.number({ optional: true, default: 3000 }),
+ *   API_URL: Env.schema.string({ format: 'url' }),
+ *   DEBUG: Env.schema.boolean({ optional: true, default: false }),
+ *   NODE_ENV: Env.schema.enum(['development', 'production', 'test'])
+ * });
+ *
+ * // config is now type-safe and validated
+ * console.log(config.PORT); // number
+ * console.log(config.API_URL); // validated URL string
+ * ```
+ */
 export class Env {
+    /**
+     * Schema builders for different environment variable types.
+     *
+     * Provides factory methods for creating validation rules for different
+     * data types that can be parsed from environment variables.
+     */
     static { this.schema = {
+        /**
+         * Creates a string validation rule.
+         *
+         * @param opts - Optional configuration for string validation
+         * @param opts.optional - Whether the environment variable is optional
+         * @param opts.format - Format validation ('url' or 'email')
+         * @returns String validation rule object
+         */
         string: (opts) => ({
             type: 'string',
             ...opts
         }),
+        /**
+         * Creates a number validation rule.
+         *
+         * @param opts - Optional configuration for number validation
+         * @param opts.optional - Whether the environment variable is optional
+         * @returns Number validation rule object
+         */
         number: (opts) => ({
             type: 'number',
             ...opts
         }),
+        /**
+         * Creates a boolean validation rule.
+         *
+         * Accepts 'true'/'false' or '1'/'0' as valid boolean values.
+         *
+         * @param opts - Optional configuration for boolean validation
+         * @param opts.optional - Whether the environment variable is optional
+         * @param opts.default - Default value if the variable is missing
+         * @returns Boolean validation rule object
+         */
         boolean: (opts) => ({
             type: 'boolean',
             ...opts
         }),
+        /**
+         * Creates an enum validation rule.
+         *
+         * @template T - Array of allowed string values
+         * @param values - Array of allowed values for this environment variable
+         * @returns Enum validation rule object
+         */
         enum: (values) => ({
             type: 'enum',
             values
         })
     }; }
+    /**
+     * Stores the last validated configuration.
+     *
+     * This static property holds the most recently validated environment
+     * configuration for reference by other parts of the application.
+     */
     static { this.config = {}; }
+    /**
+     * Validates environment variables against a schema definition.
+     *
+     * Parses and validates environment variables according to the provided
+     * schema, returning a type-safe configuration object.
+     *
+     * @template T - The expected type of the returned configuration object
+     * @param schema - Object mapping environment variable names to validation rules
+     * @param rawEnv - Environment variables object (defaults to process.env)
+     * @returns Validated and parsed configuration object
+     *
+     * @throws {Error} When required environment variables are missing
+     * @throws {Error} When environment variables fail format validation
+     *
+     * @example
+     * ```typescript
+     * interface Config {
+     *   DATABASE_URL: string;
+     *   PORT: number;
+     *   DEBUG: boolean;
+     *   NODE_ENV: 'development' | 'production';
+     * }
+     *
+     * const config: Config = Env.validate({
+     *   DATABASE_URL: Env.schema.string({ format: 'url' }),
+     *   PORT: Env.schema.number({ optional: true }),
+     *   DEBUG: Env.schema.boolean({ optional: true, default: false }),
+     *   NODE_ENV: Env.schema.enum(['development', 'production'])
+     * });
+     * ```
+     */
     static validate(schema, rawEnv = process.env) {
         const config = {};
         for (const [key, rules] of Object.entries(schema)) {

package/dist/env/env.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,20 @@
+/**
+ * @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();
+ * ```
+ */
 export { DigitalTwinEngine } from './engine/digital_twin_engine.js';
 export { Collector } from './components/collector.js';
 export { Harvester } from './components/harvester.js';
@@ -5,6 +22,7 @@ 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 { StorageService } from './storage/storage_service.js';
 export { LocalStorageService } from './storage/adapters/local_storage_service.js';
 export { OvhS3StorageService } from './storage/adapters/ovh_storage_service.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAGnE,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,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAA;AAGzE,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;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAA;AAGlH,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AAGtC,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AAErC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAGnE,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,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAGhE,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;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAA;AAGlH,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AAGtC,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AAErC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -1,4 +1,20 @@
-// Main entry point for digitaltwin-core package
+/**
+ * @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
@@ -8,6 +24,7 @@ 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';
 // Storage Services
 export { StorageService } from './storage/storage_service.js';
 export { LocalStorageService } from './storage/adapters/local_storage_service.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAEhD,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,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAA;AAEzE,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,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAE/D,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AAErC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA"}
+{"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,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAEhE,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,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAE/D,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AAErC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA"}

package/dist/types/data_record.d.ts

@@ -1,17 +1,78 @@
+/**
+ * @fileoverview Data record type definition for digital twin data storage
+ *
+ * This module defines the standardized interface for data records used
+ * throughout the digital twin system for both streaming data and asset storage.
+ */
+/**
+ * Standard data record interface for digital twin data storage.
+ *
+ * DataRecord provides a unified interface for all data stored in the digital twin system,
+ * from streaming sensor data to asset files. It supports both database metadata
+ * and file storage through a consistent API.
+ *
+ * @example
+ * ```typescript
+ * const record: DataRecord = {
+ *   id: 12345,
+ *   name: 'weather-station-001',
+ *   date: new Date(),
+ *   contentType: 'application/json',
+ *   url: '/api/data/weather/12345',
+ *   data: async () => Buffer.from(JSON.stringify(weatherData)),
+ *   description: 'Weather data from station 001',
+ *   source: 'https://api.weather.com/v1/current',
+ *   owner_id: 123
+ * };
+ * ```
+ */
 export interface DataRecord {
+    /** Unique identifier for this data record */
     id: number;
+    /** Human-readable name or identifier for this record */
     name: string;
+    /** Timestamp when this record was created or last updated */
     date: Date;
+    /** MIME type of the data content (e.g., 'application/json', 'image/png') */
     contentType: string;
+    /** URL or path where this record can be accessed */
     url: string;
+    /**
+     * Function that returns the actual data content as a Buffer.
+     *
+     * This lazy-loading approach allows for efficient memory usage
+     * when working with large datasets or files.
+     *
+     * @returns Promise resolving to the data content as a Buffer
+     */
     data: () => Promise<Buffer>;
-    /** Human-readable description of the asset (AssetsManager only) */
+    /**
+     * Human-readable description of the asset.
+     *
+     * Used primarily by AssetsManager components to provide
+     * additional context about stored files and resources.
+     */
     description?: string;
-    /** Source URL for data provenance (AssetsManager only) */
+    /**
+     * Source URL for data provenance.
+     *
+     * Records the original source of this data for traceability
+     * and debugging purposes. Used by AssetsManager components.
+     */
     source?: string;
-    /** ID of the user who owns this asset (AssetsManager only) */
+    /**
+     * ID of the user who owns this asset.
+     *
+     * Enables access control and ownership tracking for
+     * asset management. Used by AssetsManager components.
+     */
     owner_id?: number | null;
-    /** Original filename provided by the user (AssetsManager only) */
+    /**
+     * Original filename provided by the user.
+     *
+     * Preserves the original filename when assets are uploaded
+     * or imported. Used by AssetsManager components.
+     */
     filename?: string;
 }
 //# sourceMappingURL=data_record.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"data_record.d.ts","sourceRoot":"","sources":["../../src/types/data_record.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAG3B,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB"}
+{"version":3,"file":"data_record.d.ts","sourceRoot":"","sources":["../../src/types/data_record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,UAAU;IACvB,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAA;IAEV,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IAEZ,6DAA6D;IAC7D,IAAI,EAAE,IAAI,CAAA;IAEV,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAA;IAEnB,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IAEX;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAI3B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAExB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/dist/types/data_record.js

@@ -1,2 +1,8 @@
+/**
+ * @fileoverview Data record type definition for digital twin data storage
+ *
+ * This module defines the standardized interface for data records used
+ * throughout the digital twin system for both streaming data and asset storage.
+ */
 export {};
 //# sourceMappingURL=data_record.js.map

package/dist/types/data_record.js.map

@@ -1 +1 @@
-{"version":3,"file":"data_record.js","sourceRoot":"","sources":["../../src/types/data_record.ts"],"names":[],"mappings":""}
+{"version":3,"file":"data_record.js","sourceRoot":"","sources":["../../src/types/data_record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/servable_endpoint.d.ts

@@ -1,6 +1,63 @@
-export declare function servableEndpoint(config: {
+/**
+ * @fileoverview Decorator for marking methods as HTTP endpoint handlers
+ *
+ * This utility provides a decorator to annotate component methods as HTTP endpoints
+ * that should be automatically registered with the digital twin engine's router.
+ */
+/**
+ * Configuration interface for the servable endpoint decorator.
+ */
+interface ServableEndpointConfig {
+    /** URL path for this endpoint (e.g., '/api/data/:id') */
     path: string;
+    /** HTTP method (defaults to 'get') */
     method?: string;
+    /** Response content type (defaults to 'application/json') */
     responseType?: string;
-}): (target: any, propertyKey: string | symbol, descriptor?: PropertyDescriptor) => any;
+}
+/**
+ * Decorator that marks a method as an HTTP endpoint handler.
+ *
+ * This decorator allows component methods to be automatically discovered
+ * and registered as HTTP endpoints by the digital twin engine. The decorated
+ * method will be called when HTTP requests are made to the specified path.
+ *
+ * @param config - Configuration object specifying the endpoint details
+ * @param config.path - URL path pattern for this endpoint
+ * @param config.method - HTTP method (defaults to 'GET')
+ * @param config.responseType - Response content type (defaults to 'application/json')
+ *
+ * @returns Method decorator function
+ *
+ * @example
+ * ```typescript
+ * class WeatherCollector extends Collector {
+ *   @servableEndpoint({
+ *     path: '/api/weather/current',
+ *     method: 'get',
+ *     responseType: 'application/json'
+ *   })
+ *   getCurrentWeather(req: Request) {
+ *     return {
+ *       status: 200,
+ *       content: { temperature: 22, humidity: 65 }
+ *     };
+ *   }
+ *
+ *   @servableEndpoint({
+ *     path: '/api/weather/history/:date',
+ *     method: 'get'
+ *   })
+ *   getWeatherHistory(req: Request) {
+ *     const date = req.params.date;
+ *     return {
+ *       status: 200,
+ *       content: this.getHistoricalData(date)
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export declare function servableEndpoint(config: ServableEndpointConfig): (target: any, propertyKey: string | symbol, descriptor?: PropertyDescriptor) => any;
+export {};
 //# sourceMappingURL=servable_endpoint.d.ts.map

package/dist/utils/servable_endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"servable_endpoint.d.ts","sourceRoot":"","sources":["../../src/utils/servable_endpoint.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,IAC5E,QAAQ,GAAG,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,aAAa,kBAAkB,KAAG,GAAG,CAgBpG"}
+{"version":3,"file":"servable_endpoint.d.ts","sourceRoot":"","sources":["../../src/utils/servable_endpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,UAAU,sBAAsB;IAC5B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IAEZ,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,IAC1C,QAAQ,GAAG,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,aAAa,kBAAkB,KAAG,GAAG,CAkBpG"}