meteo-lt-sdk 1.0.0

package/dist/__tests__/test-utils.js

@@ -0,0 +1,278 @@
+/**
+ * Test utilities and mock helpers for Meteo.lt SDK tests.
+ */
+/**
+ * Creates a mock fetch function that returns the specified response.
+ */
+export function createMockFetch(response, options = {}) {
+    const { status = 200, statusText = 'OK', headers = {} } = options;
+    return async () => {
+        const responseHeaders = new Headers(headers);
+        return new Response(JSON.stringify(response), {
+            status,
+            statusText,
+            headers: responseHeaders,
+        });
+    };
+}
+/**
+ * Creates a mock fetch that throws a network error.
+ */
+export function createNetworkErrorFetch(message = 'Network error') {
+    return async () => {
+        throw new Error(message);
+    };
+}
+/**
+ * Creates a mock fetch that times out via AbortController.
+ */
+export function createTimeoutFetch() {
+    return async (_url, init) => {
+        // Simulate timeout by checking abort signal
+        if (init?.signal) {
+            const error = new DOMException('The operation was aborted', 'AbortError');
+            throw error;
+        }
+        return new Response('{}', { status: 200 });
+    };
+}
+/**
+ * Creates a resolved config with a mock fetch.
+ */
+export function createMockConfig(mockFetch, overrides = {}) {
+    return {
+        baseUrl: 'https://api.meteo.lt/v1/',
+        timeout: 1000,
+        fetch: mockFetch,
+        headers: {},
+        throttle: false,
+        ...overrides,
+    };
+}
+/**
+ * Sample data for testing places API.
+ */
+export const MOCK_PLACES = [
+    {
+        code: 'vilnius',
+        name: 'Vilnius',
+        administrativeDivision: 'Vilniaus miesto savivaldybė',
+        countryCode: 'LT',
+        coordinates: { latitude: 54.6872, longitude: 25.2797 },
+    },
+    {
+        code: 'kaunas',
+        name: 'Kaunas',
+        administrativeDivision: 'Kauno miesto savivaldybė',
+        countryCode: 'LT',
+        coordinates: { latitude: 54.8985, longitude: 23.9036 },
+    },
+];
+export const MOCK_PLACE_DETAILS = {
+    code: 'vilnius',
+    name: 'Vilnius',
+    administrativeDivision: 'Vilniaus miesto savivaldybė',
+    country: 'Lietuva',
+    countryCode: 'LT',
+    coordinates: { latitude: 54.6872, longitude: 25.2797 },
+};
+export const MOCK_FORECAST_TYPES = {
+    place: MOCK_PLACE_DETAILS,
+    forecastTypes: [
+        { type: 'long-term', description: 'Long-term forecast' },
+    ],
+};
+export const MOCK_FORECAST = {
+    place: MOCK_PLACE_DETAILS,
+    forecastType: 'long-term',
+    forecastCreationTimeUtc: '2026-01-04 14:00:00',
+    forecastTimestamps: [
+        {
+            forecastTimeUtc: '2026-01-04 15:00:00',
+            airTemperature: -2.5,
+            feelsLikeTemperature: -5.0,
+            windSpeed: 3.5,
+            windGust: 6.2,
+            windDirection: 180,
+            cloudCover: 75,
+            seaLevelPressure: 1015,
+            relativeHumidity: 85,
+            totalPrecipitation: 0.5,
+            conditionCode: 'cloudy',
+        },
+        {
+            forecastTimeUtc: '2026-01-04 18:00:00',
+            airTemperature: -4.0,
+            feelsLikeTemperature: -7.5,
+            windSpeed: 2.0,
+            windGust: 4.0,
+            windDirection: 200,
+            cloudCover: 50,
+            seaLevelPressure: 1016,
+            relativeHumidity: 80,
+            totalPrecipitation: 0,
+            conditionCode: 'partly-cloudy',
+        },
+    ],
+};
+/**
+ * Sample data for testing stations API.
+ */
+export const MOCK_STATIONS = [
+    {
+        code: 'vilniaus-ams',
+        name: 'Vilniaus AMS',
+        coordinates: { latitude: 54.6339, longitude: 25.1008 },
+    },
+    {
+        code: 'kauno-ams',
+        name: 'Kauno AMS',
+        coordinates: { latitude: 54.8839, longitude: 23.8365 },
+    },
+];
+export const MOCK_STATION_DETAILS = {
+    code: 'vilniaus-ams',
+    name: 'Vilniaus AMS',
+    type: 'Automatic weather station',
+    coordinates: { latitude: 54.6339, longitude: 25.1008 },
+};
+export const MOCK_STATION_OBS_INFO = {
+    station: {
+        code: 'vilniaus-ams',
+        name: 'Vilniaus AMS',
+        coordinates: { latitude: 54.6339, longitude: 25.1008 },
+    },
+    observationsDataRange: {
+        startTimeUtc: '2016-01-01 00:00:00',
+        endTimeUtc: '2026-01-04 14:00:00',
+    },
+};
+export const MOCK_OBSERVATIONS = {
+    station: {
+        code: 'vilniaus-ams',
+        name: 'Vilniaus AMS',
+        coordinates: { latitude: 54.6339, longitude: 25.1008 },
+    },
+    observations: [
+        {
+            observationTimeUtc: '2026-01-04 12:00:00',
+            airTemperature: -3.2,
+            feelsLikeTemperature: -6.5,
+            windSpeed: 2.8,
+            windGust: 5.1,
+            windDirection: 190,
+            cloudCover: 80,
+            seaLevelPressure: 1014,
+            relativeHumidity: 88,
+            precipitation: 0.2,
+            conditionCode: 'cloudy',
+        },
+        {
+            observationTimeUtc: '2026-01-04 13:00:00',
+            airTemperature: -2.8,
+            feelsLikeTemperature: -5.8,
+            windSpeed: 3.1,
+            windGust: 5.5,
+            windDirection: 185,
+            cloudCover: 75,
+            seaLevelPressure: 1015,
+            relativeHumidity: 85,
+            precipitation: 0,
+            conditionCode: 'cloudy-with-sunny-intervals',
+        },
+    ],
+};
+/**
+ * Sample data for testing hydro stations API.
+ */
+export const MOCK_HYDRO_STATIONS = [
+    {
+        code: 'nemajunu-vms',
+        name: 'Nemajūnų VMS',
+        waterBody: 'Nemunas',
+        coordinates: { latitude: 54.4336, longitude: 24.0678 },
+    },
+    {
+        code: 'kauno-vms',
+        name: 'Kauno VMS',
+        waterBody: 'Nemunas',
+        coordinates: { latitude: 54.8989, longitude: 23.9012 },
+    },
+];
+export const MOCK_HYDRO_OBS_TYPES = {
+    station: {
+        code: 'nemajunu-vms',
+        name: 'Nemajūnų VMS',
+        waterBody: 'Nemunas',
+        coordinates: { latitude: 54.4336, longitude: 24.0678 },
+    },
+    observationTypes: [
+        { type: 'measured', description: 'Current year measurements' },
+        { type: 'historical', description: 'Historical data' },
+    ],
+};
+export const MOCK_HYDRO_MEASURED_INFO = {
+    station: {
+        code: 'nemajunu-vms',
+        name: 'Nemajūnų VMS',
+        waterBody: 'Nemunas',
+        coordinates: { latitude: 54.4336, longitude: 24.0678 },
+    },
+    observationsDataRange: {
+        startTimeUtc: '2025-12-05 00:00:00',
+        endTimeUtc: '2026-01-04 14:00:00',
+    },
+};
+export const MOCK_HYDRO_HISTORICAL_INFO = {
+    station: {
+        code: 'nemajunu-vms',
+        name: 'Nemajūnų VMS',
+        waterBody: 'Nemunas',
+        coordinates: { latitude: 54.4336, longitude: 24.0678 },
+    },
+    observationsDataRange: {
+        startDateUtc: '2000-01-01',
+        endDateUtc: '2025-12-31',
+    },
+};
+export const MOCK_HYDRO_MEASURED_OBS = {
+    station: {
+        code: 'nemajunu-vms',
+        name: 'Nemajūnų VMS',
+        waterBody: 'Nemunas',
+        coordinates: { latitude: 54.4336, longitude: 24.0678 },
+    },
+    observations: [
+        {
+            observationTimeUtc: '2026-01-04 12:00:00',
+            waterLevel: 38.5,
+            waterTemperature: 2.1,
+        },
+        {
+            observationTimeUtc: '2026-01-04 13:00:00',
+            waterLevel: 38.2,
+            waterTemperature: 2.0,
+        },
+    ],
+};
+export const MOCK_HYDRO_HISTORICAL_OBS = {
+    station: {
+        code: 'nemajunu-vms',
+        name: 'Nemajūnų VMS',
+        waterBody: 'Nemunas',
+        coordinates: { latitude: 54.4336, longitude: 24.0678 },
+    },
+    observations: [
+        {
+            observationDateUtc: '2024-06-15',
+            waterLevel: 120.5,
+            waterDischarge: 285.3,
+        },
+        {
+            observationDateUtc: '2024-06-16',
+            waterLevel: 118.2,
+            waterDischarge: 278.1,
+        },
+    ],
+};
+//# sourceMappingURL=test-utils.js.map

