digitaltwin-core 0.8.2 → 0.8.3

package/dist/components/harvester.d.ts

@@ -5,47 +5,144 @@ import type { DatabaseAdapter } from '../database/database_adapter.js';
 import type { StorageService } from '../storage/storage_service.js';
 import type { HttpMethod } from '../engine/endpoints.js';
 /**
- * Abstract Harvester class for processing collected data
+ * Abstract base class for data harvesting components.
+ *
+ * Harvesters process and analyze data that has been collected by Collectors,
+ * applying transformations, aggregations, or other data processing operations.
+ * They can be triggered by new source data or run on a schedule.
+ *
+ * Key features:
+ * - Process existing collected data with configurable ranges
+ * - Support both time-based and count-based data retrieval
+ * - Can be triggered by source data changes or scheduled execution
+ * - Provide HTTP endpoints for accessing processed results
+ *
+ * @example
+ * ```typescript
+ * class TrafficAnalysisHarvester extends Harvester {
+ *   getUserConfiguration() {
+ *     return {
+ *       name: 'traffic-analysis',
+ *       type: 'harvester',
+ *       source: 'traffic-collector',
+ *       source_range: '1h', // Process last hour of data
+ *       schedule: '0 *\/15 * * * *' // Run every 15 minutes
+ *     };
+ *   }
+ *
+ *   async harvest(data: DataRecord[]): Promise<DataRecord[]> {
+ *     // Process traffic data and return analysis results
+ *     return this.analyzeTrafficPatterns(data);
+ *   }
+ * }
+ * ```
  */
 export declare abstract class Harvester implements Component<HarvesterConfiguration>, ScheduleRunnable, Servable {
     protected db: DatabaseAdapter;
     protected storage: StorageService;
-    setDependencies(db: DatabaseAdapter, storage: StorageService): void;
     private _configCache?;
     /**
-     * Users implement this to provide their basic configuration
+     * Injects database and storage dependencies into the harvester.
+     *
+     * Called during component initialization to provide access to
+     * data storage and file operations.
+     *
+     * @param db - Database adapter for reading source data
+     * @param storage - Storage service for file operations
+     */
+    setDependencies(db: DatabaseAdapter, storage: StorageService): void;
+    /**
+     * Provides the basic harvester configuration.
+     *
+     * Implementations must return configuration specifying the harvester's
+     * name, data source, processing range, and scheduling information.
+     *
+     * @returns Basic harvester configuration without defaults applied
+     *
+     * @example
+     * ```typescript
+     * getUserConfiguration() {
+     *   return {
+     *     name: 'weather-analysis',
+     *     type: 'harvester',
+     *     source: 'weather-collector',
+     *     source_range: '24h',
+     *     schedule: '0 0 * * * *' // Daily at midnight
+     *   };
+     * }
+     * ```
      */
     abstract getUserConfiguration(): HarvesterConfiguration;
     /**
-     * Final configuration with defaults applied
-     * This is what the engine/scheduler use
+     * Returns the complete harvester configuration with defaults applied.
+     *
+     * Merges user configuration with sensible defaults for optional settings.
+     * This final configuration is used by the engine and scheduler.
+     *
+     * @returns Complete configuration with all defaults applied
      */
     getConfiguration(): HarvesterConfiguration;
     /**
-     * Override to make schedule optional based on trigger mode
+     * Returns the cron schedule for this harvester.
+     *
+     * For 'on-source' trigger mode, returns empty string (no schedule).
+     * For 'scheduled' mode, uses the provided schedule or defaults to every minute.
+     *
+     * @returns Cron expression string or empty string for source-triggered mode
      */
     getSchedule(): string;
     /**
-     * Allow subclasses to define custom schedule
+     * Allows subclasses to define a custom schedule.
+     *
+     * Override this method to provide a custom cron expression
+     * that differs from the default every-minute schedule.
+     *
+     * @returns Custom cron expression string
+     *
+     * @example
+     * ```typescript
+     * getCustomSchedule() {
+     *   return '0 0 *\/6 * * *'; // Every 6 hours
+     * }
+     * ```
      */
     getCustomSchedule?(): string;
-    abstract harvest(sourceData: DataRecord | DataRecord[], dependenciesData: Record<string, DataRecord | DataRecord[] | null>): Promise<Buffer | Buffer[]>;
     /**
-     * Main execution method - NOUVELLE VERSION SIMPLIFIÉE
+     * Processes source data and returns harvested results.
+     *
+     * This is the main data processing method that implementations must provide.
+     * It receives source data (from the configured source component) and any
+     * dependency data, then performs analysis, transformation, or aggregation.
+     *
+     * @param sourceData - Data from the source component (single record or array)
+     * @param dependenciesData - Data from dependency components, keyed by component name
+     * @returns Processed data as Buffer(s) to be stored
+     *
+     * @example
+     * ```typescript
+     * async harvest(sourceData: DataRecord[], dependenciesData: Record<string, DataRecord[]>) {
+     *   const trafficData = sourceData.map(r => JSON.parse(r.data.toString()));
+     *   const analysis = this.performTrafficAnalysis(trafficData);
+     *   return Buffer.from(JSON.stringify(analysis));
+     * }
+     * ```
      */
-    run(): Promise<boolean>;
-    /**
-     * Get source data within the specified range
-     */
-    private getSourceData;
-    /**
-     * Get data from dependent components
-     */
-    private getDependenciesData;
+    abstract harvest(sourceData: DataRecord | DataRecord[], dependenciesData: Record<string, DataRecord | DataRecord[] | null>): Promise<Buffer | Buffer[]>;
     /**
-     * Store harvesting results
+     * Main execution method for the harvester.
+     *
+     * Orchestrates the harvesting process by:
+     * 1. Determining the date range for data retrieval
+     * 2. Fetching source and dependency data
+     * 3. Calling the harvest method with the data
+     * 4. Storing the results in the database
+     *
+     * @returns True if harvesting was successful, false if no data to process
+     *
+     * @throws {Error} When source component is not specified
+     * @throws {Error} When data processing fails
      */
-    private storeResults;
+    run(): Promise<boolean>;
     /**
      * HTTP endpoints
      */
@@ -59,5 +156,17 @@ export declare abstract class Harvester implements Component<HarvesterConfigurat
      * Retrieve latest harvested data
      */
     retrieve(): Promise<DataResponse>;
+    /**
+     * Get source data within the specified range
+     */
+    private getSourceData;
+    /**
+     * Get data from dependent components
+     */
+    private getDependenciesData;
+    /**
+     * Store harvesting results
+     */
+    private storeResults;
 }
 //# sourceMappingURL=harvester.d.ts.map

