@hexclave/next 1.0.75 → 1.0.77

package/dist/{quetzal-translations-XeH3zQ9l.d.ts.map → quetzal-translations-B2jT2SWm.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"quetzal-translations-XeH3zQ9l.d.ts","names":[],"sources":["../src/generated/quetzal-translations.ts"],"mappings":";cAUa,WAAA,EAAW,GAAA;AAAA,cAqTX,cAAA,EAAc,GAAA,mIAAA,GAAA,66qBAAA,GAAA,usnBAAA,GAAA,iyrBAAA,GAAA,g+qBAAA,GAAA,8srBAAA,GAAA,2trBAAA,GAAA,41pBAAA,GAAA,m3eAAA,GAAA,oreAAA,GAAA,swpBAAA,GAAA,+0qBAAA,GAAA,8wbAAA,GAAA"}
+{"version":3,"file":"quetzal-translations-B2jT2SWm.d.ts","names":[],"sources":["../src/generated/quetzal-translations.ts"],"mappings":";cAUa,WAAA,EAAW,GAAA;AAAA,cAqTX,cAAA,EAAc,GAAA,mIAAA,GAAA,66qBAAA,GAAA,usnBAAA,GAAA,iyrBAAA,GAAA,g+qBAAA,GAAA,8srBAAA,GAAA,2trBAAA,GAAA,41pBAAA,GAAA,m3eAAA,GAAA,oreAAA,GAAA,swpBAAA,GAAA,+0qBAAA,GAAA,8wbAAA,GAAA"}

package/dist/setup-error-overlay/index.d.ts

@@ -0,0 +1,16 @@
+//#region src/setup-error-overlay/index.d.ts
+/** Exported so tests can drop the singleton; every other consumer should go through `showSetupErrorOverlay`. */
+declare const SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY = "__hexclave-setup-error-overlay";
+/**
+ * Shows `error` as an error card on the current page.
+ *
+ * Setup errors are always shown, because the flow they aborted cannot complete no matter what the end user does, and
+ * their messages are written for exactly this purpose. Any other error is only shown while developing — those messages
+ * are internal diagnostics, so in production they stay in captureError's hands.
+ *
+ * Returns a cleanup function that removes the card again.
+ */
+declare function showSetupErrorOverlay(error: unknown): () => void;
+//#endregion
+export { SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY, showSetupErrorOverlay };
+//# sourceMappingURL=index.d.ts.map

package/dist/setup-error-overlay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/setup-error-overlay/index.ts"],"mappings":";;cAiBa,uCAAA;;;;AAAuC;AA8DpD;;;;AAAoD;iBAApC,qBAAA,CAAsB,KAAc"}

package/dist/setup-error-overlay/index.js

@@ -0,0 +1,108 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let ___in_page_ui_dom_js = require("../in-page-ui/dom.js");
+let _hexclave_shared_dist_utils_errors = require("@hexclave/shared/dist/utils/errors");
+let ___in_page_ui_dev_environment_js = require("../in-page-ui/dev-environment.js");
+let ___in_page_ui_issue_card_js = require("../in-page-ui/issue-card.js");
+//#region src/setup-error-overlay/index.ts
+/** Exported so tests can drop the singleton; every other consumer should go through `showSetupErrorOverlay`. */
+const SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY = "__hexclave-setup-error-overlay";
+const css = (0, ___in_page_ui_issue_card_js.getIssueCardCSS)(".hexclave-setup-error-overlay");
+const unexpectedErrorHowToFix = [
+	"Check the browser console and your Hexclave dashboard's logs for the full error.",
+	"Make sure your Hexclave SDK packages are up to date.",
+	"If the error looks like a bug in Hexclave, report it at https://github.com/hexclave/hexclave/issues."
+];
+function toSetupIssue(error) {
+	if (_hexclave_shared_dist_utils_errors.HexclaveSetupError.isSetupError(error)) return {
+		title: error.title,
+		message: error.message,
+		howToFix: error.howToFix,
+		isFatal: true
+	};
+	return {
+		title: "Hexclave could not finish an authentication flow",
+		message: (0, _hexclave_shared_dist_utils_errors.errorToNiceString)(error),
+		howToFix: unexpectedErrorHowToFix,
+		isFatal: false
+	};
+}
+function buildAiPrompt(issue) {
+	return [
+		"Help me fix this Hexclave setup error.",
+		"",
+		"Hexclave reminder:",
+		"This error was thrown by the Hexclave SDK in the browser while it was resolving an authentication flow, and the flow was aborted because of it. It is a problem with how my project is set up, not something my users can work around. Use your web fetch tool to read https://skill.hexclave.com to learn more about Hexclave.",
+		"",
+		"Error message:",
+		issue.message,
+		"",
+		"Hexclave suggests:",
+		...issue.howToFix.map((step) => `- ${step}`),
+		"",
+		"Please explain the likely cause and suggest the smallest safe fix."
+	].join("\n");
+}
+/**
+* Shows `error` as an error card on the current page.
+*
+* Setup errors are always shown, because the flow they aborted cannot complete no matter what the end user does, and
+* their messages are written for exactly this purpose. Any other error is only shown while developing — those messages
+* are internal diagnostics, so in production they stay in captureError's hands.
+*
+* Returns a cleanup function that removes the card again.
+*/
+function showSetupErrorOverlay(error) {
+	if (!(0, ___in_page_ui_dom_js.canMountIntoDom)()) return () => {};
+	if (!_hexclave_shared_dist_utils_errors.HexclaveSetupError.isSetupError(error) && !(0, ___in_page_ui_dev_environment_js.isLikelyDevelopmentEnvironment)()) return () => {};
+	const issue = toSetupIssue(error);
+	if ((0, ___in_page_ui_dom_js.getGlobalUiInstance)("__hexclave-setup-error-overlay") != null) return () => {};
+	const root = (0, ___in_page_ui_dom_js.h)("div", { className: "hexclave-setup-error-overlay" });
+	const style = (0, ___in_page_ui_dom_js.h)("style", null, css);
+	root.appendChild(style);
+	document.body.appendChild(root);
+	let focusTrap = null;
+	const render = (minimized) => {
+		focusTrap?.release();
+		focusTrap = null;
+		root.replaceChildren(style);
+		if (minimized) {
+			root.appendChild((0, ___in_page_ui_issue_card_js.renderIssuePill)({
+				kind: "error",
+				label: "Setup error",
+				ariaLabel: "Show Hexclave setup error",
+				onClick: () => render(false)
+			}));
+			return;
+		}
+		root.appendChild((0, ___in_page_ui_issue_card_js.renderIssueCard)({
+			kind: "error",
+			badge: "Setup error",
+			title: issue.title,
+			bodyText: issue.isFatal ? "Hexclave stopped the authentication flow that ran into this error, so nobody can sign in through it until it is fixed." : "Hexclave aborted the authentication flow that ran into this error. Errors like this one may also be transient, in which case retrying the flow works.",
+			messageLabel: "Error message",
+			message: issue.message,
+			howToFix: issue.howToFix,
+			footerText: issue.isFatal ? "This card is shown by the Hexclave SDK. Fix the problem above and reload the page to try the flow again." : "This card is shown by the Hexclave SDK while developing, and never in production.",
+			ariaLabel: "Hexclave setup error",
+			aiPrompt: buildAiPrompt(issue),
+			onCopyError: (copyError) => (0, _hexclave_shared_dist_utils_errors.captureError)("setup-error-overlay-copy", copyError),
+			onCopyAiPromptError: (copyError) => (0, _hexclave_shared_dist_utils_errors.captureError)("setup-error-overlay-copy-ai-prompt", copyError),
+			onMinimize: () => render(true)
+		}));
+		focusTrap = (0, ___in_page_ui_issue_card_js.trapFocusInIssueCard)(root);
+	};
+	render(false);
+	const cleanup = () => {
+		focusTrap?.release();
+		focusTrap = null;
+		root.remove();
+		if ((0, ___in_page_ui_dom_js.getGlobalUiInstance)("__hexclave-setup-error-overlay")?.cleanup === cleanup) (0, ___in_page_ui_dom_js.setGlobalUiInstance)(SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY, null);
+	};
+	(0, ___in_page_ui_dom_js.setGlobalUiInstance)(SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY, { cleanup });
+	return cleanup;
+}
+//#endregion
+exports.SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY = SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY;
+exports.showSetupErrorOverlay = showSetupErrorOverlay;
+
+//# sourceMappingURL=index.js.map

