digitaltwin-core 0.1.0

package/dist/components/collector.d.ts

@@ -0,0 +1,62 @@
+import { Component, ScheduleRunnable, Servable } from './interfaces.js';
+import { CollectorConfiguration } from './types.js';
+import { DatabaseAdapter } from '../database/database_adapter.js';
+import { StorageService } from '../storage/storage_service.js';
+import { DataResponse } from './types.js';
+import type { HttpMethod } from "../engine/endpoints.js";
+/**
+ * Base abstract class for defining a Collector component.
+ * A Collector is responsible for fetching raw data from a source,
+ * storing it via a StorageService, and indexing metadata via a DatabaseAdapter.
+ * It also exposes an HTTP GET endpoint to retrieve the latest collected data.
+ */
+export declare abstract class Collector implements Component<CollectorConfiguration>, ScheduleRunnable, Servable {
+    /** Database adapter used to index metadata */
+    protected db: DatabaseAdapter;
+    /** Storage service used to save collected blobs */
+    protected storage: StorageService;
+    /**
+     * Injects dependencies into the collector.
+     * @param db - The database adapter
+     * @param storage - The storage service
+     */
+    setDependencies(db: DatabaseAdapter, storage: StorageService): void;
+    /**
+     * Returns the static configuration of the collector.
+     * Must be implemented by subclasses.
+     */
+    abstract getConfiguration(): CollectorConfiguration;
+    /**
+     * Returns a cron-style string defining the execution schedule.
+     * Must be implemented by subclasses.
+     */
+    abstract getSchedule(): string;
+    /**
+     * Actual logic to collect the data.
+     * Must be implemented by subclasses.
+     * @returns A Buffer containing the raw data.
+     */
+    abstract collect(): Promise<Buffer>;
+    /**
+     * Executes the collector's data collection process.
+     * Saves the data to storage and metadata to the database if collection is successful.
+     * @returns The collected Buffer, or void if none.
+     */
+    run(): Promise<Buffer | void>;
+    /**
+     * Defines the HTTP endpoints exposed by this component.
+     * @returns A list of route definitions.
+     */
+    getEndpoints(): Array<{
+        method: HttpMethod;
+        path: string;
+        handler: (...args: any[]) => any;
+        responseType?: string;
+    }>;
+    /**
+     * Handler to retrieve the most recently collected data.
+     * @returns A DataResponse containing status, content, and headers.
+     */
+    retrieve(): Promise<DataResponse>;
+}
+//# sourceMappingURL=collector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/components/collector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGxD;;;;;GAKG;AACH,8BAAsB,SAAU,YAAW,SAAS,CAAC,sBAAsB,CAAC,EAAE,gBAAgB,EAAE,QAAQ;IACpG,8CAA8C;IAC9C,SAAS,CAAC,EAAE,EAAG,eAAe,CAAA;IAE9B,mDAAmD;IACnD,SAAS,CAAC,OAAO,EAAG,cAAc,CAAA;IAElC;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc;IAK5D;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,IAAI,sBAAsB;IAEnD;;;OAGG;IACH,QAAQ,CAAC,WAAW,IAAI,MAAM;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAEnC;;;;OAIG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4BnC;;;OAGG;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;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;CAmB1C"}

package/dist/components/collector.js

