@sierragridteam/sdk 0.0.0-stage → 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,1287 @@
+import type * as T from './generated/types.gen.js';
+export type * from './generated/types.gen.js';
+export type RequestOptions = {
+    signal?: AbortSignal;
+    etag?: string;
+    timeoutMs?: number;
+};
+export type ApiResult<T> = {
+    data: T;
+    status: number;
+    etag: string | null;
+    notModified: false;
+} | {
+    data: undefined;
+    status: 304;
+    etag: string | null;
+    notModified: true;
+};
+export declare class SierraApiError extends Error {
+    readonly status: number;
+    readonly codeName: string;
+    readonly retryAfter: string | null;
+    readonly body: unknown;
+    constructor(message: string, status: number, codeName: string, retryAfter: string | null, body: unknown);
+}
+export type ClientOptions = {
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+};
+export type EventQuery = NonNullable<T.GridServiceListEventsData['query']>;
+export type HistoryQuery = NonNullable<T.GridServiceListHistoryData['query']> & {
+    from: string;
+    to: string;
+};
+export type MapLayer = T.GetMapLayerData['path']['layer'];
+/** Public read-only client. All returned JSON is validated against generated Zod schemas. */
+export declare function createSierraClient(config?: ClientOptions): {
+    listEvents: (query?: EventQuery, options?: RequestOptions) => Promise<ApiResult<{
+        events: {
+            areaLabel: string;
+            canonicalUrl: string;
+            category: string;
+            description: string;
+            effective: string | null;
+            enhancement: {
+                enhancedAt: string | null;
+                fields: string[];
+                model: string;
+                request: string;
+                response: string;
+            } | null;
+            expires: string | null;
+            geometry: {
+                bbox: {
+                    maxLat: number;
+                    maxLng: number;
+                    minLat: number;
+                    minLng: number;
+                };
+                centroid: {
+                    lat: number;
+                    lng: number;
+                };
+                geojson: string;
+                object?: {
+                    coordinates: unknown[];
+                    type: "Point" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon";
+                } | null | undefined;
+            } | null;
+            headline: string;
+            id: string;
+            ingestedAt: string;
+            layer: "MESH" | "ROAD_INCIDENT" | "WEATHER_ALERT" | "FIRE_WEATHER" | "EARTHQUAKE" | "WILDFIRE" | "EVACUATION" | "POWER" | "LAYER_UNSPECIFIED" | "GAUGE" | "AIR_QUALITY" | "ANNOUNCEMENT" | "BURN_STATUS";
+            observedAt: string | null;
+            placeIds: string[];
+            provenance: {
+                attribution: string;
+                fetchedAt: string;
+                sourceId: "meshcore" | "chp" | "calfire" | "firis" | "caloes" | "nws" | "usgs" | "caltrans" | "pge" | "psps" | "burnline" | "calfire-burn";
+                sourceName: string;
+                sourceUrl: string;
+            };
+            revision: number;
+            severity: "INFO" | "MODERATE" | "SEVERE" | "MINOR" | "EXTREME";
+            status: "ACTIVE" | "SCHEDULED" | "EVENT_STATUS_UNSPECIFIED" | "RESOLVED" | "EXPIRED";
+            summary: string;
+            burnStatus?: {
+                burnDay: "BURN_DAY_UNKNOWN" | "BURN_DAY_YES" | "BURN_DAY_NO" | "BURN_DAY_MARGINAL";
+                burnLines: {
+                    burnDay: "BURN_DAY_UNKNOWN" | "BURN_DAY_YES" | "BURN_DAY_NO" | "BURN_DAY_MARGINAL";
+                    id: string;
+                    name: string;
+                    observation: {
+                        confidence: number;
+                        message: string;
+                        observedAt: string;
+                        transcript: string;
+                    } | null;
+                    phone: string;
+                }[];
+                calfireArea: string;
+                calfireEffective: string | null;
+                calfireObservedAt: string | null;
+                calfireStatus: "CALFIRE_BURN_STATUS_UNKNOWN" | "CALFIRE_BURNING_SUSPENDED" | "CALFIRE_PERMIT_REQUIRED" | "CALFIRE_NO_PERMIT_REQUIRED";
+                permission: "BURN_PERMISSION_UNKNOWN" | "BURN_PERMISSION_ALLOWED" | "BURN_PERMISSION_PROHIBITED";
+            } | undefined;
+            earthquake?: {
+                depthKm: number;
+                felt: number;
+                magnitude: number;
+            } | undefined;
+            evacuation?: {
+                county: string;
+                eventType: string;
+                level: "ORDER" | "WARNING" | "ADVISORY" | "SHELTER_IN_PLACE";
+                zoneId: string;
+            } | undefined;
+            fireWeather?: {
+                sourceEvent: string;
+                state: "normal" | "elevated" | "red-flag";
+                zones: string[];
+            } | undefined;
+            mesh?: {
+                name: string;
+                nodeType: "repeater" | "companion" | "room_server" | "sensor";
+                publicKey: string;
+                reachability: "MESH_REACHABILITY_UNSPECIFIED" | "REACHABLE" | "UNREACHABLE";
+                telemetry: {
+                    admin: {
+                        airtimeMs: string;
+                        batteryPercent: number | null;
+                        batteryPercentSource: "" | "measured" | "estimated";
+                        batteryVolts: number | null;
+                        directDups: string;
+                        floodDups: string;
+                        fullEvents: string;
+                        humidity: number | null;
+                        lastAttemptAt: string | null;
+                        lastRssiDbm: number | null;
+                        lastSnrDb: number | null;
+                        lastSuccessAt: string | null;
+                        noiseFloorDbm: number | null;
+                        packetsReceived: string;
+                        packetsSent: string;
+                        pressure: number | null;
+                        recvDirect: string;
+                        recvErrors: string;
+                        recvFlood: string;
+                        reportedAt: string | null;
+                        reporterId: string;
+                        rxAirtimeMs: string;
+                        sentDirect: string;
+                        sentFlood: string;
+                        temperatureC: number | null;
+                        txQueueLen: number | null;
+                        uptimeSeconds: string;
+                    } | null;
+                    gateways: string[];
+                    hopCount: number | null;
+                    lastAdvertAt: string | null;
+                    lastHeardAt: string | null;
+                    lastRelayedAt: string | null;
+                    rssi: number | null;
+                    snr: number | null;
+                } | null;
+            } | undefined;
+            power?: {
+                allClear: string | null;
+                cause: string;
+                crewStatus: string;
+                customersAffected: number;
+                deEnergizationEnd: string | null;
+                deEnergizationStart: string | null;
+                estimatedRestoration: string | null;
+                eventId: string;
+                eventName: string;
+                medicalBaselineAffected: number;
+                outageId: string;
+                stage: "" | "Watch" | "Warning";
+                timePeriod: string;
+            } | undefined;
+            roadIncident?: {
+                closure: {
+                    begin: {
+                        lat: number;
+                        lng: number;
+                    } | null;
+                    beginLocation: string;
+                    closureDuration: "Standard" | "Long Term" | "Intermittent";
+                    closureId: string;
+                    closureType: string;
+                    direction: string;
+                    district: number;
+                    end: {
+                        lat: number;
+                        lng: number;
+                    } | null;
+                    endIndefinite: boolean;
+                    endLocation: string;
+                    estimatedDelayMinutes: number;
+                    facility: string;
+                    lanesClosed: string;
+                    logNumber: string;
+                    plannedEnd: string | null;
+                    plannedStart: string;
+                    route: string;
+                    setUpAt: string | null;
+                    totalLanes: number;
+                    windowId: string;
+                    workType: string;
+                } | null;
+                duration: "" | "unknown" | "< 1 hour" | "several hours" | "ongoing";
+                impact: "" | "none" | "light" | "moderate" | "severe";
+                logNumber: string;
+                metadata: Record<string, string>;
+            } | undefined;
+            weatherAlert?: {
+                areaDesc: string;
+                certainty: "Unknown" | "Observed" | "Likely" | "Possible" | "Unlikely";
+                instruction: string;
+                nwsSeverity: "Extreme" | "Severe" | "Moderate" | "Minor" | "Unknown";
+                urgency: "Unknown" | "Immediate" | "Expected" | "Future" | "Past";
+                zones: string[];
+            } | undefined;
+            wildfire?: {
+                acres: number;
+                cause: string;
+                containment: number;
+                county: string;
+                hasPerimeter: boolean;
+            } | undefined;
+        }[];
+        nextPageToken: string;
+    }>>;
+    getEvent: (id: string, query?: NonNullable<T.GridServiceGetEventData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        areaLabel: string;
+        canonicalUrl: string;
+        category: string;
+        description: string;
+        effective: string | null;
+        enhancement: {
+            enhancedAt: string | null;
+            fields: string[];
+            model: string;
+            request: string;
+            response: string;
+        } | null;
+        expires: string | null;
+        geometry: {
+            bbox: {
+                maxLat: number;
+                maxLng: number;
+                minLat: number;
+                minLng: number;
+            };
+            centroid: {
+                lat: number;
+                lng: number;
+            };
+            geojson: string;
+            object?: {
+                coordinates: unknown[];
+                type: "Point" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon";
+            } | null | undefined;
+        } | null;
+        headline: string;
+        id: string;
+        ingestedAt: string;
+        layer: "MESH" | "ROAD_INCIDENT" | "WEATHER_ALERT" | "FIRE_WEATHER" | "EARTHQUAKE" | "WILDFIRE" | "EVACUATION" | "POWER" | "LAYER_UNSPECIFIED" | "GAUGE" | "AIR_QUALITY" | "ANNOUNCEMENT" | "BURN_STATUS";
+        observedAt: string | null;
+        placeIds: string[];
+        provenance: {
+            attribution: string;
+            fetchedAt: string;
+            sourceId: "meshcore" | "chp" | "calfire" | "firis" | "caloes" | "nws" | "usgs" | "caltrans" | "pge" | "psps" | "burnline" | "calfire-burn";
+            sourceName: string;
+            sourceUrl: string;
+        };
+        revision: number;
+        severity: "INFO" | "MODERATE" | "SEVERE" | "MINOR" | "EXTREME";
+        status: "ACTIVE" | "SCHEDULED" | "EVENT_STATUS_UNSPECIFIED" | "RESOLVED" | "EXPIRED";
+        summary: string;
+        burnStatus?: {
+            burnDay: "BURN_DAY_UNKNOWN" | "BURN_DAY_YES" | "BURN_DAY_NO" | "BURN_DAY_MARGINAL";
+            burnLines: {
+                burnDay: "BURN_DAY_UNKNOWN" | "BURN_DAY_YES" | "BURN_DAY_NO" | "BURN_DAY_MARGINAL";
+                id: string;
+                name: string;
+                observation: {
+                    confidence: number;
+                    message: string;
+                    observedAt: string;
+                    transcript: string;
+                } | null;
+                phone: string;
+            }[];
+            calfireArea: string;
+            calfireEffective: string | null;
+            calfireObservedAt: string | null;
+            calfireStatus: "CALFIRE_BURN_STATUS_UNKNOWN" | "CALFIRE_BURNING_SUSPENDED" | "CALFIRE_PERMIT_REQUIRED" | "CALFIRE_NO_PERMIT_REQUIRED";
+            permission: "BURN_PERMISSION_UNKNOWN" | "BURN_PERMISSION_ALLOWED" | "BURN_PERMISSION_PROHIBITED";
+        } | undefined;
+        earthquake?: {
+            depthKm: number;
+            felt: number;
+            magnitude: number;
+        } | undefined;
+        evacuation?: {
+            county: string;
+            eventType: string;
+            level: "ORDER" | "WARNING" | "ADVISORY" | "SHELTER_IN_PLACE";
+            zoneId: string;
+        } | undefined;
+        fireWeather?: {
+            sourceEvent: string;
+            state: "normal" | "elevated" | "red-flag";
+            zones: string[];
+        } | undefined;
+        mesh?: {
+            name: string;
+            nodeType: "repeater" | "companion" | "room_server" | "sensor";
+            publicKey: string;
+            reachability: "MESH_REACHABILITY_UNSPECIFIED" | "REACHABLE" | "UNREACHABLE";
+            telemetry: {
+                admin: {
+                    airtimeMs: string;
+                    batteryPercent: number | null;
+                    batteryPercentSource: "" | "measured" | "estimated";
+                    batteryVolts: number | null;
+                    directDups: string;
+                    floodDups: string;
+                    fullEvents: string;
+                    humidity: number | null;
+                    lastAttemptAt: string | null;
+                    lastRssiDbm: number | null;
+                    lastSnrDb: number | null;
+                    lastSuccessAt: string | null;
+                    noiseFloorDbm: number | null;
+                    packetsReceived: string;
+                    packetsSent: string;
+                    pressure: number | null;
+                    recvDirect: string;
+                    recvErrors: string;
+                    recvFlood: string;
+                    reportedAt: string | null;
+                    reporterId: string;
+                    rxAirtimeMs: string;
+                    sentDirect: string;
+                    sentFlood: string;
+                    temperatureC: number | null;
+                    txQueueLen: number | null;
+                    uptimeSeconds: string;
+                } | null;
+                gateways: string[];
+                hopCount: number | null;
+                lastAdvertAt: string | null;
+                lastHeardAt: string | null;
+                lastRelayedAt: string | null;
+                rssi: number | null;
+                snr: number | null;
+            } | null;
+        } | undefined;
+        power?: {
+            allClear: string | null;
+            cause: string;
+            crewStatus: string;
+            customersAffected: number;
+            deEnergizationEnd: string | null;
+            deEnergizationStart: string | null;
+            estimatedRestoration: string | null;
+            eventId: string;
+            eventName: string;
+            medicalBaselineAffected: number;
+            outageId: string;
+            stage: "" | "Watch" | "Warning";
+            timePeriod: string;
+        } | undefined;
+        roadIncident?: {
+            closure: {
+                begin: {
+                    lat: number;
+                    lng: number;
+                } | null;
+                beginLocation: string;
+                closureDuration: "Standard" | "Long Term" | "Intermittent";
+                closureId: string;
+                closureType: string;
+                direction: string;
+                district: number;
+                end: {
+                    lat: number;
+                    lng: number;
+                } | null;
+                endIndefinite: boolean;
+                endLocation: string;
+                estimatedDelayMinutes: number;
+                facility: string;
+                lanesClosed: string;
+                logNumber: string;
+                plannedEnd: string | null;
+                plannedStart: string;
+                route: string;
+                setUpAt: string | null;
+                totalLanes: number;
+                windowId: string;
+                workType: string;
+            } | null;
+            duration: "" | "unknown" | "< 1 hour" | "several hours" | "ongoing";
+            impact: "" | "none" | "light" | "moderate" | "severe";
+            logNumber: string;
+            metadata: Record<string, string>;
+        } | undefined;
+        weatherAlert?: {
+            areaDesc: string;
+            certainty: "Unknown" | "Observed" | "Likely" | "Possible" | "Unlikely";
+            instruction: string;
+            nwsSeverity: "Extreme" | "Severe" | "Moderate" | "Minor" | "Unknown";
+            urgency: "Unknown" | "Immediate" | "Expected" | "Future" | "Past";
+            zones: string[];
+        } | undefined;
+        wildfire?: {
+            acres: number;
+            cause: string;
+            containment: number;
+            county: string;
+            hasPerimeter: boolean;
+        } | undefined;
+    }>>;
+    getEventHistory: (id: string, query?: NonNullable<T.GridServiceGetEventHistoryData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        nextPageToken: string;
+        revisions: {
+            event: {
+                areaLabel: string;
+                canonicalUrl: string;
+                category: string;
+                description: string;
+                effective: string | null;
+                enhancement: {
+                    enhancedAt: string | null;
+                    fields: string[];
+                    model: string;
+                    request: string;
+                    response: string;
+                } | null;
+                expires: string | null;
+                geometry: {
+                    bbox: {
+                        maxLat: number;
+                        maxLng: number;
+                        minLat: number;
+                        minLng: number;
+                    };
+                    centroid: {
+                        lat: number;
+                        lng: number;
+                    };
+                    geojson: string;
+                    object?: {
+                        coordinates: unknown[];
+                        type: "Point" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon";
+                    } | null | undefined;
+                } | null;
+                headline: string;
+                id: string;
+                ingestedAt: string;
+                layer: "MESH" | "ROAD_INCIDENT" | "WEATHER_ALERT" | "FIRE_WEATHER" | "EARTHQUAKE" | "WILDFIRE" | "EVACUATION" | "POWER" | "LAYER_UNSPECIFIED" | "GAUGE" | "AIR_QUALITY" | "ANNOUNCEMENT" | "BURN_STATUS";
+                observedAt: string | null;
+                placeIds: string[];
+                provenance: {
+                    attribution: string;
+                    fetchedAt: string;
+                    sourceId: "meshcore" | "chp" | "calfire" | "firis" | "caloes" | "nws" | "usgs" | "caltrans" | "pge" | "psps" | "burnline" | "calfire-burn";
+                    sourceName: string;
+                    sourceUrl: string;
+                };
+                revision: number;
+                severity: "INFO" | "MODERATE" | "SEVERE" | "MINOR" | "EXTREME";
+                status: "ACTIVE" | "SCHEDULED" | "EVENT_STATUS_UNSPECIFIED" | "RESOLVED" | "EXPIRED";
+                summary: string;
+                burnStatus?: {
+                    burnDay: "BURN_DAY_UNKNOWN" | "BURN_DAY_YES" | "BURN_DAY_NO" | "BURN_DAY_MARGINAL";
+                    burnLines: {
+                        burnDay: "BURN_DAY_UNKNOWN" | "BURN_DAY_YES" | "BURN_DAY_NO" | "BURN_DAY_MARGINAL";
+                        id: string;
+                        name: string;
+                        observation: {
+                            confidence: number;
+                            message: string;
+                            observedAt: string;
+                            transcript: string;
+                        } | null;
+                        phone: string;
+                    }[];
+                    calfireArea: string;
+                    calfireEffective: string | null;
+                    calfireObservedAt: string | null;
+                    calfireStatus: "CALFIRE_BURN_STATUS_UNKNOWN" | "CALFIRE_BURNING_SUSPENDED" | "CALFIRE_PERMIT_REQUIRED" | "CALFIRE_NO_PERMIT_REQUIRED";
+                    permission: "BURN_PERMISSION_UNKNOWN" | "BURN_PERMISSION_ALLOWED" | "BURN_PERMISSION_PROHIBITED";
+                } | undefined;
+                earthquake?: {
+                    depthKm: number;
+                    felt: number;
+                    magnitude: number;
+                } | undefined;
+                evacuation?: {
+                    county: string;
+                    eventType: string;
+                    level: "ORDER" | "WARNING" | "ADVISORY" | "SHELTER_IN_PLACE";
+                    zoneId: string;
+                } | undefined;
+                fireWeather?: {
+                    sourceEvent: string;
+                    state: "normal" | "elevated" | "red-flag";
+                    zones: string[];
+                } | undefined;
+                mesh?: {
+                    name: string;
+                    nodeType: "repeater" | "companion" | "room_server" | "sensor";
+                    publicKey: string;
+                    reachability: "MESH_REACHABILITY_UNSPECIFIED" | "REACHABLE" | "UNREACHABLE";
+                    telemetry: {
+                        admin: {
+                            airtimeMs: string;
+                            batteryPercent: number | null;
+                            batteryPercentSource: "" | "measured" | "estimated";
+                            batteryVolts: number | null;
+                            directDups: string;
+                            floodDups: string;
+                            fullEvents: string;
+                            humidity: number | null;
+                            lastAttemptAt: string | null;
+                            lastRssiDbm: number | null;
+                            lastSnrDb: number | null;
+                            lastSuccessAt: string | null;
+                            noiseFloorDbm: number | null;
+                            packetsReceived: string;
+                            packetsSent: string;
+                            pressure: number | null;
+                            recvDirect: string;
+                            recvErrors: string;
+                            recvFlood: string;
+                            reportedAt: string | null;
+                            reporterId: string;
+                            rxAirtimeMs: string;
+                            sentDirect: string;
+                            sentFlood: string;
+                            temperatureC: number | null;
+                            txQueueLen: number | null;
+                            uptimeSeconds: string;
+                        } | null;
+                        gateways: string[];
+                        hopCount: number | null;
+                        lastAdvertAt: string | null;
+                        lastHeardAt: string | null;
+                        lastRelayedAt: string | null;
+                        rssi: number | null;
+                        snr: number | null;
+                    } | null;
+                } | undefined;
+                power?: {
+                    allClear: string | null;
+                    cause: string;
+                    crewStatus: string;
+                    customersAffected: number;
+                    deEnergizationEnd: string | null;
+                    deEnergizationStart: string | null;
+                    estimatedRestoration: string | null;
+                    eventId: string;
+                    eventName: string;
+                    medicalBaselineAffected: number;
+                    outageId: string;
+                    stage: "" | "Watch" | "Warning";
+                    timePeriod: string;
+                } | undefined;
+                roadIncident?: {
+                    closure: {
+                        begin: {
+                            lat: number;
+                            lng: number;
+                        } | null;
+                        beginLocation: string;
+                        closureDuration: "Standard" | "Long Term" | "Intermittent";
+                        closureId: string;
+                        closureType: string;
+                        direction: string;
+                        district: number;
+                        end: {
+                            lat: number;
+                            lng: number;
+                        } | null;
+                        endIndefinite: boolean;
+                        endLocation: string;
+                        estimatedDelayMinutes: number;
+                        facility: string;
+                        lanesClosed: string;
+                        logNumber: string;
+                        plannedEnd: string | null;
+                        plannedStart: string;
+                        route: string;
+                        setUpAt: string | null;
+                        totalLanes: number;
+                        windowId: string;
+                        workType: string;
+                    } | null;
+                    duration: "" | "unknown" | "< 1 hour" | "several hours" | "ongoing";
+                    impact: "" | "none" | "light" | "moderate" | "severe";
+                    logNumber: string;
+                    metadata: Record<string, string>;
+                } | undefined;
+                weatherAlert?: {
+                    areaDesc: string;
+                    certainty: "Unknown" | "Observed" | "Likely" | "Possible" | "Unlikely";
+                    instruction: string;
+                    nwsSeverity: "Extreme" | "Severe" | "Moderate" | "Minor" | "Unknown";
+                    urgency: "Unknown" | "Immediate" | "Expected" | "Future" | "Past";
+                    zones: string[];
+                } | undefined;
+                wildfire?: {
+                    acres: number;
+                    cause: string;
+                    containment: number;
+                    county: string;
+                    hasPerimeter: boolean;
+                } | undefined;
+            };
+            ingestedAt: string;
+            observedAt: string;
+            revision: number;
+        }[];
+    }>>;
+    listPlaces: (query?: NonNullable<T.GridServiceListPlacesData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        places: {
+            geometry: {
+                bbox: {
+                    maxLat: number;
+                    maxLng: number;
+                    minLat: number;
+                    minLng: number;
+                };
+                centroid: {
+                    lat: number;
+                    lng: number;
+                };
+                geojson: string;
+                object?: {
+                    coordinates: unknown[];
+                    type: "Point" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon";
+                } | null | undefined;
+            };
+            id: string;
+            kind: "AREA" | "COUNTY" | "TOWN" | "PLACE_KIND_UNSPECIFIED" | "EVAC_ZONE" | "CORRIDOR" | "SITE";
+            name: string;
+            parentId: string;
+            slug: string;
+        }[];
+    }>>;
+    getPlace: (place: string, options?: RequestOptions) => Promise<ApiResult<{
+        geometry: {
+            bbox: {
+                maxLat: number;
+                maxLng: number;
+                minLat: number;
+                minLng: number;
+            };
+            centroid: {
+                lat: number;
+                lng: number;
+            };
+            geojson: string;
+            object?: {
+                coordinates: unknown[];
+                type: "Point" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon";
+            } | null | undefined;
+        };
+        id: string;
+        kind: "AREA" | "COUNTY" | "TOWN" | "PLACE_KIND_UNSPECIFIED" | "EVAC_ZONE" | "CORRIDOR" | "SITE";
+        name: string;
+        parentId: string;
+        slug: string;
+    }>>;
+    resolvePlace: (query: NonNullable<T.GridServiceResolvePlaceData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        places: {
+            geometry: {
+                bbox: {
+                    maxLat: number;
+                    maxLng: number;
+                    minLat: number;
+                    minLng: number;
+                };
+                centroid: {
+                    lat: number;
+                    lng: number;
+                };
+                geojson: string;
+                object?: {
+                    coordinates: unknown[];
+                    type: "Point" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon";
+                } | null | undefined;
+            };
+            id: string;
+            kind: "AREA" | "COUNTY" | "TOWN" | "PLACE_KIND_UNSPECIFIED" | "EVAC_ZONE" | "CORRIDOR" | "SITE";
+            name: string;
+            parentId: string;
+            slug: string;
+        }[];
+        query: {
+            lat: number;
+            lng: number;
+            matchedAddress: string;
+        };
+    }>>;
+    getPlaceSummary: (place: string, options?: RequestOptions) => Promise<ApiResult<{
+        domains: {
+            activeCount: number;
+            domain: "evacuation" | "power" | "weather" | "fire" | "roads" | "seismic" | "burn" | "comms";
+            headlines: {
+                headline: string;
+                id: string;
+                kind: "EVENT" | "CONDITION";
+                layer: "MESH" | "ROAD_INCIDENT" | "CHAIN_CONTROL" | "ROAD_SEGMENT" | "WEATHER_ALERT" | "FIRE_WEATHER" | "EARTHQUAKE" | "WILDFIRE" | "EVACUATION" | "POWER" | "BURN_STATUS";
+                severity: "INFO" | "MODERATE" | "SEVERE" | "MINOR" | "EXTREME";
+            }[];
+            highestSeverity: "INFO" | "MODERATE" | "SEVERE" | "MINOR" | "EXTREME";
+            status: "OK" | "STALE" | "UNAVAILABLE";
+        }[];
+        generatedAt: string;
+        mode: "ACTIVE" | "QUIET" | "WATCH";
+        place: string;
+        placeId: string;
+        placeName: string;
+        sources: {
+            id: string;
+            lastSuccessAt: string | null;
+            status: "OK" | "STALE" | "UNAVAILABLE";
+        }[];
+        summary: {
+            activeEvacuations: number | null;
+            evacuationSourceUrl: string;
+            evacuationStatus: "OK" | "STALE" | "UNAVAILABLE";
+            highestSeverity: "INFO" | "MODERATE" | "SEVERE" | "MINOR" | "EXTREME";
+            highestSeverityRank: number;
+            severityCounts: Record<string, number>;
+            topEvents: {
+                headline: string;
+                id: string;
+                layer: "ROAD_INCIDENT" | "WEATHER_ALERT" | "EARTHQUAKE" | "WILDFIRE" | "EVACUATION" | "POWER";
+                severity: "INFO" | "MODERATE" | "SEVERE" | "MINOR" | "EXTREME";
+                severityRank: number;
+                source: string;
+            }[];
+            totalActive: number;
+        };
+    }>>;
+    getConditions: (query?: NonNullable<T.GridServiceGetConditionsData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        fireWeather: {
+            headline: string;
+            state: "" | "normal" | "elevated" | "red-flag";
+            zones: string[];
+        } | null;
+        forecast: {
+            horizonHours: number;
+            issuedAt: string | null;
+            locationId: string;
+            minHumidityPercent: number;
+            peakWindGustAt: string | null;
+            peakWindGustKmh: number;
+            periods: {
+                humidityPercent: number;
+                temperatureCelsius: number;
+                time: string | null;
+                windDirectionDegrees: number;
+                windGustKmh: number;
+                windSpeedKmh: number;
+            }[];
+            source: string;
+        }[];
+        lastUpdated: string | null;
+        weather: {
+            feelsLikeCelsius: number;
+            humidityPercent: number;
+            locationId: string;
+            locationName: string;
+            temperatureCelsius: number;
+            visibilityKm: number;
+            weatherDescription: string;
+            weatherIcon: string;
+            weatherMain: string;
+            windDirectionDegrees: number;
+            windSpeedKmh: number;
+        }[];
+    }>>;
+    listCameras: (query?: NonNullable<T.GridServiceListCamerasData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        attribution: string;
+        cameras: {
+            county: string;
+            description: string;
+            direction: "" | "North" | "South" | "East" | "West";
+            distanceMeters: number;
+            elevationFeet: number;
+            id: string;
+            imageRefreshMinutes: number;
+            imageUrl: string;
+            location: {
+                lat: number;
+                lng: number;
+            };
+            name: string;
+            nearbyPlace: string;
+            route: string;
+            streamUrl: string;
+        }[];
+        lastSourceUpdate: string | null;
+        sourceStatus: "OK" | "STALE" | "UNAVAILABLE";
+    }>>;
+    listScanners: (query?: NonNullable<T.GridServiceListScannersData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        scanners: {
+            agency: string;
+            broadcastifyUrl: string;
+            channelLabel: string;
+            feedId: string;
+        }[];
+    }>>;
+    listSources: (options?: RequestOptions) => Promise<ApiResult<{
+        sources: {
+            attribution: string;
+            expireAfterSeconds: number;
+            homepageUrl: string;
+            id: string;
+            kind: "SOURCE_KIND_UNSPECIFIED" | "FEED" | "REPORTER";
+            lastAttemptAt: string | null;
+            lastError: string;
+            lastSuccessAt: string | null;
+            name: string;
+            pollIntervalSeconds: number;
+            staleAfterSeconds: number;
+            status: "OK" | "STALE" | "UNAVAILABLE" | "SOURCE_STATUS_UNSPECIFIED";
+        }[];
+    }>>;
+    getMapLayer: (place: string, layer: MapLayer, query?: NonNullable<T.GetMapLayerData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        features: {
+            geometry: {
+                coordinates: unknown[];
+                type: "Point" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon";
+            } | null;
+            properties: {
+                headline: string;
+                id: string;
+                kind: "Road incident" | "Chain control" | "Road segment" | "Message sign" | "Weather alert" | "Fire weather" | "Fire-weather forecast" | "Earthquake" | "Wildfire" | "Evacuation" | "Power outage" | "Public Safety Power Shutoff" | "Mesh node" | "Relay link" | "Traffic camera";
+                layer: "ROAD_INCIDENT" | "CHAIN_CONTROL" | "ROAD_SEGMENT" | "MESSAGE_SIGN" | "WEATHER_ALERT" | "FIRE_WEATHER" | "EARTHQUAKE" | "WILDFIRE" | "EVACUATION" | "POWER" | "MESH_NODE" | "MESH_LINK" | "CAMERA";
+                severity: "INFO" | "MODERATE" | "SEVERE" | "MINOR" | "EXTREME";
+                severityRank: number;
+                source: {
+                    id: string;
+                    name: string;
+                    attribution?: string | undefined;
+                    fetchedAt?: string | undefined;
+                    url?: string | undefined;
+                };
+                areaLabel?: string | undefined;
+                camera?: {
+                    distanceMeters: number;
+                    imageUrl: string;
+                    county?: string | undefined;
+                    direction?: string | undefined;
+                    elevationFeet?: number | undefined;
+                    imageRefreshMinutes?: number | undefined;
+                    route?: string | undefined;
+                    streamUrl?: string | undefined;
+                } | undefined;
+                category?: string | undefined;
+                chainControl?: {
+                    direction?: string | undefined;
+                    highway?: string | undefined;
+                    level?: "R1" | "R2" | "R3" | undefined;
+                } | undefined;
+                description?: string | undefined;
+                earthquake?: {
+                    depthKm: number;
+                    magnitude: number;
+                    felt?: number | undefined;
+                } | undefined;
+                effective?: string | undefined;
+                evacuation?: {
+                    level: "ORDER" | "WARNING" | "ADVISORY" | "SHELTER_IN_PLACE";
+                    county?: string | undefined;
+                    eventType?: string | undefined;
+                    zoneId?: string | undefined;
+                } | undefined;
+                expires?: string | undefined;
+                fireWeather?: {
+                    forecast?: {
+                        horizonHours?: number | undefined;
+                        issuedAt?: string | undefined;
+                        minHumidityPercent?: number | undefined;
+                        peakWindGustAt?: string | undefined;
+                        peakWindGustKmh?: number | undefined;
+                        source?: string | undefined;
+                    } | undefined;
+                    sourceEvent?: string | undefined;
+                    state?: "normal" | "elevated" | "red-flag" | undefined;
+                    zones?: string[] | undefined;
+                } | undefined;
+                incident?: {
+                    closure?: {
+                        windowId: string;
+                        closureType?: string | undefined;
+                        estimatedDelayMinutes?: number | undefined;
+                        lanesClosed?: string | undefined;
+                        plannedEnd?: string | undefined;
+                        plannedStart?: string | undefined;
+                        setUpAt?: string | undefined;
+                        totalLanes?: number | undefined;
+                        workType?: string | undefined;
+                    } | undefined;
+                    logNumber?: string | undefined;
+                } | undefined;
+                mesh?: {
+                    publicKey: string;
+                    admin?: {
+                        reporterId: string;
+                        airtimeMs?: number | undefined;
+                        batteryPercent?: number | undefined;
+                        batteryPercentSource?: string | undefined;
+                        batteryVolts?: number | undefined;
+                        lastSuccessAt?: string | undefined;
+                        noiseFloorDbm?: number | undefined;
+                        packetsReceived?: number | undefined;
+                        packetsSent?: number | undefined;
+                        recvErrors?: number | undefined;
+                        reportedAt?: string | undefined;
+                        rxAirtimeMs?: number | undefined;
+                        temperatureC?: number | undefined;
+                        txQueueLen?: number | undefined;
+                        uptimeSeconds?: number | undefined;
+                    } | undefined;
+                    gateways?: string[] | undefined;
+                    hopCount?: number | undefined;
+                    inRegion?: boolean | undefined;
+                    lastHeardAt?: string | undefined;
+                    lastRelayedAt?: string | undefined;
+                    name?: string | undefined;
+                    nodeType?: "repeater" | "companion" | "room_server" | "sensor" | undefined;
+                    reachability?: "REACHABLE" | "UNREACHABLE" | undefined;
+                    rssi?: number | undefined;
+                    snr?: number | undefined;
+                } | undefined;
+                meshLink?: {
+                    a: string;
+                    b: string;
+                    daysActive: number;
+                    observations: number;
+                    bestSnr?: number | undefined;
+                    firstSeen?: string | undefined;
+                    lastSeen?: string | undefined;
+                } | undefined;
+                messageSign?: {
+                    district: number;
+                    inService: boolean;
+                    signId: string;
+                    direction?: string | undefined;
+                    pages?: [string, string, string][] | undefined;
+                    route?: string | undefined;
+                } | undefined;
+                power?: {
+                    allClear?: string | undefined;
+                    cause?: string | undefined;
+                    crewStatus?: string | undefined;
+                    customersAffected?: number | undefined;
+                    deEnergizationEnd?: string | undefined;
+                    deEnergizationStart?: string | undefined;
+                    estimatedRestoration?: string | undefined;
+                    eventName?: string | undefined;
+                    medicalBaselineAffected?: number | undefined;
+                    outageId?: string | undefined;
+                    stage?: "Watch" | "Warning" | undefined;
+                } | undefined;
+                road?: {
+                    roadId: string;
+                    congestion?: "MODERATE" | "CLEAR" | "LIGHT" | "HEAVY" | "SEVERE" | "UNSPECIFIED" | undefined;
+                    delayMinutes?: number | undefined;
+                    distanceKm?: number | undefined;
+                    durationMinutes?: number | undefined;
+                } | undefined;
+                status?: "ACTIVE" | "ORDER" | "WARNING" | "ADVISORY" | "SHELTER_IN_PLACE" | "UNSPECIFIED" | "SCHEDULED" | "OPEN" | "CLOSED" | "RESTRICTED" | "MAINTENANCE" | undefined;
+                summary?: string | undefined;
+                summaryEnhanced?: {
+                    enhancedAt?: string | undefined;
+                } | undefined;
+                updatedAt?: string | undefined;
+                weather?: {
+                    certainty?: string | undefined;
+                    event?: string | undefined;
+                    instruction?: string | undefined;
+                    nwsSeverity?: "Extreme" | "Severe" | "Moderate" | "Minor" | "Unknown" | undefined;
+                    source?: "NWS" | undefined;
+                    urgency?: string | undefined;
+                    zones?: string[] | undefined;
+                } | undefined;
+                wildfire?: {
+                    containment: number;
+                    hasPerimeter: boolean;
+                    acres?: number | undefined;
+                    cause?: string | undefined;
+                    county?: string | undefined;
+                } | undefined;
+            };
+            type: "Feature";
+        }[];
+        metadata: {
+            area: string;
+            generatedAt: string;
+            layer: "road_incident" | "chain_control" | "road_segment" | "message_sign" | "weather_alert" | "fire_weather" | "earthquake" | "wildfire" | "evacuation" | "power" | "mesh_node" | "mesh_link" | "camera";
+            schemaVersion: 1;
+            sourceStatus: "OK" | "STALE" | "UNAVAILABLE";
+            attribution?: string | undefined;
+            lastSourceUpdate?: string | undefined;
+            sourceUrl?: string | undefined;
+        };
+        type: "FeatureCollection";
+    }>>;
+    listMeshLinks: (query?: NonNullable<T.ListMeshLinksData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        generatedAt: string;
+        links: {
+            a: string;
+            b: string;
+            bestSnr: number;
+            daysActive: number;
+            firstSeen: string;
+            lastSeen: string;
+            observations: number;
+        }[];
+        window: string;
+    }>>;
+    getMeshTelemetry: (query: NonNullable<T.GridServiceGetMeshTelemetryData["query"]>, options?: RequestOptions) => Promise<ApiResult<{
+        cadenceSeconds: string | null;
+        coverage: {
+            from: string | null;
+            samples: number;
+            to: string | null;
+        };
+        from: string;
+        node: string;
+        reboots: string[];
+        samples: {
+            reading: {
+                airtimeMs: string;
+                batteryPercent: number | null;
+                batteryPercentSource: "" | "measured" | "estimated";
+                batteryVolts: number | null;
+                directDups: string;
+                floodDups: string;
+                fullEvents: string;
+                humidity: number | null;
+                lastAttemptAt: string | null;
+                lastRssiDbm: number | null;
+                lastSnrDb: number | null;
+                lastSuccessAt: string | null;
+                noiseFloorDbm: number | null;
+                packetsReceived: string;
+                packetsSent: string;
+                pressure: number | null;
+                recvDirect: string;
+                recvErrors: string;
+                recvFlood: string;
+                reportedAt: string | null;
+                reporterId: string;
+                rxAirtimeMs: string;
+                sentDirect: string;
+                sentFlood: string;
+                temperatureC: number | null;
+                txQueueLen: number | null;
+                uptimeSeconds: string;
+            };
+            receivedAt: string;
+        }[];
+        to: string;
+        truncated: boolean;
+    }>>;
+    listHistory: (query: HistoryQuery, options?: RequestOptions) => Promise<ApiResult<{
+        nextPageToken: string;
+        revisions: {
+            event: {
+                areaLabel: string;
+                canonicalUrl: string;
+                category: string;
+                description: string;
+                effective: string | null;
+                enhancement: {
+                    enhancedAt: string | null;
+                    fields: string[];
+                    model: string;
+                    request: string;
+                    response: string;
+                } | null;
+                expires: string | null;
+                geometry: {
+                    bbox: {
+                        maxLat: number;
+                        maxLng: number;
+                        minLat: number;
+                        minLng: number;
+                    };
+                    centroid: {
+                        lat: number;
+                        lng: number;
+                    };
+                    geojson: string;
+                    object?: {
+                        coordinates: unknown[];
+                        type: "Point" | "MultiPoint" | "LineString" | "MultiLineString" | "Polygon" | "MultiPolygon";
+                    } | null | undefined;
+                } | null;
+                headline: string;
+                id: string;
+                ingestedAt: string;
+                layer: "MESH" | "ROAD_INCIDENT" | "WEATHER_ALERT" | "FIRE_WEATHER" | "EARTHQUAKE" | "WILDFIRE" | "EVACUATION" | "POWER" | "LAYER_UNSPECIFIED" | "GAUGE" | "AIR_QUALITY" | "ANNOUNCEMENT" | "BURN_STATUS";
+                observedAt: string | null;
+                placeIds: string[];
+                provenance: {
+                    attribution: string;
+                    fetchedAt: string;
+                    sourceId: "meshcore" | "chp" | "calfire" | "firis" | "caloes" | "nws" | "usgs" | "caltrans" | "pge" | "psps" | "burnline" | "calfire-burn";
+                    sourceName: string;
+                    sourceUrl: string;
+                };
+                revision: number;
+                severity: "INFO" | "MODERATE" | "SEVERE" | "MINOR" | "EXTREME";
+                status: "ACTIVE" | "SCHEDULED" | "EVENT_STATUS_UNSPECIFIED" | "RESOLVED" | "EXPIRED";
+                summary: string;
+                burnStatus?: {
+                    burnDay: "BURN_DAY_UNKNOWN" | "BURN_DAY_YES" | "BURN_DAY_NO" | "BURN_DAY_MARGINAL";
+                    burnLines: {
+                        burnDay: "BURN_DAY_UNKNOWN" | "BURN_DAY_YES" | "BURN_DAY_NO" | "BURN_DAY_MARGINAL";
+                        id: string;
+                        name: string;
+                        observation: {
+                            confidence: number;
+                            message: string;
+                            observedAt: string;
+                            transcript: string;
+                        } | null;
+                        phone: string;
+                    }[];
+                    calfireArea: string;
+                    calfireEffective: string | null;
+                    calfireObservedAt: string | null;
+                    calfireStatus: "CALFIRE_BURN_STATUS_UNKNOWN" | "CALFIRE_BURNING_SUSPENDED" | "CALFIRE_PERMIT_REQUIRED" | "CALFIRE_NO_PERMIT_REQUIRED";
+                    permission: "BURN_PERMISSION_UNKNOWN" | "BURN_PERMISSION_ALLOWED" | "BURN_PERMISSION_PROHIBITED";
+                } | undefined;
+                earthquake?: {
+                    depthKm: number;
+                    felt: number;
+                    magnitude: number;
+                } | undefined;
+                evacuation?: {
+                    county: string;
+                    eventType: string;
+                    level: "ORDER" | "WARNING" | "ADVISORY" | "SHELTER_IN_PLACE";
+                    zoneId: string;
+                } | undefined;
+                fireWeather?: {
+                    sourceEvent: string;
+                    state: "normal" | "elevated" | "red-flag";
+                    zones: string[];
+                } | undefined;
+                mesh?: {
+                    name: string;
+                    nodeType: "repeater" | "companion" | "room_server" | "sensor";
+                    publicKey: string;
+                    reachability: "MESH_REACHABILITY_UNSPECIFIED" | "REACHABLE" | "UNREACHABLE";
+                    telemetry: {
+                        admin: {
+                            airtimeMs: string;
+                            batteryPercent: number | null;
+                            batteryPercentSource: "" | "measured" | "estimated";
+                            batteryVolts: number | null;
+                            directDups: string;
+                            floodDups: string;
+                            fullEvents: string;
+                            humidity: number | null;
+                            lastAttemptAt: string | null;
+                            lastRssiDbm: number | null;
+                            lastSnrDb: number | null;
+                            lastSuccessAt: string | null;
+                            noiseFloorDbm: number | null;
+                            packetsReceived: string;
+                            packetsSent: string;
+                            pressure: number | null;
+                            recvDirect: string;
+                            recvErrors: string;
+                            recvFlood: string;
+                            reportedAt: string | null;
+                            reporterId: string;
+                            rxAirtimeMs: string;
+                            sentDirect: string;
+                            sentFlood: string;
+                            temperatureC: number | null;
+                            txQueueLen: number | null;
+                            uptimeSeconds: string;
+                        } | null;
+                        gateways: string[];
+                        hopCount: number | null;
+                        lastAdvertAt: string | null;
+                        lastHeardAt: string | null;
+                        lastRelayedAt: string | null;
+                        rssi: number | null;
+                        snr: number | null;
+                    } | null;
+                } | undefined;
+                power?: {
+                    allClear: string | null;
+                    cause: string;
+                    crewStatus: string;
+                    customersAffected: number;
+                    deEnergizationEnd: string | null;
+                    deEnergizationStart: string | null;
+                    estimatedRestoration: string | null;
+                    eventId: string;
+                    eventName: string;
+                    medicalBaselineAffected: number;
+                    outageId: string;
+                    stage: "" | "Watch" | "Warning";
+                    timePeriod: string;
+                } | undefined;
+                roadIncident?: {
+                    closure: {
+                        begin: {
+                            lat: number;
+                            lng: number;
+                        } | null;
+                        beginLocation: string;
+                        closureDuration: "Standard" | "Long Term" | "Intermittent";
+                        closureId: string;
+                        closureType: string;
+                        direction: string;
+                        district: number;
+                        end: {
+                            lat: number;
+                            lng: number;
+                        } | null;
+                        endIndefinite: boolean;
+                        endLocation: string;
+                        estimatedDelayMinutes: number;
+                        facility: string;
+                        lanesClosed: string;
+                        logNumber: string;
+                        plannedEnd: string | null;
+                        plannedStart: string;
+                        route: string;
+                        setUpAt: string | null;
+                        totalLanes: number;
+                        windowId: string;
+                        workType: string;
+                    } | null;
+                    duration: "" | "unknown" | "< 1 hour" | "several hours" | "ongoing";
+                    impact: "" | "none" | "light" | "moderate" | "severe";
+                    logNumber: string;
+                    metadata: Record<string, string>;
+                } | undefined;
+                weatherAlert?: {
+                    areaDesc: string;
+                    certainty: "Unknown" | "Observed" | "Likely" | "Possible" | "Unlikely";
+                    instruction: string;
+                    nwsSeverity: "Extreme" | "Severe" | "Moderate" | "Minor" | "Unknown";
+                    urgency: "Unknown" | "Immediate" | "Expected" | "Future" | "Past";
+                    zones: string[];
+                } | undefined;
+                wildfire?: {
+                    acres: number;
+                    cause: string;
+                    containment: number;
+                    county: string;
+                    hasPerimeter: boolean;
+                } | undefined;
+            };
+            ingestedAt: string;
+            observedAt: string;
+            revision: number;
+        }[];
+    }>>;
+};
+export type SierraClient = ReturnType<typeof createSierraClient>;
+/** Yields pages, including continuation tokens. A caller stopping early owns that incompleteness. */
+export declare function paginate<T extends {
+    nextPageToken: string;
+}>(load: (pageToken?: string) => Promise<ApiResult<T>>, maxPages?: number): AsyncGenerator<T>;