whoopper 0.1.0

package/dist/utils/conversions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversions.d.ts","sourceRoot":"","sources":["../../src/utils/conversions.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/utils/conversions.js

@@ -0,0 +1,10 @@
+export function kJToCalories(kj) {
+    return Math.round(kj * 0.239006 * 10) / 10;
+}
+export function msToHours(ms) {
+    return Math.round((ms / 3_600_000) * 100) / 100;
+}
+export function msToMinutes(ms) {
+    return Math.round((ms / 60_000) * 100) / 100;
+}
+//# sourceMappingURL=conversions.js.map

package/dist/utils/conversions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversions.js","sourceRoot":"","sources":["../../src/utils/conversions.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,QAAQ,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC/C,CAAC"}

package/dist/utils/date.d.ts

@@ -0,0 +1,6 @@
+export declare function toISODate(date: Date): string;
+export declare function toISODateTime(date: Date): string;
+export declare function parseWhoopDate(dateStr: string): Date;
+export declare function daysAgo(days: number): string;
+export declare function formatTimezoneOffset(offset: string): string;
+//# sourceMappingURL=date.d.ts.map

package/dist/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE5C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/utils/date.js

@@ -0,0 +1,19 @@
+export function toISODate(date) {
+    return date.toISOString().split('T')[0];
+}
+export function toISODateTime(date) {
+    return date.toISOString();
+}
+export function parseWhoopDate(dateStr) {
+    return new Date(dateStr);
+}
+export function daysAgo(days) {
+    const date = new Date();
+    date.setDate(date.getDate() - days);
+    return toISODateTime(date);
+}
+export function formatTimezoneOffset(offset) {
+    // WHOOP returns offsets like "-05:00" or "+02:00"
+    return offset.startsWith('+') || offset.startsWith('-') ? `UTC${offset}` : offset;
+}
+//# sourceMappingURL=date.js.map

package/dist/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,kDAAkD;IAClD,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACpF,CAAC"}

package/dist/utils/headers.d.ts

@@ -0,0 +1,2 @@
+export declare function internalApiHeaders(): Record<string, string>;
+//# sourceMappingURL=headers.d.ts.map

package/dist/utils/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/utils/headers.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM3D"}

package/dist/utils/headers.js

@@ -0,0 +1,8 @@
+export function internalApiHeaders() {
+    return {
+        'User-Agent': 'WHOOP/4.0 (com.whoop.app; build:1; iOS 17.0) Alamofire/5.8.1',
+        'Accept': 'application/json',
+        'Accept-Language': 'en-US,en;q=0.9',
+    };
+}
+//# sourceMappingURL=headers.js.map

package/dist/utils/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/utils/headers.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,YAAY,EAAE,8DAA8D;QAC5E,QAAQ,EAAE,kBAAkB;QAC5B,iBAAiB,EAAE,gBAAgB;KACpC,CAAC;AACJ,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export { toISODate, toISODateTime, parseWhoopDate, daysAgo, formatTimezoneOffset, } from './date.js';
+export { kJToCalories, msToHours, msToMinutes } from './conversions.js';
+export { totalSleepTime, sleepEfficiency, totalSleepNeed, zoneDurationPercentages, } from './sleep-helpers.js';
+export { internalApiHeaders } from './headers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,cAAc,EACd,OAAO,EACP,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+export { toISODate, toISODateTime, parseWhoopDate, daysAgo, formatTimezoneOffset, } from './date.js';
+export { kJToCalories, msToHours, msToMinutes } from './conversions.js';
+export { totalSleepTime, sleepEfficiency, totalSleepNeed, zoneDurationPercentages, } from './sleep-helpers.js';
+export { internalApiHeaders } from './headers.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,cAAc,EACd,OAAO,EACP,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/utils/sleep-helpers.d.ts

@@ -0,0 +1,7 @@
+import type { SleepScore } from '../models/sleep.js';
+import type { ZoneDurations } from '../models/workout.js';
+export declare function totalSleepTime(score: SleepScore): number;
+export declare function sleepEfficiency(score: SleepScore): number;
+export declare function totalSleepNeed(score: SleepScore): number;
+export declare function zoneDurationPercentages(zones: ZoneDurations): Record<string, number>;
+//# sourceMappingURL=sleep-helpers.d.ts.map

