freezmo/components/LearningSection.tsx
Martin Dvorak e4a8e0ba01 Phase 2: learning engine — history, SRS review, mistakes, stats, exam, reminders
Answer history and schedules
- Every answer is recorded (deck, activity, topic, correct/wrong, time)
  in a versioned IndexedDB log (freezmo-learning v1, stores answers +
  srs), mirrored in memory for synchronous React reads and capped at
  20k answers (oldest pruned). StudyFeed records as it grades.
- Light SM-2 schedule per activity: 1 day, 3 days, then interval x
  ease; wrong answers return in ten minutes with the ease nudged down.

Review, mistakes, stats
- Library 'Smart review' card: due count, mistakes count (latest
  answer wrong — clears itself when answered correctly), today's goal
  progress. Review sessions freeze their item list at start.
- New /review (due across decks, ?mistakes=1 global or ?deck= per
  deck) built on a shared SessionFeed with the study feed's snap/keyboard
  mechanics, wake lock and a results slide.
- New /stats: day streak, five-week calendar, accuracy per subject and
  per deck, weakest topics (>=3 answers), daily-goal progress.
- Daily goal configurable in Settings (10/20/30/50).

Exam mode
- New /exam: pick decks, question count, optional timer; no hints
  (a NoHints context hides hint rows and the self-check escape);
  results with score, per-deck and per-topic breakdown; wrong answers
  land in the mistakes set through the normal history.

Reminders (conditional)
- VAPID-gated: GET/POST/DELETE /api/push and POST /api/push/test with
  the standard route pattern, RATE_LIMIT_PUSH, zod, auth before body.
  Subscriptions stored server-side as endpoint + keys only (PUSH_DIR).
  UI hidden entirely without keys; iOS install note; service worker
  push/notificationclick handlers; scripts/send-reminders.mjs for a
  cron/systemd timer; web-push added as the one server dependency.

Verified: new phase-2 suite 42/42 (history/SRS shapes from a real study
run, mistakes clearing, review session, stats math, exam timer and
breakdowns, VAPID-less hidden state plus the configured
subscribe/validate/test/delete path against a second instance) plus
regression 74/74, mobile 52/52, wizard 80/80, declutter 116/116,
animation 8/8, native 35/35, phase1 38/38, i18n 25/25. Key parity
709/709. Lint + build clean. SW freezmo-v26.
2026-10-10 14:15:21 +00:00

209 lines
7.3 KiB
TypeScript

