@hexclave/shared 1.0.0

package/dist/esm/utils/turnstile-flow.js

@@ -0,0 +1,219 @@
+import { HexclaveAssertionError, captureError } from "./errors.js";
+import { getTurnstileApi, loadTurnstileScript } from "./turnstile-browser.js";
+
+//#region src/utils/turnstile-flow.ts
+var BotChallengeUserCancelledError = class extends Error {
+	constructor() {
+		super("User cancelled the bot challenge");
+		this.name = "BotChallengeUserCancelledError";
+	}
+};
+var BotChallengeExecutionFailedError = class extends Error {
+	constructor(message = "Bot challenge could not be completed", options) {
+		super(message, options);
+		this.name = "BotChallengeExecutionFailedError";
+	}
+};
+const INVISIBLE_TIMEOUT_MS = 3e4;
+async function executeTurnstileInvisible(siteKey, action) {
+	await loadTurnstileScript();
+	const api = getTurnstileApi();
+	if (!api) throw new HexclaveAssertionError("Turnstile API not available after loadTurnstileScript() resolved");
+	const container = document.createElement("div");
+	Object.assign(container.style, {
+		position: "fixed",
+		left: "-9999px",
+		top: "-9999px"
+	});
+	document.body.appendChild(container);
+	let widgetId;
+	try {
+		return await new Promise((resolve, reject) => {
+			const timeout = setTimeout(() => reject(/* @__PURE__ */ new Error("Turnstile invisible challenge timed out")), INVISIBLE_TIMEOUT_MS);
+			const settle = (fn) => {
+				clearTimeout(timeout);
+				fn();
+			};
+			widgetId = api.render(container, {
+				sitekey: siteKey,
+				action,
+				size: "invisible",
+				execution: "execute",
+				appearance: "execute",
+				callback: (t) => settle(() => resolve(t)),
+				"error-callback": () => settle(() => reject(/* @__PURE__ */ new Error("Turnstile invisible verification failed"))),
+				"expired-callback": () => settle(() => reject(/* @__PURE__ */ new Error("Turnstile token expired"))),
+				"timeout-callback": () => settle(() => reject(/* @__PURE__ */ new Error("Turnstile challenge timed out")))
+			});
+			api.execute?.(widgetId);
+		});
+	} finally {
+		if (widgetId != null) try {
+			api.remove(widgetId);
+		} catch (e) {
+			captureError("turnstile-widget-remove", e instanceof Error ? e : new HexclaveAssertionError("Non-Error thrown during Turnstile widget removal", { cause: e }));
+		}
+		container.remove();
+	}
+}
+const VISIBLE_TIMEOUT_MS = 12e4;
+const OVERLAY_Z_INDEX = "999999";
+let activeOverlay = null;
+function el(tag, style, props) {
+	const element = document.createElement(tag);
+	Object.assign(element.style, style);
+	if (props) for (const [k, v] of Object.entries(props)) element.setAttribute(k, v);
+	return element;
+}
+function showTurnstileVisibleChallenge(siteKey, action) {
+	if (activeOverlay) {
+		activeOverlay.reject(new BotChallengeUserCancelledError());
+		activeOverlay.cleanup();
+		activeOverlay = null;
+	}
+	return new Promise((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			cleanup();
+			reject(/* @__PURE__ */ new Error("Visible Turnstile challenge timed out"));
+		}, VISIBLE_TIMEOUT_MS);
+		const overlay = el("div", {
+			position: "fixed",
+			inset: "0",
+			zIndex: OVERLAY_Z_INDEX,
+			display: "flex",
+			alignItems: "center",
+			justifyContent: "center",
+			background: "rgba(0,0,0,0.5)",
+			backdropFilter: "blur(2px)"
+		}, { "data-stack-turnstile-overlay": "true" });
+		const card = el("div", {
+			background: "white",
+			borderRadius: "12px",
+			padding: "24px",
+			maxWidth: "400px",
+			width: "90%",
+			textAlign: "center",
+			boxShadow: "0 4px 24px rgba(0,0,0,0.18)",
+			fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif"
+		});
+		const title = el("p", {
+			margin: "0 0 16px",
+			fontSize: "16px",
+			fontWeight: "600",
+			color: "#333"
+		});
+		title.textContent = "Please complete the security check";
+		const widgetContainer = el("div", {
+			display: "flex",
+			justifyContent: "center",
+			minHeight: "65px"
+		});
+		const errorText = el("p", {
+			margin: "8px 0 0",
+			fontSize: "14px",
+			color: "#dc2626",
+			display: "none"
+		});
+		const cancelBtn = el("button", {
+			marginTop: "16px",
+			padding: "8px 20px",
+			border: "1px solid #ddd",
+			borderRadius: "6px",
+			background: "transparent",
+			cursor: "pointer",
+			fontSize: "14px",
+			color: "#666"
+		});
+		cancelBtn.textContent = "Cancel";
+		cancelBtn.onmouseover = () => {
+			cancelBtn.style.background = "#f5f5f5";
+		};
+		cancelBtn.onmouseout = () => {
+			cancelBtn.style.background = "transparent";
+		};
+		card.append(title, widgetContainer, errorText, cancelBtn);
+		overlay.appendChild(card);
+		document.body.appendChild(overlay);
+		function cleanup() {
+			clearTimeout(timeout);
+			overlay.remove();
+			if (activeOverlay?.cleanup === cleanup) activeOverlay = null;
+		}
+		activeOverlay = {
+			cleanup,
+			reject
+		};
+		cancelBtn.onclick = () => {
+			cleanup();
+			reject(new BotChallengeUserCancelledError());
+		};
+		loadTurnstileScript().then(() => {
+			const api = getTurnstileApi();
+			if (!api) {
+				cleanup();
+				reject(new HexclaveAssertionError("Turnstile API not available after loadTurnstileScript() resolved"));
+				return;
+			}
+			api.render(widgetContainer, {
+				sitekey: siteKey,
+				action,
+				appearance: "always",
+				execution: "render",
+				size: "flexible",
+				callback: (token) => {
+					cleanup();
+					resolve(token);
+				},
+				"error-callback": (errorCode) => {
+					errorText.textContent = errorCode ? `Verification error: ${errorCode}` : "Verification failed. Please try again.";
+					errorText.style.display = "block";
+				},
+				"expired-callback": () => {
+					errorText.textContent = "Challenge expired. Please solve it again.";
+					errorText.style.display = "block";
+				}
+			});
+		}).catch((err) => {
+			cleanup();
+			reject(err);
+		});
+	});
+}
+async function withBotChallengeFlow(options) {
+	if (typeof window === "undefined") return await options.execute({});
+	let invisibleToken;
+	let usedVisibleFallback = false;
+	try {
+		invisibleToken = await executeTurnstileInvisible(options.invisibleSiteKey, options.action);
+	} catch {
+		try {
+			invisibleToken = await showTurnstileVisibleChallenge(options.visibleSiteKey, options.action);
+			usedVisibleFallback = true;
+		} catch (e) {
+			if (e instanceof BotChallengeUserCancelledError) throw e;
+			captureError("turnstile-flow-all-challenges-failed", e instanceof Error ? e : new HexclaveAssertionError("Non-Error thrown during Turnstile challenge", { cause: e }));
+			return await options.execute({ unavailable: true });
+		}
+	}
+	const firstResult = await options.execute({
+		token: invisibleToken,
+		phase: invisibleToken ? usedVisibleFallback ? "visible" : "invisible" : void 0
+	});
+	if (!options.isChallengeRequired(firstResult)) return firstResult;
+	let visibleToken;
+	try {
+		visibleToken = await showTurnstileVisibleChallenge(options.visibleSiteKey, options.action);
+	} catch (e) {
+		if (e instanceof BotChallengeUserCancelledError) throw e;
+		captureError("turnstile-flow-visible-challenge-failed", e instanceof Error ? e : new HexclaveAssertionError("Non-Error thrown during visible Turnstile challenge", { cause: e }));
+		throw new BotChallengeExecutionFailedError("Visible bot challenge could not be completed", { cause: e });
+	}
+	return await options.execute({
+		token: visibleToken,
+		phase: "visible"
+	});
+}
+
+//#endregion
+export { BotChallengeExecutionFailedError, BotChallengeUserCancelledError, executeTurnstileInvisible, showTurnstileVisibleChallenge, withBotChallengeFlow };
+//# sourceMappingURL=turnstile-flow.js.map

