mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-18 08:02:12 +00:00
Add a discreet unread dot to the Coach FAB when the Coach has something the user has not opened yet, and clear it when they open the Coach. The signal is server-authoritative: a new coach_last_seen_at column on users records the last time the Coach was opened, and the launcher's status endpoint reports unread when the newest assistant message is newer than that stamp — so the dot works even with no push channel and clears across every device, web and iOS. Opening the Coach (FAB or the /coach page) stamps the column via a new /api/insights/coach/seen endpoint; the launcher keeps a local stamp only for an instant paint. The dot is a calm cyan, not an alarming red, per the card-status rule.
267 lines
11 KiB
TypeScript
267 lines
11 KiB
TypeScript
"use client";
|
|
|
|
import { useEffect, useRef, useState } from "react";
|
|
import { usePathname } from "next/navigation";
|
|
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
|
|
import { Sparkles } from "lucide-react";
|
|
|
|
import { Button } from "@/components/ui/button";
|
|
import { cn } from "@/lib/utils";
|
|
import { useTranslations } from "@/lib/i18n/context";
|
|
import { useCoachLaunch } from "@/lib/insights/coach-launch-context";
|
|
import { useFeatureFlags } from "@/hooks/use-feature-flags";
|
|
import { useDisableCoach } from "@/hooks/use-disable-coach";
|
|
import { queryKeys } from "@/lib/query-keys";
|
|
|
|
import { apiGet, apiPost } from "@/lib/api/api-fetch";
|
|
|
|
/**
|
|
* v1.16.8 — the Coach FAB is a permanent launcher again, now on EVERY
|
|
* authenticated page (mounted once in `<AuthShell>`, no longer scoped
|
|
* to `/insights/**`). The v1.16.1 nudge-only bubble folded into it: the
|
|
* FAB always renders, and an unread proactive Coach message (surfaced
|
|
* by `/api/insights/coach/nudge-status`) paints a small unread dot on
|
|
* its corner instead of toggling the whole button.
|
|
*
|
|
* v1.18.6 (CCH-02/CCH-03) — the proactive nudge now lands as a real
|
|
* ASSISTANT message in the conversation rail, not a notification-only
|
|
* dispatch, so the unread signal moved onto the server-authoritative
|
|
* `User.coachLastSeenAt` stamp: `status.unread` is true while a Coach
|
|
* message is newer than the last time the user opened the Coach. Opening
|
|
* the Coach (this FAB, or the `/coach` page) fires
|
|
* `POST /api/insights/coach/seen`, which stamps the server and clears
|
|
* the dot everywhere (web + iOS). A local "seen" stamp is kept only as
|
|
* an instant-paint optimisation so the dot disappears the moment the
|
|
* user taps, before the mutation round-trips.
|
|
*
|
|
* The FAB hides inside the Coach view itself (`/coach`) — a
|
|
* launcher pointing at the page the user is already on is noise.
|
|
*
|
|
* It yields while a data-list selection bar is mounted (CSS `:has()`
|
|
* gate) so it never covers the bar's delete action. The v1.4.33
|
|
* chart-tooltip auto-hide is gone: blinking out on every chart hover
|
|
* read as a glitch, and a hover tooltip under the cursor never reaches
|
|
* the lower-right corner anyway.
|
|
*/
|
|
|
|
const NUDGE_SEEN_STORAGE_KEY = "healthlog-coach-nudge-seen";
|
|
|
|
export interface CoachNudgeStatus {
|
|
nudgedAt: string | null;
|
|
unread: boolean;
|
|
}
|
|
|
|
/**
|
|
* Pure unread derivation — the server signal is authoritative
|
|
* (`status.unread` already compares the newest Coach message against the
|
|
* persisted `coachLastSeenAt`). The local seen-stamp only suppresses the
|
|
* dot for an instant after the user taps, before the mark-seen mutation
|
|
* + status refetch land. Exported so the unit test pins the contract
|
|
* without a QueryClient round-trip.
|
|
*/
|
|
export function isNudgeUnread(
|
|
status: CoachNudgeStatus | undefined,
|
|
seenStamp: string | null,
|
|
): boolean {
|
|
if (!status?.unread || status.nudgedAt === null) return false;
|
|
return seenStamp !== status.nudgedAt;
|
|
}
|
|
|
|
export function LayoutCoachFab() {
|
|
const { t } = useTranslations();
|
|
const pathname = usePathname();
|
|
const launch = useCoachLaunch();
|
|
const flags = useFeatureFlags();
|
|
const disableCoach = useDisableCoach();
|
|
|
|
// Local "seen on this device" stamp — the nudge timestamp the user
|
|
// last dismissed by opening the chat. Lazy initialiser per the
|
|
// `react-hooks/set-state-in-effect` rule.
|
|
const [seenStamp, setSeenStamp] = useState<string | null>(() => {
|
|
if (typeof window === "undefined") return null;
|
|
try {
|
|
return window.localStorage.getItem(NUDGE_SEEN_STORAGE_KEY);
|
|
} catch {
|
|
return null;
|
|
}
|
|
});
|
|
|
|
const coachAvailable = !!launch && flags.coach && !disableCoach;
|
|
const onCoachPage = pathname?.startsWith("/coach") ?? false;
|
|
const queryClient = useQueryClient();
|
|
|
|
const { data: status } = useQuery({
|
|
queryKey: queryKeys.coachNudgeStatus(),
|
|
queryFn: async (): Promise<CoachNudgeStatus> => {
|
|
return apiGet<CoachNudgeStatus>("/api/insights/coach/nudge-status");
|
|
},
|
|
enabled: coachAvailable && !onCoachPage,
|
|
staleTime: 5 * 60 * 1000,
|
|
});
|
|
|
|
// v1.18.6 (CCH-03) — stamp `coachLastSeenAt` server-side when the user
|
|
// opens the Coach so the dot clears across every device. Fire-and-
|
|
// forget from the UI's perspective (the local seen-stamp already
|
|
// suppressed the dot); on success the status query refetches so the
|
|
// server-authoritative `unread` re-resolves to false.
|
|
const markSeen = useMutation({
|
|
mutationKey: queryKeys.coachMarkSeen(),
|
|
mutationFn: async () =>
|
|
apiPost<{ seenAt: string }>("/api/insights/coach/seen", {}),
|
|
onSuccess: () => {
|
|
queryClient.invalidateQueries({
|
|
queryKey: queryKeys.coachNudgeStatus(),
|
|
});
|
|
},
|
|
});
|
|
|
|
const nudgedAt = status?.nudgedAt ?? null;
|
|
const unread = isNudgeUnread(status, seenStamp);
|
|
|
|
// The unread dot is visual-only (`aria-hidden`) and the swapped
|
|
// `aria-label` is not announced on mutation — a screen-reader user
|
|
// never hears about a fresh nudge. The polite live region below the
|
|
// button emits the nudge copy once on the unread rising edge and
|
|
// clears when the nudge is read, so the announcement fires exactly
|
|
// once per nudge.
|
|
const [liveAnnouncement, setLiveAnnouncement] = useState("");
|
|
const prevUnreadRef = useRef(false);
|
|
useEffect(() => {
|
|
if (unread && !prevUnreadRef.current) {
|
|
setLiveAnnouncement(t("insights.coach.nudgeBubbleLabel"));
|
|
} else if (!unread && prevUnreadRef.current) {
|
|
setLiveAnnouncement("");
|
|
}
|
|
prevUnreadRef.current = unread;
|
|
}, [unread, t]);
|
|
|
|
// Visiting the Coach page itself counts as reading the nudge — persist
|
|
// the local instant-paint stamp AND stamp the server so the dot stays
|
|
// gone after leaving, on every device. Fired once per page entry: the
|
|
// ref guards against the effect re-running on unrelated re-renders.
|
|
const seenStampedRef = useRef(false);
|
|
useEffect(() => {
|
|
if (!onCoachPage) {
|
|
seenStampedRef.current = false;
|
|
return;
|
|
}
|
|
if (seenStampedRef.current) return;
|
|
seenStampedRef.current = true;
|
|
if (nudgedAt !== null) {
|
|
try {
|
|
window.localStorage.setItem(NUDGE_SEEN_STORAGE_KEY, nudgedAt);
|
|
} catch {
|
|
// Storage unavailable (private mode) — the server stamp below
|
|
// still clears the dot once it round-trips.
|
|
}
|
|
}
|
|
markSeen.mutate();
|
|
// `markSeen` is a stable mutation object; excluding it keeps the
|
|
// effect from re-firing on its internal state changes.
|
|
// eslint-disable-next-line react-hooks/exhaustive-deps
|
|
}, [onCoachPage, nudgedAt]);
|
|
|
|
if (!coachAvailable) return null;
|
|
// The Coach chat page IS the destination — no launcher on top of it.
|
|
if (onCoachPage) return null;
|
|
|
|
const accessibleLabel = unread
|
|
? t("insights.coach.nudgeBubbleLabel")
|
|
: t("insights.coach.fabLabel");
|
|
|
|
const handleOpen = () => {
|
|
if (nudgedAt !== null) {
|
|
setSeenStamp(nudgedAt);
|
|
try {
|
|
window.localStorage.setItem(NUDGE_SEEN_STORAGE_KEY, nudgedAt);
|
|
} catch {
|
|
// Best effort — see above.
|
|
}
|
|
}
|
|
// v1.18.6 (CCH-03) — stamp the server so the dot clears on every
|
|
// device, not just this one. The local stamp above already hid the
|
|
// dot for an instant paint; the mutation makes it durable.
|
|
if (unread) markSeen.mutate();
|
|
// v1.16.11 — open the side drawer in place (the launch context the
|
|
// layout mount consumes) instead of navigating to the chat page;
|
|
// the conversation arrives without losing the page underneath.
|
|
launch?.askCoach();
|
|
};
|
|
|
|
return (
|
|
<>
|
|
<Button
|
|
type="button"
|
|
size="icon"
|
|
data-slot="coach-fab"
|
|
data-unread={unread ? "true" : undefined}
|
|
onClick={handleOpen}
|
|
aria-label={accessibleLabel}
|
|
title={accessibleLabel}
|
|
className={cn(
|
|
// Sit above the 64 px bottom-nav + the iPhone home-indicator
|
|
// safe-area inset on mobile; plain bottom offset once the
|
|
// bottom-nav hides (`md:hidden` on the nav, so `md:` here —
|
|
// not `lg:` — keeps the FAB from floating mid-air 768-1023px).
|
|
// v1.18.1 (W-COACH-UI C5) — corner inset: on desktop the right and
|
|
// bottom insets match (`md:right-8` / `md:bottom-8`) so the FAB
|
|
// sits symmetrically in the corner. On mobile the right inset is
|
|
// `right-6` but the bottom is deliberately larger — it clears the
|
|
// 64 px bottom-nav plus the home-indicator safe-area inset
|
|
// (`bottom-[calc(env(safe-area-inset-bottom,0px)+5rem)]`), so the
|
|
// gap is asymmetric there by design, not drift.
|
|
"fixed right-6 z-40 size-14 rounded-full shadow-lg md:right-8",
|
|
"bottom-[calc(env(safe-area-inset-bottom,0px)+5rem)] md:bottom-8",
|
|
// Dark glyph on the purple/pink gradient — white sat at
|
|
// ≈2.3:1 against the gradient midpoint; the background token
|
|
// reads ≈6.5:1.
|
|
"from-dracula-purple to-dracula-pink text-background bg-gradient-to-br",
|
|
"hover:from-dracula-purple/90 hover:to-dracula-pink/90",
|
|
// The default ring alone is hard to see against the gradient;
|
|
// the offset ring draws a clear halo around the circle.
|
|
"focus-visible:ring-offset-background focus-visible:ring-offset-2",
|
|
"transition-opacity duration-150 motion-reduce:transition-none",
|
|
// Yield to the data-list selection bar: its delete action lands
|
|
// in the same lower-right band, and the destructive control
|
|
// wins. The `:has()` gate keys off the bar's `data-slot`.
|
|
// `invisible` (visibility:hidden) removes the hidden button
|
|
// from the tab order + accessibility tree — `opacity-0`
|
|
// alone left it focusable and operable while unseeable.
|
|
"[body:has([data-slot=selection-action-bar])_&]:pointer-events-none",
|
|
"[body:has([data-slot=selection-action-bar])_&]:opacity-0",
|
|
"[body:has([data-slot=selection-action-bar])_&]:invisible",
|
|
// Same yield while the onboarding tour overlay is up — the
|
|
// tour dims the page and drives focus itself; a floating
|
|
// launcher on top of the spotlight is noise.
|
|
"[body:has([data-testid=onboarding-tour])_&]:pointer-events-none",
|
|
"[body:has([data-testid=onboarding-tour])_&]:opacity-0",
|
|
"[body:has([data-testid=onboarding-tour])_&]:invisible",
|
|
)}
|
|
>
|
|
<Sparkles className="size-6" aria-hidden="true" />
|
|
{unread ? (
|
|
// v1.18.6 (CCH-03) — discreet "the Coach said something" dot.
|
|
// Deliberately NOT an alarming red (the medication-card rule:
|
|
// status via calm signal, never an alarm tint): a small cyan
|
|
// dot ringed against the FAB background reads as informative,
|
|
// not urgent.
|
|
<span
|
|
data-slot="coach-fab-unread"
|
|
aria-hidden="true"
|
|
className="border-background bg-dracula-cyan absolute top-0.5 right-0.5 size-3 rounded-full border-2"
|
|
/>
|
|
) : null}
|
|
</Button>
|
|
{/* Polite announcement for the unread-nudge arrival — see the
|
|
rising-edge effect above. */}
|
|
<span
|
|
data-slot="coach-fab-live"
|
|
aria-live="polite"
|
|
className="sr-only"
|
|
>
|
|
{liveAnnouncement}
|
|
</span>
|
|
</>
|
|
);
|
|
}
|