Source

// One Bounded session per tab: a guest account, created on first use. No sign-up, ever.
// The SDK loads on first use, so a short link opening or a first look at the page never downloads it.
import { APP_ID } from "../../functions/lib/config";

let client: Promise<typeof import("@bounded-sh/client")> | null = null;
export const sdk = () => (client ??= import("@bounded-sh/client").catch((err) => { client = null; throw err; }));

/** The app this page is served for: the host injects it, so a preview talks to its own data. Local dev falls back to config. */
export const SERVED_APP_ID =
  (typeof document !== "undefined" && document.getElementById("__bounded-first-live-bridge")?.getAttribute("data-app-id")) || APP_ID;

let session: Promise<string> | null = null;

/** Resolves to this browser's guest user id, signing in once. */
export function me(): Promise<string> {
  session ??= (async () => {
    const { init, getCurrentUser, signInAnonymously } = await sdk();
    await init({ appId: SERVED_APP_ID });
    const user = getCurrentUser() || (await signInAnonymously());
    if (!user?.id) throw new Error("Could not start a guest session.");
    return user.id as string;
  })().catch((err) => {
    session = null;
    throw err;
  });
  return session;
}

/** A sentence a person can read for a failed write or read. */
export function explain(err: unknown): string {
  const e = err as { message?: string; status?: number; decline?: { message?: string } };
  if (e?.decline?.message) return e.decline.message;
  const msg = String(e?.message || err || "");
  if (/network|fetch|Failed to fetch/i.test(msg)) return "You seem to be offline. Try again in a moment.";
  if (/denied|403|forbidden/i.test(msg)) return "That change was not allowed.";
  return msg || "Something went wrong. Try again.";
}