import { type FormEvent, type ReactElement, useEffect, useRef, useState } from "react";
import { HostAuthError } from "../auth-protocol.js";
/**
* The shared visual language of every host-owned auth screen.
*
* Exported so the login, recovery, reset, and verification screens are literally the same card
* rather than four that drift apart. Modules never render any of them.
*/
export const authStyles = {
button: {
background: "#1c1917",
border: "1px solid #1c1917",
borderRadius: "0.375rem",
color: "#fafaf9",
cursor: "pointer",
font: "inherit",
fontWeight: 600,
padding: "0.625rem 0.875rem",
},
card: {
background: "#ffffff",
border: "1px solid #e7e5e4",
borderRadius: "0.75rem",
boxShadow: "0 12px 32px rgb(28 25 23 / 0.08)",
display: "grid",
gap: "1rem",
maxWidth: "24rem",
padding: "1.5rem",
width: "100%",
},
error: { color: "#9f1239", margin: 0 },
field: { display: "grid", gap: "0.375rem" },
form: { display: "grid", gap: "1rem" },
heading: { fontSize: "1.5rem", margin: 0 },
host: {
alignItems: "center",
background: "#fafaf9",
color: "#1c1917",
display: "flex",
fontFamily: "system-ui, sans-serif",
justifyContent: "center",
minHeight: "100vh",
padding: "1rem",
},
input: {
border: "1px solid #a8a29e",
borderRadius: "0.375rem",
font: "inherit",
padding: "0.625rem 0.75rem",
width: "100%",
},
introduction: { color: "#57534e", margin: 0 },
label: { fontWeight: 600 },
secondaryAction: {
background: "transparent",
border: "none",
color: "#1c1917",
cursor: "pointer",
font: "inherit",
justifySelf: "start",
padding: 0,
textDecoration: "underline",
},
} as const;
export interface AuthCardProps {
readonly headingId: string;
readonly heading: string;
readonly testId: string;
readonly children: React.ReactNode;
}
/** One centred card on the sign-in background, with a labelled region for assistive technology. */
export function AuthCard(props: AuthCardProps): ReactElement {
return (
{props.heading}
{props.children}
);
}
export interface UseSingleSubmissionResult {
readonly pending: boolean;
readonly errorMessage: string | undefined;
readonly setErrorMessage: (message: string | undefined) => void;
/** Runs `operation` at most once at a time. A second submit while one is in flight is dropped. */
readonly submit: (
event: FormEvent,
operation: (signal: AbortSignal) => Promise,
) => Promise;
}
/**
* The submission discipline every auth form needs, in one place.
*
* A `ref` closes the same-tick gap before React commits `pending`, which is what actually prevents a
* double submission — a disabled attribute alone cannot, because it is not applied until after the
* commit. Every one of these forms triggers an email or changes a credential, so a duplicate is not
* merely untidy.
*/
export function useSingleSubmission(fallbackMessage: string): UseSingleSubmissionResult {
const [pending, setPending] = useState(false);
const [errorMessage, setErrorMessage] = useState(undefined);
const pendingRef = useRef(false);
const attemptRef = useRef(undefined);
const mountedRef = useRef(true);
useEffect(() => {
mountedRef.current = true;
return () => {
mountedRef.current = false;
attemptRef.current?.abort();
};
}, []);
const submit = async (
event: FormEvent,
operation: (signal: AbortSignal) => Promise,
): Promise => {
event.preventDefault();
if (pendingRef.current) {
return;
}
pendingRef.current = true;
setPending(true);
setErrorMessage(undefined);
const attempt = new AbortController();
attemptRef.current = attempt;
try {
await operation(attempt.signal);
} catch (error) {
if (!attempt.signal.aborted && mountedRef.current) {
// A `HostAuthError` message is fixed text this package wrote. Anything else is an unknown
// thrown value whose message could contain a URL or a provider detail, so it is replaced.
setErrorMessage(error instanceof HostAuthError ? error.message : fallbackMessage);
}
} finally {
if (attemptRef.current === attempt) {
attemptRef.current = undefined;
pendingRef.current = false;
if (mountedRef.current) {
setPending(false);
}
}
}
};
return { errorMessage, pending, setErrorMessage, submit };
}