@tiangong-ai/cli 0.0.50 → 0.0.55

package/dist/data/connectors/openaq-air-quality.schemas.d.ts

@@ -0,0 +1,1067 @@
+export declare const OPENAQ_LOCATION_SEARCH_INPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/openaq/location-search-input.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly countryCode: {
+            readonly type: "string";
+            readonly pattern: "^[A-Z]{2}$";
+            readonly description: "One ISO 3166-1 alpha-2 country code used to narrow locations.";
+            readonly examples: readonly ["NL"];
+        };
+        readonly countryIds: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 25;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly type: "integer";
+                readonly minimum: 1;
+            };
+            readonly description: "One or more OpenAQ country IDs, normalized into ascending order.";
+            readonly examples: readonly [readonly [7]];
+        };
+        readonly providerIds: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 25;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly type: "integer";
+                readonly minimum: 1;
+            };
+            readonly description: "One or more OpenAQ data-provider IDs, normalized into ascending order.";
+            readonly examples: readonly [readonly [51, 52]];
+        };
+        readonly parameterIds: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 25;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly type: "integer";
+                readonly minimum: 1;
+            };
+            readonly description: "One or more OpenAQ pollutant or parameter IDs measured at the location.";
+            readonly examples: readonly [readonly [1, 2]];
+        };
+        readonly licenseIds: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 25;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly type: "integer";
+                readonly minimum: 1;
+            };
+            readonly description: "One or more OpenAQ license IDs used to filter location data terms.";
+            readonly examples: readonly [readonly [81]];
+        };
+        readonly monitor: {
+            readonly type: "boolean";
+            readonly description: "Filter by OpenAQ's reference-monitor classification.";
+            readonly examples: readonly [true];
+        };
+        readonly mobile: {
+            readonly type: "boolean";
+            readonly description: "Filter mobile or stationary OpenAQ locations.";
+            readonly examples: readonly [false];
+        };
+        readonly center: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["latitude", "longitude", "radiusMeters"];
+            readonly description: "One WGS84 center and radius search. Do not combine it with boundingBox; OpenAQ limits the radius to 25 km.";
+            readonly examples: readonly [{
+                readonly latitude: 52.37;
+                readonly longitude: 4.9;
+                readonly radiusMeters: 5000;
+            }];
+            readonly properties: {
+                readonly latitude: {
+                    readonly type: "number";
+                    readonly minimum: -90;
+                    readonly maximum: 90;
+                    readonly description: "Center latitude in WGS84 decimal degrees.";
+                    readonly examples: readonly [52.37];
+                };
+                readonly longitude: {
+                    readonly type: "number";
+                    readonly minimum: -180;
+                    readonly maximum: 180;
+                    readonly description: "Center longitude in WGS84 decimal degrees.";
+                    readonly examples: readonly [4.9];
+                };
+                readonly radiusMeters: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 25000;
+                    readonly description: "Search radius in meters, capped by OpenAQ at 25,000.";
+                    readonly examples: readonly [5000];
+                };
+            };
+        };
+        readonly boundingBox: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["west", "south", "east", "north"];
+            readonly description: "One non-antimeridian WGS84 bounding box. Do not combine it with center; the CLI rejects world-scale scans.";
+            readonly examples: readonly [{
+                readonly west: 4.7;
+                readonly south: 52.25;
+                readonly east: 5.05;
+                readonly north: 52.5;
+            }];
+            readonly properties: {
+                readonly west: {
+                    readonly type: "number";
+                    readonly minimum: -180;
+                    readonly maximum: 180;
+                    readonly description: "Western longitude; it must be lower than east.";
+                    readonly examples: readonly [4.7];
+                };
+                readonly south: {
+                    readonly type: "number";
+                    readonly minimum: -90;
+                    readonly maximum: 90;
+                    readonly description: "Southern latitude; it must be lower than north.";
+                    readonly examples: readonly [52.25];
+                };
+                readonly east: {
+                    readonly type: "number";
+                    readonly minimum: -180;
+                    readonly maximum: 180;
+                    readonly description: "Eastern longitude; it must be greater than west.";
+                    readonly examples: readonly [5.05];
+                };
+                readonly north: {
+                    readonly type: "number";
+                    readonly minimum: -90;
+                    readonly maximum: 90;
+                    readonly description: "Northern latitude; it must be greater than south.";
+                    readonly examples: readonly [52.5];
+                };
+            };
+        };
+        readonly pageSize: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 1000;
+            readonly description: "Provider records requested per page; runtime page and record limits still bound the operation.";
+            readonly examples: readonly [250];
+        };
+        readonly sortOrder: {
+            readonly enum: readonly ["asc", "desc"];
+            readonly description: "Stable OpenAQ location-ID sort direction; defaults to ascending.";
+            readonly examples: readonly ["asc"];
+        };
+    };
+};
+export declare const OPENAQ_MEASUREMENT_INPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/openaq/sensor-measurements-input.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["sensorId", "granularity", "startDateTime", "endDateTime"];
+    readonly properties: {
+        readonly sensorId: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly description: "One OpenAQ sensor ID obtained from search-locations or another trusted OpenAQ metadata lookup.";
+            readonly examples: readonly [1001];
+        };
+        readonly granularity: {
+            readonly enum: readonly ["raw", "hourly", "daily"];
+            readonly description: "raw returns upstream-reported measurements; hourly and daily use OpenAQ's preferred precomputed aggregates.";
+            readonly examples: readonly ["hourly"];
+        };
+        readonly startDateTime: {
+            readonly type: "string";
+            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+            readonly description: "Inclusive RFC3339 lower time bound. Together with endDateTime, the window may not exceed 366 days.";
+            readonly examples: readonly ["2026-03-01T00:00:00Z"];
+        };
+        readonly endDateTime: {
+            readonly type: "string";
+            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+            readonly description: "Inclusive RFC3339 upper time bound. It must not precede startDateTime.";
+            readonly examples: readonly ["2026-03-07T23:59:59Z"];
+        };
+        readonly pageSize: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 1000;
+            readonly description: "Provider records requested per page; runtime page and record limits still bound the operation.";
+            readonly examples: readonly [1000];
+        };
+    };
+};
+export declare const OPENAQ_LOCATION_SEARCH_OUTPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/openaq/location-search-output.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["source", "query", "provider", "pages", "records", "stopReason"];
+    readonly properties: {
+        readonly source: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["providerId", "service", "apiVersion", "sourceSpecificTerms"];
+            readonly properties: {
+                readonly providerId: {
+                    readonly const: "openaq";
+                };
+                readonly service: {
+                    readonly const: "OpenAQ API";
+                };
+                readonly apiVersion: {
+                    readonly const: "v3";
+                };
+                readonly sourceSpecificTerms: {
+                    readonly const: true;
+                };
+            };
+        };
+        readonly query: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["countryCode", "countryIds", "providerIds", "parameterIds", "licenseIds", "monitor", "mobile", "center", "boundingBox", "pageSize", "sortOrder"];
+            readonly properties: {
+                readonly countryCode: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly countryIds: {
+                    readonly type: "array";
+                    readonly maxItems: 25;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly minItems: 0;
+                };
+                readonly providerIds: {
+                    readonly type: "array";
+                    readonly maxItems: 25;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly minItems: 0;
+                };
+                readonly parameterIds: {
+                    readonly type: "array";
+                    readonly maxItems: 25;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly minItems: 0;
+                };
+                readonly licenseIds: {
+                    readonly type: "array";
+                    readonly maxItems: 25;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly minItems: 0;
+                };
+                readonly monitor: {
+                    readonly anyOf: readonly [{
+                        readonly type: "boolean";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly mobile: {
+                    readonly anyOf: readonly [{
+                        readonly type: "boolean";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly center: {
+                    readonly anyOf: readonly [{
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["latitude", "longitude", "radiusMeters"];
+                        readonly description: "One WGS84 center and radius search. Do not combine it with boundingBox; OpenAQ limits the radius to 25 km.";
+                        readonly examples: readonly [{
+                            readonly latitude: 52.37;
+                            readonly longitude: 4.9;
+                            readonly radiusMeters: 5000;
+                        }];
+                        readonly properties: {
+                            readonly latitude: {
+                                readonly type: "number";
+                                readonly minimum: -90;
+                                readonly maximum: 90;
+                                readonly description: "Center latitude in WGS84 decimal degrees.";
+                                readonly examples: readonly [52.37];
+                            };
+                            readonly longitude: {
+                                readonly type: "number";
+                                readonly minimum: -180;
+                                readonly maximum: 180;
+                                readonly description: "Center longitude in WGS84 decimal degrees.";
+                                readonly examples: readonly [4.9];
+                            };
+                            readonly radiusMeters: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                                readonly maximum: 25000;
+                                readonly description: "Search radius in meters, capped by OpenAQ at 25,000.";
+                                readonly examples: readonly [5000];
+                            };
+                        };
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly boundingBox: {
+                    readonly anyOf: readonly [{
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["west", "south", "east", "north"];
+                        readonly description: "One non-antimeridian WGS84 bounding box. Do not combine it with center; the CLI rejects world-scale scans.";
+                        readonly examples: readonly [{
+                            readonly west: 4.7;
+                            readonly south: 52.25;
+                            readonly east: 5.05;
+                            readonly north: 52.5;
+                        }];
+                        readonly properties: {
+                            readonly west: {
+                                readonly type: "number";
+                                readonly minimum: -180;
+                                readonly maximum: 180;
+                                readonly description: "Western longitude; it must be lower than east.";
+                                readonly examples: readonly [4.7];
+                            };
+                            readonly south: {
+                                readonly type: "number";
+                                readonly minimum: -90;
+                                readonly maximum: 90;
+                                readonly description: "Southern latitude; it must be lower than north.";
+                                readonly examples: readonly [52.25];
+                            };
+                            readonly east: {
+                                readonly type: "number";
+                                readonly minimum: -180;
+                                readonly maximum: 180;
+                                readonly description: "Eastern longitude; it must be greater than west.";
+                                readonly examples: readonly [5.05];
+                            };
+                            readonly north: {
+                                readonly type: "number";
+                                readonly minimum: -90;
+                                readonly maximum: 90;
+                                readonly description: "Northern latitude; it must be greater than south.";
+                                readonly examples: readonly [52.5];
+                            };
+                        };
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+                readonly pageSize: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 1000;
+                };
+                readonly sortOrder: {
+                    readonly enum: readonly ["asc", "desc"];
+                };
+            };
+        };
+        readonly provider: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["name", "website", "found"];
+            readonly properties: {
+                readonly name: {
+                    readonly const: "openaq-api";
+                };
+                readonly website: {
+                    readonly type: "string";
+                };
+                readonly found: {
+                    readonly anyOf: readonly [{
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    }, {
+                        readonly type: "string";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+            };
+        };
+        readonly pages: {
+            readonly type: "array";
+            readonly maxItems: 10;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["pageNumber", "inputRecords", "emittedRecords"];
+                readonly properties: {
+                    readonly pageNumber: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly inputRecords: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly emittedRecords: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                };
+            };
+        };
+        readonly records: {
+            readonly type: "array";
+            readonly maxItems: 10000;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["recordIndex", "sourcePageNumber", "locationId", "name", "locality", "timezone", "country", "owner", "provider", "isMobile", "isMonitor", "coordinates", "bounds", "distanceMeters", "datetimeFirstUtc", "datetimeLastUtc", "instruments", "sensors", "licenses"];
+                readonly properties: {
+                    readonly recordIndex: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly sourcePageNumber: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly locationId: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly name: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly locality: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly timezone: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly country: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["id", "code", "name"];
+                        readonly properties: {
+                            readonly id: {
+                                readonly anyOf: readonly [{
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                }, {
+                                    readonly type: "null";
+                                }];
+                            };
+                            readonly code: {
+                                readonly type: "string";
+                                readonly minLength: 2;
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                        };
+                    };
+                    readonly owner: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["id", "name"];
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                        };
+                    };
+                    readonly provider: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["id", "name"];
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                        };
+                    };
+                    readonly isMobile: {
+                        readonly type: "boolean";
+                    };
+                    readonly isMonitor: {
+                        readonly type: "boolean";
+                    };
+                    readonly coordinates: {
+                        readonly anyOf: readonly [{
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["latitude", "longitude"];
+                            readonly properties: {
+                                readonly latitude: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                        readonly minimum: -90;
+                                        readonly maximum: 90;
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly longitude: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                        readonly minimum: -180;
+                                        readonly maximum: 180;
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly bounds: {
+                        readonly type: "array";
+                        readonly minItems: 4;
+                        readonly maxItems: 4;
+                        readonly items: {
+                            readonly type: "number";
+                        };
+                    };
+                    readonly distanceMeters: {
+                        readonly anyOf: readonly [{
+                            readonly type: "number";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly datetimeFirstUtc: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly datetimeLastUtc: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly instruments: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["id", "name"];
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                };
+                                readonly name: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                            };
+                        };
+                    };
+                    readonly sensors: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["id", "name", "parameter"];
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                };
+                                readonly name: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly parameter: {
+                                    readonly type: "object";
+                                    readonly additionalProperties: false;
+                                    readonly required: readonly ["id", "name", "units", "displayName"];
+                                    readonly properties: {
+                                        readonly id: {
+                                            readonly type: "integer";
+                                            readonly minimum: 1;
+                                        };
+                                        readonly name: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly units: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly displayName: {
+                                            readonly anyOf: readonly [{
+                                                readonly type: "string";
+                                            }, {
+                                                readonly type: "null";
+                                            }];
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly licenses: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["id", "name", "attributionName", "attributionUrl", "dateFrom", "dateTo"];
+                            readonly properties: {
+                                readonly id: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                };
+                                readonly name: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly attributionName: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly attributionUrl: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly dateFrom: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly dateTo: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\d{4}-\\d{2}-\\d{2}$";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly stopReason: {
+            readonly enum: readonly ["completed", "no-results", "max-pages", "max-records", "partial"];
+        };
+    };
+};
+export declare const OPENAQ_MEASUREMENT_OUTPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/openaq/sensor-measurements-output.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["source", "query", "provider", "pages", "records", "stopReason"];
+    readonly properties: {
+        readonly source: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["providerId", "service", "apiVersion", "sourceSpecificTerms"];
+            readonly properties: {
+                readonly providerId: {
+                    readonly const: "openaq";
+                };
+                readonly service: {
+                    readonly const: "OpenAQ API";
+                };
+                readonly apiVersion: {
+                    readonly const: "v3";
+                };
+                readonly sourceSpecificTerms: {
+                    readonly const: true;
+                };
+            };
+        };
+        readonly query: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["sensorId", "granularity", "startDateTime", "endDateTime", "pageSize"];
+            readonly properties: {
+                readonly sensorId: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                };
+                readonly granularity: {
+                    readonly enum: readonly ["raw", "hourly", "daily"];
+                };
+                readonly startDateTime: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+                };
+                readonly endDateTime: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+                };
+                readonly pageSize: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 1000;
+                };
+            };
+        };
+        readonly provider: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["name", "website", "found"];
+            readonly properties: {
+                readonly name: {
+                    readonly const: "openaq-api";
+                };
+                readonly website: {
+                    readonly type: "string";
+                };
+                readonly found: {
+                    readonly anyOf: readonly [{
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    }, {
+                        readonly type: "string";
+                    }, {
+                        readonly type: "null";
+                    }];
+                };
+            };
+        };
+        readonly pages: {
+            readonly type: "array";
+            readonly maxItems: 10;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["pageNumber", "inputRecords", "emittedRecords"];
+                readonly properties: {
+                    readonly pageNumber: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly inputRecords: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly emittedRecords: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                };
+            };
+        };
+        readonly records: {
+            readonly type: "array";
+            readonly maxItems: 10000;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["recordIndex", "sourcePageNumber", "sensorId", "granularity", "value", "flagInfo", "parameter", "period", "coordinates", "summary", "coverage"];
+                readonly properties: {
+                    readonly recordIndex: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly sourcePageNumber: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly sensorId: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly granularity: {
+                        readonly enum: readonly ["raw", "hourly", "daily"];
+                    };
+                    readonly value: {
+                        readonly anyOf: readonly [{
+                            readonly type: "number";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly flagInfo: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["hasFlags"];
+                        readonly properties: {
+                            readonly hasFlags: {
+                                readonly type: "boolean";
+                            };
+                        };
+                    };
+                    readonly parameter: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["id", "name", "units", "displayName"];
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly units: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly displayName: {
+                                readonly anyOf: readonly [{
+                                    readonly type: "string";
+                                }, {
+                                    readonly type: "null";
+                                }];
+                            };
+                        };
+                    };
+                    readonly period: {
+                        readonly anyOf: readonly [{
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["label", "interval", "datetimeFromUtc", "datetimeToUtc"];
+                            readonly properties: {
+                                readonly label: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly interval: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly datetimeFromUtc: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly datetimeToUtc: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly coordinates: {
+                        readonly anyOf: readonly [{
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["latitude", "longitude"];
+                            readonly properties: {
+                                readonly latitude: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                        readonly minimum: -90;
+                                        readonly maximum: 90;
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly longitude: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                        readonly minimum: -180;
+                                        readonly maximum: 180;
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly summary: {
+                        readonly anyOf: readonly [{
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["min", "q02", "q25", "median", "q75", "q98", "max", "average", "standardDeviation"];
+                            readonly properties: {
+                                readonly min: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly q02: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly q25: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly median: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly q75: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly q98: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly max: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly average: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly standardDeviation: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "number";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly coverage: {
+                        readonly anyOf: readonly [{
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["expectedCount", "expectedInterval", "observedCount", "observedInterval", "percentComplete", "percentCoverage", "datetimeFromUtc", "datetimeToUtc"];
+                            readonly properties: {
+                                readonly expectedCount: {
+                                    readonly type: "integer";
+                                    readonly minimum: 0;
+                                };
+                                readonly expectedInterval: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly observedCount: {
+                                    readonly type: "integer";
+                                    readonly minimum: 0;
+                                };
+                                readonly observedInterval: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly percentComplete: {
+                                    readonly type: "number";
+                                    readonly minimum: 0;
+                                    readonly maximum: 100;
+                                };
+                                readonly percentCoverage: {
+                                    readonly type: "number";
+                                    readonly minimum: 0;
+                                    readonly maximum: 100;
+                                };
+                                readonly datetimeFromUtc: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                                readonly datetimeToUtc: {
+                                    readonly anyOf: readonly [{
+                                        readonly type: "string";
+                                        readonly pattern: "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$";
+                                    }, {
+                                        readonly type: "null";
+                                    }];
+                                };
+                            };
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                };
+            };
+        };
+        readonly stopReason: {
+            readonly enum: readonly ["completed", "no-results", "max-pages", "max-records", "partial"];
+        };
+    };
+};