package/dist/esm/utils/turnstile-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnstile-flow.js","names":[],"sources":["../../../src/utils/turnstile-flow.ts"],"sourcesContent":["import { HexclaveAssertionError, captureError } from \"./errors\";\nimport { loadTurnstileScript, getTurnstileApi } from \"./turnstile-browser\";\nimport type { TurnstileAction } from \"./turnstile\";\n\nexport class BotChallengeUserCancelledError extends Error {\n  constructor() {\n    super(\"User cancelled the bot challenge\");\n    this.name = \"BotChallengeUserCancelledError\";\n  }\n}\n\nexport class BotChallengeExecutionFailedError extends Error {\n  constructor(message = \"Bot challenge could not be completed\", options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"BotChallengeExecutionFailedError\";\n  }\n}\n\n\n// ── Invisible challenge ────────────────────────────────────────────────\n\nconst INVISIBLE_TIMEOUT_MS = 30_000;\n\nexport async function executeTurnstileInvisible(siteKey: string, action: TurnstileAction): Promise<string> {\n  await loadTurnstileScript();\n  const api = getTurnstileApi();\n  if (!api) throw new HexclaveAssertionError(\"Turnstile API not available after loadTurnstileScript() resolved\");\n\n  const container = document.createElement(\"div\");\n  Object.assign(container.style, { position: \"fixed\", left: \"-9999px\", top: \"-9999px\" });\n  document.body.appendChild(container);\n\n  let widgetId: string | undefined;\n  try {\n    return await new Promise<string>((resolve, reject) => {\n      const timeout = setTimeout(\n        () => reject(new Error(\"Turnstile invisible challenge timed out\")),\n        INVISIBLE_TIMEOUT_MS,\n      );\n      const settle = (fn: () => void) => {\n        clearTimeout(timeout);\n        fn();\n      };\n\n      widgetId = api.render(container, {\n        sitekey: siteKey,\n        action,\n        size: \"invisible\",\n        execution: \"execute\",\n        appearance: \"execute\",\n        callback: (t) => settle(() => resolve(t)),\n        \"error-callback\": () => settle(() => reject(new Error(\"Turnstile invisible verification failed\"))),\n        \"expired-callback\": () => settle(() => reject(new Error(\"Turnstile token expired\"))),\n        \"timeout-callback\": () => settle(() => reject(new Error(\"Turnstile challenge timed out\"))),\n      });\n\n      api.execute?.(widgetId);\n    });\n  } finally {\n    if (widgetId != null) {\n      try {\n        api.remove(widgetId);\n      } catch (e) {\n        captureError(\"turnstile-widget-remove\", e instanceof Error ? e : new HexclaveAssertionError(\"Non-Error thrown during Turnstile widget removal\", { cause: e }));\n      }\n    }\n    container.remove();\n  }\n}\n\n\n// ── Visible challenge overlay ──────────────────────────────────────────\n\nconst VISIBLE_TIMEOUT_MS = 120_000;\nconst OVERLAY_Z_INDEX = \"999999\";\n\n// Module-level singleton: only one visible overlay can be active at a time.\n// If a second challenge is requested while one is showing (e.g. user clicks another\n// auth flow), the previous overlay is cancelled with BotChallengeUserCancelledError\n// and cleaned up before the new one renders.\nlet activeOverlay: { cleanup: () => void, reject: (err: Error) => void } | null = null;\n\nfunction el<K extends keyof HTMLElementTagNameMap>(\n  tag: K,\n  style: Partial<CSSStyleDeclaration>,\n  props?: Record<string, string>,\n): HTMLElementTagNameMap[K] {\n  const element = document.createElement(tag);\n  Object.assign(element.style, style);\n  if (props) {\n    for (const [k, v] of Object.entries(props)) {\n      element.setAttribute(k, v);\n    }\n  }\n  return element;\n}\n\nexport function showTurnstileVisibleChallenge(siteKey: string, action: TurnstileAction): Promise<string> {\n  if (activeOverlay) {\n    activeOverlay.reject(new BotChallengeUserCancelledError());\n    activeOverlay.cleanup();\n    activeOverlay = null;\n  }\n\n  return new Promise<string>((resolve, reject) => {\n    const timeout = setTimeout(() => {\n      cleanup();\n      reject(new Error(\"Visible Turnstile challenge timed out\"));\n    }, VISIBLE_TIMEOUT_MS);\n\n    const overlay = el(\"div\", {\n      position: \"fixed\", inset: \"0\", zIndex: OVERLAY_Z_INDEX,\n      display: \"flex\", alignItems: \"center\", justifyContent: \"center\",\n      background: \"rgba(0,0,0,0.5)\", backdropFilter: \"blur(2px)\",\n    }, { \"data-stack-turnstile-overlay\": \"true\" });\n\n    const card = el(\"div\", {\n      background: \"white\", borderRadius: \"12px\", padding: \"24px\",\n      maxWidth: \"400px\", width: \"90%\", textAlign: \"center\",\n      boxShadow: \"0 4px 24px rgba(0,0,0,0.18)\",\n      fontFamily: \"-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif\",\n    });\n\n    const title = el(\"p\", { margin: \"0 0 16px\", fontSize: \"16px\", fontWeight: \"600\", color: \"#333\" });\n    title.textContent = \"Please complete the security check\";\n\n    const widgetContainer = el(\"div\", { display: \"flex\", justifyContent: \"center\", minHeight: \"65px\" });\n\n    const errorText = el(\"p\", { margin: \"8px 0 0\", fontSize: \"14px\", color: \"#dc2626\", display: \"none\" });\n\n    const cancelBtn = el(\"button\", {\n      marginTop: \"16px\", padding: \"8px 20px\", border: \"1px solid #ddd\",\n      borderRadius: \"6px\", background: \"transparent\", cursor: \"pointer\",\n      fontSize: \"14px\", color: \"#666\",\n    });\n    cancelBtn.textContent = \"Cancel\";\n    cancelBtn.onmouseover = () => {\n      cancelBtn.style.background = \"#f5f5f5\";\n    };\n    cancelBtn.onmouseout = () => {\n      cancelBtn.style.background = \"transparent\";\n    };\n\n    card.append(title, widgetContainer, errorText, cancelBtn);\n    overlay.appendChild(card);\n    document.body.appendChild(overlay);\n\n    function cleanup() {\n      clearTimeout(timeout);\n      overlay.remove();\n      if (activeOverlay?.cleanup === cleanup) {\n        activeOverlay = null;\n      }\n    }\n\n    activeOverlay = { cleanup, reject };\n    cancelBtn.onclick = () => {\n      cleanup();\n      reject(new BotChallengeUserCancelledError());\n    };\n\n    loadTurnstileScript().then(() => {\n      const api = getTurnstileApi();\n      if (!api) {\n        cleanup();\n        reject(new HexclaveAssertionError(\"Turnstile API not available after loadTurnstileScript() resolved\"));\n        return;\n      }\n\n      api.render(widgetContainer, {\n        sitekey: siteKey,\n        action,\n        appearance: \"always\",\n        execution: \"render\",\n        size: \"flexible\",\n        callback: (token) => {\n          cleanup();\n          resolve(token);\n        },\n        \"error-callback\": (errorCode) => {\n          errorText.textContent = errorCode ? `Verification error: ${errorCode}` : \"Verification failed. Please try again.\";\n          errorText.style.display = \"block\";\n        },\n        \"expired-callback\": () => {\n          errorText.textContent = \"Challenge expired. Please solve it again.\";\n          errorText.style.display = \"block\";\n        },\n      });\n    }).catch((err) => {\n      cleanup();\n      reject(err);\n    });\n  });\n}\n\n\n// ── Flow orchestrator ──────────────────────────────────────────────────\n\nexport type BotChallengeExecuteParams = {\n  token?: string,\n  phase?: \"invisible\" | \"visible\",\n  unavailable?: true,\n};\n\nexport type WithBotChallengeFlowOptions<T> = {\n  visibleSiteKey: string,\n  invisibleSiteKey: string,\n  action: TurnstileAction,\n  execute: (challenge: BotChallengeExecuteParams) => Promise<T>,\n  isChallengeRequired: (result: T) => boolean,\n};\n\n// We use separate invisible + visible flows (rather than Turnstile's \"managed\" mode) because:\n// 1. Managed mode auto-decides visibility, but we need deterministic server-side logic:\n//    invisible-fail → require visible challenge → fail = block.\n// 2. Invisible + visible use different site keys so the server can tell which phase passed.\n// 3. Managed mode doesn't expose an API to programmatically trigger a retry with a\n//    different widget type, which our two-phase challenge escalation requires.\nexport async function withBotChallengeFlow<T>(options: WithBotChallengeFlowOptions<T>): Promise<T> {\n  // Server safe: no Turnstile in SSR — just call execute with no turnstile params\n  if (typeof window === \"undefined\") {\n    return await options.execute({});\n  }\n\n  // Phase 1: invisible token\n  let invisibleToken: string | undefined;\n  let usedVisibleFallback = false;\n  try {\n    invisibleToken = await executeTurnstileInvisible(options.invisibleSiteKey, options.action);\n  } catch {\n    try {\n      invisibleToken = await showTurnstileVisibleChallenge(options.visibleSiteKey, options.action);\n      usedVisibleFallback = true;\n    } catch (e) {\n      if (e instanceof BotChallengeUserCancelledError) throw e;\n      // Both challenges failed (for example Cloudflare is unreachable) — tell the\n      // server explicitly so it can distinguish challenge infra outages from a\n      // user submitting an invalid visible challenge.\n      captureError(\"turnstile-flow-all-challenges-failed\", e instanceof Error ? e : new HexclaveAssertionError(\"Non-Error thrown during Turnstile challenge\", { cause: e }));\n      return await options.execute({ unavailable: true });\n    }\n  }\n\n  const firstResult = await options.execute({\n    token: invisibleToken,\n    phase: invisibleToken ? (usedVisibleFallback ? \"visible\" : \"invisible\") : undefined,\n  });\n\n  if (!options.isChallengeRequired(firstResult)) {\n    return firstResult;\n  }\n\n  // Phase 2: visible challenge (single retry)\n  let visibleToken: string | undefined;\n  try {\n    visibleToken = await showTurnstileVisibleChallenge(options.visibleSiteKey, options.action);\n  } catch (e) {\n    if (e instanceof BotChallengeUserCancelledError) throw e;\n    captureError(\"turnstile-flow-visible-challenge-failed\", e instanceof Error ? e : new HexclaveAssertionError(\"Non-Error thrown during visible Turnstile challenge\", { cause: e }));\n    throw new BotChallengeExecutionFailedError(\"Visible bot challenge could not be completed\", {\n      cause: e,\n    });\n  }\n\n  return await options.execute({ token: visibleToken, phase: \"visible\" });\n}\n"],"mappings":"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"}

