/** * Global fetch interceptor for transparent 401 → token-refresh → retry. * * WHY a global interceptor instead of a per-call wrapper: * Every authenticated API call in the app needs the same 401 handling. * Replacing each `fetch(...)` call individually is error-prone (easy to * miss one) and creates noise across every module. Patching `window.fetch` * once here means all existing and future calls are covered automatically. * * WHY _originalFetch must be used everywhere inside this module: * `_refresh()` itself calls `/api/auth/refresh`. If it used `window.fetch` * (the patched version), a 401 on the refresh endpoint would call `_refresh()` * again, which would call `window.fetch` again — infinite recursion. The same * applies to the interceptor's own initial call and the retry: they must all * bypass the interceptor by using the captured `_originalFetch` directly. * * WHY /api/auth/ endpoints are excluded from the retry logic: * login, logout, refresh, and /me are the auth primitives themselves. * A 401 on these means credentials are genuinely invalid — retrying after * a refresh makes no sense and would loop. * * WHY cross-origin requests bypass the interceptor entirely: * A 401 from an external service (e.g. a third-party library calling its own * API) has nothing to do with OxiCloud's session. Attempting a token refresh * and redirecting to /login in response would be catastrophic. Only same-origin * requests go through the refresh-and-retry path. * * Call `installFetchInterceptor()` once at app startup (before any fetch). */ import { getCsrfHeaders } from './csrf.js'; const WRAPPER_REFRESH_ENDPOINT = '/api/auth/refresh'; const WRAPPER_USER_DATA_KEY = 'oxicloud_user'; /** Captured before patching — the only safe fetch inside this module. */ let _originalFetch = window.fetch.bind(window); /** Deduplicates concurrent refresh attempts into a single in-flight promise. */ /** @type {Promise | null} */ let _refreshInFlight = null; async function _refresh() { if (_refreshInFlight) return _refreshInFlight; console.log(`requesting a refresh token`); // Must use _originalFetch to avoid re-entering the interceptor. _refreshInFlight = (async () => { try { const r = await _originalFetch(WRAPPER_REFRESH_ENDPOINT, { method: 'POST', credentials: 'same-origin', headers: { 'Content-Type': 'application/json', ...getCsrfHeaders() }, body: '{}' }); return r.ok; } catch { return false; } finally { _refreshInFlight = null; } })(); return _refreshInFlight; } function installFetchInterceptor() { // Capture the real fetch before overwriting it. _originalFetch = window.fetch.bind(window); window.fetch = async (url, options) => { // Use _originalFetch for the actual network call — NOT window.fetch — // so this interceptor does not call itself recursively. const response = await _originalFetch(url, options); if (response.status !== 401) return response; const urlStr = typeof url === 'string' ? url : url instanceof URL ? url.href : (url.url ?? ''); // Cross-origin: a 401 from an external service is none of our business. // Pass it through untouched so the caller can handle it themselves. try { if (new URL(urlStr, window.location.origin).origin !== window.location.origin) { return response; } } catch { return response; } // True auth primitives must bypass retry — they would either loop // (/refresh), or a 401 there genuinely means bad credentials (login, // register, oidc, device flows). User-data endpoints that happen to // live under /api/auth/ (me, me/image, change-password, app-passwords) // ARE retried so that an expired access token is transparently refreshed. // Public share endpoints (/api/s/) use 401 to mean "password required", // not "session expired" — intercepting them would wrongly redirect to login. const AUTH_PRIMITIVES = [ '/api/auth/login', '/api/auth/logout', '/api/auth/refresh', '/api/auth/register', '/api/auth/setup', '/api/auth/oidc/', '/api/auth/device/' ]; if (AUTH_PRIMITIVES.some((p) => urlStr.includes(p)) || urlStr.includes('/api/s/')) { return response; } const refreshed = await _refresh(); if (!refreshed) { localStorage.removeItem(WRAPPER_USER_DATA_KEY); window.location.href = '/login?source=session_expired'; throw new Error('Session expired'); } // Retry with _originalFetch for the same reason as above. return _originalFetch(url, options); }; } export { installFetchInterceptor };