meteo-lt-sdk 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"places.d.ts","sourceRoot":"","sources":["../../src/api/places.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQtD;;;GAGG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;OAWG;IACG,MAAM,IAAI,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IAIhD;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAI9C;;;;;;;;;;;;;;OAcG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOjE;;;;;;;;;;;;;;;;OAgBG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC;CAMvE"}

package/dist/api/places.js

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview Places API module.
+ * @module meteo-lt-sdk/api/places
+ */
+import { placeSummaryArraySchema, placeDetailsSchema, placeForecastTypesSchema, } from '../schemas/places.js';
+import { forecastSchema } from '../schemas/forecasts.js';
+/**
+ * API module for place and forecast operations.
+ * Provides methods to query places and retrieve weather forecasts.
+ */
+export class PlacesApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * 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})`));
+     * ```
+     */
+    async getAll() {
+        return this.http.get('places', placeSummaryArraySchema);
+    }
+    /**
+     * 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}`);
+     * ```
+     */
+    async get(code) {
+        return this.http.get(`places/${encodeURIComponent(code)}`, placeDetailsSchema);
+    }
+    /**
+     * 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}`);
+     * });
+     * ```
+     */
+    async getForecastTypes(code) {
+        return this.http.get(`places/${encodeURIComponent(code)}/forecasts`, placeForecastTypesSchema);
+    }
+    /**
+     * 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}`);
+     * });
+     * ```
+     */
+    async getForecast(code, type) {
+        return this.http.get(`places/${encodeURIComponent(code)}/forecasts/${encodeURIComponent(type)}`, forecastSchema);
+    }
+}
+//# sourceMappingURL=places.js.map

package/dist/api/places.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"places.js","sourceRoot":"","sources":["../../src/api/places.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;GAGG;AACH,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,gBAAgB,CAAC,IAAY;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,UAAU,kBAAkB,CAAC,IAAI,CAAC,YAAY,EAC9C,wBAAwB,CACzB,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,IAAkB;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,UAAU,kBAAkB,CAAC,IAAI,CAAC,cAAc,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAC1E,cAAc,CACf,CAAC;IACJ,CAAC;CACF"}

package/dist/api/stations.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Meteorological stations API module.
+ * @module meteo-lt-sdk/api/stations
+ */
+import type { HttpClient } from '../client/http.js';
+import type { StationSummary, StationDetails, StationObservationsInfo, StationObservations, ObservationDateParam } from '../types/stations.js';
+/**
+ * API module for meteorological station operations.
+ * Provides methods to query stations and retrieve observation data.
+ */
+export declare class StationsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Gets a list of all meteorological stations.
+     *
+     * @returns Array of station summaries with codes, names, and coordinates
+     *
+     * @example
+     * ```typescript
+     * const stations = await client.stations.getAll();
+     * console.log(`Found ${stations.length} stations`);
+     * stations.forEach(s => console.log(`${s.name} (${s.code})`));
+     * ```
+     */
+    getAll(): Promise<readonly StationSummary[]>;
+    /**
+     * Gets detailed information for a specific station.
+     *
+     * @param code - Station code (e.g., 'vilniaus-ams')
+     * @returns Detailed station information including type
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const station = await client.stations.get('vilniaus-ams');
+     * console.log(`${station.name} (${station.type})`);
+     * ```
+     */
+    get(code: string): Promise<StationDetails>;
+    /**
+     * Gets information about available observation data for a station.
+     *
+     * @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.stations.getObservationsInfo('vilniaus-ams');
+     * console.log(`Data from ${info.observationsDataRange.startTimeUtc}`);
+     * console.log(`Data to ${info.observationsDataRange.endTimeUtc}`);
+     * ```
+     */
+    getObservationsInfo(code: string): Promise<StationObservationsInfo>;
+    /**
+     * Gets observation data for a station on a specific date.
+     *
+     * @param code - Station code
+     * @param date - Date in YYYY-MM-DD format, or 'latest' for last 24 hours.
+     *               Historical data is available for the last 10 years.
+     * @returns Station info and observation data points
+     * @throws {MeteoNotFoundError} If no data exists for the requested date
+     *
+     * @example
+     * ```typescript
+     * // Get latest observations
+     * const latest = await client.stations.getObservations('vilniaus-ams', 'latest');
+     *
+     * // Get specific date
+     * const historical = await client.stations.getObservations('vilniaus-ams', '2024-01-15');
+     *
+     * historical.observations.forEach(obs => {
+     *   console.log(`${obs.observationTimeUtc}: ${obs.airTemperature}°C`);
+     * });
+     * ```
+     */
+    getObservations(code: string, date: ObservationDateParam): Promise<StationObservations>;
+}
+//# sourceMappingURL=stations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stations.d.ts","sourceRoot":"","sources":["../../src/api/stations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAQ9B;;;GAGG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;OAWG;IACG,MAAM,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;IAIlD;;;;;;;;;;;;OAYG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhD;;;;;;;;;;;;;OAaG;IACG,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAOzE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,eAAe,CACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC;CAMhC"}

