meteo-lt-sdk 1.0.0

package/dist/schemas/stations.js

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Zod schemas for meteorological station data validation.
+ * @module meteo-lt-sdk/schemas/stations
+ */
+import { z } from 'zod';
+import { coordinatesSchema } from './coordinates.js';
+import { OBSERVATION_CONDITION_CODES } from '../types/conditions.js';
+/**
+ * Schema for observation condition codes.
+ * Allows null for unknown conditions.
+ */
+const observationConditionCodeSchema = z.enum(OBSERVATION_CONDITION_CODES).nullable();
+/**
+ * Schema for station summary (list item).
+ */
+export const stationSummarySchema = z.object({
+    code: z.string().min(1),
+    name: z.string().min(1),
+    coordinates: coordinatesSchema,
+});
+/**
+ * Schema for an array of station summaries.
+ */
+export const stationSummaryArraySchema = z.array(stationSummarySchema);
+/**
+ * Schema for detailed station information.
+ */
+export const stationDetailsSchema = stationSummarySchema.extend({
+    type: z.string(),
+});
+/**
+ * Schema for observations data range.
+ */
+export const observationsDataRangeSchema = z.object({
+    startTimeUtc: z.string(),
+    endTimeUtc: z.string(),
+});
+/**
+ * Schema for station observations info response.
+ */
+export const stationObservationsInfoSchema = z.object({
+    station: stationSummarySchema,
+    observationsDataRange: observationsDataRangeSchema,
+});
+/**
+ * Schema for a single observation data point.
+ * Most fields are nullable since not all stations measure all parameters.
+ */
+export const observationSchema = z.object({
+    observationTimeUtc: z.string(),
+    airTemperature: z.number().nullable(),
+    feelsLikeTemperature: z.number().nullable(),
+    windSpeed: z.number().nonnegative().nullable(),
+    windGust: z.number().nonnegative().nullable(),
+    windDirection: z.number().min(0).max(360).nullable(),
+    cloudCover: z.number().min(0).max(100).nullable(),
+    seaLevelPressure: z.number().positive().nullable(),
+    relativeHumidity: z.number().min(0).max(100).nullable(),
+    precipitation: z.number().nonnegative().nullable(),
+    conditionCode: observationConditionCodeSchema,
+});
+/**
+ * Schema for station observations response.
+ */
+export const stationObservationsSchema = z.object({
+    station: stationSummarySchema,
+    observations: z.array(observationSchema),
+});
+//# sourceMappingURL=stations.js.map

package/dist/schemas/stations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stations.js","sourceRoot":"","sources":["../../src/schemas/stations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAUrE;;;GAGG;AACH,MAAM,8BAA8B,GAAG,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEtF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,iBAAiB;CAC/B,CAAqC,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAqC,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAA4C,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,OAAO,EAAE,oBAAoB;IAC7B,qBAAqB,EAAE,2BAA2B;CACnD,CAA8C,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC7C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAClD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACvD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAClD,aAAa,EAAE,8BAA8B;CAC9C,CAAkC,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,oBAAoB;IAC7B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;CACzC,CAA0C,CAAC"}