package/dist/setup-error-overlay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["HexclaveSetupError"],"sources":["../../src/setup-error-overlay/index.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\n\n// Renders an error card on the page when an auth flow dies because of a setup problem in the developer's project (a\n// domain missing from the trusted domains, for example). Those failures used to be logged with captureError only, which\n// meant the flow just quietly stopped: the developer saw a page that never signed anybody in, with the explanation\n// buried in the console or in Sentry. Setup errors are always the developer's to fix and never recoverable at runtime,\n// so they get the same treatment as a broken pushed config: a card that is impossible to miss.\n\nimport { HexclaveSetupError, captureError, errorToNiceString } from \"@hexclave/shared/dist/utils/errors\";\nimport { isLikelyDevelopmentEnvironment } from \"../in-page-ui/dev-environment\";\nimport { canMountIntoDom, getGlobalUiInstance, h, setGlobalUiInstance } from \"../in-page-ui/dom\";\nimport { getIssueCardCSS, renderIssueCard, renderIssuePill, trapFocusInIssueCard, type IssueCardFocusTrap } from \"../in-page-ui/issue-card\";\n\n/** Exported so tests can drop the singleton; every other consumer should go through `showSetupErrorOverlay`. */\nexport const SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY = \"__hexclave-setup-error-overlay\";\n\nconst css = getIssueCardCSS(\".hexclave-setup-error-overlay\");\n\nconst unexpectedErrorHowToFix = [\n  \"Check the browser console and your Hexclave dashboard's logs for the full error.\",\n  \"Make sure your Hexclave SDK packages are up to date.\",\n  \"If the error looks like a bug in Hexclave, report it at https://github.com/hexclave/hexclave/issues.\",\n] as const;\n\ntype SetupIssue = {\n  title: string,\n  message: string,\n  howToFix: readonly string[],\n  // Setup errors are known to be fatal for their flow, so the card says so. Anything else may well be transient (a\n  // network blip while resolving a session, say), and claiming that nobody can sign in anymore would be misleading.\n  isFatal: boolean,\n};\n\nfunction toSetupIssue(error: unknown): SetupIssue {\n  if (HexclaveSetupError.isSetupError(error)) {\n    return {\n      title: error.title,\n      message: error.message,\n      howToFix: error.howToFix,\n      isFatal: true,\n    };\n  }\n  return {\n    title: \"Hexclave could not finish an authentication flow\",\n    message: errorToNiceString(error),\n    howToFix: unexpectedErrorHowToFix,\n    isFatal: false,\n  };\n}\n\nfunction buildAiPrompt(issue: SetupIssue): string {\n  return [\n    \"Help me fix this Hexclave setup error.\",\n    \"\",\n    \"Hexclave reminder:\",\n    \"This error was thrown by the Hexclave SDK in the browser while it was resolving an authentication flow, and the flow was aborted because of it. It is a problem with how my project is set up, not something my users can work around. Use your web fetch tool to read https://skill.hexclave.com to learn more about Hexclave.\",\n    \"\",\n    \"Error message:\",\n    issue.message,\n    \"\",\n    \"Hexclave suggests:\",\n    ...issue.howToFix.map((step) => `- ${step}`),\n    \"\",\n    \"Please explain the likely cause and suggest the smallest safe fix.\",\n  ].join(\"\\n\");\n}\n\n/**\n * Shows `error` as an error card on the current page.\n *\n * Setup errors are always shown, because the flow they aborted cannot complete no matter what the end user does, and\n * their messages are written for exactly this purpose. Any other error is only shown while developing — those messages\n * are internal diagnostics, so in production they stay in captureError's hands.\n *\n * Returns a cleanup function that removes the card again.\n */\nexport function showSetupErrorOverlay(error: unknown): () => void {\n  if (!canMountIntoDom()) {\n    return () => {};\n  }\n  if (!HexclaveSetupError.isSetupError(error) && !isLikelyDevelopmentEnvironment()) {\n    return () => {};\n  }\n\n  const issue = toSetupIssue(error);\n  const existingInstance = getGlobalUiInstance(SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY);\n  if (existingInstance != null) {\n    // A single broken setup usually throws the same error on every page load and sometimes from several flows at once.\n    // Stacking cards on top of each other would only hide the first (and most relevant) one, so later errors keep to\n    // captureError and leave the card that is already up alone.\n    return () => {};\n  }\n\n  const root = h(\"div\", { className: \"hexclave-setup-error-overlay\" });\n  const style = h(\"style\", null, css);\n  root.appendChild(style);\n  document.body.appendChild(root);\n\n  let focusTrap: IssueCardFocusTrap | null = null;\n  const render = (minimized: boolean) => {\n    focusTrap?.release();\n    focusTrap = null;\n    root.replaceChildren(style);\n    if (minimized) {\n      root.appendChild(renderIssuePill({\n        kind: \"error\",\n        label: \"Setup error\",\n        ariaLabel: \"Show Hexclave setup error\",\n        onClick: () => render(false),\n      }));\n      return;\n    }\n    root.appendChild(renderIssueCard({\n      kind: \"error\",\n      badge: \"Setup error\",\n      title: issue.title,\n      bodyText: issue.isFatal\n        ? \"Hexclave stopped the authentication flow that ran into this error, so nobody can sign in through it until it is fixed.\"\n        : \"Hexclave aborted the authentication flow that ran into this error. Errors like this one may also be transient, in which case retrying the flow works.\",\n      messageLabel: \"Error message\",\n      message: issue.message,\n      howToFix: issue.howToFix,\n      footerText: issue.isFatal\n        ? \"This card is shown by the Hexclave SDK. Fix the problem above and reload the page to try the flow again.\"\n        : \"This card is shown by the Hexclave SDK while developing, and never in production.\",\n      ariaLabel: \"Hexclave setup error\",\n      aiPrompt: buildAiPrompt(issue),\n      onCopyError: (copyError) => captureError(\"setup-error-overlay-copy\", copyError),\n      onCopyAiPromptError: (copyError) => captureError(\"setup-error-overlay-copy-ai-prompt\", copyError),\n      onMinimize: () => render(true),\n    }));\n    focusTrap = trapFocusInIssueCard(root);\n  };\n  render(false);\n\n  const cleanup = () => {\n    focusTrap?.release();\n    focusTrap = null;\n    root.remove();\n    if (getGlobalUiInstance(SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY)?.cleanup === cleanup) {\n      setGlobalUiInstance(SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY, null);\n    }\n  };\n  setGlobalUiInstance(SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY, { cleanup });\n  return cleanup;\n}\n\n"],"mappings":";;;;;;;AAiBA,MAAa,0CAA0C;AAEvD,MAAM,OAAA,GAAA,4BAAA,gBAAA,CAAsB,+BAA+B;AAE3D,MAAM,0BAA0B;CAC9B;CACA;CACA;AACF;AAWA,SAAS,aAAa,OAA4B;CAChD,IAAIA,mCAAAA,mBAAmB,aAAa,KAAK,GACvC,OAAO;EACL,OAAO,MAAM;EACb,SAAS,MAAM;EACf,UAAU,MAAM;EAChB,SAAS;CACX;CAEF,OAAO;EACL,OAAO;EACP,UAAA,GAAA,mCAAA,kBAAA,CAA2B,KAAK;EAChC,UAAU;EACV,SAAS;CACX;AACF;AAEA,SAAS,cAAc,OAA2B;CAChD,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA,MAAM;EACN;EACA;EACA,GAAG,MAAM,SAAS,KAAK,SAAS,KAAK,MAAM;EAC3C;EACA;CACF,CAAC,CAAC,KAAK,IAAI;AACb;;;;;;;;;;AAWA,SAAgB,sBAAsB,OAA4B;CAChE,IAAI,EAAA,GAAA,qBAAA,gBAAA,CAAiB,GACnB,aAAa,CAAC;CAEhB,IAAI,CAACA,mCAAAA,mBAAmB,aAAa,KAAK,KAAK,EAAA,GAAA,iCAAA,+BAAA,CAAgC,GAC7E,aAAa,CAAC;CAGhB,MAAM,QAAQ,aAAa,KAAK;CAEhC,KAAA,GAAA,qBAAA,oBAAA,CAAA,gCAAmB,KAAK,MAItB,aAAa,CAAC;CAGhB,MAAM,QAAA,GAAA,qBAAA,EAAA,CAAS,OAAO,EAAE,WAAW,+BAA+B,CAAC;CACnE,MAAM,SAAA,GAAA,qBAAA,EAAA,CAAU,SAAS,MAAM,GAAG;CAClC,KAAK,YAAY,KAAK;CACtB,SAAS,KAAK,YAAY,IAAI;CAE9B,IAAI,YAAuC;CAC3C,MAAM,UAAU,cAAuB;EACrC,WAAW,QAAQ;EACnB,YAAY;EACZ,KAAK,gBAAgB,KAAK;EAC1B,IAAI,WAAW;GACb,KAAK,aAAA,GAAA,4BAAA,gBAAA,CAA4B;IAC/B,MAAM;IACN,OAAO;IACP,WAAW;IACX,eAAe,OAAO,KAAK;GAC7B,CAAC,CAAC;GACF;EACF;EACA,KAAK,aAAA,GAAA,4BAAA,gBAAA,CAA4B;GAC/B,MAAM;GACN,OAAO;GACP,OAAO,MAAM;GACb,UAAU,MAAM,UACZ,2HACA;GACJ,cAAc;GACd,SAAS,MAAM;GACf,UAAU,MAAM;GAChB,YAAY,MAAM,UACd,6GACA;GACJ,WAAW;GACX,UAAU,cAAc,KAAK;GAC7B,cAAc,eAAA,GAAA,mCAAA,aAAA,CAA2B,4BAA4B,SAAS;GAC9E,sBAAsB,eAAA,GAAA,mCAAA,aAAA,CAA2B,sCAAsC,SAAS;GAChG,kBAAkB,OAAO,IAAI;EAC/B,CAAC,CAAC;EACF,aAAA,GAAA,4BAAA,qBAAA,CAAiC,IAAI;CACvC;CACA,OAAO,KAAK;CAEZ,MAAM,gBAAgB;EACpB,WAAW,QAAQ;EACnB,YAAY;EACZ,KAAK,OAAO;EACZ,KAAA,GAAA,qBAAA,oBAAA,CAAA,gCAA+D,CAAC,EAAE,YAAY,SAC5E,CAAA,GAAA,qBAAA,oBAAA,CAAoB,yCAAyC,IAAI;CAErE;CACA,CAAA,GAAA,qBAAA,oBAAA,CAAoB,yCAAyC,EAAE,QAAQ,CAAC;CACxE,OAAO;AACT"}

