digitaltwin-core 0.8.0 → 0.8.1

package/dist/components/handler.d.ts

@@ -1,31 +1,92 @@
+/**
+ * @fileoverview Handler component base class for HTTP endpoint providers
+ *
+ * Handlers are lightweight, stateless components that expose HTTP endpoints
+ * for on-demand data access, computation, or utility services within the digital twin.
+ */
 import type { Component, Servable } from './interfaces.js';
 import type { ComponentConfiguration } from './types.js';
 import type { DataResponse } from './types.js';
 import type { HttpMethod } from '../engine/endpoints.js';
 /**
- * Description of a runtime HTTP endpoint handler.
+ * Runtime descriptor for an HTTP endpoint handler.
+ *
+ * Represents a fully resolved endpoint with its bound handler function,
+ * ready for registration with the Express router.
  */
 type EndpointDescriptor = {
+    /** HTTP method for the endpoint */
     method: HttpMethod;
+    /** URL path pattern */
     path: string;
+    /** Response content type */
     responseType?: string;
+    /** Bound handler function */
     handler: (...args: any[]) => Promise<DataResponse>;
 };
 /**
- * Base abstract class for defining a Handler component.
- * A Handler is a stateless, servable component that exposes HTTP endpoints,
- * useful for on-demand computation or utility services.
+ * Abstract base class for Handler components.
+ *
+ * Handlers are lightweight, stateless components that expose HTTP endpoints
+ * for on-demand data access, computation, or utility services. Unlike Collectors
+ * and Harvesters, they don't run on schedules but respond to HTTP requests.
+ *
+ * Key features:
+ * - Expose HTTP endpoints using the @servableEndpoint decorator
+ * - Stateless operation (no database or storage dependencies by default)
+ * - Suitable for real-time computations, data queries, or API proxies
+ *
+ * @example
+ * ```typescript
+ * class CalculatorHandler extends Handler {
+ *   getConfiguration() {
+ *     return {
+ *       name: 'calculator-handler',
+ *       type: 'handler',
+ *       contentType: 'application/json'
+ *     };
+ *   }
+ *
+ *   @servableEndpoint({ path: '/api/calculate/sum', method: 'post' })
+ *   async calculateSum(req: Request) {
+ *     const { a, b } = req.body;
+ *     return {
+ *       status: 200,
+ *       content: { result: a + b }
+ *     };
+ *   }
+ * }
+ * ```
  */
 export declare abstract class Handler implements Component, Servable {
     /**
-     * Returns the static configuration of the handler.
-     * Must be implemented by subclasses.
+     * Returns the handler's configuration.
+     *
+     * Implementations must provide basic component information including
+     * name, type, and default content type for responses.
+     *
+     * @returns Component configuration object
+     *
+     * @example
+     * ```typescript
+     * getConfiguration() {
+     *   return {
+     *     name: 'my-handler',
+     *     type: 'handler',
+     *     contentType: 'application/json'
+     *   };
+     * }
+     * ```
      */
     abstract getConfiguration(): ComponentConfiguration;
     /**
-     * Resolves and returns the list of servable endpoints defined on the class.
-     * Uses static metadata declared on the constructor (__endpoints).
-     * @returns A list of endpoint descriptors mapping method/path to handlers.
+     * Resolves and returns HTTP endpoints defined on this handler.
+     *
+     * Automatically discovers endpoints declared with the @servableEndpoint
+     * decorator and creates bound handler functions for registration with
+     * the Express router.
+     *
+     * @returns Array of endpoint descriptors with bound handler functions
      */
     getEndpoints(): EndpointDescriptor[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/components/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAYxD;;GAEG;AACH,KAAK,kBAAkB,GAAG;IACtB,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;CACrD,CAAA;AAED;;;;GAIG;AACH,8BAAsB,OAAQ,YAAW,SAAS,EAAE,QAAQ;IACxD;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,IAAI,sBAAsB;IAEnD;;;;OAIG;IACH,YAAY,IAAI,kBAAkB,EAAE;CAevC"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/components/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAsBxD;;;;;GAKG;AACH,KAAK,kBAAkB,GAAG;IACtB,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAA;IAElB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IAEZ,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,6BAA6B;IAC7B,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;CACrD,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,8BAAsB,OAAQ,YAAW,SAAS,EAAE,QAAQ;IACxD;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,gBAAgB,IAAI,sBAAsB;IAEnD;;;;;;;;OAQG;IACH,YAAY,IAAI,kBAAkB,EAAE;CAevC"}

package/dist/components/handler.js

@@ -1,13 +1,52 @@
 /**
- * Base abstract class for defining a Handler component.
- * A Handler is a stateless, servable component that exposes HTTP endpoints,
- * useful for on-demand computation or utility services.
+ * @fileoverview Handler component base class for HTTP endpoint providers
+ *
+ * Handlers are lightweight, stateless components that expose HTTP endpoints
+ * for on-demand data access, computation, or utility services within the digital twin.
+ */
+/**
+ * Abstract base class for Handler components.
+ *
+ * Handlers are lightweight, stateless components that expose HTTP endpoints
+ * for on-demand data access, computation, or utility services. Unlike Collectors
+ * and Harvesters, they don't run on schedules but respond to HTTP requests.
+ *
+ * Key features:
+ * - Expose HTTP endpoints using the @servableEndpoint decorator
+ * - Stateless operation (no database or storage dependencies by default)
+ * - Suitable for real-time computations, data queries, or API proxies
+ *
+ * @example
+ * ```typescript
+ * class CalculatorHandler extends Handler {
+ *   getConfiguration() {
+ *     return {
+ *       name: 'calculator-handler',
+ *       type: 'handler',
+ *       contentType: 'application/json'
+ *     };
+ *   }
+ *
+ *   @servableEndpoint({ path: '/api/calculate/sum', method: 'post' })
+ *   async calculateSum(req: Request) {
+ *     const { a, b } = req.body;
+ *     return {
+ *       status: 200,
+ *       content: { result: a + b }
+ *     };
+ *   }
+ * }
+ * ```
  */
 export class Handler {
     /**
-     * Resolves and returns the list of servable endpoints defined on the class.
-     * Uses static metadata declared on the constructor (__endpoints).
-     * @returns A list of endpoint descriptors mapping method/path to handlers.
+     * Resolves and returns HTTP endpoints defined on this handler.
+     *
+     * Automatically discovers endpoints declared with the @servableEndpoint
+     * decorator and creates bound handler functions for registration with
+     * the Express router.
+     *
+     * @returns Array of endpoint descriptors with bound handler functions
      */
     getEndpoints() {
         const config = this.getConfiguration();

package/dist/components/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/components/handler.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,OAAgB,OAAO;IAOzB;;;;OAIG;IACH,YAAY;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,WAA+C,CAAA;QACjE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAA;QAExC,OAAO,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YACtB,MAAM,SAAS,GAAI,IAA4B,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAkC,CAAA;YAC3G,OAAO;gBACH,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,YAAY,EAAE,EAAE,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW;gBACnD,OAAO,EAAE,SAAS;aACrB,CAAA;QACL,CAAC,CAAC,CAAA;IACN,CAAC;CACJ"}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/components/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+CH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAgB,OAAO;IAsBzB;;;;;;;;OAQG;IACH,YAAY;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,WAA+C,CAAA;QACjE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAA;QAExC,OAAO,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YACtB,MAAM,SAAS,GAAI,IAA4B,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAkC,CAAA;YAC3G,OAAO;gBACH,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,YAAY,EAAE,EAAE,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW;gBACnD,OAAO,EAAE,SAAS;aACrB,CAAA;QACL,CAAC,CAAC,CAAA;IACN,CAAC;CACJ"}

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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"}