package/dist/utils/sleep-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/sleep-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAOxD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMzD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAQxD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BpF"}

package/dist/utils/sleep-helpers.js

@@ -0,0 +1,49 @@
+export function totalSleepTime(score) {
+    const s = score.stage_summary;
+    return (s.total_light_sleep_time_milli +
+        s.total_slow_wave_sleep_time_milli +
+        s.total_rem_sleep_time_milli);
+}
+export function sleepEfficiency(score) {
+    const s = score.stage_summary;
+    const totalInBed = s.total_in_bed_time_milli;
+    if (totalInBed === 0)
+        return 0;
+    const actualSleep = totalSleepTime(score);
+    return Math.round((actualSleep / totalInBed) * 10000) / 100;
+}
+export function totalSleepNeed(score) {
+    const n = score.sleep_needed;
+    return (n.baseline_milli +
+        n.need_from_sleep_debt_milli +
+        n.need_from_recent_strain_milli +
+        n.need_from_recent_nap_milli);
+}
+export function zoneDurationPercentages(zones) {
+    const total = zones.zone_zero_milli +
+        zones.zone_one_milli +
+        zones.zone_two_milli +
+        zones.zone_three_milli +
+        zones.zone_four_milli +
+        zones.zone_five_milli;
+    if (total === 0) {
+        return {
+            zone_zero: 0,
+            zone_one: 0,
+            zone_two: 0,
+            zone_three: 0,
+            zone_four: 0,
+            zone_five: 0,
+        };
+    }
+    const pct = (ms) => Math.round((ms / total) * 10000) / 100;
+    return {
+        zone_zero: pct(zones.zone_zero_milli),
+        zone_one: pct(zones.zone_one_milli),
+        zone_two: pct(zones.zone_two_milli),
+        zone_three: pct(zones.zone_three_milli),
+        zone_four: pct(zones.zone_four_milli),
+        zone_five: pct(zones.zone_five_milli),
+    };
+}
+//# sourceMappingURL=sleep-helpers.js.map

package/dist/utils/sleep-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-helpers.js","sourceRoot":"","sources":["../../src/utils/sleep-helpers.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;IAC9B,OAAO,CACL,CAAC,CAAC,4BAA4B;QAC9B,CAAC,CAAC,gCAAgC;QAClC,CAAC,CAAC,0BAA0B,CAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;IAC9B,MAAM,UAAU,GAAG,CAAC,CAAC,uBAAuB,CAAC;IAC7C,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,MAAM,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;IAC7B,OAAO,CACL,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,0BAA0B;QAC5B,CAAC,CAAC,6BAA6B;QAC/B,CAAC,CAAC,0BAA0B,CAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAoB;IAC1D,MAAM,KAAK,GACT,KAAK,CAAC,eAAe;QACrB,KAAK,CAAC,cAAc;QACpB,KAAK,CAAC,cAAc;QACpB,KAAK,CAAC,gBAAgB;QACtB,KAAK,CAAC,eAAe;QACrB,KAAK,CAAC,eAAe,CAAC;IAExB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO;YACL,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,CAAC;YACb,SAAS,EAAE,CAAC;YACZ,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IACnE,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC;QACrC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;QACnC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;QACnC,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC;QACvC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC;QACrC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "whoopper",
+  "version": "0.1.0",
+  "description": "The definitive WHOOP API client — zero runtime deps, full API coverage",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./models": {
+      "import": "./dist/models/index.js",
+      "types": "./dist/models/index.d.ts"
+    },
+    "./errors": {
+      "import": "./dist/errors/index.js",
+      "types": "./dist/errors/index.d.ts"
+    },
+    "./utils": {
+      "import": "./dist/utils/index.js",
+      "types": "./dist/utils/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "whoop",
+    "api",
+    "health",
+    "fitness",
+    "recovery",
+    "sleep",
+    "hrv",
+    "heart-rate"
+  ],
+  "author": "car1os",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/car1os/whoopper"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "typescript": "^5.7",
+    "vitest": "^3"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}