package/dist/setup-error-overlay/index.test.d.ts

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

package/dist/setup-error-overlay/index.test.js

@@ -0,0 +1,124 @@
+let _hexclave_shared_dist_utils_errors = require("@hexclave/shared/dist/utils/errors");
+let vitest = require("vitest");
+let __index_js = require("./index.js");
+//#region src/setup-error-overlay/index.test.ts
+// @vitest-environment jsdom
+function createSetupError() {
+	return new _hexclave_shared_dist_utils_errors.HexclaveSetupError({
+		title: "A domain in your authentication flow is not one of your project's trusted domains",
+		message: "Nested cross-domain auth callback URL https://demo.example.test/ is not trusted.",
+		howToFix: ["Add https://demo.example.test to your project's trusted domains."]
+	});
+}
+function overlayRoots() {
+	return document.querySelectorAll(".hexclave-setup-error-overlay");
+}
+(0, vitest.describe)("setup error overlay", () => {
+	(0, vitest.afterEach)(() => {
+		vitest.vi.unstubAllEnvs();
+		for (const root of overlayRoots()) root.remove();
+		Reflect.deleteProperty(window, __index_js.SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY);
+	});
+	(0, vitest.it)("renders setup errors with their fix instructions, even outside development", () => {
+		vitest.vi.stubEnv("NODE_ENV", "production");
+		const error = createSetupError();
+		const cleanup = (0, __index_js.showSetupErrorOverlay)(error);
+		try {
+			(0, vitest.expect)(overlayRoots()).toHaveLength(1);
+			const text = document.body.textContent;
+			(0, vitest.expect)(text).toContain(error.title);
+			(0, vitest.expect)(text).toContain(error.message);
+			(0, vitest.expect)(text).toContain(error.howToFix[0]);
+			(0, vitest.expect)(document.querySelector("[role='alertdialog']")).not.toBeNull();
+		} finally {
+			cleanup();
+		}
+		(0, vitest.expect)(overlayRoots()).toHaveLength(0);
+	});
+	(0, vitest.it)("minimizes into a pill and back", () => {
+		vitest.vi.stubEnv("NODE_ENV", "production");
+		const cleanup = (0, __index_js.showSetupErrorOverlay)(createSetupError());
+		try {
+			const minimizeButton = document.querySelector("[aria-label='Minimize Hexclave setup error']");
+			(0, vitest.expect)(minimizeButton).not.toBeNull();
+			minimizeButton?.click();
+			(0, vitest.expect)(document.querySelector("[role='alertdialog']")).toBeNull();
+			const pill = document.querySelector("[aria-label='Show Hexclave setup error']");
+			(0, vitest.expect)(pill).not.toBeNull();
+			pill?.click();
+			(0, vitest.expect)(document.querySelector("[role='alertdialog']")).not.toBeNull();
+		} finally {
+			cleanup();
+		}
+	});
+	(0, vitest.it)("keeps keyboard focus inside the card and gives it back afterwards", () => {
+		vitest.vi.stubEnv("NODE_ENV", "production");
+		const pageButton = document.body.appendChild(document.createElement("button"));
+		pageButton.focus();
+		const cleanup = (0, __index_js.showSetupErrorOverlay)(createSetupError());
+		try {
+			const card = document.querySelector("[role='alertdialog']");
+			(0, vitest.expect)(document.activeElement).toBe(card);
+			const cardButtons = [...card?.querySelectorAll("button") ?? []];
+			(0, vitest.expect)(cardButtons.length).toBeGreaterThan(1);
+			cardButtons[cardButtons.length - 1].focus();
+			document.dispatchEvent(new KeyboardEvent("keydown", {
+				key: "Tab",
+				bubbles: true,
+				cancelable: true
+			}));
+			(0, vitest.expect)(document.activeElement).toBe(cardButtons[0]);
+			document.dispatchEvent(new KeyboardEvent("keydown", {
+				key: "Tab",
+				bubbles: true,
+				cancelable: true,
+				shiftKey: true
+			}));
+			(0, vitest.expect)(document.activeElement).toBe(cardButtons[cardButtons.length - 1]);
+			pageButton.focus();
+			document.dispatchEvent(new KeyboardEvent("keydown", {
+				key: "Tab",
+				bubbles: true,
+				cancelable: true
+			}));
+			(0, vitest.expect)(document.activeElement).toBe(cardButtons[0]);
+		} finally {
+			cleanup();
+		}
+		(0, vitest.expect)(document.activeElement).toBe(pageButton);
+		pageButton.remove();
+	});
+	(0, vitest.it)("keeps the first card instead of stacking later errors on top of it", () => {
+		vitest.vi.stubEnv("NODE_ENV", "production");
+		const firstError = createSetupError();
+		const cleanup = (0, __index_js.showSetupErrorOverlay)(firstError);
+		try {
+			(0, __index_js.showSetupErrorOverlay)(new _hexclave_shared_dist_utils_errors.HexclaveSetupError({
+				title: "Another setup error",
+				message: "Another setup error happened.",
+				howToFix: ["Fix the other thing."]
+			}))();
+			(0, vitest.expect)(overlayRoots()).toHaveLength(1);
+			(0, vitest.expect)(document.body.textContent).toContain(firstError.message);
+			(0, vitest.expect)(document.body.textContent).not.toContain("Another setup error happened.");
+		} finally {
+			cleanup();
+		}
+	});
+	(0, vitest.it)("only shows errors that are not setup errors while developing", () => {
+		vitest.vi.stubEnv("NODE_ENV", "production");
+		(0, __index_js.showSetupErrorOverlay)(/* @__PURE__ */ new Error("Some internal failure."))();
+		(0, vitest.expect)(overlayRoots()).toHaveLength(0);
+		vitest.vi.stubEnv("NODE_ENV", "development");
+		const cleanup = (0, __index_js.showSetupErrorOverlay)(/* @__PURE__ */ new Error("Some internal failure."));
+		try {
+			(0, vitest.expect)(overlayRoots()).toHaveLength(1);
+			(0, vitest.expect)(document.body.textContent).toContain("Some internal failure.");
+		} finally {
+			cleanup();
+		}
+	});
+});
+//#endregion
+
+//# sourceMappingURL=index.test.js.map