package/dist/types/conditions.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Weather condition codes for forecasts and observations.
+ * @module meteo-lt-sdk/types/conditions
+ */
+/**
+ * Weather condition codes used in forecast data.
+ * These are the possible values returned by the forecast API.
+ */
+export declare const FORECAST_CONDITION_CODES: readonly ["clear", "partly-cloudy", "cloudy-with-sunny-intervals", "cloudy", "light-rain", "rain", "heavy-rain", "thunder", "isolated-thunderstorms", "thunderstorms", "heavy-rain-with-thunderstorms", "light-sleet", "sleet", "freezing-rain", "hail", "light-snow", "snow", "heavy-snow", "fog"];
+/**
+ * Weather condition code type for forecast data.
+ * Null indicates conditions could not be determined.
+ */
+export type ForecastConditionCode = (typeof FORECAST_CONDITION_CODES)[number] | null;
+/**
+ * Weather condition codes used in observation data.
+ * This is a superset of forecast conditions with additional observational values.
+ */
+export declare const OBSERVATION_CONDITION_CODES: readonly ["clear", "partly-cloudy", "variable-cloudiness", "cloudy-with-sunny-intervals", "cloudy", "rain-showers", "light-rain-at-times", "rain-at-times", "light-rain", "rain", "heavy-rain", "thunder", "isolated-thunderstorms", "thunderstorms", "sleet-showers", "sleet-at-times", "light-sleet", "sleet", "freezing-rain", "hail", "snow-showers", "light-snow-at-times", "snow-at-times", "light-snow", "snow", "heavy-snow", "snowstorm", "fog", "squall"];
+/**
+ * Weather condition code type for observation data.
+ * Null indicates conditions could not be determined.
+ */
+export type ObservationConditionCode = (typeof OBSERVATION_CONDITION_CODES)[number] | null;
+/**
+ * Type guard to check if a value is a valid forecast condition code.
+ * @param value - The value to check
+ * @returns True if the value is a valid forecast condition code
+ */
+export declare function isForecastConditionCode(value: unknown): value is ForecastConditionCode;
+/**
+ * Type guard to check if a value is a valid observation condition code.
+ * @param value - The value to check
+ * @returns True if the value is a valid observation condition code
+ */
+export declare function isObservationConditionCode(value: unknown): value is ObservationConditionCode;
+/**
+ * Human-readable descriptions for weather condition codes in English.
+ */
+export declare const CONDITION_DESCRIPTIONS: Readonly<Record<string, string>>;
+/**
+ * Gets the human-readable description for a condition code.
+ * @param code - The condition code
+ * @returns Human-readable description or 'Unknown' if not found
+ */
+export declare function getConditionDescription(code: ForecastConditionCode | ObservationConditionCode): string;
+//# sourceMappingURL=conditions.d.ts.map

package/dist/types/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../src/types/conditions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,qSAoB3B,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,qcA8B9B,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAItF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,wBAAwB,CAI5F;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B1D,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,wBAAwB,GAAG,MAAM,CAGtG"}

package/dist/types/conditions.js

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Weather condition codes for forecasts and observations.
+ * @module meteo-lt-sdk/types/conditions
+ */
+/**
+ * Weather condition codes used in forecast data.
+ * These are the possible values returned by the forecast API.
+ */
+export const FORECAST_CONDITION_CODES = [
+    'clear',
+    'partly-cloudy',
+    'cloudy-with-sunny-intervals',
+    'cloudy',
+    'light-rain',
+    'rain',
+    'heavy-rain',
+    'thunder',
+    'isolated-thunderstorms',
+    'thunderstorms',
+    'heavy-rain-with-thunderstorms',
+    'light-sleet',
+    'sleet',
+    'freezing-rain',
+    'hail',
+    'light-snow',
+    'snow',
+    'heavy-snow',
+    'fog',
+];
+/**
+ * Weather condition codes used in observation data.
+ * This is a superset of forecast conditions with additional observational values.
+ */
+export const OBSERVATION_CONDITION_CODES = [
+    'clear',
+    'partly-cloudy',
+    'variable-cloudiness',
+    'cloudy-with-sunny-intervals',
+    'cloudy',
+    'rain-showers',
+    'light-rain-at-times',
+    'rain-at-times',
+    'light-rain',
+    'rain',
+    'heavy-rain',
+    'thunder',
+    'isolated-thunderstorms',
+    'thunderstorms',
+    'sleet-showers',
+    'sleet-at-times',
+    'light-sleet',
+    'sleet',
+    'freezing-rain',
+    'hail',
+    'snow-showers',
+    'light-snow-at-times',
+    'snow-at-times',
+    'light-snow',
+    'snow',
+    'heavy-snow',
+    'snowstorm',
+    'fog',
+    'squall',
+];
+/**
+ * Type guard to check if a value is a valid forecast condition code.
+ * @param value - The value to check
+ * @returns True if the value is a valid forecast condition code
+ */
+export function isForecastConditionCode(value) {
+    if (value === null)
+        return true;
+    return typeof value === 'string' &&
+        FORECAST_CONDITION_CODES.includes(value);
+}
+/**
+ * Type guard to check if a value is a valid observation condition code.
+ * @param value - The value to check
+ * @returns True if the value is a valid observation condition code
+ */
+export function isObservationConditionCode(value) {
+    if (value === null)
+        return true;
+    return typeof value === 'string' &&
+        OBSERVATION_CONDITION_CODES.includes(value);
+}
+/**
+ * Human-readable descriptions for weather condition codes in English.
+ */
+export const CONDITION_DESCRIPTIONS = {
+    'clear': 'Clear',
+    'partly-cloudy': 'Partly cloudy',
+    'variable-cloudiness': 'Variable cloudiness',
+    'cloudy-with-sunny-intervals': 'Cloudy with sunny intervals',
+    'cloudy': 'Cloudy',
+    'rain-showers': 'Rain showers',
+    'light-rain-at-times': 'Light rain at times',
+    'rain-at-times': 'Rain at times',
+    'light-rain': 'Light rain',
+    'rain': 'Rain',
+    'heavy-rain': 'Heavy rain',
+    'thunder': 'Thunder',
+    'isolated-thunderstorms': 'Isolated thunderstorms',
+    'thunderstorms': 'Thunderstorms',
+    'heavy-rain-with-thunderstorms': 'Heavy rain with thunderstorms',
+    'sleet-showers': 'Sleet showers',
+    'sleet-at-times': 'Sleet at times',
+    'light-sleet': 'Light sleet',
+    'sleet': 'Sleet',
+    'freezing-rain': 'Freezing rain',
+    'hail': 'Hail',
+    'snow-showers': 'Snow showers',
+    'light-snow-at-times': 'Light snow at times',
+    'snow-at-times': 'Snow at times',
+    'light-snow': 'Light snow',
+    'snow': 'Snow',
+    'heavy-snow': 'Heavy snow',
+    'snowstorm': 'Snowstorm',
+    'fog': 'Fog',
+    'squall': 'Squall',
+};
+/**
+ * Gets the human-readable description for a condition code.
+ * @param code - The condition code
+ * @returns Human-readable description or 'Unknown' if not found
+ */
+export function getConditionDescription(code) {
+    if (code === null)
+        return 'Unknown';
+    return CONDITION_DESCRIPTIONS[code] ?? 'Unknown';
+}
+//# sourceMappingURL=conditions.js.map