package/dist/esm/utils/turnstile-flow.test.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/esm/utils/turnstile-flow.test.js

@@ -0,0 +1,75 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+//#region src/utils/turnstile-flow.test.ts
+// @vitest-environment jsdom
+const loadTurnstileScriptMock = vi.fn(() => Promise.resolve());
+const renderMock = vi.fn();
+const executeMock = vi.fn();
+const removeMock = vi.fn();
+const captureErrorMock = vi.fn();
+vi.mock("./turnstile-browser", () => ({
+	loadTurnstileScript: loadTurnstileScriptMock,
+	getTurnstileApi: () => ({
+		render: renderMock,
+		execute: executeMock,
+		remove: removeMock
+	})
+}));
+vi.mock("./errors", async () => {
+	return {
+		...await vi.importActual("./errors"),
+		captureError: captureErrorMock
+	};
+});
+describe("withBotChallengeFlow", () => {
+	beforeEach(() => {
+		vi.clearAllMocks();
+		loadTurnstileScriptMock.mockResolvedValue(void 0);
+		renderMock.mockImplementation((_container, config) => {
+			config.callback("invisible-token");
+			return "widget-id";
+		});
+		executeMock.mockImplementation(() => {});
+		removeMock.mockImplementation(() => {});
+	});
+	it("throws a bot challenge execution error when the phase-2 visible challenge fails", async () => {
+		const { BotChallengeExecutionFailedError, withBotChallengeFlow } = await import("./turnstile-flow.js");
+		loadTurnstileScriptMock.mockResolvedValueOnce(void 0).mockRejectedValueOnce(/* @__PURE__ */ new Error("cloudflare unavailable"));
+		const execute = vi.fn(async ({ token, phase }) => {
+			if (token === "invisible-token" && phase === "invisible") return { requiresChallenge: true };
+			return { requiresChallenge: false };
+		});
+		await expect(withBotChallengeFlow({
+			visibleSiteKey: "visible-site-key",
+			invisibleSiteKey: "invisible-site-key",
+			action: "sign_up_with_credential",
+			execute,
+			isChallengeRequired: (result) => result.requiresChallenge
+		})).rejects.toBeInstanceOf(BotChallengeExecutionFailedError);
+		expect(execute).toHaveBeenCalledTimes(1);
+		expect(execute).toHaveBeenCalledWith({
+			token: "invisible-token",
+			phase: "invisible"
+		});
+		expect(captureErrorMock).toHaveBeenCalledWith("turnstile-flow-visible-challenge-failed", expect.any(Error));
+	});
+	it("marks the challenge as unavailable when both phase-1 challenge attempts fail", async () => {
+		const { withBotChallengeFlow } = await import("./turnstile-flow.js");
+		loadTurnstileScriptMock.mockRejectedValueOnce(/* @__PURE__ */ new Error("invisible unavailable")).mockRejectedValueOnce(/* @__PURE__ */ new Error("visible unavailable"));
+		const execute = vi.fn(async ({ unavailable }) => ({ unavailable }));
+		await expect(withBotChallengeFlow({
+			visibleSiteKey: "visible-site-key",
+			invisibleSiteKey: "invisible-site-key",
+			action: "sign_up_with_credential",
+			execute,
+			isChallengeRequired: () => false
+		})).resolves.toEqual({ unavailable: true });
+		expect(execute).toHaveBeenCalledTimes(1);
+		expect(execute).toHaveBeenCalledWith({ unavailable: true });
+		expect(captureErrorMock).toHaveBeenCalledWith("turnstile-flow-all-challenges-failed", expect.any(Error));
+	});
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=turnstile-flow.test.js.map

package/dist/esm/utils/turnstile-flow.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnstile-flow.test.js","names":[],"sources":["../../../src/utils/turnstile-flow.test.ts"],"sourcesContent":["// @vitest-environment jsdom\n\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nconst loadTurnstileScriptMock = vi.fn(() => Promise.resolve());\nconst renderMock = vi.fn();\nconst executeMock = vi.fn();\nconst removeMock = vi.fn();\nconst captureErrorMock = vi.fn();\n\nvi.mock(\"./turnstile-browser\", () => ({\n  loadTurnstileScript: loadTurnstileScriptMock,\n  getTurnstileApi: () => ({\n    render: renderMock,\n    execute: executeMock,\n    remove: removeMock,\n  }),\n}));\n\nvi.mock(\"./errors\", async () => {\n  const actual = await vi.importActual<typeof import(\"./errors\")>(\"./errors\");\n  return {\n    ...actual,\n    captureError: captureErrorMock,\n  };\n});\n\ndescribe(\"withBotChallengeFlow\", () => {\n  beforeEach(() => {\n    vi.clearAllMocks();\n    loadTurnstileScriptMock.mockResolvedValue(undefined);\n    renderMock.mockImplementation((_container, config: {\n      callback: (token: string) => void,\n    }) => {\n      config.callback(\"invisible-token\");\n      return \"widget-id\";\n    });\n    executeMock.mockImplementation(() => {});\n    removeMock.mockImplementation(() => {});\n  });\n\n  it(\"throws a bot challenge execution error when the phase-2 visible challenge fails\", async () => {\n    const { BotChallengeExecutionFailedError, withBotChallengeFlow } = await import(\"./turnstile-flow\");\n\n    loadTurnstileScriptMock\n      .mockResolvedValueOnce(undefined)\n      .mockRejectedValueOnce(new Error(\"cloudflare unavailable\"));\n\n    const execute = vi.fn(async ({ token, phase }: { token?: string, phase?: \"invisible\" | \"visible\" }) => {\n      if (token === \"invisible-token\" && phase === \"invisible\") {\n        return { requiresChallenge: true };\n      }\n      return { requiresChallenge: false };\n    });\n\n    await expect(withBotChallengeFlow({\n      visibleSiteKey: \"visible-site-key\",\n      invisibleSiteKey: \"invisible-site-key\",\n      action: \"sign_up_with_credential\",\n      execute,\n      isChallengeRequired: (result) => result.requiresChallenge,\n    })).rejects.toBeInstanceOf(BotChallengeExecutionFailedError);\n\n    expect(execute).toHaveBeenCalledTimes(1);\n    expect(execute).toHaveBeenCalledWith({\n      token: \"invisible-token\",\n      phase: \"invisible\",\n    });\n    expect(captureErrorMock).toHaveBeenCalledWith(\n      \"turnstile-flow-visible-challenge-failed\",\n      expect.any(Error),\n    );\n  });\n\n  it(\"marks the challenge as unavailable when both phase-1 challenge attempts fail\", async () => {\n    const { withBotChallengeFlow } = await import(\"./turnstile-flow\");\n\n    loadTurnstileScriptMock\n      .mockRejectedValueOnce(new Error(\"invisible unavailable\"))\n      .mockRejectedValueOnce(new Error(\"visible unavailable\"));\n\n    const execute = vi.fn(async ({ unavailable }: { unavailable?: true }) => ({\n      unavailable,\n    }));\n\n    await expect(withBotChallengeFlow({\n      visibleSiteKey: \"visible-site-key\",\n      invisibleSiteKey: \"invisible-site-key\",\n      action: \"sign_up_with_credential\",\n      execute,\n      isChallengeRequired: () => false,\n    })).resolves.toEqual({ unavailable: true });\n\n    expect(execute).toHaveBeenCalledTimes(1);\n    expect(execute).toHaveBeenCalledWith({ unavailable: true });\n    expect(captureErrorMock).toHaveBeenCalledWith(\n      \"turnstile-flow-all-challenges-failed\",\n      expect.any(Error),\n    );\n  });\n});\n"],"mappings":";;;;AAIA,MAAM,0BAA0B,GAAG,SAAS,QAAQ,SAAS,CAAC;AAC9D,MAAM,aAAa,GAAG,IAAI;AAC1B,MAAM,cAAc,GAAG,IAAI;AAC3B,MAAM,aAAa,GAAG,IAAI;AAC1B,MAAM,mBAAmB,GAAG,IAAI;AAEhC,GAAG,KAAK,8BAA8B;CACpC,qBAAqB;CACrB,wBAAwB;EACtB,QAAQ;EACR,SAAS;EACT,QAAQ;EACT;CACF,EAAE;AAEH,GAAG,KAAK,YAAY,YAAY;AAE9B,QAAO;EACL,GAFa,MAAM,GAAG,aAAwC,WAAW;EAGzE,cAAc;EACf;EACD;AAEF,SAAS,8BAA8B;AACrC,kBAAiB;AACf,KAAG,eAAe;AAClB,0BAAwB,kBAAkB,OAAU;AACpD,aAAW,oBAAoB,YAAY,WAErC;AACJ,UAAO,SAAS,kBAAkB;AAClC,UAAO;IACP;AACF,cAAY,yBAAyB,GAAG;AACxC,aAAW,yBAAyB,GAAG;GACvC;AAEF,IAAG,mFAAmF,YAAY;EAChG,MAAM,EAAE,kCAAkC,yBAAyB,MAAM,OAAO;AAEhF,0BACG,sBAAsB,OAAU,CAChC,sCAAsB,IAAI,MAAM,yBAAyB,CAAC;EAE7D,MAAM,UAAU,GAAG,GAAG,OAAO,EAAE,OAAO,YAAiE;AACrG,OAAI,UAAU,qBAAqB,UAAU,YAC3C,QAAO,EAAE,mBAAmB,MAAM;AAEpC,UAAO,EAAE,mBAAmB,OAAO;IACnC;AAEF,QAAM,OAAO,qBAAqB;GAChC,gBAAgB;GAChB,kBAAkB;GAClB,QAAQ;GACR;GACA,sBAAsB,WAAW,OAAO;GACzC,CAAC,CAAC,CAAC,QAAQ,eAAe,iCAAiC;AAE5D,SAAO,QAAQ,CAAC,sBAAsB,EAAE;AACxC,SAAO,QAAQ,CAAC,qBAAqB;GACnC,OAAO;GACP,OAAO;GACR,CAAC;AACF,SAAO,iBAAiB,CAAC,qBACvB,2CACA,OAAO,IAAI,MAAM,CAClB;GACD;AAEF,IAAG,gFAAgF,YAAY;EAC7F,MAAM,EAAE,yBAAyB,MAAM,OAAO;AAE9C,0BACG,sCAAsB,IAAI,MAAM,wBAAwB,CAAC,CACzD,sCAAsB,IAAI,MAAM,sBAAsB,CAAC;EAE1D,MAAM,UAAU,GAAG,GAAG,OAAO,EAAE,mBAA2C,EACxE,aACD,EAAE;AAEH,QAAM,OAAO,qBAAqB;GAChC,gBAAgB;GAChB,kBAAkB;GAClB,QAAQ;GACR;GACA,2BAA2B;GAC5B,CAAC,CAAC,CAAC,SAAS,QAAQ,EAAE,aAAa,MAAM,CAAC;AAE3C,SAAO,QAAQ,CAAC,sBAAsB,EAAE;AACxC,SAAO,QAAQ,CAAC,qBAAqB,EAAE,aAAa,MAAM,CAAC;AAC3D,SAAO,iBAAiB,CAAC,qBACvB,wCACA,OAAO,IAAI,MAAM,CAClB;GACD;EACF"}

package/dist/esm/utils/turnstile.d.ts

@@ -0,0 +1,17 @@
+//#region src/utils/turnstile.d.ts
+declare const turnstileActionValues: readonly ["sign_up_with_credential", "send_magic_link_email", "oauth_authenticate"];
+type TurnstileAction = typeof turnstileActionValues[number];
+declare const turnstilePhaseValues: readonly ["invisible", "visible"];
+type TurnstilePhase = typeof turnstilePhaseValues[number];
+declare const turnstileResultValues: readonly ["ok", "invalid", "error"];
+type TurnstileResult = typeof turnstileResultValues[number];
+declare const turnstileDevelopmentKeys: {
+  readonly visibleSiteKey: "1x00000000000000000000AA";
+  readonly invisibleSiteKey: "1x00000000000000000000BB";
+  readonly secretKey: "1x0000000000000000000000000000000AA";
+  readonly forcedChallengeSiteKey: "3x00000000000000000000FF";
+};
+declare function isTurnstileResult(value: unknown): value is TurnstileResult;
+//#endregion
+export { TurnstileAction, TurnstilePhase, TurnstileResult, isTurnstileResult, turnstileActionValues, turnstileDevelopmentKeys, turnstilePhaseValues, turnstileResultValues };
+//# sourceMappingURL=turnstile.d.ts.map

package/dist/esm/utils/turnstile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnstile.d.ts","names":[],"sources":["../../../src/utils/turnstile.ts"],"mappings":";cAAa,qBAAA;AAAA,KAMD,eAAA,UAAyB,qBAAA;AAAA,cAExB,oBAAA;AAAA,KAKD,cAAA,UAAwB,oBAAA;AAAA,cAEvB,qBAAA;AAAA,KAMD,eAAA,UAAyB,qBAAA;AAAA,cAExB,wBAAA;EAAA;;;;;iBAQG,iBAAA,CAAkB,KAAA,YAAiB,KAAA,IAAS,eAAA"}

package/dist/esm/utils/turnstile.js

@@ -0,0 +1,25 @@
+//#region src/utils/turnstile.ts
+const turnstileActionValues = [
+	"sign_up_with_credential",
+	"send_magic_link_email",
+	"oauth_authenticate"
+];
+const turnstilePhaseValues = ["invisible", "visible"];
+const turnstileResultValues = [
+	"ok",
+	"invalid",
+	"error"
+];
+const turnstileDevelopmentKeys = {
+	visibleSiteKey: "1x00000000000000000000AA",
+	invisibleSiteKey: "1x00000000000000000000BB",
+	secretKey: "1x0000000000000000000000000000000AA",
+	forcedChallengeSiteKey: "3x00000000000000000000FF"
+};
+function isTurnstileResult(value) {
+	return typeof value === "string" && turnstileResultValues.some((status) => status === value);
+}
+
+//#endregion
+export { isTurnstileResult, turnstileActionValues, turnstileDevelopmentKeys, turnstilePhaseValues, turnstileResultValues };
+//# sourceMappingURL=turnstile.js.map

package/dist/esm/utils/turnstile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnstile.js","names":[],"sources":["../../../src/utils/turnstile.ts"],"sourcesContent":["export const turnstileActionValues = [\n  \"sign_up_with_credential\",\n  \"send_magic_link_email\",\n  \"oauth_authenticate\",\n] as const;\n\nexport type TurnstileAction = typeof turnstileActionValues[number];\n\nexport const turnstilePhaseValues = [\n  \"invisible\",\n  \"visible\",\n] as const;\n\nexport type TurnstilePhase = typeof turnstilePhaseValues[number];\n\nexport const turnstileResultValues = [\n  \"ok\",\n  \"invalid\",\n  \"error\",\n] as const;\n\nexport type TurnstileResult = typeof turnstileResultValues[number];\n\nexport const turnstileDevelopmentKeys = {\n  visibleSiteKey: \"1x00000000000000000000AA\",\n  invisibleSiteKey: \"1x00000000000000000000BB\",\n  secretKey: \"1x0000000000000000000000000000000AA\",\n  forcedChallengeSiteKey: \"3x00000000000000000000FF\",\n} as const;\n\n\nexport function isTurnstileResult(value: unknown): value is TurnstileResult {\n  return typeof value === \"string\" && turnstileResultValues.some((status) => status === value);\n}\n"],"mappings":";AAAA,MAAa,wBAAwB;CACnC;CACA;CACA;CACD;AAID,MAAa,uBAAuB,CAClC,aACA,UACD;AAID,MAAa,wBAAwB;CACnC;CACA;CACA;CACD;AAID,MAAa,2BAA2B;CACtC,gBAAgB;CAChB,kBAAkB;CAClB,WAAW;CACX,wBAAwB;CACzB;AAGD,SAAgB,kBAAkB,OAA0C;AAC1E,QAAO,OAAO,UAAU,YAAY,sBAAsB,MAAM,WAAW,WAAW,MAAM"}

package/dist/esm/utils/typed-arrays.d.ts

@@ -0,0 +1,14 @@
+//#region src/utils/typed-arrays.d.ts
+/**
+ * Ensures a Uint8Array is backed by a regular ArrayBuffer (not SharedArrayBuffer).
+ *
+ * TypeScript 5.7+ made typed arrays generic over their buffer type. Bare `Uint8Array`
+ * defaults to `Uint8Array<ArrayBufferLike>`, which includes SharedArrayBuffer. Web Crypto
+ * APIs require `BufferSource` which only accepts `ArrayBufferView<ArrayBuffer>`. This
+ * function narrows the type using an instanceof guard, creating a same-buffer view
+ * (zero-copy) when the buffer is already an ArrayBuffer.
+ */
+declare function toArrayBufferBacked(arr: Uint8Array): Uint8Array<ArrayBuffer>;
+//#endregion
+export { toArrayBufferBacked };
+//# sourceMappingURL=typed-arrays.d.ts.map

package/dist/esm/utils/typed-arrays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-arrays.d.ts","names":[],"sources":["../../../src/utils/typed-arrays.tsx"],"mappings":";;AAWA;;;;;;;;iBAAgB,mBAAA,CAAoB,GAAA,EAAK,UAAA,GAAa,UAAA,CAAW,WAAA"}

package/dist/esm/utils/typed-arrays.js

@@ -0,0 +1,20 @@
+import { HexclaveAssertionError } from "./errors.js";
+
+//#region src/utils/typed-arrays.tsx
+/**
+* Ensures a Uint8Array is backed by a regular ArrayBuffer (not SharedArrayBuffer).
+*
+* TypeScript 5.7+ made typed arrays generic over their buffer type. Bare `Uint8Array`
+* defaults to `Uint8Array<ArrayBufferLike>`, which includes SharedArrayBuffer. Web Crypto
+* APIs require `BufferSource` which only accepts `ArrayBufferView<ArrayBuffer>`. This
+* function narrows the type using an instanceof guard, creating a same-buffer view
+* (zero-copy) when the buffer is already an ArrayBuffer.
+*/
+function toArrayBufferBacked(arr) {
+	if (arr.buffer instanceof SharedArrayBuffer) throw new HexclaveAssertionError("SharedArrayBuffer-backed Uint8Arrays are not supported in this context");
+	return new Uint8Array(arr.buffer, arr.byteOffset, arr.byteLength);
+}
+
+//#endregion
+export { toArrayBufferBacked };
+//# sourceMappingURL=typed-arrays.js.map

package/dist/esm/utils/typed-arrays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-arrays.js","names":[],"sources":["../../../src/utils/typed-arrays.tsx"],"sourcesContent":["import { HexclaveAssertionError } from \"./errors\";\n\n/**\n * Ensures a Uint8Array is backed by a regular ArrayBuffer (not SharedArrayBuffer).\n *\n * TypeScript 5.7+ made typed arrays generic over their buffer type. Bare `Uint8Array`\n * defaults to `Uint8Array<ArrayBufferLike>`, which includes SharedArrayBuffer. Web Crypto\n * APIs require `BufferSource` which only accepts `ArrayBufferView<ArrayBuffer>`. This\n * function narrows the type using an instanceof guard, creating a same-buffer view\n * (zero-copy) when the buffer is already an ArrayBuffer.\n */\nexport function toArrayBufferBacked(arr: Uint8Array): Uint8Array<ArrayBuffer> {\n  if (arr.buffer instanceof SharedArrayBuffer) {\n    throw new HexclaveAssertionError(\"SharedArrayBuffer-backed Uint8Arrays are not supported in this context\");\n  }\n  return new Uint8Array(arr.buffer, arr.byteOffset, arr.byteLength);\n}\n"],"mappings":";;;;;;;;;;;;AAWA,SAAgB,oBAAoB,KAA0C;AAC5E,KAAI,IAAI,kBAAkB,kBACxB,OAAM,IAAI,uBAAuB,yEAAyE;AAE5G,QAAO,IAAI,WAAW,IAAI,QAAQ,IAAI,YAAY,IAAI,WAAW"}

