@hexclave/tanstack-start 1.0.55 → 1.0.57

package/dist/dev-tool/index.js

@@ -15,11 +15,13 @@ function getOverride() {
 	return null;
 }
 let activeDevToolOption = void 0;
+let activeProjectIsDevelopmentEnvironment = false;
 function shouldShow() {
 	const override = getOverride();
 	if (override !== null) return override;
 	if (!(0, ___in_page_ui_dom_js.canMountIntoDom)()) return false;
 	if (activeDevToolOption === true) return true;
+	if (activeProjectIsDevelopmentEnvironment) return true;
 	const nodeEnv = ___generated_env_js.envVars.NODE_ENV;
 	if (nodeEnv !== void 0) return nodeEnv === "development";
 	try {
@@ -74,10 +76,25 @@ function tryMount() {
 function mountDevTool(app, devToolOption) {
 	activeApp = app;
 	activeDevToolOption = devToolOption === false ? void 0 : devToolOption ?? void 0;
+	activeProjectIsDevelopmentEnvironment = false;
 	tryMount();
+	queueMicrotask(() => {
+		(0, _hexclave_shared_dist_utils_promises.runAsynchronously)(async () => {
+			const project = await app.getProject();
+			if (activeApp !== app) return;
+			activeProjectIsDevelopmentEnvironment = project.isDevelopmentEnvironment;
+			if (activeProjectIsDevelopmentEnvironment && activeCleanup === null) tryMount();
+		}, {
+			noErrorLogging: true,
+			onError: (error) => {
+				(0, _hexclave_shared_dist_utils_errors.captureError)("dev-tool-project-detection", error);
+			}
+		});
+	});
 	const myCleanup = activeCleanup;
 	return () => {
 		activeApp = null;
+		activeProjectIsDevelopmentEnvironment = false;
 		if (activeCleanup === myCleanup && myCleanup != null) {
 			activeCleanup = null;
 			myCleanup();
@@ -111,7 +128,7 @@ if (typeof window !== "undefined") window.HexclaveDevTool = window.HexclaveDevTo
 			activeCleanup();
 			activeCleanup = null;
 		}
-		console.log("[Stack DevTool] Reset to default (auto-detect based on NODE_ENV or localhost/file: origin).");
+		console.log("[Stack DevTool] Reset to default (auto-detect based on project, NODE_ENV, or localhost/file: origin).");
 	}
 };
 //#endregion

package/dist/dev-tool/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["envVars"],"sources":["../../src/dev-tool/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\nimport type { StackClientApp } from \"../lib/hexclave-app\";\nimport { captureError } from \"@hexclave/shared/dist/utils/errors\";\nimport { runAsynchronously } from \"@hexclave/shared/dist/utils/promises\";\nimport { isLocalhost } from \"@hexclave/shared/dist/utils/urls\";\nimport { canMountIntoDom } from \"../in-page-ui/dom\";\nimport { envVars } from \"../generated/env\";\nimport type { createDevTool as CreateDevToolFn } from \"./dev-tool-core\";\n\n// Hexclave rebrand: UI-only local pref — straight rename (one-time reset is harmless)\nconst OVERRIDE_KEY = '__hexclave-dev-tool-override';\n\nfunction getOverride(): boolean | null {\n  try {\n    const val = localStorage.getItem(OVERRIDE_KEY);\n    if (val === 'true') return true;\n    if (val === 'false') return false;\n  } catch {}\n  return null;\n}\n\nlet activeDevToolOption: true | \"auto\" | undefined = undefined;\n\nfunction shouldShow(): boolean {\n  const override = getOverride();\n  if (override !== null) return override;\n  if (!canMountIntoDom()) return false;\n\n  // If devTool was explicitly set to true, always show\n  if (activeDevToolOption === true) return true;\n\n  // \"auto\" behavior (the default):\n  const nodeEnv = envVars.NODE_ENV;\n  if (nodeEnv !== undefined) {\n    // NODE_ENV is available (bundler/process env exists) — only show in development\n    return nodeEnv === \"development\";\n  }\n\n  // NODE_ENV not found (no process.env/import.meta) — show on localhost or file: protocol\n  try {\n    const url = new URL(window.location.href);\n    if (url.protocol === \"file:\") return true;\n  } catch {}\n  return isLocalhost(window.location.href);\n}\n\nlet activeCleanup: (() => void) | null = null;\nlet activeApp: StackClientApp<true> | null = null;\nlet mountGeneration = 0;\n\nlet createDevToolPromise: Promise<typeof CreateDevToolFn> | null = null;\nfunction loadCreateDevTool(): Promise<typeof CreateDevToolFn> {\n  if (!createDevToolPromise) {\n    createDevToolPromise = import(\"./dev-tool-core\").then(m => m.createDevTool).catch((err) => {\n      createDevToolPromise = null;\n      throw err;\n    });\n  }\n  return createDevToolPromise;\n}\n\nfunction tryMount() {\n  if (activeCleanup) {\n    activeCleanup();\n    activeCleanup = null;\n  }\n\n  if (!shouldShow() || !activeApp || !canMountIntoDom()) return;\n\n  const generation = ++mountGeneration;\n  const app = activeApp;\n\n  runAsynchronously(async () => {\n    const createDevTool = await loadCreateDevTool();\n    if (generation !== mountGeneration) return;\n    if (!shouldShow() || activeApp !== app || !canMountIntoDom()) return;\n    activeCleanup = createDevTool(app);\n  }, {\n    noErrorLogging: true,\n    onError: (error) => {\n      captureError(\"dev-tool-mount\", error);\n    },\n  });\n}\n\n/**\n * Mounts the Hexclave dev tool on the page.\n *\n * Visibility is determined by the `devTool` option:\n * - `true`: always show\n * - `false`: never show (caller gates this — mountDevTool won't be called)\n * - `\"auto\"` / `undefined`: show based on NODE_ENV or localhost/file: heuristics\n *\n * Console commands (also work in production):\n *   HexclaveDevTool.enable()  — force-show the dev tool\n *   HexclaveDevTool.disable() — force-hide the dev tool\n *   HexclaveDevTool.reset()   — revert to auto behavior\n */\nexport function mountDevTool(app: StackClientApp<true>, devToolOption?: boolean | \"auto\"): () => void {\n  activeApp = app;\n  activeDevToolOption = devToolOption === false ? undefined : devToolOption ?? undefined;\n  tryMount();\n\n  // Capture the cleanup created by THIS specific mount call so that React\n  // StrictMode's double-invoke doesn't let the first effect's cleanup tear\n  // down the second mount (which would cause the tool to disappear silently).\n  const myCleanup = activeCleanup;\n\n  return () => {\n    activeApp = null;\n    if (activeCleanup === myCleanup && myCleanup != null) {\n      activeCleanup = null;\n      myCleanup();\n    }\n  };\n}\n\n// Expose console commands: HexclaveDevTool.enable() / .disable() / .reset()\nif (typeof window !== 'undefined') {\n  // Hexclave rebrand: expose under both the legacy and new global names.\n  (window as any).HexclaveDevTool = (window as any).HexclaveDevTool = {\n    enable() {\n      try {\n        localStorage.setItem(OVERRIDE_KEY, 'true');\n      } catch {}\n      tryMount();\n      console.log('[Stack DevTool] Enabled. Refresh if the panel does not appear.');\n    },\n    disable() {\n      try {\n        localStorage.setItem(OVERRIDE_KEY, 'false');\n      } catch {}\n      if (activeCleanup) {\n        activeCleanup();\n        activeCleanup = null;\n      }\n      console.log('[Stack DevTool] Disabled.');\n    },\n    reset() {\n      try {\n        localStorage.removeItem(OVERRIDE_KEY);\n      } catch {}\n      if (shouldShow()) {\n        tryMount();\n      } else if (activeCleanup) {\n        activeCleanup();\n        activeCleanup = null;\n      }\n      console.log('[Stack DevTool] Reset to default (auto-detect based on NODE_ENV or localhost/file: origin).');\n    },\n  };\n}\n\n"],"mappings":";;;;;;;AAcA,MAAM,eAAe;AAErB,SAAS,cAA8B;CACrC,IAAI;EACF,MAAM,MAAM,aAAa,QAAQ,YAAY;EAC7C,IAAI,QAAQ,QAAQ,OAAO;EAC3B,IAAI,QAAQ,SAAS,OAAO;CAC9B,QAAQ,CAAC;CACT,OAAO;AACT;AAEA,IAAI,sBAAiD,KAAA;AAErD,SAAS,aAAsB;CAC7B,MAAM,WAAW,YAAY;CAC7B,IAAI,aAAa,MAAM,OAAO;CAC9B,IAAI,EAAA,GAAA,qBAAA,gBAAA,CAAiB,GAAG,OAAO;CAG/B,IAAI,wBAAwB,MAAM,OAAO;CAGzC,MAAM,UAAUA,oBAAAA,QAAQ;CACxB,IAAI,YAAY,KAAA,GAEd,OAAO,YAAY;CAIrB,IAAI;EAEF,IAAI,IADY,IAAI,OAAO,SAAS,IAC9B,CAAC,CAAC,aAAa,SAAS,OAAO;CACvC,QAAQ,CAAC;CACT,QAAA,GAAA,iCAAA,YAAA,CAAmB,OAAO,SAAS,IAAI;AACzC;AAEA,IAAI,gBAAqC;AACzC,IAAI,YAAyC;AAC7C,IAAI,kBAAkB;AAEtB,IAAI,uBAA+D;AACnE,SAAS,oBAAqD;CAC5D,IAAI,CAAC,sBACH,uBAAuB,OAAO,qBAAkB,CAAC,MAAK,MAAK,EAAE,aAAa,CAAC,CAAC,OAAO,QAAQ;EACzF,uBAAuB;EACvB,MAAM;CACR,CAAC;CAEH,OAAO;AACT;AAEA,SAAS,WAAW;CAClB,IAAI,eAAe;EACjB,cAAc;EACd,gBAAgB;CAClB;CAEA,IAAI,CAAC,WAAW,KAAK,CAAC,aAAa,EAAA,GAAA,qBAAA,gBAAA,CAAiB,GAAG;CAEvD,MAAM,aAAa,EAAE;CACrB,MAAM,MAAM;CAEZ,CAAA,GAAA,qCAAA,kBAAA,CAAkB,YAAY;EAC5B,MAAM,gBAAgB,MAAM,kBAAkB;EAC9C,IAAI,eAAe,iBAAiB;EACpC,IAAI,CAAC,WAAW,KAAK,cAAc,OAAO,EAAA,GAAA,qBAAA,gBAAA,CAAiB,GAAG;EAC9D,gBAAgB,cAAc,GAAG;CACnC,GAAG;EACD,gBAAgB;EAChB,UAAU,UAAU;GAClB,CAAA,GAAA,mCAAA,aAAA,CAAa,kBAAkB,KAAK;EACtC;CACF,CAAC;AACH;;;;;;;;;;;;;;AAeA,SAAgB,aAAa,KAA2B,eAA8C;CACpG,YAAY;CACZ,sBAAsB,kBAAkB,QAAQ,KAAA,IAAY,iBAAiB,KAAA;CAC7E,SAAS;CAKT,MAAM,YAAY;CAElB,aAAa;EACX,YAAY;EACZ,IAAI,kBAAkB,aAAa,aAAa,MAAM;GACpD,gBAAgB;GAChB,UAAU;EACZ;CACF;AACF;AAGA,IAAI,OAAO,WAAW,aAEpB,OAAgB,kBAAkB,OAAgB,kBAAkB;CAClE,SAAS;EACP,IAAI;GACF,aAAa,QAAQ,cAAc,MAAM;EAC3C,QAAQ,CAAC;EACT,SAAS;EACT,QAAQ,IAAI,gEAAgE;CAC9E;CACA,UAAU;EACR,IAAI;GACF,aAAa,QAAQ,cAAc,OAAO;EAC5C,QAAQ,CAAC;EACT,IAAI,eAAe;GACjB,cAAc;GACd,gBAAgB;EAClB;EACA,QAAQ,IAAI,2BAA2B;CACzC;CACA,QAAQ;EACN,IAAI;GACF,aAAa,WAAW,YAAY;EACtC,QAAQ,CAAC;EACT,IAAI,WAAW,GACb,SAAS;OACJ,IAAI,eAAe;GACxB,cAAc;GACd,gBAAgB;EAClB;EACA,QAAQ,IAAI,6FAA6F;CAC3G;AACF"}
+{"version":3,"file":"index.js","names":["envVars"],"sources":["../../src/dev-tool/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\nimport type { StackClientApp } from \"../lib/hexclave-app\";\nimport { captureError } from \"@hexclave/shared/dist/utils/errors\";\nimport { runAsynchronously } from \"@hexclave/shared/dist/utils/promises\";\nimport { isLocalhost } from \"@hexclave/shared/dist/utils/urls\";\nimport { canMountIntoDom } from \"../in-page-ui/dom\";\nimport { envVars } from \"../generated/env\";\nimport type { createDevTool as CreateDevToolFn } from \"./dev-tool-core\";\n\n// Hexclave rebrand: UI-only local pref — straight rename (one-time reset is harmless)\nconst OVERRIDE_KEY = '__hexclave-dev-tool-override';\n\nfunction getOverride(): boolean | null {\n  try {\n    const val = localStorage.getItem(OVERRIDE_KEY);\n    if (val === 'true') return true;\n    if (val === 'false') return false;\n  } catch {}\n  return null;\n}\n\nlet activeDevToolOption: true | \"auto\" | undefined = undefined;\nlet activeProjectIsDevelopmentEnvironment = false;\n\nfunction shouldShow(): boolean {\n  const override = getOverride();\n  if (override !== null) return override;\n  if (!canMountIntoDom()) return false;\n\n  // If devTool was explicitly set to true, always show\n  if (activeDevToolOption === true) return true;\n\n  // Development environment projects should expose the tool even when the\n  // consuming app itself was built or hosted as production.\n  if (activeProjectIsDevelopmentEnvironment) return true;\n\n  // \"auto\" behavior (the default):\n  const nodeEnv = envVars.NODE_ENV;\n  if (nodeEnv !== undefined) {\n    // NODE_ENV is available (bundler/process env exists) — only show in development\n    return nodeEnv === \"development\";\n  }\n\n  // NODE_ENV not found (no process.env/import.meta) — show on localhost or file: protocol\n  try {\n    const url = new URL(window.location.href);\n    if (url.protocol === \"file:\") return true;\n  } catch {}\n  return isLocalhost(window.location.href);\n}\n\nlet activeCleanup: (() => void) | null = null;\nlet activeApp: StackClientApp<true> | null = null;\nlet mountGeneration = 0;\n\nlet createDevToolPromise: Promise<typeof CreateDevToolFn> | null = null;\nfunction loadCreateDevTool(): Promise<typeof CreateDevToolFn> {\n  if (!createDevToolPromise) {\n    createDevToolPromise = import(\"./dev-tool-core\").then(m => m.createDevTool).catch((err) => {\n      createDevToolPromise = null;\n      throw err;\n    });\n  }\n  return createDevToolPromise;\n}\n\nfunction tryMount() {\n  if (activeCleanup) {\n    activeCleanup();\n    activeCleanup = null;\n  }\n\n  if (!shouldShow() || !activeApp || !canMountIntoDom()) return;\n\n  const generation = ++mountGeneration;\n  const app = activeApp;\n\n  runAsynchronously(async () => {\n    const createDevTool = await loadCreateDevTool();\n    if (generation !== mountGeneration) return;\n    if (!shouldShow() || activeApp !== app || !canMountIntoDom()) return;\n    activeCleanup = createDevTool(app);\n  }, {\n    noErrorLogging: true,\n    onError: (error) => {\n      captureError(\"dev-tool-mount\", error);\n    },\n  });\n}\n\n/**\n * Mounts the Hexclave dev tool on the page.\n *\n * Visibility is determined by the `devTool` option:\n * - `true`: always show\n * - `false`: never show (caller gates this — mountDevTool won't be called)\n * - `\"auto\"` / `undefined`: show based on NODE_ENV or localhost/file: heuristics\n *\n * Console commands (also work in production):\n *   HexclaveDevTool.enable()  — force-show the dev tool\n *   HexclaveDevTool.disable() — force-hide the dev tool\n *   HexclaveDevTool.reset()   — revert to auto behavior\n */\nexport function mountDevTool(app: StackClientApp<true>, devToolOption?: boolean | \"auto\"): () => void {\n  activeApp = app;\n  activeDevToolOption = devToolOption === false ? undefined : devToolOption ?? undefined;\n  activeProjectIsDevelopmentEnvironment = false;\n  tryMount();\n\n  // The project endpoint is also the source of config warnings, so this uses\n  // the backend's development-environment flag instead of inferring it from\n  // the SDK's build or the current page's origin.\n  queueMicrotask(() => {\n    runAsynchronously(async () => {\n      const project = await app.getProject();\n      if (activeApp !== app) return;\n      activeProjectIsDevelopmentEnvironment = project.isDevelopmentEnvironment;\n      if (activeProjectIsDevelopmentEnvironment && activeCleanup === null) {\n        tryMount();\n      }\n    }, {\n      noErrorLogging: true,\n      onError: (error) => {\n        captureError(\"dev-tool-project-detection\", error);\n      },\n    });\n  });\n\n  // Capture the cleanup created by THIS specific mount call so that React\n  // StrictMode's double-invoke doesn't let the first effect's cleanup tear\n  // down the second mount (which would cause the tool to disappear silently).\n  const myCleanup = activeCleanup;\n\n  return () => {\n    activeApp = null;\n    activeProjectIsDevelopmentEnvironment = false;\n    if (activeCleanup === myCleanup && myCleanup != null) {\n      activeCleanup = null;\n      myCleanup();\n    }\n  };\n}\n\n// Expose console commands: HexclaveDevTool.enable() / .disable() / .reset()\nif (typeof window !== 'undefined') {\n  // Hexclave rebrand: expose under both the legacy and new global names.\n  (window as any).HexclaveDevTool = (window as any).HexclaveDevTool = {\n    enable() {\n      try {\n        localStorage.setItem(OVERRIDE_KEY, 'true');\n      } catch {}\n      tryMount();\n      console.log('[Stack DevTool] Enabled. Refresh if the panel does not appear.');\n    },\n    disable() {\n      try {\n        localStorage.setItem(OVERRIDE_KEY, 'false');\n      } catch {}\n      if (activeCleanup) {\n        activeCleanup();\n        activeCleanup = null;\n      }\n      console.log('[Stack DevTool] Disabled.');\n    },\n    reset() {\n      try {\n        localStorage.removeItem(OVERRIDE_KEY);\n      } catch {}\n      if (shouldShow()) {\n        tryMount();\n      } else if (activeCleanup) {\n        activeCleanup();\n        activeCleanup = null;\n      }\n      console.log('[Stack DevTool] Reset to default (auto-detect based on project, NODE_ENV, or localhost/file: origin).');\n    },\n  };\n}\n\n"],"mappings":"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"}

package/dist/dev-tool/index.test.d.ts

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

package/dist/dev-tool/index.test.js

@@ -0,0 +1,40 @@
+let vitest = require("vitest");
+let ___lib_hexclave_app_index_js = require("../lib/hexclave-app/index.js");
+let __dev_tool_core_js = require("./dev-tool-core.js");
+let __index_js = require("./index.js");
+//#region src/dev-tool/index.test.ts
+vitest.vi.mock("./dev-tool-core", () => ({ createDevTool: vitest.vi.fn(() => () => {}) }));
+(0, vitest.describe)("dev tool visibility", () => {
+	(0, vitest.afterEach)(() => {
+		vitest.vi.unstubAllEnvs();
+		vitest.vi.unstubAllGlobals();
+		vitest.vi.clearAllMocks();
+	});
+	(0, vitest.it)("shows for a development environment project in a production-hosted app", async () => {
+		const app = new ___lib_hexclave_app_index_js.StackClientApp({
+			baseUrl: "https://api.example.com",
+			projectId: "00000000-0000-4000-8000-000000000000",
+			publishableClientKey: "stack-pk-test",
+			tokenStore: "memory",
+			redirectMethod: "none",
+			devTool: false
+		});
+		const getProject = vitest.vi.fn(async () => ({ isDevelopmentEnvironment: true }));
+		Reflect.set(app, "getProject", getProject);
+		vitest.vi.stubEnv("NODE_ENV", "production");
+		vitest.vi.stubGlobal("window", { location: { href: "https://example.com" } });
+		vitest.vi.stubGlobal("document", {
+			body: { appendChild: () => {} },
+			createElement: () => ({})
+		});
+		vitest.vi.stubGlobal("localStorage", { getItem: () => null });
+		(0, __index_js.mountDevTool)(app);
+		await vitest.vi.waitFor(() => {
+			(0, vitest.expect)(getProject).toHaveBeenCalledOnce();
+			(0, vitest.expect)(__dev_tool_core_js.createDevTool).toHaveBeenCalledOnce();
+		});
+	});
+});
+//#endregion
+
+//# sourceMappingURL=index.test.js.map

package/dist/dev-tool/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","names":["vi","StackClientApp","createDevTool"],"sources":["../../src/dev-tool/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//===========================================\nimport { afterEach, describe, expect, it, vi } from \"vitest\";\nimport { StackClientApp } from \"../lib/hexclave-app\";\nimport { createDevTool } from \"./dev-tool-core\";\nimport { mountDevTool } from \".\";\n\nvi.mock(\"./dev-tool-core\", () => ({\n  createDevTool: vi.fn(() => () => {}),\n}));\n\ndescribe(\"dev tool visibility\", () => {\n  afterEach(() => {\n    vi.unstubAllEnvs();\n    vi.unstubAllGlobals();\n    vi.clearAllMocks();\n  });\n\n  it(\"shows for a development environment project in a production-hosted app\", async () => {\n    const app = new StackClientApp({\n      baseUrl: \"https://api.example.com\",\n      projectId: \"00000000-0000-4000-8000-000000000000\",\n      publishableClientKey: \"stack-pk-test\",\n      tokenStore: \"memory\",\n      redirectMethod: \"none\",\n      devTool: false,\n    });\n    const getProject = vi.fn(async () => ({\n      isDevelopmentEnvironment: true,\n    }));\n    Reflect.set(app, \"getProject\", getProject);\n\n    vi.stubEnv(\"NODE_ENV\", \"production\");\n    vi.stubGlobal(\"window\", {\n      location: {\n        href: \"https://example.com\",\n      },\n    });\n    vi.stubGlobal(\"document\", {\n      body: {\n        appendChild: () => {},\n      },\n      createElement: () => ({}),\n    });\n    vi.stubGlobal(\"localStorage\", {\n      getItem: () => null,\n    });\n\n    mountDevTool(app);\n\n    await vi.waitFor(() => {\n      expect(getProject).toHaveBeenCalledOnce();\n      expect(createDevTool).toHaveBeenCalledOnce();\n    });\n  });\n});\n"],"mappings":";;;;;AASAA,OAAAA,GAAG,KAAK,0BAA0B,EAChC,eAAeA,OAAAA,GAAG,eAAe,CAAC,CAAC,EACrC,EAAE;qBAEO,6BAA6B;CACpC,CAAA,GAAA,OAAA,UAAA,OAAgB;EACd,OAAA,GAAG,cAAc;EACjB,OAAA,GAAG,iBAAiB;EACpB,OAAA,GAAG,cAAc;CACnB,CAAC;CAED,CAAA,GAAA,OAAA,GAAA,CAAG,0EAA0E,YAAY;EACvF,MAAM,MAAM,IAAIC,6BAAAA,eAAe;GAC7B,SAAS;GACT,WAAW;GACX,sBAAsB;GACtB,YAAY;GACZ,gBAAgB;GAChB,SAAS;EACX,CAAC;EACD,MAAM,aAAaD,OAAAA,GAAG,GAAG,aAAa,EACpC,0BAA0B,KAC5B,EAAE;EACF,QAAQ,IAAI,KAAK,cAAc,UAAU;EAEzC,OAAA,GAAG,QAAQ,YAAY,YAAY;EACnC,OAAA,GAAG,WAAW,UAAU,EACtB,UAAU,EACR,MAAM,sBACR,EACF,CAAC;EACD,OAAA,GAAG,WAAW,YAAY;GACxB,MAAM,EACJ,mBAAmB,CAAC,EACtB;GACA,sBAAsB,CAAC;EACzB,CAAC;EACD,OAAA,GAAG,WAAW,gBAAgB,EAC5B,eAAe,KACjB,CAAC;EAED,CAAA,GAAA,WAAA,aAAA,CAAa,GAAG;EAEhB,MAAMA,OAAAA,GAAG,cAAc;GACrB,CAAA,GAAA,OAAA,OAAA,CAAO,UAAU,CAAC,CAAC,qBAAqB;GACxC,CAAA,GAAA,OAAA,OAAA,CAAOE,mBAAAA,aAAa,CAAC,CAAC,qBAAqB;EAC7C,CAAC;CACH,CAAC;AACH,CAAC"}

package/dist/esm/components/api-key-dialogs.d.ts

@@ -3,7 +3,7 @@ import { ApiKey, ApiKeyCreationOptions, ApiKeyType } from "../lib/hexclave-app/a
 //#region src/components/api-key-dialogs.d.ts
 declare const neverInMs: number;
 declare const expiresInOptions: {
-  readonly [x: number]: "Never" | "1 day" | "7 days" | "30 days" | "90 days" | "1 year";
+  readonly [x: number]: "1 day" | "7 days" | "30 days" | "90 days" | "1 year" | "Never";
 };
 /**
  * Dialog for creating a new API key

package/dist/esm/components-page/account-settings/active-sessions/active-sessions-page.js

@@ -3,10 +3,10 @@ import { captureError } from "@hexclave/shared/dist/utils/errors";
 import { ActionCell, Badge, Button, Skeleton, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, Typography } from "@hexclave/ui";
 import { useEffect, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { fromNow } from "@hexclave/shared/dist/utils/dates";
 import { useUser } from "../../../lib/hooks.js";
 import { useTranslation } from "../../../lib/translations.js";
 import { PageLayout } from "../page-layout.js";
-import { fromNow } from "@hexclave/shared/dist/utils/dates";
 //#region src/components-page/account-settings/active-sessions/active-sessions-page.tsx
 function ActiveSessionsPage(props) {
 	const { t } = useTranslation();

package/dist/esm/components-page/account-settings/api-keys/api-keys-page.js

@@ -1,11 +1,11 @@
 import { Button } from "@hexclave/ui";
 import { useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { CreateApiKeyDialog, ShowApiKeyDialog } from "../../../components/api-key-dialogs.js";
-import { ApiKeyTable } from "../../../components/api-key-table.js";
 import { useUser } from "../../../lib/hooks.js";
 import { useTranslation } from "../../../lib/translations.js";
 import { PageLayout } from "../page-layout.js";
+import { CreateApiKeyDialog, ShowApiKeyDialog } from "../../../components/api-key-dialogs.js";
+import { ApiKeyTable } from "../../../components/api-key-table.js";
 //#region src/components-page/account-settings/api-keys/api-keys-page.tsx
 function ApiKeysPage(props) {
 	const { t } = useTranslation();

package/dist/esm/components-page/account-settings/email-and-auth/emails-section.js

@@ -7,8 +7,8 @@ import { useForm } from "react-hook-form";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useUser } from "../../../lib/hooks.js";
 import { useTranslation } from "../../../lib/translations.js";
-import { FormWarningText } from "../../../components/elements/form-warning.js";
 import { KnownErrors } from "@hexclave/shared/dist/known-errors";
+import { FormWarningText } from "../../../components/elements/form-warning.js";
 //#region src/components-page/account-settings/email-and-auth/emails-section.tsx
 function EmailsSection(props) {
 	const { t } = useTranslation();

package/dist/esm/components-page/account-settings/email-and-auth/mfa-section.js

@@ -5,11 +5,11 @@ import { useEffect, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useStackApp, useUser } from "../../../lib/hooks.js";
 import { useTranslation } from "../../../lib/translations.js";
-import { Section } from "../section.js";
 import { createTOTPKeyURI, verifyTOTP } from "@oslojs/otp";
 import { useAsyncCallback } from "@hexclave/shared/dist/hooks/use-async-callback";
 import { generateRandomValues } from "@hexclave/shared/dist/utils/crypto";
 import * as QRCode from "qrcode";
+import { Section } from "../section.js";
 //#region src/components-page/account-settings/email-and-auth/mfa-section.tsx
 function MfaSection(props) {
 	const { t } = useTranslation();

package/dist/esm/components-page/account-settings/email-and-auth/passkey-section.js

@@ -3,8 +3,8 @@ import { useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useUser } from "../../../lib/hooks.js";
 import { useTranslation } from "../../../lib/translations.js";
-import { useStackApp as useStackApp$1 } from "../../../index.js";
 import { Section } from "../section.js";
+import { useStackApp as useStackApp$1 } from "../../../index.js";
 //#region src/components-page/account-settings/email-and-auth/passkey-section.tsx
 function PasskeySection(props) {
 	const { t } = useTranslation();

package/dist/esm/components-page/account-settings/email-and-auth/password-section.js

@@ -9,9 +9,9 @@ import { getPasswordError } from "@hexclave/shared/dist/helpers/password";
 import * as yup from "yup";
 import { useUser } from "../../../lib/hooks.js";
 import { useTranslation } from "../../../lib/translations.js";
-import { useStackApp as useStackApp$1 } from "../../../index.js";
-import { Section } from "../section.js";
 import { FormWarningText } from "../../../components/elements/form-warning.js";
+import { Section } from "../section.js";
+import { useStackApp as useStackApp$1 } from "../../../index.js";
 //#region src/components-page/account-settings/email-and-auth/password-section.tsx
 function PasswordSection(props) {
 	const { t } = useTranslation();

package/dist/esm/components-page/account-settings/payments/payments-panel.js

@@ -6,11 +6,11 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { KnownErrors } from "@hexclave/shared";
 import { Result } from "@hexclave/shared/dist/utils/results";
 import { useTranslation } from "../../../lib/translations.js";
+import { Section } from "../section.js";
 import { useStackApp } from "../../../index.js";
 import { CardElement, Elements, useElements, useStripe } from "@stripe/react-stripe-js";
 import { loadStripe } from "@stripe/stripe-js";
 import { envVars } from "../../../generated/env.js";
-import { Section } from "../section.js";
 //#region src/components-page/account-settings/payments/payments-panel.tsx
 function formatPaymentMethod(pm) {
 	return [

package/dist/esm/components-page/account-settings/teams/team-api-keys-section.js

@@ -2,10 +2,10 @@ import { HexclaveAssertionError } from "@hexclave/shared/dist/utils/errors";
 import { Button } from "@hexclave/ui";
 import { useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { CreateApiKeyDialog, ShowApiKeyDialog } from "../../../components/api-key-dialogs.js";
-import { ApiKeyTable } from "../../../components/api-key-table.js";
 import { useStackApp, useUser } from "../../../lib/hooks.js";
 import { useTranslation } from "../../../lib/translations.js";
+import { CreateApiKeyDialog, ShowApiKeyDialog } from "../../../components/api-key-dialogs.js";
+import { ApiKeyTable } from "../../../components/api-key-table.js";
 import { Section } from "../section.js";
 //#region src/components-page/account-settings/teams/team-api-keys-section.tsx
 function TeamApiKeysSection(props) {

package/dist/esm/components-page/account-settings/teams/team-creation-page.js

@@ -8,8 +8,8 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { useStackApp, useUser } from "../../../lib/hooks.js";
 import { useTranslation } from "../../../lib/translations.js";
 import { PageLayout } from "../page-layout.js";
-import { Section } from "../section.js";
 import { FormWarningText } from "../../../components/elements/form-warning.js";
+import { Section } from "../section.js";
 import { MessageCard } from "../../../components/message-cards/message-card.js";
 //#region src/components-page/account-settings/teams/team-creation-page.tsx
 function TeamCreationPage(props) {

package/dist/esm/components-page/account-settings/teams/team-member-invitation-section.js

@@ -8,8 +8,8 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Trash } from "lucide-react";
 import { useUser } from "../../../lib/hooks.js";
 import { useTranslation } from "../../../lib/translations.js";
-import { Section } from "../section.js";
 import { FormWarningText } from "../../../components/elements/form-warning.js";
+import { Section } from "../section.js";
 //#region src/components-page/account-settings/teams/team-member-invitation-section.tsx
 function TeamMemberInvitationSection(props) {
 	if (!useUser({ or: "redirect" }).usePermission(props.team, "$invite_members")) return null;

package/dist/esm/dev-tool/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/dev-tool/index.ts"],"mappings":";;;;;AAsGA;;;;;;;;AAAwF;;;iBAAxE,YAAA,CAAa,GAAA,EAAK,cAAc,QAAQ,aAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/dev-tool/index.ts"],"mappings":";;;;;AA2GA;;;;;;;;AAAwF;;;iBAAxE,YAAA,CAAa,GAAA,EAAK,cAAc,QAAQ,aAAA"}

package/dist/esm/dev-tool/index.js

@@ -14,11 +14,13 @@ function getOverride() {
 	return null;
 }
 let activeDevToolOption = void 0;
+let activeProjectIsDevelopmentEnvironment = false;
 function shouldShow() {
 	const override = getOverride();
 	if (override !== null) return override;
 	if (!canMountIntoDom()) return false;
 	if (activeDevToolOption === true) return true;
+	if (activeProjectIsDevelopmentEnvironment) return true;
 	const nodeEnv = envVars.NODE_ENV;
 	if (nodeEnv !== void 0) return nodeEnv === "development";
 	try {
@@ -73,10 +75,25 @@ function tryMount() {
 function mountDevTool(app, devToolOption) {
 	activeApp = app;
 	activeDevToolOption = devToolOption === false ? void 0 : devToolOption ?? void 0;
+	activeProjectIsDevelopmentEnvironment = false;
 	tryMount();
+	queueMicrotask(() => {
+		runAsynchronously(async () => {
+			const project = await app.getProject();
+			if (activeApp !== app) return;
+			activeProjectIsDevelopmentEnvironment = project.isDevelopmentEnvironment;
+			if (activeProjectIsDevelopmentEnvironment && activeCleanup === null) tryMount();
+		}, {
+			noErrorLogging: true,
+			onError: (error) => {
+				captureError("dev-tool-project-detection", error);
+			}
+		});
+	});
 	const myCleanup = activeCleanup;
 	return () => {
 		activeApp = null;
+		activeProjectIsDevelopmentEnvironment = false;
 		if (activeCleanup === myCleanup && myCleanup != null) {
 			activeCleanup = null;
 			myCleanup();
@@ -110,7 +127,7 @@ if (typeof window !== "undefined") window.HexclaveDevTool = window.HexclaveDevTo
 			activeCleanup();
 			activeCleanup = null;
 		}
-		console.log("[Stack DevTool] Reset to default (auto-detect based on NODE_ENV or localhost/file: origin).");
+		console.log("[Stack DevTool] Reset to default (auto-detect based on project, NODE_ENV, or localhost/file: origin).");
 	}
 };
 //#endregion

package/dist/esm/dev-tool/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/dev-tool/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\nimport type { StackClientApp } from \"../lib/hexclave-app\";\nimport { captureError } from \"@hexclave/shared/dist/utils/errors\";\nimport { runAsynchronously } from \"@hexclave/shared/dist/utils/promises\";\nimport { isLocalhost } from \"@hexclave/shared/dist/utils/urls\";\nimport { canMountIntoDom } from \"../in-page-ui/dom\";\nimport { envVars } from \"../generated/env\";\nimport type { createDevTool as CreateDevToolFn } from \"./dev-tool-core\";\n\n// Hexclave rebrand: UI-only local pref — straight rename (one-time reset is harmless)\nconst OVERRIDE_KEY = '__hexclave-dev-tool-override';\n\nfunction getOverride(): boolean | null {\n  try {\n    const val = localStorage.getItem(OVERRIDE_KEY);\n    if (val === 'true') return true;\n    if (val === 'false') return false;\n  } catch {}\n  return null;\n}\n\nlet activeDevToolOption: true | \"auto\" | undefined = undefined;\n\nfunction shouldShow(): boolean {\n  const override = getOverride();\n  if (override !== null) return override;\n  if (!canMountIntoDom()) return false;\n\n  // If devTool was explicitly set to true, always show\n  if (activeDevToolOption === true) return true;\n\n  // \"auto\" behavior (the default):\n  const nodeEnv = envVars.NODE_ENV;\n  if (nodeEnv !== undefined) {\n    // NODE_ENV is available (bundler/process env exists) — only show in development\n    return nodeEnv === \"development\";\n  }\n\n  // NODE_ENV not found (no process.env/import.meta) — show on localhost or file: protocol\n  try {\n    const url = new URL(window.location.href);\n    if (url.protocol === \"file:\") return true;\n  } catch {}\n  return isLocalhost(window.location.href);\n}\n\nlet activeCleanup: (() => void) | null = null;\nlet activeApp: StackClientApp<true> | null = null;\nlet mountGeneration = 0;\n\nlet createDevToolPromise: Promise<typeof CreateDevToolFn> | null = null;\nfunction loadCreateDevTool(): Promise<typeof CreateDevToolFn> {\n  if (!createDevToolPromise) {\n    createDevToolPromise = import(\"./dev-tool-core\").then(m => m.createDevTool).catch((err) => {\n      createDevToolPromise = null;\n      throw err;\n    });\n  }\n  return createDevToolPromise;\n}\n\nfunction tryMount() {\n  if (activeCleanup) {\n    activeCleanup();\n    activeCleanup = null;\n  }\n\n  if (!shouldShow() || !activeApp || !canMountIntoDom()) return;\n\n  const generation = ++mountGeneration;\n  const app = activeApp;\n\n  runAsynchronously(async () => {\n    const createDevTool = await loadCreateDevTool();\n    if (generation !== mountGeneration) return;\n    if (!shouldShow() || activeApp !== app || !canMountIntoDom()) return;\n    activeCleanup = createDevTool(app);\n  }, {\n    noErrorLogging: true,\n    onError: (error) => {\n      captureError(\"dev-tool-mount\", error);\n    },\n  });\n}\n\n/**\n * Mounts the Hexclave dev tool on the page.\n *\n * Visibility is determined by the `devTool` option:\n * - `true`: always show\n * - `false`: never show (caller gates this — mountDevTool won't be called)\n * - `\"auto\"` / `undefined`: show based on NODE_ENV or localhost/file: heuristics\n *\n * Console commands (also work in production):\n *   HexclaveDevTool.enable()  — force-show the dev tool\n *   HexclaveDevTool.disable() — force-hide the dev tool\n *   HexclaveDevTool.reset()   — revert to auto behavior\n */\nexport function mountDevTool(app: StackClientApp<true>, devToolOption?: boolean | \"auto\"): () => void {\n  activeApp = app;\n  activeDevToolOption = devToolOption === false ? undefined : devToolOption ?? undefined;\n  tryMount();\n\n  // Capture the cleanup created by THIS specific mount call so that React\n  // StrictMode's double-invoke doesn't let the first effect's cleanup tear\n  // down the second mount (which would cause the tool to disappear silently).\n  const myCleanup = activeCleanup;\n\n  return () => {\n    activeApp = null;\n    if (activeCleanup === myCleanup && myCleanup != null) {\n      activeCleanup = null;\n      myCleanup();\n    }\n  };\n}\n\n// Expose console commands: HexclaveDevTool.enable() / .disable() / .reset()\nif (typeof window !== 'undefined') {\n  // Hexclave rebrand: expose under both the legacy and new global names.\n  (window as any).HexclaveDevTool = (window as any).HexclaveDevTool = {\n    enable() {\n      try {\n        localStorage.setItem(OVERRIDE_KEY, 'true');\n      } catch {}\n      tryMount();\n      console.log('[Stack DevTool] Enabled. Refresh if the panel does not appear.');\n    },\n    disable() {\n      try {\n        localStorage.setItem(OVERRIDE_KEY, 'false');\n      } catch {}\n      if (activeCleanup) {\n        activeCleanup();\n        activeCleanup = null;\n      }\n      console.log('[Stack DevTool] Disabled.');\n    },\n    reset() {\n      try {\n        localStorage.removeItem(OVERRIDE_KEY);\n      } catch {}\n      if (shouldShow()) {\n        tryMount();\n      } else if (activeCleanup) {\n        activeCleanup();\n        activeCleanup = null;\n      }\n      console.log('[Stack DevTool] Reset to default (auto-detect based on NODE_ENV or localhost/file: origin).');\n    },\n  };\n}\n\n"],"mappings":";;;;;;AAcA,MAAM,eAAe;AAErB,SAAS,cAA8B;CACrC,IAAI;EACF,MAAM,MAAM,aAAa,QAAQ,YAAY;EAC7C,IAAI,QAAQ,QAAQ,OAAO;EAC3B,IAAI,QAAQ,SAAS,OAAO;CAC9B,QAAQ,CAAC;CACT,OAAO;AACT;AAEA,IAAI,sBAAiD,KAAA;AAErD,SAAS,aAAsB;CAC7B,MAAM,WAAW,YAAY;CAC7B,IAAI,aAAa,MAAM,OAAO;CAC9B,IAAI,CAAC,gBAAgB,GAAG,OAAO;CAG/B,IAAI,wBAAwB,MAAM,OAAO;CAGzC,MAAM,UAAU,QAAQ;CACxB,IAAI,YAAY,KAAA,GAEd,OAAO,YAAY;CAIrB,IAAI;EAEF,IAAI,IADY,IAAI,OAAO,SAAS,IAC9B,CAAC,CAAC,aAAa,SAAS,OAAO;CACvC,QAAQ,CAAC;CACT,OAAO,YAAY,OAAO,SAAS,IAAI;AACzC;AAEA,IAAI,gBAAqC;AACzC,IAAI,YAAyC;AAC7C,IAAI,kBAAkB;AAEtB,IAAI,uBAA+D;AACnE,SAAS,oBAAqD;CAC5D,IAAI,CAAC,sBACH,uBAAuB,OAAO,qBAAkB,CAAC,MAAK,MAAK,EAAE,aAAa,CAAC,CAAC,OAAO,QAAQ;EACzF,uBAAuB;EACvB,MAAM;CACR,CAAC;CAEH,OAAO;AACT;AAEA,SAAS,WAAW;CAClB,IAAI,eAAe;EACjB,cAAc;EACd,gBAAgB;CAClB;CAEA,IAAI,CAAC,WAAW,KAAK,CAAC,aAAa,CAAC,gBAAgB,GAAG;CAEvD,MAAM,aAAa,EAAE;CACrB,MAAM,MAAM;CAEZ,kBAAkB,YAAY;EAC5B,MAAM,gBAAgB,MAAM,kBAAkB;EAC9C,IAAI,eAAe,iBAAiB;EACpC,IAAI,CAAC,WAAW,KAAK,cAAc,OAAO,CAAC,gBAAgB,GAAG;EAC9D,gBAAgB,cAAc,GAAG;CACnC,GAAG;EACD,gBAAgB;EAChB,UAAU,UAAU;GAClB,aAAa,kBAAkB,KAAK;EACtC;CACF,CAAC;AACH;;;;;;;;;;;;;;AAeA,SAAgB,aAAa,KAA2B,eAA8C;CACpG,YAAY;CACZ,sBAAsB,kBAAkB,QAAQ,KAAA,IAAY,iBAAiB,KAAA;CAC7E,SAAS;CAKT,MAAM,YAAY;CAElB,aAAa;EACX,YAAY;EACZ,IAAI,kBAAkB,aAAa,aAAa,MAAM;GACpD,gBAAgB;GAChB,UAAU;EACZ;CACF;AACF;AAGA,IAAI,OAAO,WAAW,aAEpB,OAAgB,kBAAkB,OAAgB,kBAAkB;CAClE,SAAS;EACP,IAAI;GACF,aAAa,QAAQ,cAAc,MAAM;EAC3C,QAAQ,CAAC;EACT,SAAS;EACT,QAAQ,IAAI,gEAAgE;CAC9E;CACA,UAAU;EACR,IAAI;GACF,aAAa,QAAQ,cAAc,OAAO;EAC5C,QAAQ,CAAC;EACT,IAAI,eAAe;GACjB,cAAc;GACd,gBAAgB;EAClB;EACA,QAAQ,IAAI,2BAA2B;CACzC;CACA,QAAQ;EACN,IAAI;GACF,aAAa,WAAW,YAAY;EACtC,QAAQ,CAAC;EACT,IAAI,WAAW,GACb,SAAS;OACJ,IAAI,eAAe;GACxB,cAAc;GACd,gBAAgB;EAClB;EACA,QAAQ,IAAI,6FAA6F;CAC3G;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/dev-tool/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\nimport type { StackClientApp } from \"../lib/hexclave-app\";\nimport { captureError } from \"@hexclave/shared/dist/utils/errors\";\nimport { runAsynchronously } from \"@hexclave/shared/dist/utils/promises\";\nimport { isLocalhost } from \"@hexclave/shared/dist/utils/urls\";\nimport { canMountIntoDom } from \"../in-page-ui/dom\";\nimport { envVars } from \"../generated/env\";\nimport type { createDevTool as CreateDevToolFn } from \"./dev-tool-core\";\n\n// Hexclave rebrand: UI-only local pref — straight rename (one-time reset is harmless)\nconst OVERRIDE_KEY = '__hexclave-dev-tool-override';\n\nfunction getOverride(): boolean | null {\n  try {\n    const val = localStorage.getItem(OVERRIDE_KEY);\n    if (val === 'true') return true;\n    if (val === 'false') return false;\n  } catch {}\n  return null;\n}\n\nlet activeDevToolOption: true | \"auto\" | undefined = undefined;\nlet activeProjectIsDevelopmentEnvironment = false;\n\nfunction shouldShow(): boolean {\n  const override = getOverride();\n  if (override !== null) return override;\n  if (!canMountIntoDom()) return false;\n\n  // If devTool was explicitly set to true, always show\n  if (activeDevToolOption === true) return true;\n\n  // Development environment projects should expose the tool even when the\n  // consuming app itself was built or hosted as production.\n  if (activeProjectIsDevelopmentEnvironment) return true;\n\n  // \"auto\" behavior (the default):\n  const nodeEnv = envVars.NODE_ENV;\n  if (nodeEnv !== undefined) {\n    // NODE_ENV is available (bundler/process env exists) — only show in development\n    return nodeEnv === \"development\";\n  }\n\n  // NODE_ENV not found (no process.env/import.meta) — show on localhost or file: protocol\n  try {\n    const url = new URL(window.location.href);\n    if (url.protocol === \"file:\") return true;\n  } catch {}\n  return isLocalhost(window.location.href);\n}\n\nlet activeCleanup: (() => void) | null = null;\nlet activeApp: StackClientApp<true> | null = null;\nlet mountGeneration = 0;\n\nlet createDevToolPromise: Promise<typeof CreateDevToolFn> | null = null;\nfunction loadCreateDevTool(): Promise<typeof CreateDevToolFn> {\n  if (!createDevToolPromise) {\n    createDevToolPromise = import(\"./dev-tool-core\").then(m => m.createDevTool).catch((err) => {\n      createDevToolPromise = null;\n      throw err;\n    });\n  }\n  return createDevToolPromise;\n}\n\nfunction tryMount() {\n  if (activeCleanup) {\n    activeCleanup();\n    activeCleanup = null;\n  }\n\n  if (!shouldShow() || !activeApp || !canMountIntoDom()) return;\n\n  const generation = ++mountGeneration;\n  const app = activeApp;\n\n  runAsynchronously(async () => {\n    const createDevTool = await loadCreateDevTool();\n    if (generation !== mountGeneration) return;\n    if (!shouldShow() || activeApp !== app || !canMountIntoDom()) return;\n    activeCleanup = createDevTool(app);\n  }, {\n    noErrorLogging: true,\n    onError: (error) => {\n      captureError(\"dev-tool-mount\", error);\n    },\n  });\n}\n\n/**\n * Mounts the Hexclave dev tool on the page.\n *\n * Visibility is determined by the `devTool` option:\n * - `true`: always show\n * - `false`: never show (caller gates this — mountDevTool won't be called)\n * - `\"auto\"` / `undefined`: show based on NODE_ENV or localhost/file: heuristics\n *\n * Console commands (also work in production):\n *   HexclaveDevTool.enable()  — force-show the dev tool\n *   HexclaveDevTool.disable() — force-hide the dev tool\n *   HexclaveDevTool.reset()   — revert to auto behavior\n */\nexport function mountDevTool(app: StackClientApp<true>, devToolOption?: boolean | \"auto\"): () => void {\n  activeApp = app;\n  activeDevToolOption = devToolOption === false ? undefined : devToolOption ?? undefined;\n  activeProjectIsDevelopmentEnvironment = false;\n  tryMount();\n\n  // The project endpoint is also the source of config warnings, so this uses\n  // the backend's development-environment flag instead of inferring it from\n  // the SDK's build or the current page's origin.\n  queueMicrotask(() => {\n    runAsynchronously(async () => {\n      const project = await app.getProject();\n      if (activeApp !== app) return;\n      activeProjectIsDevelopmentEnvironment = project.isDevelopmentEnvironment;\n      if (activeProjectIsDevelopmentEnvironment && activeCleanup === null) {\n        tryMount();\n      }\n    }, {\n      noErrorLogging: true,\n      onError: (error) => {\n        captureError(\"dev-tool-project-detection\", error);\n      },\n    });\n  });\n\n  // Capture the cleanup created by THIS specific mount call so that React\n  // StrictMode's double-invoke doesn't let the first effect's cleanup tear\n  // down the second mount (which would cause the tool to disappear silently).\n  const myCleanup = activeCleanup;\n\n  return () => {\n    activeApp = null;\n    activeProjectIsDevelopmentEnvironment = false;\n    if (activeCleanup === myCleanup && myCleanup != null) {\n      activeCleanup = null;\n      myCleanup();\n    }\n  };\n}\n\n// Expose console commands: HexclaveDevTool.enable() / .disable() / .reset()\nif (typeof window !== 'undefined') {\n  // Hexclave rebrand: expose under both the legacy and new global names.\n  (window as any).HexclaveDevTool = (window as any).HexclaveDevTool = {\n    enable() {\n      try {\n        localStorage.setItem(OVERRIDE_KEY, 'true');\n      } catch {}\n      tryMount();\n      console.log('[Stack DevTool] Enabled. Refresh if the panel does not appear.');\n    },\n    disable() {\n      try {\n        localStorage.setItem(OVERRIDE_KEY, 'false');\n      } catch {}\n      if (activeCleanup) {\n        activeCleanup();\n        activeCleanup = null;\n      }\n      console.log('[Stack DevTool] Disabled.');\n    },\n    reset() {\n      try {\n        localStorage.removeItem(OVERRIDE_KEY);\n      } catch {}\n      if (shouldShow()) {\n        tryMount();\n      } else if (activeCleanup) {\n        activeCleanup();\n        activeCleanup = null;\n      }\n      console.log('[Stack DevTool] Reset to default (auto-detect based on project, NODE_ENV, or localhost/file: origin).');\n    },\n  };\n}\n\n"],"mappings":"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"}

