@stuartshay/otel-data-types 1.0.292 → 1.0.430

package/index.d.ts

@@ -271,7 +271,11 @@ export type paths = {
         delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
+        /**
+         * Patch Activity
+         * @description Manually patch Garmin activity fields (auth required when OAuth2 is enabled).
+         */
+        patch: operations["patch_activity_api_v1_garmin_activities__activity_id__patch"];
         trace?: never;
     };
     "/api/v1/garmin/activities/{activity_id}/tracks": {
@@ -548,6 +552,11 @@ export type paths = {
         /**
          * Geocoding Status
          * @description Get geocoding coverage statistics for both OwnTracks and Garmin sources.
+         *
+         *     The underlying aggregates scan large tables (millions of garmin_track_points)
+         *     and change slowly, so the response is cached per-process for
+         *     ``_STATUS_CACHE_TTL_SECONDS`` to avoid repeatedly running the heavy COUNT
+         *     queries on every dashboard poll.
          */
         get: operations["geocoding_status_api_v1_geocoding_status_get"];
         put?: never;
@@ -558,6 +567,31 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/geocoding/pelias-health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Pelias Health
+         * @description Probe the upstream Pelias reverse-geocoder with a known-good coordinate.
+         *
+         *     Returns 200 with ``healthy=false`` rather than failing so that callers
+         *     (Airflow sensors, dashboards) can branch on the boolean. Used as a
+         *     pre-flight gate before batched trigger runs to avoid recording large
+         *     numbers of false-positive errors during a Pelias outage.
+         */
+        get: operations["pelias_health_api_v1_geocoding_pelias_health_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/geocoding/trigger": {
         parameters: {
             query?: never;
@@ -598,6 +632,26 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/geocoding/trigger/garmin-dense": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Trigger Garmin Dense
+         * @description Trigger batch reverse-geocoding of distinct 4dp GPS cells (auth required).
+         */
+        post: operations["trigger_garmin_dense_api_v1_geocoding_trigger_garmin_dense_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 };
 export type webhooks = Record<string, never>;
 export type components = {
@@ -761,9 +815,12 @@ export type components = {
          * @description Summary of a Garmin Connect activity parsed from a FIT file.
          * @example {
          *       "activity_id": "20932993811",
+         *       "aerobic_training_effect": 2.6,
+         *       "anaerobic_training_effect": 0,
          *       "avg_cadence": 78,
          *       "avg_heart_rate": 142,
          *       "avg_pace": 3.513345,
+         *       "avg_respiration_rate": 25,
          *       "avg_speed_kmh": 26.3,
          *       "avg_temperature_c": 18,
          *       "calories": 1689,
@@ -772,21 +829,32 @@ export type components = {
          *       "distance_km": 50.6,
          *       "duration_seconds": 6932,
          *       "end_time": "2025-11-08T20:16:45+00:00",
+         *       "exercise_load": 48,
+         *       "hr_available": true,
          *       "max_cadence": 112,
          *       "max_heart_rate": 178,
+         *       "max_respiration_rate": 32,
          *       "max_speed_kmh": 48.7,
          *       "max_temperature_c": 22,
+         *       "min_heart_rate": 98,
+         *       "min_respiration_rate": 16,
          *       "min_temperature_c": 14,
+         *       "moderate_intensity_minutes": 88,
+         *       "paved_distance_km": 21.09,
          *       "sport": "cycling",
          *       "start_time": "2025-11-08T18:21:13+00:00",
          *       "sub_sport": "road",
+         *       "sweat_loss_ml": 1629,
          *       "total_ascent_m": 385,
          *       "total_descent_m": 380,
          *       "total_distance": 50598.95,
          *       "total_elapsed_time": 7200.5,
+         *       "total_intensity_minutes": 146,
          *       "total_timer_time": 6932.1,
          *       "track_point_count": 10707,
-         *       "uploaded_at": "2026-02-09T23:56:37+00:00"
+         *       "unpaved_distance_km": 0.65,
+         *       "uploaded_at": "2026-02-09T23:56:37+00:00",
+         *       "vigorous_intensity_minutes": 29
          *     }
          */
         GarminActivity: {
@@ -835,6 +903,77 @@ export type components = {
              * @description Maximum heart rate in beats per minute
              */
             max_heart_rate?: number | null;
+            /**
+             * Hr Available
+             * @description Whether this activity has usable heart-rate data in summary or track points
+             * @default false
+             */
+            hr_available: boolean;
+            /**
+             * Min Heart Rate
+             * @description Minimum heart rate in beats per minute
+             */
+            min_heart_rate?: number | null;
+            /**
+             * Aerobic Training Effect
+             * @description Aerobic training effect score
+             */
+            aerobic_training_effect?: number | null;
+            /**
+             * Anaerobic Training Effect
+             * @description Anaerobic training effect score
+             */
+            anaerobic_training_effect?: number | null;
+            /**
+             * Exercise Load
+             * @description Exercise load score
+             */
+            exercise_load?: number | null;
+            /**
+             * Avg Respiration Rate
+             * @description Average respiration rate in breaths per minute
+             */
+            avg_respiration_rate?: number | null;
+            /**
+             * Min Respiration Rate
+             * @description Minimum respiration rate in breaths per minute
+             */
+            min_respiration_rate?: number | null;
+            /**
+             * Max Respiration Rate
+             * @description Maximum respiration rate in breaths per minute
+             */
+            max_respiration_rate?: number | null;
+            /**
+             * Sweat Loss Ml
+             * @description Estimated sweat loss in millilitres
+             */
+            sweat_loss_ml?: number | null;
+            /**
+             * Moderate Intensity Minutes
+             * @description Moderate intensity minutes
+             */
+            moderate_intensity_minutes?: number | null;
+            /**
+             * Vigorous Intensity Minutes
+             * @description Vigorous intensity minutes
+             */
+            vigorous_intensity_minutes?: number | null;
+            /**
+             * Total Intensity Minutes
+             * @description Total intensity minutes
+             */
+            total_intensity_minutes?: number | null;
+            /**
+             * Paved Distance Km
+             * @description Distance over paved surfaces in kilometres
+             */
+            paved_distance_km?: number | null;
+            /**
+             * Unpaved Distance Km
+             * @description Distance over unpaved surfaces in kilometres
+             */
+            unpaved_distance_km?: number | null;
             /**
              * Avg Cadence
              * @description Average cadence in RPM
@@ -1019,6 +1158,204 @@ export type components = {
              */
             geocoded_at?: string | null;
         };
+        /**
+         * GarminActivityManualUpdate
+         * @description Partial manual update payload for Garmin activity records.
+         * @example {
+         *       "aerobic_training_effect": 3.2,
+         *       "avg_cadence": 82,
+         *       "avg_heart_rate": 141,
+         *       "device_manufacturer": "polar_electro",
+         *       "max_heart_rate": 172
+         *     }
+         */
+        GarminActivityManualUpdate: {
+            /**
+             * Sport
+             * @description Primary sport type (e.g. cycling, running)
+             */
+            sport?: string | null;
+            /**
+             * Sub Sport
+             * @description Sub-sport classification (e.g. road, trail)
+             */
+            sub_sport?: string | null;
+            /**
+             * Start Time
+             * @description Activity start time in UTC
+             */
+            start_time?: string | null;
+            /**
+             * End Time
+             * @description Activity end time in UTC
+             */
+            end_time?: string | null;
+            /**
+             * Distance Km
+             * @description Total distance in kilometres
+             */
+            distance_km?: number | null;
+            /**
+             * Duration Seconds
+             * @description Active duration in seconds (excludes pauses)
+             */
+            duration_seconds?: number | null;
+            /**
+             * Avg Heart Rate
+             * @description Average heart rate in beats per minute
+             */
+            avg_heart_rate?: number | null;
+            /**
+             * Max Heart Rate
+             * @description Maximum heart rate in beats per minute
+             */
+            max_heart_rate?: number | null;
+            /**
+             * Min Heart Rate
+             * @description Minimum heart rate in beats per minute
+             */
+            min_heart_rate?: number | null;
+            /**
+             * Aerobic Training Effect
+             * @description Aerobic training effect score
+             */
+            aerobic_training_effect?: number | null;
+            /**
+             * Anaerobic Training Effect
+             * @description Anaerobic training effect score
+             */
+            anaerobic_training_effect?: number | null;
+            /**
+             * Exercise Load
+             * @description Exercise load score
+             */
+            exercise_load?: number | null;
+            /**
+             * Avg Respiration Rate
+             * @description Average respiration rate in breaths per minute
+             */
+            avg_respiration_rate?: number | null;
+            /**
+             * Min Respiration Rate
+             * @description Minimum respiration rate in breaths per minute
+             */
+            min_respiration_rate?: number | null;
+            /**
+             * Max Respiration Rate
+             * @description Maximum respiration rate in breaths per minute
+             */
+            max_respiration_rate?: number | null;
+            /**
+             * Sweat Loss Ml
+             * @description Estimated sweat loss in millilitres
+             */
+            sweat_loss_ml?: number | null;
+            /**
+             * Moderate Intensity Minutes
+             * @description Moderate intensity minutes
+             */
+            moderate_intensity_minutes?: number | null;
+            /**
+             * Vigorous Intensity Minutes
+             * @description Vigorous intensity minutes
+             */
+            vigorous_intensity_minutes?: number | null;
+            /**
+             * Total Intensity Minutes
+             * @description Total intensity minutes
+             */
+            total_intensity_minutes?: number | null;
+            /**
+             * Paved Distance Km
+             * @description Distance over paved surfaces in kilometres
+             */
+            paved_distance_km?: number | null;
+            /**
+             * Unpaved Distance Km
+             * @description Distance over unpaved surfaces in kilometres
+             */
+            unpaved_distance_km?: number | null;
+            /**
+             * Avg Cadence
+             * @description Average cadence in RPM
+             */
+            avg_cadence?: number | null;
+            /**
+             * Max Cadence
+             * @description Maximum cadence in RPM
+             */
+            max_cadence?: number | null;
+            /**
+             * Calories
+             * @description Total calories burned
+             */
+            calories?: number | null;
+            /**
+             * Avg Speed Kmh
+             * @description Average speed in km/h
+             */
+            avg_speed_kmh?: number | null;
+            /**
+             * Max Speed Kmh
+             * @description Maximum speed in km/h
+             */
+            max_speed_kmh?: number | null;
+            /**
+             * Total Ascent M
+             * @description Total elevation gain in meters
+             */
+            total_ascent_m?: number | null;
+            /**
+             * Total Descent M
+             * @description Total elevation loss in meters
+             */
+            total_descent_m?: number | null;
+            /**
+             * Total Distance
+             * @description Raw total distance in meters from FIT file
+             */
+            total_distance?: number | null;
+            /**
+             * Avg Pace
+             * @description Average pace in minutes per kilometre
+             */
+            avg_pace?: number | null;
+            /**
+             * Device Manufacturer
+             * @description Device manufacturer (e.g. garmin)
+             */
+            device_manufacturer?: string | null;
+            /**
+             * Avg Temperature C
+             * @description Average ambient temperature in degrees C
+             */
+            avg_temperature_c?: number | null;
+            /**
+             * Min Temperature C
+             * @description Minimum ambient temperature in degrees C
+             */
+            min_temperature_c?: number | null;
+            /**
+             * Max Temperature C
+             * @description Maximum ambient temperature in degrees C
+             */
+            max_temperature_c?: number | null;
+            /**
+             * Total Elapsed Time
+             * @description Total elapsed time in seconds (includes pauses)
+             */
+            total_elapsed_time?: number | null;
+            /**
+             * Total Timer Time
+             * @description Total timer time in seconds (active recording)
+             */
+            total_timer_time?: number | null;
+            /**
+             * Uploaded At
+             * @description UTC timestamp when the FIT file was uploaded
+             */
+            uploaded_at?: string | null;
+        };
         /**
          * GarminActivityTotal
          * @description Aggregated Garmin activity totals for a single time bucket (week/month/year).
@@ -1071,10 +1408,14 @@ export type components = {
          *       "altitude": 12.4,
          *       "cadence": 80,
          *       "distance_from_start_km": 0,
+         *       "effort_level": "steady",
          *       "heart_rate": 135,
+         *       "hr_zone": 3,
          *       "latitude": 40.71501586586237,
          *       "longitude": -74.01768794283271,
+         *       "respiration_rate": 22,
          *       "speed_kmh": 24.5,
+         *       "surface_type": "paved",
          *       "temperature_c": 18,
          *       "timestamp": "2025-11-08T18:21:13Z"
          *     }
@@ -1106,6 +1447,16 @@ export type components = {
              * @description Heart rate in beats per minute
              */
             heart_rate?: number | null;
+            /**
+             * Hr Zone
+             * @description Heart-rate zone index (1-5)
+             */
+            hr_zone?: number | null;
+            /**
+             * Respiration Rate
+             * @description Respiration rate in breaths per minute
+             */
+            respiration_rate?: number | null;
             /**
              * Cadence
              * @description Pedal/step cadence in RPM
@@ -1116,6 +1467,16 @@ export type components = {
              * @description Ambient temperature in degrees C
              */
             temperature_c?: number | null;
+            /**
+             * Surface Type
+             * @description Road or terrain type
+             */
+            surface_type?: string | null;
+            /**
+             * Effort Level
+             * @description Effort classification label
+             */
+            effort_level?: string | null;
             /**
              * Latitude
              * @description GPS latitude in decimal degrees (WGS 84)
@@ -1213,11 +1574,15 @@ export type components = {
          *       "cadence": 80,
          *       "created_at": "2026-02-09T23:56:37Z",
          *       "distance_from_start_km": 0,
+         *       "effort_level": "steady",
          *       "heart_rate": 135,
+         *       "hr_zone": 3,
          *       "id": 7454,
          *       "latitude": 40.71501586586237,
          *       "longitude": -74.01768794283271,
+         *       "respiration_rate": 22,
          *       "speed_kmh": 24.5,
+         *       "surface_type": "paved",
          *       "temperature_c": 18,
          *       "timestamp": "2025-11-08T18:21:13Z"
          *     }
@@ -1269,6 +1634,16 @@ export type components = {
              * @description Heart rate in beats per minute
              */
             heart_rate?: number | null;
+            /**
+             * Hr Zone
+             * @description Heart-rate zone index (1-5)
+             */
+            hr_zone?: number | null;
+            /**
+             * Respiration Rate
+             * @description Respiration rate in breaths per minute
+             */
+            respiration_rate?: number | null;
             /**
              * Cadence
              * @description Pedal/step cadence in RPM
@@ -1279,6 +1654,16 @@ export type components = {
              * @description Ambient temperature in degrees C
              */
             temperature_c?: number | null;
+            /**
+             * Surface Type
+             * @description Road or terrain type
+             */
+            surface_type?: string | null;
+            /**
+             * Effort Level
+             * @description Effort classification label
+             */
+            effort_level?: string | null;
             /**
              * Created At
              * @description UTC timestamp when the record was inserted
@@ -1371,6 +1756,21 @@ export type components = {
              * @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
@@ -1386,6 +1786,16 @@ export type components = {
              * @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;
             /**
              * Waypoint Kind
              * @description Role of this waypoint (Garmin only)
@@ -1396,6 +1806,11 @@ export type components = {
              * @description Geocoding status: success, no_coverage, error, pending
              */
             status: string;
+            /**
+             * Geocoded At
+             * @description UTC timestamp when geocoding was performed
+             */
+            geocoded_at?: string | null;
         };
         /**
          * GeocodingSourceStatus
@@ -1480,6 +1895,48 @@ export type components = {
             coverage_percent: number;
             /** @description Per-source breakdown of geocoding coverage (owntracks, garmin) */
             by_source: components["schemas"]["GeocodingStatusBySource"];
+            /**
+             * Dense Cells Total
+             * @description Total number of distinct 4dp (~11m) GPS cells observed in garmin_track_points
+             * @default 0
+             */
+            dense_cells_total: number;
+            /**
+             * Dense Cells Geocoded
+             * @description Number of dense cells with any geocoding row (any status)
+             * @default 0
+             */
+            dense_cells_geocoded: number;
+            /**
+             * Dense Cells Success
+             * @description Number of dense cells with status='success'
+             * @default 0
+             */
+            dense_cells_success: number;
+            /**
+             * Dense Cells Pending
+             * @description Number of dense cells awaiting geocoding
+             * @default 0
+             */
+            dense_cells_pending: number;
+            /**
+             * Dense Cells No Coverage
+             * @description Number of dense cells outside Pelias coverage
+             * @default 0
+             */
+            dense_cells_no_coverage: number;
+            /**
+             * Dense Cells Errors
+             * @description Number of dense cells that failed geocoding
+             * @default 0
+             */
+            dense_cells_errors: number;
+            /**
+             * Dense Point Coverage Percent
+             * @description Percentage of garmin_track_points whose 4dp cell has any geocoded row
+             * @default 0
+             */
+            dense_point_coverage_percent: number;
         };
         /**
          * GeocodingStatusBySource
@@ -1505,6 +1962,12 @@ export type components = {
              * @description Percentage of Garmin activities with at least one geocoded address
              */
             garmin_coverage_percent: number;
+            /**
+             * Garmin Waypoint Success Percent
+             * @description Percentage of Garmin waypoint rows with status='success' (success / (success + pending + no_coverage + error)).
+             * @default 0
+             */
+            garmin_waypoint_success_percent: number;
         };
         /**
          * GeocodingTriggerResponse
@@ -1956,6 +2419,33 @@ export type components = {
              */
             offset: number;
         };
+        /**
+         * PeliasHealth
+         * @description Result of an upstream Pelias reverse-geocoder health probe.
+         */
+        PeliasHealth: {
+            /**
+             * Healthy
+             * @description True when Pelias returned a usable feature for the probe coordinate.
+             */
+            healthy: boolean;
+            /**
+             * Latency Ms
+             * @description Round-trip latency for the probe request, in milliseconds.
+             */
+            latency_ms: number;
+            /**
+             * Sample Features Count
+             * @description Number of features returned by the probe (0 means the probe failed).
+             * @default 0
+             */
+            sample_features_count: number;
+            /**
+             * Detail
+             * @description Failure detail when not healthy (timeout, transport error, non-2xx status).
+             */
+            detail?: string | null;
+        };
         /**
          * ReferenceLocation
          * @description Named geographic reference point used for spatial queries (e.g. home, office).
@@ -2436,6 +2926,12 @@ export interface operations {
                 lookback?: number | null;
                 /** @description Optional sync window in hours. Positive integer. */
                 window_hours?: number | null;
+                /** @description Whether to re-sync activities that already exist in the database. */
+                resync_existing?: boolean | null;
+                /** @description Optional Garmin activity_id filter (repeatable). */
+                activity_id?: string[] | null;
+                /** @description Optional Garmin activity_ids filter (repeatable). */
+                activity_ids?: string[] | null;
             };
             header?: never;
             path?: never;
@@ -2667,6 +3163,63 @@ export interface operations {
             };
         };
     };
+    patch_activity_api_v1_garmin_activities__activity_id__patch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Garmin activity ID */
+                activity_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GarminActivityManualUpdate"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GarminActivity"];
+                };
+            };
+            /** @description No fields to update */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Authentication required */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @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_track_points_api_v1_garmin_activities__activity_id__tracks_get: {
         parameters: {
             query?: {
@@ -3192,12 +3745,32 @@ export interface operations {
             };
         };
     };
+    pelias_health_api_v1_geocoding_pelias_health_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"]["PeliasHealth"];
+                };
+            };
+        };
+    };
     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 */
+                /** @description Re-process records with statuses no_coverage or error */
                 retry_failed?: boolean;
             };
             header?: never;
@@ -3233,7 +3806,41 @@ export interface operations {
                 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 */
+                /** @description Re-process activities with at least one waypoint in statuses no_coverage or error */
+                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"];
+                };
+            };
+        };
+    };
+    trigger_garmin_dense_api_v1_geocoding_trigger_garmin_dense_post: {
+        parameters: {
+            query?: {
+                /** @description Number of dense cells to process in this batch */
+                batch_size?: number;
+                /** @description Re-process cells whose status is no_coverage, error, or pending */
                 retry_failed?: boolean;
             };
             header?: never;

package/package.json

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