@stuartshay/otel-data-types 1.0.514 → 1.0.523

package/index.d.ts

@@ -436,6 +436,33 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/garmin/segment-efforts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Segment Efforts
+         * @description Rank activity efforts over an ad-hoc segment defined by start/end coordinates.
+         *
+         *     Matches raw GPS track points with PostGIS: an activity qualifies when its
+         *     route passes within ``tolerance_meters`` of the start point and, later in
+         *     time, within tolerance of the end point (same direction of travel). For each
+         *     activity the shortest such start→end traversal is used, and efforts are
+         *     ranked fastest-first. Stateless (no stored segment) — the coordinate pair can
+         *     be sourced from a detected climb or lap.
+         */
+        get: operations["list_segment_efforts_api_v1_garmin_segment_efforts_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/gps/unified": {
         parameters: {
             query?: never;
@@ -3117,6 +3144,118 @@ export type components = {
              */
             description?: string | null;
         };
+        /**
+         * SegmentDefinition
+         * @description The ad-hoc segment queried for efforts (a start→end corridor).
+         */
+        SegmentDefinition: {
+            /**
+             * Start Lat
+             * @description Segment start latitude
+             */
+            start_lat: number;
+            /**
+             * Start Lon
+             * @description Segment start longitude
+             */
+            start_lon: number;
+            /**
+             * End Lat
+             * @description Segment end latitude
+             */
+            end_lat: number;
+            /**
+             * End Lon
+             * @description Segment end longitude
+             */
+            end_lon: number;
+            /**
+             * Tolerance Meters
+             * @description Corridor radius around the start/end points in meters
+             */
+            tolerance_meters: number;
+        };
+        /**
+         * SegmentEffort
+         * @description A single activity's best traversal of a segment, for cross-activity comparison.
+         */
+        SegmentEffort: {
+            /**
+             * Rank
+             * @description 1-based rank by elapsed time (1 = fastest)
+             */
+            rank: number;
+            /**
+             * Activity Id
+             * @description Garmin activity identifier
+             */
+            activity_id: string;
+            /**
+             * Sport
+             * @description Sport type (e.g. cycling)
+             */
+            sport?: string | null;
+            /**
+             * Activity Start Time
+             * @description UTC start time of the parent activity
+             */
+            activity_start_time?: string | null;
+            /**
+             * Effort Start
+             * Format: date-time
+             * @description UTC timestamp entering the segment start corridor
+             */
+            effort_start: string;
+            /**
+             * Effort End
+             * Format: date-time
+             * @description UTC timestamp reaching the segment end corridor
+             */
+            effort_end: string;
+            /**
+             * Elapsed Seconds
+             * @description Segment elapsed time in seconds
+             */
+            elapsed_seconds: number;
+            /**
+             * Distance Km
+             * @description Distance covered across the segment in km
+             */
+            distance_km?: number | null;
+            /**
+             * Avg Speed Kmh
+             * @description Average speed across the segment in km/h
+             */
+            avg_speed_kmh?: number | null;
+            /**
+             * Avg Heart Rate
+             * @description Average heart rate across the segment in bpm
+             */
+            avg_heart_rate?: number | null;
+            /**
+             * Max Heart Rate
+             * @description Maximum heart rate across the segment in bpm
+             */
+            max_heart_rate?: number | null;
+        };
+        /**
+         * SegmentEffortsResponse
+         * @description Ranked efforts for a segment across all matching activities.
+         */
+        SegmentEffortsResponse: {
+            /** @description The queried segment definition */
+            segment: components["schemas"]["SegmentDefinition"];
+            /**
+             * Total
+             * @description Number of matching efforts returned
+             */
+            total: number;
+            /**
+             * Items
+             * @description Efforts ordered fastest-first
+             */
+            items: components["schemas"]["SegmentEffort"][];
+        };
         /**
          * SportInfo
          * @description Sport type with its activity count.
@@ -4026,6 +4165,56 @@ export interface operations {
             };
         };
     };
+    list_segment_efforts_api_v1_garmin_segment_efforts_get: {
+        parameters: {
+            query: {
+                /** @description Segment start latitude */
+                start_lat: number;
+                /** @description Segment start longitude */
+                start_lon: number;
+                /** @description Segment end latitude */
+                end_lat: number;
+                /** @description Segment end longitude */
+                end_lon: number;
+                /** @description Corridor radius around the start/end points in meters */
+                tolerance_meters?: number;
+                /** @description Filter by sport type; pass an empty value to include all sports */
+                sport?: string | null;
+                /** @description Filter from date (YYYY-MM-DD) on activity start_time */
+                date_from?: string | null;
+                /** @description Filter to date (YYYY-MM-DD) on activity start_time */
+                date_to?: string | null;
+                /** @description Ignore traversals longer than this (filters loop/return mismatches) */
+                max_effort_seconds?: number;
+                /** @description Maximum number of efforts to return */
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SegmentEffortsResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     list_unified_gps_api_v1_gps_unified_get: {
         parameters: {
             query?: {

package/package.json

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