package/dist/setup-error-overlay/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","names":["HexclaveSetupError","SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY"],"sources":["../../src/setup-error-overlay/index.test.ts"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\n// @vitest-environment jsdom\n\nimport { HexclaveSetupError } from \"@hexclave/shared/dist/utils/errors\";\nimport { afterEach, describe, expect, it, vi } from \"vitest\";\nimport { SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY, showSetupErrorOverlay } from \".\";\n\nfunction createSetupError() {\n  return new HexclaveSetupError({\n    title: \"A domain in your authentication flow is not one of your project's trusted domains\",\n    message: \"Nested cross-domain auth callback URL https://demo.example.test/ is not trusted.\",\n    howToFix: [\"Add https://demo.example.test to your project's trusted domains.\"],\n  });\n}\n\nfunction overlayRoots() {\n  return document.querySelectorAll(\".hexclave-setup-error-overlay\");\n}\n\ndescribe(\"setup error overlay\", () => {\n  afterEach(() => {\n    vi.unstubAllEnvs();\n    for (const root of overlayRoots()) {\n      root.remove();\n    }\n    Reflect.deleteProperty(window, SETUP_ERROR_OVERLAY_GLOBAL_INSTANCE_KEY);\n  });\n\n  it(\"renders setup errors with their fix instructions, even outside development\", () => {\n    vi.stubEnv(\"NODE_ENV\", \"production\");\n    const error = createSetupError();\n\n    const cleanup = showSetupErrorOverlay(error);\n    try {\n      expect(overlayRoots()).toHaveLength(1);\n      const text = document.body.textContent;\n      expect(text).toContain(error.title);\n      expect(text).toContain(error.message);\n      expect(text).toContain(error.howToFix[0]);\n      expect(document.querySelector(\"[role='alertdialog']\")).not.toBeNull();\n    } finally {\n      cleanup();\n    }\n\n    expect(overlayRoots()).toHaveLength(0);\n  });\n\n  it(\"minimizes into a pill and back\", () => {\n    vi.stubEnv(\"NODE_ENV\", \"production\");\n    const cleanup = showSetupErrorOverlay(createSetupError());\n    try {\n      const minimizeButton = document.querySelector<HTMLButtonElement>(\"[aria-label='Minimize Hexclave setup error']\");\n      expect(minimizeButton).not.toBeNull();\n      minimizeButton?.click();\n      expect(document.querySelector(\"[role='alertdialog']\")).toBeNull();\n\n      const pill = document.querySelector<HTMLButtonElement>(\"[aria-label='Show Hexclave setup error']\");\n      expect(pill).not.toBeNull();\n      pill?.click();\n      expect(document.querySelector(\"[role='alertdialog']\")).not.toBeNull();\n    } finally {\n      cleanup();\n    }\n  });\n\n  it(\"keeps keyboard focus inside the card and gives it back afterwards\", () => {\n    vi.stubEnv(\"NODE_ENV\", \"production\");\n    const pageButton = document.body.appendChild(document.createElement(\"button\"));\n    pageButton.focus();\n\n    const cleanup = showSetupErrorOverlay(createSetupError());\n    try {\n      const card = document.querySelector<HTMLElement>(\"[role='alertdialog']\");\n      expect(document.activeElement).toBe(card);\n\n      const cardButtons = [...(card?.querySelectorAll(\"button\") ?? [])];\n      expect(cardButtons.length).toBeGreaterThan(1);\n      cardButtons[cardButtons.length - 1].focus();\n      document.dispatchEvent(new KeyboardEvent(\"keydown\", { key: \"Tab\", bubbles: true, cancelable: true }));\n      expect(document.activeElement).toBe(cardButtons[0]);\n      document.dispatchEvent(new KeyboardEvent(\"keydown\", { key: \"Tab\", bubbles: true, cancelable: true, shiftKey: true }));\n      expect(document.activeElement).toBe(cardButtons[cardButtons.length - 1]);\n\n      // Tabbing away from the card is what the trap exists to prevent, even when the page itself moves focus.\n      pageButton.focus();\n      document.dispatchEvent(new KeyboardEvent(\"keydown\", { key: \"Tab\", bubbles: true, cancelable: true }));\n      expect(document.activeElement).toBe(cardButtons[0]);\n    } finally {\n      cleanup();\n    }\n\n    expect(document.activeElement).toBe(pageButton);\n    pageButton.remove();\n  });\n\n  it(\"keeps the first card instead of stacking later errors on top of it\", () => {\n    vi.stubEnv(\"NODE_ENV\", \"production\");\n    const firstError = createSetupError();\n    const cleanup = showSetupErrorOverlay(firstError);\n    try {\n      const secondCleanup = showSetupErrorOverlay(new HexclaveSetupError({\n        title: \"Another setup error\",\n        message: \"Another setup error happened.\",\n        howToFix: [\"Fix the other thing.\"],\n      }));\n      secondCleanup();\n\n      expect(overlayRoots()).toHaveLength(1);\n      expect(document.body.textContent).toContain(firstError.message);\n      expect(document.body.textContent).not.toContain(\"Another setup error happened.\");\n    } finally {\n      cleanup();\n    }\n  });\n\n  it(\"only shows errors that are not setup errors while developing\", () => {\n    vi.stubEnv(\"NODE_ENV\", \"production\");\n    showSetupErrorOverlay(new Error(\"Some internal failure.\"))();\n    expect(overlayRoots()).toHaveLength(0);\n\n    vi.stubEnv(\"NODE_ENV\", \"development\");\n    const cleanup = showSetupErrorOverlay(new Error(\"Some internal failure.\"));\n    try {\n      expect(overlayRoots()).toHaveLength(1);\n      expect(document.body.textContent).toContain(\"Some internal failure.\");\n    } finally {\n      cleanup();\n    }\n  });\n});\n"],"mappings":"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"}

