@golemio/chmu 1.1.1-dev.2647709694 → 1.1.1-dev.2674913750

package/dist/integration-engine/datasources/AbstractOpendataDatasource.d.ts

@@ -0,0 +1,19 @@
+/** Raw record shape shared by both the live (daily) and historical (monthly) ČHMÚ opendata sources. */
+export interface IRawOpendataRecord {
+    STATION: string;
+    ELEMENT: string;
+    DT: string;
+    VAL: number | "";
+    FLAG: string;
+    QUALITY: number;
+}
+export declare abstract class AbstractOpendataDatasource {
+    abstract name: string;
+    private readonly responseValidator;
+    private readonly recordValidator;
+    protected abstract buildUrl(wsi: string, date: Date): string;
+    getData(wsi: string, date?: Date): Promise<IRawOpendataRecord[]>;
+    private getDatasource;
+    private parseHeader;
+    private mapToRecords;
+}

package/dist/integration-engine/datasources/AbstractOpendataDatasource.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractOpendataDatasource = void 0;
+const datasources_1 = require("@golemio/core/dist/integration-engine/datasources");
+const HTTPFetchProtocolStrategy_1 = require("@golemio/core/dist/integration-engine/datasources/protocol-strategy/HTTPFetchProtocolStrategy");
+const golemio_validator_1 = require("@golemio/core/dist/shared/golemio-validator");
+const OpendataSchemaProvider_1 = __importDefault(require("../../schema-definitions/datasources/OpendataSchemaProvider"));
+const REQUIRED_COLUMNS = ["STATION", "ELEMENT", "DT", "VAL", "FLAG", "QUALITY"];
+class AbstractOpendataDatasource {
+    constructor() {
+        this.responseValidator = new golemio_validator_1.JSONSchemaValidator("OpendataResponseValidator", OpendataSchemaProvider_1.default.getResponseSchema());
+        this.recordValidator = new golemio_validator_1.JSONSchemaValidator("OpendataRecordValidator", OpendataSchemaProvider_1.default.get());
+    }
+    async getData(wsi, date = new Date()) {
+        const { header, values } = await this.getDatasource(this.buildUrl(wsi, date)).getAll();
+        const colIndex = this.parseHeader(header);
+        const records = this.mapToRecords(values, colIndex);
+        await this.recordValidator.Validate(records);
+        return records;
+    }
+    getDatasource(url) {
+        return new datasources_1.DataSource("OpendataHttpDataSource", new HTTPFetchProtocolStrategy_1.HTTPFetchProtocolStrategy({ url, method: "GET", responseType: "json" }), new datasources_1.JSONDataTypeStrategy({ resultsPath: "data.data" }), this.responseValidator);
+    }
+    parseHeader(header) {
+        const colIndex = Object.fromEntries(header.split(",").map((c, i) => [c, i]));
+        const missing = REQUIRED_COLUMNS.filter((c) => colIndex[c] === undefined);
+        if (missing.length > 0) {
+            throw new Error(`${this.constructor.name}: missing columns in header: ${missing.join(", ")}`);
+        }
+        return colIndex;
+    }
+    mapToRecords(values, colIndex) {
+        return values.map((row) => ({
+            STATION: row[colIndex["STATION"]],
+            ELEMENT: row[colIndex["ELEMENT"]],
+            DT: row[colIndex["DT"]],
+            VAL: row[colIndex["VAL"]],
+            FLAG: row[colIndex["FLAG"]],
+            QUALITY: row[colIndex["QUALITY"]],
+        }));
+    }
+}
+exports.AbstractOpendataDatasource = AbstractOpendataDatasource;
+//# sourceMappingURL=AbstractOpendataDatasource.js.map

package/dist/integration-engine/datasources/AbstractOpendataDatasource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractOpendataDatasource.js","sourceRoot":"","sources":["../../../src/integration-engine/datasources/AbstractOpendataDatasource.ts"],"names":[],"mappings":";;;;;;AAAA,mFAAqG;AACrG,6IAA0I;AAC1I,mFAAkF;AAClF,yHAA6E;AAY7E,MAAM,gBAAgB,GAA4C,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAEzH,MAAsB,0BAA0B;IAAhD;QAGqB,sBAAiB,GAAG,IAAI,uCAAmB,CACxD,2BAA2B,EAC3B,gCAAsB,CAAC,iBAAiB,EAAE,CAC7C,CAAC;QACe,oBAAe,GAAG,IAAI,uCAAmB,CAAC,yBAAyB,EAAE,gCAAsB,CAAC,GAAG,EAAE,CAAC,CAAC;IAwCxH,CAAC;IApCU,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,OAAa,IAAI,IAAI,EAAE;QACrD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACvF,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,OAAO,CAAC;IACnB,CAAC;IAEO,aAAa,CAAC,GAAW;QAC7B,OAAO,IAAI,wBAAU,CACjB,wBAAwB,EACxB,IAAI,qDAAyB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,EAC3E,IAAI,kCAAoB,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,EACtD,IAAI,CAAC,iBAAiB,CACzB,CAAC;IACN,CAAC;IAEO,WAAW,CAAC,MAAc;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAC1E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,gCAAgC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEO,YAAY,CAAC,MAAmB,EAAE,QAAgC;QACtE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxB,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAW;YAC3C,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAW;YAC3C,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAW;YACjC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAgB;YACxC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAW;YACrC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAW;SAC9C,CAAC,CAAC,CAAC;IACR,CAAC;CACJ;AA/CD,gEA+CC"}

package/dist/integration-engine/datasources/OpendataDatasource.d.ts

@@ -1,30 +1,8 @@
 import { ISimpleConfig } from "@golemio/core/dist/helpers/configuration/ISimpleConfig";
