@sierragridteam/sdk 0.0.0-stage → 0.1.1

package/dist/generated/sdk.gen.d.ts

@@ -0,0 +1,210 @@
+import type { Client, ClientMeta, Options as Options2, RequestResult, TDataShape } from './client/index.js';
+import type { GetMapLayerData, GetMapLayerErrors, GetMapLayerResponses, GridServiceGetConditionsData, GridServiceGetConditionsErrors, GridServiceGetConditionsResponses, GridServiceGetEventData, GridServiceGetEventErrors, GridServiceGetEventHistoryData, GridServiceGetEventHistoryErrors, GridServiceGetEventHistoryResponses, GridServiceGetEventResponses, GridServiceGetMeshTelemetryData, GridServiceGetMeshTelemetryErrors, GridServiceGetMeshTelemetryResponses, GridServiceGetPlaceData, GridServiceGetPlaceErrors, GridServiceGetPlaceResponses, GridServiceGetPlaceSummaryData, GridServiceGetPlaceSummaryErrors, GridServiceGetPlaceSummaryResponses, GridServiceListCamerasData, GridServiceListCamerasErrors, GridServiceListCamerasResponses, GridServiceListEventsData, GridServiceListEventsErrors, GridServiceListEventsResponses, GridServiceListHistoryData, GridServiceListHistoryErrors, GridServiceListHistoryResponses, GridServiceListPlacesData, GridServiceListPlacesErrors, GridServiceListPlacesResponses, GridServiceListScannersData, GridServiceListScannersErrors, GridServiceListScannersResponses, GridServiceListSourcesData, GridServiceListSourcesErrors, GridServiceListSourcesResponses, GridServiceResolvePlaceData, GridServiceResolvePlaceErrors, GridServiceResolvePlaceResponses, ListMeshLinksData, ListMeshLinksErrors, ListMeshLinksResponses } from './types.gen.js';
+export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
+    /**
+     * You can provide a client instance returned by `createClient()` instead of
+     * individual options. This might be also useful if you want to implement a
+     * custom client.
+     */
+    client?: Client;
+    /**
+     * You can pass arbitrary values through the `meta` object. This can be
+     * used to access values that aren't defined as part of the SDK function.
+     */
+    meta?: keyof ClientMeta extends never ? Record<string, unknown> : ClientMeta;
+};
+/**
+ * List Caltrans traffic cameras.
+ *
+ * In-service Caltrans CCTV cameras within 25 km of a coverage area, each with
+ * a snapshot image URL and, where Caltrans publishes one, an HLS stream URL.
+ * Links only: images and streams are served by Caltrans, never proxied. With
+ * `place`, only cameras within 25 km of that place, nearest first. Cameras are
+ * reference views, not events: nothing here is a hazard, and an empty list
+ * means no camera nearby. Refreshed every 6 hours; check `sourceStatus`.
+ * Supports ETag / If-None-Match.
+ */
+export declare const gridServiceListCameras: <ThrowOnError extends boolean = false>(options?: Options<GridServiceListCamerasData, ThrowOnError>) => RequestResult<GridServiceListCamerasResponses, GridServiceListCamerasErrors, ThrowOnError>;
+/**
+ * Get current weather, forecasts and fire weather.
+ *
+ * Current conditions per weather location (OpenWeatherMap, refreshed every 15
+ * minutes), a 48-hour NWS forecast per location, and the region's fire-weather
+ * state. With `place`, only the weather locations inside the place's bounding
+ * box (and their forecasts); `fireWeather` is region-wide either way. Weather
+ * ALERTS are events (`/api/v1/events?layer=WEATHER_ALERT`); road conditions
+ * are the `road_segment` and `chain_control` map layers.
+ */
+export declare const gridServiceGetConditions: <ThrowOnError extends boolean = false>(options?: Options<GridServiceGetConditionsData, ThrowOnError>) => RequestResult<GridServiceGetConditionsResponses, GridServiceGetConditionsErrors, ThrowOnError>;
+/**
+ * Query events across layers.
+ *
+ * The main event feed, from the grid event store. Defaults: status ACTIVE and
+ * SCHEDULED, every layer, every place, every severity, up to 50 per page.
+ *
+ * An unscoped query is dominated by MESH nodes (hundreds of INFO community
+ * radio nodes, many outside every place) and SCHEDULED Caltrans roadwork. For
+ * a hazard feed pass `place` and `status=ACTIVE`, and either
+ * `severityMin=MINOR` or an explicit `layer` list. Use
+ * `layer=ROAD_INCIDENT&place={corridor}` for a highway's incidents and
+ * `layer=WEATHER_ALERT` for NWS alerts. Sorted by severity, then most recently
+ * observed. A page holds at most `pageSize` events and stops early at about
+ * 3 MiB encoded, so follow `nextPageToken` until it is empty. Supports
+ * ETag / If-None-Match.
+ */
+export declare const gridServiceListEvents: <ThrowOnError extends boolean = false>(options?: Options<GridServiceListEventsData, ThrowOnError>) => RequestResult<GridServiceListEventsResponses, GridServiceListEventsErrors, ThrowOnError>;
+/**
+ * Get one event.
+ *
+ * The current revision of one event, any status. Ids contain colons
+ * (`chp:261106ST0341`); URL-encode them if your client requires it. Ids that
+ * appear in the summary's domain headlines with `kind: CONDITION`
+ * (`road:...`, `cc:...`, `fw:...`) are map features, not events, and return
+ * 404 here. Supports ETag / If-None-Match.
+ */
+export declare const gridServiceGetEvent: <ThrowOnError extends boolean = false>(options: Options<GridServiceGetEventData, ThrowOnError>) => RequestResult<GridServiceGetEventResponses, GridServiceGetEventErrors, ThrowOnError>;
+/**
+ * List one event's revisions.
+ *
+ * Every stored revision of one event, newest first, each a full snapshot. A
+ * status change (for example ACTIVE to RESOLVED) is a revision, so the last
+ * entries show when it ended. Up to 50 per page by default, up to 200; a
+ * page also stops early at about 3 MiB encoded (a perimeter that grew over
+ * many revisions), so follow `nextPageToken` until it is empty. Supports
+ * ETag / If-None-Match.
+ */
+export declare const gridServiceGetEventHistory: <ThrowOnError extends boolean = false>(options: Options<GridServiceGetEventHistoryData, ThrowOnError>) => RequestResult<GridServiceGetEventHistoryResponses, GridServiceGetEventHistoryErrors, ThrowOnError>;
+/**
+ * Query revisions across events (the archive).
+ *
+ * Revisions of all events, optionally filtered by place and layer, over a
+ * half-open `[from, to)` window on each revision's `observedAt`. With no
+ * window it covers all history. Ordered newest first. Place and layer
+ * filters use each event's CURRENT place attachments and layer. Use it for
+ * "what happened here last week". A page holds at most `pageSize` revisions
+ * and stops early at about 3 MiB encoded, so follow `nextPageToken` until it
+ * is empty. Supports ETag / If-None-Match.
+ */
+export declare const gridServiceListHistory: <ThrowOnError extends boolean = false>(options?: Options<GridServiceListHistoryData, ThrowOnError>) => RequestResult<GridServiceListHistoryResponses, GridServiceListHistoryErrors, ThrowOnError>;
+/**
+ * The MeshCore relay topology, as an edge list
+ *
+ * Every undirected relay link observed within `window`, mesh-wide (not
+ * place-scoped: a mesh spans places). Nodes are identified by public key;
+ * to draw a link, join `a` and `b` to `properties.mesh.publicKey` on the
+ * `mesh_node` map layer (or `mesh.publicKey` on `layer=MESH` events) for
+ * coordinates. For a place-scoped, ready-to-draw version use the
+ * `mesh_link` map layer. Weight edges by `daysActive`, fade by `lastSeen`.
+ *
+ * `Cache-Control: public, max-age=60` and a weak `ETag` (`W/"…"`) that
+ * excludes `generatedAt`: `If-None-Match` revalidates to `304` until the
+ * links change.
+ *
+ */
+export declare const listMeshLinks: <ThrowOnError extends boolean = false>(options?: Options<ListMeshLinksData, ThrowOnError>) => RequestResult<ListMeshLinksResponses, ListMeshLinksErrors, ThrowOnError>;
+/**
+ * Get one mesh node's telemetry series.
+ *
+ * Every archived operator-monitor reading for one MeshCore node over a
+ * window, oldest first: the data behind a battery, temperature or airtime
+ * chart. The event carries only the latest reading
+ * (`mesh.telemetry.admin`). Only nodes an operator monitors have samples.
+ * The default window is the 24 hours before `to` (default now); windows over
+ * 400 days are clamped. At most 20,000 samples are returned (`truncated`
+ * says so).
+ */
+export declare const gridServiceGetMeshTelemetry: <ThrowOnError extends boolean = false>(options: Options<GridServiceGetMeshTelemetryData, ThrowOnError>) => RequestResult<GridServiceGetMeshTelemetryResponses, GridServiceGetMeshTelemetryErrors, ThrowOnError>;
+/**
+ * List places.
+ *
+ * The place directory, with geometry: coverage areas, counties, towns and
+ * highway corridors (about 20 today). Filter by `kind` and a case-insensitive
+ * name substring `q`. Not paginated. Supports ETag / If-None-Match.
+ */
+export declare const gridServiceListPlaces: <ThrowOnError extends boolean = false>(options?: Options<GridServiceListPlacesData, ThrowOnError>) => RequestResult<GridServiceListPlacesResponses, GridServiceListPlacesErrors, ThrowOnError>;
+/**
+ * Get one place.
+ *
+ * One place by slug (`arnold`) or namespaced id (`town:arnold`), with its
+ * geometry. Supports ETag / If-None-Match.
+ */
+export declare const gridServiceGetPlace: <ThrowOnError extends boolean = false>(options: Options<GridServiceGetPlaceData, ThrowOnError>) => RequestResult<GridServiceGetPlaceResponses, GridServiceGetPlaceErrors, ThrowOnError>;
+/**
+ * One map layer for a place, as GeoJSON
+ *
+ * An RFC 7946 FeatureCollection of one layer's features within a place.
+ * Coordinates are `[longitude, latitude]`. Check `metadata.sourceStatus`
+ * before drawing: UNAVAILABLE means unknown (empty `features`), STALE
+ * means last-good data.
+ *
+ * | layer | features | backed by |
+ * |---|---|---|
+ * | `road_incident` | Points: CHP incidents (category `incident`) and Caltrans planned lane closures (`closure`, SCHEDULED until set up) | events |
+ * | `chain_control` | Points: active R1/R2/R3 checkpoints and seasonal pass closures | live Caltrans |
+ * | `road_segment` | LineStrings: configured routes with travel time; `status` OPEN/CLOSED/RESTRICTED/MAINTENANCE | live Google Routes + Caltrans |
+ * | `message_sign` | Points: Caltrans message signs and their text; always INFO | live Caltrans |
+ * | `weather_alert` | null geometry: NWS zone watches/warnings/advisories | events |
+ * | `fire_weather` | one null-geometry region banner (`fw:region`) plus forecast Points | live NWS |
+ * | `earthquake` | Points | events (USGS) |
+ * | `wildfire` | Points or (Multi)Polygon perimeters | events (CAL FIRE, FIRIS) |
+ * | `evacuation` | (Multi)Polygon zones; `status` is the level | events (Cal OES) |
+ * | `power` | Polygons/Points: PG&E outages (`unplanned`/`planned`) and PSPS (`psps`) | events |
+ * | `mesh_node` | Points: MeshCore nodes in the place; always INFO | events |
+ * | `mesh_link` | LineString relay links touching the place plus the MESH_NODE Points at both ends (neighbours outside the place have `mesh.inRegion: false`); honours `window` | derived |
+ * | `camera` | Points: Caltrans CCTV cameras near the place, nearest first; always INFO | live Caltrans |
+ *
+ * Event-backed layers carry only ACTIVE and SCHEDULED features, and each
+ * feature `id` is an event id usable with `/api/v1/events/{id}`. The
+ * `.geojson` suffix is optional (`/map/wildfire` is the same resource).
+ *
+ * **Caching.** `Cache-Control: public, max-age=60` and a weak `ETag`
+ * (`W/"…"`) over the layer's content, excluding `metadata.generatedAt`.
+ * Revalidate with `If-None-Match`: the answer is `304` until the
+ * features, `sourceStatus`, `lastSourceUpdate` or `attribution` change,
+ * so polling a quiet layer costs no body.
+ *
+ */
+export declare const getMapLayer: <ThrowOnError extends boolean = false>(options: Options<GetMapLayerData, ThrowOnError>) => RequestResult<GetMapLayerResponses, GetMapLayerErrors, ThrowOnError>;
+/**
+ * Summarize a place in one call.
+ *
+ * The dashboard headline: `mode` (QUIET, WATCH, ACTIVE), a cross-layer hazard
+ * rollup (`summary`), one block per domain (`domains`), and a source-health
+ * sidecar (`sources`). Built from the place's ACTIVE and SCHEDULED events
+ * plus the live condition layers (road segments, chain control, fire
+ * weather).
+ *
+ * Ambient state is kept out of the hazard rollup (`totalActive`,
+ * `severityCounts`, `topEvents`, `mode`): MESH nodes, BURN_STATUS, INFO-level
+ * POWER outages, and SCHEDULED road closures. MESH and BURN_STATUS appear only
+ * in their own `comms` and `burn` domains. The `evacuation` invariant: see
+ * `summary.activeEvacuations`. Computed fresh on each call; no ETag.
+ */
+export declare const gridServiceGetPlaceSummary: <ThrowOnError extends boolean = false>(options: Options<GridServiceGetPlaceSummaryData, ThrowOnError>) => RequestResult<GridServiceGetPlaceSummaryResponses, GridServiceGetPlaceSummaryErrors, ThrowOnError>;
+/**
+ * Resolve a point or an address to places.
+ *
+ * Returns every place containing the point, most specific first (SITE,
+ * EVAC_ZONE, TOWN, CORRIDOR, COUNTY, AREA). A town matches within 3 km of its
+ * point (nearest town first); a corridor within about 1.5 km of its line. Give
+ * `lat` and `lng`, or `address` (geocoded with the US Census geocoder), not
+ * both. An empty `places` list means the point is outside the covered region.
+ */
+export declare const gridServiceResolvePlace: <ThrowOnError extends boolean = false>(options?: Options<GridServiceResolvePlaceData, ThrowOnError>) => RequestResult<GridServiceResolvePlaceResponses, GridServiceResolvePlaceErrors, ThrowOnError>;
+/**
+ * List police, fire and CHP scanner feeds.
+ *
+ * Broadcastify audio feeds that cover the region. With `place` naming an AREA,
+ * that area's feeds; with any other place, or none, every configured feed,
+ * deduplicated. Links only; audio is served by Broadcastify.
+ */
+export declare const gridServiceListScanners: <ThrowOnError extends boolean = false>(options?: Options<GridServiceListScannersData, ThrowOnError>) => RequestResult<GridServiceListScannersResponses, GridServiceListScannersErrors, ThrowOnError>;
+/**
+ * List sources and their health.
+ *
+ * The upstream source registry with per-source health (OK, STALE,
+ * UNAVAILABLE), last success, last attempt and last error. This is how a
+ * client decides how far to trust each layer. It also lists one health-only
+ * row per operator push reporter.
+ */
+export declare const gridServiceListSources: <ThrowOnError extends boolean = false>(options?: Options<GridServiceListSourcesData, ThrowOnError>) => RequestResult<GridServiceListSourcesResponses, GridServiceListSourcesErrors, ThrowOnError>;