package/dist/team-invitation-B5Ol7vdd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"team-invitation-B5Ol7vdd.d.ts","names":[],"sources":["../src/components-page/team-invitation.tsx"],"mappings":";iBAyEgB,cAAA;EAAiB,QAAA;EAAgB;AAAA;EAAkB,QAAA;EAAoB,YAAA,EAAc,MAAA;AAAA,gCAAwB,GAAA,CAAA,OAAA"}
+{"version":3,"file":"team-invitation-B5Ol7vdd.d.ts","names":[],"sources":["../src/components-page/team-invitation.tsx"],"mappings":";iBA2EgB,cAAA;EAAiB,QAAA;EAAgB;AAAA;EAAkB,QAAA;EAAoB,YAAA,EAAc,MAAA;AAAA,gCAAwB,GAAA,CAAA,OAAA"}

package/dist/{translation-provider-WOaZXqAz.d.ts → translation-provider-6505O9P2.d.ts}

@@ -1,4 +1,4 @@
-import { n as quetzalLocales } from "./quetzal-translations-XeH3zQ9l.js";
+import { n as quetzalLocales } from "./quetzal-translations-B2jT2SWm.js";
 
 //#region src/providers/translation-provider.d.ts
 declare function TranslationProvider({
@@ -12,4 +12,4 @@ declare function TranslationProvider({
 }): import("react/jsx-runtime").JSX.Element;
 //#endregion
 export { TranslationProvider as t };
-//# sourceMappingURL=translation-provider-WOaZXqAz.d.ts.map
+//# sourceMappingURL=translation-provider-6505O9P2.d.ts.map

package/dist/{translation-provider-WOaZXqAz.d.ts.map → translation-provider-6505O9P2.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"translation-provider-WOaZXqAz.d.ts","names":[],"sources":["../src/providers/translation-provider.tsx"],"mappings":";;;iBAQgB,mBAAA;EAAsB,IAAA;EAAM,oBAAA;EAAsB;AAAA;EAChE,IAAA,EAAM,UAAA,QAAkB,cAAA,CAAe,GAAA;EACvC,oBAAA,GAAuB,MAAA;EACvB,QAAA,EAAU,KAAA,CAAM,SAAA;AAAA,gCACjB,GAAA,CAAA,OAAA"}
+{"version":3,"file":"translation-provider-6505O9P2.d.ts","names":[],"sources":["../src/providers/translation-provider.tsx"],"mappings":";;;iBAQgB,mBAAA;EAAsB,IAAA;EAAM,oBAAA;EAAsB;AAAA;EAChE,IAAA,EAAM,UAAA,QAAkB,cAAA,CAAe,GAAA;EACvC,oBAAA,GAAuB,MAAA;EACvB,QAAA,EAAU,KAAA,CAAM,SAAA;AAAA,gCACjB,GAAA,CAAA,OAAA"}

package/dist/utils/monkey-patch.d.ts

@@ -0,0 +1,7 @@
+//#region src/utils/monkey-patch.d.ts
+declare const NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL = "__stack-no-suspense-boundary-error__";
+declare function isNoSuspenseBoundaryError(value: unknown): boolean;
+declare function ensureMonkeyPatch(): void;
+//#endregion
+export { NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL, ensureMonkeyPatch, isNoSuspenseBoundaryError };
+//# sourceMappingURL=monkey-patch.d.ts.map

package/dist/utils/monkey-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monkey-patch.d.ts","names":[],"sources":["../../src/utils/monkey-patch.tsx"],"mappings":";cAMa,mCAAA;AAAA,iBAEG,yBAAA,CAA0B,KAAc;AAAA,iBASxC,iBAAA"}

package/dist/utils/monkey-patch.js

@@ -0,0 +1,23 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _hexclave_shared_dist_utils_globals = require("@hexclave/shared/dist/utils/globals");
+//#region src/utils/monkey-patch.tsx
+const NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL = "__stack-no-suspense-boundary-error__";
+function isNoSuspenseBoundaryError(value) {
+	return typeof value === "object" && value !== null && "__noSuspenseBoundarySentinel" in value && value.__noSuspenseBoundarySentinel === "__stack-no-suspense-boundary-error__";
+}
+function ensureMonkeyPatch() {
+	(0, _hexclave_shared_dist_utils_globals.createGlobal)("__console-error-monkey-patch__", () => {
+		const originalConsoleError = console.error;
+		console.error = function(...args) {
+			if (args.length === 1 && isNoSuspenseBoundaryError(args[0])) return;
+			return originalConsoleError.apply(this, args);
+		};
+		return true;
+	});
+}
+//#endregion
+exports.NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL = NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL;
+exports.ensureMonkeyPatch = ensureMonkeyPatch;
+exports.isNoSuspenseBoundaryError = isNoSuspenseBoundaryError;
+
+//# sourceMappingURL=monkey-patch.js.map

package/dist/utils/monkey-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monkey-patch.js","names":[],"sources":["../../src/utils/monkey-patch.tsx"],"sourcesContent":["\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\nimport { createGlobal } from \"@hexclave/shared/dist/utils/globals\";\n\nexport const NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL = \"__stack-no-suspense-boundary-error__\";\n\nexport function isNoSuspenseBoundaryError(value: unknown): boolean {\n  return (\n    typeof value === \"object\"\n    && value !== null\n    && \"__noSuspenseBoundarySentinel\" in value\n    && value.__noSuspenseBoundarySentinel === NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL\n  );\n}\n\nexport function ensureMonkeyPatch() {\n  createGlobal(\"__console-error-monkey-patch__\", () => {\n    const originalConsoleError = console.error;\n    console.error = function (...args: unknown[]) {\n      // React's default error handlers log every server error, including the one we intentionally throw to skip SSR.\n      // Frameworks that use those defaults (including vanilla React) therefore need this narrow sentinel-based filter.\n      if (args.length === 1 && isNoSuspenseBoundaryError(args[0])) {\n        return;\n      }\n      return originalConsoleError.apply(this, args);\n    };\n    return true;\n  });\n}\n"],"mappings":";;;AAMA,MAAa,sCAAsC;AAEnD,SAAgB,0BAA0B,OAAyB;CACjE,OACE,OAAO,UAAU,YACd,UAAU,QACV,kCAAkC,SAClC,MAAM,iCAAA;AAEb;AAEA,SAAgB,oBAAoB;CAClC,CAAA,GAAA,oCAAA,aAAA,CAAa,wCAAwC;EACnD,MAAM,uBAAuB,QAAQ;EACrC,QAAQ,QAAQ,SAAU,GAAG,MAAiB;GAG5C,IAAI,KAAK,WAAW,KAAK,0BAA0B,KAAK,EAAE,GACxD;GAEF,OAAO,qBAAqB,MAAM,MAAM,IAAI;EAC9C;EACA,OAAO;CACT,CAAC;AACH"}

