@edge-base/web 0.1.1

package/dist/turnstile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnstile.d.ts","sourceRoot":"","sources":["../src/turnstile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,CAAC,EAAE;YACV,MAAM,EAAE,CACN,SAAS,EAAE,MAAM,GAAG,WAAW,EAC/B,OAAO,EAAE;gBACP,OAAO,EAAE,MAAM,CAAC;gBAChB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;gBACnC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;gBAC5C,6BAA6B,CAAC,EAAE,MAAM,IAAI,CAAC;gBAC3C,4BAA4B,CAAC,EAAE,MAAM,IAAI,CAAC;gBAC1C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;gBAChC,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,kBAAkB,CAAC;gBACvD,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;aAC1C,KACE,MAAM,CAAC;YACZ,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;YACnC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;SACnC,CAAC;KACH;CACF;AAgED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,SAAQ,GAChB,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAOD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqB1E;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}

package/dist/turnstile.js

@@ -0,0 +1,191 @@
+/**
+ * Turnstile captcha provider for browser environments.
+ *
+ * Automatically loads Cloudflare Turnstile JS SDK, renders invisible widget,
+ * and returns a captcha token. If interactive challenge is needed, shows
+ * a centered modal overlay automatically.
+ *
+ * Usage (internal — called by AuthClient):
+ *   const token = await getCaptchaToken(siteKey, 'signup');
+ */
+const TURNSTILE_SCRIPT_URL = 'https://challenges.cloudflare.com/turnstile/v0/api.js';
+let scriptLoaded = false;
+let scriptLoading = null;
+/** Load Turnstile JS SDK (idempotent). */
+function loadTurnstileScript() {
+    if (scriptLoaded && window.turnstile)
+        return Promise.resolve();
+    if (scriptLoading)
+        return scriptLoading;
+    scriptLoading = new Promise((resolve, reject) => {
+        // Check if already in DOM
+        if (document.querySelector(`script[src^="${TURNSTILE_SCRIPT_URL}"]`)) {
+            const check = () => {
+                if (window.turnstile) {
+                    scriptLoaded = true;
+                    resolve();
+                }
+                else
+                    setTimeout(check, 50);
+            };
+            check();
+            return;
+        }
+        const script = document.createElement('script');
+        script.src = `${TURNSTILE_SCRIPT_URL}?render=explicit`;
+        script.async = true;
+        script.defer = true;
+        script.onload = () => {
+            const check = () => {
+                if (window.turnstile) {
+                    scriptLoaded = true;
+                    resolve();
+                }
+                else
+                    setTimeout(check, 50);
+            };
+            check();
+        };
+        script.onerror = () => {
+            scriptLoading = null;
+            reject(new Error('Failed to load Turnstile script'));
+        };
+        document.head.appendChild(script);
+    });
+    return scriptLoading;
+}
+/** Create modal overlay for interactive challenge. Hidden by default. */
+function createOverlay() {
+    const overlay = document.createElement('div');
+    overlay.style.cssText = 'position:fixed;top:0;left:0;width:100%;height:100%;background:rgba(0,0,0,0.5);display:none;align-items:center;justify-content:center;z-index:999999;';
+    const container = document.createElement('div');
+    container.style.cssText = 'background:#fff;border-radius:12px;padding:16px;box-shadow:0 4px 24px rgba(0,0,0,0.2);';
+    overlay.appendChild(container);
+    document.body.appendChild(overlay);
+    return {
+        overlay,
+        container,
+        show: () => { overlay.style.display = 'flex'; },
+        hide: () => { overlay.style.display = 'none'; },
+        destroy: () => { overlay.remove(); },
+    };
+}
+/**
+ * Get a Turnstile captcha token for the given action.
+ *
+ * - Loads Turnstile JS SDK if needed (cached)
+ * - Renders invisible widget → auto-passes for 99% of users
+ * - If interactive challenge needed → shows centered modal overlay automatically
+ * - Returns the token string
+ *
+ * @param siteKey - Turnstile site key from GET /api/config
+ * @param action - Action name (e.g. 'signup', 'signin', 'anonymous')
+ * @param timeoutMs - Timeout in ms (default: 30000)
+ */
+export async function getCaptchaToken(siteKey, action, timeoutMs = 30000) {
+    if (typeof window === 'undefined' || typeof document === 'undefined') {
+        throw new Error('Turnstile is only available in browser environments');
+    }
+    await loadTurnstileScript();
+    if (!window.turnstile) {
+        throw new Error('Turnstile failed to initialize');
+    }
+    return new Promise((resolve, reject) => {
+        const { container, show, hide, destroy } = createOverlay();
+        const timer = setTimeout(() => {
+            cleanup();
+            reject(new Error('Turnstile timeout'));
+        }, timeoutMs);
+        let widgetId;
+        const cleanup = () => {
+            clearTimeout(timer);
+            if (widgetId && window.turnstile) {
+                try {
+                    window.turnstile.remove(widgetId);
+                }
+                catch { /* ignore */ }
+            }
+            destroy();
+        };
+        widgetId = window.turnstile.render(container, {
+            sitekey: siteKey,
+            action,
+            appearance: 'interaction-only',
+            callback: (token) => {
+                cleanup();
+                resolve(token);
+            },
+            'error-callback': (error) => {
+                cleanup();
+                reject(new Error(`Turnstile error: ${error}`));
+            },
+            'before-interactive-callback': () => {
+                show();
+            },
+            'after-interactive-callback': () => {
+                hide();
+            },
+            'timeout-callback': () => {
+                cleanup();
+                reject(new Error('Turnstile challenge timed out'));
+            },
+        });
+    });
+}
+// ─── Site Key Cache ───
+let siteKeyCache = null;
+let siteKeyPromise = null;
+/**
+ * Fetch captcha siteKey from GET /api/config (cached).
+ * Returns null if captcha is not configured on server.
+ */
+export async function fetchSiteKey(baseUrl) {
+    if (siteKeyCache !== null)
+        return siteKeyCache;
+    if (siteKeyPromise)
+        return siteKeyPromise;
+    siteKeyPromise = (async () => {
+        try {
+            const res = await fetch(`${baseUrl}/api/config`, {
+                signal: AbortSignal.timeout(3000),
+            });
+            if (!res.ok)
+                return null;
+            const data = (await res.json());
+            siteKeyCache = data.captcha?.siteKey ?? null;
+            return siteKeyCache;
+        }
+        catch {
+            return null;
+        }
+        finally {
+            siteKeyPromise = null;
+        }
+    })();
+    return siteKeyPromise;
+}
+/**
+ * Resolve captcha token: use provided token or auto-acquire via Turnstile.
+ *
+ * - If captchaToken is provided → return it (manual override)
+ * - If siteKey is available → auto-acquire via Turnstile widget
+ * - If no siteKey (captcha not configured) → return undefined
+ */
+export async function resolveCaptchaToken(baseUrl, action, captchaToken) {
+    // Manual override — skip built-in widget
+    if (captchaToken)
+        return captchaToken;
+    // Fetch siteKey (cached)
+    const siteKey = await fetchSiteKey(baseUrl);
+    if (!siteKey)
+        return undefined; // Captcha not configured on server
+    // Auto-acquire token via Turnstile
+    try {
+        return await getCaptchaToken(siteKey, action);
+    }
+    catch {
+        // Turnstile failed — let server handle (failMode: open/closed)
+        return undefined;
+    }
+}
+//# sourceMappingURL=turnstile.js.map

package/dist/turnstile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnstile.js","sourceRoot":"","sources":["../src/turnstile.ts"],"names":[],"mappings":"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"}