DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
const RETURN_URL_BASE = "https://deeptutor.invalid";
export interface BrowserLocationParts {
pathname: string;
search?: string;
hash?: string;
}
/** Return a same-origin application path or the supplied safe fallback. */
export function normalizeInternalReturnPath(
raw: string | null | undefined,
fallback = "/",
): string {
const candidate = String(raw ?? "").trim();
if (
!candidate.startsWith("/") ||
candidate.startsWith("//") ||
candidate.includes("\\") ||
/[\u0000-\u001f\u007f]/.test(candidate)
) {
return fallback;
}
try {
const parsed = new URL(candidate, RETURN_URL_BASE);
if (parsed.origin !== RETURN_URL_BASE) return fallback;
const decodedPath = decodeURIComponent(parsed.pathname);
if (
decodedPath.startsWith("//") ||
decodedPath.includes("\\") ||
/[\u0000-\u001f\u007f]/.test(decodedPath)
) {
return fallback;
}
return `${parsed.pathname}${parsed.search}${parsed.hash}`;
} catch {
return fallback;
}
}
export function browserReturnPath(location: BrowserLocationParts): string {
return normalizeInternalReturnPath(
`${location.pathname}${location.search ?? ""}${location.hash ?? ""}`,
);
}
export function loginHref(returnPath: string): string {
const query = new URLSearchParams({
next: normalizeInternalReturnPath(returnPath),
});
return `/login?${query.toString()}`;
}
/**
* Server redirects cannot read a fragment. Browsers retain it on the login
* URL, so carry that fragment into a validated destination that lacks one.
*/
export function inheritLoginHash(returnPath: string, loginHash: string): string {
const safe = normalizeInternalReturnPath(returnPath);
if (!loginHash || safe.includes("#")) return safe;
const hash = loginHash.startsWith("#") ? loginHash : `#${loginHash}`;
return normalizeInternalReturnPath(`${safe}${hash}`);
}