-/** Raw record shape as returned by the ČHMÚ opendata API after unpacking values rows. */
-interface IRawOpendataRecord {
-    STATION: string;
-    ELEMENT: string;
-    DT: string;
-    VAL: number | "";
-    FLAG: string;
-    QUALITY: number;
-}
-export default class OpendataDatasource {
+import { AbstractOpendataDatasource } from "./AbstractOpendataDatasource";
+export default class OpendataDatasource extends AbstractOpendataDatasource {
     name: string;
-    private readonly responseValidator;
-    private readonly recordValidator;
     private readonly baseUrl;
     constructor(config: ISimpleConfig);
-    /**
-     * Fetches the 10-minute JSON file for one station from ČHMÚ opendata.
-     * Returns unpacked records with named fields (STATION = WSI).
-     *
-     * @param wsi    Station WSI identifier (e.g. "0-20000-0-11520")
-     * @param date   Date for which to fetch data (defaults to today)
-     */
-    getData(wsi: string, date?: Date): Promise<IRawOpendataRecord[]>;
-    private getDatasource;
-    private parseHeader;
-    private mapToRecords;
-    private buildUrl;
+    protected buildUrl(wsi: string, date: Date): string;
 }
-export {};

package/dist/integration-engine/datasources/OpendataDatasource.js

@@ -11,60 +11,17 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 const CoreToken_1 = require("@golemio/core/dist/helpers/ioc/CoreToken");
-const datasources_1 = require("@golemio/core/dist/integration-engine/datasources");
-const HTTPFetchProtocolStrategy_1 = require("@golemio/core/dist/integration-engine/datasources/protocol-strategy/HTTPFetchProtocolStrategy");
 const luxon_1 = require("@golemio/core/dist/shared/luxon");
-const golemio_validator_1 = require("@golemio/core/dist/shared/golemio-validator");
 const tsyringe_1 = require("@golemio/core/dist/shared/tsyringe");
-const OpendataSchemaProvider_1 = __importDefault(require("../../schema-definitions/datasources/OpendataSchemaProvider"));
-const REQUIRED_COLUMNS = ["STATION", "ELEMENT", "DT", "VAL", "FLAG", "QUALITY"];
-let OpendataDatasource = class OpendataDatasource {
+const AbstractOpendataDatasource_1 = require("./AbstractOpendataDatasource");
+let OpendataDatasource = class OpendataDatasource extends AbstractOpendataDatasource_1.AbstractOpendataDatasource {
     constructor(config) {
+        super();
         this.name = "OpendataDatasource";
-        this.responseValidator = new golemio_validator_1.JSONSchemaValidator("OpendataResponseValidator", OpendataSchemaProvider_1.default.getResponseSchema());
-        this.recordValidator = new golemio_validator_1.JSONSchemaValidator("OpendataRecordValidator", OpendataSchemaProvider_1.default.get());
         this.baseUrl = config.getValue("module.chmu.opendata.baseUrl");
     }
-    /**
-     * Fetches the 10-minute JSON file for one station from ČHMÚ opendata.
-     * Returns unpacked records with named fields (STATION = WSI).
-     *
-     * @param wsi    Station WSI identifier (e.g. "0-20000-0-11520")
-     * @param date   Date for which to fetch data (defaults to today)
-     */
-    async getData(wsi, date = new Date()) {
-        const { header, values } = await this.getDatasource(this.buildUrl(wsi, date)).getAll();
-        const colIndex = this.parseHeader(header);
-        const records = this.mapToRecords(values, colIndex);
-        await this.recordValidator.Validate(records);
-        return records;
-    }
-    getDatasource(url) {
-        return new datasources_1.DataSource("OpendataHttpDataSource", new HTTPFetchProtocolStrategy_1.HTTPFetchProtocolStrategy({ url, method: "GET", responseType: "json" }), new datasources_1.JSONDataTypeStrategy({ resultsPath: "data.data" }), this.responseValidator);
-    }
-    parseHeader(header) {
-        const colIndex = Object.fromEntries(header.split(",").map((c, i) => [c, i]));
-        const missing = REQUIRED_COLUMNS.filter((c) => colIndex[c] === undefined);
-        if (missing.length > 0) {
-            throw new Error(`OpendataDatasource: missing columns in header: ${missing.join(", ")}`);
-        }
-        return colIndex;
-    }
-    mapToRecords(values, colIndex) {
-        return values.map((row) => ({
-            STATION: row[colIndex["STATION"]],
-            ELEMENT: row[colIndex["ELEMENT"]],
-            DT: row[colIndex["DT"]],
-            VAL: row[colIndex["VAL"]],
-            FLAG: row[colIndex["FLAG"]],
-            QUALITY: row[colIndex["QUALITY"]],
-        }));
-    }
     buildUrl(wsi, date) {
         const dt = luxon_1.DateTime.fromJSDate(date).setZone("Europe/Prague");
         const yyyymmdd = dt.toFormat("yyyyMMdd");

package/dist/integration-engine/datasources/OpendataDatasource.js.map

@@ -1 +1 @@
-{"version":3,"file":"OpendataDatasource.js","sourceRoot":"","sources":["../../../src/integration-engine/datasources/OpendataDatasource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"OpendataDatasource.js","sourceRoot":"","sources":["../../../src/integration-engine/datasources/OpendataDatasource.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AACA,wEAAqE;AACrE,2DAA2D;AAC3D,iEAAwE;AACxE,6EAA0E;AAG3D,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,uDAA0B;IAKtE,YAA4C,MAAqB;QAC7D,KAAK,EAAE,CAAC;QALL,SAAI,GAAG,oBAAoB,CAAC;QAM/B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;IACnE,CAAC;IAES,QAAQ,CAAC,GAAW,EAAE,IAAU;QACtC,MAAM,EAAE,GAAG,gBAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACzC,OAAO,GAAG,IAAI,CAAC,OAAO,QAAQ,GAAG,IAAI,QAAQ,OAAO,CAAC;IACzD,CAAC;CACJ,CAAA;AAfoB,kBAAkB;IADtC,IAAA,qBAAU,GAAE;IAMI,WAAA,IAAA,iBAAM,EAAC,qBAAS,CAAC,YAAY,CAAC,CAAA;;GAL1B,kBAAkB,CAetC;kBAfoB,kBAAkB"}

package/dist/integration-engine/datasources/OpendataHistoricalDatasource.d.ts

@@ -0,0 +1,8 @@
+import { ISimpleConfig } from "@golemio/core/dist/helpers/configuration/ISimpleConfig";
+import { AbstractOpendataDatasource } from "./AbstractOpendataDatasource";
+export default class OpendataHistoricalDatasource extends AbstractOpendataDatasource {
+    name: string;
+    private readonly baseUrl;
+    constructor(config: ISimpleConfig);
+    protected buildUrl(wsi: string, date: Date): string;
+}

package/dist/integration-engine/datasources/OpendataHistoricalDatasource.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const CoreToken_1 = require("@golemio/core/dist/helpers/ioc/CoreToken");
+const luxon_1 = require("@golemio/core/dist/shared/luxon");
+const tsyringe_1 = require("@golemio/core/dist/shared/tsyringe");
+const AbstractOpendataDatasource_1 = require("./AbstractOpendataDatasource");
+let OpendataHistoricalDatasource = class OpendataHistoricalDatasource extends AbstractOpendataDatasource_1.AbstractOpendataDatasource {
+    constructor(config) {
+        super();
+        this.name = "OpendataHistoricalDatasource";
+        this.baseUrl = config.getValue("module.chmu.opendata.historicalBaseUrl");
+    }
+    buildUrl(wsi, date) {
+        const dt = luxon_1.DateTime.fromJSDate(date, { zone: "utc" });
+        const year = dt.toFormat("yyyy");
+        const yearMonth = dt.toFormat("yyyyMM");
+        return `${this.baseUrl}/${year}/10m-${wsi}-${yearMonth}.json`;
+    }
+};
+OpendataHistoricalDatasource = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(CoreToken_1.CoreToken.SimpleConfig)),
+    __metadata("design:paramtypes", [Object])
+], OpendataHistoricalDatasource);
+exports.default = OpendataHistoricalDatasource;
+//# sourceMappingURL=OpendataHistoricalDatasource.js.map

package/dist/integration-engine/datasources/OpendataHistoricalDatasource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpendataHistoricalDatasource.js","sourceRoot":"","sources":["../../../src/integration-engine/datasources/OpendataHistoricalDatasource.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AACA,wEAAqE;AACrE,2DAA2D;AAC3D,iEAAwE;AACxE,6EAA0E;AAG3D,IAAM,4BAA4B,GAAlC,MAAM,4BAA6B,SAAQ,uDAA0B;IAKhF,YAA4C,MAAqB;QAC7D,KAAK,EAAE,CAAC;QALL,SAAI,GAAG,8BAA8B,CAAC;QAMzC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC;IAC7E,CAAC;IAES,QAAQ,CAAC,GAAW,EAAE,IAAU;QACtC,MAAM,EAAE,GAAG,gBAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,QAAQ,GAAG,IAAI,SAAS,OAAO,CAAC;IAClE,CAAC;CACJ,CAAA;AAhBoB,4BAA4B;IADhD,IAAA,qBAAU,GAAE;IAMI,WAAA,IAAA,iBAAM,EAAC,qBAAS,CAAC,YAAY,CAAC,CAAA;;GAL1B,4BAA4B,CAgBhD;kBAhBoB,4BAA4B"}

package/dist/integration-engine/ioc/Di.js

@@ -9,10 +9,12 @@ const StationsRepository_1 = require("../data-access/StationsRepository");
 const Di_1 = require("@golemio/core/dist/integration-engine/ioc/Di");
 const ChmuDatasource_1 = __importDefault(require("../datasources/ChmuDatasource"));
 const OpendataDatasource_1 = __importDefault(require("../datasources/OpendataDatasource"));
+const OpendataHistoricalDatasource_1 = __importDefault(require("../datasources/OpendataHistoricalDatasource"));
 const MeasurementsTransformation_1 = require("../transformations/MeasurementsTransformation");
 const OpendataMeasurementsTransformation_1 = require("../transformations/OpendataMeasurementsTransformation");
 const DownloadMeasurementsTask_1 = __importDefault(require("../workers/tasks/DownloadMeasurementsTask"));
 const DownloadOpendataMeasurementsTask_1 = __importDefault(require("../workers/tasks/DownloadOpendataMeasurementsTask"));
+const DownloadOpendataHistoricalMeasurementsTask_1 = __importDefault(require("../workers/tasks/DownloadOpendataHistoricalMeasurementsTask"));
 const ModuleContainerToken_1 = require("./ModuleContainerToken");
 //#region Initialization
 const ChmuContainer = Di_1.IntegrationEngineContainer.createChildContainer();
@@ -21,6 +23,7 @@ exports.ChmuContainer = ChmuContainer;
 //#region Datasources
 ChmuContainer.registerSingleton(ModuleContainerToken_1.ModuleContainerToken.ChmuDatasource, ChmuDatasource_1.default);
 ChmuContainer.registerSingleton(ModuleContainerToken_1.ModuleContainerToken.OpendataDatasource, OpendataDatasource_1.default);
+ChmuContainer.registerSingleton(ModuleContainerToken_1.ModuleContainerToken.OpendataHistoricalDatasource, OpendataHistoricalDatasource_1.default);
 //#endregion
 //#region Transformations
 ChmuContainer.registerSingleton(ModuleContainerToken_1.ModuleContainerToken.MeasurementsTransformation, MeasurementsTransformation_1.MeasurementsTransformation);
@@ -33,4 +36,5 @@ ChmuContainer.registerSingleton(ModuleContainerToken_1.ModuleContainerToken.Stat
 //#region WorkerTasks
 ChmuContainer.registerSingleton(ModuleContainerToken_1.ModuleContainerToken.DownloadMeasurementsTask, DownloadMeasurementsTask_1.default);
 ChmuContainer.registerSingleton(ModuleContainerToken_1.ModuleContainerToken.DownloadOpendataMeasurementsTask, DownloadOpendataMeasurementsTask_1.default);
+ChmuContainer.registerSingleton(ModuleContainerToken_1.ModuleContainerToken.DownloadOpendataHistoricalMeasurementsTask, DownloadOpendataHistoricalMeasurementsTask_1.default);
 //# sourceMappingURL=Di.js.map

package/dist/integration-engine/ioc/Di.js.map

@@ -1 +1 @@
-{"version":3,"file":"Di.js","sourceRoot":"","sources":["../../../src/integration-engine/ioc/Di.ts"],"names":[],"mappings":";;;;;;AAAA,kFAAgF;AAChF,0EAAwE;AACxE,qEAA0F;AAC1F,mFAA4D;AAC5D,2FAAoE;AACpE,8FAA4F;AAC5F,8GAA4G;AAC5G,yGAAkF;AAClF,yHAAkG;AAElG,iEAA8D;AAE9D,wBAAwB;AACxB,MAAM,aAAa,GAAwB,+BAA0B,CAAC,oBAAoB,EAAE,CAAC;AAuBpF,sCAAa;AAtBtB,YAAY;AAEZ,qBAAqB;AACrB,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,cAAc,EAAE,wBAAc,CAAC,CAAC;AACrF,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,kBAAkB,EAAE,4BAAkB,CAAC,CAAC;AAC7F,YAAY;AAEZ,yBAAyB;AACzB,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,0BAA0B,EAAE,uDAA0B,CAAC,CAAC;AAC7G,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,kCAAkC,EAAE,uEAAkC,CAAC,CAAC;AAC7H,YAAY;AAEZ,sBAAsB;AACtB,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,sBAAsB,EAAE,+CAAsB,CAAC,CAAC;AACrG,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,kBAAkB,EAAE,uCAAkB,CAAC,CAAC;AAC7F,YAAY;AAEZ,qBAAqB;AACrB,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,wBAAwB,EAAE,kCAAwB,CAAC,CAAC;AACzG,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,gCAAgC,EAAE,0CAAgC,CAAC,CAAC"}
+{"version":3,"file":"Di.js","sourceRoot":"","sources":["../../../src/integration-engine/ioc/Di.ts"],"names":[],"mappings":";;;;;;AAAA,kFAAgF;AAChF,0EAAwE;AACxE,qEAA0F;AAC1F,mFAA4D;AAC5D,2FAAoE;AACpE,+GAAwF;AACxF,8FAA4F;AAC5F,8GAA4G;AAC5G,yGAAkF;AAClF,yHAAkG;AAClG,6IAAsH;AAEtH,iEAA8D;AAE9D,wBAAwB;AACxB,MAAM,aAAa,GAAwB,+BAA0B,CAAC,oBAAoB,EAAE,CAAC;AA4BpF,sCAAa;AA3BtB,YAAY;AAEZ,qBAAqB;AACrB,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,cAAc,EAAE,wBAAc,CAAC,CAAC;AACrF,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,kBAAkB,EAAE,4BAAkB,CAAC,CAAC;AAC7F,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,4BAA4B,EAAE,sCAA4B,CAAC,CAAC;AACjH,YAAY;AAEZ,yBAAyB;AACzB,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,0BAA0B,EAAE,uDAA0B,CAAC,CAAC;AAC7G,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,kCAAkC,EAAE,uEAAkC,CAAC,CAAC;AAC7H,YAAY;AAEZ,sBAAsB;AACtB,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,sBAAsB,EAAE,+CAAsB,CAAC,CAAC;AACrG,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,kBAAkB,EAAE,uCAAkB,CAAC,CAAC;AAC7F,YAAY;AAEZ,qBAAqB;AACrB,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,wBAAwB,EAAE,kCAAwB,CAAC,CAAC;AACzG,aAAa,CAAC,iBAAiB,CAAC,2CAAoB,CAAC,gCAAgC,EAAE,0CAAgC,CAAC,CAAC;AACzH,aAAa,CAAC,iBAAiB,CAC3B,2CAAoB,CAAC,0CAA0C,EAC/D,oDAA0C,CAC7C,CAAC"}

package/dist/integration-engine/ioc/ModuleContainerToken.d.ts

@@ -7,5 +7,7 @@ declare const ModuleContainerToken: {
     OpendataDatasource: symbol;
     OpendataMeasurementsTransformation: symbol;
     DownloadOpendataMeasurementsTask: symbol;
+    OpendataHistoricalDatasource: symbol;
+    DownloadOpendataHistoricalMeasurementsTask: symbol;
 };
 export { ModuleContainerToken };

package/dist/integration-engine/ioc/ModuleContainerToken.js

@@ -11,6 +11,9 @@ const ModuleContainerToken = {
     OpendataDatasource: Symbol(),
     OpendataMeasurementsTransformation: Symbol(),
     DownloadOpendataMeasurementsTask: Symbol(),
+    // opendata historical
+    OpendataHistoricalDatasource: Symbol(),
+    DownloadOpendataHistoricalMeasurementsTask: Symbol(),
 };
 exports.ModuleContainerToken = ModuleContainerToken;
 //# sourceMappingURL=ModuleContainerToken.js.map

package/dist/integration-engine/ioc/ModuleContainerToken.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModuleContainerToken.js","sourceRoot":"","sources":["../../../src/integration-engine/ioc/ModuleContainerToken.ts"],"names":[],"mappings":";;;AAAA,MAAM,oBAAoB,GAAG;IACzB,cAAc,EAAE,MAAM,EAAE;IACxB,sBAAsB,EAAE,MAAM,EAAE;IAChC,0BAA0B,EAAE,MAAM,EAAE;IACpC,wBAAwB,EAAE,MAAM,EAAE;IAClC,oBAAoB;IACpB,kBAAkB,EAAE,MAAM,EAAE;IAC5B,kBAAkB,EAAE,MAAM,EAAE;IAC5B,kCAAkC,EAAE,MAAM,EAAE;IAC5C,gCAAgC,EAAE,MAAM,EAAE;CAC7C,CAAC;AAEO,oDAAoB"}
+{"version":3,"file":"ModuleContainerToken.js","sourceRoot":"","sources":["../../../src/integration-engine/ioc/ModuleContainerToken.ts"],"names":[],"mappings":";;;AAAA,MAAM,oBAAoB,GAAG;IACzB,cAAc,EAAE,MAAM,EAAE;IACxB,sBAAsB,EAAE,MAAM,EAAE;IAChC,0BAA0B,EAAE,MAAM,EAAE;IACpC,wBAAwB,EAAE,MAAM,EAAE;IAClC,oBAAoB;IACpB,kBAAkB,EAAE,MAAM,EAAE;IAC5B,kBAAkB,EAAE,MAAM,EAAE;IAC5B,kCAAkC,EAAE,MAAM,EAAE;IAC5C,gCAAgC,EAAE,MAAM,EAAE;IAC1C,sBAAsB;IACtB,4BAA4B,EAAE,MAAM,EAAE;IACtC,0CAA0C,EAAE,MAAM,EAAE;CACvD,CAAC;AAEO,oDAAoB"}

package/dist/integration-engine/workers/ChmuWorker.js

@@ -16,6 +16,7 @@ class ChmuWorker extends workers_1.AbstractWorker {
         // Register tasks
         this.registerTask(Di_1.ChmuContainer.resolve(ModuleContainerToken_1.ModuleContainerToken.DownloadMeasurementsTask));
         this.registerTask(Di_1.ChmuContainer.resolve(ModuleContainerToken_1.ModuleContainerToken.DownloadOpendataMeasurementsTask));
+        this.registerTask(Di_1.ChmuContainer.resolve(ModuleContainerToken_1.ModuleContainerToken.DownloadOpendataHistoricalMeasurementsTask));
     }
 }
 exports.ChmuWorker = ChmuWorker;

package/dist/integration-engine/workers/ChmuWorker.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChmuWorker.js","sourceRoot":"","sources":["../../../src/integration-engine/workers/ChmuWorker.ts"],"names":[],"mappings":";;;AAAA,kCAA2C;AAC3C,sEAAoE;AACpE,2EAA6F;AAC7F,uCAAwC;AAIxC,MAAa,UAAW,SAAQ,wBAAc;IAG1C;QACI,KAAK,EAAE,CAAC;QAHF,SAAI,GAAG,mBAAW,CAAC;QAYtB,iBAAY,GAAG,CAAC,IAAuB,EAAQ,EAAE;YACpD,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC7C,CAAC,CAAC;QAVE,iBAAiB;QACjB,IAAI,CAAC,YAAY,CAAC,kBAAa,CAAC,OAAO,CAA2B,2CAAoB,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAClH,IAAI,CAAC,YAAY,CACb,kBAAa,CAAC,OAAO,CAAmC,2CAAoB,CAAC,gCAAgC,CAAC,CACjH,CAAC;IACN,CAAC;CAMJ;AAjBD,gCAiBC"}
+{"version":3,"file":"ChmuWorker.js","sourceRoot":"","sources":["../../../src/integration-engine/workers/ChmuWorker.ts"],"names":[],"mappings":";;;AAAA,kCAA2C;AAC3C,sEAAoE;AACpE,2EAA6F;AAC7F,uCAAwC;AAKxC,MAAa,UAAW,SAAQ,wBAAc;IAG1C;QACI,KAAK,EAAE,CAAC;QAHF,SAAI,GAAG,mBAAW,CAAC;QAiBtB,iBAAY,GAAG,CAAC,IAAuB,EAAQ,EAAE;YACpD,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC7C,CAAC,CAAC;QAfE,iBAAiB;QACjB,IAAI,CAAC,YAAY,CAAC,kBAAa,CAAC,OAAO,CAA2B,2CAAoB,CAAC,wBAAwB,CAAC,CAAC,CAAC;QAClH,IAAI,CAAC,YAAY,CACb,kBAAa,CAAC,OAAO,CAAmC,2CAAoB,CAAC,gCAAgC,CAAC,CACjH,CAAC;QACF,IAAI,CAAC,YAAY,CACb,kBAAa,CAAC,OAAO,CACjB,2CAAoB,CAAC,0CAA0C,CAClE,CACJ,CAAC;IACN,CAAC;CAMJ;AAtBD,gCAsBC"}

package/dist/integration-engine/workers/interfaces/IDownloadOpendataHistoricalMessage.d.ts

@@ -0,0 +1,10 @@
+export default interface IDownloadOpendataHistoricalMessage {
+    /** ISO 8601 timestamp - inclusive start of the range to download. Required; no default. */
+    from: string;
+    /** ISO 8601 timestamp - exclusive end of the range to download. Required; no default. */
+    to: string;
+    /** Station ID from chmu.stations. When set together with wsi, task runs in single-station mode. */
+    station_id?: string;
+    /** WSI identifier of the station. When set together with station_id, task runs in single-station mode. */
+    wsi?: string;
+}

package/dist/integration-engine/workers/interfaces/IDownloadOpendataHistoricalMessage.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IDownloadOpendataHistoricalMessage.js.map

package/dist/integration-engine/workers/interfaces/IDownloadOpendataHistoricalMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDownloadOpendataHistoricalMessage.js","sourceRoot":"","sources":["../../../../src/integration-engine/workers/interfaces/IDownloadOpendataHistoricalMessage.ts"],"names":[],"mappings":""}

package/dist/integration-engine/workers/tasks/DownloadOpendataHistoricalMeasurementsTask.d.ts

@@ -0,0 +1,26 @@
+import { StationsRepository } from "../../data-access/StationsRepository";
+import { MeasurementsRepository } from "../../data-access/MeasurementsRepository";
+import OpendataHistoricalDatasource from "../../datasources/OpendataHistoricalDatasource";
+import { OpendataMeasurementsTransformation } from "../../transformations/OpendataMeasurementsTransformation";
+import { ILogger } from "@golemio/core/dist/helpers/logger/LoggerProvider";
+import { AbstractTask } from "@golemio/core/dist/integration-engine";
+import IDownloadOpendataHistoricalMessage from "../interfaces/IDownloadOpendataHistoricalMessage";
+import { DownloadOpendataHistoricalMessageSchema } from "./DownloadOpendataHistoricalMessageSchema";
+export default class DownloadOpendataHistoricalMeasurementsTask extends AbstractTask<IDownloadOpendataHistoricalMessage> {
+    private stationsRepository;
+    private datasource;
+    private transformation;
+    private repository;
+    private logger;
+    queueName: string;
+    protected schema: typeof DownloadOpendataHistoricalMessageSchema;
+    constructor(stationsRepository: StationsRepository, datasource: OpendataHistoricalDatasource, transformation: OpendataMeasurementsTransformation, repository: MeasurementsRepository, logger: ILogger);
+    protected execute: (data: IDownloadOpendataHistoricalMessage) => Promise<void>;
+    private generateSubtasks;
+    private processStation;
+    private generateStationMonthSubtasks;
+    private processStationMeasurements;
+    private validateRange;
+    /** Splits [from, to) into calendar-month intervals (UTC, matching DT's format); clips the first/last interval. */
+    private static generateMonthIntervals;
+}

package/dist/integration-engine/workers/tasks/DownloadOpendataHistoricalMeasurementsTask.js

@@ -0,0 +1,149 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var DownloadOpendataHistoricalMeasurementsTask_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+const StationsRepository_1 = require("../../data-access/StationsRepository");
+const MeasurementsRepository_1 = require("../../data-access/MeasurementsRepository");
+const OpendataHistoricalDatasource_1 = __importDefault(require("../../datasources/OpendataHistoricalDatasource"));
+const ModuleContainerToken_1 = require("../../ioc/ModuleContainerToken");
+const OpendataMeasurementsTransformation_1 = require("../../transformations/OpendataMeasurementsTransformation");
+const integration_engine_1 = require("@golemio/core/dist/integration-engine");
+const QueueManager_1 = require("@golemio/core/dist/integration-engine/queueprocessors/QueueManager");
+const golemio_errors_1 = require("@golemio/core/dist/shared/golemio-errors");
+const luxon_1 = require("@golemio/core/dist/shared/luxon");
+const tsyringe_1 = require("@golemio/core/dist/shared/tsyringe");
+const DownloadOpendataHistoricalMessageSchema_1 = require("./DownloadOpendataHistoricalMessageSchema");
+const CoreToken_1 = require("@golemio/core/dist/helpers/ioc/CoreToken");
+let DownloadOpendataHistoricalMeasurementsTask = DownloadOpendataHistoricalMeasurementsTask_1 = class DownloadOpendataHistoricalMeasurementsTask extends integration_engine_1.AbstractTask {
+    constructor(stationsRepository, datasource, transformation, repository, logger) {
+        super(""); // queue prefix is set by the worker
+        this.stationsRepository = stationsRepository;
+        this.datasource = datasource;
+        this.transformation = transformation;
+        this.repository = repository;
+        this.logger = logger;
+        this.queueName = "downloadOpendataHistoricalMeasurementsTask";
+        this.schema = DownloadOpendataHistoricalMessageSchema_1.DownloadOpendataHistoricalMessageSchema;
+        this.execute = async (data) => {
+            const { from, to } = this.validateRange(data);
+            try {
+                if (data.station_id && data.wsi) {
+                    await this.processStation(data.station_id, data.wsi, from, to);
+                }
+                else {
+                    await this.generateSubtasks(from, to);
+                }
+            }
+            catch (error) {
+                if (error instanceof golemio_errors_1.AbstractGolemioError) {
+                    throw error;
+                }
+                throw new golemio_errors_1.GeneralError(`Unable to download chmu opendata historical measurements data.`, this.constructor.name, error);
+            }
+        };
+    }
+    async generateSubtasks(from, to) {
+        const stations = await this.stationsRepository.getStationsWithWsi();
+        if (stations.length === 0) {
+            this.logger.warn(`${this.constructor.name}: no stations with WSI found - skipping. Populate chmu.stations.wsi first.`);
+            return;
+        }
+        for (const station of stations) {
+            await this.generateStationMonthSubtasks(station.station_id, station.wsi, from, to);
+        }
+    }
+    async processStation(stationId, wsi, from, to) {
+        const intervals = DownloadOpendataHistoricalMeasurementsTask_1.generateMonthIntervals(from, to);
+        if (intervals.length === 1) {
+            await this.processStationMeasurements(stationId, wsi, intervals[0]);
+        }
+        else {
+            await this.generateStationMonthSubtasks(stationId, wsi, from, to);
+        }
+    }
+    async generateStationMonthSubtasks(stationId, wsi, from, to) {
+        const intervals = DownloadOpendataHistoricalMeasurementsTask_1.generateMonthIntervals(from, to);
+        for (const interval of intervals) {
+            await QueueManager_1.QueueManager.sendMessageToExchange(this.queuePrefix, this.queueName, {
+                station_id: stationId,
+                wsi,
+                from: interval.from.toISO(),
+                to: interval.to.toISO(),
+            });
+        }
+        this.logger.debug(`${this.constructor.name}: dispatched ${intervals.length} month subtasks for station ${stationId}.`);
+    }
+    async processStationMeasurements(stationId, wsi, interval) {
+        const rangeLabel = `${interval.from.toISO()} - ${interval.to.toISO()}`;
+        let stationRecords;
+        try {
+            stationRecords = await this.datasource.getData(wsi, interval.from.toJSDate());
+        }
+        catch (error) {
+            throw new golemio_errors_1.GeneralError(`${this.constructor.name}: failed to fetch data for station ${stationId} (WSI: ${wsi}, range ${rangeLabel}).`);
+        }
+        if (stationRecords.length === 0) {
+            this.logger.warn(`${this.constructor.name}: no records fetched for station ${stationId} (WSI: ${wsi}), range ${rangeLabel}.`);
+            return;
+        }
+        const withinRange = stationRecords.filter((r) => {
+            const dt = luxon_1.DateTime.fromISO(r.DT, { zone: "utc" });
+            return dt >= interval.from && dt < interval.to;
+        });
+        if (withinRange.length === 0) {
+            this.logger.warn(`${this.constructor.name}: all records for station ${stationId} fall outside the requested range ${rangeLabel}.`);
+            return;
+        }
+        const records = withinRange.map((r) => ({ ...r, station_id: stationId }));
+        const transformed = await this.transformation.transform(records);
+        await this.repository.bulkUpdate(transformed);
+        this.logger.debug(`${this.constructor.name}: upserted ${transformed.length} measurements for station ${stationId}, range ${rangeLabel}.`);
+    }
+    validateRange(data) {
+        const from = luxon_1.DateTime.fromISO(data.from, { zone: "utc" });
+        const to = luxon_1.DateTime.fromISO(data.to, { zone: "utc" });
+        if (to <= from) {
+            throw new golemio_errors_1.GeneralError(`"to" (${data.to}) must be after "from" (${data.from}).`, this.constructor.name);
+        }
+        return { from, to };
+    }
+    /** Splits [from, to) into calendar-month intervals (UTC, matching DT's format); clips the first/last interval. */
+    static generateMonthIntervals(from, to) {
+        const intervals = [];
+        let cursor = from;
+        while (cursor < to) {
+            const nextMonth = cursor.startOf("month").plus({ months: 1 });
+            intervals.push({ from: cursor, to: luxon_1.DateTime.min(nextMonth, to) });
+            cursor = nextMonth;
+        }
+        return intervals;
+    }
+};
+DownloadOpendataHistoricalMeasurementsTask = DownloadOpendataHistoricalMeasurementsTask_1 = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(ModuleContainerToken_1.ModuleContainerToken.StationsRepository)),
+    __param(1, (0, tsyringe_1.inject)(ModuleContainerToken_1.ModuleContainerToken.OpendataHistoricalDatasource)),
+    __param(2, (0, tsyringe_1.inject)(ModuleContainerToken_1.ModuleContainerToken.OpendataMeasurementsTransformation)),
+    __param(3, (0, tsyringe_1.inject)(ModuleContainerToken_1.ModuleContainerToken.MeasurementsRepository)),
+    __param(4, (0, tsyringe_1.inject)(CoreToken_1.CoreToken.Logger)),
+    __metadata("design:paramtypes", [StationsRepository_1.StationsRepository,
+        OpendataHistoricalDatasource_1.default,
+        OpendataMeasurementsTransformation_1.OpendataMeasurementsTransformation,
+        MeasurementsRepository_1.MeasurementsRepository, Object])
+], DownloadOpendataHistoricalMeasurementsTask);
+exports.default = DownloadOpendataHistoricalMeasurementsTask;
+//# sourceMappingURL=DownloadOpendataHistoricalMeasurementsTask.js.map