package/dist/api/stations.js

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Meteorological stations API module.
+ * @module meteo-lt-sdk/api/stations
+ */
+import { stationSummaryArraySchema, stationDetailsSchema, stationObservationsInfoSchema, stationObservationsSchema, } from '../schemas/stations.js';
+/**
+ * API module for meteorological station operations.
+ * Provides methods to query stations and retrieve observation data.
+ */
+export class StationsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Gets a list of all meteorological stations.
+     *
+     * @returns Array of station summaries with codes, names, and coordinates
+     *
+     * @example
+     * ```typescript
+     * const stations = await client.stations.getAll();
+     * console.log(`Found ${stations.length} stations`);
+     * stations.forEach(s => console.log(`${s.name} (${s.code})`));
+     * ```
+     */
+    async getAll() {
+        return this.http.get('stations', stationSummaryArraySchema);
+    }
+    /**
+     * Gets detailed information for a specific station.
+     *
+     * @param code - Station code (e.g., 'vilniaus-ams')
+     * @returns Detailed station information including type
+     * @throws {MeteoNotFoundError} If the station code doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const station = await client.stations.get('vilniaus-ams');
+     * console.log(`${station.name} (${station.type})`);
+     * ```
+     */
+    async get(code) {
+        return this.http.get(`stations/${encodeURIComponent(code)}`, stationDetailsSchema);
+    }
+    /**
+     * Gets information about available observation data for a station.
+     *
+     * @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.stations.getObservationsInfo('vilniaus-ams');
+     * console.log(`Data from ${info.observationsDataRange.startTimeUtc}`);
+     * console.log(`Data to ${info.observationsDataRange.endTimeUtc}`);
+     * ```
+     */
+    async getObservationsInfo(code) {
+        return this.http.get(`stations/${encodeURIComponent(code)}/observations`, stationObservationsInfoSchema);
+    }
+    /**
+     * Gets observation data for a station on a specific date.
+     *
+     * @param code - Station code
+     * @param date - Date in YYYY-MM-DD format, or 'latest' for last 24 hours.
+     *               Historical data is available for the last 10 years.
+     * @returns Station info and observation data points
+     * @throws {MeteoNotFoundError} If no data exists for the requested date
+     *
+     * @example
+     * ```typescript
+     * // Get latest observations
+     * const latest = await client.stations.getObservations('vilniaus-ams', 'latest');
+     *
+     * // Get specific date
+     * const historical = await client.stations.getObservations('vilniaus-ams', '2024-01-15');
+     *
+     * historical.observations.forEach(obs => {
+     *   console.log(`${obs.observationTimeUtc}: ${obs.airTemperature}°C`);
+     * });
+     * ```
+     */
+    async getObservations(code, date) {
+        return this.http.get(`stations/${encodeURIComponent(code)}/observations/${encodeURIComponent(date)}`, stationObservationsSchema);
+    }
+}
+//# sourceMappingURL=stations.js.map

