Merge remote-tracking branch 'origin/main' into fix/v1397-derive

docs/api/openapi.yaml

@@ -41066,9 +41066,9 @@ components:
             properties:
               id:
                 type: string
-                description: Measurement row id; `sleep:<wake-day>` for a sleep night; `day:<local-day>` for a day bucket (`pulse` /
-                  `glucose` beyond 90 days); `hour:<ISO start>` for an hour bucket (`pulse` / `glucose` within 90 days
-                  when the window holds more than 10 000 readings).
+                description: Measurement row id; `sleep:<wake-day>` for a sleep night; `day:<local-day>` for a day bucket (`pulse`,
+                  `glucose`, `heartRateVariability`, `oxygenSaturation` beyond 90 days); `hour:<ISO start>` for an hour
+                  bucket (the same kinds within 90 days when the window holds more than 10 000 readings).
               at:
                 type: string
                 format: date-time
@@ -41141,12 +41141,13 @@ components:
         - stats
       additionalProperties: false
       description: "iOS-friendly per-kind time series: one point per reading (or per reconstructed night for `sleep`), an
-        explicit `unit` token, and a summary `stats` block. Sample-dense kinds are bucketed server-side: `pulse` and
-        `glucose` beyond 90 days per local day, and `pulse` / `glucose` within 90 days per local hour when the window
-        holds more than 10 000 readings (a continuous glucose sensor, a watch recording heart rate every minute; a cuff
-        or fingerstick meter stays raw). A bucket carries the mean as `value`; a `pulse` bucket also carries its range
-        as `valueMin` / `valueMax`, and a `glucose` bucket is converted to the user's unit like a raw reading. `stats`
-        is always computed over the underlying readings, never over the buckets."
+        explicit `unit` token, and a summary `stats` block. Sample-dense kinds (`pulse`, `glucose`,
+        `heartRateVariability`, `oxygenSaturation`) are bucketed server-side: beyond 90 days per local day, and within
+        90 days per local hour when the window holds more than 10 000 readings (a continuous glucose sensor, a watch or
+        ring recording every minute; a cuff, a fingerstick meter or a few readings a night stay raw). A bucket carries
+        the mean as `value` and otherwise has the shape of a reading of its kind; a `pulse` bucket also carries its
+        range as `valueMin` / `valueMax`, and a `glucose` bucket is converted to the user's unit like a raw reading.
+        `stats` is always computed over the underlying readings, never over the buckets."
     ListMeasurementsResponse:
       type: object
       properties:
@@ -41339,6 +41340,12 @@ components:
           type: integer
           minimum: 0
           maximum: 9007199254740991
+        windowFrom:
+          description: "Set on the per-night SLEEP_DURATION mode when the requested window was longer than 365 days: the instant
+            the read started from. The window is a year ending at `to` (or now); page further back by moving `to`."
+          type: string
+          format: date-time
+          pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
       required:
         - total
         - limit