package/dist/__tests__/test-utils.js.map

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

package/dist/api/hydro-stations.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @fileoverview Hydrological stations API module.
+ * @module meteo-lt-sdk/api/hydro-stations
+ */
+import type { HttpClient } from '../client/http.js';
+import type { HydroStationSummary, HydroStationDetails, HydroStationObservationTypes, HydroStationMeasuredInfo, HydroStationHistoricalInfo, HydroStationMeasuredObservations, HydroStationHistoricalObservations, MeasuredDateParam, HistoricalDateParam } from '../types/hydro-stations.js';
+/**
+ * API module for hydrological station operations.
+ * Provides methods to query hydro stations and retrieve water observation data.
+ */
+export declare class HydroStationsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Gets a list of all hydrological stations.
+     *
+     * @returns Array of hydro station summaries with codes, names, water bodies, and coordinates
+     *
+     * @example
+     * ```typescript
+     * const stations = await client.hydroStations.getAll();
+     * console.log(`Found ${stations.length} hydro stations`);
+     * stations.forEach(s => console.log(`${s.name} on ${s.waterBody}`));
+     * ```
+     */
+    getAll(): Promise<readonly HydroStationSummary[]>;
+    /**
+     * Gets detailed information for a specific hydrological station.
+     *
+     * @param code - Station code (e.g., 'nemajunu-vms')
+     * @returns Detailed hydro station information
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const station = await client.hydroStations.get('nemajunu-vms');
+     * console.log(`${station.name} monitors ${station.waterBody}`);
+     * ```
+     */
+    get(code: string): Promise<HydroStationDetails>;
+    /**
+     * Gets available observation types for a hydro station.
+     *
+     * @param code - Station code
+     * @returns Station info and available observation types (measured, historical)
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const info = await client.hydroStations.getObservationTypes('nemajunu-vms');
+     * info.observationTypes.forEach(ot => {
+     *   console.log(`${ot.type}: ${ot.description}`);
+     * });
+     * ```
+     */
+    getObservationTypes(code: string): Promise<HydroStationObservationTypes>;
+    /**
+     * Gets information about available measured (current year) observation data.
+     *
+     * @param code - Station code
+     * @returns Station info and available data time range
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const info = await client.hydroStations.getMeasuredInfo('nemajunu-vms');
+     * console.log(`Data from ${info.observationsDataRange.startTimeUtc}`);
+     * ```
+     */
+    getMeasuredInfo(code: string): Promise<HydroStationMeasuredInfo>;
+    /**
+     * Gets information about available historical observation data.
+     *
+     * @param code - Station code
+     * @returns Station info and available data date range
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const info = await client.hydroStations.getHistoricalInfo('nemajunu-vms');
+     * console.log(`Historical data from ${info.observationsDataRange.startDateUtc}`);
+     * ```
+     */
+    getHistoricalInfo(code: string): Promise<HydroStationHistoricalInfo>;
+    /**
+     * Gets measured (current year) observation data for a hydro station.
+     *
+     * @param code - Station code
+     * @param date - Date in YYYY-MM-DD format, or 'latest' for last 24 hours.
+     *               Data is available for the last 30 days.
+     * @returns Station info and measured observation data points
+     * @throws {MeteoNotFoundError} If no data exists for the requested date
+     *
+     * @example
+     * ```typescript
+     * const data = await client.hydroStations.getMeasuredObservations('nemajunu-vms', 'latest');
+     * data.observations.forEach(obs => {
+     *   console.log(`${obs.observationTimeUtc}: ${obs.waterLevel}cm, ${obs.waterTemperature}°C`);
+     * });
+     * ```
+     */
+    getMeasuredObservations(code: string, date: MeasuredDateParam): Promise<HydroStationMeasuredObservations>;
+    /**
+     * Gets historical observation data for a hydro station.
+     *
+     * @param code - Station code
+     * @param date - Can be:
+     *   - 'latest' for last 31 days
+     *   - 'YYYY-MM' for a specific month
+     *   - 'YYYY-MM-DD' for a specific day
+     *   Historical data is available from 2000 onwards.
+     * @returns Station info and historical observation data points (daily averages)
+     * @throws {MeteoNotFoundError} If no data exists for the requested date
+     *
+     * @example
+     * ```typescript
+     * // Get last 31 days
+     * const latest = await client.hydroStations.getHistoricalObservations('nemajunu-vms', 'latest');
+     *
+     * // Get specific month
+     * const monthly = await client.hydroStations.getHistoricalObservations('nemajunu-vms', '2024-06');
+     *
+     * // Get specific day
+     * const daily = await client.hydroStations.getHistoricalObservations('nemajunu-vms', '2024-06-15');
+     *
+     * latest.observations.forEach(obs => {
+     *   console.log(`${obs.observationDateUtc}: ${obs.waterLevel}cm, ${obs.waterDischarge}m³/s`);
+     * });
+     * ```
+     */
+    getHistoricalObservations(code: string, date: HistoricalDateParam): Promise<HydroStationHistoricalObservations>;
+}
+//# sourceMappingURL=hydro-stations.d.ts.map