package/dist/integration-engine/workers/tasks/DownloadOpendataHistoricalMeasurementsTask.js.map

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

package/dist/integration-engine/workers/tasks/DownloadOpendataHistoricalMessageSchema.d.ts

@@ -0,0 +1,7 @@
+import IDownloadOpendataHistoricalMessage from "../interfaces/IDownloadOpendataHistoricalMessage";
+export declare class DownloadOpendataHistoricalMessageSchema implements IDownloadOpendataHistoricalMessage {
+    from: string;
+    to: string;
+    station_id?: string;
+    wsi?: string;
+}

package/dist/integration-engine/workers/tasks/DownloadOpendataHistoricalMessageSchema.js

@@ -0,0 +1,40 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DownloadOpendataHistoricalMessageSchema = void 0;
+const class_validator_1 = require("@golemio/core/dist/shared/class-validator");
+const ISO8601_WITH_TIMEZONE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+class DownloadOpendataHistoricalMessageSchema {
+}
+exports.DownloadOpendataHistoricalMessageSchema = DownloadOpendataHistoricalMessageSchema;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)({ strict: true }),
+    (0, class_validator_1.Matches)(ISO8601_WITH_TIMEZONE, { message: "from must be a full ISO 8601 timestamp with a timezone (e.g. Z or +01:00)" }),
+    __metadata("design:type", String)
+], DownloadOpendataHistoricalMessageSchema.prototype, "from", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsISO8601)({ strict: true }),
+    (0, class_validator_1.Matches)(ISO8601_WITH_TIMEZONE, { message: "to must be a full ISO 8601 timestamp with a timezone (e.g. Z or +01:00)" }),
+    __metadata("design:type", String)
+], DownloadOpendataHistoricalMessageSchema.prototype, "to", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], DownloadOpendataHistoricalMessageSchema.prototype, "station_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], DownloadOpendataHistoricalMessageSchema.prototype, "wsi", void 0);
+//# sourceMappingURL=DownloadOpendataHistoricalMessageSchema.js.map