package/dist/api/stations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stations.js","sourceRoot":"","sources":["../../src/api/stations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,6BAA6B,EAC7B,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAEhC;;;GAGG;AACH,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,mBAAmB,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,YAAY,kBAAkB,CAAC,IAAI,CAAC,eAAe,EACnD,6BAA6B,CAC9B,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,eAAe,CACnB,IAAY,EACZ,IAA0B;QAE1B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,YAAY,kBAAkB,CAAC,IAAI,CAAC,iBAAiB,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAC/E,yBAAyB,CAC1B,CAAC;IACJ,CAAC;CACF"}

package/dist/client/MeteoClient.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview Main Meteo.lt client.
+ * @module meteo-lt-sdk/client/MeteoClient
+ */
+import type { MeteoClientConfig } from './config.js';
+import { PlacesApi } from '../api/places.js';
+import { StationsApi } from '../api/stations.js';
+import { HydroStationsApi } from '../api/hydro-stations.js';
+/**
+ * Main client for the Meteo.lt API.
+ *
+ * Provides access to weather forecasts, meteorological observations,
+ * and hydrological data from the Lithuanian Hydrometeorological Service (LHMT).
+ *
+ * @example
+ * ```typescript
+ * import { MeteoClient } from 'meteo-lt-sdk';
+ *
+ * const client = new MeteoClient();
+ *
+ * // Get weather forecast for Vilnius
+ * const forecast = await client.places.getForecast('vilnius', 'long-term');
+ * console.log(`Current temperature: ${forecast.forecastTimestamps[0]?.airTemperature}°C`);
+ *
+ * // Get latest observations from a weather station
+ * const observations = await client.stations.getObservations('vilniaus-ams', 'latest');
+ *
+ * // Get water level data
+ * const hydroData = await client.hydroStations.getMeasuredObservations('nemajunu-vms', 'latest');
+ * ```
+ *
+ * @example Custom configuration
+ * ```typescript
+ * const client = new MeteoClient({
+ *   timeout: 10000, // 10 second timeout
+ *   headers: { 'X-Custom-Header': 'value' },
+ * });
+ * ```
+ *
+ * @remarks
+ * Rate Limiting: The API limits requests to 180 per minute per IP address.
+ * Daily limit is recommended to be under 20,000 requests per IP.
+ *
+ * @see {@link https://api.meteo.lt/} Official API documentation
+ */
+export declare class MeteoClient {
+    private readonly http;
+    /**
+     * API for places and weather forecasts.
+     *
+     * @example
+     * ```typescript
+     * const places = await client.places.getAll();
+     * const forecast = await client.places.getForecast('vilnius', 'long-term');
+     * ```
+     */
+    readonly places: PlacesApi;
+    /**
+     * API for meteorological stations and observations.
+     *
+     * @example
+     * ```typescript
+     * const stations = await client.stations.getAll();
+     * const data = await client.stations.getObservations('vilniaus-ams', 'latest');
+     * ```
+     */
+    readonly stations: StationsApi;
+    /**
+     * API for hydrological stations and water observations.
+     *
+     * @example
+     * ```typescript
+     * const stations = await client.hydroStations.getAll();
+     * const data = await client.hydroStations.getMeasuredObservations('nemajunu-vms', 'latest');
+     * ```
+     */
+    readonly hydroStations: HydroStationsApi;
+    /**
+     * Creates a new Meteo.lt client.
+     *
+     * @param config - Optional configuration options
+     */
+    constructor(config?: MeteoClientConfig);
+}
+//# sourceMappingURL=MeteoClient.d.ts.map

package/dist/client/MeteoClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeteoClient.d.ts","sourceRoot":"","sources":["../../src/client/MeteoClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC;;;;;;;;OAQG;IACH,SAAgB,MAAM,EAAE,SAAS,CAAC;IAElC;;;;;;;;OAQG;IACH,SAAgB,QAAQ,EAAE,WAAW,CAAC;IAEtC;;;;;;;;OAQG;IACH,SAAgB,aAAa,EAAE,gBAAgB,CAAC;IAEhD;;;;OAIG;gBACS,MAAM,CAAC,EAAE,iBAAiB;CAOvC"}