@@ -0,0 +1,80 @@
+import { engineEventBus } from "../engine/events.js";
+/**
+ * Base abstract class for defining a Collector component.
+ * A Collector is responsible for fetching raw data from a source,
+ * storing it via a StorageService, and indexing metadata via a DatabaseAdapter.
+ * It also exposes an HTTP GET endpoint to retrieve the latest collected data.
+ */
+export class Collector {
+    /**
+     * Injects dependencies into the collector.
+     * @param db - The database adapter
+     * @param storage - The storage service
+     */
+    setDependencies(db, storage) {
+        this.db = db;
+        this.storage = storage;
+    }
+    /**
+     * Executes the collector's data collection process.
+     * Saves the data to storage and metadata to the database if collection is successful.
+     * @returns The collected Buffer, or void if none.
+     */
+    async run() {
+        const result = await this.collect();
+        if (result) {
+            const config = this.getConfiguration();
+            const now = new Date();
+            const url = await this.storage.save(result, config.name);
+            await this.db.save({
+                name: config.name,
+                type: config.contentType,
+                url,
+                date: now,
+            });
+            // Emit event after successful collection
+            engineEventBus.emit('component:event', {
+                type: 'collector:completed',
+                componentName: config.name,
+                timestamp: now,
+                data: { bytesCollected: result.length }
+            });
+        }
+        return result;
+    }
+    /**
+     * Defines the HTTP endpoints exposed by this component.
+     * @returns A list of route definitions.
+     */
+    getEndpoints() {
+        return [
+            {
+                method: 'get', // ici, 'get' est bien assignable à HttpMethod
+                path: `/${this.getConfiguration().endpoint}`,
+                handler: this.retrieve.bind(this),
+                responseType: this.getConfiguration().contentType,
+            },
+        ];
+    }
+    /**
+     * Handler to retrieve the most recently collected data.
+     * @returns A DataResponse containing status, content, and headers.
+     */
+    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=collector.js.map

package/dist/components/collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.js","sourceRoot":"","sources":["../../src/components/collector.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,OAAgB,SAAS;IAO3B;;;;OAIG;IACH,eAAe,CAAC,EAAmB,EAAE,OAAuB;QACxD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;QACZ,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IAC1B,CAAC;IAqBD;;;;OAIG;IACH,KAAK,CAAC,GAAG;QACL,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QAEnC,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;YACtC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;YAEtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;YAExD,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,WAAW;gBACxB,GAAG;gBACH,IAAI,EAAE,GAAG;aACZ,CAAC,CAAA;YAEF,yCAAyC;YACzC,cAAc,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBACnC,IAAI,EAAE,qBAAqB;gBAC3B,aAAa,EAAE,MAAM,CAAC,IAAI;gBAC1B,SAAS,EAAE,GAAG;gBACd,IAAI,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;aAC1C,CAAC,CAAA;QACN,CAAC;QAED,OAAO,MAAM,CAAA;IACjB,CAAC;IAED;;;OAGG;IACH,YAAY;QAMR,OAAO;YACH;gBACI,MAAM,EAAE,KAAK,EAAE,8CAA8C;gBAC7D,IAAI,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE;gBAC5C,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;gBACjC,YAAY,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,WAAW;aACpD;SACJ,CAAA;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAEzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO;gBACH,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,mBAAmB;aAC/B,CAAA;QACL,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QAEhC,OAAO;YACH,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE;SAClD,CAAA;IACL,CAAC;CACJ"}

package/dist/components/global_assets_handler.d.ts

@@ -0,0 +1,63 @@
+import { Handler } from './handler.js';
+import { ComponentConfiguration, DataResponse } from './types.js';
+import { AssetsManager } from './assets_manager.js';
+/**
+ * Global assets handler that provides access to ALL assets across ALL asset managers.
+ *
+ * This handler aggregates assets from all registered AssetsManager instances
+ * without duplicating their logic or hardcoding component names.
+ *
+ * @class GlobalAssetsHandler
+ * @extends {Handler}
+ *
+ * @example
+ * ```typescript
+ * const globalHandler = new GlobalAssetsHandler()
+ * globalHandler.setAssetsManagers([gltfManager, pointcloudManager])
+ *
+ * // Usage:
+ * // GET /assets/all - Returns all assets from all managers
+ * ```
+ */
+export declare class GlobalAssetsHandler extends Handler {
+    private assetsManagers;
+    /**
+     * Inject AssetsManager dependencies (called by engine)
+     */
+    setAssetsManagers(assetsManagers: AssetsManager[]): void;
+    /**
+     * Component configuration for the global assets handler
+     */
+    getConfiguration(): ComponentConfiguration;
+    /**
+     * Get all assets from all registered asset managers.
+     *
+     * This method delegates to each AssetsManager's getAllAssets() method
+     * and aggregates the results with proper endpoint URLs.
+     *
+     * @returns {Promise<DataResponse>} JSON response with all assets
+     *
+     * @example
+     * ```typescript
+     * // GET /assets/all
+     * // Returns: {
+     * //   total: 5,
+     * //   assets: [
+     * //     { id: 1, component: "gltf", url: "/gltf/1", ... },
+     * //     { id: 2, component: "pointcloud", url: "/pointcloud/2", ... }
+     * //   ]
+     * // }
+     * ```
+     */
+    getAllAssets(): Promise<DataResponse>;
+    /**
+     * HTTP endpoints for global assets
+     */
+    getEndpoints(): Array<{
+        method: any;
+        path: string;
+        handler: (...args: any[]) => any;
+        responseType?: string;
+    }>;
+}
+//# sourceMappingURL=global_assets_handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"global_assets_handler.d.ts","sourceRoot":"","sources":["../../src/components/global_assets_handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAoB,SAAQ,OAAO;IAC5C,OAAO,CAAC,cAAc,CAAsB;IAE5C;;OAEG;IACH,iBAAiB,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,IAAI;IAIxD;;OAEG;IACH,gBAAgB,IAAI,sBAAsB;IAS1C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAuD3C;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAClB,MAAM,EAAE,GAAG,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;QAChC,YAAY,CAAC,EAAE,MAAM,CAAA;KACxB,CAAC;CAUL"}

package/dist/components/global_assets_handler.js

@@ -0,0 +1,127 @@
+import { Handler } from './handler.js';
+/**
+ * Global assets handler that provides access to ALL assets across ALL asset managers.
+ *
+ * This handler aggregates assets from all registered AssetsManager instances
+ * without duplicating their logic or hardcoding component names.
+ *
+ * @class GlobalAssetsHandler
+ * @extends {Handler}
+ *
+ * @example
+ * ```typescript
+ * const globalHandler = new GlobalAssetsHandler()
+ * globalHandler.setAssetsManagers([gltfManager, pointcloudManager])
+ *
+ * // Usage:
+ * // GET /assets/all - Returns all assets from all managers
+ * ```
+ */
+export class GlobalAssetsHandler extends Handler {
+    constructor() {
+        super(...arguments);
+        this.assetsManagers = [];
+    }
+    /**
+     * Inject AssetsManager dependencies (called by engine)
+     */
+    setAssetsManagers(assetsManagers) {
+        this.assetsManagers = assetsManagers;
+    }
+    /**
+     * Component configuration for the global assets handler
+     */
+    getConfiguration() {
+        return {
+            name: 'global_assets',
+            description: 'Global handler for all assets across all managers',
+            contentType: 'application/json',
+            tags: ['assets', 'global', 'all']
+        };
+    }
+    /**
+     * Get all assets from all registered asset managers.
+     *
+     * This method delegates to each AssetsManager's getAllAssets() method
+     * and aggregates the results with proper endpoint URLs.
+     *
+     * @returns {Promise<DataResponse>} JSON response with all assets
+     *
+     * @example
+     * ```typescript
+     * // GET /assets/all
+     * // Returns: {
+     * //   total: 5,
+     * //   assets: [
+     * //     { id: 1, component: "gltf", url: "/gltf/1", ... },
+     * //     { id: 2, component: "pointcloud", url: "/pointcloud/2", ... }
+     * //   ]
+     * // }
+     * ```
+     */
+    async getAllAssets() {
+        try {
+            const allAssets = [];
+            // Iterate through all registered AssetsManager instances
+            for (const manager of this.assetsManagers) {
+                try {
+                    const assets = await manager.getAllAssets();
+                    const config = manager.getConfiguration();
+                    // Transform assets to include component info and URLs
+                    const transformedAssets = assets.map(asset => ({
+                        id: asset.id,
+                        component: config.name,
+                        date: asset.date,
+                        contentType: asset.contentType,
+                        description: asset.description,
+                        source: asset.source,
+                        owner_id: asset.owner_id,
+                        filename: asset.filename,
+                        // Generate URLs using the manager's configuration
+                        url: `/${config.name}/${asset.id}`,
+                        download_url: `/${config.name}/${asset.id}/download`
+                    }));
+                    allAssets.push(...transformedAssets);
+                }
+                catch (error) {
+                    // Skip this manager if it fails, don't break the whole operation
+                    console.warn(`Failed to get assets from manager ${manager.getConfiguration().name}:`, error);
+                    continue;
+                }
+            }
+            // Sort by date (newest first)
+            allAssets.sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime());
+            return {
+                status: 200,
+                content: JSON.stringify({
+                    total: allAssets.length,
+                    assets: allAssets
+                }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+        catch (error) {
+            return {
+                status: 500,
+                content: JSON.stringify({
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+    }
+    /**
+     * HTTP endpoints for global assets
+     */
+    getEndpoints() {
+        return [
+            {
+                method: 'get',
+                path: '/assets/all',
+                handler: this.getAllAssets.bind(this),
+                responseType: 'application/json',
+            }
+        ];
+    }
+}
+//# sourceMappingURL=global_assets_handler.js.map

package/dist/components/global_assets_handler.js.map

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

package/dist/components/handler.d.ts

@@ -0,0 +1,33 @@
+import { Component, Servable } from './interfaces.js';
+import { ComponentConfiguration } from './types.js';
+import { DataResponse } from './types.js';
+import { HttpMethod } from "../engine/endpoints.js";
+/**
+ * Description of a runtime HTTP endpoint handler.
+ */
+type EndpointDescriptor = {
+    method: HttpMethod;
+    path: string;
+    responseType?: string;
+    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.
+ */
+export declare abstract class Handler implements Component, Servable {
+    /**
+     * Returns the static configuration of the handler.
+     * Must be implemented by subclasses.
+     */
+    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.
+     */
+    getEndpoints(): EndpointDescriptor[];
+}
+export {};
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/components/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAYpD;;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"}

package/dist/components/handler.js

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+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.
+     */
+    getEndpoints() {
+        const config = this.getConfiguration();
+        const ctor = this.constructor;
+        const endpoints = ctor.__endpoints || [];
+        return endpoints.map((ep) => {
+            const handlerFn = this[ep.handlerName].bind(this);
+            return {
+                method: ep.method,
+                path: ep.path,
+                responseType: ep.responseType || config.contentType,
+                handler: handlerFn,
+            };
+        });
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/components/handler.js.map

@@ -0,0 +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,CAAC,EAAE,EAAE,EAAE;YACxB,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

@@ -0,0 +1,54 @@
+import { Component, ScheduleRunnable, Servable } from './interfaces.js';
+import { DataResponse, HarvesterConfiguration } from "./types.js";
+import { DataRecord } from "../types/data_record.js";
+import { DatabaseAdapter } from '../database/database_adapter.js';
+import { StorageService } from '../storage/storage_service.js';
+import type { HttpMethod } from "../engine/endpoints.js";
+/**
+ * Abstract Harvester class for processing collected data
+ */
+export declare abstract class Harvester implements Component<HarvesterConfiguration>, ScheduleRunnable, Servable {
+    protected db: DatabaseAdapter;
+    protected storage: StorageService;
+    setDependencies(db: DatabaseAdapter, storage: StorageService): void;
+    abstract getConfiguration(): HarvesterConfiguration;
+    /**
+     * Override to make schedule optional based on trigger mode
+     */
+    getSchedule(): string;
+    /**
+     * Allow subclasses to define custom schedule
+     */
+    getCustomSchedule?(): string;
+    abstract harvest(sourceData: DataRecord | DataRecord[], dependenciesData: Record<string, DataRecord | DataRecord[]>): Promise<Buffer | Buffer[]>;
+    /**
+     * Main execution method - NOUVELLE VERSION SIMPLIFIÉE
+     */
+    run(): Promise<boolean>;
+    /**
+     * Get source data within the specified range
+     */
+    private getSourceData;
+    /**
+     * Get data from dependent components
+     */
+    private getDependenciesData;
+    /**
+     * Store harvesting results
+     */
+    private storeResults;
+    /**
+     * HTTP endpoints
+     */
+    getEndpoints(): Array<{
+        method: HttpMethod;
+        path: string;
+        handler: (...args: any[]) => any;
+        responseType?: string;
+    }>;
+    /**
+     * Retrieve latest harvested data
+     */
+    retrieve(): Promise<DataResponse>;
+}
+//# sourceMappingURL=harvester.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harvester.d.ts","sourceRoot":"","sources":["../../src/components/harvester.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAkFxD;;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,QAAQ,CAAC,gBAAgB,IAAI,sBAAsB;IAEnD;;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,CAAC,GAC5D,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;IAoE7B;;OAEG;YACW,aAAa;IA2B3B;;OAEG;YACW,mBAAmB;IA4CjC;;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"}