package/dist/integration-engine/workers/tasks/DownloadOpendataHistoricalMessageSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DownloadOpendataHistoricalMessageSchema.js","sourceRoot":"","sources":["../../../../src/integration-engine/workers/tasks/DownloadOpendataHistoricalMessageSchema.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+EAAqG;AAGrG,MAAM,qBAAqB,GAAG,kEAAkE,CAAC;AAEjG,MAAa,uCAAuC;CAkBnD;AAlBD,0FAkBC;AAdG;IAHC,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3B,IAAA,yBAAO,EAAC,qBAAqB,EAAE,EAAE,OAAO,EAAE,2EAA2E,EAAE,CAAC;;qEAC3G;AAKd;IAHC,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3B,IAAA,yBAAO,EAAC,qBAAqB,EAAE,EAAE,OAAO,EAAE,yEAAyE,EAAE,CAAC;;mEAC3G;AAIZ;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;2EACS;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;oEACE"}

package/dist/integration-engine/workers/tasks/DownloadOpendataMeasurementsTask.d.ts

@@ -18,5 +18,5 @@ export default class DownloadOpendataMeasurementsTask extends AbstractTask<IDown
     protected execute: (data: IDownloadOpendataMessage) => Promise<void>;
     private generateSubtasks;
     private processStationMeasurements;