package/dist/types/conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../src/types/conditions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO;IACP,eAAe;IACf,6BAA6B;IAC7B,QAAQ;IACR,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,SAAS;IACT,wBAAwB;IACxB,eAAe;IACf,+BAA+B;IAC/B,aAAa;IACb,OAAO;IACP,eAAe;IACf,MAAM;IACN,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,KAAK;CACG,CAAC;AAQX;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,OAAO;IACP,eAAe;IACf,qBAAqB;IACrB,6BAA6B;IAC7B,QAAQ;IACR,cAAc;IACd,qBAAqB;IACrB,eAAe;IACf,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,SAAS;IACT,wBAAwB;IACxB,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,aAAa;IACb,OAAO;IACP,eAAe;IACf,MAAM;IACN,cAAc;IACd,qBAAqB;IACrB,eAAe;IACf,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,WAAW;IACX,KAAK;IACL,QAAQ;CACA,CAAC;AAQX;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ;QAC7B,wBAA8C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ;QAC7B,2BAAiD,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAqC;IACtE,OAAO,EAAE,OAAO;IAChB,eAAe,EAAE,eAAe;IAChC,qBAAqB,EAAE,qBAAqB;IAC5C,6BAA6B,EAAE,6BAA6B;IAC5D,QAAQ,EAAE,QAAQ;IAClB,cAAc,EAAE,cAAc;IAC9B,qBAAqB,EAAE,qBAAqB;IAC5C,eAAe,EAAE,eAAe;IAChC,YAAY,EAAE,YAAY;IAC1B,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,YAAY;IAC1B,SAAS,EAAE,SAAS;IACpB,wBAAwB,EAAE,wBAAwB;IAClD,eAAe,EAAE,eAAe;IAChC,+BAA+B,EAAE,+BAA+B;IAChE,eAAe,EAAE,eAAe;IAChC,gBAAgB,EAAE,gBAAgB;IAClC,aAAa,EAAE,aAAa;IAC5B,OAAO,EAAE,OAAO;IAChB,eAAe,EAAE,eAAe;IAChC,MAAM,EAAE,MAAM;IACd,cAAc,EAAE,cAAc;IAC9B,qBAAqB,EAAE,qBAAqB;IAC5C,eAAe,EAAE,eAAe;IAChC,YAAY,EAAE,YAAY;IAC1B,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,YAAY;IAC1B,WAAW,EAAE,WAAW;IACxB,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,QAAQ;CACV,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAsD;IAC5F,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO,sBAAsB,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AACnD,CAAC"}