package/dist/api/hydro-stations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydro-stations.d.ts","sourceRoot":"","sources":["../../src/api/hydro-stations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,EAC5B,wBAAwB,EACxB,0BAA0B,EAC1B,gCAAgC,EAChC,kCAAkC,EAClC,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAWpC;;;GAGG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;OAWG;IACG,MAAM,IAAI,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAIvD;;;;;;;;;;;;OAYG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOrD;;;;;;;;;;;;;;OAcG;IACG,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAO9E;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAOtE;;;;;;;;;;;;OAYG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAO1E;;;;;;;;;;;;;;;;OAgBG;IACG,uBAAuB,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gCAAgC,CAAC;IAO5C;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,yBAAyB,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,kCAAkC,CAAC;CAM/C"}

package/dist/api/hydro-stations.js

@@ -0,0 +1,148 @@
+/**
+ * @fileoverview Hydrological stations API module.
+ * @module meteo-lt-sdk/api/hydro-stations
+ */
+import { hydroStationSummaryArraySchema, hydroStationSummarySchema, hydroStationObservationTypesSchema, hydroStationMeasuredInfoSchema, hydroStationHistoricalInfoSchema, hydroStationMeasuredObservationsSchema, hydroStationHistoricalObservationsSchema, } from '../schemas/hydro-stations.js';
+/**
+ * API module for hydrological station operations.
+ * Provides methods to query hydro stations and retrieve water observation data.
+ */
+export class HydroStationsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Gets a list of all hydrological stations.
+     *
+     * @returns Array of hydro station summaries with codes, names, water bodies, and coordinates
+     *
+     * @example
+     * ```typescript
+     * const stations = await client.hydroStations.getAll();
+     * console.log(`Found ${stations.length} hydro stations`);
+     * stations.forEach(s => console.log(`${s.name} on ${s.waterBody}`));
+     * ```
+     */
+    async getAll() {
+        return this.http.get('hydro-stations', hydroStationSummaryArraySchema);
+    }
+    /**
+     * Gets detailed information for a specific hydrological station.
+     *
+     * @param code - Station code (e.g., 'nemajunu-vms')
+     * @returns Detailed hydro station information
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const station = await client.hydroStations.get('nemajunu-vms');
+     * console.log(`${station.name} monitors ${station.waterBody}`);
+     * ```
+     */
+    async get(code) {
+        return this.http.get(`hydro-stations/${encodeURIComponent(code)}`, hydroStationSummarySchema);
+    }
+    /**
+     * Gets available observation types for a hydro station.
+     *
+     * @param code - Station code
+     * @returns Station info and available observation types (measured, historical)
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const info = await client.hydroStations.getObservationTypes('nemajunu-vms');
+     * info.observationTypes.forEach(ot => {
+     *   console.log(`${ot.type}: ${ot.description}`);
+     * });
+     * ```
+     */
+    async getObservationTypes(code) {
+        return this.http.get(`hydro-stations/${encodeURIComponent(code)}/observations`, hydroStationObservationTypesSchema);
+    }
+    /**
+     * Gets information about available measured (current year) observation data.
+     *
+     * @param code - Station code
+     * @returns Station info and available data time range
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const info = await client.hydroStations.getMeasuredInfo('nemajunu-vms');
+     * console.log(`Data from ${info.observationsDataRange.startTimeUtc}`);
+     * ```
+     */
+    async getMeasuredInfo(code) {
+        return this.http.get(`hydro-stations/${encodeURIComponent(code)}/observations/measured`, hydroStationMeasuredInfoSchema);
+    }
+    /**
+     * Gets information about available historical observation data.
+     *
+     * @param code - Station code
+     * @returns Station info and available data date range
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const info = await client.hydroStations.getHistoricalInfo('nemajunu-vms');
+     * console.log(`Historical data from ${info.observationsDataRange.startDateUtc}`);
+     * ```
+     */
+    async getHistoricalInfo(code) {
+        return this.http.get(`hydro-stations/${encodeURIComponent(code)}/observations/historical`, hydroStationHistoricalInfoSchema);
+    }
+    /**
+     * Gets measured (current year) observation data for a hydro station.
+     *
+     * @param code - Station code
+     * @param date - Date in YYYY-MM-DD format, or 'latest' for last 24 hours.
+     *               Data is available for the last 30 days.
+     * @returns Station info and measured observation data points
+     * @throws {MeteoNotFoundError} If no data exists for the requested date
+     *
+     * @example
+     * ```typescript
+     * const data = await client.hydroStations.getMeasuredObservations('nemajunu-vms', 'latest');
+     * data.observations.forEach(obs => {
+     *   console.log(`${obs.observationTimeUtc}: ${obs.waterLevel}cm, ${obs.waterTemperature}°C`);
+     * });
+     * ```
+     */
+    async getMeasuredObservations(code, date) {
+        return this.http.get(`hydro-stations/${encodeURIComponent(code)}/observations/measured/${encodeURIComponent(date)}`, hydroStationMeasuredObservationsSchema);
+    }
+    /**
+     * Gets historical observation data for a hydro station.
+     *
+     * @param code - Station code
+     * @param date - Can be:
+     *   - 'latest' for last 31 days
+     *   - 'YYYY-MM' for a specific month
+     *   - 'YYYY-MM-DD' for a specific day
+     *   Historical data is available from 2000 onwards.
+     * @returns Station info and historical observation data points (daily averages)
+     * @throws {MeteoNotFoundError} If no data exists for the requested date
+     *
+     * @example
+     * ```typescript
+     * // Get last 31 days
+     * const latest = await client.hydroStations.getHistoricalObservations('nemajunu-vms', 'latest');
+     *
+     * // Get specific month
+     * const monthly = await client.hydroStations.getHistoricalObservations('nemajunu-vms', '2024-06');
+     *
+     * // Get specific day
+     * const daily = await client.hydroStations.getHistoricalObservations('nemajunu-vms', '2024-06-15');
+     *
+     * latest.observations.forEach(obs => {
+     *   console.log(`${obs.observationDateUtc}: ${obs.waterLevel}cm, ${obs.waterDischarge}m³/s`);
+     * });
+     * ```
+     */
+    async getHistoricalObservations(code, date) {
+        return this.http.get(`hydro-stations/${encodeURIComponent(code)}/observations/historical/${encodeURIComponent(date)}`, hydroStationHistoricalObservationsSchema);
+    }
+}
+//# sourceMappingURL=hydro-stations.js.map

