@hexclave/shared 1.0.41 → 1.0.42

package/dist/esm/utils/dev-env-state-path.js

@@ -1,6 +1,5 @@
 import { join } from "path";
 import { homedir } from "os";
-
 //#region src/utils/dev-env-state-path.ts
 function defaultHexclaveDevEnvStatePath() {
 	if (process.platform === "win32") return join(process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local"), "Hexclave", "dev-envs.json");
@@ -9,7 +8,7 @@ function defaultHexclaveDevEnvStatePath() {
 function hexclaveDevEnvStatePath() {
 	return process.env.STACK_DEV_ENVS_PATH ?? defaultHexclaveDevEnvStatePath();
 }
-
 //#endregion
 export { defaultHexclaveDevEnvStatePath, hexclaveDevEnvStatePath };
+
 //# sourceMappingURL=dev-env-state-path.js.map

package/dist/esm/utils/dev-env-state-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-env-state-path.js","names":[],"sources":["../../../src/utils/dev-env-state-path.ts"],"sourcesContent":["import { homedir } from \"os\";\nimport { join } from \"path\";\n\nexport function defaultHexclaveDevEnvStatePath(): string {\n  if (process.platform === \"win32\") {\n    const localAppData = process.env.LOCALAPPDATA ?? join(homedir(), \"AppData\", \"Local\");\n    return join(localAppData, \"Hexclave\", \"dev-envs.json\");\n  }\n  return join(homedir(), \".stack\", \"dev-envs.json\");\n}\n\nexport function hexclaveDevEnvStatePath(): string {\n  return process.env.STACK_DEV_ENVS_PATH ?? defaultHexclaveDevEnvStatePath();\n}\n"],"mappings":";;;;AAGA,SAAgB,iCAAyC;AACvD,KAAI,QAAQ,aAAa,QAEvB,QAAO,KADc,QAAQ,IAAI,gBAAgB,KAAK,SAAS,EAAE,WAAW,QAAQ,EAC1D,YAAY,gBAAgB;AAExD,QAAO,KAAK,SAAS,EAAE,UAAU,gBAAgB;;AAGnD,SAAgB,0BAAkC;AAChD,QAAO,QAAQ,IAAI,uBAAuB,gCAAgC"}
+{"version":3,"file":"dev-env-state-path.js","names":[],"sources":["../../../src/utils/dev-env-state-path.ts"],"sourcesContent":["import { homedir } from \"os\";\nimport { join } from \"path\";\n\nexport function defaultHexclaveDevEnvStatePath(): string {\n  if (process.platform === \"win32\") {\n    const localAppData = process.env.LOCALAPPDATA ?? join(homedir(), \"AppData\", \"Local\");\n    return join(localAppData, \"Hexclave\", \"dev-envs.json\");\n  }\n  return join(homedir(), \".stack\", \"dev-envs.json\");\n}\n\nexport function hexclaveDevEnvStatePath(): string {\n  return process.env.STACK_DEV_ENVS_PATH ?? defaultHexclaveDevEnvStatePath();\n}\n"],"mappings":";;;AAGA,SAAgB,iCAAyC;CACvD,IAAI,QAAQ,aAAa,SAEvB,OAAO,KADc,QAAQ,IAAI,gBAAgB,KAAK,QAAQ,GAAG,WAAW,OAAO,GACzD,YAAY,eAAe;CAEvD,OAAO,KAAK,QAAQ,GAAG,UAAU,eAAe;AAClD;AAEA,SAAgB,0BAAkC;CAChD,OAAO,QAAQ,IAAI,uBAAuB,+BAA+B;AAC3E"}

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

@@ -1 +1 @@
-{"version":3,"file":"dev-tool.d.ts","names":[],"sources":["../../../src/utils/dev-tool.tsx"],"mappings":";;AAeA;;;;;AAQA;;;;;AAGA;;;;cAXa,gBAAA;AAcb;;;;;;AAAA,cANa,gBAAA;;cAGA,qBAAA;;cAGA,qBAAA"}
+{"version":3,"file":"dev-tool.d.ts","names":[],"sources":["../../../src/utils/dev-tool.tsx"],"mappings":";;AAeA;;;;AAA6B;AAQ7B;;;;AAA6B;AAG7B;;;;cAXa,gBAAA;AAcb;;;;AAAkC;;AAAlC,cANa,gBAAA;;cAGA,qBAAA;;cAGA,qBAAA"}

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

@@ -26,7 +26,7 @@ const CLICKMAP_ROOT_ID = "__hexclave-clickmap-root";
 const DEV_TOOL_CLASS_PREFIX = "sdt-";
 /** Legacy class marker still present on older dev-tool builds. */
 const DEV_TOOL_LEGACY_CLASS = "stack-devtool";
-
 //#endregion
 export { CLICKMAP_ROOT_ID, DEV_TOOL_CLASS_PREFIX, DEV_TOOL_LEGACY_CLASS, DEV_TOOL_ROOT_ID };
+
 //# sourceMappingURL=dev-tool.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","names":[],"sources":["../../../src/utils/dom.tsx"],"mappings":";iBAAgB,kBAAA,CAAmB,OAAA,EAAS,WAAA;AAA5C;;;;;AAAA,iBAagB,cAAA,CAAe,KAAA"}
+{"version":3,"file":"dom.d.ts","names":[],"sources":["../../../src/utils/dom.tsx"],"mappings":";iBAAgB,kBAAA,CAAmB,OAAoB,EAAX,WAAW;AAAvD;;;;AAAuD;AAAvD,iBAagB,cAAA,CAAe,KAAa"}

package/dist/esm/utils/dom.js

@@ -24,7 +24,7 @@ function cssEscapeIdent(value) {
 	}
 	return escaped;
 }
-
 //#endregion
 export { cssEscapeIdent, hasClickableParent };
+
 //# sourceMappingURL=dom.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"dom.js","names":[],"sources":["../../../src/utils/dom.tsx"],"sourcesContent":["export function hasClickableParent(element: HTMLElement): boolean {\n  const parent = element.parentElement;\n  if (!parent) return false;\n  if (parent.dataset.n2Clickable) return true;\n\n  return hasClickableParent(element.parentElement);\n}\n\n/**\n * Escape a string so it is safe to use as a CSS identifier (id/class) inside a selector.\n * Prefers the native `CSS.escape` when available, falling back to a conservative\n * backslash-escape for non-DOM environments (SSR, tests, older runtimes).\n */\nexport function cssEscapeIdent(value: string): string {\n  if (typeof CSS !== \"undefined\" && typeof CSS.escape === \"function\") {\n    return CSS.escape(value);\n  }\n\n  let escaped = \"\";\n  for (let i = 0; i < value.length; i += 1) {\n    const char = value.charAt(i);\n    const codeUnit = value.charCodeAt(i);\n\n    if (codeUnit === 0x0000) {\n      escaped += \"\\uFFFD\";\n    } else if (\n      (codeUnit >= 0x0001 && codeUnit <= 0x001f) ||\n      codeUnit === 0x007f ||\n      (i === 0 && codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (i === 1 && codeUnit >= 0x0030 && codeUnit <= 0x0039 && value.charCodeAt(0) === 0x002d)\n    ) {\n      escaped += `\\\\${codeUnit.toString(16)} `;\n    } else if (i === 0 && codeUnit === 0x002d && value.length === 1) {\n      escaped += \"\\\\-\";\n    } else if (\n      codeUnit >= 0x0080 ||\n      codeUnit === 0x002d ||\n      codeUnit === 0x005f ||\n      (codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (codeUnit >= 0x0041 && codeUnit <= 0x005a) ||\n      (codeUnit >= 0x0061 && codeUnit <= 0x007a)\n    ) {\n      escaped += char;\n    } else {\n      escaped += `\\\\${char}`;\n    }\n  }\n  return escaped;\n}\n"],"mappings":";AAAA,SAAgB,mBAAmB,SAA+B;CAChE,MAAM,SAAS,QAAQ;AACvB,KAAI,CAAC,OAAQ,QAAO;AACpB,KAAI,OAAO,QAAQ,YAAa,QAAO;AAEvC,QAAO,mBAAmB,QAAQ,cAAc;;;;;;;AAQlD,SAAgB,eAAe,OAAuB;AACpD,KAAI,OAAO,QAAQ,eAAe,OAAO,IAAI,WAAW,WACtD,QAAO,IAAI,OAAO,MAAM;CAG1B,IAAI,UAAU;AACd,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxC,MAAM,OAAO,MAAM,OAAO,EAAE;EAC5B,MAAM,WAAW,MAAM,WAAW,EAAE;AAEpC,MAAI,aAAa,EACf,YAAW;WAEV,YAAY,KAAU,YAAY,MACnC,aAAa,OACZ,MAAM,KAAK,YAAY,MAAU,YAAY,MAC7C,MAAM,KAAK,YAAY,MAAU,YAAY,MAAU,MAAM,WAAW,EAAE,KAAK,GAEhF,YAAW,KAAK,SAAS,SAAS,GAAG,CAAC;WAC7B,MAAM,KAAK,aAAa,MAAU,MAAM,WAAW,EAC5D,YAAW;WAEX,YAAY,OACZ,aAAa,MACb,aAAa,MACZ,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,IAEnC,YAAW;MAEX,YAAW,KAAK;;AAGpB,QAAO"}
+{"version":3,"file":"dom.js","names":[],"sources":["../../../src/utils/dom.tsx"],"sourcesContent":["export function hasClickableParent(element: HTMLElement): boolean {\n  const parent = element.parentElement;\n  if (!parent) return false;\n  if (parent.dataset.n2Clickable) return true;\n\n  return hasClickableParent(element.parentElement);\n}\n\n/**\n * Escape a string so it is safe to use as a CSS identifier (id/class) inside a selector.\n * Prefers the native `CSS.escape` when available, falling back to a conservative\n * backslash-escape for non-DOM environments (SSR, tests, older runtimes).\n */\nexport function cssEscapeIdent(value: string): string {\n  if (typeof CSS !== \"undefined\" && typeof CSS.escape === \"function\") {\n    return CSS.escape(value);\n  }\n\n  let escaped = \"\";\n  for (let i = 0; i < value.length; i += 1) {\n    const char = value.charAt(i);\n    const codeUnit = value.charCodeAt(i);\n\n    if (codeUnit === 0x0000) {\n      escaped += \"\\uFFFD\";\n    } else if (\n      (codeUnit >= 0x0001 && codeUnit <= 0x001f) ||\n      codeUnit === 0x007f ||\n      (i === 0 && codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (i === 1 && codeUnit >= 0x0030 && codeUnit <= 0x0039 && value.charCodeAt(0) === 0x002d)\n    ) {\n      escaped += `\\\\${codeUnit.toString(16)} `;\n    } else if (i === 0 && codeUnit === 0x002d && value.length === 1) {\n      escaped += \"\\\\-\";\n    } else if (\n      codeUnit >= 0x0080 ||\n      codeUnit === 0x002d ||\n      codeUnit === 0x005f ||\n      (codeUnit >= 0x0030 && codeUnit <= 0x0039) ||\n      (codeUnit >= 0x0041 && codeUnit <= 0x005a) ||\n      (codeUnit >= 0x0061 && codeUnit <= 0x007a)\n    ) {\n      escaped += char;\n    } else {\n      escaped += `\\\\${char}`;\n    }\n  }\n  return escaped;\n}\n"],"mappings":";AAAA,SAAgB,mBAAmB,SAA+B;CAChE,MAAM,SAAS,QAAQ;CACvB,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,QAAQ,aAAa,OAAO;CAEvC,OAAO,mBAAmB,QAAQ,aAAa;AACjD;;;;;;AAOA,SAAgB,eAAe,OAAuB;CACpD,IAAI,OAAO,QAAQ,eAAe,OAAO,IAAI,WAAW,YACtD,OAAO,IAAI,OAAO,KAAK;CAGzB,IAAI,UAAU;CACd,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,GAAG;EACxC,MAAM,OAAO,MAAM,OAAO,CAAC;EAC3B,MAAM,WAAW,MAAM,WAAW,CAAC;EAEnC,IAAI,aAAa,GACf,WAAW;OACN,IACJ,YAAY,KAAU,YAAY,MACnC,aAAa,OACZ,MAAM,KAAK,YAAY,MAAU,YAAY,MAC7C,MAAM,KAAK,YAAY,MAAU,YAAY,MAAU,MAAM,WAAW,CAAC,MAAM,IAEhF,WAAW,KAAK,SAAS,SAAS,EAAE,EAAE;OACjC,IAAI,MAAM,KAAK,aAAa,MAAU,MAAM,WAAW,GAC5D,WAAW;OACN,IACL,YAAY,OACZ,aAAa,MACb,aAAa,MACZ,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,MAClC,YAAY,MAAU,YAAY,KAEnC,WAAW;OAEX,WAAW,KAAK;CAEpB;CACA,OAAO;AACT"}

package/dist/esm/utils/elements-chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elements-chain.d.ts","names":[],"sources":["../../../src/utils/elements-chain.tsx"],"mappings":";;AAeA;;;;;;;;;;;;;KAAY,oBAAA;EACV,GAAA;EACA,OAAA;EACA,KAAA,EAAO,MAAA;EACP,IAAA;EACA,QAAA;EACA,SAAA;EACA,IAAA;AAAA;AAAA,cAGW,wBAAA;AAAA,cACA,uBAAA;AAAA,cACA,uBAAA;AAAA,cAKA,oBAAA;;;;AAAb;iBAyFgB,kBAAA,CAAmB,OAAA,EAAS,OAAA;;iBA0K5B,kBAAA,CAAmB,KAAA,WAAgB,oBAAA"}
+{"version":3,"file":"elements-chain.d.ts","names":[],"sources":["../../../src/utils/elements-chain.tsx"],"mappings":";;AAeA;;;;;;;;;;;;;KAAY,oBAAA;EACV,GAAA;EACA,OAAA;EACA,KAAA,EAAO,MAAM;EACb,IAAA;EACA,QAAA;EACA,SAAA;EACA,IAAA;AAAA;AAAA,cAGW,wBAAA;AAAA,cACA,uBAAA;AAAA,cACA,uBAAA;AAAA,cAKA,oBAAA;;;AALuB;AAKpC;iBAyFgB,kBAAA,CAAmB,OAAgB,EAAP,OAAO;;iBA0KnC,kBAAA,CAAmB,KAAA,WAAgB,oBAAoB"}

package/dist/esm/utils/elements-chain.js