package/dist/types/coordinates.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Coordinate types for WGS84 geographic coordinates.
+ * @module meteo-lt-sdk/types/coordinates
+ */
+/**
+ * Branded type for latitude values in decimal degrees.
+ * Valid range: -90 to 90
+ */
+export type Latitude = number & {
+    readonly __brand: 'Latitude';
+};
+/**
+ * Branded type for longitude values in decimal degrees.
+ * Valid range: -180 to 180
+ */
+export type Longitude = number & {
+    readonly __brand: 'Longitude';
+};
+/**
+ * Geographic coordinates in WGS84 decimal degrees format.
+ * Used throughout the API for location data.
+ */
+export interface Coordinates {
+    /** Latitude in decimal degrees (-90 to 90) */
+    readonly latitude: Latitude;
+    /** Longitude in decimal degrees (-180 to 180) */
+    readonly longitude: Longitude;
+}
+/**
+ * Type guard to check if a number is a valid latitude value.
+ * @param value - The value to check
+ * @returns True if the value is a valid latitude (-90 to 90)
+ */
+export declare function isValidLatitude(value: number): value is Latitude;
+/**
+ * Type guard to check if a number is a valid longitude value.
+ * @param value - The value to check
+ * @returns True if the value is a valid longitude (-180 to 180)
+ */
+export declare function isValidLongitude(value: number): value is Longitude;
+/**
+ * Creates a branded Latitude value from a number.
+ * @param value - The latitude value in decimal degrees
+ * @returns Branded Latitude value
+ * @throws {RangeError} If the value is outside the valid range
+ */
+export declare function createLatitude(value: number): Latitude;
+/**
+ * Creates a branded Longitude value from a number.
+ * @param value - The longitude value in decimal degrees
+ * @returns Branded Longitude value
+ * @throws {RangeError} If the value is outside the valid range
+ */
+export declare function createLongitude(value: number): Longitude;
+/**
+ * Creates a Coordinates object from latitude and longitude values.
+ * @param latitude - The latitude value in decimal degrees
+ * @param longitude - The longitude value in decimal degrees
+ * @returns Coordinates object with branded latitude and longitude
+ * @throws {RangeError} If either value is outside the valid range
+ */
+export declare function createCoordinates(latitude: number, longitude: number): Coordinates;
+//# sourceMappingURL=coordinates.d.ts.map

package/dist/types/coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.d.ts","sourceRoot":"","sources":["../../src/types/coordinates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAKtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAKxD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAKlF"}

package/dist/types/coordinates.js

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Coordinate types for WGS84 geographic coordinates.
+ * @module meteo-lt-sdk/types/coordinates
+ */
+/**
+ * Type guard to check if a number is a valid latitude value.
+ * @param value - The value to check
+ * @returns True if the value is a valid latitude (-90 to 90)
+ */
+export function isValidLatitude(value) {
+    return value >= -90 && value <= 90;
+}
+/**
+ * Type guard to check if a number is a valid longitude value.
+ * @param value - The value to check
+ * @returns True if the value is a valid longitude (-180 to 180)
+ */
+export function isValidLongitude(value) {
+    return value >= -180 && value <= 180;
+}
+/**
+ * Creates a branded Latitude value from a number.
+ * @param value - The latitude value in decimal degrees
+ * @returns Branded Latitude value
+ * @throws {RangeError} If the value is outside the valid range
+ */
+export function createLatitude(value) {
+    if (!isValidLatitude(value)) {
+        throw new RangeError(`Latitude must be between -90 and 90, got: ${String(value)}`);
+    }
+    return value;
+}
+/**
+ * Creates a branded Longitude value from a number.
+ * @param value - The longitude value in decimal degrees
+ * @returns Branded Longitude value
+ * @throws {RangeError} If the value is outside the valid range
+ */
+export function createLongitude(value) {
+    if (!isValidLongitude(value)) {
+        throw new RangeError(`Longitude must be between -180 and 180, got: ${String(value)}`);
+    }
+    return value;
+}
+/**
+ * Creates a Coordinates object from latitude and longitude values.
+ * @param latitude - The latitude value in decimal degrees
+ * @param longitude - The longitude value in decimal degrees
+ * @returns Coordinates object with branded latitude and longitude
+ * @throws {RangeError} If either value is outside the valid range
+ */
+export function createCoordinates(latitude, longitude) {
+    return {
+        latitude: createLatitude(latitude),
+        longitude: createLongitude(longitude),
+    };
+}
+//# sourceMappingURL=coordinates.js.map