-    private validateMessageData;
+    private validateDate;
 }

package/dist/integration-engine/workers/tasks/DownloadOpendataMeasurementsTask.js

@@ -38,7 +38,7 @@ let DownloadOpendataMeasurementsTask = class DownloadOpendataMeasurementsTask ex
         this.queueName = "downloadOpendataMeasurementsTask";
         this.schema = DownloadOpendataMessageSchema_1.DownloadOpendataMessageSchema;
         this.execute = async (data) => {
-            const { date } = this.validateMessageData(data);
+            const { date } = this.validateDate(data);
             try {
                 if (data.wsi && data.station_id) {
                     await this.processStationMeasurements(data.station_id, data.wsi, new Date(date));
@@ -51,7 +51,7 @@ let DownloadOpendataMeasurementsTask = class DownloadOpendataMeasurementsTask ex
                 if (error instanceof golemio_errors_1.AbstractGolemioError) {
                     throw error;
                 }
-                this.logger.error(error, `${this.constructor.name}: Unable to download chmu opendata measurements data.`);
+                throw new golemio_errors_1.GeneralError(`Unable to download chmu opendata measurements data.`, this.constructor.name, error);
             }
         };
     }
@@ -87,13 +87,13 @@ let DownloadOpendataMeasurementsTask = class DownloadOpendataMeasurementsTask ex
         await this.repository.bulkUpdate(transformed);
         this.logger.debug(`${this.constructor.name}: upserted ${transformed.length} measurements for station ${stationId}.`);
     }