package/dist/api/hydro-stations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydro-stations.js","sourceRoot":"","sources":["../../src/api/hydro-stations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,kCAAkC,EAClC,8BAA8B,EAC9B,gCAAgC,EAChC,sCAAsC,EACtC,wCAAwC,GACzC,MAAM,8BAA8B,CAAC;AAEtC;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,8BAA8B,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAC5C,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,mBAAmB,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,eAAe,EACzD,kCAAkC,CACnC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,wBAAwB,EAClE,8BAA8B,CAC/B,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAAY;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,0BAA0B,EACpE,gCAAgC,CACjC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,uBAAuB,CAC3B,IAAY,EACZ,IAAuB;QAEvB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,0BAA0B,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAC9F,sCAAsC,CACvC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,yBAAyB,CAC7B,IAAY,EACZ,IAAyB;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,4BAA4B,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAChG,wCAAwC,CACzC,CAAC;IACJ,CAAC;CACF"}

package/dist/api/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview API module exports.
+ * @module meteo-lt-sdk/api
+ */
+export { PlacesApi } from './places.js';
+export { StationsApi } from './stations.js';
+export { HydroStationsApi } from './hydro-stations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview API module exports.
+ * @module meteo-lt-sdk/api
+ */
+export { PlacesApi } from './places.js';
+export { StationsApi } from './stations.js';
+export { HydroStationsApi } from './hydro-stations.js';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/api/places.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview Places API module.
+ * @module meteo-lt-sdk/api/places
+ */
+import type { HttpClient } from '../client/http.js';
+import type { PlaceSummary, PlaceDetails, PlaceForecastTypes, ForecastType } from '../types/places.js';
+import type { Forecast } from '../types/forecasts.js';
+/**
+ * API module for place and forecast operations.
+ * Provides methods to query places and retrieve weather forecasts.
+ */
+export declare class PlacesApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Gets a list of all places with weather forecast support.
+     *
+     * @returns Array of place summaries with codes, names, and coordinates
+     *
+     * @example
+     * ```typescript
+     * const places = await client.places.getAll();
+     * console.log(`Found ${places.length} places`);
+     * places.forEach(p => console.log(`${p.name} (${p.code})`));
+     * ```
+     */
+    getAll(): Promise<readonly PlaceSummary[]>;
+    /**
+     * Gets detailed information for a specific place.
+     *
+     * @param code - Place code (e.g., 'vilnius', 'kaunas')
+     * @returns Detailed place information including country name
+     * @throws {MeteoNotFoundError} If the place code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const place = await client.places.get('vilnius');
+     * console.log(`${place.name}, ${place.country}`);
+     * console.log(`Coords: ${place.coordinates.latitude}, ${place.coordinates.longitude}`);
+     * ```
+     */
+    get(code: string): Promise<PlaceDetails>;
+    /**
+     * Gets available forecast types for a place.
+     *
+     * @param code - Place code
+     * @returns Place details and available forecast types
+     * @throws {MeteoNotFoundError} If the place code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const info = await client.places.getForecastTypes('vilnius');
+     * info.forecastTypes.forEach(ft => {
+     *   console.log(`${ft.type}: ${ft.description}`);
+     * });
+     * ```
+     */
+    getForecastTypes(code: string): Promise<PlaceForecastTypes>;
+    /**
+     * Gets weather forecast for a place.
+     *
+     * @param code - Place code
+     * @param type - Forecast type (currently only 'long-term' is supported)
+     * @returns Complete forecast with timestamps and weather data
+     * @throws {MeteoNotFoundError} If the place code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const forecast = await client.places.getForecast('vilnius', 'long-term');
+     * console.log(`Forecast created: ${forecast.forecastCreationTimeUtc}`);
+     * forecast.forecastTimestamps.forEach(ts => {
+     *   console.log(`${ts.forecastTimeUtc}: ${ts.airTemperature}°C, ${ts.conditionCode}`);
+     * });
+     * ```
+     */
+    getForecast(code: string, type: ForecastType): Promise<Forecast>;
+}
+//# sourceMappingURL=places.d.ts.map