@stuartshay/otel-data-types 1.0.280 → 1.0.285

package/index.d.ts

@@ -322,6 +322,29 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/garmin/activities/{activity_id}/addresses": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Activity Addresses
+         * @description Return all reverse-geocoded addresses for a Garmin activity, in timestamp order.
+         *
+         *     Includes start, end, and mid-route waypoints as persisted by the Garmin
+         *     geocoding pipeline.
+         */
+        get: operations["list_activity_addresses_api_v1_garmin_activities__activity_id__addresses_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/gps/unified": {
         parameters: {
             query?: never;
@@ -524,7 +547,7 @@ export type paths = {
         };
         /**
          * Geocoding Status
-         * @description Get geocoding coverage statistics.
+         * @description Get geocoding coverage statistics for both OwnTracks and Garmin sources.
          */
         get: operations["geocoding_status_api_v1_geocoding_status_get"];
         put?: never;
@@ -546,11 +569,7 @@ export type paths = {
         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.
+         * @description Trigger batch reverse-geocoding of OwnTracks location records (auth required).
          */
         post: operations["trigger_geocoding_api_v1_geocoding_trigger_post"];
         delete?: never;
@@ -559,6 +578,26 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/geocoding/trigger/garmin": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Trigger Garmin Geocoding
+         * @description Trigger batch reverse-geocoding of Garmin activity waypoints (auth required).
+         */
+        post: operations["trigger_garmin_geocoding_api_v1_geocoding_trigger_garmin_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 };
 export type webhooks = Record<string, never>;
 export type components = {
@@ -887,6 +926,99 @@ export type components = {
              */
             track_point_count?: number | null;
         };
+        /**
+         * GarminActivityAddress
+         * @description Reverse-geocoded address attached to a Garmin activity waypoint.
+         */
+        GarminActivityAddress: {
+            /**
+             * Track Point Id
+             * @description garmin_track_points.id this address was geocoded from
+             */
+            track_point_id: number;
+            /**
+             * Activity Id
+             * @description Parent Garmin activity identifier
+             */
+            activity_id: string;
+            /**
+             * Waypoint Kind
+             * @description Role of this waypoint: start, end, or mid-route waypoint
+             * @enum {string}
+             */
+            waypoint_kind: "start" | "end" | "waypoint";
+            /**
+             * Timestamp
+             * Format: date-time
+             * @description UTC timestamp of the track point this address was derived from
+             */
+            timestamp: string;
+            /**
+             * Latitude
+             * @description GPS latitude in decimal degrees (WGS 84)
+             */
+            latitude: number;
+            /**
+             * Longitude
+             * @description GPS longitude in decimal degrees (WGS 84)
+             */
+            longitude: number;
+            /**
+             * 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;
+        };
         /**
          * GarminActivityTotal
          * @description Aggregated Garmin activity totals for a single time bucket (week/month/year).
@@ -1152,6 +1284,8 @@ export type components = {
              * @description UTC timestamp when the record was inserted
              */
             created_at?: string | null;
+            /** @description Reverse-geocoded address for this track point (Garmin pipeline). Only populated for waypoints that have been geocoded. */
+            address?: components["schemas"]["GeocodedAddressSummary"] | null;
         };
         /**
          * GeocodedAddress
@@ -1227,6 +1361,74 @@ export type components = {
              */
             geocoded_at?: string | null;
         };
+        /**
+         * GeocodedAddressSummary
+         * @description Compact address summary embedded in track-point payloads.
+         */
+        GeocodedAddressSummary: {
+            /**
+             * Display Address
+             * @description Full formatted address label from Pelias
+             */
+            display_address?: 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;
+            /**
+             * Waypoint Kind
+             * @description Role of this waypoint (Garmin only)
+             */
+            waypoint_kind?: ("start" | "end" | "waypoint") | null;
+            /**
+             * Status
+             * @description Geocoding status: success, no_coverage, error, pending
+             */
+            status: string;
+        };
+        /**
+         * GeocodingSourceStatus
+         * @description Coverage statistics for a single geocoding source (owntracks or garmin).
+         */
+        GeocodingSourceStatus: {
+            /**
+             * Success
+             * @description Number of successfully geocoded records for this source
+             */
+            success: number;
+            /**
+             * Pending
+             * @description Number of records awaiting geocoding for this source
+             * @default 0
+             */
+            pending: number;
+            /**
+             * No Coverage
+             * @description Number of records outside Pelias coverage area
+             */
+            no_coverage: number;
+            /**
+             * Errors
+             * @description Number of records that failed geocoding
+             */
+            errors: number;
+            /**
+             * Total
+             * @description Total number of geocoded_addresses rows for this source
+             */
+            total: number;
+        };
         /**
          * GeocodingStatus
          * @description Coverage statistics for geocoded location records.
@@ -1276,6 +1478,33 @@ export type components = {
              * @description Percentage of locations with a geocoded address
              */
             coverage_percent: number;
+            /** @description Per-source breakdown of geocoding coverage (owntracks, garmin) */
+            by_source: components["schemas"]["GeocodingStatusBySource"];
+        };
+        /**
+         * GeocodingStatusBySource
+         * @description Per-source breakdown of geocoding coverage.
+         */
+        GeocodingStatusBySource: {
+            /** @description Coverage stats for OwnTracks rows */
+            owntracks: components["schemas"]["GeocodingSourceStatus"];
+            /** @description Coverage stats for Garmin rows */
+            garmin: components["schemas"]["GeocodingSourceStatus"];
+            /**
+             * Garmin Activities Total
+             * @description Total number of Garmin activities (denominator for activity-level coverage)
+             */
+            garmin_activities_total: number;
+            /**
+             * Garmin Activities Geocoded
+             * @description Number of Garmin activities that have at least one address row
+             */
+            garmin_activities_geocoded: number;
+            /**
+             * Garmin Coverage Percent
+             * @description Percentage of Garmin activities with at least one geocoded address
+             */
+            garmin_coverage_percent: number;
         };
         /**
          * GeocodingTriggerResponse
@@ -2527,6 +2756,45 @@ export interface operations {
             };
         };
     };
+    list_activity_addresses_api_v1_garmin_activities__activity_id__addresses_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Garmin activity ID */
+                activity_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GarminActivityAddress"][];
+                };
+            };
+            /** @description Activity not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     list_unified_gps_api_v1_gps_unified_get: {
         parameters: {
             query?: {
@@ -2958,4 +3226,40 @@ export interface operations {
             };
         };
     };
+    trigger_garmin_geocoding_api_v1_geocoding_trigger_garmin_post: {
+        parameters: {
+            query?: {
+                /** @description Number of Garmin activities to process in this batch */
+                batch_size?: number;
+                /** @description Approximate spacing between mid-route waypoints in kilometres */
+                waypoint_spacing_km?: number;
+                /** @description Re-process activities with at least one no_coverage waypoint */
+                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.280",
+    "version": "1.0.285",
     "description": "TypeScript types for otel-data-api — Auto-generated from OpenAPI 3.1 specification",
     "types": "index.d.ts",
     "exports": {