@stuartshay/otel-data-types 1.0.656 → 1.0.666

package/index.d.ts

@@ -606,6 +606,54 @@ export type paths = {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/garmin/segments/{segment_id}/effort-series": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Segment Effort Series
+         * @description Return one effort's speed/HR series binned by distance along the segment.
+         *
+         *     Bins are normalized to the effort's own traversal; each fraction is the
+         *     bin midpoint in the open interval between the start and end corridors.
+         *     Series from different activities are therefore directly comparable at the
+         *     same fraction despite GPS odometer drift.
+         *     The effort window is trusted client input from the efforts endpoint and is
+         *     returned normalized to UTC; an arbitrary window merely aggregates the
+         *     caller's own read-only track data.
+         */
+        get: operations["get_segment_effort_series_api_v1_garmin_segments__segment_id__effort_series_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/garmin/segments/{segment_id}/effort-series/batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Get Segment Effort Series Batch
+         * @description Return multiple effort series in request order using one database query.
+         */
+        post: operations["get_segment_effort_series_batch_api_v1_garmin_segments__segment_id__effort_series_batch_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/gps/unified": {
         parameters: {
             query?: never;
@@ -3957,6 +4005,119 @@ export type components = {
              */
             max_heart_rate?: number | null;
         };
+        /**
+         * SegmentEffortSeriesBatchItem
+         * @description One effort window requested as part of a batch series lookup.
+         */
+        SegmentEffortSeriesBatchItem: {
+            /**
+             * Activity Id
+             * @description Garmin activity identifier
+             */
+            activity_id: string;
+            /**
+             * Effort Start
+             * Format: date-time
+             * @description Effort start timestamp returned by the efforts endpoint
+             */
+            effort_start: string;
+            /**
+             * Effort End
+             * Format: date-time
+             * @description Effort end timestamp returned by the efforts endpoint
+             */
+            effort_end: string;
+        };
+        /**
+         * SegmentEffortSeriesBatchRequest
+         * @description Bounded collection of effort windows to bin in one database query.
+         */
+        SegmentEffortSeriesBatchRequest: {
+            /**
+             * Efforts
+             * @description Effort windows processed and returned in request order
+             */
+            efforts: components["schemas"]["SegmentEffortSeriesBatchItem"][];
+            /**
+             * Bins
+             * @description Number of distance bins per effort
+             * @default 100
+             */
+            bins: number;
+        };
+        /**
+         * SegmentEffortSeriesBatchResponse
+         * @description Distance-binned series returned in the same order as the batch request.
+         */
+        SegmentEffortSeriesBatchResponse: {
+            /**
+             * Items
+             * @description Effort series in request order
+             */
+            items: components["schemas"]["SegmentEffortSeriesResponse"][];
+        };
+        /**
+         * SegmentEffortSeriesBin
+         * @description One distance bin of an effort's speed/heart-rate series along a segment.
+         */
+        SegmentEffortSeriesBin: {
+            /**
+             * Index
+             * @description 0-based bin index from segment start
+             */
+            index: number;
+            /**
+             * Fraction
+             * @description Bin midpoint strictly within (0, 1) of the effort's traversal distance
+             */
+            fraction: number;
+            /**
+             * Speed Kmh
+             * @description Average speed within the bin in km/h
+             */
+            speed_kmh?: number | null;
+            /**
+             * Heart Rate
+             * @description Average heart rate within the bin in bpm
+             */
+            heart_rate?: number | null;
+        };
+        /**
+         * SegmentEffortSeriesResponse
+         * @description A single effort's speed/HR series, binned by normalized distance along the segment.
+         *
+         *     ``bins`` always contains exactly ``bin_count`` entries ordered by index;
+         *     bins with no samples (GPS gaps, degenerate traversals) carry null metrics.
+         */
+        SegmentEffortSeriesResponse: {
+            /**
+             * Activity Id
+             * @description Garmin activity identifier
+             */
+            activity_id: string;
+            /**
+             * 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;
+            /**
+             * Bin Count
+             * @description Number of distance bins in the series
+             */
+            bin_count: number;
+            /**
+             * Bins
+             * @description Distance-ordered bins spanning the traversal
+             */
+            bins: components["schemas"]["SegmentEffortSeriesBin"][];
+        };
         /**
          * SegmentEffortsResponse
          * @description Ranked efforts for a segment across all matching activities.
@@ -5279,6 +5440,97 @@ export interface operations {
             };
         };
     };
+    get_segment_effort_series_api_v1_garmin_segments__segment_id__effort_series_get: {
+        parameters: {
+            query: {
+                /** @description Garmin activity ID */
+                activity_id: string;
+                /** @description Effort start timestamp, exactly as returned by the efforts endpoint */
+                effort_start: string;
+                /** @description Effort end timestamp, exactly as returned by the efforts endpoint */
+                effort_end: string;
+                /** @description Number of distance bins in the series */
+                bins?: 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"]["SegmentEffortSeriesResponse"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    get_segment_effort_series_batch_api_v1_garmin_segments__segment_id__effort_series_batch_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Saved segment ID */
+                segment_id: number;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SegmentEffortSeriesBatchRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SegmentEffortSeriesBatchResponse"];
+                };
+            };
+            /** @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.656",
+    "version": "1.0.666",
     "description": "TypeScript types for otel-data-api — Auto-generated from OpenAPI 3.1 specification",
     "types": "index.d.ts",
     "exports": {