Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

2.5 KB
Raw Blame
"use client";

import { useEffect, useSyncExternalStore } from "react";
import { listPartners, type PartnerInfo } from "@/lib/partners-api";

/**
 * The partners this account can talk to, held once for the whole app.
 *
 * The composer's menus and every transcript line that names a partner read
 * the same list, so it is fetched once and shared rather than per consumer.
 * It refreshes when the window regains focus — a partner made or renamed in
 * another tab shows up — but no more than once per `STALE_MS`, and a fetch
 * already in flight is joined, not repeated. Nothing is kept beyond the one
 * list.
 */
interface Roster {
  partners: PartnerInfo[];
  loading: boolean;
  error: boolean;
}

const STALE_MS = 30_000;

let roster: Roster = { partners: [], loading: false, error: false };
let loadedAt = 0;
let inflight: Promise<void> | null = null;
const listeners = new Set<() => void>();

function publish(next: Roster) {
  roster = next;
  for (const listener of listeners) listener();
}

/** Fetch the list unless a fresh one is held or one is already on its way. */
export function refreshPartnerRoster(force = false): Promise<void> {
  if (inflight) return inflight;
  if (!force && loadedAt && Date.now() - loadedAt < STALE_MS) return Promise.resolve();
  publish({ ...roster, loading: true });
  inflight = listPartners()
    .then((partners) => {
      loadedAt = Date.now();
      publish({ partners, loading: false, error: false });
    })
    .catch(() => publish({ ...roster, loading: false, error: true }))
    .finally(() => {
      inflight = null;
    });
  return inflight;
}

function subscribe(listener: () => void) {
  listeners.add(listener);
  return () => listeners.delete(listener);
}

const EMPTY: Roster = { partners: [], loading: false, error: false };

export function usePartnerRoster(enabled = true): Roster {
  const value = useSyncExternalStore(subscribe, () => roster, () => EMPTY);
  useEffect(() => {
    if (!enabled) return;
    void refreshPartnerRoster();
    const onFocus = () => void refreshPartnerRoster();
    window.addEventListener("focus", onFocus);
    return () => window.removeEventListener("focus", onFocus);
  }, [enabled]);
  return enabled ? value : EMPTY;
}

/** One partner by id, from the shared list; undefined until it has loaded. */
export function usePartner(partnerId: string | null | undefined): PartnerInfo | undefined {
  const { partners } = usePartnerRoster(Boolean(partnerId));
  return partnerId ? partners.find((partner) => partner.partner_id === partnerId) : undefined;
}