package/dist/client/MeteoClient.js

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Main Meteo.lt client.
+ * @module meteo-lt-sdk/client/MeteoClient
+ */
+import { resolveConfig } from './config.js';
+import { HttpClient } from './http.js';
+import { PlacesApi } from '../api/places.js';
+import { StationsApi } from '../api/stations.js';
+import { HydroStationsApi } from '../api/hydro-stations.js';
+/**
+ * Main client for the Meteo.lt API.
+ *
+ * Provides access to weather forecasts, meteorological observations,
+ * and hydrological data from the Lithuanian Hydrometeorological Service (LHMT).
+ *
+ * @example
+ * ```typescript
+ * import { MeteoClient } from 'meteo-lt-sdk';
+ *
+ * const client = new MeteoClient();
+ *
+ * // Get weather forecast for Vilnius
+ * const forecast = await client.places.getForecast('vilnius', 'long-term');
+ * console.log(`Current temperature: ${forecast.forecastTimestamps[0]?.airTemperature}°C`);
+ *
+ * // Get latest observations from a weather station
+ * const observations = await client.stations.getObservations('vilniaus-ams', 'latest');
+ *
+ * // Get water level data
+ * const hydroData = await client.hydroStations.getMeasuredObservations('nemajunu-vms', 'latest');
+ * ```
+ *
+ * @example Custom configuration
+ * ```typescript
+ * const client = new MeteoClient({
+ *   timeout: 10000, // 10 second timeout
+ *   headers: { 'X-Custom-Header': 'value' },
+ * });
+ * ```
+ *
+ * @remarks
+ * Rate Limiting: The API limits requests to 180 per minute per IP address.
+ * Daily limit is recommended to be under 20,000 requests per IP.
+ *
+ * @see {@link https://api.meteo.lt/} Official API documentation
+ */
+export class MeteoClient {
+    http;
+    /**
+     * API for places and weather forecasts.
+     *
+     * @example
+     * ```typescript
+     * const places = await client.places.getAll();
+     * const forecast = await client.places.getForecast('vilnius', 'long-term');
+     * ```
+     */
+    places;
+    /**
+     * API for meteorological stations and observations.
+     *
+     * @example
+     * ```typescript
+     * const stations = await client.stations.getAll();
+     * const data = await client.stations.getObservations('vilniaus-ams', 'latest');
+     * ```
+     */
+    stations;
+    /**
+     * API for hydrological stations and water observations.
+     *
+     * @example
+     * ```typescript
+     * const stations = await client.hydroStations.getAll();
+     * const data = await client.hydroStations.getMeasuredObservations('nemajunu-vms', 'latest');
+     * ```
+     */
+    hydroStations;
+    /**
+     * Creates a new Meteo.lt client.
+     *
+     * @param config - Optional configuration options
+     */
+    constructor(config) {
+        const resolved = resolveConfig(config);
+        this.http = new HttpClient(resolved);
+        this.places = new PlacesApi(this.http);
+        this.stations = new StationsApi(this.http);
+        this.hydroStations = new HydroStationsApi(this.http);
+    }
+}
+//# sourceMappingURL=MeteoClient.js.map

