@stuartshay/otel-data-types 1.0.187 → 1.0.193

package/index.d.ts

@@ -431,6 +431,50 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/geocoding/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Geocoding Status
+         * @description Get geocoding coverage statistics.
+         */
+        get: operations["geocoding_status_api_v1_geocoding_status_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/geocoding/trigger": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Trigger Geocoding
+         * @description Trigger batch reverse-geocoding of un-geocoded location records (auth required).
+         *
+         *     Fetches the next batch of locations without a geocoded address and calls
+         *     the Pelias reverse-geocoder for each one.  Duplicate nearby coordinates
+         *     (within 50 m) that already have a geocoded address are skipped.
+         */
+        post: operations["trigger_geocoding_api_v1_geocoding_trigger_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 };
 export type webhooks = Record<string, never>;
 export type components = {
@@ -936,6 +980,156 @@ export type components = {
              */
             created_at?: string | null;
         };
+        /**
+         * GeocodedAddress
+         * @description Reverse-geocoded address components from Pelias.
+         * @example {
+         *       "confidence": 0.95,
+         *       "country": "United States",
+         *       "display_address": "123 Main St, Hoboken, NJ 07030",
+         *       "geocoded_at": "2026-02-12T08:10:55+00:00",
+         *       "housenumber": "123",
+         *       "locality": "Hoboken",
+         *       "neighbourhood": "Downtown",
+         *       "postalcode": "07030",
+         *       "region": "New Jersey",
+         *       "status": "success",
+         *       "street": "Main St"
+         *     }
+         */
+        GeocodedAddress: {
+            /**
+             * Display Address
+             * @description Full formatted address label from Pelias
+             */
+            display_address?: string | null;
+            /**
+             * Street
+             * @description Street name
+             */
+            street?: string | null;
+            /**
+             * Housenumber
+             * @description House or building number
+             */
+            housenumber?: string | null;
+            /**
+             * Neighbourhood
+             * @description Neighbourhood name
+             */
+            neighbourhood?: string | null;
+            /**
+             * Locality
+             * @description City or town
+             */
+            locality?: string | null;
+            /**
+             * Region
+             * @description State or province
+             */
+            region?: string | null;
+            /**
+             * Country
+             * @description Country name
+             */
+            country?: string | null;
+            /**
+             * Postalcode
+             * @description Postal or ZIP code
+             */
+            postalcode?: string | null;
+            /**
+             * Confidence
+             * @description Pelias confidence score (0-1)
+             */
+            confidence?: number | null;
+            /**
+             * Status
+             * @description Geocoding status: success, no_coverage, error, pending
+             */
+            status: string;
+            /**
+             * Geocoded At
+             * @description UTC timestamp when geocoding was performed
+             */
+            geocoded_at?: string | null;
+        };
+        /**
+         * GeocodingStatus
+         * @description Coverage statistics for geocoded location records.
+         * @example {
+         *       "coverage_percent": 26.67,
+         *       "errors": 100,
+         *       "geocoded": 12000,
+         *       "no_coverage": 400,
+         *       "pending": 33000,
+         *       "success": 11500,
+         *       "total_locations": 45000
+         *     }
+         */
+        GeocodingStatus: {
+            /**
+             * Total Locations
+             * @description Total number of OwnTracks location records
+             */
+            total_locations: number;
+            /**
+             * Geocoded
+             * @description Number of locations with a geocoded address (any status)
+             */
+            geocoded: number;
+            /**
+             * Success
+             * @description Number of successfully geocoded locations
+             */
+            success: number;
+            /**
+             * Pending
+             * @description Number of locations awaiting geocoding
+             */
+            pending: number;
+            /**
+             * No Coverage
+             * @description Number of locations outside Pelias coverage area
+             */
+            no_coverage: number;
+            /**
+             * Errors
+             * @description Number of locations that failed geocoding
+             */
+            errors: number;
+            /**
+             * Coverage Percent
+             * @description Percentage of locations with a geocoded address
+             */
+            coverage_percent: number;
+        };
+        /**
+         * GeocodingTriggerResponse
+         * @description Result of triggering a batch geocoding operation.
+         * @example {
+         *       "processed": 100,
+         *       "remaining": 32900,
+         *       "skipped_dedup": 35
+         *     }
+         */
+        GeocodingTriggerResponse: {
+            /**
+             * Processed
+             * @description Number of records processed in this batch
+             */
+            processed: number;
+            /**
+             * Remaining
+             * @description Number of records still awaiting geocoding
+             */
+            remaining: number;
+            /**
+             * Skipped Dedup
+             * @description Number of records skipped via proximity deduplication
+             */
+            skipped_dedup: number;
+        };
         /** HTTPValidationError */
         HTTPValidationError: {
             /** Detail */
@@ -952,6 +1146,7 @@ export type components = {
          *       "connection_type": "w",
          *       "created_at": "2026-02-12T08:10:55+00:00",
          *       "device_id": "iphone_stuart",
+         *       "display_address": "123 Main St, Hoboken, NJ 07030",
          *       "id": 101160,
          *       "latitude": 40.736238,
          *       "longitude": -74.039405,
@@ -1032,6 +1227,11 @@ export type components = {
              * @description UTC timestamp when the record was inserted into the database
              */
             created_at?: string | null;
+            /**
+             * Display Address
+             * @description Short formatted address from reverse geocoding (e.g. '123 Main St, Hoboken')
+             */
+            display_address?: string | null;
         };
         /**
          * LocationCount
@@ -1157,6 +1357,11 @@ export type components = {
              * @description UTC timestamp when the record was inserted into the database
              */
             created_at?: string | null;
+            /**
+             * Display Address
+             * @description Short formatted address from reverse geocoding (e.g. '123 Main St, Hoboken')
+             */
+            display_address?: string | null;
             /**
              * Raw Payload
              * @description Original OwnTracks JSON payload as received from the MQTT broker
@@ -1164,6 +1369,8 @@ export type components = {
             raw_payload?: {
                 [key: string]: unknown;
             } | null;
+            /** @description Full reverse-geocoded address components from Pelias */
+            address?: components["schemas"]["GeocodedAddress"] | null;
         };
         /**
          * NearbyPoint
@@ -2377,4 +2584,58 @@ export interface operations {
             };
         };
     };
+    geocoding_status_api_v1_geocoding_status_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GeocodingStatus"];
+                };
+            };
+        };
+    };
+    trigger_geocoding_api_v1_geocoding_trigger_post: {
+        parameters: {
+            query?: {
+                /** @description Number of locations to geocode in this batch */
+                batch_size?: number;
+                /** @description Re-process records with status no_coverage */
+                retry_failed?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GeocodingTriggerResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@stuartshay/otel-data-types",
-    "version": "1.0.187",
+    "version": "1.0.193",
     "description": "TypeScript types for otel-data-api — Auto-generated from OpenAPI 3.1 specification",
     "types": "index.d.ts",
     "exports": {