@tiangong-ai/cli 0.0.50 → 0.0.55

package/dist/data/connectors/usbr-rise.schemas.d.ts

@@ -0,0 +1,623 @@
+export declare const USBR_RISE_DISCOVER_ITEMS_INPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/usbr/rise-discover-items-input.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly queryTerms: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 20;
+            readonly uniqueItems: true;
+            readonly description: "Case-insensitive words or phrases that must all occur in the normalized catalog item's searchable metadata.";
+            readonly examples: readonly [readonly ["Lake Powell", "release"]];
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 200;
+            };
+        };
+        readonly itemTitleContains: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 300;
+            readonly description: "Case-insensitive substring required in the RISE catalog item title.";
+            readonly examples: readonly ["Lake Powell"];
+        };
+        readonly locationNameContains: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 300;
+            readonly description: "Case-insensitive substring required in the catalog location name.";
+            readonly examples: readonly ["Glen Canyon"];
+        };
+        readonly parameterNameContains: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 300;
+            readonly description: "Case-insensitive substring required in the catalog parameter name.";
+            readonly examples: readonly ["release"];
+        };
+        readonly parameterId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+            readonly description: "Exact provider parameter identifier used as a client-side catalog filter.";
+            readonly examples: readonly ["3001"];
+        };
+        readonly locationId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+            readonly description: "Exact provider location identifier used as a client-side catalog filter.";
+            readonly examples: readonly ["2001"];
+        };
+        readonly sourceCode: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+            readonly description: "Exact case-insensitive USBR RISE source code used as a catalog filter.";
+            readonly examples: readonly ["UC"];
+        };
+        readonly startPage: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly description: "One-based provider catalog page at which the bounded scan starts.";
+            readonly examples: readonly [1];
+        };
+        readonly pageSize: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 100;
+            readonly description: "Number of provider catalog members requested per page.";
+            readonly examples: readonly [100];
+        };
+    };
+};
+export declare const USBR_RISE_FETCH_RESULTS_INPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/usbr/rise-fetch-results-input.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["itemIds"];
+    readonly properties: {
+        readonly itemIds: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 20;
+            readonly uniqueItems: true;
+            readonly description: "Explicit RISE catalog item identifiers grounded through discovery or another official source.";
+            readonly examples: readonly [readonly ["10835"]];
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 100;
+            };
+        };
+        readonly locationId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+            readonly description: "Optional exact RISE location identifier applied to every requested item.";
+            readonly examples: readonly ["2001"];
+        };
+        readonly parameterId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+            readonly description: "Optional exact RISE parameter identifier applied to every requested item.";
+            readonly examples: readonly ["3001"];
+        };
+        readonly afterUtc: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly description: "Optional inclusive lower RFC3339 dateTime filter with an explicit UTC offset.";
+            readonly examples: readonly ["2025-01-01T00:00:00Z"];
+        };
+        readonly beforeUtc: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly description: "Optional inclusive upper RFC3339 dateTime filter with an explicit UTC offset.";
+            readonly examples: readonly ["2025-01-31T23:59:59Z"];
+        };
+        readonly orderDateTime: {
+            readonly enum: readonly ["asc", "desc"];
+            readonly description: "Provider ordering for result timestamps; descending is the default.";
+            readonly examples: readonly ["desc"];
+        };
+        readonly includeItemMetadata: {
+            readonly type: "boolean";
+            readonly description: "Whether to request each catalog item's metadata and use it to enrich result rows.";
+            readonly examples: readonly [true];
+        };
+        readonly startPage: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly description: "One-based provider result page at which each item scan starts.";
+            readonly examples: readonly [1];
+        };
+        readonly pageSize: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 100;
+            readonly description: "Number of provider result rows requested per page.";
+            readonly examples: readonly [100];
+        };
+    };
+};
+export declare const USBR_RISE_DISCOVER_ITEMS_OUTPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/usbr/rise-discover-items-output.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["source", "query", "candidateItemIds", "records", "pages", "listSemantics", "stopReason"];
+    readonly properties: {
+        readonly source: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["providerId", "endpoint", "interpretationBoundary"];
+            readonly properties: {
+                readonly providerId: {
+                    readonly const: "usbr-rise";
+                };
+                readonly endpoint: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly interpretationBoundary: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+            };
+        };
+        readonly query: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["queryTerms", "itemTitleContains", "locationNameContains", "parameterNameContains", "parameterId", "locationId", "sourceCode", "startPage", "pageSize"];
+            readonly properties: {
+                readonly queryTerms: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+                readonly itemTitleContains: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly locationNameContains: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly parameterNameContains: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly parameterId: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly locationId: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly sourceCode: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly startPage: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                };
+                readonly pageSize: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 100;
+                };
+            };
+        };
+        readonly candidateItemIds: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+        };
+        readonly records: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["itemId", "itemApiPath", "itemTitle", "itemDescription", "locationId", "locationName", "locationSourceCode", "parameterId", "parameterName", "parameterUnit", "parameterGroup", "parameterTimestep", "parameterTransformation", "sourceCode", "temporalStartDate", "temporalEndDate", "landingPage", "spatial", "sourcePageNumber"];
+                readonly properties: {
+                    readonly itemId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly itemTitle: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly itemDescription: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly locationId: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly locationName: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly locationSourceCode: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterId: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterName: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterUnit: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterGroup: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterTimestep: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterTransformation: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly sourceCode: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly temporalStartDate: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly temporalEndDate: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly landingPage: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly providerDisclaimer: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly spatial: {
+                        readonly type: readonly ["object", "null"];
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["type", "coordinates"];
+                        readonly properties: {
+                            readonly type: {
+                                readonly const: "Point";
+                            };
+                            readonly coordinates: {
+                                readonly type: "array";
+                                readonly minItems: 2;
+                                readonly maxItems: 2;
+                                readonly prefixItems: readonly [{
+                                    readonly type: "number";
+                                }, {
+                                    readonly type: "number";
+                                }];
+                                readonly items: false;
+                            };
+                        };
+                    };
+                    readonly itemApiPath: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly sourcePageNumber: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                };
+            };
+        };
+        readonly pages: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["pageNumber", "providerTotalItems", "providerMemberCount", "matchedRecordCount"];
+                readonly properties: {
+                    readonly pageNumber: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly providerTotalItems: {
+                        readonly type: readonly ["integer", "null"];
+                        readonly minimum: 0;
+                    };
+                    readonly providerMemberCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly matchedRecordCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                };
+            };
+        };
+        readonly listSemantics: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly stopReason: {
+            readonly enum: readonly ["completed", "no-results", "max-pages", "max-records", "partial"];
+        };
+    };
+};
+export declare const USBR_RISE_FETCH_RESULTS_OUTPUT_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://schemas.tiangong.ai/data/usbr/rise-fetch-results-output.v1.json";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["source", "query", "itemMetadata", "records", "pages", "stopReason"];
+    readonly properties: {
+        readonly source: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["providerId", "endpoint", "interpretationBoundary"];
+            readonly properties: {
+                readonly providerId: {
+                    readonly const: "usbr-rise";
+                };
+                readonly endpoint: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+                readonly interpretationBoundary: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                };
+            };
+        };
+        readonly query: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["itemIds", "locationId", "parameterId", "afterUtc", "beforeUtc", "orderDateTime", "includeItemMetadata", "startPage", "pageSize"];
+            readonly properties: {
+                readonly itemIds: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                };
+                readonly locationId: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly parameterId: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly afterUtc: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly beforeUtc: {
+                    readonly type: readonly ["string", "null"];
+                };
+                readonly orderDateTime: {
+                    readonly enum: readonly ["asc", "desc"];
+                };
+                readonly includeItemMetadata: {
+                    readonly type: "boolean";
+                };
+                readonly startPage: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                };
+                readonly pageSize: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 100;
+                };
+            };
+        };
+        readonly itemMetadata: {
+            readonly type: "object";
+            readonly propertyNames: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 100;
+            };
+            readonly additionalProperties: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: string[];
+                readonly properties: {
+                    readonly itemId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly itemTitle: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly itemDescription: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly locationId: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly locationName: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly locationSourceCode: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterId: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterName: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterUnit: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterGroup: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterTimestep: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterTransformation: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly sourceCode: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly temporalStartDate: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly temporalEndDate: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly landingPage: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly providerDisclaimer: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly spatial: {
+                        readonly type: readonly ["object", "null"];
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["type", "coordinates"];
+                        readonly properties: {
+                            readonly type: {
+                                readonly const: "Point";
+                            };
+                            readonly coordinates: {
+                                readonly type: "array";
+                                readonly minItems: 2;
+                                readonly maxItems: 2;
+                                readonly prefixItems: readonly [{
+                                    readonly type: "number";
+                                }, {
+                                    readonly type: "number";
+                                }];
+                                readonly items: false;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly records: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["recordId", "itemId", "locationId", "locationName", "parameterId", "parameterName", "parameterUnit", "parameterGroup", "parameterTimestep", "parameterTransformation", "sourceCode", "observedAtUtc", "value", "status", "lastUpdate", "createDate", "updateDate", "latitude", "longitude", "itemTitle", "itemDescription", "landingPage", "providerDisclaimer", "sourcePageNumber"];
+                readonly properties: {
+                    readonly recordId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly itemId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly locationId: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly locationName: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterId: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterName: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterUnit: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterGroup: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterTimestep: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly parameterTransformation: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly sourceCode: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly observedAtUtc: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly value: {
+                        readonly anyOf: readonly [{
+                            readonly type: "number";
+                        }, {
+                            readonly type: "string";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                    readonly status: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly lastUpdate: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly createDate: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly updateDate: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly latitude: {
+                        readonly type: readonly ["number", "null"];
+                    };
+                    readonly longitude: {
+                        readonly type: readonly ["number", "null"];
+                    };
+                    readonly itemTitle: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly itemDescription: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly landingPage: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly providerDisclaimer: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly sourcePageNumber: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                };
+            };
+        };
+        readonly pages: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["itemId", "pageNumber", "providerTotalItems", "recordCount"];
+                readonly properties: {
+                    readonly itemId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly pageNumber: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                    };
+                    readonly providerTotalItems: {
+                        readonly type: readonly ["integer", "null"];
+                        readonly minimum: 0;
+                    };
+                    readonly recordCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                };
+            };
+        };
+        readonly stopReason: {
+            readonly enum: readonly ["completed", "no-results", "max-pages", "max-records", "partial"];
+        };
+    };
+};