@hexclave/next 1.0.76 → 1.0.78

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

@@ -1 +1 @@
-{"version":3,"file":"quetzal-translations-CK45_4Dm.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-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"}

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-DQ3BJepJ.d.ts → translation-provider-WOaZXqAz.d.ts}

@@ -1,4 +1,4 @@
-import { n as quetzalLocales } from "./quetzal-translations-CK45_4Dm.js";
+import { n as quetzalLocales } from "./quetzal-translations-XeH3zQ9l.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-DQ3BJepJ.d.ts.map
+//# sourceMappingURL=translation-provider-WOaZXqAz.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"translation-provider-DQ3BJepJ.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-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"}

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.76",
+  "version": "1.0.78",
   "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/shared": "1.0.76",
-    "@hexclave/ui": "1.0.76",
-    "@hexclave/sc": "1.0.76"
+    "@hexclave/sc": "1.0.78",
+    "@hexclave/ui": "1.0.78",
+    "@hexclave/shared": "1.0.78"
   },
   "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}
+    />
+  );
 };

package/src/lib/hexclave-app/apps/implementations/admin-app-impl.ts

@@ -1404,6 +1404,7 @@ export class _HexclaveAdminAppImplIncomplete<HasTokenStore extends boolean, Proj
 
     const items: AdminSessionReplay[] = response.items.map((r) => ({
       id: r.id,
+      refreshTokenId: r.refresh_token_id,
       projectUser: {
         id: r.project_user.id,
         displayName: r.project_user.display_name,
@@ -1425,6 +1426,7 @@ export class _HexclaveAdminAppImplIncomplete<HasTokenStore extends boolean, Proj
     const response = await this._interface.getSessionReplay(sessionReplayId);
     return {
       id: response.id,
+      refreshTokenId: response.refresh_token_id,
       projectUser: {
         id: response.project_user.id,
         displayName: response.project_user.display_name,

package/src/lib/hexclave-app/apps/implementations/client-app-impl.automatic-side-effects.test.ts

@@ -2,9 +2,10 @@
 //===========================================
 // 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 } from "vitest";
+import { describe, expect, it, vi } from "vitest";
 import { hexclaveAppInternalsSymbol } from "../../common";
 import { HexclaveClientApp, HexclaveClientAppConstructorOptions, HexclaveClientAppJson } from "../interfaces/client-app";
+import { stripBrowserActionQueryParam } from "./client-app-impl";
 
 const baseOptions = {
   baseUrl: "http://localhost:12345",
@@ -123,4 +124,40 @@ describe("HexclaveClientApp automatic side effects", () => {
 
     expect(second).toBe(first);
   });
+
+  it("keeps stripping the browser action parameter after a router restores it", () => {
+    vi.useFakeTimers();
+    const previousWindow = Reflect.get(globalThis, "window");
+    const hadPreviousWindow = Reflect.has(globalThis, "window");
+    let currentHref = "http://localhost:12345/?hexclave_action_id=action-id";
+    const browserGlobal = {
+      location: {
+        get href() {
+          return currentHref;
+        },
+      },
+      history: {
+        state: null,
+        replaceState: (_state: null, _title: string, url: string | URL) => {
+          currentHref = String(url);
+        },
+      },
+      setTimeout,
+    };
+
+    Reflect.set(globalThis, "window", browserGlobal);
+    try {
+      stripBrowserActionQueryParam();
+      currentHref = "http://localhost:12345/?hexclave_action_id=action-id";
+      vi.runAllTimers();
+      expect(currentHref).toBe("http://localhost:12345/");
+    } finally {
+      vi.useRealTimers();
+      if (hadPreviousWindow) {
+        Reflect.set(globalThis, "window", previousWindow);
+      } else {
+        Reflect.deleteProperty(globalThis, "window");
+      }
+    }
+  });
 });

package/src/lib/hexclave-app/apps/implementations/client-app-impl.cross-domain.test.ts

@@ -11,9 +11,8 @@ import { StackClientApp } from "../interfaces/client-app";
 import { planRedirectToHandler } from "./redirect-page-urls";
 
 // Every app in this file is constructed with `devTool: false`. The tests install a mock window and document, which makes
-// the SDK believe it is in a browser, and mounting the dev tool kicks off a background `getProject()` against a backend
-// that does not exist here. That fetch never settles, and because it runs inside the global store lock, it blocks every
-// later `withWriteLock` caller (`_signOut`, most visibly) for the rest of the test file.
+// the SDK believe it is in a browser; mounting the dev tool would then start background requests against a backend that
+// does not exist here and leak that work across test cases.
 function createAccessTokenString(refreshTokenId: string): string {
   const encode = (value: unknown) => Buffer.from(JSON.stringify(value)).toString("base64url");
   const nowSeconds = Math.floor(Date.now() / 1000);

package/src/lib/hexclave-app/apps/implementations/client-app-impl.sign-out.test.ts

@@ -0,0 +1,96 @@
+
+//===========================================
+// THIS FILE IS AUTO-GENERATED FROM TEMPLATE. DO NOT EDIT IT DIRECTLY UNLESS YOU ALSO EDIT THE CORRESPONDING FILE IN packages/template
+//===========================================
+import { AsyncStore } from "@hexclave/shared/dist/utils/stores";
+import { describe, expect, it } from "vitest";
+import { StackClientApp } from "../interfaces/client-app";
+
+function createAccessTokenString(refreshTokenId: string): string {
+  const encode = (value: unknown) => Buffer.from(JSON.stringify(value)).toString("base64url");
+  const nowSeconds = Math.floor(Date.now() / 1000);
+  return [
+    encode({ alg: "none", typ: "JWT" }),
+    encode({ sub: "user-id", exp: nowSeconds + 60, iat: nowSeconds, refresh_token_id: refreshTokenId }),
+    "",
+  ].join(".");
+}
+
+class Deferred {
+  readonly promise: Promise<void>;
+  private _resolve: () => void = () => {
+    throw new Error("Deferred promise was resolved before initialization");
+  };
+
+  constructor() {
+    this.promise = new Promise<void>((resolve) => {
+      this._resolve = resolve;
+    });
+  }
+
+  resolve(): void {
+    this._resolve();
+  }
+}
+
+describe("StackClientApp sign-out", () => {
+  it("delays current-user reads until redirect dispatch without blocking unrelated stores", async () => {
+    const clientApp = new StackClientApp({
+      baseUrl: "http://localhost:12345",
+      projectId: "00000000-0000-4000-8000-000000000000",
+      publishableClientKey: "stack-pk-test",
+      tokenStore: "memory",
+      redirectMethod: "none",
+      noAutomaticPrefetch: true,
+      devTool: false,
+    });
+    const clientInterface = Reflect.get(clientApp, "_interface");
+    Reflect.set(clientInterface, "getClientUserByToken", async () => ({
+      id: "user-id",
+      is_anonymous: false,
+      is_restricted: false,
+    }));
+
+    const signInToAccountWithTokens = Reflect.get(clientApp, "_signInToAccountWithTokens");
+    await signInToAccountWithTokens.call(clientApp, {
+      accessToken: createAccessTokenString("refresh-token-id"),
+      refreshToken: "refresh-token",
+    });
+
+    const createCookieHelper = Reflect.get(clientApp, "_createCookieHelper");
+    const getOrCreateTokenStore = Reflect.get(clientApp, "_getOrCreateTokenStore");
+    const getSessionFromTokenStore = Reflect.get(clientApp, "_getSessionFromTokenStore");
+    const tokenStore = getOrCreateTokenStore.call(clientApp, await createCookieHelper.call(clientApp));
+    const session = getSessionFromTokenStore.call(clientApp, tokenStore);
+
+    Reflect.set(clientInterface, "signOut", async () => {
+      session.markInvalid();
+    });
+
+    const redirectStarted = new Deferred();
+    const redirectFinished = new Deferred();
+    Reflect.set(clientApp, "_redirectToDefaultAfterSignOut", async () => {
+      redirectStarted.resolve();
+      await redirectFinished.promise;
+    });
+
+    const unrelatedStore = new AsyncStore<void>();
+    expect(unrelatedStore.setAsync(new Promise<void>(() => {}))).toBeInstanceOf(Promise);
+
+    const signOut = Reflect.get(clientApp, "_signOut");
+    const signOutPromise = signOut.call(clientApp, session);
+    await redirectStarted.promise;
+
+    const getUserDuringSignOut = clientApp.getUser();
+    const stateBeforeRedirectFinished = await Promise.race([
+      getUserDuringSignOut.then(() => "resolved"),
+      Promise.resolve("pending"),
+    ]);
+    expect(stateBeforeRedirectFinished).toBe("pending");
+
+    redirectFinished.resolve();
+    await signOutPromise;
+
+    await expect(getUserDuringSignOut).resolves.toBeNull();
+  });
+});