"use client";
import { useEffect, useState, useSyncExternalStore } from "react";
import { Button } from "@/components/ui";
import { haptic } from "@/lib/haptics";
import { localeHeader, useI18n } from "@/lib/i18n";
import { authHeaders, saveSettings, settingsStore } from "@/lib/settings";
const GOALS = [10, 20, 30, 50];
type PushStatus = { enabled: boolean; publicKey?: string };
function urlBase64ToUint8Array(base64: string): Uint8Array {
const padding = "=".repeat((4 - (base64.length % 4)) % 4);
const normalized = (base64 + padding).replace(/-/g, "+").replace(/_/g, "/");
const raw = atob(normalized);
const bytes = new Uint8Array(raw.length);
for (let index = 0; index < raw.length; index++) bytes[index] = raw.charCodeAt(index);
return bytes;
}
/**
* Settings → Learning: the daily goal, plus push reminders — but only when
* the server has VAPID keys configured. Without them the reminder block is
* hidden completely, exactly as if the feature did not exist.
*/
export function LearningSection() {
const { t } = useI18n();
const dailyGoal = useSyncExternalStore(
settingsStore.subscribe,
() => settingsStore.getSnapshot().dailyGoal,
() => 20,
);
const [status, setStatus] = useState<PushStatus | null>(null);
const [subscribed, setSubscribed] = useState(false);
const [endpoint, setEndpoint] = useState<string | null>(null);
const [busy, setBusy] = useState(false);
const [notice, setNotice] = useState<string | null>(null);
const pushSupported =
typeof window !== "undefined" &&
"serviceWorker" in navigator &&
"PushManager" in window &&
"Notification" in window;
useEffect(() => {
if (!pushSupported) return;
let cancelled = false;
void (async () => {
try {
const response = await fetch("/api/push", {
headers: { ...authHeaders(), ...localeHeader() },
cache: "no-store",
});
const body = (await response.json()) as PushStatus;
if (cancelled) return;
setStatus(body);
if (body.enabled) {
const registration = await navigator.serviceWorker.ready.catch(() => null);
const subscription = await registration?.pushManager.getSubscription();
if (!cancelled && subscription) {
setSubscribed(true);
setEndpoint(subscription.endpoint);
}
}
} catch {
if (!cancelled) setStatus({ enabled: false });
}
})();
return () => {
cancelled = true;
};
}, [pushSupported]);
const enable = async () => {
if (!status?.publicKey) return;
setBusy(true);
setNotice(null);
try {
const permission = await Notification.requestPermission();
if (permission !== "granted") {
setNotice(t("settings.reminderDenied"));
return;
}
const registration = await navigator.serviceWorker.ready;
const subscription = await registration.pushManager.subscribe({
userVisibleOnly: true,
applicationServerKey: urlBase64ToUint8Array(status.publicKey) as unknown as BufferSource,
});
const response = await fetch("/api/push", {
method: "POST",
headers: { "Content-Type": "application/json", ...authHeaders(), ...localeHeader() },
body: JSON.stringify(subscription.toJSON()),
});
if (!response.ok) throw new Error("subscribe failed");
setSubscribed(true);
setEndpoint(subscription.endpoint);
setNotice(t("settings.reminderOn"));
haptic("toggle");
} catch {
setNotice(t("settings.reminderError"));
} finally {
setBusy(false);
}
};
const disable = async () => {
setBusy(true);
setNotice(null);
try {
const registration = await navigator.serviceWorker.ready.catch(() => null);
const subscription = await registration?.pushManager.getSubscription();
if (subscription) {
await fetch(`/api/push?endpoint=${encodeURIComponent(subscription.endpoint)}`, {
method: "DELETE",
headers: { ...authHeaders(), ...localeHeader() },
});
await subscription.unsubscribe();
}
setSubscribed(false);
setEndpoint(null);
setNotice(t("settings.reminderOff"));
} catch {
setNotice(t("settings.reminderError"));
} finally {
setBusy(false);
}
};
const test = async () => {
if (!endpoint) return;
setBusy(true);
setNotice(null);
try {
const response = await fetch("/api/push/test", {
method: "POST",
headers: { "Content-Type": "application/json", ...authHeaders(), ...localeHeader() },
body: JSON.stringify({ endpoint }),
});
if (!response.ok) throw new Error("test failed");
setNotice(t("settings.reminderOn"));
} catch {
setNotice(t("settings.reminderError"));
} finally {
setBusy(false);
}
};
const iosNeedsInstall =
typeof navigator !== "undefined" &&
/iPhone|iPad|iPod/.test(navigator.userAgent) &&
!(navigator as Navigator & { standalone?: boolean }).standalone;
return (
<section className="mb-4 space-y-3 rounded-2xl border border-[var(--hairline)] bg-[var(--surface-sunken)] p-3">
<h3 className="text-sm font-semibold text-frost-950 dark:text-frost-50">{t("settings.learning")}</h3>
<div className="space-y-1.5">
<p className="text-[12px] font-semibold text-[var(--text)]">{t("settings.dailyGoal")}</p>
<p className="text-[11px] leading-snug text-[var(--text-subtle)]">{t("settings.dailyGoalNote")}</p>
<div className="segmented" role="group" aria-label={t("settings.dailyGoal")}>
{GOALS.map((goal) => (
<button
key={goal}
type="button"
aria-pressed={dailyGoal === goal}
onClick={() => {
haptic("toggle");
saveSettings({ dailyGoal: goal });
}}
>
<span className="seg-label">{goal}</span>
</button>
))}
</div>
</div>
{pushSupported && status?.enabled ? (
<div className="space-y-2 border-t border-[var(--hairline-soft)] pt-2.5">
<p className="text-[12px] font-semibold text-[var(--text)]">{t("settings.reminders")}</p>
<p className="text-[11px] leading-snug text-[var(--text-subtle)]">{t("settings.remindersNote")}</p>
{iosNeedsInstall ? (
<p className="text-[11px] font-medium leading-snug text-amber-700 dark:text-amber-300">
{t("settings.remindersIos")}
</p>
) : null}
<div className="flex flex-wrap gap-2">
{subscribed ? (
<>
<Button size="sm" variant="secondary" loading={busy} onClick={() => void test()}>
{t("settings.reminderTest")}
</Button>
<Button size="sm" variant="ghost" loading={busy} onClick={() => void disable()}>
{t("settings.reminderDisable")}
</Button>
</>
) : (
<Button size="sm" loading={busy} onClick={() => void enable()}>
{t("settings.reminderEnable")}
</Button>
)}
</div>
{notice ? <p className="text-[12px] font-medium text-[var(--text-muted)]">{notice}</p> : null}
</div>
) : null}
</section>
);
}