-    validateMessageData(data) {
+    validateDate(data) {
         const dt = data.date ? luxon_1.DateTime.fromISO(data.date) : luxon_1.DateTime.now();
         const ageInDays = luxon_1.DateTime.now().startOf("day").diff(dt.startOf("day"), "days").days;
         if (ageInDays > 2) {
-            throw new Error(`Date "${data.date}" is outside the 3-day retention window`);
+            throw new golemio_errors_1.GeneralError(`Date "${data.date}" is outside the 3-day retention window`, this.constructor.name);
         }
-        return { ...data, date: dt.toISODate() };
+        return { date: dt.toISODate() };
     }
 };
 DownloadOpendataMeasurementsTask = __decorate([

package/dist/integration-engine/workers/tasks/DownloadOpendataMeasurementsTask.js.map

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

package/docs/asyncapi.yaml

@@ -17,7 +17,7 @@ channels:
                 $ref: "#/components/messages/chmu.DownloadMeasurementsMessage"
     chmu.downloadOpendataMeasurementsTask:
         address: dataplatform.chmu.downloadOpendataMeasurementsTask
-        description: Downloads CHMU 10-minute data from opendata.chmi.cz for all stations with a WSI identifier.
+        description: Downloads CHMU 10-minute opendata for all stations with a WSI identifier.
         bindings:
             amqp:
                 is: queue
@@ -26,6 +26,17 @@ channels:
         messages:
             chmu.DownloadOpendataMessage:
                 $ref: "#/components/messages/chmu.DownloadOpendataMessage"
+    chmu.downloadOpendataHistoricalMeasurementsTask:
+        address: dataplatform.chmu.downloadOpendataHistoricalMeasurementsTask
+        description: Downloads historical 10-minute opendata for an arbitrary date range.
+        bindings:
+            amqp:
+                is: queue
+                queue:
+                    durable: true
+        messages:
+            chmu.DownloadOpendataHistoricalMessage:
+                $ref: "#/components/messages/chmu.DownloadOpendataHistoricalMessage"
 operations:
     chmu.downloadMeasurementsTask:
         action: "send"
@@ -35,6 +46,10 @@ operations:
         action: "send"
         channel:
             $ref: "#/channels/chmu.downloadOpendataMeasurementsTask"
+    chmu.downloadOpendataHistoricalMeasurementsTask:
+        action: "send"
+        channel:
+            $ref: "#/channels/chmu.downloadOpendataHistoricalMeasurementsTask"
 components:
     messages:
         chmu.DownloadMeasurementsMessage:
@@ -65,3 +80,31 @@ components:
                         nullable: true
                         description: ČHMÚ WSI station identifier.
                 additionalProperties: false
+        chmu.DownloadOpendataHistoricalMessage:
+            payload:
+                type: object
+                properties:
+                    "from":
+                        type: string
+                        format: date-time
+                        description: >
+                            ISO 8601 timestamp with an explicit timezone (Z or ±HH:MM) - inclusive start of the range
+                            to download. Required; no default.
+                    "to":
+                        type: string
+                        format: date-time
+                        description: >
+                            ISO 8601 timestamp with an explicit timezone (Z or ±HH:MM) - exclusive end of the range
+                            to download. Required; no default.
+                    "station_id":
+                        type: string
+                        nullable: true
+                        description: Station identifier. Together with wsi, runs in single-station mode.
+                    "wsi":
+                        type: string
+                        nullable: true
+                        description: ČHMÚ WSI station identifier. Together with station_id, runs in single-station mode.
+                required:
+                    - from
+                    - to
+                additionalProperties: false

package/docs/implementation_documentation.md

@@ -45,6 +45,19 @@ Data z obou zdrojů se ukládají do stejné tabulky `chmu.measurements` pomocí
 - poznámka
   - Zpracovány jsou pouze stanice s vyplněným sloupcem `wsi` v `chmu.stations`; ostatní jsou přeskočeny.
 
+#### *OpendataHistoricalDatasource* (jednorázový download historických dat)
+
+- zdroj dat
+  - ČHMÚ opendata - historický 10min JSON archiv
+  - URL: `https://opendata.chmi.cz/meteorology/climate/historical/data/10min/{rok}/10m-{WSI}-{YYYYMM}.json`
+  - jeden soubor = jedna stanice × jeden měsíc, všechny veličiny dané stanice (stejně jako živý soubor)
+- formát dat
+  - stejný jako *OpendataDatasource* výše
+- frekvence stahování
+  - jednorázový batch (ne cron)
+- název RabbitMQ fronty
+  - `chmu.downloadOpendataHistoricalMeasurementsTask`
+
 ## Zpracování dat / transformace
 
 ### *ChmuWorker*
@@ -101,6 +114,26 @@ Data z obou zdrojů se ukládají do stejné tabulky `chmu.measurements` pomocí
 - data modely
   - [MeasurementModel](https://gitlab.com/operator-ict/golemio/code/modules/chmu/-/blob/development/src/schema-definitions/definitions/models/MeasurementModel.ts)
 
+#### *DownloadOpendataHistoricalMeasurementsTask*
+
+- vstupní RabbitMQ fronta
+  - `chmu.downloadOpendataHistoricalMeasurementsTask`
+  - parametry `from` / `to` - povinné ISO 8601 timestampy s časovou zónou (`Z` nebo `±HH:MM`); volitelně `station_id` + `wsi` pro omezení na jednu stanici
+  - bez `station_id`/`wsi` rozešle subtasky pro všechny stanice; se `station_id`+`wsi` a rozsahem přes více měsíců rozešle subtasky po měsících; rozsah v rámci jednoho měsíce se zpracuje rovnou (leaf mode)
+- tok zpracování
+  1. `StationsRepository` - stejné jako u živého pipeline (stanice s vyplněným WSI)
+  2. `OpendataHistoricalDatasource` - jeden fetch na stanici × měsíc (měsíc určen z `from`)
+  3. Přiřazení `station_id` dle WSI -> `station_id` mappingu
+  4. Filtr `from <= DT < to` dle rozsahu dílčí zprávy
+  5. `OpendataMeasurementsTransformation` - stejná jako u živého pipeline (pivot long->wide, `data_source = 'opendata'`, žádná hodinová agregace - ukládá se ve stejné 10minutové granularitě jako živá data)
+  6. `MeasurementsRepository.bulkUpdate` - stejné UPSERT jako u živého pipeline; `data_source` je součástí primárního klíče, takže `opendata` řádky nikdy nekolidují s `ftp` řádky
+- mapování ELEMENT -> DB sloupec
+  - stejné jako u *DownloadOpendataMeasurementsTask* výše
+- data modely
+  - [MeasurementModel](https://gitlab.com/operator-ict/golemio/code/modules/chmu/-/blob/development/src/schema-definitions/definitions/models/MeasurementModel.ts)
+- poznámka
+  - Rozsah (`from`/`to`) určuje výhradně volající zpráva.
+
 ## Uložení dat
 
 ### Obecné

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@golemio/chmu",
-    "version": "1.1.1-dev.2647709694",
+    "version": "1.1.1-dev.2674913750",
     "description": "Golemio CHMU module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",