feat(medications): low-stock notifications with a runway threshold

A daily job projects each tracked medication's remaining supply against
its schedules and notifies through the normal channel cascade when the
runway falls below the user's threshold (default seven days, 1-60 or
off, set beside the reminder thresholds). One notification per
crossing: a stamp on the medication row re-arms on refill or threshold
change, and a failed dispatch leaves it clear for the next day's retry.
The GLP-1 card's fixed four-dose flag stays as the locked iOS read
contract; the engine covers it like any other medication.
This commit is contained in:
Marc-André Bombeck committed 2026-06-12 21:04:09 +02:00
1 parent 159de9b78f
commit cac9a32756
19 files changed
+1741 -59

No files matched your search

+212
View File
@@ -0,0 +1,212 @@
"use client";
import { useEffect, useRef, useState } from "react";
import { useQuery, useQueryClient } from "@tanstack/react-query";
import { PackageOpen } from "lucide-react";
import { Input } from "@/components/ui/input";
import { Switch } from "@/components/ui/switch";
import { SettingsCardHeader } from "@/components/settings/_card-header";
import { useTranslations } from "@/lib/i18n/context";
import { queryKeys } from "@/lib/query-keys";
import { apiFetchRaw, apiGet } from "@/lib/api/api-fetch";
/**
* v1.16.11 — medication low-stock alert threshold (Settings →
* Notifications). The threshold is REMAINING RUNWAY: notify when a
* tracked medication's supply covers fewer than N days (1–60, default
* 7); the switch off persists `null` (alert off). Reads the same
* per-user prefs blob the mood / coach cards use and writes through
* `PATCH /api/auth/me/notification-prefs`; the value also surfaces on
* `GET /api/settings/reminder-thresholds` for API consumers, so the
* save invalidates both keys.
*/
interface NotificationPrefsShape {
medication: { lowStockRunwayDays: number | null };
}
const DEFAULT_DAYS = 7;
const MIN_DAYS = 1;
const MAX_DAYS = 60;
export function LowStockCard({
isAuthenticated,
}: {
isAuthenticated: boolean;
}) {
const { t } = useTranslations();
const queryClient = useQueryClient();
const [optimistic, setOptimistic] = useState<number | null | undefined>(
undefined,
);
const [draft, setDraft] = useState<string | null>(null);
const [saving, setSaving] = useState(false);
const [msg, setMsg] = useState<string | null>(null);
const [msgType, setMsgType] = useState<"success" | "error" | null>(null);
// Auto-clear the inline status line 3 s after the mutation settles —
// the MoodReminderCard pattern, including the unmount / re-toggle
// timer hygiene.
const clearTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
useEffect(() => {
return () => {
if (clearTimerRef.current !== null) {
clearTimeout(clearTimerRef.current);
clearTimerRef.current = null;
}
};
}, []);
function scheduleClear() {
if (clearTimerRef.current !== null) {
clearTimeout(clearTimerRef.current);
}
clearTimerRef.current = setTimeout(() => {
clearTimerRef.current = null;
setMsg(null);
setMsgType(null);
}, 3000);
}
const { data: prefs } = useQuery({
queryKey: queryKeys.authNotificationPrefs(),
queryFn: async () => {
return apiGet<NotificationPrefsShape>("/api/auth/me/notification-prefs");
},
enabled: isAuthenticated,
});
const persisted =
prefs?.medication?.lowStockRunwayDays === undefined
? DEFAULT_DAYS
: prefs.medication.lowStockRunwayDays;
const current = optimistic === undefined ? persisted : optimistic;
const enabled = current !== null;
const days = current ?? DEFAULT_DAYS;
async function persist(next: number | null, successMsg: string) {
setOptimistic(next);
setSaving(true);
setMsg(null);
setMsgType(null);
if (clearTimerRef.current !== null) {
clearTimeout(clearTimerRef.current);
clearTimerRef.current = null;
}
const res = await apiFetchRaw("/api/auth/me/notification-prefs", {
method: "PATCH",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ medication: { lowStockRunwayDays: next } }),
});
if (res.ok) {
setMsg(successMsg);
setMsgType("success");
await Promise.all([
queryClient.invalidateQueries({
queryKey: queryKeys.authNotificationPrefs(),
}),
queryClient.invalidateQueries({
queryKey: queryKeys.settingsReminderThresholds(),
}),
]);
setOptimistic(undefined);
} else {
setOptimistic(undefined);
setMsg(t("notifications.lowStock.saveError"));
setMsgType("error");
}
scheduleClear();
setSaving(false);
}
async function handleToggle(next: boolean) {
await persist(
next ? days : null,
next
? t("notifications.lowStock.enabledToast")
: t("notifications.lowStock.disabledToast"),
);
}
function commitDraft() {
if (draft === null) return;
const parsed = Number(draft);
setDraft(null);
if (!Number.isInteger(parsed)) return;
const clamped = Math.min(MAX_DAYS, Math.max(MIN_DAYS, parsed));
if (clamped === days) return;
void persist(clamped, t("notifications.lowStock.savedToast"));
}
return (
<section
aria-labelledby="settings-low-stock-title"
className="bg-card border-border rounded-xl border p-4 sm:p-6"
>
<SettingsCardHeader
icon={PackageOpen}
title={t("notifications.lowStock.title")}
titleId="settings-low-stock-title"
description={t("notifications.lowStock.description")}
status={
<label className="flex min-h-11 items-center gap-3">
<Switch
checked={enabled}
onCheckedChange={handleToggle}
disabled={!isAuthenticated || saving}
aria-label={t("notifications.lowStock.toggleAria")}
/>
<span className="text-muted-foreground text-xs">
{enabled
? t("notifications.lowStock.statusOn")
: t("notifications.lowStock.statusOff")}
</span>
</label>
}
/>
{enabled && (
<div className="mt-4 flex min-h-11 items-center gap-3 pl-7">
<label htmlFor="low-stock-days" className="text-sm font-medium">
{t("notifications.lowStock.daysLabel")}
</label>
<Input
id="low-stock-days"
type="number"
inputMode="numeric"
min={MIN_DAYS}
max={MAX_DAYS}
className="w-24"
value={draft ?? String(days)}
disabled={!isAuthenticated || saving}
onChange={(e) => setDraft(e.target.value)}
onBlur={commitDraft}
onKeyDown={(e) => {
if (e.key === "Enter") commitDraft();
}}
aria-label={t("notifications.lowStock.daysAria")}
autoComplete="off"
data-lpignore="true"
data-1p-ignore="true"
/>
</div>
)}
{msg && (
<p
role="status"
aria-live="polite"
className={
msgType === "error"
? "text-destructive mt-3 pl-7 text-sm"
: "text-muted-foreground mt-3 pl-7 text-sm"
}
>
{msg}
</p>
)}
</section>
);
}
@@ -8,6 +8,7 @@ import { useAuth } from "@/hooks/use-auth";
import { useTranslations } from "@/lib/i18n/context";
import { queryKeys } from "@/lib/query-keys";
import { CoachNudgeCard } from "@/components/settings/coach-nudge-card";
import { LowStockCard } from "@/components/settings/low-stock-card";
import { MoodReminderCard } from "@/components/settings/mood-reminder-card";
import { NotificationStatusCard } from "@/components/settings/notification-status-card";
import { NtfyCard } from "@/components/settings/ntfy-card";
@@ -107,6 +108,10 @@ export function NotificationsSection() {
<div id="mood-reminder" className="scroll-mt-28">
<MoodReminderCard isAuthenticated={isAuthenticated} />
</div>
{/* v1.16.11 — medication low-stock runway threshold. */}
<div id="low-stock" className="scroll-mt-28">
<LowStockCard isAuthenticated={isAuthenticated} />
</div>
{/* v1.15.20 — proactive Coach nudge opt-out. */}
<div id="coach-nudge" className="scroll-mt-28">
<CoachNudgeCard isAuthenticated={isAuthenticated} />