package/dist/generated/sdk.gen.js

@@ -0,0 +1,336 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import * as z from 'zod';
+import { client } from './client.gen.js';
+import { zGetMapLayerHeaders, zGetMapLayerPath, zGetMapLayerQuery, zGetMapLayerResponse, zGridServiceGetConditionsQuery, zGridServiceGetConditionsResponse, zGridServiceGetEventHistoryPath, zGridServiceGetEventHistoryQuery, zGridServiceGetEventHistoryResponse, zGridServiceGetEventPath, zGridServiceGetEventQuery, zGridServiceGetEventResponse, zGridServiceGetMeshTelemetryQuery, zGridServiceGetMeshTelemetryResponse, zGridServiceGetPlacePath, zGridServiceGetPlaceQuery, zGridServiceGetPlaceResponse, zGridServiceGetPlaceSummaryPath, zGridServiceGetPlaceSummaryResponse, zGridServiceListCamerasQuery, zGridServiceListCamerasResponse, zGridServiceListEventsQuery, zGridServiceListEventsResponse, zGridServiceListHistoryQuery, zGridServiceListHistoryResponse, zGridServiceListPlacesQuery, zGridServiceListPlacesResponse, zGridServiceListScannersQuery, zGridServiceListScannersResponse, zGridServiceListSourcesResponse, zGridServiceResolvePlaceQuery, zGridServiceResolvePlaceResponse, zListMeshLinksHeaders, zListMeshLinksQuery, zListMeshLinksResponse } from './zod.gen.js';
+/**
+ * List Caltrans traffic cameras.
+ *
+ * In-service Caltrans CCTV cameras within 25 km of a coverage area, each with
+ * a snapshot image URL and, where Caltrans publishes one, an HLS stream URL.
+ * Links only: images and streams are served by Caltrans, never proxied. With
+ * `place`, only cameras within 25 km of that place, nearest first. Cameras are
+ * reference views, not events: nothing here is a hazard, and an empty list
+ * means no camera nearby. Refreshed every 6 hours; check `sourceStatus`.
+ * Supports ETag / If-None-Match.
+ */
+export const gridServiceListCameras = (options) => (options?.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: z.never().optional(),
+        query: zGridServiceListCamerasQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceListCamerasResponse.parseAsync(data),
+    url: '/api/v1/cameras',
+    ...options
+});
+/**
+ * Get current weather, forecasts and fire weather.
+ *
+ * Current conditions per weather location (OpenWeatherMap, refreshed every 15
+ * minutes), a 48-hour NWS forecast per location, and the region's fire-weather
+ * state. With `place`, only the weather locations inside the place's bounding
+ * box (and their forecasts); `fireWeather` is region-wide either way. Weather
+ * ALERTS are events (`/api/v1/events?layer=WEATHER_ALERT`); road conditions
+ * are the `road_segment` and `chain_control` map layers.
+ */
+export const gridServiceGetConditions = (options) => (options?.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: z.never().optional(),
+        query: zGridServiceGetConditionsQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceGetConditionsResponse.parseAsync(data),
+    url: '/api/v1/conditions',
+    ...options
+});
+/**
+ * Query events across layers.
+ *
+ * The main event feed, from the grid event store. Defaults: status ACTIVE and
+ * SCHEDULED, every layer, every place, every severity, up to 50 per page.
+ *
+ * An unscoped query is dominated by MESH nodes (hundreds of INFO community
+ * radio nodes, many outside every place) and SCHEDULED Caltrans roadwork. For
+ * a hazard feed pass `place` and `status=ACTIVE`, and either
+ * `severityMin=MINOR` or an explicit `layer` list. Use
+ * `layer=ROAD_INCIDENT&place={corridor}` for a highway's incidents and
+ * `layer=WEATHER_ALERT` for NWS alerts. Sorted by severity, then most recently
+ * observed. A page holds at most `pageSize` events and stops early at about
+ * 3 MiB encoded, so follow `nextPageToken` until it is empty. Supports
+ * ETag / If-None-Match.
+ */
+export const gridServiceListEvents = (options) => (options?.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: z.never().optional(),
+        query: zGridServiceListEventsQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceListEventsResponse.parseAsync(data),
+    url: '/api/v1/events',
+    ...options
+});
+/**
+ * Get one event.
+ *
+ * The current revision of one event, any status. Ids contain colons
+ * (`chp:261106ST0341`); URL-encode them if your client requires it. Ids that
+ * appear in the summary's domain headlines with `kind: CONDITION`
+ * (`road:...`, `cc:...`, `fw:...`) are map features, not events, and return
+ * 404 here. Supports ETag / If-None-Match.
+ */
+export const gridServiceGetEvent = (options) => (options.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: zGridServiceGetEventPath,
+        query: zGridServiceGetEventQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceGetEventResponse.parseAsync(data),
+    url: '/api/v1/events/{id}',
+    ...options
+});
+/**
+ * List one event's revisions.
+ *
+ * Every stored revision of one event, newest first, each a full snapshot. A
+ * status change (for example ACTIVE to RESOLVED) is a revision, so the last
+ * entries show when it ended. Up to 50 per page by default, up to 200; a
+ * page also stops early at about 3 MiB encoded (a perimeter that grew over
+ * many revisions), so follow `nextPageToken` until it is empty. Supports
+ * ETag / If-None-Match.
+ */
+export const gridServiceGetEventHistory = (options) => (options.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: zGridServiceGetEventHistoryPath,
+        query: zGridServiceGetEventHistoryQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceGetEventHistoryResponse.parseAsync(data),
+    url: '/api/v1/events/{id}/history',
+    ...options
+});
+/**
+ * Query revisions across events (the archive).
+ *
+ * Revisions of all events, optionally filtered by place and layer, over a
+ * half-open `[from, to)` window on each revision's `observedAt`. With no
+ * window it covers all history. Ordered newest first. Place and layer
+ * filters use each event's CURRENT place attachments and layer. Use it for
+ * "what happened here last week". A page holds at most `pageSize` revisions
+ * and stops early at about 3 MiB encoded, so follow `nextPageToken` until it
+ * is empty. Supports ETag / If-None-Match.
+ */
+export const gridServiceListHistory = (options) => (options?.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: z.never().optional(),
+        query: zGridServiceListHistoryQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceListHistoryResponse.parseAsync(data),
+    url: '/api/v1/history',
+    ...options
+});
+/**
+ * The MeshCore relay topology, as an edge list
+ *
+ * Every undirected relay link observed within `window`, mesh-wide (not
+ * place-scoped: a mesh spans places). Nodes are identified by public key;
+ * to draw a link, join `a` and `b` to `properties.mesh.publicKey` on the
+ * `mesh_node` map layer (or `mesh.publicKey` on `layer=MESH` events) for
+ * coordinates. For a place-scoped, ready-to-draw version use the
+ * `mesh_link` map layer. Weight edges by `daysActive`, fade by `lastSeen`.
+ *
+ * `Cache-Control: public, max-age=60` and a weak `ETag` (`W/"…"`) that
+ * excludes `generatedAt`: `If-None-Match` revalidates to `304` until the
+ * links change.
+ *
+ */
+export const listMeshLinks = (options) => (options?.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        headers: zListMeshLinksHeaders.optional(),
+        path: z.never().optional(),
+        query: zListMeshLinksQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zListMeshLinksResponse.parseAsync(data),
+    url: '/api/v1/mesh/links',
+    ...options
+});
+/**
+ * Get one mesh node's telemetry series.
+ *
+ * Every archived operator-monitor reading for one MeshCore node over a
+ * window, oldest first: the data behind a battery, temperature or airtime
+ * chart. The event carries only the latest reading
+ * (`mesh.telemetry.admin`). Only nodes an operator monitors have samples.
+ * The default window is the 24 hours before `to` (default now); windows over
+ * 400 days are clamped. At most 20,000 samples are returned (`truncated`
+ * says so).
+ */
+export const gridServiceGetMeshTelemetry = (options) => (options.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: z.never().optional(),
+        query: zGridServiceGetMeshTelemetryQuery
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceGetMeshTelemetryResponse.parseAsync(data),
+    url: '/api/v1/mesh/telemetry',
+    ...options
+});
+/**
+ * List places.
+ *
+ * The place directory, with geometry: coverage areas, counties, towns and
+ * highway corridors (about 20 today). Filter by `kind` and a case-insensitive
+ * name substring `q`. Not paginated. Supports ETag / If-None-Match.
+ */
+export const gridServiceListPlaces = (options) => (options?.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: z.never().optional(),
+        query: zGridServiceListPlacesQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceListPlacesResponse.parseAsync(data),
+    url: '/api/v1/places',
+    ...options
+});
+/**
+ * Get one place.
+ *
+ * One place by slug (`arnold`) or namespaced id (`town:arnold`), with its
+ * geometry. Supports ETag / If-None-Match.
+ */
+export const gridServiceGetPlace = (options) => (options.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: zGridServiceGetPlacePath,
+        query: zGridServiceGetPlaceQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceGetPlaceResponse.parseAsync(data),
+    url: '/api/v1/places/{place}',
+    ...options
+});
+/**
+ * One map layer for a place, as GeoJSON
+ *
+ * An RFC 7946 FeatureCollection of one layer's features within a place.
+ * Coordinates are `[longitude, latitude]`. Check `metadata.sourceStatus`
+ * before drawing: UNAVAILABLE means unknown (empty `features`), STALE
+ * means last-good data.
+ *
+ * | layer | features | backed by |
+ * |---|---|---|
+ * | `road_incident` | Points: CHP incidents (category `incident`) and Caltrans planned lane closures (`closure`, SCHEDULED until set up) | events |
+ * | `chain_control` | Points: active R1/R2/R3 checkpoints and seasonal pass closures | live Caltrans |
+ * | `road_segment` | LineStrings: configured routes with travel time; `status` OPEN/CLOSED/RESTRICTED/MAINTENANCE | live Google Routes + Caltrans |
+ * | `message_sign` | Points: Caltrans message signs and their text; always INFO | live Caltrans |
+ * | `weather_alert` | null geometry: NWS zone watches/warnings/advisories | events |
+ * | `fire_weather` | one null-geometry region banner (`fw:region`) plus forecast Points | live NWS |
+ * | `earthquake` | Points | events (USGS) |
+ * | `wildfire` | Points or (Multi)Polygon perimeters | events (CAL FIRE, FIRIS) |
+ * | `evacuation` | (Multi)Polygon zones; `status` is the level | events (Cal OES) |
+ * | `power` | Polygons/Points: PG&E outages (`unplanned`/`planned`) and PSPS (`psps`) | events |
+ * | `mesh_node` | Points: MeshCore nodes in the place; always INFO | events |
+ * | `mesh_link` | LineString relay links touching the place plus the MESH_NODE Points at both ends (neighbours outside the place have `mesh.inRegion: false`); honours `window` | derived |
+ * | `camera` | Points: Caltrans CCTV cameras near the place, nearest first; always INFO | live Caltrans |
+ *
+ * Event-backed layers carry only ACTIVE and SCHEDULED features, and each
+ * feature `id` is an event id usable with `/api/v1/events/{id}`. The
+ * `.geojson` suffix is optional (`/map/wildfire` is the same resource).
+ *
+ * **Caching.** `Cache-Control: public, max-age=60` and a weak `ETag`
+ * (`W/"…"`) over the layer's content, excluding `metadata.generatedAt`.
+ * Revalidate with `If-None-Match`: the answer is `304` until the
+ * features, `sourceStatus`, `lastSourceUpdate` or `attribution` change,
+ * so polling a quiet layer costs no body.
+ *
+ */
+export const getMapLayer = (options) => (options.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        headers: zGetMapLayerHeaders.optional(),
+        path: zGetMapLayerPath,
+        query: zGetMapLayerQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGetMapLayerResponse.parseAsync(data),
+    url: '/api/v1/places/{place}/map/{layer}.geojson',
+    ...options
+});
+/**
+ * Summarize a place in one call.
+ *
+ * The dashboard headline: `mode` (QUIET, WATCH, ACTIVE), a cross-layer hazard
+ * rollup (`summary`), one block per domain (`domains`), and a source-health
+ * sidecar (`sources`). Built from the place's ACTIVE and SCHEDULED events
+ * plus the live condition layers (road segments, chain control, fire
+ * weather).
+ *
+ * Ambient state is kept out of the hazard rollup (`totalActive`,
+ * `severityCounts`, `topEvents`, `mode`): MESH nodes, BURN_STATUS, INFO-level
+ * POWER outages, and SCHEDULED road closures. MESH and BURN_STATUS appear only
+ * in their own `comms` and `burn` domains. The `evacuation` invariant: see
+ * `summary.activeEvacuations`. Computed fresh on each call; no ETag.
+ */
+export const gridServiceGetPlaceSummary = (options) => (options.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: zGridServiceGetPlaceSummaryPath,
+        query: z.never().optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceGetPlaceSummaryResponse.parseAsync(data),
+    url: '/api/v1/places/{place}/summary',
+    ...options
+});
+/**
+ * Resolve a point or an address to places.
+ *
+ * Returns every place containing the point, most specific first (SITE,
+ * EVAC_ZONE, TOWN, CORRIDOR, COUNTY, AREA). A town matches within 3 km of its
+ * point (nearest town first); a corridor within about 1.5 km of its line. Give
+ * `lat` and `lng`, or `address` (geocoded with the US Census geocoder), not
+ * both. An empty `places` list means the point is outside the covered region.
+ */
+export const gridServiceResolvePlace = (options) => (options?.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: z.never().optional(),
+        query: zGridServiceResolvePlaceQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceResolvePlaceResponse.parseAsync(data),
+    url: '/api/v1/places:resolve',
+    ...options
+});
+/**
+ * List police, fire and CHP scanner feeds.
+ *
+ * Broadcastify audio feeds that cover the region. With `place` naming an AREA,
+ * that area's feeds; with any other place, or none, every configured feed,
+ * deduplicated. Links only; audio is served by Broadcastify.
+ */
+export const gridServiceListScanners = (options) => (options?.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: z.never().optional(),
+        query: zGridServiceListScannersQuery.optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceListScannersResponse.parseAsync(data),
+    url: '/api/v1/scanners',
+    ...options
+});
+/**
+ * List sources and their health.
+ *
+ * The upstream source registry with per-source health (OK, STALE,
+ * UNAVAILABLE), last success, last attempt and last error. This is how a
+ * client decides how far to trust each layer. It also lists one health-only
+ * row per operator push reporter.
+ */
+export const gridServiceListSources = (options) => (options?.client ?? client).get({
+    requestValidator: async (data) => await z.object({
+        body: z.never().optional(),
+        path: z.never().optional(),
+        query: z.never().optional()
+    }).parseAsync(data),
+    responseValidator: async (data) => await zGridServiceListSourcesResponse.parseAsync(data),
+    url: '/api/v1/sources',
+    ...options
+});