package/dist/types/coordinates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.js","sourceRoot":"","sources":["../../src/types/coordinates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyBH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,IAAI,CAAC,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,GAAG,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,6CAA6C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,UAAU,CAAC,gDAAgD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,SAAiB;IACnE,OAAO;QACL,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;QAClC,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @fileoverview Error types for the Meteo.lt SDK.
+ * @module meteo-lt-sdk/types/errors
+ */
+/**
+ * Base error class for all Meteo.lt API errors.
+ * Contains the HTTP status code and response body for debugging.
+ */
+export declare class MeteoApiError extends Error {
+    readonly statusCode: number;
+    readonly responseBody?: string | undefined;
+    /** Error name for instanceof checks */
+    readonly name: string;
+    /**
+     * Creates a new MeteoApiError.
+     * @param message - Human-readable error message
+     * @param statusCode - HTTP status code from the API response
+     * @param responseBody - Raw response body for debugging
+     */
+    constructor(message: string, statusCode: number, responseBody?: string | undefined);
+}
+/**
+ * Error thrown when a requested resource is not found (HTTP 404).
+ * This can occur when:
+ * - A place code doesn't exist
+ * - A station code doesn't exist
+ * - No observations exist for the requested date
+ */
+export declare class MeteoNotFoundError extends MeteoApiError {
+    readonly resource: string;
+    readonly name: string;
+    /**
+     * Creates a new MeteoNotFoundError.
+     * @param resource - Description of the resource that wasn't found
+     * @param responseBody - Raw response body for debugging
+     */
+    constructor(resource: string, responseBody?: string);
+}
+/**
+ * Error thrown when the rate limit is exceeded (HTTP 429).
+ * The API limits requests to 180 per minute per IP address.
+ */
+export declare class MeteoRateLimitError extends MeteoApiError {
+    readonly retryAfterSeconds?: number | undefined;
+    readonly name: string;
+    /**
+     * Creates a new MeteoRateLimitError.
+     * @param retryAfterSeconds - Seconds to wait before retrying (if provided by API)
+     * @param responseBody - Raw response body for debugging
+     */
+    constructor(retryAfterSeconds?: number | undefined, responseBody?: string);
+}
+/**
+ * Error thrown when response validation fails.
+ * This indicates the API returned data that doesn't match the expected schema.
+ */
+export declare class MeteoValidationError extends MeteoApiError {
+    readonly validationErrors: readonly string[];
+    readonly name: string;
+    /**
+     * Creates a new MeteoValidationError.
+     * @param message - Description of what validation failed
+     * @param validationErrors - Detailed validation error information
+     * @param responseBody - Raw response body for debugging
+     */
+    constructor(message: string, validationErrors: readonly string[], responseBody?: string);
+}
+/**
+ * Error thrown when a network request fails.
+ * This wraps fetch errors for consistent error handling.
+ */
+export declare class MeteoNetworkError extends MeteoApiError {
+    readonly cause?: Error | undefined;
+    readonly name: string;
+    /**
+     * Creates a new MeteoNetworkError.
+     * @param message - Description of the network error
+     * @param cause - Original error that caused this error
+     */
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Error thrown when a request times out.
+ */
+export declare class MeteoTimeoutError extends MeteoApiError {
+    readonly timeoutMs: number;
+    readonly name: string;
+    /**
+     * Creates a new MeteoTimeoutError.
+     * @param timeoutMs - The timeout value in milliseconds
+     */
+    constructor(timeoutMs: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAYpB,UAAU,EAAE,MAAM;aAClB,YAAY,CAAC,EAAE,MAAM;IAZvC,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAmB;IAExC;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,YAAA;CAIxC;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;aASjC,QAAQ,EAAE,MAAM;IARlC,SAAkB,IAAI,EAAE,MAAM,CAAwB;IAEtD;;;;OAIG;gBAEe,QAAQ,EAAE,MAAM,EAChC,YAAY,CAAC,EAAE,MAAM;CAIxB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;aASlC,iBAAiB,CAAC,EAAE,MAAM;IAR5C,SAAkB,IAAI,EAAE,MAAM,CAAyB;IAEvD;;;;OAIG;gBAEe,iBAAiB,CAAC,EAAE,MAAM,YAAA,EAC1C,YAAY,CAAC,EAAE,MAAM;CAOxB;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;aAWnC,gBAAgB,EAAE,SAAS,MAAM,EAAE;IAVrD,SAAkB,IAAI,EAAE,MAAM,CAA0B;IAExD;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACC,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnD,YAAY,CAAC,EAAE,MAAM;CAIxB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;aAUhC,KAAK,CAAC,EAAE,KAAK;IAT/B,SAAkB,IAAI,EAAE,MAAM,CAAuB;IAErD;;;;OAIG;gBAED,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAIhC;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;aAOtB,SAAS,EAAE,MAAM;IAN7C,SAAkB,IAAI,EAAE,MAAM,CAAuB;IAErD;;;OAGG;gBACyB,SAAS,EAAE,MAAM;CAG9C"}

package/dist/types/errors.js

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Error types for the Meteo.lt SDK.
+ * @module meteo-lt-sdk/types/errors
+ */
+/**
+ * Base error class for all Meteo.lt API errors.
+ * Contains the HTTP status code and response body for debugging.
+ */
+export class MeteoApiError extends Error {
+    statusCode;
+    responseBody;
+    /** Error name for instanceof checks */
+    name = 'MeteoApiError';
+    /**
+     * Creates a new MeteoApiError.
+     * @param message - Human-readable error message
+     * @param statusCode - HTTP status code from the API response
+     * @param responseBody - Raw response body for debugging
+     */
+    constructor(message, statusCode, responseBody) {
+        super(message);
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+    }
+}
+/**
+ * Error thrown when a requested resource is not found (HTTP 404).
+ * This can occur when:
+ * - A place code doesn't exist
+ * - A station code doesn't exist
+ * - No observations exist for the requested date
+ */
+export class MeteoNotFoundError extends MeteoApiError {
+    resource;
+    name = 'MeteoNotFoundError';
+    /**
+     * Creates a new MeteoNotFoundError.
+     * @param resource - Description of the resource that wasn't found
+     * @param responseBody - Raw response body for debugging
+     */
+    constructor(resource, responseBody) {
+        super(`Resource not found: ${resource}`, 404, responseBody);
+        this.resource = resource;
+    }
+}
+/**
+ * Error thrown when the rate limit is exceeded (HTTP 429).
+ * The API limits requests to 180 per minute per IP address.
+ */
+export class MeteoRateLimitError extends MeteoApiError {
+    retryAfterSeconds;
+    name = 'MeteoRateLimitError';
+    /**
+     * Creates a new MeteoRateLimitError.
+     * @param retryAfterSeconds - Seconds to wait before retrying (if provided by API)
+     * @param responseBody - Raw response body for debugging
+     */
+    constructor(retryAfterSeconds, responseBody) {
+        const retryMessage = retryAfterSeconds !== undefined
+            ? `. Retry after ${String(retryAfterSeconds)} seconds`
+            : '';
+        super(`Rate limit exceeded${retryMessage}`, 429, responseBody);
+        this.retryAfterSeconds = retryAfterSeconds;
+    }
+}
+/**
+ * Error thrown when response validation fails.
+ * This indicates the API returned data that doesn't match the expected schema.
+ */
+export class MeteoValidationError extends MeteoApiError {
+    validationErrors;
+    name = 'MeteoValidationError';
+    /**
+     * Creates a new MeteoValidationError.
+     * @param message - Description of what validation failed
+     * @param validationErrors - Detailed validation error information
+     * @param responseBody - Raw response body for debugging
+     */
+    constructor(message, validationErrors, responseBody) {
+        super(`Validation failed: ${message}`, 0, responseBody);
+        this.validationErrors = validationErrors;
+    }
+}
+/**
+ * Error thrown when a network request fails.
+ * This wraps fetch errors for consistent error handling.
+ */
+export class MeteoNetworkError extends MeteoApiError {
+    cause;
+    name = 'MeteoNetworkError';
+    /**
+     * Creates a new MeteoNetworkError.
+     * @param message - Description of the network error
+     * @param cause - Original error that caused this error
+     */
+    constructor(message, cause) {
+        super(`Network error: ${message}`, 0);
+        this.cause = cause;
+    }
+}
+/**
+ * Error thrown when a request times out.
+ */
+export class MeteoTimeoutError extends MeteoApiError {
+    timeoutMs;
+    name = 'MeteoTimeoutError';
+    /**
+     * Creates a new MeteoTimeoutError.
+     * @param timeoutMs - The timeout value in milliseconds
+     */
+    constructor(timeoutMs) {
+        super(`Request timed out after ${String(timeoutMs)}ms`, 0);
+        this.timeoutMs = timeoutMs;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAYpB;IACA;IAZlB,uCAAuC;IAC9B,IAAI,GAAW,eAAe,CAAC;IAExC;;;;;OAKG;IACH,YACE,OAAe,EACC,UAAkB,EAClB,YAAqB;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QAClB,iBAAY,GAAZ,YAAY,CAAS;IAGvC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IASjC;IARA,IAAI,GAAW,oBAAoB,CAAC;IAEtD;;;;OAIG;IACH,YACkB,QAAgB,EAChC,YAAqB;QAErB,KAAK,CAAC,uBAAuB,QAAQ,EAAE,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QAH5C,aAAQ,GAAR,QAAQ,CAAQ;IAIlC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IASlC;IARA,IAAI,GAAW,qBAAqB,CAAC;IAEvD;;;;OAIG;IACH,YACkB,iBAA0B,EAC1C,YAAqB;QAErB,MAAM,YAAY,GAAG,iBAAiB,KAAK,SAAS;YAClD,CAAC,CAAC,iBAAiB,MAAM,CAAC,iBAAiB,CAAC,UAAU;YACtD,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,CAAC,sBAAsB,YAAY,EAAE,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC;QAN/C,sBAAiB,GAAjB,iBAAiB,CAAS;IAO5C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IAWnC;IAVA,IAAI,GAAW,sBAAsB,CAAC;IAExD;;;;;OAKG;IACH,YACE,OAAe,EACC,gBAAmC,EACnD,YAAqB;QAErB,KAAK,CAAC,sBAAsB,OAAO,EAAE,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;QAHxC,qBAAgB,GAAhB,gBAAgB,CAAmB;IAIrD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAUhC;IATA,IAAI,GAAW,mBAAmB,CAAC;IAErD;;;;OAIG;IACH,YACE,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,kBAAkB,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAFtB,UAAK,GAAL,KAAK,CAAQ;IAG/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAOtB;IANV,IAAI,GAAW,mBAAmB,CAAC;IAErD;;;OAGG;IACH,YAA4B,SAAiB;QAC3C,KAAK,CAAC,2BAA2B,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QADjC,cAAS,GAAT,SAAS,CAAQ;IAE7C,CAAC;CACF"}

package/dist/types/forecasts.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Forecast data types for weather predictions.
+ * @module meteo-lt-sdk/types/forecasts
+ */
+import type { ForecastConditionCode } from './conditions.js';
+import type { PlaceDetails, ForecastType } from './places.js';
+/**
+ * A single forecast timestamp with all weather parameters.
+ * Represents predicted weather conditions for a specific point in time.
+ */
+export interface ForecastTimestamp {
+    /** Forecast time in UTC (ISO 8601 format) */
+    readonly forecastTimeUtc: string;
+    /** Air temperature in degrees Celsius */
+    readonly airTemperature: number;
+    /** Feels-like temperature in degrees Celsius */
+    readonly feelsLikeTemperature: number;
+    /** Wind speed in meters per second */
+    readonly windSpeed: number;
+    /** Maximum wind gust in m/s (max over 1h when step is 1h, 3h when step is 3h, etc.) */
+    readonly windGust: number;
+    /** Wind direction in degrees (0 = from north, 180 = from south) */
+    readonly windDirection: number;
+    /** Cloud cover percentage (0 = clear, 100 = overcast) */
+    readonly cloudCover: number;
+    /** Atmospheric pressure at sea level in hPa */
+    readonly seaLevelPressure: number;
+    /** Relative humidity percentage */
+    readonly relativeHumidity: number;
+    /** Total precipitation in mm (sum over 1h when step is 1h, 3h when step is 3h, etc.) */
+    readonly totalPrecipitation: number;
+    /** Weather condition code */
+    readonly conditionCode: ForecastConditionCode;
+}
+/**
+ * Complete forecast response for a place.
+ * Returned by GET /places/{place-code}/forecasts/{forecast-type} endpoint.
+ */
+export interface Forecast {
+    /** Place information */
+    readonly place: PlaceDetails;
+    /** Type of forecast */
+    readonly forecastType: ForecastType;
+    /** When the forecast was created (UTC, ISO 8601 format) */
+    readonly forecastCreationTimeUtc: string;
+    /** Array of forecast data points */
+    readonly forecastTimestamps: readonly ForecastTimestamp[];
+}
+//# sourceMappingURL=forecasts.d.ts.map