hae-vault 0.1.0

package/tests/parse-sleep.test.ts

@@ -0,0 +1,65 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { detectSleepVariant, normalizeSleep } from '../src/parse/sleep.js';
+import type { SleepDatapoint } from '../src/types/hae.js';
+
+const nonAgg: SleepDatapoint = {
+  startDate: '2026-01-15 22:00:00 +0000',
+  endDate: '2026-01-16 06:00:00 +0000',
+  value: 'ASLEEP_CORE',
+  source: 'Apple Watch',
+  qty: 1.5
+};
+
+const aggV2: SleepDatapoint = {
+  sleepStart: '2026-01-15 22:00:00 +0000',
+  sleepEnd: '2026-01-16 06:00:00 +0000',
+  core: 3.0, deep: 1.0, rem: 1.5, awake: 0.5, asleep: 5.5, inBed: 6.0,
+  source: 'Apple Watch'
+};
+
+const aggV1: SleepDatapoint = {
+  sleepStart: '2026-01-15 22:00:00 +0000',
+  sleepEnd: '2026-01-16 06:00:00 +0000',
+  inBedStart: '2026-01-15 21:50:00 +0000',
+  inBedEnd: '2026-01-16 06:10:00 +0000',
+  asleep: 5.5, inBed: 6.0,
+  sleepSource: "Ruben's Apple Watch",
+  inBedSource: 'iPhone'
+};
+
+test('detects non-aggregated variant', () => {
+  assert.equal(detectSleepVariant(nonAgg), 'detailed');
+});
+
+test('detects aggregated v2 variant', () => {
+  assert.equal(detectSleepVariant(aggV2), 'aggregated_v2');
+});
+
+test('detects aggregated v1 variant', () => {
+  assert.equal(detectSleepVariant(aggV1), 'aggregated_v1');
+});
+
+test('normalizes aggregated v2', () => {
+  const row = normalizeSleep(aggV2, 'default', 'sess-1');
+  assert.equal(row.schema_ver, 'aggregated_v2');
+  assert.equal(row.core_h, 3.0);
+  assert.equal(row.source, 'Apple Watch');
+  assert.ok(row.sleep_start);
+  assert.ok(row.date);
+});
+
+test('normalizes aggregated v1', () => {
+  const row = normalizeSleep(aggV1, 'default', 'sess-1');
+  assert.equal(row.schema_ver, 'aggregated_v1');
+  assert.equal(row.asleep_h, 5.5);
+  assert.ok(row.in_bed_start);
+});
+
+test('normalizes non-aggregated — stores raw in meta', () => {
+  const row = normalizeSleep(nonAgg, 'default', 'sess-1');
+  assert.equal(row.schema_ver, 'detailed');
+  assert.ok(row.meta);
+  const meta = JSON.parse(row.meta!);
+  assert.equal(meta.value, 'ASLEEP_CORE');
+});

package/tests/parse-time.test.ts

@@ -0,0 +1,48 @@
+// tests/parse-time.test.ts
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { parseHaeTime, toIso, toDateStr } from '../src/parse/time.js';
+
+test('parses 24-hour format', () => {
+  const result = parseHaeTime('2026-01-15 14:30:00 +0000');
+  assert.equal(toIso(result), '2026-01-15T14:30:00.000Z');
+});
+
+test('parses 12-hour uppercase PM format', () => {
+  const result = parseHaeTime('2026-01-15 2:30:00 PM +0000');
+  assert.equal(toIso(result), '2026-01-15T14:30:00.000Z');
+});
+
+test('parses 12-hour lowercase pm format', () => {
+  const result = parseHaeTime('2026-01-15 2:30:00 pm +0000');
+  assert.equal(toIso(result), '2026-01-15T14:30:00.000Z');
+});
+
+test('parses narrow non-breaking space before PM (\\u202f)', () => {
+  const result = parseHaeTime('2026-01-15 2:30:00\u202fPM +0000');
+  assert.equal(toIso(result), '2026-01-15T14:30:00.000Z');
+});
+
+test('parses narrow non-breaking space before pm (\\u202f)', () => {
+  const result = parseHaeTime('2026-01-15 2:30:00\u202fpm +0000');
+  assert.equal(toIso(result), '2026-01-15T14:30:00.000Z');
+});
+
+test('throws on unrecognised format', () => {
+  assert.throws(() => parseHaeTime('not-a-date'), /Failed to parse/);
+});
+
+test('toDateStr extracts YYYY-MM-DD', () => {
+  const result = parseHaeTime('2026-01-15 14:30:00 +0000');
+  assert.equal(toDateStr(result), '2026-01-15');
+});
+
+test('handles midnight correctly', () => {
+  const result = parseHaeTime('2026-01-15 12:00:00 AM +0000');
+  assert.equal(toIso(result), '2026-01-15T00:00:00.000Z');
+});
+
+test('handles noon correctly', () => {
+  const result = parseHaeTime('2026-01-15 12:00:00 PM +0000');
+  assert.equal(toIso(result), '2026-01-15T12:00:00.000Z');
+});