package/dist/esm/utils/types.d.ts

@@ -0,0 +1,77 @@
+import { Join } from "./strings";
+
+//#region src/utils/types.d.ts
+type IsAny<T> = 0 extends (1 & T) ? true : false;
+type IsNever<T> = [T] extends [never] ? true : false;
+type IsNullish<T> = [T] extends [null | undefined] ? true : false;
+type IsUnion<T, U = T> = IsNever<T> extends true ? false : IsAny<T> extends true ? false : T extends U ? ([U] extends [T] ? false : true) : never;
+type NullishCoalesce<T, U> = T extends null | undefined ? U : T;
+type LastUnionElement<U> = UnionToIntersection<U extends any ? (x: U) => 0 : never> extends ((x: infer L) => 0) ? L & U : never;
+type primitive = string | number | boolean | bigint | symbol | null | undefined;
+/**
+ * Makes a type prettier by recursively expanding all object types. For example, `Omit<{ a: 1 }, "a">` becomes just `{}`.
+ */
+type Expand<T> = T extends ((...args: infer A) => infer R) ? ((...args: A) => R) extends T ? (...args: Expand<A>) => Expand<R> : ((...args: Expand<A>) => Expand<R>) & { [K in keyof T]: Expand<T[K]> } : T extends object ? T extends primitive ? T : T extends infer O ? { [K in keyof O]: Expand<O[K]> } : never : T;
+/**
+ * Removes all optional undefined/never keys from an object.
+ */
+type DeepRemoveOptionalUndefined<T> = T extends object ? { [K in keyof T]: DeepRemoveOptionalUndefined<T[K]> } : T;
+type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends ((x: infer I) => void) ? I : never;
+type _UnionToTupleInner<U, R extends any[], Last> = UnionToTuple<Exclude<U, Last>, [...R, Last]>;
+type UnionToTuple<U, R extends any[] = []> = [U] extends [never] ? R : _UnionToTupleInner<U, R, LastUnionElement<U>>;
+type CollapseObjectUnion<T extends object> = { [K in AllUnionKeys<T>]?: T extends Record<K, infer V> ? V : never };
+type IntersectAll<T extends any[]> = UnionToIntersection<T[number]>;
+type OptionalKeys<T> = { [K in keyof T]: {} extends Pick<T, K> ? K : never }[keyof T];
+type RequiredKeys<T> = { [K in keyof T]: {} extends Pick<T, K> ? never : K }[keyof T];
+/**
+ * Returns a type whose keys are the intersection of the keys of T and U, deeply.
+ */
+type KeyIntersect<T, U> = { [K in keyof T & keyof U]?: T[K] & U[K] } & { [K in RequiredKeys<T> & keyof U]: T[K] & U[K] } & { [K in RequiredKeys<U> & keyof T]: U[K] & T[K] };
+/**
+ * Returns ALL keys of all union elements.
+ */
+type AllUnionKeys<T extends object> = T extends T ? keyof T : never;
+type SubtractType<T, U> = T extends object ? { [K in keyof T]: K extends keyof U ? SubtractType<T[K], U[K]> : T[K] } : (T extends U ? never : T);
+type XOR<T extends readonly any[]> = T extends readonly [infer A, infer B, ...infer Rest] ? Rest extends [] ? (A & { [K in keyof B]?: never }) | (B & { [K in keyof A]?: never }) : XOR<[(A & { [K in keyof B]?: never }) | (B & { [K in keyof A]?: never }), ...Rest]> : T[0];
+type _AntiIntersectInner<T, U> = T extends object ? (Omit<U, keyof T> & { [K in keyof Pick<U, { [K in keyof T & keyof U]: U[K] extends T[K] ? (T[K] extends U[K] ? never : K) : never }[keyof T & keyof U]>]: PseudoAntiIntersect<T[K], U[K]> } & { [K in keyof Pick<U, keyof T & keyof U>]?: PseudoAntiIntersect<T[K], U[K]> }) : U;
+/**
+ * Returns a type R such that T & R = U.
+ */
+type AntiIntersect<T, U> = U extends T ? _AntiIntersectInner<T, U> : "Cannot anti-intersect a type with a type that is not a subtype of it";
+type PseudoAntiIntersect<T, U> = _AntiIntersectInner<T, T & U>;
+/**
+ * A variation of TypeScript's conditionals with slightly different semantics. It is the perfect type for cases where:
+ *
+ * - If all possible values are contained in `Extends`, then it will be mapped to `Then`.
+ * - If all possible values are not contained in `Extends`, then it will be mapped to `Otherwise`.
+ * - If some possible values are contained in `Extends` and some are not, then it will be mapped to `Then | Otherwise`.
+ *
+ * This is different from TypeScript's built-in conditional types (`Value extends Extends ? Then : Otherwise`), which
+ * returns `Otherwise` for the third case (causing unsoundness in many real-world cases).
+ */
+type IfAndOnlyIf<Value, Extends, Then, Otherwise> = (Value extends Extends ? never : Otherwise) | (Value & Extends extends never ? never : Then);
+/**
+ * Can be used to prettify a type in the IDE; for example, some complicated intersected types can be flattened into a single type.
+ */
+type PrettifyType<T> = T extends object ? { [K in keyof T]: T[K] } & {} : T;
+type _ToStringAndJoin<T extends any[], Separator extends string> = T extends [infer U, ...infer Rest extends any[]] ? `${TypeToString<U>}${Rest extends [any, ...any[]] ? `${Separator}${_ToStringAndJoin<Rest, Separator>}` : ""}` : "<error-joining-tuple-elements>";
+type _TypeToStringInner<T> = IsAny<T> extends true ? "any" : IsNever<T> extends true ? "never" : IsUnion<T> extends true ? _ToStringAndJoin<UnionToTuple<T>, " | "> : [T] extends [number] ? (number extends T ? "number" : `${T}`) : [T] extends [boolean] ? `${T}` : [T] extends [undefined] ? "undefined" : [T] extends [null] ? "null" : [T] extends [string] ? (string extends T ? "string" : `'${T}'`) : [T] extends [[]] ? "[]" : [T] extends [[any, ...any[]]] ? `[${_ToStringAndJoin<T, ", ">}]` : [T] extends [(infer E)[]] ? `${TypeToString<E>}[]` : [T] extends [Function] ? "function" : [T] extends [symbol] ? `symbol(${T['description']})` : [T] extends [object] ? `{ ${Join<UnionToTuple<{ [K in keyof T]: `${TypeToString<K>}: ${TypeToString<T[K]>}` }[keyof T]>, ", ">} }` : "<unknown-type>";
+type TypeToString<T> = _TypeToStringInner<T> extends `${infer S}` ? S : never;
+/**
+ * Can be used to create assertions on types. For example, if passed any T other than `true`, the following will
+ * show a type error:
+ *
+ * ```ts
+ * typeAssert<T>()();  // the second pair of braces is important!
+ * ```
+ */
+declare function typeAssert<T>(): (IsAny<T> extends true ? TypeAssertionError<`Type assertion failed. Expected true, but got any.`> : IsNever<T> extends true ? TypeAssertionError<`Type assertion failed. Expected true, but got never.`> : T extends true ? (() => undefined) : TypeAssertionError<`Type assertion failed. Expected true, but got: ${TypeToString<T>}`>);
+type TypeAssertionError<T> = [T] & /* this promise makes sure that if we accidentally forget the second pair of braces, eslint will complain (if we have no-floating-promises enabled) */Promise<any>;
+/**
+ * Functionally equivalent to `typeAssert<T extends S ? true : false>()()`, but with better error messages.
+ */
+declare function typeAssertExtends<T, S>(): ([T] extends [S] ? (() => undefined) : TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to extend ${TypeToString<S>}`>);
+declare function typeAssertIs<T, U>(): (IsAny<T> extends true ? (IsAny<U> extends true ? (() => undefined) : TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to be ${TypeToString<U>}`>) : IsAny<U> extends true ? TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to be ${TypeToString<U>}`> : [T] extends [U] ? ([U] extends [T] ? (() => undefined) : TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to be ${TypeToString<U>}`>) : TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to be ${TypeToString<U>}`>);
+//#endregion
+export { AllUnionKeys, AntiIntersect, CollapseObjectUnion, DeepRemoveOptionalUndefined, Expand, IfAndOnlyIf, IntersectAll, IsAny, IsNever, IsNullish, IsUnion, KeyIntersect, LastUnionElement, NullishCoalesce, OptionalKeys, PrettifyType, PseudoAntiIntersect, RequiredKeys, SubtractType, TypeToString, UnionToIntersection, UnionToTuple, XOR, typeAssert, typeAssertExtends, typeAssertIs };
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/utils/types.d.ts.map

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

package/dist/esm/utils/types.js

@@ -0,0 +1,55 @@
+//#region src/utils/types.tsx
+typeAssertIs()();
+typeAssertIs()();
+typeAssertIs()();
+/**
+* Can be used to create assertions on types. For example, if passed any T other than `true`, the following will
+* show a type error:
+*
+* ```ts
+* typeAssert<T>()();  // the second pair of braces is important!
+* ```
+*/
+function typeAssert() {
+	return (() => void 0);
+}
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+/**
+* Functionally equivalent to `typeAssert<T extends S ? true : false>()()`, but with better error messages.
+*/
+function typeAssertExtends() {
+	return (() => void 0);
+}
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+function typeAssertIs() {
+	return (() => void 0);
+}
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+typeAssertExtends()();
+
+//#endregion
+export { typeAssert, typeAssertExtends, typeAssertIs };
+//# sourceMappingURL=types.js.map

package/dist/esm/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/utils/types.tsx"],"sourcesContent":["import { DeepPartial } from \"./objects\";\nimport { Join } from \"./strings\";\n\nexport type IsAny<T> = 0 extends (1 & T) ? true : false;\nexport type IsNever<T> = [T] extends [never] ? true : false;\nexport type IsNullish<T> = [T] extends [null | undefined] ? true : false;\nexport type IsUnion<T, U = T> =\n  IsNever<T> extends true ? false\n  : IsAny<T> extends true ? false\n    : T extends U // distributive conditional https://www.typescriptlang.org/docs/handbook/2/conditional-types.html#distributive-conditional-types\n        ? /* if the *whole* original type (`U`) still fits inside the current variant, then `T` wasn’t a union */ ([U] extends [T] ? false : true)\n        : never;\n\nexport type NullishCoalesce<T, U> = T extends null | undefined ? U : T;\n\nexport type LastUnionElement<U> = UnionToIntersection<U extends any ? (x: U) => 0 : never> extends (x: infer L) => 0 ? L & U : never;\n\ntype primitive = string | number | boolean | bigint | symbol | null | undefined;\n\n/**\n * Makes a type prettier by recursively expanding all object types. For example, `Omit<{ a: 1 }, \"a\">` becomes just `{}`.\n */\nexport type Expand<T> = T extends (...args: infer A) => infer R\n  ? ((...args: A) => R) extends T\n    ? (...args: Expand<A>) => Expand<R>\n    : ((...args: Expand<A>) => Expand<R>) & { [K in keyof T]: Expand<T[K]> }\n  : T extends object\n    ? T extends primitive\n      ? T\n      : T extends infer O\n        ? { [K in keyof O]: Expand<O[K]> }\n        : never\n    : T;\n\n\n/**\n * Removes all optional undefined/never keys from an object.\n */\nexport type DeepRemoveOptionalUndefined<T> = T extends object ? { [K in keyof T]: DeepRemoveOptionalUndefined<T[K]> } : T;\n\n// why this works: https://stackoverflow.com/a/50375286\nexport type UnionToIntersection<U> =\n  (U extends any ? (x: U) => void : never) extends ((x: infer I) => void) ? I : never\n\ntype _UnionToTupleInner<U, R extends any[], Last> = UnionToTuple<Exclude<U, Last>, [...R, Last]>\nexport type UnionToTuple<U, R extends any[] = []> = [U] extends [never] ? R : _UnionToTupleInner<U, R, LastUnionElement<U>>;\n\nexport type CollapseObjectUnion<T extends object> = {\n  [K in AllUnionKeys<T>]?: T extends Record<K, infer V> ? V : never;\n};\ntypeAssertIs<CollapseObjectUnion<{ a: string } | { b: number }>, { a?: string, b?: number }>()();\ntypeAssertIs<CollapseObjectUnion<{ a: string } | { a: number }>, { a?: string | number }>()();\n\nexport type IntersectAll<T extends any[]> = UnionToIntersection<T[number]>;\n\nexport type OptionalKeys<T> = {\n  [K in keyof T]: {} extends Pick<T, K> ? K : never;\n}[keyof T];\nexport type RequiredKeys<T> = {\n  [K in keyof T]: {} extends Pick<T, K> ? never : K;\n}[keyof T];\n\n/**\n * Returns a type whose keys are the intersection of the keys of T and U, deeply.\n */\nexport type KeyIntersect<T, U> =\n  & { [K in keyof T & keyof U]?: T[K] & U[K] }\n  & { [K in RequiredKeys<T> & keyof U]: T[K] & U[K] }\n  & { [K in RequiredKeys<U> & keyof T]: U[K] & T[K] }\n\n/**\n * Returns ALL keys of all union elements.\n */\nexport type AllUnionKeys<T extends object> = T extends T ? keyof T : never;\ntypeAssertIs<AllUnionKeys<{ a: string } | { b: number }>, \"a\" | \"b\">()();\n\nexport type SubtractType<T, U> = T extends object ? { [K in keyof T]: K extends keyof U ? SubtractType<T[K], U[K]> : T[K] } : (T extends U ? never : T); // note: this only works due to the distributive property of conditional types https://www.typescriptlang.org/docs/handbook/2/conditional-types.html#distributive-conditional-types\n\nexport type XOR<T extends readonly any[]> = T extends readonly [infer A, infer B, ...infer Rest]\n  ? Rest extends []\n  ? (A & { [K in keyof B]?: never }) | (B & { [K in keyof A]?: never })\n  : XOR<[(A & { [K in keyof B]?: never }) | (B & { [K in keyof A]?: never }), ...Rest]>\n  : T[0];\n\n\ntype _AntiIntersectInner<T, U> = T extends object ? (\n  & Omit<U, keyof T>\n  & { [K in keyof Pick<U, { [K in keyof T & keyof U]: U[K] extends T[K] ? (T[K] extends U[K] ? never : K) : never }[keyof T & keyof U]>]: PseudoAntiIntersect<T[K], U[K]> }\n  & { [K in keyof Pick<U, keyof T & keyof U>]?: PseudoAntiIntersect<T[K], U[K]> }\n) : U;\n/**\n * Returns a type R such that T & R = U.\n */\nexport type AntiIntersect<T, U> = U extends T ? _AntiIntersectInner<T, U> : \"Cannot anti-intersect a type with a type that is not a subtype of it\"; // NOTE: This type is mostly untested — not sure how well it works on the edge cases\nexport type PseudoAntiIntersect<T, U> = _AntiIntersectInner<T, T & U>;\n\n/**\n * A variation of TypeScript's conditionals with slightly different semantics. It is the perfect type for cases where:\n *\n * - If all possible values are contained in `Extends`, then it will be mapped to `Then`.\n * - If all possible values are not contained in `Extends`, then it will be mapped to `Otherwise`.\n * - If some possible values are contained in `Extends` and some are not, then it will be mapped to `Then | Otherwise`.\n *\n * This is different from TypeScript's built-in conditional types (`Value extends Extends ? Then : Otherwise`), which\n * returns `Otherwise` for the third case (causing unsoundness in many real-world cases).\n */\nexport type IfAndOnlyIf<Value, Extends, Then, Otherwise> =\n  | (Value extends Extends ? never : Otherwise)\n  | (Value & Extends extends never ? never : Then);\n\n\n/**\n * Can be used to prettify a type in the IDE; for example, some complicated intersected types can be flattened into a single type.\n */\nexport type PrettifyType<T> = T extends object ? { [K in keyof T]: T[K] } & {} : T;\n\ntype _ToStringAndJoin<T extends any[], Separator extends string> =\n  T extends [infer U, ...infer Rest extends any[]]\n    ? `${TypeToString<U>}${Rest extends [any, ...any[]] ? `${Separator}${_ToStringAndJoin<Rest, Separator>}` : \"\"}`\n    : \"<error-joining-tuple-elements>\";\ntype _TypeToStringInner<T> =\n  IsAny<T> extends true ? \"any\"\n  : IsNever<T> extends true ? \"never\"\n  : IsUnion<T> extends true ? _ToStringAndJoin<UnionToTuple<T>, \" | \">\n  : [T] extends [number] ? (number extends T ? \"number\" : `${T}`)\n  : [T] extends [boolean] ? `${T}`\n  : [T] extends [undefined] ? \"undefined\"\n  : [T] extends [null] ? \"null\"\n  : [T] extends [string] ? (string extends T ? \"string\" : `'${T}'`)\n  : [T] extends [[]] ? \"[]\"\n  : [T] extends [[any, ...any[]]] ? `[${_ToStringAndJoin<T, \", \">}]`\n  : [T] extends [(infer E)[]] ? `${TypeToString<E>}[]`\n  : [T] extends [Function] ? \"function\"\n  : [T] extends [symbol] ? `symbol(${T['description']})`\n  : [T] extends [object] ? `{ ${Join<UnionToTuple<{ [K in keyof T]: `${TypeToString<K>}: ${TypeToString<T[K]>}` }[keyof T]>, \", \">} }`\n  : \"<unknown-type>\"\nexport type TypeToString<T> = _TypeToStringInner<T> extends `${infer S}` ? S : never;\n\n/**\n * Can be used to create assertions on types. For example, if passed any T other than `true`, the following will\n * show a type error:\n *\n * ```ts\n * typeAssert<T>()();  // the second pair of braces is important!\n * ```\n */\nexport function typeAssert<T>(): (\n  IsAny<T> extends true ? TypeAssertionError<`Type assertion failed. Expected true, but got any.`>\n    : IsNever<T> extends true ? TypeAssertionError<`Type assertion failed. Expected true, but got never.`>\n    : T extends true ? (() => undefined)\n    : TypeAssertionError<`Type assertion failed. Expected true, but got: ${TypeToString<T>}`>\n) {\n  return (() => undefined) as any;\n}\ntype TypeAssertionError<T> =\n  & [T]\n  & /* this promise makes sure that if we accidentally forget the second pair of braces, eslint will complain (if we have no-floating-promises enabled) */ Promise<any>;\n\n\ntypeAssertExtends<ReturnType<typeof typeAssert<true>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssert<false>>, TypeAssertionError<`Type assertion failed. Expected true, but got: false`>>()();\ntypeAssertExtends<ReturnType<typeof typeAssert<never>>, TypeAssertionError<`Type assertion failed. Expected true, but got never.`>>()();\ntypeAssertExtends<ReturnType<typeof typeAssert<any>>, TypeAssertionError<`Type assertion failed. Expected true, but got any.`>>()();\n\n/**\n * Functionally equivalent to `typeAssert<T extends S ? true : false>()()`, but with better error messages.\n */\nexport function typeAssertExtends<T, S>(): (\n  [T] extends [S] ? (() => undefined) : TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to extend ${TypeToString<S>}`>\n) {\n  return (() => undefined) as any;\n}\n\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<never, true>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<any, true>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<false, false>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<\"abc\", string>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<{a: 1, b: 123}, {a: number}>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<never, never>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<true, any>>, () => undefined>()();\n\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<{a: number}, {a: 1}>>, [\"Type assertion failed. Expected { 'a': number } to extend { 'a': 1 }\"]>()();\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<any, never>>, [\"Type assertion failed. Expected any to extend never\"]>()();\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<false, true>>, [\"Type assertion failed. Expected false to extend true\"]>()();\ntypeAssertExtends<ReturnType<typeof typeAssertExtends<false, never>>, [\"Type assertion failed. Expected false to extend never\"]>()();\n\n\nexport function typeAssertIs<T, U>(): (\n  IsAny<T> extends true ? (IsAny<U> extends true ? (() => undefined) : TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to be ${TypeToString<U>}`>)\n    : IsAny<U> extends true ? TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to be ${TypeToString<U>}`>\n    : [T] extends [U] ? ([U] extends [T] ? (() => undefined) : TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to be ${TypeToString<U>}`>)\n    : TypeAssertionError<`Type assertion failed. Expected ${TypeToString<T>} to be ${TypeToString<U>}`>\n) {\n  return (() => undefined) as any;\n}\n\ntypeAssertExtends<ReturnType<typeof typeAssertIs<\"123\", \"123\">>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<{a: 1}, {a: 1}>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<DeepPartial<{a: 1}>, {a?: 1}>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<any, any>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<never, never>>, () => undefined>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<1, any>>, [\"Type assertion failed. Expected 1 to be any\"]>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<any, 1>>, [\"Type assertion failed. Expected any to be 1\"]>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<false, true>>, [\"Type assertion failed. Expected false to be true\"]>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<{a: number}, {a: 1}>>, [\"Type assertion failed. Expected { 'a': number } to be { 'a': 1 }\"]>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<any, never>>, [\"Type assertion failed. Expected any to be never\"]>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<false, true>>, [\"Type assertion failed. Expected false to be true\"]>()();\ntypeAssertExtends<ReturnType<typeof typeAssertIs<false, never>>, [\"Type assertion failed. Expected false to be never\"]>()();\n"],"mappings":";AAkDA,cAA8F,EAAE;AAChG,cAA2F,EAAE;AAuB7F,cAAsE,EAAE;;;;;;;;;AAwExE,SAAgB,aAKd;AACA,eAAc;;AAOhB,mBAAyE,EAAE;AAC3E,mBAAqI,EAAE;AACvI,mBAAqI,EAAE;AACvI,mBAAiI,EAAE;;;;AAKnI,SAAgB,oBAEd;AACA,eAAc;;AAGhB,mBAAuF,EAAE;AACzF,mBAAqF,EAAE;AACvF,mBAAwF,EAAE;AAC1F,mBAAyF,EAAE;AAC3F,mBAAuG,EAAE;AACzG,mBAAwF,EAAE;AAC1F,mBAAqF,EAAE;AAEvF,mBAAwJ,EAAE;AAC1J,mBAA8H,EAAE;AAChI,mBAAgI,EAAE;AAClI,mBAAkI,EAAE;AAGpI,SAAgB,eAKd;AACA,eAAc;;AAGhB,mBAAmF,EAAE;AACrF,mBAAqF,EAAE;AACvF,mBAAmG,EAAE;AACrG,mBAA+E,EAAE;AACjF,mBAAmF,EAAE;AACrF,mBAA6G,EAAE;AAC/G,mBAA6G,EAAE;AAC/G,mBAAuH,EAAE;AACzH,mBAA+I,EAAE;AACjJ,mBAAqH,EAAE;AACvH,mBAAuH,EAAE;AACzH,mBAAyH,EAAE"}

package/dist/esm/utils/unicode.d.ts

@@ -0,0 +1,5 @@
+//#region src/utils/unicode.d.ts
+declare function getFlagEmoji(twoLetterCountryCode: string): string;
+//#endregion
+export { getFlagEmoji };
+//# sourceMappingURL=unicode.d.ts.map

package/dist/esm/utils/unicode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode.d.ts","names":[],"sources":["../../../src/utils/unicode.tsx"],"mappings":";iBAGgB,YAAA,CAAa,oBAAA"}