package/dist/utils/react.d.ts

@@ -0,0 +1,17 @@
+//#region src/utils/react.d.ts
+declare function shouldRethrowRenderingError(error: unknown): boolean;
+declare class NoSuspenseBoundaryError extends Error {
+  digest: string;
+  reason: string;
+  __noSuspenseBoundarySentinel: string;
+  constructor(options: {
+    caller?: string;
+  });
+}
+/**
+ * Use this in a component or hook to disable SSR. It must be wrapped in a Suspense boundary.
+ */
+declare function suspendIfSsr(caller?: string): void;
+//#endregion
+export { NoSuspenseBoundaryError, shouldRethrowRenderingError, suspendIfSsr };
+//# sourceMappingURL=react.d.ts.map

package/dist/utils/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","names":[],"sources":["../../src/utils/react.tsx"],"mappings":";iBAYgB,2BAAA,CAA4B,KAAc;AAAA,cAI7C,uBAAA,SAAgC,KAAK;EAChD,MAAA;EACA,MAAA;EACA,4BAAA;cAEY,OAAA;IAAW,MAAA;EAAA;AAAA;;;;iBA8DT,YAAA,CAAa,MAAe"}

package/dist/utils/react.js

@@ -0,0 +1,63 @@
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _hexclave_shared_dist_utils_strings = require("@hexclave/shared/dist/utils/strings");
+let next_navigation = require("next/navigation");
+let _hexclave_shared_dist_utils_env = require("@hexclave/shared/dist/utils/env");
+let __monkey_patch_js = require("./monkey-patch.js");
+//#region src/utils/react.tsx
+function shouldRethrowRenderingError(error) {
+	return !!error && typeof error === "object" && "digest" in error && error.digest === "BAILOUT_TO_CLIENT_SIDE_RENDERING";
+}
+var NoSuspenseBoundaryError = class extends Error {
+	constructor(options) {
+		(0, __monkey_patch_js.ensureMonkeyPatch)();
+		super(_hexclave_shared_dist_utils_strings.deindent`
+      Suspense boundary not found! Read the error message below carefully (or paste it into your AI agent).
+
+      ${options.caller ?? "This code path"} attempted to display a loading indicator, but didn't find a Suspense boundary above it. Please read the error message below carefully.
+      
+      There are several potential causes:
+      
+      1. [Next.js] You are missing a loading.tsx file in your app directory. Fix it by adding a loading.tsx file in your app directory.
+
+      2. [React] You are missing a <Suspense> boundary in your component. Fix it by wrapping your component (or the entire app) in a <Suspense> component.
+
+      3. [Next.js] The component is rendered in the root (outermost) layout.tsx or template.tsx file. Next.js does not wrap those files in a Suspense boundary, even if there is a loading.tsx file in the same folder. To fix it, wrap your layout inside a route group like this:
+
+        - app
+        - - layout.tsx  // contains <html> and <body>, alongside providers and other components that don't need ${options.caller ?? "this code path"}
+        - - loading.tsx  // required for suspense
+        - - (main)
+        - - - layout.tsx  // contains the main layout of your app, like a sidebar or a header, and can use ${options.caller ?? "this code path"}
+        - - - route.tsx  // your actual main page
+        - - - the rest of your app
+
+        For more information on this approach, see Next's documentation on route groups: https://nextjs.org/docs/app/building-your-application/routing/route-groups
+      
+      4. You caught this error with try-catch or a custom error boundary. Fix this by rethrowing the error or not catching it in the first place.
+
+      5. Your version of Hexclave is too old. Upgrade to the latest version to see if that fixes the issue.
+
+      See: https://nextjs.org/docs/messages/missing-suspense-with-csr-bailout
+
+      More information on SSR and Suspense boundaries: https://react.dev/reference/react/Suspense#providing-a-fallback-for-server-errors-and-client-only-content
+    `);
+		this.__noSuspenseBoundarySentinel = __monkey_patch_js.NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL;
+		this.name = "NoSuspenseBoundaryError";
+		this.reason = options.caller ?? "suspendIfSsr()";
+		this.digest = "BAILOUT_TO_CLIENT_SIDE_RENDERING";
+	}
+};
+/**
+* Use this in a component or hook to disable SSR. It must be wrapped in a Suspense boundary.
+*/
+function suspendIfSsr(caller) {
+	(0, next_navigation.useSearchParams)();
+	if (!(0, _hexclave_shared_dist_utils_env.isBrowserLike)()) throw new NoSuspenseBoundaryError({ caller });
+}
+//#endregion
+exports.NoSuspenseBoundaryError = NoSuspenseBoundaryError;
+exports.shouldRethrowRenderingError = shouldRethrowRenderingError;
+exports.suspendIfSsr = suspendIfSsr;
+
+//# sourceMappingURL=react.js.map

