@stuartshay/otel-data-types 1.0.506 → 1.0.523

package/index.d.ts

@@ -389,6 +389,30 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/garmin/laps": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Laps
+         * @description Batch laps across activities for cross-activity comparison.
+         *
+         *     Returns activities (newest first) that have at least one lap, each with
+         *     its laps ordered by ``lap_index`` ascending, so lap N can be compared
+         *     across dates. Pagination applies to activities, not individual laps.
+         */
+        get: operations["list_laps_api_v1_garmin_laps_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/garmin/activities/{activity_id}/addresses": {
         parameters: {
             query?: never;
@@ -412,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;
@@ -1518,6 +1569,19 @@ export type components = {
              */
             updated_at?: string | null;
         };
+        /**
+         * GarminActivityLapsGroup
+         * @description Laps for a single activity within the batch laps response.
+         */
+        GarminActivityLapsGroup: {
+            /** @description Parent activity summary */
+            activity: components["schemas"]["GarminLapsActivity"];
+            /**
+             * Laps
+             * @description Laps ordered by lap_index ascending
+             */
+            laps: components["schemas"]["GarminActivityLap"][];
+        };
         /**
          * GarminActivityManualUpdate
          * @description Partial manual update payload for Garmin activity records.
@@ -1934,6 +1998,62 @@ export type components = {
              */
             activity_count: number;
         };
+        /**
+         * GarminLapsActivity
+         * @description Activity summary metadata for a batch laps response item.
+         */
+        GarminLapsActivity: {
+            /**
+             * Activity Id
+             * @description Garmin activity identifier
+             */
+            activity_id: string;
+            /**
+             * Sport
+             * @description Sport type (e.g. cycling)
+             */
+            sport?: string | null;
+            /**
+             * Sub Sport
+             * @description Sub-sport type (e.g. road)
+             */
+            sub_sport?: string | null;
+            /**
+             * Start Time
+             * @description UTC activity start time
+             */
+            start_time?: string | null;
+            /**
+             * Distance Km
+             * @description Total activity distance in kilometers
+             */
+            distance_km?: number | null;
+            /**
+             * Duration Seconds
+             * @description Total activity duration in seconds
+             */
+            duration_seconds?: number | null;
+            /**
+             * Avg Speed Kmh
+             * @description Average activity speed in km/h
+             */
+            avg_speed_kmh?: number | null;
+            /**
+             * Avg Heart Rate
+             * @description Average activity heart rate in bpm
+             */
+            avg_heart_rate?: number | null;
+            /**
+             * Max Heart Rate
+             * @description Maximum activity heart rate in bpm
+             */
+            max_heart_rate?: number | null;
+            /**
+             * Total Ascent M
+             * @description Total activity elevation gain in meters
+             */
+            total_ascent_m?: number | null;
+        };
         /**
          * GarminSyncResponse
          * @description Response payload for Garmin on-demand sync trigger requests.
@@ -2751,6 +2871,29 @@ export type components = {
              */
             offset: number;
         };
+        /** PaginatedResponse[GarminActivityLapsGroup] */
+        PaginatedResponse_GarminActivityLapsGroup_: {
+            /**
+             * Items
+             * @description List of items in the current page
+             */
+            items: components["schemas"]["GarminActivityLapsGroup"][];
+            /**
+             * Total
+             * @description Total number of items matching the query
+             */
+            total: number;
+            /**
+             * Limit
+             * @description Maximum number of items per page
+             */
+            limit: number;
+            /**
+             * Offset
+             * @description Number of items skipped from the start
+             */
+            offset: number;
+        };
         /** PaginatedResponse[GarminActivity] */
         PaginatedResponse_GarminActivity_: {
             /**
@@ -3001,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.
@@ -3831,6 +4086,46 @@ export interface operations {
             };
         };
     };
+    list_laps_api_v1_garmin_laps_get: {
+        parameters: {
+            query?: {
+                /** @description Filter by sport type */
+                sport?: string | null;
+                /** @description Filter from date (YYYY-MM-DD) */
+                date_from?: string | null;
+                /** @description Filter to date (YYYY-MM-DD) */
+                date_to?: string | null;
+                /** @description Maximum number of activities to return per page */
+                limit?: number;
+                /** @description Number of activities to skip for pagination */
+                offset?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PaginatedResponse_GarminActivityLapsGroup_"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     list_activity_addresses_api_v1_garmin_activities__activity_id__addresses_get: {
         parameters: {
             query?: never;
@@ -3870,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.506",
+    "version": "1.0.523",
     "description": "TypeScript types for otel-data-api — Auto-generated from OpenAPI 3.1 specification",
     "types": "index.d.ts",
     "exports": {