package/dist/client/MeteoClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeteoClient.js","sourceRoot":"","sources":["../../src/client/MeteoClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,WAAW;IACL,IAAI,CAAa;IAElC;;;;;;;;OAQG;IACa,MAAM,CAAY;IAElC;;;;;;;;OAQG;IACa,QAAQ,CAAc;IAEtC;;;;;;;;OAQG;IACa,aAAa,CAAmB;IAEhD;;;;OAIG;IACH,YAAY,MAA0B;QACpC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/client/config.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Client configuration types.
+ * @module meteo-lt-sdk/client/config
+ */
+/**
+ * Configuration options for the Meteo.lt client.
+ */
+export interface MeteoClientConfig {
+    /**
+     * Base URL for the API.
+     * @default 'https://api.meteo.lt/v1/'
+     */
+    readonly baseUrl?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    readonly timeout?: number;
+    /**
+     * Custom fetch implementation.
+     * Useful for testing or custom environments.
+     * @default globalThis.fetch
+     */
+    readonly fetch?: typeof globalThis.fetch;
+    /**
+     * Custom headers to include in all requests.
+     */
+    readonly headers?: Readonly<Record<string, string>>;
+    /**
+     * Enable automatic rate limiting.
+     * When true, requests are queued to stay under the API limit (180 req/min).
+     * Uses a global rate limiter shared across all MeteoClient instances.
+     * @default false
+     */
+    readonly throttle?: boolean;
+}
+/**
+ * Resolved configuration with all defaults applied.
+ */
+export interface ResolvedMeteoClientConfig {
+    readonly baseUrl: string;
+    readonly timeout: number;
+    readonly fetch: typeof globalThis.fetch;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly throttle: boolean;
+}
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULT_CONFIG: ResolvedMeteoClientConfig;
+/**
+ * Resolves partial config with defaults.
+ * @param config - Partial configuration
+ * @returns Fully resolved configuration
+ */
+export declare function resolveConfig(config?: MeteoClientConfig): ResolvedMeteoClientConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/client/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEpD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,yBAMnB,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,yBAAyB,CAQnF"}

package/dist/client/config.js

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Client configuration types.
+ * @module meteo-lt-sdk/client/config
+ */
+/**
+ * Default configuration values.
+ */
+export const DEFAULT_CONFIG = {
+    baseUrl: 'https://api.meteo.lt/v1/',
+    timeout: 30000,
+    fetch: globalThis.fetch.bind(globalThis),
+    headers: {},
+    throttle: false,
+};
+/**
+ * Resolves partial config with defaults.
+ * @param config - Partial configuration
+ * @returns Fully resolved configuration
+ */
+export function resolveConfig(config) {
+    return {
+        baseUrl: config?.baseUrl ?? DEFAULT_CONFIG.baseUrl,
+        timeout: config?.timeout ?? DEFAULT_CONFIG.timeout,
+        fetch: config?.fetch ?? DEFAULT_CONFIG.fetch,
+        headers: config?.headers ?? DEFAULT_CONFIG.headers,
+        throttle: config?.throttle ?? DEFAULT_CONFIG.throttle,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/client/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkDH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA8B;IACvD,OAAO,EAAE,0BAA0B;IACnC,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;IACxC,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,KAAK;CACP,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,OAAO;QACL,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,cAAc,CAAC,OAAO;QAClD,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,cAAc,CAAC,OAAO;QAClD,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,cAAc,CAAC,KAAK;QAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,cAAc,CAAC,OAAO;QAClD,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,cAAc,CAAC,QAAQ;KACtD,CAAC;AACJ,CAAC"}

package/dist/client/http.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Typed HTTP client with error handling and validation.
+ * @module meteo-lt-sdk/client/http
+ */
+import type { z } from 'zod';
+import type { ResolvedMeteoClientConfig } from './config.js';
+/**
+ * Internal HTTP client for making API requests.
+ * Handles error mapping, timeouts, and response validation.
+ */
+export declare class HttpClient {
+    private readonly config;
+    constructor(config: ResolvedMeteoClientConfig);
+    /**
+     * Makes a GET request and validates the response.
+     * @param path - API endpoint path (relative to base URL)
+     * @param schema - Zod schema for response validation
+     * @returns Validated and typed response data
+     * @throws {MeteoNotFoundError} When the resource is not found (404)
+     * @throws {MeteoRateLimitError} When rate limit is exceeded (429)
+     * @throws {MeteoApiError} For other HTTP errors
+     * @throws {MeteoNetworkError} For network failures
+     * @throws {MeteoTimeoutError} When request times out
+     * @throws {MeteoValidationError} When response doesn't match schema
+     */
+    get<T>(path: string, schema: z.ZodType<T>): Promise<T>;
+    /**
+     * Builds full URL from path.
+     */
+    private buildUrl;
+    /**
+     * Maps HTTP error responses to specific error types.
+     */
+    private handleHttpError;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/client/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/client/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAW7D;;;GAGG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,yBAAyB;IAE9D;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IA6Eb;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,eAAe;CAwBxB"}