package/tests/parse-workouts.test.ts

@@ -0,0 +1,43 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { parseWorkout } from '../src/parse/workouts.js';
+import type { WorkoutData } from '../src/types/hae.js';
+
+const run: WorkoutData = {
+  name: 'Running',
+  start: '2026-01-15 07:00:00 +0000',
+  end: '2026-01-15 07:45:00 +0000',
+  activeEnergyBurned: { qty: 450, units: 'kJ' },
+  distance: { qty: 5.2, units: 'km' },
+  heartRateData: [
+    { date: '2026-01-15 07:01:00 +0000', qty: 140, units: 'bpm' },
+    { date: '2026-01-15 07:44:00 +0000', qty: 155, units: 'bpm' },
+  ],
+};
+
+test('parses workout basics', () => {
+  const row = parseWorkout(run, 'default', 'sess-1');
+  assert.equal(row.name, 'Running');
+  assert.equal(row.duration_s, 45 * 60);
+  assert.equal(row.calories_kj, 450);
+  assert.equal(row.distance, 5.2);
+  assert.equal(row.distance_unit, 'km');
+});
+
+test('computes avg and max heart rate', () => {
+  const row = parseWorkout(run, 'default', 'sess-1');
+  assert.equal(row.avg_hr, (140 + 155) / 2);
+  assert.equal(row.max_hr, 155);
+});
+
+test('stores full workout JSON in meta', () => {
+  const row = parseWorkout(run, 'default', 'sess-1');
+  assert.ok(row.meta);
+  const meta = JSON.parse(row.meta);
+  assert.equal(meta.name, 'Running');
+});
+
+test('derives date from start timestamp', () => {
+  const row = parseWorkout(run, 'default', 'sess-1');
+  assert.equal(row.date, '2026-01-15');
+});

package/tests/types.test.ts

@@ -0,0 +1,27 @@
+// tests/types.test.ts
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import type { HaePayload, MetricData, WorkoutData } from '../src/types/hae.js';
+
+test('HaePayload shape is correct', () => {
+  const payload: HaePayload = {
+    data: {
+      metrics: [
+        { name: 'step_count', units: 'count', data: [{ date: '2026-01-15 10:00:00 +0000', qty: 5000 }] }
+      ],
+      workouts: []
+    }
+  };
+  assert.equal(payload.data.metrics![0].name, 'step_count');
+});
+
+test('SleepAnalysis non-aggregated shape', () => {
+  const row = { startDate: '2026-01-15 22:00:00 +0000', endDate: '2026-01-16 06:00:00 +0000', value: 'ASLEEP_CORE', source: 'Apple Watch', qty: 1.5 };
+  assert.ok('startDate' in row);
+  assert.ok('value' in row);
+});
+
+test('AggregatedSleepV2 shape', () => {
+  const row = { sleepStart: '2026-01-15 22:00:00 +0000', sleepEnd: '2026-01-16 06:00:00 +0000', core: 3.0, deep: 1.0, rem: 1.5, awake: 0.5, asleep: 5.5, inBed: 6.0, source: 'Apple Watch' };
+  assert.ok('source' in row && 'core' in row);
+});

package/tests/util-zip.test.ts

@@ -0,0 +1,46 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import AdmZip from 'adm-zip';
+import { extractPayloadFromZip } from '../src/util/zip.js';
+
+function makeZip(filename: string, content: string): Buffer {
+  const zip = new AdmZip();
+  zip.addFile(filename, Buffer.from(content, 'utf-8'));
+  return zip.toBuffer();
+}
+
+const validPayload = JSON.stringify({ data: { metrics: [], workouts: [] } });
+
+test('extracts payload from zip containing HealthAutoExport-*.json', () => {
+  const buf = makeZip('HealthAutoExport-test-2026-01-15.json', validPayload);
+  const result = extractPayloadFromZip(buf);
+  assert.ok(result);
+  assert.deepEqual(result!.data.metrics, []);
+});
+
+test('returns null when zip has no HealthAutoExport-*.json', () => {
+  const buf = makeZip('workout.gpx', '<gpx/>');
+  const result = extractPayloadFromZip(buf);
+  assert.equal(result, null);
+});
+
+test('returns null when matching entry contains invalid JSON', () => {
+  const buf = makeZip('HealthAutoExport-bad.json', 'not json {{{');
+  const result = extractPayloadFromZip(buf);
+  assert.equal(result, null);
+});
+
+test('returns null when JSON lacks data field', () => {
+  const buf = makeZip('HealthAutoExport-nodatafield.json', JSON.stringify({ other: true }));
+  const result = extractPayloadFromZip(buf);
+  assert.equal(result, null);
+});
+
+test('ignores .gpx entries and finds the .json', () => {
+  const zip = new AdmZip();
+  zip.addFile('route.gpx', Buffer.from('<gpx/>', 'utf-8'));
+  zip.addFile('HealthAutoExport-2026.json', Buffer.from(validPayload, 'utf-8'));
+  const buf = zip.toBuffer();
+  const result = extractPayloadFromZip(buf);
+  assert.ok(result);
+});

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}