@molecule/api-wearable-oura 1.0.3 → 1.0.5

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-16T23:32:18.845Z
+Generated: 2026-11-08T06:03:26.846Z
 -->
 
 # @molecule/api-wearable-oura
@@ -396,6 +396,7 @@ error path must be sanitized.
 interface WearableProvider {
   /** Stable provider key used for credential-store segregation, e.g. `"fitbit"`. */
   readonly providerName: string
+
   /**
    * Reads the daily activity rollup for `(userId, date)`.
    *
@@ -404,6 +405,7 @@ interface WearableProvider {
    * @returns Normalized daily activity.
    */
   getDailyActivity(userId: string, date: WearableDate): Promise<DailyActivity>
+
   /**
    * Reads sleep sessions bucketed under `(userId, date)`. Most days return
    * a single primary session; multi-nap days return multiple.
@@ -413,6 +415,7 @@ interface WearableProvider {
    * @returns All sleep sessions bucketed under that day.
    */
   getDailySleep(userId: string, date: WearableDate): Promise<SleepSession[]>
+
   /**
    * Reads the daily heart-rate summary for `(userId, date)`.
    *
@@ -421,6 +424,7 @@ interface WearableProvider {
    * @returns Normalized daily heart-rate summary.
    */
   getDailyHeartRate(userId: string, date: WearableDate): Promise<HeartRateSummary>
+
   /**
    * Reads body-weight entries for the user across `range`. Providers cap
    * how far back a single call may reach — implementations should clamp
@@ -432,6 +436,7 @@ interface WearableProvider {
    * @returns Weight entries, ordered by `recordedAt` ascending.
    */
   getWeight(userId: string, range: WearableDateRange): Promise<WeightEntry[]>
+
   /**
    * Exchanges an OAuth authorization `code` for tokens and persists the
    * resulting {@link UserConnection} via the bond's credentials store.
@@ -441,6 +446,7 @@ interface WearableProvider {
    * @returns The freshly-minted connection (already persisted).
    */
   connect(userId: string, code: string): Promise<UserConnection>
+
   /**
    * Forces a refresh of the user's access token using the stored refresh
    * token. The rotated connection is persisted before being returned.
@@ -449,6 +455,7 @@ interface WearableProvider {
    * @returns The rotated connection (already persisted).
    */
   refreshConnection(userId: string): Promise<UserConnection>
+
   /**
    * Revokes (best-effort) and removes the user's connection record.
    *
@@ -495,7 +502,7 @@ type SleepStage = 'awake' | 'light' | 'deep' | 'rem' | 'restless' | 'asleep' | '
 Base64url-encodes the bytes (RFC 4648 §5 with `=` padding stripped).
 
 ```typescript
-function base64UrlEncode(bytes: Uint8Array<ArrayBufferLike>): string
+function base64UrlEncode(bytes: Uint8Array): string
 ```
 
 - `bytes` — The bytes to encode.
@@ -509,7 +516,10 @@ normalized {@link DailyActivity} shape. Missing fields are
 zero-defaulted so handlers can sum across days without null guards.
 
 ```typescript
-function fromOuraActivity(date: string, entry: OuraDailyActivityEntry | undefined): DailyActivity
+function fromOuraActivity(
+  date: WearableDate,
+  entry: OuraDailyActivityEntry | undefined,
+): DailyActivity
 ```
 
 - `date` — The calendar day requested.
@@ -562,7 +572,7 @@ sleep — the bond marks any matching session as `isMainSleep: true`,
 with naps and short sessions as `false`.
 
 ```typescript
-function fromOuraSleep(date: string, raw: OuraSleepResponse): SleepSession[]
+function fromOuraSleep(date: WearableDate, raw: OuraSleepResponse): SleepSession[]
 ```
 
 - `date` — Calendar day requested.
@@ -581,7 +591,7 @@ from the minimum sample of the day. Zone data is not reported by this
 endpoint, so `zones` is left undefined.
 
 ```typescript
-function fromOuraHeartRate(date: string, raw: OuraHeartRateResponse): HeartRateSummary
+function fromOuraHeartRate(date: WearableDate, raw: OuraHeartRateResponse): HeartRateSummary
 ```
 
 - `date` — Calendar day the response was requested for.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-wearable-oura",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Oura Ring Cloud API v2 bond for molecule.dev — daily activity, sleep (REM/deep/light), and heart-rate ingestion via OAuth 2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -38,8 +38,8 @@
     "@molecule/api-wearable": "^1.0.1"
   },
   "devDependencies": {
-    "@molecule/api-bond": "1.0.3",
-    "@molecule/api-http": "1.0.3",
+    "@molecule/api-bond": "1.0.4",
+    "@molecule/api-http": "1.0.5",
     "@molecule/api-wearable": "1.0.3",
     "@types/node": "26.6.5",
     "typescript": "6.0.3",