package/dist/esm/dev-tool/index.test.d.ts

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

package/dist/esm/dev-tool/index.test.js

@@ -0,0 +1,41 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { StackClientApp } from "../lib/hexclave-app/index.js";
+import { createDevTool } from "./dev-tool-core.js";
+import { mountDevTool } from "./index.js";
+//#region src/dev-tool/index.test.ts
+vi.mock("./dev-tool-core", () => ({ createDevTool: vi.fn(() => () => {}) }));
+describe("dev tool visibility", () => {
+	afterEach(() => {
+		vi.unstubAllEnvs();
+		vi.unstubAllGlobals();
+		vi.clearAllMocks();
+	});
+	it("shows for a development environment project in a production-hosted app", async () => {
+		const app = new StackClientApp({
+			baseUrl: "https://api.example.com",
+			projectId: "00000000-0000-4000-8000-000000000000",
+			publishableClientKey: "stack-pk-test",
+			tokenStore: "memory",
+			redirectMethod: "none",
+			devTool: false
+		});
+		const getProject = vi.fn(async () => ({ isDevelopmentEnvironment: true }));
+		Reflect.set(app, "getProject", getProject);
+		vi.stubEnv("NODE_ENV", "production");
+		vi.stubGlobal("window", { location: { href: "https://example.com" } });
+		vi.stubGlobal("document", {
+			body: { appendChild: () => {} },
+			createElement: () => ({})
+		});
+		vi.stubGlobal("localStorage", { getItem: () => null });
+		mountDevTool(app);
+		await vi.waitFor(() => {
+			expect(getProject).toHaveBeenCalledOnce();
+			expect(createDevTool).toHaveBeenCalledOnce();
+		});
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=index.test.js.map

package/dist/esm/dev-tool/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","names":[],"sources":["../../../src/dev-tool/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//===========================================\nimport { afterEach, describe, expect, it, vi } from \"vitest\";\nimport { StackClientApp } from \"../lib/hexclave-app\";\nimport { createDevTool } from \"./dev-tool-core\";\nimport { mountDevTool } from \".\";\n\nvi.mock(\"./dev-tool-core\", () => ({\n  createDevTool: vi.fn(() => () => {}),\n}));\n\ndescribe(\"dev tool visibility\", () => {\n  afterEach(() => {\n    vi.unstubAllEnvs();\n    vi.unstubAllGlobals();\n    vi.clearAllMocks();\n  });\n\n  it(\"shows for a development environment project in a production-hosted app\", async () => {\n    const app = new StackClientApp({\n      baseUrl: \"https://api.example.com\",\n      projectId: \"00000000-0000-4000-8000-000000000000\",\n      publishableClientKey: \"stack-pk-test\",\n      tokenStore: \"memory\",\n      redirectMethod: \"none\",\n      devTool: false,\n    });\n    const getProject = vi.fn(async () => ({\n      isDevelopmentEnvironment: true,\n    }));\n    Reflect.set(app, \"getProject\", getProject);\n\n    vi.stubEnv(\"NODE_ENV\", \"production\");\n    vi.stubGlobal(\"window\", {\n      location: {\n        href: \"https://example.com\",\n      },\n    });\n    vi.stubGlobal(\"document\", {\n      body: {\n        appendChild: () => {},\n      },\n      createElement: () => ({}),\n    });\n    vi.stubGlobal(\"localStorage\", {\n      getItem: () => null,\n    });\n\n    mountDevTool(app);\n\n    await vi.waitFor(() => {\n      expect(getProject).toHaveBeenCalledOnce();\n      expect(createDevTool).toHaveBeenCalledOnce();\n    });\n  });\n});\n"],"mappings":";;;;;AASA,GAAG,KAAK,0BAA0B,EAChC,eAAe,GAAG,eAAe,CAAC,CAAC,EACrC,EAAE;AAEF,SAAS,6BAA6B;CACpC,gBAAgB;EACd,GAAG,cAAc;EACjB,GAAG,iBAAiB;EACpB,GAAG,cAAc;CACnB,CAAC;CAED,GAAG,0EAA0E,YAAY;EACvF,MAAM,MAAM,IAAI,eAAe;GAC7B,SAAS;GACT,WAAW;GACX,sBAAsB;GACtB,YAAY;GACZ,gBAAgB;GAChB,SAAS;EACX,CAAC;EACD,MAAM,aAAa,GAAG,GAAG,aAAa,EACpC,0BAA0B,KAC5B,EAAE;EACF,QAAQ,IAAI,KAAK,cAAc,UAAU;EAEzC,GAAG,QAAQ,YAAY,YAAY;EACnC,GAAG,WAAW,UAAU,EACtB,UAAU,EACR,MAAM,sBACR,EACF,CAAC;EACD,GAAG,WAAW,YAAY;GACxB,MAAM,EACJ,mBAAmB,CAAC,EACtB;GACA,sBAAsB,CAAC;EACzB,CAAC;EACD,GAAG,WAAW,gBAAgB,EAC5B,eAAe,KACjB,CAAC;EAED,aAAa,GAAG;EAEhB,MAAM,GAAG,cAAc;GACrB,OAAO,UAAU,CAAC,CAAC,qBAAqB;GACxC,OAAO,aAAa,CAAC,CAAC,qBAAqB;EAC7C,CAAC;CACH,CAAC;AACH,CAAC"}