package/dist/utils/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":["NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL"],"sources":["../../src/utils/react.tsx"],"sourcesContent":["'use client';\n\n\n//===========================================\n// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template\n//===========================================\n\nimport { isBrowserLike } from \"@hexclave/shared/dist/utils/env\";\nimport { deindent } from \"@hexclave/shared/dist/utils/strings\";\nimport { useSearchParams } from \"next/navigation\"; // THIS_LINE_PLATFORM next\nimport { ensureMonkeyPatch, NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL } from \"./monkey-patch\";\n\nexport function shouldRethrowRenderingError(error: unknown): boolean {\n  return !!error && typeof error === \"object\" && \"digest\" in error && error.digest === \"BAILOUT_TO_CLIENT_SIDE_RENDERING\";\n}\n\nexport class NoSuspenseBoundaryError extends Error {\n  digest: string;\n  reason: string;\n  __noSuspenseBoundarySentinel = NO_SUSPENSE_BOUNDARY_ERROR_SENTINEL;\n\n  constructor(options: { caller?: string }) {\n    ensureMonkeyPatch();\n\n    super(deindent`\n      Suspense boundary not found! Read the error message below carefully (or paste it into your AI agent).\n\n      ${options.caller ?? \"This code path\"} attempted to display a loading indicator, but didn't find a Suspense boundary above it. Please read the error message below carefully.\n      \n      There are several potential causes:\n      \n      1. [Next.js] You are missing a loading.tsx file in your app directory. Fix it by adding a loading.tsx file in your app directory.\n\n      2. [React] You are missing a <Suspense> boundary in your component. Fix it by wrapping your component (or the entire app) in a <Suspense> component.\n\n      3. [Next.js] The component is rendered in the root (outermost) layout.tsx or template.tsx file. Next.js does not wrap those files in a Suspense boundary, even if there is a loading.tsx file in the same folder. To fix it, wrap your layout inside a route group like this:\n\n        - app\n        - - layout.tsx  // contains <html> and <body>, alongside providers and other components that don't need ${options.caller ?? \"this code path\"}\n        - - loading.tsx  // required for suspense\n        - - (main)\n        - - - layout.tsx  // contains the main layout of your app, like a sidebar or a header, and can use ${options.caller ?? \"this code path\"}\n        - - - route.tsx  // your actual main page\n        - - - the rest of your app\n\n        For more information on this approach, see Next's documentation on route groups: https://nextjs.org/docs/app/building-your-application/routing/route-groups\n      \n      4. You caught this error with try-catch or a custom error boundary. Fix this by rethrowing the error or not catching it in the first place.\n\n      5. Your version of Hexclave is too old. Upgrade to the latest version to see if that fixes the issue.\n\n      See: https://nextjs.org/docs/messages/missing-suspense-with-csr-bailout\n\n      More information on SSR and Suspense boundaries: https://react.dev/reference/react/Suspense#providing-a-fallback-for-server-errors-and-client-only-content\n    `);\n\n    this.name = \"NoSuspenseBoundaryError\";\n    this.reason = options.caller ?? \"suspendIfSsr()\";\n\n    // Next recognizes this digest as an intentional request-time CSR bailout and suppresses its normal error reporting.\n    this.digest = \"BAILOUT_TO_CLIENT_SIDE_RENDERING\";\n  }\n}\nimport.meta.vitest?.test(\"NoSuspenseBoundaryError\", ({ expect }) => {\n  const defaultError = new NoSuspenseBoundaryError({});\n  expect(defaultError.name).toBe(\"NoSuspenseBoundaryError\");\n  expect(defaultError.reason).toBe(\"suspendIfSsr()\");\n  expect(defaultError.digest).toBe(\"BAILOUT_TO_CLIENT_SIDE_RENDERING\");\n  expect(defaultError.message).toContain(\"This code path attempted to display a loading indicator\");\n\n  const customError = new NoSuspenseBoundaryError({ caller: \"CustomComponent\" });\n  expect(customError.name).toBe(\"NoSuspenseBoundaryError\");\n  expect(customError.reason).toBe(\"CustomComponent\");\n  expect(customError.digest).toBe(\"BAILOUT_TO_CLIENT_SIDE_RENDERING\");\n  expect(customError.message).toContain(\"CustomComponent attempted to display a loading indicator\");\n  expect(customError.message).toContain(\"loading.tsx\");\n  expect(customError.message).toContain(\"route groups\");\n  expect(customError.message).toContain(\"https://nextjs.org/docs/messages/missing-suspense-with-csr-bailout\");\n});\n\n/**\n * Use this in a component or hook to disable SSR. It must be wrapped in a Suspense boundary.\n */\nexport function suspendIfSsr(caller?: string) {\n  // Next 16.3's Instant Insights is a silly goose! It rejects our deliberate recoverable SSR error during\n  // prerender validation, even though React uses the surrounding Suspense fallback correctly. Calling\n  // useSearchParams first makes Next create its own recognized `prerender-client` dynamic hole, so prerendering\n  // stops before our error while request-time SSR still reaches the error and retries this subtree on the client.\n  useSearchParams();\n  if (!isBrowserLike()) {\n    throw new NoSuspenseBoundaryError({ caller });\n  }\n}\n"],"mappings":";;;;;;;AAYA,SAAgB,4BAA4B,OAAyB;CACnE,OAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,YAAY,SAAS,MAAM,WAAW;AACvF;AAEA,IAAa,0BAAb,cAA6C,MAAM;CAKjD,YAAY,SAA8B;EACxC,CAAA,GAAA,kBAAA,kBAAA,CAAkB;EAElB,MAAM,oCAAA,QAAQ;;;QAGV,QAAQ,UAAU,iBAAiB;;;;;;;;;;;kHAWuE,QAAQ,UAAU,iBAAiB;;;6GAGxC,QAAQ,UAAU,iBAAiB;;;;;;;;;;;;;KAa3I;sCAnC4BA,kBAAAA;EAqC7B,KAAK,OAAO;EACZ,KAAK,SAAS,QAAQ,UAAU;EAGhC,KAAK,SAAS;CAChB;AACF;;;;AAqBA,SAAgB,aAAa,QAAiB;CAK5C,CAAA,GAAA,gBAAA,gBAAA,CAAgB;CAChB,IAAI,EAAA,GAAA,gCAAA,cAAA,CAAe,GACjB,MAAM,IAAI,wBAAwB,EAAE,OAAO,CAAC;AAEhD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "//": "THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template (FOR package.json FILES, PLEASE EDIT package-template.json)",
   "name": "@hexclave/next",
