@tiangong-ai/cli 0.0.51 → 0.0.55

package/dist/data/connectors/open-meteo-historical-weather.schemas.d.ts

@@ -0,0 +1,420 @@
+export declare const OPEN_METEO_HISTORICAL_HOURLY_VARIABLES: readonly ["cloud_cover", "precipitation", "pressure_msl", "rain", "relative_humidity_2m", "shortwave_radiation", "snowfall", "soil_moisture_0_to_7cm", "soil_temperature_0_to_7cm", "temperature_2m", "wind_direction_10m", "wind_speed_10m"];
+export declare const OPEN_METEO_HISTORICAL_DAILY_VARIABLES: readonly ["apparent_temperature_max", "apparent_temperature_min", "et0_fao_evapotranspiration", "precipitation_hours", "precipitation_sum", "rain_sum", "snowfall_sum", "sunshine_duration", "temperature_2m_max", "temperature_2m_min", "weather_code", "wind_speed_10m_max"];
+export declare const OPEN_METEO_HISTORICAL_MODELS: readonly ["best_match", "cerra", "ecmwf_ifs", "ecmwf_ifs_analysis_long_window", "era5", "era5_ensemble", "era5_land", "era5_seamless"];
+export declare const OPEN_METEO_HISTORICAL_WEATHER_INPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/open-meteo/historical-weather-input.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["locations", "startDate", "endDate", "hourlyVariables", "dailyVariables"];
+    readonly properties: {
+        readonly locations: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 10;
+            readonly description: "One to ten coordinates. Results preserve request order and separately report the selected model-grid coordinate.";
+            readonly examples: readonly [readonly [{
+                readonly latitude: 52.52;
+                readonly longitude: 13.41;
+            }]];
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["latitude", "longitude"];
+                readonly description: "One WGS84 coordinate for historical weather reanalysis grid selection.";
+                readonly examples: readonly [{
+                    readonly latitude: 52.52;
+                    readonly longitude: 13.41;
+                }];
+                readonly properties: {
+                    readonly latitude: {
+                        readonly type: "number";
+                        readonly minimum: -90;
+                        readonly maximum: 90;
+                        readonly description: "Requested WGS84 latitude in decimal degrees.";
+                        readonly examples: readonly [52.52];
+                    };
+                    readonly longitude: {
+                        readonly type: "number";
+                        readonly minimum: -180;
+                        readonly maximum: 180;
+                        readonly description: "Requested WGS84 longitude in decimal degrees.";
+                        readonly examples: readonly [13.41];
+                    };
+                };
+            };
+        };
+        readonly startDate: {
+            readonly type: "string";
+            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+            readonly description: "Inclusive first historical date in YYYY-MM-DD form. Together with endDate, the window may contain at most 366 dates.";
+            readonly examples: readonly ["2024-01-01"];
+        };
+        readonly endDate: {
+            readonly type: "string";
+            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+            readonly description: "Inclusive last historical date in YYYY-MM-DD form; it must not precede startDate.";
+            readonly examples: readonly ["2024-01-31"];
+        };
+        readonly hourlyVariables: {
+            readonly type: "array";
+            readonly maxItems: 12;
+            readonly uniqueItems: true;
+            readonly description: "Zero to twelve curated Open-Meteo hourly historical-weather variable codes. Use an empty array for daily-only retrieval.";
+            readonly examples: readonly [readonly ["temperature_2m", "precipitation"]];
+            readonly items: {
+                readonly enum: readonly ["cloud_cover", "precipitation", "pressure_msl", "rain", "relative_humidity_2m", "shortwave_radiation", "snowfall", "soil_moisture_0_to_7cm", "soil_temperature_0_to_7cm", "temperature_2m", "wind_direction_10m", "wind_speed_10m"];
+                readonly description: "One documented hourly historical-weather variable code.";
+                readonly examples: readonly ["temperature_2m"];
+            };
+            readonly minItems: 0;
+        };
+        readonly dailyVariables: {
+            readonly type: "array";
+            readonly maxItems: 12;
+            readonly uniqueItems: true;
+            readonly description: "Zero to twelve curated numeric Open-Meteo daily historical-weather variable codes. Use an empty array for hourly-only retrieval.";
+            readonly examples: readonly [readonly ["temperature_2m_max", "precipitation_sum"]];
+            readonly items: {
+                readonly enum: readonly ["apparent_temperature_max", "apparent_temperature_min", "et0_fao_evapotranspiration", "precipitation_hours", "precipitation_sum", "rain_sum", "snowfall_sum", "sunshine_duration", "temperature_2m_max", "temperature_2m_min", "weather_code", "wind_speed_10m_max"];
+                readonly description: "One documented numeric daily historical-weather variable code.";
+                readonly examples: readonly ["temperature_2m_max"];
+            };
+            readonly minItems: 0;
+        };
+        readonly model: {
+            readonly enum: readonly ["best_match", "cerra", "ecmwf_ifs", "ecmwf_ifs_analysis_long_window", "era5", "era5_ensemble", "era5_land", "era5_seamless"];
+            readonly description: "One provider model. best_match favors current local detail; use ERA5 or ERA5-Land for a consistent multi-decade series.";
+            readonly examples: readonly ["era5"];
+        };
+        readonly cellSelection: {
+            readonly enum: readonly ["land", "nearest", "sea"];
+            readonly description: "Grid-cell preference around each coordinate. land is the deterministic default; nearest or sea may select a different grid cell.";
+            readonly examples: readonly ["land"];
+        };
+    };
+};
+export declare const OPEN_METEO_HISTORICAL_WEATHER_OUTPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/open-meteo/historical-weather-output.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["source", "request", "validation", "locations", "stopReason"];
+    readonly properties: {
+        readonly source: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["providerId", "service", "endpoint", "model", "reanalysis", "timezone"];
+            readonly properties: {
+                readonly providerId: {
+                    readonly const: "open-meteo";
+                };
+                readonly service: {
+                    readonly const: "Historical Weather API";
+                };
+                readonly endpoint: {
+                    readonly const: "/v1/archive";
+                };
+                readonly model: {
+                    readonly enum: readonly ["best_match", "cerra", "ecmwf_ifs", "ecmwf_ifs_analysis_long_window", "era5", "era5_ensemble", "era5_land", "era5_seamless"];
+                };
+                readonly reanalysis: {
+                    readonly const: true;
+                };
+                readonly timezone: {
+                    readonly const: "GMT";
+                };
+            };
+        };
+        readonly request: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["locations", "startDate", "endDate", "hourlyVariables", "dailyVariables", "model", "cellSelection", "timezone", "temperatureUnit", "windSpeedUnit", "precipitationUnit"];
+            readonly properties: {
+                readonly locations: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 10;
+                    readonly description: "One to ten coordinates. Results preserve request order and separately report the selected model-grid coordinate.";
+                    readonly examples: readonly [readonly [{
+                        readonly latitude: 52.52;
+                        readonly longitude: 13.41;
+                    }]];
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["latitude", "longitude"];
+                        readonly description: "One WGS84 coordinate for historical weather reanalysis grid selection.";
+                        readonly examples: readonly [{
+                            readonly latitude: 52.52;
+                            readonly longitude: 13.41;
+                        }];
+                        readonly properties: {
+                            readonly latitude: {
+                                readonly type: "number";
+                                readonly minimum: -90;
+                                readonly maximum: 90;
+                                readonly description: "Requested WGS84 latitude in decimal degrees.";
+                                readonly examples: readonly [52.52];
+                            };
+                            readonly longitude: {
+                                readonly type: "number";
+                                readonly minimum: -180;
+                                readonly maximum: 180;
+                                readonly description: "Requested WGS84 longitude in decimal degrees.";
+                                readonly examples: readonly [13.41];
+                            };
+                        };
+                    };
+                };
+                readonly startDate: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                    readonly description: "Inclusive first historical date in YYYY-MM-DD form. Together with endDate, the window may contain at most 366 dates.";
+                    readonly examples: readonly ["2024-01-01"];
+                };
+                readonly endDate: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                    readonly description: "Inclusive last historical date in YYYY-MM-DD form; it must not precede startDate.";
+                    readonly examples: readonly ["2024-01-31"];
+                };
+                readonly hourlyVariables: {
+                    readonly type: "array";
+                    readonly maxItems: 12;
+                    readonly uniqueItems: true;
+                    readonly description: "Zero to twelve curated Open-Meteo hourly historical-weather variable codes. Use an empty array for daily-only retrieval.";
+                    readonly examples: readonly [readonly ["temperature_2m", "precipitation"]];
+                    readonly items: {
+                        readonly enum: readonly ["cloud_cover", "precipitation", "pressure_msl", "rain", "relative_humidity_2m", "shortwave_radiation", "snowfall", "soil_moisture_0_to_7cm", "soil_temperature_0_to_7cm", "temperature_2m", "wind_direction_10m", "wind_speed_10m"];
+                        readonly description: "One documented hourly historical-weather variable code.";
+                        readonly examples: readonly ["temperature_2m"];
+                    };
+                    readonly minItems: 0;
+                };
+                readonly dailyVariables: {
+                    readonly type: "array";
+                    readonly maxItems: 12;
+                    readonly uniqueItems: true;
+                    readonly description: "Zero to twelve curated numeric Open-Meteo daily historical-weather variable codes. Use an empty array for hourly-only retrieval.";
+                    readonly examples: readonly [readonly ["temperature_2m_max", "precipitation_sum"]];
+                    readonly items: {
+                        readonly enum: readonly ["apparent_temperature_max", "apparent_temperature_min", "et0_fao_evapotranspiration", "precipitation_hours", "precipitation_sum", "rain_sum", "snowfall_sum", "sunshine_duration", "temperature_2m_max", "temperature_2m_min", "weather_code", "wind_speed_10m_max"];
+                        readonly description: "One documented numeric daily historical-weather variable code.";
+                        readonly examples: readonly ["temperature_2m_max"];
+                    };
+                    readonly minItems: 0;
+                };
+                readonly model: {
+                    readonly enum: readonly ["best_match", "cerra", "ecmwf_ifs", "ecmwf_ifs_analysis_long_window", "era5", "era5_ensemble", "era5_land", "era5_seamless"];
+                };
+                readonly cellSelection: {
+                    readonly enum: readonly ["land", "nearest", "sea"];
+                };
+                readonly timezone: {
+                    readonly const: "GMT";
+                };
+                readonly temperatureUnit: {
+                    readonly const: "celsius";
+                };
+                readonly windSpeedUnit: {
+                    readonly const: "kmh";
+                };
+                readonly precipitationUnit: {
+                    readonly const: "mm";
+                };
+            };
+        };
+        readonly validation: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["issueCount", "issues"];
+            readonly properties: {
+                readonly issueCount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+                readonly issues: {
+                    readonly type: "array";
+                    readonly maxItems: 50;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["path", "message"];
+                        readonly properties: {
+                            readonly path: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly message: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly locations: {
+            readonly type: "array";
+            readonly maxItems: 10;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["requestedLocationIndex", "requestedLocation", "gridLocation", "elevation", "timezone", "timezoneAbbreviation", "utcOffsetSeconds", "hourly", "daily"];
+                readonly properties: {
+                    readonly requestedLocationIndex: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 9;
+                    };
+                    readonly requestedLocation: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["latitude", "longitude"];
+                        readonly description: "One WGS84 coordinate for historical weather reanalysis grid selection.";
+                        readonly examples: readonly [{
+                            readonly latitude: 52.52;
+                            readonly longitude: 13.41;
+                        }];
+                        readonly properties: {
+                            readonly latitude: {
+                                readonly type: "number";
+                                readonly minimum: -90;
+                                readonly maximum: 90;
+                                readonly description: "Requested WGS84 latitude in decimal degrees.";
+                                readonly examples: readonly [52.52];
+                            };
+                            readonly longitude: {
+                                readonly type: "number";
+                                readonly minimum: -180;
+                                readonly maximum: 180;
+                                readonly description: "Requested WGS84 longitude in decimal degrees.";
+                                readonly examples: readonly [13.41];
+                            };
+                        };
+                    };
+                    readonly gridLocation: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["latitude", "longitude"];
+                        readonly description: "One WGS84 coordinate for historical weather reanalysis grid selection.";
+                        readonly examples: readonly [{
+                            readonly latitude: 52.52;
+                            readonly longitude: 13.41;
+                        }];
+                        readonly properties: {
+                            readonly latitude: {
+                                readonly type: "number";
+                                readonly minimum: -90;
+                                readonly maximum: 90;
+                                readonly description: "Requested WGS84 latitude in decimal degrees.";
+                                readonly examples: readonly [52.52];
+                            };
+                            readonly longitude: {
+                                readonly type: "number";
+                                readonly minimum: -180;
+                                readonly maximum: 180;
+                                readonly description: "Requested WGS84 longitude in decimal degrees.";
+                                readonly examples: readonly [13.41];
+                            };
+                        };
+                    };
+                    readonly elevation: {
+                        readonly type: readonly ["number", "null"];
+                    };
+                    readonly timezone: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly timezoneAbbreviation: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly utcOffsetSeconds: {
+                        readonly type: "integer";
+                    };
+                    readonly hourly: {
+                        readonly type: readonly ["object", "null"];
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["timesUtc", "variables"];
+                        readonly properties: {
+                            readonly timesUtc: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                    readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$";
+                                };
+                            };
+                            readonly variables: {
+                                readonly type: "array";
+                                readonly maxItems: 12;
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["variable", "unit", "values"];
+                                    readonly properties: {
+                                        readonly variable: {
+                                            readonly enum: readonly ["cloud_cover", "precipitation", "pressure_msl", "rain", "relative_humidity_2m", "shortwave_radiation", "snowfall", "soil_moisture_0_to_7cm", "soil_temperature_0_to_7cm", "temperature_2m", "wind_direction_10m", "wind_speed_10m"];
+                                        };
+                                        readonly unit: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly values: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: readonly ["number", "null"];
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly daily: {
+                        readonly type: readonly ["object", "null"];
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["dates", "variables"];
+                        readonly properties: {
+                            readonly dates: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                    readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                };
+                            };
+                            readonly variables: {
+                                readonly type: "array";
+                                readonly maxItems: 12;
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["variable", "unit", "values"];
+                                    readonly properties: {
+                                        readonly variable: {
+                                            readonly enum: readonly ["apparent_temperature_max", "apparent_temperature_min", "et0_fao_evapotranspiration", "precipitation_hours", "precipitation_sum", "rain_sum", "snowfall_sum", "sunshine_duration", "temperature_2m_max", "temperature_2m_min", "weather_code", "wind_speed_10m_max"];
+                                        };
+                                        readonly unit: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly values: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: readonly ["number", "null"];
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly stopReason: {
+            readonly enum: readonly ["completed", "max-records", "partial"];
+        };
+    };
+};