feat(stats): add v1 immersion stats dashboard (#19)

stats/src/lib/api-client.test.ts

@@ -0,0 +1,157 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { apiClient, BASE_URL, resolveStatsBaseUrl } from './api-client';
+
+test('resolveStatsBaseUrl prefers apiBase query parameter for file-based overlay mode', () => {
+  const baseUrl = resolveStatsBaseUrl({
+    protocol: 'file:',
+    origin: 'null',
+    search: '?overlay=1&apiBase=http%3A%2F%2F127.0.0.1%3A6123',
+  });
+
+  assert.equal(baseUrl, 'http://127.0.0.1:6123');
+});
+
+test('resolveStatsBaseUrl falls back to configured window origin for browser mode', () => {
+  const baseUrl = resolveStatsBaseUrl({
+    protocol: 'http:',
+    origin: 'http://127.0.0.1:6123',
+    search: '',
+  });
+
+  assert.equal(baseUrl, 'http://127.0.0.1:6123');
+});
+
+test('resolveStatsBaseUrl keeps legacy localhost fallback for file mode without apiBase', () => {
+  const baseUrl = resolveStatsBaseUrl({
+    protocol: 'file:',
+    origin: 'null',
+    search: '?overlay=1',
+  });
+
+  assert.equal(baseUrl, 'http://127.0.0.1:6969');
+});
+
+test('deleteSession sends a DELETE request to the session endpoint', async () => {
+  const originalFetch = globalThis.fetch;
+  let seenUrl = '';
+  let seenMethod = '';
+  globalThis.fetch = (async (input: RequestInfo | URL, init?: RequestInit) => {
+    seenUrl = String(input);
+    seenMethod = init?.method ?? 'GET';
+    return new Response(null, { status: 200 });
+  }) as typeof globalThis.fetch;
+
+  try {
+    await apiClient.deleteSession(42);
+    assert.equal(seenUrl, `${BASE_URL}/api/stats/sessions/42`);
+    assert.equal(seenMethod, 'DELETE');
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+test('deleteSession throws when the stats API delete request fails', async () => {
+  const originalFetch = globalThis.fetch;
+  globalThis.fetch = (async () =>
+    new Response('boom', {
+      status: 500,
+      statusText: 'Internal Server Error',
+    })) as typeof globalThis.fetch;
+
+  try {
+    await assert.rejects(() => apiClient.deleteSession(7), /Stats API error: 500 boom/);
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+test('getTrendsDashboard requests the chart-ready trends endpoint with range and grouping', async () => {
+  const originalFetch = globalThis.fetch;
+  let seenUrl = '';
+  globalThis.fetch = (async (input: RequestInfo | URL) => {
+    seenUrl = String(input);
+    return new Response(
+      JSON.stringify({
+        activity: { watchTime: [], cards: [], words: [], sessions: [] },
+        progress: {
+          watchTime: [],
+          sessions: [],
+          words: [],
+          newWords: [],
+          cards: [],
+          episodes: [],
+          lookups: [],
+        },
+        ratios: { lookupsPerHundred: [] },
+        animePerDay: {
+          episodes: [],
+          watchTime: [],
+          cards: [],
+          words: [],
+          lookups: [],
+          lookupsPerHundred: [],
+        },
+        animeCumulative: {
+          watchTime: [],
+          episodes: [],
+          cards: [],
+          words: [],
+        },
+        patterns: {
+          watchTimeByDayOfWeek: [],
+          watchTimeByHour: [],
+        },
+      }),
+      { status: 200, headers: { 'Content-Type': 'application/json' } },
+    );
+  }) as typeof globalThis.fetch;
+
+  try {
+    await apiClient.getTrendsDashboard('90d', 'month');
+    assert.equal(seenUrl, `${BASE_URL}/api/stats/trends/dashboard?range=90d&groupBy=month`);
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+test('getSessionEvents can request only specific event types', async () => {
+  const originalFetch = globalThis.fetch;
+  let seenUrl = '';
+  globalThis.fetch = (async (input: RequestInfo | URL) => {
+    seenUrl = String(input);
+    return new Response(JSON.stringify([]), {
+      status: 200,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }) as typeof globalThis.fetch;
+
+  try {
+    await apiClient.getSessionEvents(42, 120, [4, 5, 6, 7, 8, 9]);
+    assert.equal(
+      seenUrl,
+      `${BASE_URL}/api/stats/sessions/42/events?limit=120&types=4%2C5%2C6%2C7%2C8%2C9`,
+    );
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});
+
+test('getSessionTimeline requests full session history when limit is omitted', async () => {
+  const originalFetch = globalThis.fetch;
+  let seenUrl = '';
+  globalThis.fetch = (async (input: RequestInfo | URL) => {
+    seenUrl = String(input);
+    return new Response(JSON.stringify([]), {
+      status: 200,
+      headers: { 'Content-Type': 'application/json' },
+    });
+  }) as typeof globalThis.fetch;
+
+  try {
+    await apiClient.getSessionTimeline(42);
+    assert.equal(seenUrl, `${BASE_URL}/api/stats/sessions/42/timeline`);
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+});