@@ -45,7 +45,7 @@ function serializeElementsChainSegment(element) {
 	parts.push(element.tagName.toLowerCase());
 	const classes = getElementClasses(element);
 	if (classes.length > 0) parts.push(`.${classes.map(escapeElementsChainClass).join(".")}`);
-	const text = element.textContent.trim().replace(/\s+/g, " ").slice(0, ELEMENTS_CHAIN_TEXT_MAX);
+	const text = element.textContent.trim().replace(/\s+/g, " ").slice(0, 80);
 	const nthChild = getNthChildIndex(element);
 	const nthOfType = getNthOfTypeIndex(element);
 	const attrPairs = [];
@@ -55,11 +55,11 @@ function serializeElementsChainSegment(element) {
 	for (const attrName of ELEMENTS_CHAIN_ATTRS) {
 		const value = element.getAttribute(attrName);
 		if (value == null || value === "") continue;
-		attrPairs.push(`attr__${attrName}="${escapeElementsChainValue(value.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}"`);
+		attrPairs.push(`attr__${attrName}="${escapeElementsChainValue(value.slice(0, 200))}"`);
 	}
 	if (element.tagName === "A") {
 		const href = element.getAttribute("href");
-		if (href != null && href !== "") attrPairs.push(`href="${escapeElementsChainValue(href.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}"`);
+		if (href != null && href !== "") attrPairs.push(`href="${escapeElementsChainValue(href.slice(0, 200))}"`);
 	}
 	if (attrPairs.length > 0) parts.push(`:${attrPairs.join(":")}`);
 	return parts.join("");
@@ -72,7 +72,7 @@ function buildElementsChain(element) {
 	const segments = [];
 	let current = element;
 	let depth = 0;
-	while (current != null && depth < ELEMENTS_CHAIN_MAX_DEPTH && current !== document.documentElement) {
+	while (current != null && depth < 8 && current !== document.documentElement) {
 		segments.push(serializeElementsChainSegment(current));
 		current = current.parentElement;
 		depth += 1;
@@ -246,52 +246,7 @@ function parseElementsChain(chain) {
 	if (current.length > 0) segments.push(current);
 	return segments.map(parseElementsChainSegment).filter((segment) => segment != null);
 }
-(void 0)?.test("parseElementsChain parses a simple leaf+ancestor chain", ({ expect }) => {
-	expect(parseElementsChain("button.btn.btn-primary:nth-of-type=\"1\":text=\"Save\":attr__id=\"save-btn\";div.container")).toEqual([{
-		tag: "button",
-		classes: ["btn", "btn-primary"],
-		attrs: { id: "save-btn" },
-		text: "Save",
-		nthChild: null,
-		nthOfType: 1,
-		href: null
-	}, {
-		tag: "div",
-		classes: ["container"],
-		attrs: {},
-		text: null,
-		nthChild: null,
-		nthOfType: null,
-		href: null
-	}]);
-});
-(void 0)?.test("parseElementsChain reverses class escaping for Tailwind-style tokens", ({ expect }) => {
-	expect(parseElementsChain("a.md\\:hover\\:bg-blue-500.w-\\[1\\.5rem\\]:href=\"/p?a=1\"")).toEqual([{
-		tag: "a",
-		classes: ["md:hover:bg-blue-500", "w-[1.5rem]"],
-		attrs: { href: "/p?a=1" },
-		text: null,
-		nthChild: null,
-		nthOfType: null,
-		href: "/p?a=1"
-	}]);
-});
-(void 0)?.test("parseElementsChain unescapes quotes/backslashes and ignores ';' inside quoted values", ({ expect }) => {
-	expect(parseElementsChain("span:text=\"a \\\"b\\\"; c \\\\ d\"")).toEqual([{
-		tag: "span",
-		classes: [],
-		attrs: {},
-		text: "a \"b\"; c \\ d",
-		nthChild: null,
-		nthOfType: null,
-		href: null
-	}]);
-});
-(void 0)?.test("parseElementsChain drops empty/tagless segments", ({ expect }) => {
-	expect(parseElementsChain("")).toEqual([]);
-	expect(parseElementsChain(";;")).toEqual([]);
-});
-
 //#endregion
 export { ELEMENTS_CHAIN_ATTRS, ELEMENTS_CHAIN_ATTR_MAX, ELEMENTS_CHAIN_MAX_DEPTH, ELEMENTS_CHAIN_TEXT_MAX, buildElementsChain, parseElementsChain };
+
 //# sourceMappingURL=elements-chain.js.map

package/dist/esm/utils/elements-chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"elements-chain.js","names":[],"sources":["../../../src/utils/elements-chain.tsx"],"sourcesContent":["/**\n * PostHog-style `elements_chain` format — the single owner of both halves of the\n * contract. The event tracker {@link buildElementsChain serializes} a clicked\n * element (and its ancestors) into a string; the clickmap overlay\n * {@link parseElementsChain parses} that string back into structured segments so\n * it can re-locate the element in a live DOM.\n *\n * Encode and decode MUST round-trip exactly, which is why they live together:\n * the escaping applied here on the write side is reversed by the parser below,\n * and a single round-trip test in `elements-chain.test.tsx` guards the pair.\n *\n * Segment shape (leaf-first, joined by `;`):\n *   tag.class1.class2:nth-child=\"2\":nth-of-type=\"1\":text=\"Save\":attr__id=\"x\":href=\"...\"\n */\n\nexport type ElementsChainSegment = {\n  tag: string,\n  classes: string[],\n  attrs: Record<string, string>,\n  text: string | null,\n  nthChild: number | null,\n  nthOfType: number | null,\n  href: string | null,\n};\n\nexport const ELEMENTS_CHAIN_MAX_DEPTH = 8;\nexport const ELEMENTS_CHAIN_TEXT_MAX = 80;\nexport const ELEMENTS_CHAIN_ATTR_MAX = 200;\n\n// Attributes we serialise into elements_chain. Mirrors the set PostHog persists:\n// stable identifiers (id, data-testid), semantics (role, type, name, aria-label),\n// and a few we expect downstream tooling to want to match against.\nexport const ELEMENTS_CHAIN_ATTRS = [\n  \"id\",\n  \"data-testid\",\n  \"data-test-id\",\n  \"data-hexclave-id\",\n  \"name\",\n  \"type\",\n  \"role\",\n  \"aria-label\",\n  \"placeholder\",\n  \"title\",\n] as const;\n\n// ---------------------------------------------------------------------------\n// Serialization (DOM element -> elements_chain string)\n// ---------------------------------------------------------------------------\n\nfunction escapeElementsChainValue(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"');\n}\n\n// Class tokens are written into the unquoted, dot-joined prefix of a segment, so\n// any \".\" or \":\" inside a class (e.g. Tailwind variants like `md:hover:bg-blue-500`\n// or arbitrary values like `w-[1.5rem]`) must be escaped to round-trip through the\n// parser, which splits the prefix on unescaped \".\" and the segment on unescaped \":\".\nfunction escapeElementsChainClass(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\./g, \"\\\\.\").replace(/:/g, \"\\\\:\");\n}\n\nfunction getElementClasses(element: Element): string[] {\n  const className = (element as HTMLElement).className;\n  if (typeof className !== \"string\" || className.trim() === \"\") {\n    return [];\n  }\n  return className.trim().split(/\\s+/).filter(Boolean).slice(0, 4);\n}\n\nfunction getNthChildIndex(element: Element): number | null {\n  const parent = element.parentElement;\n  if (parent == null) return null;\n  const index = Array.prototype.indexOf.call(parent.children, element);\n  return index >= 0 ? index + 1 : null;\n}\n\nfunction getNthOfTypeIndex(element: Element): number | null {\n  const parent = element.parentElement;\n  if (parent == null) return null;\n  const tagName = element.tagName;\n  const siblings = Array.from(parent.children).filter((child) => child.tagName === tagName);\n  if (siblings.length <= 1) return null;\n  const index = siblings.indexOf(element);\n  return index >= 0 ? index + 1 : null;\n}\n\nfunction serializeElementsChainSegment(element: Element): string {\n  const parts: string[] = [];\n  parts.push(element.tagName.toLowerCase());\n  const classes = getElementClasses(element);\n  if (classes.length > 0) {\n    parts.push(`.${classes.map(escapeElementsChainClass).join(\".\")}`);\n  }\n  const text = element.textContent.trim().replace(/\\s+/g, \" \").slice(0, ELEMENTS_CHAIN_TEXT_MAX);\n  const nthChild = getNthChildIndex(element);\n  const nthOfType = getNthOfTypeIndex(element);\n  const attrPairs: string[] = [];\n  if (nthChild != null) attrPairs.push(`nth-child=\"${nthChild}\"`);\n  if (nthOfType != null) attrPairs.push(`nth-of-type=\"${nthOfType}\"`);\n  if (text !== \"\") attrPairs.push(`text=\"${escapeElementsChainValue(text)}\"`);\n  for (const attrName of ELEMENTS_CHAIN_ATTRS) {\n    const value = element.getAttribute(attrName);\n    if (value == null || value === \"\") continue;\n    attrPairs.push(`attr__${attrName}=\"${escapeElementsChainValue(value.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}\"`);\n  }\n  if (element.tagName === \"A\") {\n    const href = element.getAttribute(\"href\");\n    if (href != null && href !== \"\") {\n      attrPairs.push(`href=\"${escapeElementsChainValue(href.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}\"`);\n    }\n  }\n  if (attrPairs.length > 0) {\n    parts.push(`:${attrPairs.join(\":\")}`);\n  }\n  return parts.join(\"\");\n}\n\n/**\n * Serialise a clicked element and up to {@link ELEMENTS_CHAIN_MAX_DEPTH}\n * ancestors (leaf-first) into an `elements_chain` string.\n */\nexport function buildElementsChain(element: Element): string {\n  const segments: string[] = [];\n  let current: Element | null = element;\n  let depth = 0;\n  while (current != null && depth < ELEMENTS_CHAIN_MAX_DEPTH && current !== document.documentElement) {\n    segments.push(serializeElementsChainSegment(current));\n    current = current.parentElement;\n    depth += 1;\n  }\n  return segments.join(\";\");\n}\n\n// ---------------------------------------------------------------------------\n// Parsing (elements_chain string -> structured segments)\n// ---------------------------------------------------------------------------\n\n// Split a string on unescaped occurrences of `.`, unescaping `\\.`, `\\:` and `\\\\`\n// back to their literal characters. Reverses `escapeElementsChainClass`.\nfunction splitEscapedDots(input: string): string[] {\n  const out: string[] = [];\n  let cur = '';\n  for (let i = 0; i < input.length; i++) {\n    const ch = input[i];\n    if (ch === '\\\\' && i + 1 < input.length) {\n      cur += input[i + 1];\n      i += 1;\n      continue;\n    }\n    if (ch === '.') {\n      out.push(cur);\n      cur = '';\n      continue;\n    }\n    cur += ch;\n  }\n  out.push(cur);\n  return out;\n}\n\ntype ElementsChainAttrResult = {\n  nthChild?: number,\n  nthOfType?: number,\n  text?: string,\n  href?: string,\n  attrKey?: string,\n  attrValue?: string,\n};\n\nfunction applyElementsChainAttr(key: string, value: string): ElementsChainAttrResult {\n  if (key === 'nth-child') {\n    const n = Number.parseInt(value, 10);\n    return Number.isFinite(n) ? { nthChild: n } : {};\n  }\n  if (key === 'nth-of-type') {\n    const n = Number.parseInt(value, 10);\n    return Number.isFinite(n) ? { nthOfType: n } : {};\n  }\n  if (key === 'text') {\n    return { text: value };\n  }\n  if (key === 'href') {\n    return { href: value, attrKey: key, attrValue: value };\n  }\n  if (key.startsWith('attr__')) {\n    return { attrKey: key.slice('attr__'.length), attrValue: value };\n  }\n  return { attrKey: key, attrValue: value };\n}\n\nfunction parseElementsChainSegment(segment: string): ElementsChainSegment | null {\n  const trimmed = segment.trim();\n  if (trimmed === '') return null;\n\n  // Find first ':' at top level — separates tag/classes prefix from attribute pairs.\n  let prefixEnd = trimmed.length;\n  let inQuotes = false;\n  for (let i = 0; i < trimmed.length; i++) {\n    const ch = trimmed[i];\n    if (ch === '\\\\' && i + 1 < trimmed.length) {\n      i += 1;\n      continue;\n    }\n    if (ch === '\"') {\n      inQuotes = !inQuotes;\n      continue;\n    }\n    if (ch === ':' && !inQuotes) {\n      prefixEnd = i;\n      break;\n    }\n  }\n\n  const prefix = trimmed.slice(0, prefixEnd);\n  const rest = trimmed.slice(prefixEnd);\n  const prefixParts = splitEscapedDots(prefix);\n  const tag = prefixParts[0].trim().toLowerCase();\n  if (tag === '') return null;\n  const classes = prefixParts.slice(1).map((c) => c.trim()).filter((c) => c !== '');\n\n  const attrs: Record<string, string> = {};\n  let nthChild: number | null = null;\n  let nthOfType: number | null = null;\n  let text: string | null = null;\n  let href: string | null = null;\n\n  // Parse :key=\"value\" pairs from rest.\n  let i = 0;\n  while (i < rest.length) {\n    if (rest[i] !== ':') {\n      i += 1;\n      continue;\n    }\n    i += 1; // skip ':'\n    // read key up to '='\n    let keyEnd = i;\n    while (keyEnd < rest.length && rest[keyEnd] !== '=' && rest[keyEnd] !== ':') keyEnd += 1;\n    const key = rest.slice(i, keyEnd).trim();\n    if (keyEnd >= rest.length || rest[keyEnd] !== '=') {\n      i = keyEnd;\n      continue;\n    }\n    let valStart = keyEnd + 1;\n    if (rest[valStart] !== '\"') {\n      // unquoted — read until next ':' at top level\n      let end = valStart;\n      while (end < rest.length && rest[end] !== ':') end += 1;\n      const value = rest.slice(valStart, end);\n      const result = applyElementsChainAttr(key, value);\n      if (result.nthChild != null) nthChild = result.nthChild;\n      if (result.nthOfType != null) nthOfType = result.nthOfType;\n      if (result.text != null) text = result.text;\n      if (result.href != null) href = result.href;\n      if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? '';\n      i = end;\n      continue;\n    }\n    // quoted value — find unescaped closing quote\n    valStart += 1;\n    let end = valStart;\n    let value = '';\n    while (end < rest.length) {\n      const ch = rest[end];\n      if (ch === '\\\\' && end + 1 < rest.length) {\n        const next = rest[end + 1];\n        if (next === '\"' || next === '\\\\') {\n          value += next;\n          end += 2;\n          continue;\n        }\n        value += ch;\n        end += 1;\n        continue;\n      }\n      if (ch === '\"') break;\n      value += ch;\n      end += 1;\n    }\n    const result = applyElementsChainAttr(key, value);\n    if (result.nthChild != null) nthChild = result.nthChild;\n    if (result.nthOfType != null) nthOfType = result.nthOfType;\n    if (result.text != null) text = result.text;\n    if (result.href != null) href = result.href;\n    if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? '';\n    i = end + 1; // skip closing quote\n  }\n\n  return { tag, classes, attrs, text, nthChild, nthOfType, href };\n}\n\n/** Parse an `elements_chain` string into structured, leaf-first segments. */\nexport function parseElementsChain(chain: string): ElementsChainSegment[] {\n  // Split top-level by ';' respecting quoted strings.\n  const segments: string[] = [];\n  let current = '';\n  let inQuotes = false;\n  for (let i = 0; i < chain.length; i++) {\n    const ch = chain[i];\n    if (ch === '\\\\' && i + 1 < chain.length) {\n      current += ch + chain[i + 1];\n      i += 1;\n      continue;\n    }\n    if (ch === '\"') {\n      inQuotes = !inQuotes;\n      current += ch;\n      continue;\n    }\n    if (ch === ';' && !inQuotes) {\n      segments.push(current);\n      current = '';\n      continue;\n    }\n    current += ch;\n  }\n  if (current.length > 0) {\n    segments.push(current);\n  }\n  return segments.map(parseElementsChainSegment).filter((segment): segment is ElementsChainSegment => segment != null);\n}\n\nimport.meta.vitest?.test(\"parseElementsChain parses a simple leaf+ancestor chain\", ({ expect }) => {\n  const parsed = parseElementsChain('button.btn.btn-primary:nth-of-type=\"1\":text=\"Save\":attr__id=\"save-btn\";div.container');\n  expect(parsed).toEqual([\n    { tag: \"button\", classes: [\"btn\", \"btn-primary\"], attrs: { id: \"save-btn\" }, text: \"Save\", nthChild: null, nthOfType: 1, href: null },\n    { tag: \"div\", classes: [\"container\"], attrs: {}, text: null, nthChild: null, nthOfType: null, href: null },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain reverses class escaping for Tailwind-style tokens\", ({ expect }) => {\n  // `md:hover:bg-blue-500` and `w-[1.5rem]` contain the prefix delimiters `:`/`.`,\n  // so the serializer escapes them; the parser must recover the literal classes.\n  const parsed = parseElementsChain('a.md\\\\:hover\\\\:bg-blue-500.w-\\\\[1\\\\.5rem\\\\]:href=\"/p?a=1\"');\n  expect(parsed).toEqual([\n    { tag: \"a\", classes: [\"md:hover:bg-blue-500\", \"w-[1.5rem]\"], attrs: { href: \"/p?a=1\" }, text: null, nthChild: null, nthOfType: null, href: \"/p?a=1\" },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain unescapes quotes/backslashes and ignores ';' inside quoted values\", ({ expect }) => {\n  const parsed = parseElementsChain('span:text=\"a \\\\\"b\\\\\"; c \\\\\\\\ d\"');\n  expect(parsed).toEqual([\n    { tag: \"span\", classes: [], attrs: {}, text: 'a \"b\"; c \\\\ d', nthChild: null, nthOfType: null, href: null },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain drops empty/tagless segments\", ({ expect }) => {\n  expect(parseElementsChain(\"\")).toEqual([]);\n  expect(parseElementsChain(\";;\")).toEqual([]);\n});\n"],"mappings":"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"}
+{"version":3,"file":"elements-chain.js","names":[],"sources":["../../../src/utils/elements-chain.tsx"],"sourcesContent":["/**\n * PostHog-style `elements_chain` format — the single owner of both halves of the\n * contract. The event tracker {@link buildElementsChain serializes} a clicked\n * element (and its ancestors) into a string; the clickmap overlay\n * {@link parseElementsChain parses} that string back into structured segments so\n * it can re-locate the element in a live DOM.\n *\n * Encode and decode MUST round-trip exactly, which is why they live together:\n * the escaping applied here on the write side is reversed by the parser below,\n * and a single round-trip test in `elements-chain.test.tsx` guards the pair.\n *\n * Segment shape (leaf-first, joined by `;`):\n *   tag.class1.class2:nth-child=\"2\":nth-of-type=\"1\":text=\"Save\":attr__id=\"x\":href=\"...\"\n */\n\nexport type ElementsChainSegment = {\n  tag: string,\n  classes: string[],\n  attrs: Record<string, string>,\n  text: string | null,\n  nthChild: number | null,\n  nthOfType: number | null,\n  href: string | null,\n};\n\nexport const ELEMENTS_CHAIN_MAX_DEPTH = 8;\nexport const ELEMENTS_CHAIN_TEXT_MAX = 80;\nexport const ELEMENTS_CHAIN_ATTR_MAX = 200;\n\n// Attributes we serialise into elements_chain. Mirrors the set PostHog persists:\n// stable identifiers (id, data-testid), semantics (role, type, name, aria-label),\n// and a few we expect downstream tooling to want to match against.\nexport const ELEMENTS_CHAIN_ATTRS = [\n  \"id\",\n  \"data-testid\",\n  \"data-test-id\",\n  \"data-hexclave-id\",\n  \"name\",\n  \"type\",\n  \"role\",\n  \"aria-label\",\n  \"placeholder\",\n  \"title\",\n] as const;\n\n// ---------------------------------------------------------------------------\n// Serialization (DOM element -> elements_chain string)\n// ---------------------------------------------------------------------------\n\nfunction escapeElementsChainValue(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\"/g, '\\\\\"');\n}\n\n// Class tokens are written into the unquoted, dot-joined prefix of a segment, so\n// any \".\" or \":\" inside a class (e.g. Tailwind variants like `md:hover:bg-blue-500`\n// or arbitrary values like `w-[1.5rem]`) must be escaped to round-trip through the\n// parser, which splits the prefix on unescaped \".\" and the segment on unescaped \":\".\nfunction escapeElementsChainClass(value: string): string {\n  return value.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\./g, \"\\\\.\").replace(/:/g, \"\\\\:\");\n}\n\nfunction getElementClasses(element: Element): string[] {\n  const className = (element as HTMLElement).className;\n  if (typeof className !== \"string\" || className.trim() === \"\") {\n    return [];\n  }\n  return className.trim().split(/\\s+/).filter(Boolean).slice(0, 4);\n}\n\nfunction getNthChildIndex(element: Element): number | null {\n  const parent = element.parentElement;\n  if (parent == null) return null;\n  const index = Array.prototype.indexOf.call(parent.children, element);\n  return index >= 0 ? index + 1 : null;\n}\n\nfunction getNthOfTypeIndex(element: Element): number | null {\n  const parent = element.parentElement;\n  if (parent == null) return null;\n  const tagName = element.tagName;\n  const siblings = Array.from(parent.children).filter((child) => child.tagName === tagName);\n  if (siblings.length <= 1) return null;\n  const index = siblings.indexOf(element);\n  return index >= 0 ? index + 1 : null;\n}\n\nfunction serializeElementsChainSegment(element: Element): string {\n  const parts: string[] = [];\n  parts.push(element.tagName.toLowerCase());\n  const classes = getElementClasses(element);\n  if (classes.length > 0) {\n    parts.push(`.${classes.map(escapeElementsChainClass).join(\".\")}`);\n  }\n  const text = element.textContent.trim().replace(/\\s+/g, \" \").slice(0, ELEMENTS_CHAIN_TEXT_MAX);\n  const nthChild = getNthChildIndex(element);\n  const nthOfType = getNthOfTypeIndex(element);\n  const attrPairs: string[] = [];\n  if (nthChild != null) attrPairs.push(`nth-child=\"${nthChild}\"`);\n  if (nthOfType != null) attrPairs.push(`nth-of-type=\"${nthOfType}\"`);\n  if (text !== \"\") attrPairs.push(`text=\"${escapeElementsChainValue(text)}\"`);\n  for (const attrName of ELEMENTS_CHAIN_ATTRS) {\n    const value = element.getAttribute(attrName);\n    if (value == null || value === \"\") continue;\n    attrPairs.push(`attr__${attrName}=\"${escapeElementsChainValue(value.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}\"`);\n  }\n  if (element.tagName === \"A\") {\n    const href = element.getAttribute(\"href\");\n    if (href != null && href !== \"\") {\n      attrPairs.push(`href=\"${escapeElementsChainValue(href.slice(0, ELEMENTS_CHAIN_ATTR_MAX))}\"`);\n    }\n  }\n  if (attrPairs.length > 0) {\n    parts.push(`:${attrPairs.join(\":\")}`);\n  }\n  return parts.join(\"\");\n}\n\n/**\n * Serialise a clicked element and up to {@link ELEMENTS_CHAIN_MAX_DEPTH}\n * ancestors (leaf-first) into an `elements_chain` string.\n */\nexport function buildElementsChain(element: Element): string {\n  const segments: string[] = [];\n  let current: Element | null = element;\n  let depth = 0;\n  while (current != null && depth < ELEMENTS_CHAIN_MAX_DEPTH && current !== document.documentElement) {\n    segments.push(serializeElementsChainSegment(current));\n    current = current.parentElement;\n    depth += 1;\n  }\n  return segments.join(\";\");\n}\n\n// ---------------------------------------------------------------------------\n// Parsing (elements_chain string -> structured segments)\n// ---------------------------------------------------------------------------\n\n// Split a string on unescaped occurrences of `.`, unescaping `\\.`, `\\:` and `\\\\`\n// back to their literal characters. Reverses `escapeElementsChainClass`.\nfunction splitEscapedDots(input: string): string[] {\n  const out: string[] = [];\n  let cur = '';\n  for (let i = 0; i < input.length; i++) {\n    const ch = input[i];\n    if (ch === '\\\\' && i + 1 < input.length) {\n      cur += input[i + 1];\n      i += 1;\n      continue;\n    }\n    if (ch === '.') {\n      out.push(cur);\n      cur = '';\n      continue;\n    }\n    cur += ch;\n  }\n  out.push(cur);\n  return out;\n}\n\ntype ElementsChainAttrResult = {\n  nthChild?: number,\n  nthOfType?: number,\n  text?: string,\n  href?: string,\n  attrKey?: string,\n  attrValue?: string,\n};\n\nfunction applyElementsChainAttr(key: string, value: string): ElementsChainAttrResult {\n  if (key === 'nth-child') {\n    const n = Number.parseInt(value, 10);\n    return Number.isFinite(n) ? { nthChild: n } : {};\n  }\n  if (key === 'nth-of-type') {\n    const n = Number.parseInt(value, 10);\n    return Number.isFinite(n) ? { nthOfType: n } : {};\n  }\n  if (key === 'text') {\n    return { text: value };\n  }\n  if (key === 'href') {\n    return { href: value, attrKey: key, attrValue: value };\n  }\n  if (key.startsWith('attr__')) {\n    return { attrKey: key.slice('attr__'.length), attrValue: value };\n  }\n  return { attrKey: key, attrValue: value };\n}\n\nfunction parseElementsChainSegment(segment: string): ElementsChainSegment | null {\n  const trimmed = segment.trim();\n  if (trimmed === '') return null;\n\n  // Find first ':' at top level — separates tag/classes prefix from attribute pairs.\n  let prefixEnd = trimmed.length;\n  let inQuotes = false;\n  for (let i = 0; i < trimmed.length; i++) {\n    const ch = trimmed[i];\n    if (ch === '\\\\' && i + 1 < trimmed.length) {\n      i += 1;\n      continue;\n    }\n    if (ch === '\"') {\n      inQuotes = !inQuotes;\n      continue;\n    }\n    if (ch === ':' && !inQuotes) {\n      prefixEnd = i;\n      break;\n    }\n  }\n\n  const prefix = trimmed.slice(0, prefixEnd);\n  const rest = trimmed.slice(prefixEnd);\n  const prefixParts = splitEscapedDots(prefix);\n  const tag = prefixParts[0].trim().toLowerCase();\n  if (tag === '') return null;\n  const classes = prefixParts.slice(1).map((c) => c.trim()).filter((c) => c !== '');\n\n  const attrs: Record<string, string> = {};\n  let nthChild: number | null = null;\n  let nthOfType: number | null = null;\n  let text: string | null = null;\n  let href: string | null = null;\n\n  // Parse :key=\"value\" pairs from rest.\n  let i = 0;\n  while (i < rest.length) {\n    if (rest[i] !== ':') {\n      i += 1;\n      continue;\n    }\n    i += 1; // skip ':'\n    // read key up to '='\n    let keyEnd = i;\n    while (keyEnd < rest.length && rest[keyEnd] !== '=' && rest[keyEnd] !== ':') keyEnd += 1;\n    const key = rest.slice(i, keyEnd).trim();\n    if (keyEnd >= rest.length || rest[keyEnd] !== '=') {\n      i = keyEnd;\n      continue;\n    }\n    let valStart = keyEnd + 1;\n    if (rest[valStart] !== '\"') {\n      // unquoted — read until next ':' at top level\n      let end = valStart;\n      while (end < rest.length && rest[end] !== ':') end += 1;\n      const value = rest.slice(valStart, end);\n      const result = applyElementsChainAttr(key, value);\n      if (result.nthChild != null) nthChild = result.nthChild;\n      if (result.nthOfType != null) nthOfType = result.nthOfType;\n      if (result.text != null) text = result.text;\n      if (result.href != null) href = result.href;\n      if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? '';\n      i = end;\n      continue;\n    }\n    // quoted value — find unescaped closing quote\n    valStart += 1;\n    let end = valStart;\n    let value = '';\n    while (end < rest.length) {\n      const ch = rest[end];\n      if (ch === '\\\\' && end + 1 < rest.length) {\n        const next = rest[end + 1];\n        if (next === '\"' || next === '\\\\') {\n          value += next;\n          end += 2;\n          continue;\n        }\n        value += ch;\n        end += 1;\n        continue;\n      }\n      if (ch === '\"') break;\n      value += ch;\n      end += 1;\n    }\n    const result = applyElementsChainAttr(key, value);\n    if (result.nthChild != null) nthChild = result.nthChild;\n    if (result.nthOfType != null) nthOfType = result.nthOfType;\n    if (result.text != null) text = result.text;\n    if (result.href != null) href = result.href;\n    if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? '';\n    i = end + 1; // skip closing quote\n  }\n\n  return { tag, classes, attrs, text, nthChild, nthOfType, href };\n}\n\n/** Parse an `elements_chain` string into structured, leaf-first segments. */\nexport function parseElementsChain(chain: string): ElementsChainSegment[] {\n  // Split top-level by ';' respecting quoted strings.\n  const segments: string[] = [];\n  let current = '';\n  let inQuotes = false;\n  for (let i = 0; i < chain.length; i++) {\n    const ch = chain[i];\n    if (ch === '\\\\' && i + 1 < chain.length) {\n      current += ch + chain[i + 1];\n      i += 1;\n      continue;\n    }\n    if (ch === '\"') {\n      inQuotes = !inQuotes;\n      current += ch;\n      continue;\n    }\n    if (ch === ';' && !inQuotes) {\n      segments.push(current);\n      current = '';\n      continue;\n    }\n    current += ch;\n  }\n  if (current.length > 0) {\n    segments.push(current);\n  }\n  return segments.map(parseElementsChainSegment).filter((segment): segment is ElementsChainSegment => segment != null);\n}\n\nimport.meta.vitest?.test(\"parseElementsChain parses a simple leaf+ancestor chain\", ({ expect }) => {\n  const parsed = parseElementsChain('button.btn.btn-primary:nth-of-type=\"1\":text=\"Save\":attr__id=\"save-btn\";div.container');\n  expect(parsed).toEqual([\n    { tag: \"button\", classes: [\"btn\", \"btn-primary\"], attrs: { id: \"save-btn\" }, text: \"Save\", nthChild: null, nthOfType: 1, href: null },\n    { tag: \"div\", classes: [\"container\"], attrs: {}, text: null, nthChild: null, nthOfType: null, href: null },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain reverses class escaping for Tailwind-style tokens\", ({ expect }) => {\n  // `md:hover:bg-blue-500` and `w-[1.5rem]` contain the prefix delimiters `:`/`.`,\n  // so the serializer escapes them; the parser must recover the literal classes.\n  const parsed = parseElementsChain('a.md\\\\:hover\\\\:bg-blue-500.w-\\\\[1\\\\.5rem\\\\]:href=\"/p?a=1\"');\n  expect(parsed).toEqual([\n    { tag: \"a\", classes: [\"md:hover:bg-blue-500\", \"w-[1.5rem]\"], attrs: { href: \"/p?a=1\" }, text: null, nthChild: null, nthOfType: null, href: \"/p?a=1\" },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain unescapes quotes/backslashes and ignores ';' inside quoted values\", ({ expect }) => {\n  const parsed = parseElementsChain('span:text=\"a \\\\\"b\\\\\"; c \\\\\\\\ d\"');\n  expect(parsed).toEqual([\n    { tag: \"span\", classes: [], attrs: {}, text: 'a \"b\"; c \\\\ d', nthChild: null, nthOfType: null, href: null },\n  ]);\n});\n\nimport.meta.vitest?.test(\"parseElementsChain drops empty/tagless segments\", ({ expect }) => {\n  expect(parseElementsChain(\"\")).toEqual([]);\n  expect(parseElementsChain(\";;\")).toEqual([]);\n});\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","names":[],"sources":["../../../src/utils/env.tsx"],"mappings":";iBAGgB,aAAA,CAAA;AAAA,iBASA,+BAAA,CAAgC,YAAA,UAAsB,SAAA,UAAmB,aAAA,sBAAmC,UAAA;;;;iBAgC5G,cAAA,CAAe,IAAA,UAAc,YAAA;AAAA,iBAgD7B,aAAA,CAAc,IAAA;AAAA,iBAWd,cAAA,CAAA;AAAA,iBAKA,kBAAA,CAAA;;;;;;;;AAhEhB;;;;;iBAgFgB,aAAA,CAAc,IAAA"}
+{"version":3,"file":"env.d.ts","names":[],"sources":["../../../src/utils/env.tsx"],"mappings":";iBAGgB,aAAA;AAAA,iBASA,+BAAA,CAAgC,YAAA,UAAsB,SAAA,UAAmB,aAAA,sBAAmC,UAAA;;;;iBAgC5G,cAAA,CAAe,IAAA,UAAc,YAAiC;AAAA,iBAgD9D,aAAA,CAAc,IAAY;AAAA,iBAW1B,cAAA;AAAA,iBAKA,kBAAA;;;;;;;AAhG0I;AAgC1J;;;;AAA8E;iBAgF9D,aAAA,CAAc,IAAY"}

package/dist/esm/utils/env.js

@@ -1,6 +1,5 @@
 import { HexclaveAssertionError, throwErr } from "./errors.js";
 import { deindent } from "./strings.js";
-
 //#region src/utils/env.tsx
 function isBrowserLike() {
 	return typeof window !== "undefined" && typeof document !== "undefined" && typeof document.createElement !== "undefined";
@@ -84,7 +83,7 @@ function getProcessEnv(name) {
 	if (typeof process === "undefined" || typeof process.env === "undefined") return;
 	return getEnvVarWithHexclaveFallback(name);
 }
-
 //#endregion
 export { getEnvBoolean, getEnvVariable, getNextRuntime, getNodeEnvironment, getProcessEnv, isBrowserLike, resolveHexclaveStackEnvVarValue };
+
 //# sourceMappingURL=env.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"env.js","names":[],"sources":["../../../src/utils/env.tsx"],"sourcesContent":["import { HexclaveAssertionError, throwErr } from \"./errors\";\nimport { deindent } from \"./strings\";\n\nexport function isBrowserLike() {\n  return typeof window !== \"undefined\" && typeof document !== \"undefined\" && typeof document.createElement !== \"undefined\";\n}\n\n// newName: oldName\nconst ENV_VAR_RENAME: Record<string, string[] | undefined> = {\n  NEXT_PUBLIC_STACK_API_URL: ['STACK_BASE_URL', 'NEXT_PUBLIC_STACK_URL'],\n};\n\nexport function resolveHexclaveStackEnvVarValue(hexclaveName: string, stackName: string, hexclaveValue: string | undefined, stackValue: string | undefined): string | undefined {\n  if (hexclaveValue && stackValue && hexclaveValue !== stackValue) {\n    throw new Error(`Environment variables ${hexclaveName} and ${stackName} are both set to different values. Remove one of them or set them to the same value.`);\n  }\n  return hexclaveValue || stackValue || undefined;\n}\n\n/**\n * Hexclave rebrand: resolve an env var by reading both the `HEXCLAVE_*` and\n * `STACK_*` spellings, preferring the canonical Hexclave value and falling back\n * to the legacy Stack value (empty counts as unset). Works in BOTH directions —\n * whether the caller passes the legacy `STACK_FOO` name or the canonical\n * `HEXCLAVE_FOO` name, the other spelling is still honored. Covers `STACK_FOO`,\n * `NEXT_PUBLIC_STACK_FOO`, `NEXT_PUBLIC_BROWSER_STACK_FOO`,\n * `NEXT_PUBLIC_SERVER_STACK_FOO`, `VITE_STACK_FOO` and their HEXCLAVE_ twins.\n * Names with neither segment behave exactly as before.\n */\nfunction getEnvVarWithHexclaveFallback(name: string): string | undefined {\n  if (name.includes(\"STACK_\")) {\n    const hexclaveName = name.replace(\"STACK_\", \"HEXCLAVE_\");\n    return resolveHexclaveStackEnvVarValue(hexclaveName, name, process.env[hexclaveName], process.env[name]);\n  }\n  if (name.includes(\"HEXCLAVE_\")) {\n    const stackName = name.replace(\"HEXCLAVE_\", \"STACK_\");\n    return resolveHexclaveStackEnvVarValue(name, stackName, process.env[name], process.env[stackName]);\n  }\n  return process.env[name];\n}\n\n/**\n * Returns the environment variable with the given name, returning the default (if given) or throwing an error (otherwise) if it's undefined or the empty string.\n */\nexport function getEnvVariable(name: string, defaultValue?: string | undefined): string {\n  if (isBrowserLike()) {\n    throw new Error(deindent`\n      Can't use getEnvVariable on the client because Next.js transpiles expressions of the kind process.env.XYZ at build-time on the client.\n    \n      Use process.env.XYZ directly instead.\n    `);\n  }\n  if (name === \"NEXT_RUNTIME\") {\n    throw new Error(deindent`\n      Can't use getEnvVariable to access the NEXT_RUNTIME environment variable because it's compiled into the client bundle.\n    \n      Use getNextRuntime() instead.\n    `);\n  }\n\n  // throw error if the old name is used as the retrieve key\n  for (const [newName, oldNames] of Object.entries(ENV_VAR_RENAME)) {\n    if (oldNames?.includes(name)) {\n      throwErr(`Environment variable ${name} has been renamed to ${newName}. Please update your configuration to use the new name.`);\n    }\n  }\n\n  // Hexclave rebrand: prefer the HEXCLAVE_*-prefixed equivalent, fall back to the STACK_* name.\n  // Treat the empty string as unset — the checked-in .env templates define empty\n  // HEXCLAVE_* placeholders, which must not shadow a real value under the legacy name.\n  let value = getEnvVarWithHexclaveFallback(name);\n\n  // check the key under the old name if the new name is not found\n  const renamedNames = ENV_VAR_RENAME[name];\n  if (!value && renamedNames != null) {\n    for (const oldName of renamedNames) {\n      value = getEnvVarWithHexclaveFallback(oldName);\n      if (value) break;\n    }\n  }\n\n  if (!value) {\n    if (defaultValue !== undefined) {\n      value = defaultValue;\n    } else {\n      throwErr(`Missing environment variable: ${name}`);\n    }\n  }\n\n  return value;\n}\n\nexport function getEnvBoolean(name: string): boolean {\n  const value = getEnvVariable(name, \"false\");\n  if (value === \"true\") {\n    return true;\n  } else if (value === \"false\") {\n    return false;\n  } else {\n    throw new HexclaveAssertionError(`Environment variable ${name} must be either \"true\" or \"false\": found ${JSON.stringify(value)}`);\n  }\n}\n\nexport function getNextRuntime() {\n  // This variable is compiled into the client bundle, so we can't use getEnvVariable here.\n  return process.env.NEXT_RUNTIME || throwErr(\"Missing environment variable: NEXT_RUNTIME\");\n}\n\nexport function getNodeEnvironment() {\n  return getEnvVariable(\"NODE_ENV\", \"\");\n}\n\n/**\n * Browser-safe access to `process.env` for server-only or genuinely dynamic\n * env-var lookups. Returns `undefined` when `process` is not defined (e.g. in\n * a Vite browser bundle without a `process` shim).\n *\n * Note: uses `process.env[name]` (bracket form), which is NOT recognized by\n * Next.js / webpack DefinePlugin for compile-time inlining. If you need\n * build-time inlining for a `NEXT_PUBLIC_*` var, use the literal dot-form at\n * the call site, guarded with `typeof process`:\n *\n *   const value = (typeof process !== \"undefined\" ? process.env.NEXT_PUBLIC_FOO : undefined);\n */\nexport function getProcessEnv(name: string): string | undefined {\n  if (typeof process === \"undefined\" || typeof process.env === \"undefined\") {\n    return undefined;\n  }\n  // Hexclave rebrand: prefer the HEXCLAVE_*-prefixed equivalent, fall back to the STACK_* name.\n  // Empty counts as unset — the checked-in .env templates define empty HEXCLAVE_* placeholders,\n  // which must not shadow a real value under the legacy name.\n  return getEnvVarWithHexclaveFallback(name);\n}\n"],"mappings":";;;;AAGA,SAAgB,gBAAgB;AAC9B,QAAO,OAAO,WAAW,eAAe,OAAO,aAAa,eAAe,OAAO,SAAS,kBAAkB;;AAI/G,MAAM,iBAAuD,EAC3D,2BAA2B,CAAC,kBAAkB,wBAAwB,EACvE;AAED,SAAgB,gCAAgC,cAAsB,WAAmB,eAAmC,YAAoD;AAC9K,KAAI,iBAAiB,cAAc,kBAAkB,WACnD,OAAM,IAAI,MAAM,yBAAyB,aAAa,OAAO,UAAU,sFAAsF;AAE/J,QAAO,iBAAiB,cAAc;;;;;;;;;;;;AAaxC,SAAS,8BAA8B,MAAkC;AACvE,KAAI,KAAK,SAAS,SAAS,EAAE;EAC3B,MAAM,eAAe,KAAK,QAAQ,UAAU,YAAY;AACxD,SAAO,gCAAgC,cAAc,MAAM,QAAQ,IAAI,eAAe,QAAQ,IAAI,MAAM;;AAE1G,KAAI,KAAK,SAAS,YAAY,EAAE;EAC9B,MAAM,YAAY,KAAK,QAAQ,aAAa,SAAS;AACrD,SAAO,gCAAgC,MAAM,WAAW,QAAQ,IAAI,OAAO,QAAQ,IAAI,WAAW;;AAEpG,QAAO,QAAQ,IAAI;;;;;AAMrB,SAAgB,eAAe,MAAc,cAA2C;AACtF,KAAI,eAAe,CACjB,OAAM,IAAI,MAAM,QAAQ;;;;MAItB;AAEJ,KAAI,SAAS,eACX,OAAM,IAAI,MAAM,QAAQ;;;;MAItB;AAIJ,MAAK,MAAM,CAAC,SAAS,aAAa,OAAO,QAAQ,eAAe,CAC9D,KAAI,UAAU,SAAS,KAAK,CAC1B,UAAS,wBAAwB,KAAK,uBAAuB,QAAQ,yDAAyD;CAOlI,IAAI,QAAQ,8BAA8B,KAAK;CAG/C,MAAM,eAAe,eAAe;AACpC,KAAI,CAAC,SAAS,gBAAgB,KAC5B,MAAK,MAAM,WAAW,cAAc;AAClC,UAAQ,8BAA8B,QAAQ;AAC9C,MAAI,MAAO;;AAIf,KAAI,CAAC,MACH,KAAI,iBAAiB,OACnB,SAAQ;KAER,UAAS,iCAAiC,OAAO;AAIrD,QAAO;;AAGT,SAAgB,cAAc,MAAuB;CACnD,MAAM,QAAQ,eAAe,MAAM,QAAQ;AAC3C,KAAI,UAAU,OACZ,QAAO;UACE,UAAU,QACnB,QAAO;KAEP,OAAM,IAAI,uBAAuB,wBAAwB,KAAK,2CAA2C,KAAK,UAAU,MAAM,GAAG;;AAIrI,SAAgB,iBAAiB;AAE/B,QAAO,QAAQ,IAAI,gBAAgB,SAAS,6CAA6C;;AAG3F,SAAgB,qBAAqB;AACnC,QAAO,eAAe,YAAY,GAAG;;;;;;;;;;;;;;AAevC,SAAgB,cAAc,MAAkC;AAC9D,KAAI,OAAO,YAAY,eAAe,OAAO,QAAQ,QAAQ,YAC3D;AAKF,QAAO,8BAA8B,KAAK"}
+{"version":3,"file":"env.js","names":[],"sources":["../../../src/utils/env.tsx"],"sourcesContent":["import { HexclaveAssertionError, throwErr } from \"./errors\";\nimport { deindent } from \"./strings\";\n\nexport function isBrowserLike() {\n  return typeof window !== \"undefined\" && typeof document !== \"undefined\" && typeof document.createElement !== \"undefined\";\n}\n\n// newName: oldName\nconst ENV_VAR_RENAME: Record<string, string[] | undefined> = {\n  NEXT_PUBLIC_STACK_API_URL: ['STACK_BASE_URL', 'NEXT_PUBLIC_STACK_URL'],\n};\n\nexport function resolveHexclaveStackEnvVarValue(hexclaveName: string, stackName: string, hexclaveValue: string | undefined, stackValue: string | undefined): string | undefined {\n  if (hexclaveValue && stackValue && hexclaveValue !== stackValue) {\n    throw new Error(`Environment variables ${hexclaveName} and ${stackName} are both set to different values. Remove one of them or set them to the same value.`);\n  }\n  return hexclaveValue || stackValue || undefined;\n}\n\n/**\n * Hexclave rebrand: resolve an env var by reading both the `HEXCLAVE_*` and\n * `STACK_*` spellings, preferring the canonical Hexclave value and falling back\n * to the legacy Stack value (empty counts as unset). Works in BOTH directions —\n * whether the caller passes the legacy `STACK_FOO` name or the canonical\n * `HEXCLAVE_FOO` name, the other spelling is still honored. Covers `STACK_FOO`,\n * `NEXT_PUBLIC_STACK_FOO`, `NEXT_PUBLIC_BROWSER_STACK_FOO`,\n * `NEXT_PUBLIC_SERVER_STACK_FOO`, `VITE_STACK_FOO` and their HEXCLAVE_ twins.\n * Names with neither segment behave exactly as before.\n */\nfunction getEnvVarWithHexclaveFallback(name: string): string | undefined {\n  if (name.includes(\"STACK_\")) {\n    const hexclaveName = name.replace(\"STACK_\", \"HEXCLAVE_\");\n    return resolveHexclaveStackEnvVarValue(hexclaveName, name, process.env[hexclaveName], process.env[name]);\n  }\n  if (name.includes(\"HEXCLAVE_\")) {\n    const stackName = name.replace(\"HEXCLAVE_\", \"STACK_\");\n    return resolveHexclaveStackEnvVarValue(name, stackName, process.env[name], process.env[stackName]);\n  }\n  return process.env[name];\n}\n\n/**\n * Returns the environment variable with the given name, returning the default (if given) or throwing an error (otherwise) if it's undefined or the empty string.\n */\nexport function getEnvVariable(name: string, defaultValue?: string | undefined): string {\n  if (isBrowserLike()) {\n    throw new Error(deindent`\n      Can't use getEnvVariable on the client because Next.js transpiles expressions of the kind process.env.XYZ at build-time on the client.\n    \n      Use process.env.XYZ directly instead.\n    `);\n  }\n  if (name === \"NEXT_RUNTIME\") {\n    throw new Error(deindent`\n      Can't use getEnvVariable to access the NEXT_RUNTIME environment variable because it's compiled into the client bundle.\n    \n      Use getNextRuntime() instead.\n    `);\n  }\n\n  // throw error if the old name is used as the retrieve key\n  for (const [newName, oldNames] of Object.entries(ENV_VAR_RENAME)) {\n    if (oldNames?.includes(name)) {\n      throwErr(`Environment variable ${name} has been renamed to ${newName}. Please update your configuration to use the new name.`);\n    }\n  }\n\n  // Hexclave rebrand: prefer the HEXCLAVE_*-prefixed equivalent, fall back to the STACK_* name.\n  // Treat the empty string as unset — the checked-in .env templates define empty\n  // HEXCLAVE_* placeholders, which must not shadow a real value under the legacy name.\n  let value = getEnvVarWithHexclaveFallback(name);\n\n  // check the key under the old name if the new name is not found\n  const renamedNames = ENV_VAR_RENAME[name];\n  if (!value && renamedNames != null) {\n    for (const oldName of renamedNames) {\n      value = getEnvVarWithHexclaveFallback(oldName);\n      if (value) break;\n    }\n  }\n\n  if (!value) {\n    if (defaultValue !== undefined) {\n      value = defaultValue;\n    } else {\n      throwErr(`Missing environment variable: ${name}`);\n    }\n  }\n\n  return value;\n}\n\nexport function getEnvBoolean(name: string): boolean {\n  const value = getEnvVariable(name, \"false\");\n  if (value === \"true\") {\n    return true;\n  } else if (value === \"false\") {\n    return false;\n  } else {\n    throw new HexclaveAssertionError(`Environment variable ${name} must be either \"true\" or \"false\": found ${JSON.stringify(value)}`);\n  }\n}\n\nexport function getNextRuntime() {\n  // This variable is compiled into the client bundle, so we can't use getEnvVariable here.\n  return process.env.NEXT_RUNTIME || throwErr(\"Missing environment variable: NEXT_RUNTIME\");\n}\n\nexport function getNodeEnvironment() {\n  return getEnvVariable(\"NODE_ENV\", \"\");\n}\n\n/**\n * Browser-safe access to `process.env` for server-only or genuinely dynamic\n * env-var lookups. Returns `undefined` when `process` is not defined (e.g. in\n * a Vite browser bundle without a `process` shim).\n *\n * Note: uses `process.env[name]` (bracket form), which is NOT recognized by\n * Next.js / webpack DefinePlugin for compile-time inlining. If you need\n * build-time inlining for a `NEXT_PUBLIC_*` var, use the literal dot-form at\n * the call site, guarded with `typeof process`:\n *\n *   const value = (typeof process !== \"undefined\" ? process.env.NEXT_PUBLIC_FOO : undefined);\n */\nexport function getProcessEnv(name: string): string | undefined {\n  if (typeof process === \"undefined\" || typeof process.env === \"undefined\") {\n    return undefined;\n  }\n  // Hexclave rebrand: prefer the HEXCLAVE_*-prefixed equivalent, fall back to the STACK_* name.\n  // Empty counts as unset — the checked-in .env templates define empty HEXCLAVE_* placeholders,\n  // which must not shadow a real value under the legacy name.\n  return getEnvVarWithHexclaveFallback(name);\n}\n"],"mappings":";;;AAGA,SAAgB,gBAAgB;CAC9B,OAAO,OAAO,WAAW,eAAe,OAAO,aAAa,eAAe,OAAO,SAAS,kBAAkB;AAC/G;AAGA,MAAM,iBAAuD,EAC3D,2BAA2B,CAAC,kBAAkB,uBAAuB,EACvE;AAEA,SAAgB,gCAAgC,cAAsB,WAAmB,eAAmC,YAAoD;CAC9K,IAAI,iBAAiB,cAAc,kBAAkB,YACnD,MAAM,IAAI,MAAM,yBAAyB,aAAa,OAAO,UAAU,qFAAqF;CAE9J,OAAO,iBAAiB,cAAc,KAAA;AACxC;;;;;;;;;;;AAYA,SAAS,8BAA8B,MAAkC;CACvE,IAAI,KAAK,SAAS,QAAQ,GAAG;EAC3B,MAAM,eAAe,KAAK,QAAQ,UAAU,WAAW;EACvD,OAAO,gCAAgC,cAAc,MAAM,QAAQ,IAAI,eAAe,QAAQ,IAAI,KAAK;CACzG;CACA,IAAI,KAAK,SAAS,WAAW,GAAG;EAC9B,MAAM,YAAY,KAAK,QAAQ,aAAa,QAAQ;EACpD,OAAO,gCAAgC,MAAM,WAAW,QAAQ,IAAI,OAAO,QAAQ,IAAI,UAAU;CACnG;CACA,OAAO,QAAQ,IAAI;AACrB;;;;AAKA,SAAgB,eAAe,MAAc,cAA2C;CACtF,IAAI,cAAc,GAChB,MAAM,IAAI,MAAM,QAAQ;;;;KAIvB;CAEH,IAAI,SAAS,gBACX,MAAM,IAAI,MAAM,QAAQ;;;;KAIvB;CAIH,KAAK,MAAM,CAAC,SAAS,aAAa,OAAO,QAAQ,cAAc,GAC7D,IAAI,UAAU,SAAS,IAAI,GACzB,SAAS,wBAAwB,KAAK,uBAAuB,QAAQ,wDAAwD;CAOjI,IAAI,QAAQ,8BAA8B,IAAI;CAG9C,MAAM,eAAe,eAAe;CACpC,IAAI,CAAC,SAAS,gBAAgB,MAC5B,KAAK,MAAM,WAAW,cAAc;EAClC,QAAQ,8BAA8B,OAAO;EAC7C,IAAI,OAAO;CACb;CAGF,IAAI,CAAC,OACH,IAAI,iBAAiB,KAAA,GACnB,QAAQ;MAER,SAAS,iCAAiC,MAAM;CAIpD,OAAO;AACT;AAEA,SAAgB,cAAc,MAAuB;CACnD,MAAM,QAAQ,eAAe,MAAM,OAAO;CAC1C,IAAI,UAAU,QACZ,OAAO;MACF,IAAI,UAAU,SACnB,OAAO;MAEP,MAAM,IAAI,uBAAuB,wBAAwB,KAAK,2CAA2C,KAAK,UAAU,KAAK,GAAG;AAEpI;AAEA,SAAgB,iBAAiB;CAE/B,OAAO,QAAQ,IAAI,gBAAgB,SAAS,4CAA4C;AAC1F;AAEA,SAAgB,qBAAqB;CACnC,OAAO,eAAe,YAAY,EAAE;AACtC;;;;;;;;;;;;;AAcA,SAAgB,cAAc,MAAkC;CAC9D,IAAI,OAAO,YAAY,eAAe,OAAO,QAAQ,QAAQ,aAC3D;CAKF,OAAO,8BAA8B,IAAI;AAC3C"}

package/dist/esm/utils/env.test.js

@@ -1,6 +1,5 @@
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { getEnvVariable, getProcessEnv, resolveHexclaveStackEnvVarValue } from "./env.js";
-
 //#region src/utils/env.test.tsx
 afterEach(() => {
 	vi.unstubAllEnvs();
@@ -43,7 +42,7 @@ describe("Hexclave/Stack env var dual-read", () => {
 		expect(() => getEnvVariable("NEXT_PUBLIC_HEXCLAVE_API_URL")).toThrow(/NEXT_PUBLIC_HEXCLAVE_API_URL.*NEXT_PUBLIC_STACK_API_URL.*different values/);
 	});
 });
-
 //#endregion
-export {  };
+export {};
+
 //# sourceMappingURL=env.test.js.map

package/dist/esm/utils/env.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.test.js","names":[],"sources":["../../../src/utils/env.test.tsx"],"sourcesContent":["import { afterEach, describe, expect, it, vi } from \"vitest\";\nimport { getEnvVariable, getProcessEnv, resolveHexclaveStackEnvVarValue } from \"./env\";\n\nafterEach(() => {\n  vi.unstubAllEnvs();\n});\n\ndescribe(\"Hexclave/Stack env var dual-read\", () => {\n  it(\"falls back to the legacy Stack name when the Hexclave value is empty\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\", \"\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://stack.example.test\");\n\n    expect(getEnvVariable(\"NEXT_PUBLIC_STACK_API_URL\")).toBe(\"https://stack.example.test\");\n    expect(getProcessEnv(\"NEXT_PUBLIC_STACK_API_URL\")).toBe(\"https://stack.example.test\");\n  });\n\n  it(\"allows both names when they have the same non-empty value\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\", \"https://api.example.test\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://api.example.test\");\n\n    expect(getEnvVariable(\"NEXT_PUBLIC_STACK_API_URL\")).toBe(\"https://api.example.test\");\n    expect(getProcessEnv(\"NEXT_PUBLIC_STACK_API_URL\")).toBe(\"https://api.example.test\");\n  });\n\n  it(\"throws when both names are non-empty and different\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\", \"https://hexclave.example.test\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://stack.example.test\");\n\n    expect(() => getEnvVariable(\"NEXT_PUBLIC_STACK_API_URL\")).toThrow(/NEXT_PUBLIC_HEXCLAVE_API_URL.*NEXT_PUBLIC_STACK_API_URL.*different values/);\n    expect(() => getProcessEnv(\"NEXT_PUBLIC_STACK_API_URL\")).toThrow(/NEXT_PUBLIC_HEXCLAVE_API_URL.*NEXT_PUBLIC_STACK_API_URL.*different values/);\n  });\n\n  it(\"checks renamed legacy aliases when falling back\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_URL\", \"https://hexclave-url.example.test\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_URL\", \"https://stack-url.example.test\");\n\n    expect(() => getEnvVariable(\"NEXT_PUBLIC_STACK_API_URL\")).toThrow(/NEXT_PUBLIC_HEXCLAVE_URL.*NEXT_PUBLIC_STACK_URL.*different values/);\n  });\n\n  it(\"returns undefined when both names are empty\", () => {\n    expect(resolveHexclaveStackEnvVarValue(\"HEXCLAVE_FOO\", \"STACK_FOO\", \"\", \"\")).toBeUndefined();\n  });\n\n  it(\"falls back to the legacy Stack name when a canonical Hexclave name is looked up\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://stack.example.test\");\n\n    // Caller passes the canonical HEXCLAVE_ name but only the legacy value is set.\n    expect(getEnvVariable(\"NEXT_PUBLIC_HEXCLAVE_API_URL\")).toBe(\"https://stack.example.test\");\n    expect(getProcessEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\")).toBe(\"https://stack.example.test\");\n  });\n\n  it(\"throws on a conflict when a canonical Hexclave name is looked up\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\", \"https://hexclave.example.test\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://stack.example.test\");\n\n    expect(() => getEnvVariable(\"NEXT_PUBLIC_HEXCLAVE_API_URL\")).toThrow(/NEXT_PUBLIC_HEXCLAVE_API_URL.*NEXT_PUBLIC_STACK_API_URL.*different values/);\n  });\n});\n"],"mappings":";;;;AAGA,gBAAgB;AACd,IAAG,eAAe;EAClB;AAEF,SAAS,0CAA0C;AACjD,IAAG,8EAA8E;AAC/E,KAAG,QAAQ,gCAAgC,GAAG;AAC9C,KAAG,QAAQ,6BAA6B,6BAA6B;AAErE,SAAO,eAAe,4BAA4B,CAAC,CAAC,KAAK,6BAA6B;AACtF,SAAO,cAAc,4BAA4B,CAAC,CAAC,KAAK,6BAA6B;GACrF;AAEF,IAAG,mEAAmE;AACpE,KAAG,QAAQ,gCAAgC,2BAA2B;AACtE,KAAG,QAAQ,6BAA6B,2BAA2B;AAEnE,SAAO,eAAe,4BAA4B,CAAC,CAAC,KAAK,2BAA2B;AACpF,SAAO,cAAc,4BAA4B,CAAC,CAAC,KAAK,2BAA2B;GACnF;AAEF,IAAG,4DAA4D;AAC7D,KAAG,QAAQ,gCAAgC,gCAAgC;AAC3E,KAAG,QAAQ,6BAA6B,6BAA6B;AAErE,eAAa,eAAe,4BAA4B,CAAC,CAAC,QAAQ,4EAA4E;AAC9I,eAAa,cAAc,4BAA4B,CAAC,CAAC,QAAQ,4EAA4E;GAC7I;AAEF,IAAG,yDAAyD;AAC1D,KAAG,QAAQ,4BAA4B,oCAAoC;AAC3E,KAAG,QAAQ,yBAAyB,iCAAiC;AAErE,eAAa,eAAe,4BAA4B,CAAC,CAAC,QAAQ,oEAAoE;GACtI;AAEF,IAAG,qDAAqD;AACtD,SAAO,gCAAgC,gBAAgB,aAAa,IAAI,GAAG,CAAC,CAAC,eAAe;GAC5F;AAEF,IAAG,yFAAyF;AAC1F,KAAG,QAAQ,6BAA6B,6BAA6B;AAGrE,SAAO,eAAe,+BAA+B,CAAC,CAAC,KAAK,6BAA6B;AACzF,SAAO,cAAc,+BAA+B,CAAC,CAAC,KAAK,6BAA6B;GACxF;AAEF,IAAG,0EAA0E;AAC3E,KAAG,QAAQ,gCAAgC,gCAAgC;AAC3E,KAAG,QAAQ,6BAA6B,6BAA6B;AAErE,eAAa,eAAe,+BAA+B,CAAC,CAAC,QAAQ,4EAA4E;GACjJ;EACF"}
+{"version":3,"file":"env.test.js","names":[],"sources":["../../../src/utils/env.test.tsx"],"sourcesContent":["import { afterEach, describe, expect, it, vi } from \"vitest\";\nimport { getEnvVariable, getProcessEnv, resolveHexclaveStackEnvVarValue } from \"./env\";\n\nafterEach(() => {\n  vi.unstubAllEnvs();\n});\n\ndescribe(\"Hexclave/Stack env var dual-read\", () => {\n  it(\"falls back to the legacy Stack name when the Hexclave value is empty\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\", \"\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://stack.example.test\");\n\n    expect(getEnvVariable(\"NEXT_PUBLIC_STACK_API_URL\")).toBe(\"https://stack.example.test\");\n    expect(getProcessEnv(\"NEXT_PUBLIC_STACK_API_URL\")).toBe(\"https://stack.example.test\");\n  });\n\n  it(\"allows both names when they have the same non-empty value\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\", \"https://api.example.test\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://api.example.test\");\n\n    expect(getEnvVariable(\"NEXT_PUBLIC_STACK_API_URL\")).toBe(\"https://api.example.test\");\n    expect(getProcessEnv(\"NEXT_PUBLIC_STACK_API_URL\")).toBe(\"https://api.example.test\");\n  });\n\n  it(\"throws when both names are non-empty and different\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\", \"https://hexclave.example.test\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://stack.example.test\");\n\n    expect(() => getEnvVariable(\"NEXT_PUBLIC_STACK_API_URL\")).toThrow(/NEXT_PUBLIC_HEXCLAVE_API_URL.*NEXT_PUBLIC_STACK_API_URL.*different values/);\n    expect(() => getProcessEnv(\"NEXT_PUBLIC_STACK_API_URL\")).toThrow(/NEXT_PUBLIC_HEXCLAVE_API_URL.*NEXT_PUBLIC_STACK_API_URL.*different values/);\n  });\n\n  it(\"checks renamed legacy aliases when falling back\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_URL\", \"https://hexclave-url.example.test\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_URL\", \"https://stack-url.example.test\");\n\n    expect(() => getEnvVariable(\"NEXT_PUBLIC_STACK_API_URL\")).toThrow(/NEXT_PUBLIC_HEXCLAVE_URL.*NEXT_PUBLIC_STACK_URL.*different values/);\n  });\n\n  it(\"returns undefined when both names are empty\", () => {\n    expect(resolveHexclaveStackEnvVarValue(\"HEXCLAVE_FOO\", \"STACK_FOO\", \"\", \"\")).toBeUndefined();\n  });\n\n  it(\"falls back to the legacy Stack name when a canonical Hexclave name is looked up\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://stack.example.test\");\n\n    // Caller passes the canonical HEXCLAVE_ name but only the legacy value is set.\n    expect(getEnvVariable(\"NEXT_PUBLIC_HEXCLAVE_API_URL\")).toBe(\"https://stack.example.test\");\n    expect(getProcessEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\")).toBe(\"https://stack.example.test\");\n  });\n\n  it(\"throws on a conflict when a canonical Hexclave name is looked up\", () => {\n    vi.stubEnv(\"NEXT_PUBLIC_HEXCLAVE_API_URL\", \"https://hexclave.example.test\");\n    vi.stubEnv(\"NEXT_PUBLIC_STACK_API_URL\", \"https://stack.example.test\");\n\n    expect(() => getEnvVariable(\"NEXT_PUBLIC_HEXCLAVE_API_URL\")).toThrow(/NEXT_PUBLIC_HEXCLAVE_API_URL.*NEXT_PUBLIC_STACK_API_URL.*different values/);\n  });\n});\n"],"mappings":";;;AAGA,gBAAgB;CACd,GAAG,cAAc;AACnB,CAAC;AAED,SAAS,0CAA0C;CACjD,GAAG,8EAA8E;EAC/E,GAAG,QAAQ,gCAAgC,EAAE;EAC7C,GAAG,QAAQ,6BAA6B,4BAA4B;EAEpE,OAAO,eAAe,2BAA2B,CAAC,CAAC,CAAC,KAAK,4BAA4B;EACrF,OAAO,cAAc,2BAA2B,CAAC,CAAC,CAAC,KAAK,4BAA4B;CACtF,CAAC;CAED,GAAG,mEAAmE;EACpE,GAAG,QAAQ,gCAAgC,0BAA0B;EACrE,GAAG,QAAQ,6BAA6B,0BAA0B;EAElE,OAAO,eAAe,2BAA2B,CAAC,CAAC,CAAC,KAAK,0BAA0B;EACnF,OAAO,cAAc,2BAA2B,CAAC,CAAC,CAAC,KAAK,0BAA0B;CACpF,CAAC;CAED,GAAG,4DAA4D;EAC7D,GAAG,QAAQ,gCAAgC,+BAA+B;EAC1E,GAAG,QAAQ,6BAA6B,4BAA4B;EAEpE,aAAa,eAAe,2BAA2B,CAAC,CAAC,CAAC,QAAQ,2EAA2E;EAC7I,aAAa,cAAc,2BAA2B,CAAC,CAAC,CAAC,QAAQ,2EAA2E;CAC9I,CAAC;CAED,GAAG,yDAAyD;EAC1D,GAAG,QAAQ,4BAA4B,mCAAmC;EAC1E,GAAG,QAAQ,yBAAyB,gCAAgC;EAEpE,aAAa,eAAe,2BAA2B,CAAC,CAAC,CAAC,QAAQ,mEAAmE;CACvI,CAAC;CAED,GAAG,qDAAqD;EACtD,OAAO,gCAAgC,gBAAgB,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc;CAC7F,CAAC;CAED,GAAG,yFAAyF;EAC1F,GAAG,QAAQ,6BAA6B,4BAA4B;EAGpE,OAAO,eAAe,8BAA8B,CAAC,CAAC,CAAC,KAAK,4BAA4B;EACxF,OAAO,cAAc,8BAA8B,CAAC,CAAC,CAAC,KAAK,4BAA4B;CACzF,CAAC;CAED,GAAG,0EAA0E;EAC3E,GAAG,QAAQ,gCAAgC,+BAA+B;EAC1E,GAAG,QAAQ,6BAA6B,4BAA4B;EAEpE,aAAa,eAAe,8BAA8B,CAAC,CAAC,CAAC,QAAQ,2EAA2E;CAClJ,CAAC;AACH,CAAC"}

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

@@ -1,4 +1,4 @@
-import { Json } from "./json";
+import { Json } from "./json.js";
 
 //#region src/utils/errors.d.ts
 declare function throwErr(errorMessage: string, extraData?: any): never;

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../../src/utils/errors.tsx"],"mappings":";;;iBAMgB,QAAA,CAAS,YAAA,UAAsB,SAAA;AAAA,iBAC/B,QAAA,CAAS,KAAA,EAAO,KAAA;AAAA,iBAChB,QAAA,CAAA,GAAY,IAAA,EAAM,gCAAA;;;;;AADlC;;;;;AACA;;;;;AA0CA;;;;;;;;;iBAAgB,iBAAA,CAAkB,KAAA,EAAO,KAAA,KAAU,MAAA,EAAQ,KAAA;AAAA,cAkB9C,sBAAA,SAA+B,KAAA;EAAA,SACG,SAAA,IAAY,MAAA,gBAAsB,YAAA;cAAnE,OAAA,UAAiC,SAAA,IAAY,MAAA,gBAAsB,YAAA;AAAA;AAAA,iBA0BjE,iBAAA,CAAkB,KAAA;AAAA,KAMtB,YAAA;AAAA,KAEP,SAAA,IAAa,QAAA,UAAkB,KAAA,WAAgB,KAAA,EAAO,YAAA,KAAiB,SAAA;AAAA,iBAG5D,iBAAA,CAAkB,IAAA,EAAM,SAAA;;;;;;;;;;iBA4CxB,YAAA,CAAa,QAAA,UAAkB,KAAA;;;;AAvD/C;iBA+DgB,cAAA,CAAe,QAAA,UAAkB,KAAA;AAAA,KAK5C,MAAA;EACH,UAAA;EACA,OAAA;AAAA;AAAA,KAGG,gCAAA,IAEH,MAAA,EAAQ,MAAA,EACR,OAAA,cAGA,UAAA,WAAqB,MAAA,EACrB,OAAA;AAAA,cAGW,WAAA,SAAoB,KAAA;EAAA,iBACd,uBAAA;EACV,IAAA;EAAA,SACS,UAAA;EAAA,OAEF,UAAA;;;;SACA,YAAA;;;;SACA,eAAA;;;;SACA,SAAA;;;;SACA,QAAA;;;;SACA,gBAAA;;;;SACA,aAAA;;;;SACA,2BAAA;;;;SACA,cAAA;;;;SACA,QAAA;;;;SACA,IAAA;;;;SACA,cAAA;;;;SACA,kBAAA;;;;SACA,eAAA;;;;SACA,UAAA;;;;SACA,oBAAA;;;;SACA,mBAAA;;;;SACA,iBAAA;;;;SACA,SAAA;;;;SACA,kBAAA;;;;SACA,mBAAA;;;;SACA,MAAA;;;;SACA,gBAAA;;;;SACA,QAAA;;;;SACA,eAAA;;;;SACA,oBAAA;;;;SACA,eAAA;;;;SACA,2BAAA;;;;SACA,0BAAA;;;;SAEA,mBAAA;;;;SACA,cAAA;;;;SACA,UAAA;;;;SACA,kBAAA;;;;SACA,cAAA;;;;SACA,uBAAA;;;;SACA,qBAAA;;;;SACA,mBAAA;;;;SACA,YAAA;;;;SACA,WAAA;;;;SACA,6BAAA;;;;iBAGC,IAAA,EAAM,gCAAA;EAAA,OAgBP,aAAA,CAAc,KAAA,YAAiB,KAAA,IAAS,WAAA;EAK/C,aAAA,CAAA;EAIA,aAAA,CAAA;EAIA,aAAA,CAAA;EAIA,OAAA,CAAA,GAAW,UAAA;EAIX,UAAA,CAAA,GAAc,MAAA;EAMd,iBAAA,CAAA,GAAqB,IAAA;;;;EAWrB,UAAA,CAAA,GAAc,IAAA;AAAA"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../../src/utils/errors.tsx"],"mappings":";;;iBAMgB,QAAA,CAAS,YAAA,UAAsB,SAAe;AAAA,iBAC9C,QAAA,CAAS,KAAY,EAAL,KAAK;AAAA,iBACrB,QAAA,IAAY,IAAA,EAAM,gCAAgC;;;;AAFJ;AAC9D;;;;AAAqC;AACrC;;;;AAAkE;AA0ClE;;;;;;;;;iBAAgB,iBAAA,CAAkB,KAAA,EAAO,KAAA,KAAU,MAAA,EAAQ,KAAK;AAAA,cAkBnD,sBAAA,SAA+B,KAAA;EAAA,SACG,SAAA,IAAY,MAAA,gBAAsB,YAAA;cAAnE,OAAA,UAAiC,SAAA,IAAY,MAAA,gBAAsB,YAAA;AAAA;AAAA,iBA0BjE,iBAAA,CAAkB,KAAc;AAAA,KAMpC,YAAA;AAAA,KAEP,SAAA,IAAa,QAAA,UAAkB,KAAA,WAAgB,KAAA,EAAO,YAAY,KAAK,SAAA;AAAA,iBAG5D,iBAAA,CAAkB,IAAe,EAAT,SAAS;;;;;;;;;;iBA4CjC,YAAA,CAAa,QAAA,UAAkB,KAAc;;;AAjFgC;AA0B7F;iBA+DgB,cAAA,CAAe,QAAA,UAAkB,KAAc;AAAA,KAK1D,MAAA;EACH,UAAA;EACA,OAAO;AAAA;AAAA,KAGJ,gCAAA,IAEH,MAAA,EAAQ,MAAA,EACR,OAAA,cAGA,UAAA,WAAqB,MAAM,EAC3B,OAAA;AAAA,cAGW,WAAA,SAAoB,KAAA;EAAA,iBACd,uBAAA;EACV,IAAA;EAAA,SACS,UAAA;EAAA,OAEF,UAAA;;;;SACA,YAAA;;;;SACA,eAAA;;;;SACA,SAAA;;;;SACA,QAAA;;;;SACA,gBAAA;;;;SACA,aAAA;;;;SACA,2BAAA;;;;SACA,cAAA;;;;SACA,QAAA;;;;SACA,IAAA;;;;SACA,cAAA;;;;SACA,kBAAA;;;;SACA,eAAA;;;;SACA,UAAA;;;;SACA,oBAAA;;;;SACA,mBAAA;;;;SACA,iBAAA;;;;SACA,SAAA;;;;SACA,kBAAA;;;;SACA,mBAAA;;;;SACA,MAAA;;;;SACA,gBAAA;;;;SACA,QAAA;;;;SACA,eAAA;;;;SACA,oBAAA;;;;SACA,eAAA;;;;SACA,2BAAA;;;;SACA,0BAAA;;;;SAEA,mBAAA;;;;SACA,cAAA;;;;SACA,UAAA;;;;SACA,kBAAA;;;;SACA,cAAA;;;;SACA,uBAAA;;;;SACA,qBAAA;;;;SACA,mBAAA;;;;SACA,YAAA;;;;SACA,WAAA;;;;SACA,6BAAA;;;;iBAGC,IAAA,EAAM,gCAAA;EAAA,OAgBP,aAAA,CAAc,KAAA,YAAiB,KAAA,IAAS,WAAA;EAK/C,aAAA;EAIA,aAAA;EAIA,aAAA;EAIA,OAAA,IAAW,UAAA;EAIX,UAAA,IAAc,MAAA;EAMd,iBAAA,IAAqB,IAAA;;;;EAWrB,UAAA,IAAc,IAAA;AAAA"}

package/dist/esm/utils/errors.js

@@ -1,7 +1,6 @@
 import { pick } from "./objects.js";
 import { globalVar } from "./globals.js";
 import { nicify } from "./strings.js";
-
 //#region src/utils/errors.tsx
 function throwErr(...args) {
 	if (typeof args[0] === "string") throw new HexclaveAssertionError(args[0], args[1]);
@@ -393,7 +392,7 @@ var StatusError = class extends Error {
 	}
 };
 StatusError.prototype.name = "StatusError";
-
 //#endregion
 export { HexclaveAssertionError, StatusError, captureError, captureWarning, concatStacktraces, errorToNiceString, registerErrorSink, throwErr };
+
 //# sourceMappingURL=errors.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../../src/utils/errors.tsx"],"sourcesContent":["import { globalVar } from \"./globals\";\nimport { Json } from \"./json\";\nimport { pick } from \"./objects\";\nimport { nicify } from \"./strings\";\n\n\nexport function throwErr(errorMessage: string, extraData?: any): never;\nexport function throwErr(error: Error): never;\nexport function throwErr(...args: StatusErrorConstructorParameters): never;\nexport function throwErr(...args: any[]): never {\n  if (typeof args[0] === \"string\") {\n    throw new HexclaveAssertionError(args[0], args[1]);\n  } else if (args[0] instanceof Error) {\n    throw args[0];\n  } else {\n    // @ts-expect-error\n    throw new StatusError(...args);\n  }\n}\n\nfunction removeStacktraceNameLine(stack: string): string {\n  // some browsers (eg. Chrome) prepend the stack with an extra line with the error name\n  const addsNameLine = new Error().stack?.startsWith(\"Error\\n\");\n  return stack.split(\"\\n\").slice(addsNameLine ? 1 : 0).join(\"\\n\");\n}\n\n\n/**\n * Concatenates the (original) stacktraces of the given errors onto the first.\n *\n * Note: Very often, the concatStacktracesIfRejected function in promises.tsx is an easier way to use this function.\n *\n * Useful when you invoke an async function to receive a promise without awaiting it immediately. Browsers are smart\n * enough to keep track of the call stack in async function calls when you invoke `.then` within the same async tick,\n * but if you don't, the stacktrace will be lost.\n *\n * Here's an example of the unwanted behavior:\n *\n * ```tsx\n * async function log() {\n *   await wait(0);  // put the task on the event loop\n *   console.log(new Error().stack);\n * }\n *\n * async function main() {\n *   await log();  // good; prints both \"log\" and \"main\" on the stacktrace\n *   log();  // bad; prints only \"log\" on the stacktrace\n * }\n * ```\n */\nexport function concatStacktraces(first: Error, ...errors: Error[]): void {\n  // some browsers (eg. Firefox) add an extra empty line at the end\n  const addsEmptyLineAtEnd = first.stack?.endsWith(\"\\n\");\n\n\n  // Add a reference to this function itself so that we know that stacktraces were concatenated\n  // If you are coming here from a stacktrace, please know that the two parts before and after this line are different\n  // stacktraces that were concatenated with concatStacktraces\n  const separator = removeStacktraceNameLine(new Error().stack ?? \"\").split(\"\\n\")[0];\n\n\n  for (const error of errors) {\n    const toAppend = removeStacktraceNameLine(error.stack ?? \"\");\n    first.stack += (addsEmptyLineAtEnd ? \"\" : \"\\n\") + separator + \"\\n\" + toAppend;\n  }\n}\n\n\nexport class HexclaveAssertionError extends Error {\n  constructor(message: string, public readonly extraData?: Record<string, any> & ErrorOptions) {\n    const disclaimer = `\\n\\nThis is likely an error in Hexclave. Please make sure you are running the newest version and report it.`;\n    super(`${message}${message.endsWith(disclaimer) ? \"\" : disclaimer}`, pick(extraData ?? {}, [\"cause\"]));\n\n    Object.defineProperty(this, \"customCaptureExtraArgs\", {\n      get() {\n        return [this.extraData];\n      },\n      enumerable: false,\n    });\n\n    // Use literal dot-form (guarded with `typeof process`) so Next.js / webpack\n    // DefinePlugin can inline the value at build time. See getProcessEnv in ./env.\n    const hexclaveDebuggerValue = typeof process !== \"undefined\" ? process.env.NEXT_PUBLIC_HEXCLAVE_DEBUGGER_ON_ASSERTION_ERROR : undefined;\n    const stackDebuggerValue = typeof process !== \"undefined\" ? process.env.NEXT_PUBLIC_STACK_DEBUGGER_ON_ASSERTION_ERROR : undefined;\n    if (hexclaveDebuggerValue && stackDebuggerValue && hexclaveDebuggerValue !== stackDebuggerValue) {\n      throw new Error(\"Environment variables NEXT_PUBLIC_HEXCLAVE_DEBUGGER_ON_ASSERTION_ERROR and NEXT_PUBLIC_STACK_DEBUGGER_ON_ASSERTION_ERROR are both set to different values. Remove one of them or set them to the same value.\");\n    }\n    if ((hexclaveDebuggerValue || stackDebuggerValue) === \"true\") {\n      debugger;\n    }\n  }\n}\nHexclaveAssertionError.prototype.name = \"HexclaveAssertionError\";\n\n\nexport function errorToNiceString(error: unknown): string {\n  if (!(error instanceof Error)) return `${typeof error}<${nicify(error)}>`;\n  return nicify(error, { maxDepth: 8 });\n}\n\n\nexport type CaptureLevel = \"error\" | \"warning\";\n\ntype ErrorSink = (location: string, error: unknown, level: CaptureLevel, ...extraArgs: unknown[]) => void;\n\nconst errorSinks = new Set<ErrorSink>();\nexport function registerErrorSink(sink: ErrorSink): void {\n  if (errorSinks.has(sink)) {\n    return;\n  }\n  errorSinks.add(sink);\n}\nregisterErrorSink((location, error, level, ...extraArgs) => {\n  const logger = level === \"warning\" ? console.warn : console.error;\n  const colorCode = level === \"warning\" ? \"\\x1b[43m\" : \"\\x1b[41m\";\n  const label = level === \"warning\" ? \"warning\" : \"error\";\n  logger(\n    `${colorCode}Captured ${label} in ${location}:`,\n    // HACK: Log a nicified version of the error to get around buggy Next.js pretty-printing\n    // https://www.reddit.com/r/nextjs/comments/1gkxdqe/comment/m19kxgn/?utm_source=share&utm_medium=web3x&utm_name=web3xcss&utm_term=1&utm_content=share_button\n    errorToNiceString(error),\n    ...extraArgs,\n    \"\\x1b[0m\",\n  );\n});\nregisterErrorSink((location, error, level, ...extraArgs) => {\n  globalVar.hexclaveCapturedErrors = globalVar.hexclaveCapturedErrors ?? [];\n  globalVar.hexclaveCapturedErrors.push({ location, error, level, extraArgs });\n});\n\nfunction dispatchToSinks(location: string, error: unknown, level: CaptureLevel): void {\n  for (const sink of errorSinks) {\n    sink(\n      location,\n      error,\n      level,\n      ...error && (typeof error === 'object' || typeof error === 'function') && \"customCaptureExtraArgs\" in error && Array.isArray(error.customCaptureExtraArgs) ? (error.customCaptureExtraArgs as any[]) : [],\n    );\n  }\n}\n\n/**\n * Captures an error and sends it to the error sinks (most notably, Sentry). Errors caught with captureError are\n * supposed to be seen by an engineer, so they should be actionable and important.\n *\n * The location string is a machine-readable ID, and should hence not contain spaces or anything like that. Good\n * examples are: \"api-route-handler\", \"renderPart()\", etc.\n *\n * Errors that bubble up to the top of runAsynchronously or a route handler are already captured with captureError.\n */\nexport function captureError(location: string, error: unknown): void {\n  dispatchToSinks(location, error, \"error\");\n}\n\n/**\n * Like captureError, but logs at warning level. Use for issues that an engineer should know about but that aren't\n * severe enough to be treated as an error (e.g. recoverable failures in background tasks).\n */\nexport function captureWarning(location: string, error: unknown): void {\n  dispatchToSinks(location, error, \"warning\");\n}\n\n\ntype Status = {\n  statusCode: number,\n  message: string,\n};\n\ntype StatusErrorConstructorParameters =\n| [\n  status: Status,\n  message?: string\n]\n| [\n  statusCode: number | Status,\n  message: string,\n];\n\nexport class StatusError extends Error {\n  private readonly __stackStatusErrorBrand = \"stack-status-error-brand-sentinel\" as const;\n  public name = \"StatusError\";\n  public readonly statusCode: number;\n\n  public static BadRequest = { statusCode: 400, message: \"Bad Request\" };\n  public static Unauthorized = { statusCode: 401, message: \"Unauthorized\" };\n  public static PaymentRequired = { statusCode: 402, message: \"Payment Required\" };\n  public static Forbidden = { statusCode: 403, message: \"Forbidden\" };\n  public static NotFound = { statusCode: 404, message: \"Not Found\" };\n  public static MethodNotAllowed = { statusCode: 405, message: \"Method Not Allowed\" };\n  public static NotAcceptable = { statusCode: 406, message: \"Not Acceptable\" };\n  public static ProxyAuthenticationRequired = { statusCode: 407, message: \"Proxy Authentication Required\" };\n  public static RequestTimeout = { statusCode: 408, message: \"Request Timeout\" };\n  public static Conflict = { statusCode: 409, message: \"Conflict\" };\n  public static Gone = { statusCode: 410, message: \"Gone\" };\n  public static LengthRequired = { statusCode: 411, message: \"Length Required\" };\n  public static PreconditionFailed = { statusCode: 412, message: \"Precondition Failed\" };\n  public static PayloadTooLarge = { statusCode: 413, message: \"Payload Too Large\" };\n  public static URITooLong = { statusCode: 414, message: \"URI Too Long\" };\n  public static UnsupportedMediaType = { statusCode: 415, message: \"Unsupported Media Type\" };\n  public static RangeNotSatisfiable = { statusCode: 416, message: \"Range Not Satisfiable\" };\n  public static ExpectationFailed = { statusCode: 417, message: \"Expectation Failed\" };\n  public static ImATeapot = { statusCode: 418, message: \"I'm a teapot\" };\n  public static MisdirectedRequest = { statusCode: 421, message: \"Misdirected Request\" };\n  public static UnprocessableEntity = { statusCode: 422, message: \"Unprocessable Entity\" };\n  public static Locked = { statusCode: 423, message: \"Locked\" };\n  public static FailedDependency = { statusCode: 424, message: \"Failed Dependency\" };\n  public static TooEarly = { statusCode: 425, message: \"Too Early\" };\n  public static UpgradeRequired = { statusCode: 426, message: \"Upgrade Required\" };\n  public static PreconditionRequired = { statusCode: 428, message: \"Precondition Required\" };\n  public static TooManyRequests = { statusCode: 429, message: \"Too Many Requests\" };\n  public static RequestHeaderFieldsTooLarge = { statusCode: 431, message: \"Request Header Fields Too Large\" };\n  public static UnavailableForLegalReasons = { statusCode: 451, message: \"Unavailable For Legal Reasons\" };\n\n  public static InternalServerError = { statusCode: 500, message: \"Internal Server Error\" };\n  public static NotImplemented = { statusCode: 501, message: \"Not Implemented\" };\n  public static BadGateway = { statusCode: 502, message: \"Bad Gateway\" };\n  public static ServiceUnavailable = { statusCode: 503, message: \"Service Unavailable\" };\n  public static GatewayTimeout = { statusCode: 504, message: \"Gateway Timeout\" };\n  public static HTTPVersionNotSupported = { statusCode: 505, message: \"HTTP Version Not Supported\" };\n  public static VariantAlsoNegotiates = { statusCode: 506, message: \"Variant Also Negotiates\" };\n  public static InsufficientStorage = { statusCode: 507, message: \"Insufficient Storage\" };\n  public static LoopDetected = { statusCode: 508, message: \"Loop Detected\" };\n  public static NotExtended = { statusCode: 510, message: \"Not Extended\" };\n  public static NetworkAuthenticationRequired = { statusCode: 511, message: \"Network Authentication Required\" };\n\n\n  constructor(...args: StatusErrorConstructorParameters);\n  constructor(\n    status: number | Status,\n    message?: string,\n  ) {\n    if (typeof status === \"object\") {\n      message ??= status.message;\n      status = status.statusCode;\n    }\n    super(message);\n    this.statusCode = status;\n    if (!message) {\n      throw new HexclaveAssertionError(\"StatusError always requires a message unless a Status object is passed\", { cause: this });\n    }\n  }\n\n  public static isStatusError(error: unknown): error is StatusError {\n    // like instanceof, but also works for errors thrown in other realms or by different versions of the same package\n    return typeof error === \"object\" && error !== null && \"__stackStatusErrorBrand\" in error && error.__stackStatusErrorBrand === \"stack-status-error-brand-sentinel\";\n  }\n\n  public isClientError() {\n    return this.statusCode >= 400 && this.statusCode < 500;\n  }\n\n  public isServerError() {\n    return !this.isClientError();\n  }\n\n  public getStatusCode(): number {\n    return this.statusCode;\n  }\n\n  public getBody(): Uint8Array {\n    return new TextEncoder().encode(this.message);\n  }\n\n  public getHeaders(): Record<string, string[]> {\n    return {\n      \"Content-Type\": [\"text/plain; charset=utf-8\"],\n    };\n  }\n\n  public toDescriptiveJson(): Json {\n    return {\n      status_code: this.getStatusCode(),\n      message: this.message,\n      headers: this.getHeaders(),\n    };\n  }\n\n  /**\n   * @deprecated this is not a good way to make status errors human-readable, use toDescriptiveJson instead\n   */\n  public toHttpJson(): Json {\n    return {\n      status_code: this.statusCode,\n      body: this.message,\n      headers: this.getHeaders(),\n    };\n  }\n}\nStatusError.prototype.name = \"StatusError\";\n"],"mappings":"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"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../../src/utils/errors.tsx"],"sourcesContent":["import { globalVar } from \"./globals\";\nimport { Json } from \"./json\";\nimport { pick } from \"./objects\";\nimport { nicify } from \"./strings\";\n\n\nexport function throwErr(errorMessage: string, extraData?: any): never;\nexport function throwErr(error: Error): never;\nexport function throwErr(...args: StatusErrorConstructorParameters): never;\nexport function throwErr(...args: any[]): never {\n  if (typeof args[0] === \"string\") {\n    throw new HexclaveAssertionError(args[0], args[1]);\n  } else if (args[0] instanceof Error) {\n    throw args[0];\n  } else {\n    // @ts-expect-error\n    throw new StatusError(...args);\n  }\n}\n\nfunction removeStacktraceNameLine(stack: string): string {\n  // some browsers (eg. Chrome) prepend the stack with an extra line with the error name\n  const addsNameLine = new Error().stack?.startsWith(\"Error\\n\");\n  return stack.split(\"\\n\").slice(addsNameLine ? 1 : 0).join(\"\\n\");\n}\n\n\n/**\n * Concatenates the (original) stacktraces of the given errors onto the first.\n *\n * Note: Very often, the concatStacktracesIfRejected function in promises.tsx is an easier way to use this function.\n *\n * Useful when you invoke an async function to receive a promise without awaiting it immediately. Browsers are smart\n * enough to keep track of the call stack in async function calls when you invoke `.then` within the same async tick,\n * but if you don't, the stacktrace will be lost.\n *\n * Here's an example of the unwanted behavior:\n *\n * ```tsx\n * async function log() {\n *   await wait(0);  // put the task on the event loop\n *   console.log(new Error().stack);\n * }\n *\n * async function main() {\n *   await log();  // good; prints both \"log\" and \"main\" on the stacktrace\n *   log();  // bad; prints only \"log\" on the stacktrace\n * }\n * ```\n */\nexport function concatStacktraces(first: Error, ...errors: Error[]): void {\n  // some browsers (eg. Firefox) add an extra empty line at the end\n  const addsEmptyLineAtEnd = first.stack?.endsWith(\"\\n\");\n\n\n  // Add a reference to this function itself so that we know that stacktraces were concatenated\n  // If you are coming here from a stacktrace, please know that the two parts before and after this line are different\n  // stacktraces that were concatenated with concatStacktraces\n  const separator = removeStacktraceNameLine(new Error().stack ?? \"\").split(\"\\n\")[0];\n\n\n  for (const error of errors) {\n    const toAppend = removeStacktraceNameLine(error.stack ?? \"\");\n    first.stack += (addsEmptyLineAtEnd ? \"\" : \"\\n\") + separator + \"\\n\" + toAppend;\n  }\n}\n\n\nexport class HexclaveAssertionError extends Error {\n  constructor(message: string, public readonly extraData?: Record<string, any> & ErrorOptions) {\n    const disclaimer = `\\n\\nThis is likely an error in Hexclave. Please make sure you are running the newest version and report it.`;\n    super(`${message}${message.endsWith(disclaimer) ? \"\" : disclaimer}`, pick(extraData ?? {}, [\"cause\"]));\n\n    Object.defineProperty(this, \"customCaptureExtraArgs\", {\n      get() {\n        return [this.extraData];\n      },\n      enumerable: false,\n    });\n\n    // Use literal dot-form (guarded with `typeof process`) so Next.js / webpack\n    // DefinePlugin can inline the value at build time. See getProcessEnv in ./env.\n    const hexclaveDebuggerValue = typeof process !== \"undefined\" ? process.env.NEXT_PUBLIC_HEXCLAVE_DEBUGGER_ON_ASSERTION_ERROR : undefined;\n    const stackDebuggerValue = typeof process !== \"undefined\" ? process.env.NEXT_PUBLIC_STACK_DEBUGGER_ON_ASSERTION_ERROR : undefined;\n    if (hexclaveDebuggerValue && stackDebuggerValue && hexclaveDebuggerValue !== stackDebuggerValue) {\n      throw new Error(\"Environment variables NEXT_PUBLIC_HEXCLAVE_DEBUGGER_ON_ASSERTION_ERROR and NEXT_PUBLIC_STACK_DEBUGGER_ON_ASSERTION_ERROR are both set to different values. Remove one of them or set them to the same value.\");\n    }\n    if ((hexclaveDebuggerValue || stackDebuggerValue) === \"true\") {\n      debugger;\n    }\n  }\n}\nHexclaveAssertionError.prototype.name = \"HexclaveAssertionError\";\n\n\nexport function errorToNiceString(error: unknown): string {\n  if (!(error instanceof Error)) return `${typeof error}<${nicify(error)}>`;\n  return nicify(error, { maxDepth: 8 });\n}\n\n\nexport type CaptureLevel = \"error\" | \"warning\";\n\ntype ErrorSink = (location: string, error: unknown, level: CaptureLevel, ...extraArgs: unknown[]) => void;\n\nconst errorSinks = new Set<ErrorSink>();\nexport function registerErrorSink(sink: ErrorSink): void {\n  if (errorSinks.has(sink)) {\n    return;\n  }\n  errorSinks.add(sink);\n}\nregisterErrorSink((location, error, level, ...extraArgs) => {\n  const logger = level === \"warning\" ? console.warn : console.error;\n  const colorCode = level === \"warning\" ? \"\\x1b[43m\" : \"\\x1b[41m\";\n  const label = level === \"warning\" ? \"warning\" : \"error\";\n  logger(\n    `${colorCode}Captured ${label} in ${location}:`,\n    // HACK: Log a nicified version of the error to get around buggy Next.js pretty-printing\n    // https://www.reddit.com/r/nextjs/comments/1gkxdqe/comment/m19kxgn/?utm_source=share&utm_medium=web3x&utm_name=web3xcss&utm_term=1&utm_content=share_button\n    errorToNiceString(error),\n    ...extraArgs,\n    \"\\x1b[0m\",\n  );\n});\nregisterErrorSink((location, error, level, ...extraArgs) => {\n  globalVar.hexclaveCapturedErrors = globalVar.hexclaveCapturedErrors ?? [];\n  globalVar.hexclaveCapturedErrors.push({ location, error, level, extraArgs });\n});\n\nfunction dispatchToSinks(location: string, error: unknown, level: CaptureLevel): void {\n  for (const sink of errorSinks) {\n    sink(\n      location,\n      error,\n      level,\n      ...error && (typeof error === 'object' || typeof error === 'function') && \"customCaptureExtraArgs\" in error && Array.isArray(error.customCaptureExtraArgs) ? (error.customCaptureExtraArgs as any[]) : [],\n    );\n  }\n}\n\n/**\n * Captures an error and sends it to the error sinks (most notably, Sentry). Errors caught with captureError are\n * supposed to be seen by an engineer, so they should be actionable and important.\n *\n * The location string is a machine-readable ID, and should hence not contain spaces or anything like that. Good\n * examples are: \"api-route-handler\", \"renderPart()\", etc.\n *\n * Errors that bubble up to the top of runAsynchronously or a route handler are already captured with captureError.\n */\nexport function captureError(location: string, error: unknown): void {\n  dispatchToSinks(location, error, \"error\");\n}\n\n/**\n * Like captureError, but logs at warning level. Use for issues that an engineer should know about but that aren't\n * severe enough to be treated as an error (e.g. recoverable failures in background tasks).\n */\nexport function captureWarning(location: string, error: unknown): void {\n  dispatchToSinks(location, error, \"warning\");\n}\n\n\ntype Status = {\n  statusCode: number,\n  message: string,\n};\n\ntype StatusErrorConstructorParameters =\n| [\n  status: Status,\n  message?: string\n]\n| [\n  statusCode: number | Status,\n  message: string,\n];\n\nexport class StatusError extends Error {\n  private readonly __stackStatusErrorBrand = \"stack-status-error-brand-sentinel\" as const;\n  public name = \"StatusError\";\n  public readonly statusCode: number;\n\n  public static BadRequest = { statusCode: 400, message: \"Bad Request\" };\n  public static Unauthorized = { statusCode: 401, message: \"Unauthorized\" };\n  public static PaymentRequired = { statusCode: 402, message: \"Payment Required\" };\n  public static Forbidden = { statusCode: 403, message: \"Forbidden\" };\n  public static NotFound = { statusCode: 404, message: \"Not Found\" };\n  public static MethodNotAllowed = { statusCode: 405, message: \"Method Not Allowed\" };\n  public static NotAcceptable = { statusCode: 406, message: \"Not Acceptable\" };\n  public static ProxyAuthenticationRequired = { statusCode: 407, message: \"Proxy Authentication Required\" };\n  public static RequestTimeout = { statusCode: 408, message: \"Request Timeout\" };\n  public static Conflict = { statusCode: 409, message: \"Conflict\" };\n  public static Gone = { statusCode: 410, message: \"Gone\" };\n  public static LengthRequired = { statusCode: 411, message: \"Length Required\" };\n  public static PreconditionFailed = { statusCode: 412, message: \"Precondition Failed\" };\n  public static PayloadTooLarge = { statusCode: 413, message: \"Payload Too Large\" };\n  public static URITooLong = { statusCode: 414, message: \"URI Too Long\" };\n  public static UnsupportedMediaType = { statusCode: 415, message: \"Unsupported Media Type\" };\n  public static RangeNotSatisfiable = { statusCode: 416, message: \"Range Not Satisfiable\" };\n  public static ExpectationFailed = { statusCode: 417, message: \"Expectation Failed\" };\n  public static ImATeapot = { statusCode: 418, message: \"I'm a teapot\" };\n  public static MisdirectedRequest = { statusCode: 421, message: \"Misdirected Request\" };\n  public static UnprocessableEntity = { statusCode: 422, message: \"Unprocessable Entity\" };\n  public static Locked = { statusCode: 423, message: \"Locked\" };\n  public static FailedDependency = { statusCode: 424, message: \"Failed Dependency\" };\n  public static TooEarly = { statusCode: 425, message: \"Too Early\" };\n  public static UpgradeRequired = { statusCode: 426, message: \"Upgrade Required\" };\n  public static PreconditionRequired = { statusCode: 428, message: \"Precondition Required\" };\n  public static TooManyRequests = { statusCode: 429, message: \"Too Many Requests\" };\n  public static RequestHeaderFieldsTooLarge = { statusCode: 431, message: \"Request Header Fields Too Large\" };\n  public static UnavailableForLegalReasons = { statusCode: 451, message: \"Unavailable For Legal Reasons\" };\n\n  public static InternalServerError = { statusCode: 500, message: \"Internal Server Error\" };\n  public static NotImplemented = { statusCode: 501, message: \"Not Implemented\" };\n  public static BadGateway = { statusCode: 502, message: \"Bad Gateway\" };\n  public static ServiceUnavailable = { statusCode: 503, message: \"Service Unavailable\" };\n  public static GatewayTimeout = { statusCode: 504, message: \"Gateway Timeout\" };\n  public static HTTPVersionNotSupported = { statusCode: 505, message: \"HTTP Version Not Supported\" };\n  public static VariantAlsoNegotiates = { statusCode: 506, message: \"Variant Also Negotiates\" };\n  public static InsufficientStorage = { statusCode: 507, message: \"Insufficient Storage\" };\n  public static LoopDetected = { statusCode: 508, message: \"Loop Detected\" };\n  public static NotExtended = { statusCode: 510, message: \"Not Extended\" };\n  public static NetworkAuthenticationRequired = { statusCode: 511, message: \"Network Authentication Required\" };\n\n\n  constructor(...args: StatusErrorConstructorParameters);\n  constructor(\n    status: number | Status,\n    message?: string,\n  ) {\n    if (typeof status === \"object\") {\n      message ??= status.message;\n      status = status.statusCode;\n    }\n    super(message);\n    this.statusCode = status;\n    if (!message) {\n      throw new HexclaveAssertionError(\"StatusError always requires a message unless a Status object is passed\", { cause: this });\n    }\n  }\n\n  public static isStatusError(error: unknown): error is StatusError {\n    // like instanceof, but also works for errors thrown in other realms or by different versions of the same package\n    return typeof error === \"object\" && error !== null && \"__stackStatusErrorBrand\" in error && error.__stackStatusErrorBrand === \"stack-status-error-brand-sentinel\";\n  }\n\n  public isClientError() {\n    return this.statusCode >= 400 && this.statusCode < 500;\n  }\n\n  public isServerError() {\n    return !this.isClientError();\n  }\n\n  public getStatusCode(): number {\n    return this.statusCode;\n  }\n\n  public getBody(): Uint8Array {\n    return new TextEncoder().encode(this.message);\n  }\n\n  public getHeaders(): Record<string, string[]> {\n    return {\n      \"Content-Type\": [\"text/plain; charset=utf-8\"],\n    };\n  }\n\n  public toDescriptiveJson(): Json {\n    return {\n      status_code: this.getStatusCode(),\n      message: this.message,\n      headers: this.getHeaders(),\n    };\n  }\n\n  /**\n   * @deprecated this is not a good way to make status errors human-readable, use toDescriptiveJson instead\n   */\n  public toHttpJson(): Json {\n    return {\n      status_code: this.statusCode,\n      body: this.message,\n      headers: this.getHeaders(),\n    };\n  }\n}\nStatusError.prototype.name = \"StatusError\";\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { Result } from "./results";
+import { Result } from "./results.js";
 
 //#region src/utils/esbuild.d.ts
 declare function initializeEsbuild(): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"esbuild.d.ts","names":[],"sources":["../../../src/utils/esbuild.tsx"],"mappings":";;;iBA0BgB,iBAAA,CAAA,GAAqB,OAAA;AAAA,iBAgDf,gBAAA,CAAiB,WAAA,EAAa,MAAA;EAA2B,WAAA;AAAA,GAAuB,OAAA;EACpG,MAAA;EACA,gBAAA,GAAmB,MAAA;EACnB,aAAA;EACA,SAAA;EACA,gBAAA;AAAA,IACO,OAAA,CAAQ,MAAA"}
+{"version":3,"file":"esbuild.d.ts","names":[],"sources":["../../../src/utils/esbuild.tsx"],"mappings":";;;iBA0BgB,iBAAA,IAAqB,OAAO;AAAA,iBAgDtB,gBAAA,CAAiB,WAAA,EAAa,MAAA;EAA2B,WAAA;AAAA,GAAuB,OAAA;EACpG,MAAA;EACA,gBAAA,GAAmB,MAAA;EACnB,aAAA;EACA,SAAA;EACA,gBAAA;AAAA,IACO,OAAA,CAAQ,MAAA"}

package/dist/esm/utils/esbuild.js

@@ -6,7 +6,6 @@ import { createGlobalAsync } from "./globals.js";
 import { Result } from "./results.js";
 import * as esbuild from "esbuild-wasm/lib/browser.js";
 import { traceSpan, withTraceSpan } from "./telemetry.js";
-
 //#region src/utils/esbuild.tsx
 globalThis.self ??= globalThis;
 let esbuildInitializePromise = null;
@@ -55,7 +54,7 @@ async function bundleJavaScript(sourceFiles, options = {}) {
 	const externalPackagesMap = new Map(Object.entries(options.externalPackages ?? {}));
 	const keepAsImports = options.keepAsImports ?? [];
 	const httpImportCache = /* @__PURE__ */ new Map();
-	const extToLoader = new Map([
+	const extToLoader = /* @__PURE__ */ new Map([
 		["tsx", "tsx"],
 		["ts", "ts"],
 		["js", "js"],
@@ -175,7 +174,7 @@ async function bundleJavaScript(sourceFiles, options = {}) {
 	if (result.outputFiles.length > 0) return Result.ok(result.outputFiles[0].text);
 	return throwErr("No output generated??");
 }
-
 //#endregion
 export { bundleJavaScript, initializeEsbuild };
+
 //# sourceMappingURL=esbuild.js.map