@stuartshay/otel-data-types 1.0.523 → 1.0.531

package/index.d.ts

@@ -463,6 +463,80 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/garmin/segments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Segments
+         * @description List saved segments (paths), newest first.
+         */
+        get: operations["list_segments_api_v1_garmin_segments_get"];
+        put?: never;
+        /**
+         * Create Segment
+         * @description Save a new segment (path) from a climb, lap, or manual selection (auth required).
+         */
+        post: operations["create_segment_api_v1_garmin_segments_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/garmin/segments/{segment_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Segment
+         * @description Get a single saved segment by ID.
+         */
+        get: operations["get_segment_api_v1_garmin_segments__segment_id__get"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete Segment
+         * @description Delete a saved segment (auth required).
+         *
+         *     If the segment has been pushed to Garmin Connect (``garmin_segment_uuid`` is
+         *     set) it is marked ``delete_pending`` so the garmin-sync agent removes it from
+         *     Garmin and then deletes the row (end-to-end delete). Segments that were never
+         *     synced are removed immediately. Either way the segment stops appearing in the
+         *     read endpoints right away.
+         */
+        delete: operations["delete_segment_api_v1_garmin_segments__segment_id__delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/garmin/segments/{segment_id}/efforts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Segment Efforts
+         * @description Rank activity efforts over a saved segment (matches the saved start/end corridor).
+         */
+        get: operations["get_segment_efforts_api_v1_garmin_segments__segment_id__efforts_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/gps/unified": {
         parameters: {
             query?: never;
@@ -2054,6 +2128,145 @@ export type components = {
              */
             total_ascent_m?: number | null;
         };
+        /**
+         * GarminSegment
+         * @description A saved named segment (path) for cross-activity effort comparison.
+         */
+        GarminSegment: {
+            /**
+             * Id
+             * @description Unique saved segment identifier
+             */
+            id: number;
+            /**
+             * Name
+             * @description Human-readable segment name
+             */
+            name: string;
+            /**
+             * Sport
+             * @description Sport type (e.g. cycling)
+             */
+            sport?: string | null;
+            /**
+             * Start Latitude
+             * @description Segment start latitude
+             */
+            start_latitude: number;
+            /**
+             * Start Longitude
+             * @description Segment start longitude
+             */
+            start_longitude: number;
+            /**
+             * End Latitude
+             * @description Segment end latitude
+             */
+            end_latitude: number;
+            /**
+             * End Longitude
+             * @description Segment end longitude
+             */
+            end_longitude: number;
+            /**
+             * Distance Meters
+             * @description Segment distance in meters
+             */
+            distance_meters?: number | null;
+            /**
+             * Match Tolerance Meters
+             * @description Corridor radius (m) used to match traversing activities
+             */
+            match_tolerance_meters: number;
+            /**
+             * Source Activity Id
+             * @description Activity the segment was created from
+             */
+            source_activity_id?: string | null;
+            /**
+             * Source Lap Index
+             * @description Lap index the segment was created from
+             */
+            source_lap_index?: number | null;
+            /**
+             * Source Climb Index
+             * @description Climb split index the segment was created from
+             */
+            source_climb_index?: number | null;
+            /**
+             * Created At
+             * @description UTC creation timestamp
+             */
+            created_at?: string | null;
+            /**
+             * Updated At
+             * @description UTC last-update timestamp
+             */
+            updated_at?: string | null;
+        };
+        /**
+         * GarminSegmentCreate
+         * @description Request body to save a new segment (path).
+         */
+        GarminSegmentCreate: {
+            /**
+             * Name
+             * @description Human-readable segment name
+             */
+            name: string;
+            /**
+             * Sport
+             * @description Sport type; defaults to cycling
+             * @default cycling
+             */
+            sport: string | null;
+            /**
+             * Start Latitude
+             * @description Segment start latitude
+             */
+            start_latitude: number;
+            /**
+             * Start Longitude
+             * @description Segment start longitude
+             */
+            start_longitude: number;
+            /**
+             * End Latitude
+             * @description Segment end latitude
+             */
+            end_latitude: number;
+            /**
+             * End Longitude
+             * @description Segment end longitude
+             */
+            end_longitude: number;
+            /**
+             * Distance Meters
+             * @description Segment distance in meters
+             */
+            distance_meters?: number | null;
+            /**
+             * Match Tolerance Meters
+             * @description Corridor radius (m) used to match traversing activities
+             * @default 35
+             */
+            match_tolerance_meters: number;
+            /**
+             * Source Activity Id
+             * @description Activity the segment was created from
+             */
+            source_activity_id?: string | null;
+            /**
+             * Source Lap Index
+             * @description Lap index the segment was created from
+             */
+            source_lap_index?: number | null;
+            /**
+             * Source Climb Index
+             * @description Climb split index the segment was created from
+             */
+            source_climb_index?: number | null;
+        };
         /**
          * GarminSyncResponse
          * @description Response payload for Garmin on-demand sync trigger requests.
@@ -4215,6 +4428,188 @@ export interface operations {
             };
         };
     };
+    list_segments_api_v1_garmin_segments_get: {
+        parameters: {
+            query?: {
+                /** @description Filter by sport type */
+                sport?: string | null;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GarminSegment"][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    create_segment_api_v1_garmin_segments_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GarminSegmentCreate"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GarminSegment"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    get_segment_api_v1_garmin_segments__segment_id__get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Saved segment ID */
+                segment_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GarminSegment"];
+                };
+            };
+            /** @description Segment not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    delete_segment_api_v1_garmin_segments__segment_id__delete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Saved segment ID */
+                segment_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    get_segment_efforts_api_v1_garmin_segments__segment_id__efforts_get: {
+        parameters: {
+            query?: {
+                /** @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 */
+                max_effort_seconds?: number;
+                /** @description Maximum number of efforts to return */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Saved segment ID */
+                segment_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SegmentEffortsResponse"];
+                };
+            };
+            /** @description Segment 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?: {

package/package.json

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