-  "version": "1.0.75",
+  "version": "1.0.77",
   "repository": "https://github.com/hexclave/hexclave",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -74,9 +74,9 @@
     "tailwindcss-animate": "^1.0.7",
     "rrweb": "^1.1.3",
     "yup": "^1.7.1",
-    "@hexclave/sc": "1.0.75",
-    "@hexclave/ui": "1.0.75",
-    "@hexclave/shared": "1.0.75"
+    "@hexclave/sc": "1.0.77",
+    "@hexclave/ui": "1.0.77",
+    "@hexclave/shared": "1.0.77"
   },
   "peerDependencies": {
     "@types/react": ">=18.0.0",

package/src/components/elements/sidebar-layout.tsx

@@ -5,11 +5,11 @@
 // THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template
 //===========================================
 
-import { useHash } from '@hexclave/shared/dist/hooks/use-hash';
 import { Button, Typography, cn } from '@hexclave/ui';
 import { XIcon } from 'lucide-react';
 import React, { ReactNode } from 'react';
 import { useStackApp } from '../..';
+import { suspendIfSsr } from '../../utils/react';
 
 export type SidebarItem = {
   title: React.ReactNode,
@@ -21,6 +21,21 @@ export type SidebarItem = {
   contentTitle?: React.ReactNode,
 }
 
+function normalizeHash(hash: string) {
+  return hash.startsWith("#") ? hash.slice(1) : hash;
+}
+
+function useHash() {
+  suspendIfSsr();
+  return React.useSyncExternalStore(
+    (onStoreChange) => {
+      window.addEventListener("hashchange", onStoreChange);
+      return () => window.removeEventListener("hashchange", onStoreChange);
+    },
+    () => normalizeHash(window.location.hash),
+  );
+}
+
 export function SidebarLayout(props: { items: SidebarItem[], title?: ReactNode, className?: string }) {
   const hash = useHash();
   const selectedIndex = props.items.findIndex(item => item.id && (item.id === hash));

package/src/components-page/team-invitation-cache.test.ts

@@ -0,0 +1,25 @@
+
+//===========================================
+// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template
+//===========================================
+import { describe, expect, it, vi } from "vitest";
+import { cacheTeamInvitationOperation } from "./team-invitation-cache";
+
+describe("cacheTeamInvitationOperation", () => {
+  it("reuses results within a session but not across sessions", async () => {
+    let resultNumber = 0;
+    const operation = vi.fn(async (_app: object, _code: string) => {
+      resultNumber += 1;
+      return resultNumber;
+    });
+    const cachedOperation = cacheTeamInvitationOperation(operation);
+    const app = {};
+    const firstSession = {};
+    const secondSession = {};
+
+    await expect(cachedOperation(app, firstSession, "shared-code")).resolves.toBe(1);
+    await expect(cachedOperation(app, firstSession, "shared-code")).resolves.toBe(1);
+    await expect(cachedOperation(app, secondSession, "shared-code")).resolves.toBe(2);
+    expect(operation).toHaveBeenCalledTimes(2);
+  });
+});

package/src/components-page/team-invitation-cache.ts

@@ -0,0 +1,13 @@
+
+//===========================================
+// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template
+//===========================================
+import { cacheFunction } from "@hexclave/shared/dist/utils/caches";
+
+export function cacheTeamInvitationOperation<TApp extends object, TResult>(
+  operation: (app: TApp, code: string) => Promise<TResult>,
+): (app: TApp, session: object, code: string) => Promise<TResult> {
+  return cacheFunction(async (app: TApp, _session: object, code: string) => {
+    return await operation(app, code);
+  });
+}

package/src/components-page/team-invitation.tsx

@@ -6,7 +6,6 @@
 //===========================================
 
 import { KnownErrors } from "@hexclave/shared";
-import { cacheFunction } from "@hexclave/shared/dist/utils/caches";
 import { runAsynchronouslyWithAlert } from "@hexclave/shared/dist/utils/promises";
 import { use } from "@hexclave/shared/dist/utils/react";
 import { Typography } from "@hexclave/ui";
@@ -14,21 +13,24 @@ import React from "react";
 import { MessageCard, StackClientApp, useStackApp, useUser } from "..";
 import { PredefinedMessageCard } from "../components/message-cards/predefined-message-card";
 import { useTranslation } from "../lib/translations";
+import { cacheTeamInvitationOperation } from "./team-invitation-cache";
 
-const cachedVerifyInvitation = cacheFunction(async (hexclaveApp: StackClientApp<true>, code: string) => {
+// Both endpoints inspect the current account, so the session must participate in
+// the key even though the SDK app object and invitation code are otherwise stable.
+const cachedVerifyInvitation = cacheTeamInvitationOperation(async (hexclaveApp: StackClientApp<true>, code: string) => {
   return await hexclaveApp.verifyTeamInvitationCode(code);
 });
 
-const cachedGetInvitationDetails = cacheFunction(async (hexclaveApp: StackClientApp<true>, code: string) => {
+const cachedGetInvitationDetails = cacheTeamInvitationOperation(async (hexclaveApp: StackClientApp<true>, code: string) => {
   return await hexclaveApp.getTeamInvitationDetails(code);
 });
 
-function TeamInvitationInner(props: { fullPage?: boolean, searchParams: Record<string, string> }) {
+function TeamInvitationInner(props: { fullPage?: boolean, searchParams: Record<string, string>, session: object }) {
   const { t } = useTranslation();
   const hexclaveApp = useStackApp();
   const [success, setSuccess] = React.useState(false);
   const [errorMessage, setErrorMessage] = React.useState<string | null>(null);
-  const details = use(cachedGetInvitationDetails(hexclaveApp, props.searchParams.code || ''));
+  const details = use(cachedGetInvitationDetails(hexclaveApp, props.session, props.searchParams.code || ''));
 
   if (errorMessage || details.status === 'error') {
     return (
@@ -131,7 +133,7 @@ export function TeamInvitation({ fullPage=false, searchParams }: { fullPage?: bo
     );
   }
 
-  const verificationResult = use(cachedVerifyInvitation(hexclaveApp, searchParams.code || ''));
+  const verificationResult = use(cachedVerifyInvitation(hexclaveApp, user._internalSession, searchParams.code || ''));
 
   if (verificationResult.status === 'error') {
     const error = verificationResult.error;
@@ -146,5 +148,12 @@ export function TeamInvitation({ fullPage=false, searchParams }: { fullPage?: bo
     }
   }
 
-  return <TeamInvitationInner fullPage={fullPage} searchParams={searchParams} />;
+  return (
+    <TeamInvitationInner
+      key={user.id}
+      fullPage={fullPage}
+      searchParams={searchParams}
+      session={user._internalSession}
+    />
+  );
 };