package/dist/components/harvester.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harvester.d.ts","sourceRoot":"","sources":["../../src/components/harvester.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAiFxD;;GAEG;AACH,8BAAsB,SAAU,YAAW,SAAS,CAAC,sBAAsB,CAAC,EAAE,gBAAgB,EAAE,QAAQ;IACpG,SAAS,CAAC,EAAE,EAAG,eAAe,CAAA;IAC9B,SAAS,CAAC,OAAO,EAAG,cAAc,CAAA;IAElC,eAAe,CAAC,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc;IAK5D,OAAO,CAAC,YAAY,CAAC,CAAwB;IAE7C;;OAEG;IACH,QAAQ,CAAC,oBAAoB,IAAI,sBAAsB;IAEvD;;;OAGG;IACH,gBAAgB,IAAI,sBAAsB;IA0B1C;;OAEG;IACH,WAAW,IAAI,MAAM;IASrB;;OAEG;IACH,iBAAiB,CAAC,IAAI,MAAM;IAE5B,QAAQ,CAAC,OAAO,CACZ,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,EACrC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,GACnE,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;IA4D7B;;OAEG;YACW,aAAa;IAsB3B;;OAEG;YACW,mBAAmB;IAyBjC;;OAEG;YACW,YAAY;IAkC1B;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAClB,MAAM,EAAE,UAAU,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAChC,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC;IAWF;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;CAmB1C"}
+{"version":3,"file":"harvester.d.ts","sourceRoot":"","sources":["../../src/components/harvester.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AA2HxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,8BAAsB,SAAU,YAAW,SAAS,CAAC,sBAAsB,CAAC,EAAE,gBAAgB,EAAE,QAAQ;IACpG,SAAS,CAAC,EAAE,EAAG,eAAe,CAAA;IAC9B,SAAS,CAAC,OAAO,EAAG,cAAc,CAAA;IAClC,OAAO,CAAC,YAAY,CAAC,CAAwB;IAE7C;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc;IAK5D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,oBAAoB,IAAI,sBAAsB;IAEvD;;;;;;;OAOG;IACH,gBAAgB,IAAI,sBAAsB;IA0B1C;;;;;;;OAOG;IACH,WAAW,IAAI,MAAM;IASrB;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CAAC,IAAI,MAAM;IAE5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,OAAO,CACZ,UAAU,EAAE,UAAU,GAAG,UAAU,EAAE,EACrC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,GACnE,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;IAE7B;;;;;;;;;;;;;OAaG;IACG,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;IA4D7B;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAClB,MAAM,EAAE,UAAU,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAChC,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC;IAWF;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAoBvC;;OAEG;YACW,aAAa;IAsB3B;;OAEG;YACW,mBAAmB;IAyBjC;;OAEG;YACW,YAAY;CAiC7B"}

package/dist/components/harvester.js

@@ -1,8 +1,37 @@
 /**
- * Utility class for handling source range parsing
+ * Utility class for parsing harvester source range configurations.
+ *
+ * Handles conversion of various source range formats (time-based like '1h', '30m'
+ * or count-based like '100') into structured date ranges for data retrieval.
+ *
+ * @example
+ * ```typescript
+ * // Parse time-based range: get data from last hour
+ * const result = SourceRangeParser.parseSourceRange(new Date(), '1h');
+ *
+ * // Parse count-based range: get last 50 records
+ * const result = SourceRangeParser.parseSourceRange(new Date(), 50);
+ * ```
  */
 class SourceRangeParser {
     static { this.ZERO_DATE = new Date('1970-01-01T00:00:00Z'); }
+    /**
+     * Gets the zero date used as fallback for empty datasets.
+     *
+     * @returns Unix epoch date (1970-01-01T00:00:00Z)
+     */
+    static get zeroDate() {
+        return new Date(this.ZERO_DATE);
+    }
+    /**
+     * Parses source range configuration into a structured result.
+     *
+     * @param latestDate - The latest date in the existing data
+     * @param sourceRange - Range specification (e.g., '1h', '30m', '7d', or number for count)
+     * @returns Parsed range result with start/end dates or record limit
+     *
+     * @throws {Error} When source range format is invalid
+     */
     static parseSourceRange(latestDate, sourceRange) {
         if (!sourceRange) {
             return { startDate: latestDate, limit: 1 };
@@ -39,6 +68,14 @@ class SourceRangeParser {
         const endDate = this.addTime(startDate, value, unit);
         return { startDate, endDate };
     }
+    /**
+     * Adds time to a date based on the specified unit.
+     *
+     * @param date - Base date to add time to
+     * @param value - Amount of time to add
+     * @param unit - Time unit ('days', 'hours', 'minutes', 'seconds')
+     * @returns New date with added time
+     */
     static addTime(date, value, unit) {
         const result = new Date(date);
         switch (unit) {
@@ -57,21 +94,61 @@ class SourceRangeParser {
         }
         return result;
     }
-    static get zeroDate() {
-        return new Date(this.ZERO_DATE);
-    }
 }
 /**
- * Abstract Harvester class for processing collected data
+ * Abstract base class for data harvesting components.
+ *
+ * Harvesters process and analyze data that has been collected by Collectors,
+ * applying transformations, aggregations, or other data processing operations.
+ * They can be triggered by new source data or run on a schedule.
+ *
+ * Key features:
+ * - Process existing collected data with configurable ranges
+ * - Support both time-based and count-based data retrieval
+ * - Can be triggered by source data changes or scheduled execution
+ * - Provide HTTP endpoints for accessing processed results
+ *
+ * @example
+ * ```typescript
+ * class TrafficAnalysisHarvester extends Harvester {
+ *   getUserConfiguration() {
+ *     return {
+ *       name: 'traffic-analysis',
+ *       type: 'harvester',
+ *       source: 'traffic-collector',
+ *       source_range: '1h', // Process last hour of data
+ *       schedule: '0 *\/15 * * * *' // Run every 15 minutes
+ *     };
+ *   }
+ *
+ *   async harvest(data: DataRecord[]): Promise<DataRecord[]> {
+ *     // Process traffic data and return analysis results
+ *     return this.analyzeTrafficPatterns(data);
+ *   }
+ * }
+ * ```
  */
 export class Harvester {
+    /**
+     * Injects database and storage dependencies into the harvester.
+     *
+     * Called during component initialization to provide access to
+     * data storage and file operations.
+     *
+     * @param db - Database adapter for reading source data
+     * @param storage - Storage service for file operations
+     */
     setDependencies(db, storage) {
         this.db = db;
         this.storage = storage;
     }
     /**
-     * Final configuration with defaults applied
-     * This is what the engine/scheduler use
+     * Returns the complete harvester configuration with defaults applied.
+     *
+     * Merges user configuration with sensible defaults for optional settings.
+     * This final configuration is used by the engine and scheduler.
+     *
+     * @returns Complete configuration with all defaults applied
      */
     getConfiguration() {
         if (this._configCache) {
@@ -95,7 +172,12 @@ export class Harvester {
         return this._configCache;
     }
     /**
-     * Override to make schedule optional based on trigger mode
+     * Returns the cron schedule for this harvester.
+     *
+     * For 'on-source' trigger mode, returns empty string (no schedule).
+     * For 'scheduled' mode, uses the provided schedule or defaults to every minute.
+     *
+     * @returns Cron expression string or empty string for source-triggered mode
      */
     getSchedule() {
         const config = this.getConfiguration();
@@ -106,7 +188,18 @@ export class Harvester {
         return '0 * * * * *';
     }
     /**
-     * Main execution method - NOUVELLE VERSION SIMPLIFIÉE
+     * Main execution method for the harvester.
+     *
+     * Orchestrates the harvesting process by:
+     * 1. Determining the date range for data retrieval
+     * 2. Fetching source and dependency data
+     * 3. Calling the harvest method with the data
+     * 4. Storing the results in the database
+     *
+     * @returns True if harvesting was successful, false if no data to process
+     *
+     * @throws {Error} When source component is not specified
+     * @throws {Error} When data processing fails
      */
     async run() {
         const config = this.getConfiguration();
@@ -151,6 +244,38 @@ export class Harvester {
         await this.storeResults(config, result, sourceData, storageDate);
         return true;
     }
+    /**
+     * HTTP endpoints
+     */
+    getEndpoints() {
+        return [
+            {
+                method: 'get',
+                path: `/${this.getConfiguration().endpoint}`,
+                handler: this.retrieve.bind(this),
+                responseType: this.getConfiguration().contentType
+            }
+        ];
+    }
+    /**
+     * Retrieve latest harvested data
+     */
+    async retrieve() {
+        const config = this.getConfiguration();
+        const record = await this.db.getLatestByName(config.name);
+        if (!record) {
+            return {
+                status: 404,
+                content: 'No data available'
+            };
+        }
+        const blob = await record.data();
+        return {
+            status: 200,
+            content: blob,
+            headers: { 'Content-Type': record.contentType }
+        };
+    }
     /**
      * Get source data within the specified range
      */
@@ -221,37 +346,5 @@ export class Harvester {
             });
         }
     }
-    /**
-     * HTTP endpoints
-     */
-    getEndpoints() {
-        return [
-            {
-                method: 'get',
-                path: `/${this.getConfiguration().endpoint}`,
-                handler: this.retrieve.bind(this),
-                responseType: this.getConfiguration().contentType
-            }
-        ];
-    }
-    /**
-     * Retrieve latest harvested data
-     */
-    async retrieve() {
-        const config = this.getConfiguration();
-        const record = await this.db.getLatestByName(config.name);
-        if (!record) {
-            return {
-                status: 404,
-                content: 'No data available'
-            };
-        }
-        const blob = await record.data();
-        return {
-            status: 200,
-            content: blob,
-            headers: { 'Content-Type': record.contentType }
-        };
-    }
 }
 //# sourceMappingURL=harvester.js.map

package/dist/components/harvester.js.map

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

package/dist/components/interfaces.d.ts

@@ -1,17 +1,125 @@
+/**
+ * @fileoverview Core interfaces defining the contract for digital twin components
+ *
+ * These interfaces establish the foundation for component architecture, scheduling,
+ * and HTTP endpoint serving capabilities within the digital twin ecosystem.
+ */
 import type { ComponentConfiguration } from './types.js';
 import type { HttpMethod } from '../engine/endpoints.js';
+/**
+ * Base interface for all digital twin components.
+ *
+ * Components are the fundamental building blocks of a digital twin system,
+ * each responsible for a specific aspect of data management or processing.
+ *
+ * @template T - The type of configuration object this component uses
+ *
+ * @example
+ * ```typescript
+ * class MyCollector implements Component<MyCollectorConfig> {
+ *   getConfiguration(): MyCollectorConfig {
+ *     return { name: 'my-collector', interval: 5000 };
+ *   }
+ * }
+ * ```
+ */
 export interface Component<T extends ComponentConfiguration = ComponentConfiguration> {
+    /**
+     * Returns the configuration object for this component.
+     *
+     * The configuration contains metadata about the component such as its name,
+     * type, scheduling information, and component-specific settings.
+     *
+     * @returns The component's configuration object
+     */
     getConfiguration(): T;
 }
+/**
+ * Interface for components that can be scheduled to run periodically.
+ *
+ * Components implementing this interface can be automatically executed
+ * by the digital twin engine's scheduler based on a cron expression.
+ *
+ * @example
+ * ```typescript
+ * class DataCollector implements ScheduleRunnable {
+ *   async run(): Promise<void> {
+ *     // Collect and process data
+ *     console.log('Collecting data...');
+ *   }
+ *
+ *   getSchedule(): string {
+ *     return '0 *.5 * * * *'; // Every 5 minutes
+ *   }
+ * }
+ * ```
+ */
 export interface ScheduleRunnable {
+    /**
+     * Executes the component's main functionality.
+     *
+     * This method is called automatically by the scheduler according to
+     * the schedule returned by getSchedule(). Implementations should handle
+     * errors appropriately and return a promise that resolves when the
+     * operation is complete.
+     *
+     * @returns A promise that resolves when the run operation completes
+     */
     run(): Promise<unknown>;
+    /**
+     * Returns the cron expression defining when this component should run.
+     *
+     * The schedule follows standard cron syntax (second minute hour day month dayOfWeek).
+     *
+     * @returns A cron expression string (e.g., '0 *.5 * * * *' for every 5 minutes)
+     */
     getSchedule(): string;
 }
+/**
+ * Interface for components that can expose HTTP endpoints.
+ *
+ * Components implementing this interface can serve HTTP requests,
+ * allowing external systems to interact with the digital twin's data
+ * and functionality through REST APIs.
+ *
+ * @example
+ * ```typescript
+ * class DataProvider implements Servable {
+ *   getEndpoints() {
+ *     return [
+ *       {
+ *         method: 'GET',
+ *         path: '/api/data',
+ *         handler: this.getData.bind(this),
+ *         responseType: 'application/json'
+ *       }
+ *     ];
+ *   }
+ *
+ *   private async getData() {
+ *     return { data: 'example' };
+ *   }
+ * }
+ * ```
+ */
 export interface Servable {
+    /**
+     * Returns an array of HTTP endpoints this component exposes.
+     *
+     * Each endpoint defines the HTTP method, URL path, handler function,
+     * and optional response content type. The digital twin engine will
+     * automatically register these endpoints with the HTTP server.
+     *
+     * @returns Array of endpoint definitions
+     */
     getEndpoints(): Array<{
+        /** HTTP method for this endpoint (GET, POST, PUT, DELETE, etc.) */
         method: HttpMethod;
+        /** URL path for this endpoint (e.g., '/api/data') */
         path: string;
+        /** Function to handle requests to this endpoint */
         handler: (...args: any[]) => any;
+        /** Optional response content type (defaults to 'application/json') */
         responseType?: string;
     }>;
 }

package/dist/components/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/components/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,sBAAsB,GAAG,sBAAsB;IAChF,gBAAgB,IAAI,CAAC,CAAA;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACvB,WAAW,IAAI,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,QAAQ;IACrB,YAAY,IAAI,KAAK,CAAC;QAClB,MAAM,EAAE,UAAU,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAChC,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC,CAAA;CACL"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/components/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,sBAAsB,GAAG,sBAAsB;IAChF;;;;;;;OAOG;IACH,gBAAgB,IAAI,CAAC,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;;;;;;;OASG;IACH,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAEvB;;;;;;OAMG;IACH,WAAW,IAAI,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,QAAQ;IACrB;;;;;;;;OAQG;IACH,YAAY,IAAI,KAAK,CAAC;QAClB,mEAAmE;QACnE,MAAM,EAAE,UAAU,CAAA;QAClB,qDAAqD;QACrD,IAAI,EAAE,MAAM,CAAA;QACZ,mDAAmD;QACnD,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAChC,sEAAsE;QACtE,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC,CAAA;CACL"}

package/dist/components/interfaces.js

@@ -1,2 +1,8 @@
+/**
+ * @fileoverview Core interfaces defining the contract for digital twin components
+ *
+ * These interfaces establish the foundation for component architecture, scheduling,
+ * and HTTP endpoint serving capabilities within the digital twin ecosystem.
+ */
 export {};
 //# sourceMappingURL=interfaces.js.map

package/dist/components/interfaces.js.map

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

package/dist/components/map_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map_manager.d.ts","sourceRoot":"","sources":["../../src/components/map_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAA0B,YAAY,EAAE,MAAM,YAAY,CAAA;AAGtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,8BAAsB,UAAW,SAAQ,aAAa;IAClD;;;;;;;;;;OAUG;IACG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAqHnD;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA+D3B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;CAwC1C"}
+{"version":3,"file":"map_manager.d.ts","sourceRoot":"","sources":["../../src/components/map_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,8BAAsB,UAAW,SAAQ,aAAa;IAClD;;;;;;;;;;OAUG;IACG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAqHnD;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA+D3B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;CAwC1C"}

package/dist/components/tileset_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tileset_manager.d.ts","sourceRoot":"","sources":["../../src/components/tileset_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAA0B,YAAY,EAAE,MAAM,YAAY,CAAA;AAKtE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAEhB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,8BAAsB,cAAe,SAAQ,aAAa;IACtD;;;;;;;;;;OAUG;IACG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAsJnD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;CAwC1C"}
+{"version":3,"file":"tileset_manager.d.ts","sourceRoot":"","sources":["../../src/components/tileset_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAK9C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAEhB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,8BAAsB,cAAe,SAAQ,aAAa;IACtD;;;;;;;;;;OAUG;IACG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAsJnD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;CAwC1C"}

package/dist/database/adapters/knex_database_adapter.d.ts

@@ -26,11 +26,11 @@ export declare class KnexDatabaseAdapter extends DatabaseAdapter {
     /**
      * Create a KnexDatabaseAdapter for PostgreSQL with simplified configuration
      */
-    static forPostgreSQL(pgConfig: PostgreSQLConfig, storage: StorageService, tableName?: string): KnexDatabaseAdapter;
+    static forPostgreSQL(pgConfig: PostgreSQLConfig, storage: StorageService, _tableName?: string): KnexDatabaseAdapter;
     /**
      * Create a KnexDatabaseAdapter for SQLite with simplified configuration
      */
-    static forSQLite(sqliteConfig: SQLiteConfig, storage: StorageService, tableName?: string): KnexDatabaseAdapter;
+    static forSQLite(sqliteConfig: SQLiteConfig, storage: StorageService, _tableName?: string): KnexDatabaseAdapter;
     save(meta: MetadataRow): Promise<DataRecord>;
     delete(id: string, name: string): Promise<void>;
     getById(id: string, name: string): Promise<DataRecord | undefined>;
@@ -61,6 +61,19 @@ export declare class KnexDatabaseAdapter extends DatabaseAdapter {
     findByConditions(tableName: string, conditions: Record<string, any>): Promise<DataRecord[]>;
     updateById(tableName: string, id: number, data: Record<string, any>): Promise<void>;
     close(): Promise<void>;
+    /**
+     * Find records for custom tables (returns raw database rows, not DataRecords)
+     * This bypasses mapToDataRecord() which assumes standard table structure
+     */
+    findCustomTableRecords(tableName: string, conditions?: Record<string, any>): Promise<any[]>;
+    /**
+     * Get a single custom table record by ID (returns raw database row, not DataRecord)
+     */
+    getCustomTableRecordById(tableName: string, id: number): Promise<any | null>;
+    /**
+     * Insert a record into a custom table (returns the new record ID)
+     */
+    insertCustomTableRecord(tableName: string, data: Record<string, any>): Promise<number>;
     /**
      * Get the underlying Knex instance for advanced operations
      */