@hexclave/shared 1.0.14 → 1.0.16

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

@@ -0,0 +1,297 @@
+//#region src/utils/elements-chain.tsx
+const ELEMENTS_CHAIN_MAX_DEPTH = 8;
+const ELEMENTS_CHAIN_TEXT_MAX = 80;
+const ELEMENTS_CHAIN_ATTR_MAX = 200;
+const ELEMENTS_CHAIN_ATTRS = [
+	"id",
+	"data-testid",
+	"data-test-id",
+	"data-hexclave-id",
+	"name",
+	"type",
+	"role",
+	"aria-label",
+	"placeholder",
+	"title"
+];
+function escapeElementsChainValue(value) {
+	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+}
+function escapeElementsChainClass(value) {
+	return value.replace(/\\/g, "\\\\").replace(/\./g, "\\.").replace(/:/g, "\\:");
+}
+function getElementClasses(element) {
+	const className = element.className;
+	if (typeof className !== "string" || className.trim() === "") return [];
+	return className.trim().split(/\s+/).filter(Boolean).slice(0, 4);
+}
+function getNthChildIndex(element) {
+	const parent = element.parentElement;
+	if (parent == null) return null;
+	const index = Array.prototype.indexOf.call(parent.children, element);
+	return index >= 0 ? index + 1 : null;
+}
+function getNthOfTypeIndex(element) {
+	const parent = element.parentElement;
+	if (parent == null) return null;
+	const tagName = element.tagName;
+	const siblings = Array.from(parent.children).filter((child) => child.tagName === tagName);
+	if (siblings.length <= 1) return null;
+	const index = siblings.indexOf(element);
+	return index >= 0 ? index + 1 : null;
+}
+function serializeElementsChainSegment(element) {
+	const parts = [];
+	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 nthChild = getNthChildIndex(element);
+	const nthOfType = getNthOfTypeIndex(element);
+	const attrPairs = [];
+	if (nthChild != null) attrPairs.push(`nth-child="${nthChild}"`);
+	if (nthOfType != null) attrPairs.push(`nth-of-type="${nthOfType}"`);
+	if (text !== "") attrPairs.push(`text="${escapeElementsChainValue(text)}"`);
+	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))}"`);
+	}
+	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 (attrPairs.length > 0) parts.push(`:${attrPairs.join(":")}`);
+	return parts.join("");
+}
+/**
+* Serialise a clicked element and up to {@link ELEMENTS_CHAIN_MAX_DEPTH}
+* ancestors (leaf-first) into an `elements_chain` string.
+*/
+function buildElementsChain(element) {
+	const segments = [];
+	let current = element;
+	let depth = 0;
+	while (current != null && depth < ELEMENTS_CHAIN_MAX_DEPTH && current !== document.documentElement) {
+		segments.push(serializeElementsChainSegment(current));
+		current = current.parentElement;
+		depth += 1;
+	}
+	return segments.join(";");
+}
+function splitEscapedDots(input) {
+	const out = [];
+	let cur = "";
+	for (let i = 0; i < input.length; i++) {
+		const ch = input[i];
+		if (ch === "\\" && i + 1 < input.length) {
+			cur += input[i + 1];
+			i += 1;
+			continue;
+		}
+		if (ch === ".") {
+			out.push(cur);
+			cur = "";
+			continue;
+		}
+		cur += ch;
+	}
+	out.push(cur);
+	return out;
+}
+function applyElementsChainAttr(key, value) {
+	if (key === "nth-child") {
+		const n = Number.parseInt(value, 10);
+		return Number.isFinite(n) ? { nthChild: n } : {};
+	}
+	if (key === "nth-of-type") {
+		const n = Number.parseInt(value, 10);
+		return Number.isFinite(n) ? { nthOfType: n } : {};
+	}
+	if (key === "text") return { text: value };
+	if (key === "href") return {
+		href: value,
+		attrKey: key,
+		attrValue: value
+	};
+	if (key.startsWith("attr__")) return {
+		attrKey: key.slice(6),
+		attrValue: value
+	};
+	return {
+		attrKey: key,
+		attrValue: value
+	};
+}
+function parseElementsChainSegment(segment) {
+	const trimmed = segment.trim();
+	if (trimmed === "") return null;
+	let prefixEnd = trimmed.length;
+	let inQuotes = false;
+	for (let i = 0; i < trimmed.length; i++) {
+		const ch = trimmed[i];
+		if (ch === "\\" && i + 1 < trimmed.length) {
+			i += 1;
+			continue;
+		}
+		if (ch === "\"") {
+			inQuotes = !inQuotes;
+			continue;
+		}
+		if (ch === ":" && !inQuotes) {
+			prefixEnd = i;
+			break;
+		}
+	}
+	const prefix = trimmed.slice(0, prefixEnd);
+	const rest = trimmed.slice(prefixEnd);
+	const prefixParts = splitEscapedDots(prefix);
+	const tag = prefixParts[0].trim().toLowerCase();
+	if (tag === "") return null;
+	const classes = prefixParts.slice(1).map((c) => c.trim()).filter((c) => c !== "");
+	const attrs = {};
+	let nthChild = null;
+	let nthOfType = null;
+	let text = null;
+	let href = null;
+	let i = 0;
+	while (i < rest.length) {
+		if (rest[i] !== ":") {
+			i += 1;
+			continue;
+		}
+		i += 1;
+		let keyEnd = i;
+		while (keyEnd < rest.length && rest[keyEnd] !== "=" && rest[keyEnd] !== ":") keyEnd += 1;
+		const key = rest.slice(i, keyEnd).trim();
+		if (keyEnd >= rest.length || rest[keyEnd] !== "=") {
+			i = keyEnd;
+			continue;
+		}
+		let valStart = keyEnd + 1;
+		if (rest[valStart] !== "\"") {
+			let end = valStart;
+			while (end < rest.length && rest[end] !== ":") end += 1;
+			const result = applyElementsChainAttr(key, rest.slice(valStart, end));
+			if (result.nthChild != null) nthChild = result.nthChild;
+			if (result.nthOfType != null) nthOfType = result.nthOfType;
+			if (result.text != null) text = result.text;
+			if (result.href != null) href = result.href;
+			if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? "";
+			i = end;
+			continue;
+		}
+		valStart += 1;
+		let end = valStart;
+		let value = "";
+		while (end < rest.length) {
+			const ch = rest[end];
+			if (ch === "\\" && end + 1 < rest.length) {
+				const next = rest[end + 1];
+				if (next === "\"" || next === "\\") {
+					value += next;
+					end += 2;
+					continue;
+				}
+				value += ch;
+				end += 1;
+				continue;
+			}
+			if (ch === "\"") break;
+			value += ch;
+			end += 1;
+		}
+		const result = applyElementsChainAttr(key, value);
+		if (result.nthChild != null) nthChild = result.nthChild;
+		if (result.nthOfType != null) nthOfType = result.nthOfType;
+		if (result.text != null) text = result.text;
+		if (result.href != null) href = result.href;
+		if (result.attrKey != null) attrs[result.attrKey] = result.attrValue ?? "";
+		i = end + 1;
+	}
+	return {
+		tag,
+		classes,
+		attrs,
+		text,
+		nthChild,
+		nthOfType,
+		href
+	};
+}
+/** Parse an `elements_chain` string into structured, leaf-first segments. */
+function parseElementsChain(chain) {
+	const segments = [];
+	let current = "";
+	let inQuotes = false;
+	for (let i = 0; i < chain.length; i++) {
+		const ch = chain[i];
+		if (ch === "\\" && i + 1 < chain.length) {
+			current += ch + chain[i + 1];
+			i += 1;
+			continue;
+		}
+		if (ch === "\"") {
+			inQuotes = !inQuotes;
+			current += ch;
+			continue;
+		}
+		if (ch === ";" && !inQuotes) {
+			segments.push(current);
+			current = "";
+			continue;
+		}
+		current += ch;
+	}
+	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

@@ -0,0 +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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"}

package/dist/hexclave-config-file.d.ts

@@ -9,7 +9,30 @@ declare const showOnboardingHexclaveConfigValue = "show-onboarding";
  */
 declare function renderConfigFileContent(config: unknown, importPackage?: string): string;
 type ParsedStackConfig = Record<string, unknown> | typeof showOnboardingHexclaveConfigValue;
+/**
+ * Like {@link parseHexclaveConfigFileContent}, but returns `null` instead of
+ * throwing when the file is not a plain static config (e.g. it wraps the config
+ * in a helper call, references imported values, or has a syntax error). Useful
+ * for deciding whether a config file can be safely regenerated deterministically
+ * or whether it has custom structure that must be preserved.
+ */
+declare function tryParseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig | null;
+/**
+ * Returns whether `content` parses as a module that exports a `config` binding.
+ * Used as a lightweight structural sanity check after editing config files whose
+ * values can't be evaluated by our loader (e.g. they import external text
+ * files), where a full semantic comparison isn't possible.
+ */
+declare function hexclaveConfigFileExportsConfig(content: string, filePath: string): boolean;
+/**
+ * Returns the relative import sources (those starting with `./` or `../`)
+ * declared in `content`. Used to discover the external files a config update may
+ * touch — e.g. `import x from "./welcome-email.tsx" with { type: "text" }` — so
+ * they can be snapshotted and rolled back if an in-place update fails. Returns
+ * an empty array if the file can't be parsed.
+ */
+declare function getRelativeImportSpecifiers(content: string): string[];
 declare function parseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig;
 //#endregion
-export { parseHexclaveConfigFileContent, renderConfigFileContent, showOnboardingHexclaveConfigValue };
+export { getRelativeImportSpecifiers, hexclaveConfigFileExportsConfig, parseHexclaveConfigFileContent, renderConfigFileContent, showOnboardingHexclaveConfigValue, tryParseHexclaveConfigFileContent };
 //# sourceMappingURL=hexclave-config-file.d.ts.map

package/dist/hexclave-config-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hexclave-config-file.d.ts","names":[],"sources":["../src/hexclave-config-file.ts"],"mappings":";cAIa,iCAAA;AAAb;;;;;AAWA;;AAXA,iBAWgB,uBAAA,CAAwB,MAAA,WAAiB,aAAA;AAAA,KAyBpD,iBAAA,GAAoB,MAAA,2BAAiC,iCAAA;AAAA,iBA8D1C,8BAAA,CAA+B,OAAA,UAAiB,QAAA,WAAmB,iBAAA"}
+{"version":3,"file":"hexclave-config-file.d.ts","names":[],"sources":["../src/hexclave-config-file.ts"],"mappings":";cAIa,iCAAA;AAAb;;;;;AAWA;;AAXA,iBAWgB,uBAAA,CAAwB,MAAA,WAAiB,aAAA;AAAA,KAyBpD,iBAAA,GAAoB,MAAA,2BAAiC,iCAAA;;AAFzD;;;;;AAuED;iBAAgB,iCAAA,CAAkC,OAAA,UAAiB,QAAA,WAAmB,iBAAA;;;;;;;iBActE,+BAAA,CAAgC,OAAA,UAAiB,QAAA;AAAjE;;;;;AA8CA;;AA9CA,iBA8CgB,2BAAA,CAA4B,OAAA;AAAA,iBAsB5B,8BAAA,CAA+B,OAAA,UAAiB,QAAA,WAAmB,iBAAA"}

package/dist/hexclave-config-file.js

@@ -59,11 +59,78 @@ function evaluateStaticConfigExpression(expression) {
 	}
 	throw new Error(`Unsupported config expression: ${unwrapped.type}`);
 }
+/**
+* Like {@link parseHexclaveConfigFileContent}, but returns `null` instead of
+* throwing when the file is not a plain static config (e.g. it wraps the config
+* in a helper call, references imported values, or has a syntax error). Useful
+* for deciding whether a config file can be safely regenerated deterministically
+* or whether it has custom structure that must be preserved.
+*/
+function tryParseHexclaveConfigFileContent(content, filePath) {
+	try {
+		return parseHexclaveConfigFileContent(content, filePath);
+	} catch {
+		return null;
+	}
+}
+/**
+* Returns whether `content` parses as a module that exports a `config` binding.
+* Used as a lightweight structural sanity check after editing config files whose
+* values can't be evaluated by our loader (e.g. they import external text
+* files), where a full semantic comparison isn't possible.
+*/
+function hexclaveConfigFileExportsConfig(content, filePath) {
+	let ast;
+	try {
+		ast = _babel_parser.parse(content, {
+			sourceType: "module",
+			sourceFilename: filePath,
+			plugins: ["typescript", "importAttributes"]
+		});
+	} catch {
+		return false;
+	}
+	for (const statement of ast.program.body) {
+		if (!_babel_types.isExportNamedDeclaration(statement)) continue;
+		if (statement.exportKind === "type") continue;
+		if (_babel_types.isVariableDeclaration(statement.declaration)) {
+			for (const declaration of statement.declaration.declarations) if (_babel_types.isIdentifier(declaration.id) && declaration.id.name === "config" && declaration.init != null) return true;
+		}
+		for (const specifier of statement.specifiers) if (_babel_types.isExportSpecifier(specifier) && specifier.exportKind !== "type") {
+			if ((_babel_types.isIdentifier(specifier.exported) ? specifier.exported.name : specifier.exported.value) === "config") return true;
+		}
+	}
+	return false;
+}
+/**
+* Returns the relative import sources (those starting with `./` or `../`)
+* declared in `content`. Used to discover the external files a config update may
+* touch — e.g. `import x from "./welcome-email.tsx" with { type: "text" }` — so
+* they can be snapshotted and rolled back if an in-place update fails. Returns
+* an empty array if the file can't be parsed.
+*/
+function getRelativeImportSpecifiers(content) {
+	let ast;
+	try {
+		ast = _babel_parser.parse(content, {
+			sourceType: "module",
+			plugins: ["typescript", "importAttributes"]
+		});
+	} catch {
+		return [];
+	}
+	const sources = [];
+	for (const statement of ast.program.body) if (_babel_types.isImportDeclaration(statement)) {
+		const source = statement.source.value;
+		if (source.startsWith("./") || source.startsWith("../")) sources.push(source);
+	}
+	return sources;
+}
 function parseHexclaveConfigFileContent(content, filePath) {
 	if (content.trim() === "") return {};
 	const ast = _babel_parser.parse(content, {
 		sourceType: "module",
-		plugins: ["typescript"]
+		plugins: ["typescript", "importAttributes"]
 	});
 	for (const statement of ast.program.body) {
 		if (!_babel_types.isExportNamedDeclaration(statement) || !_babel_types.isVariableDeclaration(statement.declaration)) continue;
@@ -77,7 +144,10 @@ function parseHexclaveConfigFileContent(content, filePath) {
 }
 
 //#endregion
+exports.getRelativeImportSpecifiers = getRelativeImportSpecifiers;
+exports.hexclaveConfigFileExportsConfig = hexclaveConfigFileExportsConfig;
 exports.parseHexclaveConfigFileContent = parseHexclaveConfigFileContent;
 exports.renderConfigFileContent = renderConfigFileContent;
 exports.showOnboardingHexclaveConfigValue = showOnboardingHexclaveConfigValue;
+exports.tryParseHexclaveConfigFileContent = tryParseHexclaveConfigFileContent;
 //# sourceMappingURL=hexclave-config-file.js.map

package/dist/hexclave-config-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"hexclave-config-file.js","names":["t","parser"],"sources":["../src/hexclave-config-file.ts"],"sourcesContent":["import * as parser from \"@babel/parser\";\nimport * as t from \"@babel/types\";\nimport { isValidConfig, normalize } from \"./config/format\";\n\nexport const showOnboardingHexclaveConfigValue = \"show-onboarding\";\n\nconst DEFAULT_CONFIG_IMPORT_PACKAGE = \"@hexclave/js\";\n\n/**\n * Renders a config object into the source text of a `stack.config.ts` file.\n *\n * Browser-safe: kept here (next to `parseHexclaveConfigFileContent`) instead of in\n * `config-rendering.ts` so dashboard client code can render config files\n * without pulling in `fs` / `path`.\n */\nexport function renderConfigFileContent(config: unknown, importPackage?: string): string {\n  if (!isValidConfig(config)) {\n    throw new Error(\"Invalid config: expected a plain object.\");\n  }\n\n  const droppedKeys: string[] = [];\n  const normalizedConfig = normalize(config, {\n    onDotIntoNonObject: \"ignore\",\n    onDotIntoNull: \"empty-object\",\n    droppedKeys,\n  });\n  if (droppedKeys.length > 0) {\n    throw new Error(`Config has conflicting keys that would be dropped during normalization: ${droppedKeys.map(k => JSON.stringify(k)).join(\", \")}`);\n  }\n  const pkg = importPackage ?? DEFAULT_CONFIG_IMPORT_PACKAGE;\n  // Import the `HexclaveConfig` type from the package's lightweight `/config`\n  // entrypoint, which is free of framework runtime code and therefore safe for\n  // tooling (e.g. the local dashboard) to load in a plain Node context. Only the\n  // Hexclave-branded packages expose this subpath; legacy `@stackframe/*`\n  // releases predate it, so fall back to their package root.\n  const importSpecifier = pkg.startsWith(\"@hexclave/\") ? `${pkg}/config` : pkg;\n  const importLine = `import type { HexclaveConfig } from \"${importSpecifier}\";`;\n  return `${importLine}\\n\\nexport const config: HexclaveConfig = ${JSON.stringify(normalizedConfig, null, 2)};\\n`;\n}\n\ntype ParsedStackConfig = Record<string, unknown> | typeof showOnboardingHexclaveConfigValue;\n\nfunction unwrapStaticConfigExpression(expression: t.Expression): t.Expression {\n  if (\n    t.isTSAsExpression(expression)\n    || t.isTSSatisfiesExpression(expression)\n    || t.isTSTypeAssertion(expression)\n    || t.isTSNonNullExpression(expression)\n  ) {\n    return unwrapStaticConfigExpression(expression.expression);\n  }\n  return expression;\n}\n\nfunction evaluateStaticConfigExpression(expression: t.Expression): unknown {\n  const unwrapped = unwrapStaticConfigExpression(expression);\n  if (t.isStringLiteral(unwrapped)) return unwrapped.value;\n  if (t.isBooleanLiteral(unwrapped)) return unwrapped.value;\n  if (t.isNumericLiteral(unwrapped)) return unwrapped.value;\n  if (t.isNullLiteral(unwrapped)) return null;\n  if (t.isIdentifier(unwrapped) && unwrapped.name === \"undefined\") return undefined;\n  if (t.isUnaryExpression(unwrapped) && unwrapped.operator === \"-\" && t.isNumericLiteral(unwrapped.argument)) {\n    return -unwrapped.argument.value;\n  }\n  if (t.isArrayExpression(unwrapped)) {\n    return unwrapped.elements.map((element) => {\n      if (element == null || t.isSpreadElement(element)) {\n        throw new Error(\"Config arrays cannot contain holes or spreads.\");\n      }\n      return evaluateStaticConfigExpression(element);\n    });\n  }\n  if (t.isObjectExpression(unwrapped)) {\n    const result: Record<string, unknown> = {};\n    for (const property of unwrapped.properties) {\n      if (t.isSpreadElement(property)) {\n        throw new Error(\"Config objects cannot contain spreads.\");\n      }\n      if (property.computed) {\n        throw new Error(\"Config object keys cannot be computed.\");\n      }\n      const key = t.isIdentifier(property.key)\n        ? property.key.name\n        : t.isStringLiteral(property.key) || t.isNumericLiteral(property.key)\n          ? String(property.key.value)\n          : null;\n      if (key == null) {\n        throw new Error(\"Unsupported config object key.\");\n      }\n      if (t.isObjectMethod(property)) {\n        throw new Error(\"Config objects cannot contain methods.\");\n      }\n      if (!t.isExpression(property.value)) {\n        throw new Error(\"Unsupported config object value.\");\n      }\n      result[key] = evaluateStaticConfigExpression(property.value);\n    }\n    return result;\n  }\n  throw new Error(`Unsupported config expression: ${unwrapped.type}`);\n}\n\nexport function parseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig {\n  if (content.trim() === \"\") return {};\n  const ast = parser.parse(content, {\n    sourceType: \"module\",\n    plugins: [\"typescript\"],\n  });\n\n  for (const statement of ast.program.body) {\n    if (!t.isExportNamedDeclaration(statement) || !t.isVariableDeclaration(statement.declaration)) {\n      continue;\n    }\n    for (const declaration of statement.declaration.declarations) {\n      if (!t.isIdentifier(declaration.id) || declaration.id.name !== \"config\") {\n        continue;\n      }\n      if (declaration.init == null || !t.isExpression(declaration.init)) {\n        throw new Error(`Config export in ${filePath} must have an initializer.`);\n      }\n      return evaluateStaticConfigExpression(declaration.init) as ParsedStackConfig;\n    }\n  }\n\n  throw new Error(`Invalid config in ${filePath}. The file must export a plain \\`config\\` object or \"show-onboarding\".`);\n}\n"],"mappings":"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"}
+{"version":3,"file":"hexclave-config-file.js","names":["t","parser"],"sources":["../src/hexclave-config-file.ts"],"sourcesContent":["import * as parser from \"@babel/parser\";\nimport * as t from \"@babel/types\";\nimport { isValidConfig, normalize } from \"./config/format\";\n\nexport const showOnboardingHexclaveConfigValue = \"show-onboarding\";\n\nconst DEFAULT_CONFIG_IMPORT_PACKAGE = \"@hexclave/js\";\n\n/**\n * Renders a config object into the source text of a `stack.config.ts` file.\n *\n * Browser-safe: kept here (next to `parseHexclaveConfigFileContent`) instead of in\n * `config-rendering.ts` so dashboard client code can render config files\n * without pulling in `fs` / `path`.\n */\nexport function renderConfigFileContent(config: unknown, importPackage?: string): string {\n  if (!isValidConfig(config)) {\n    throw new Error(\"Invalid config: expected a plain object.\");\n  }\n\n  const droppedKeys: string[] = [];\n  const normalizedConfig = normalize(config, {\n    onDotIntoNonObject: \"ignore\",\n    onDotIntoNull: \"empty-object\",\n    droppedKeys,\n  });\n  if (droppedKeys.length > 0) {\n    throw new Error(`Config has conflicting keys that would be dropped during normalization: ${droppedKeys.map(k => JSON.stringify(k)).join(\", \")}`);\n  }\n  const pkg = importPackage ?? DEFAULT_CONFIG_IMPORT_PACKAGE;\n  // Import the `HexclaveConfig` type from the package's lightweight `/config`\n  // entrypoint, which is free of framework runtime code and therefore safe for\n  // tooling (e.g. the local dashboard) to load in a plain Node context. Only the\n  // Hexclave-branded packages expose this subpath; legacy `@stackframe/*`\n  // releases predate it, so fall back to their package root.\n  const importSpecifier = pkg.startsWith(\"@hexclave/\") ? `${pkg}/config` : pkg;\n  const importLine = `import type { HexclaveConfig } from \"${importSpecifier}\";`;\n  return `${importLine}\\n\\nexport const config: HexclaveConfig = ${JSON.stringify(normalizedConfig, null, 2)};\\n`;\n}\n\ntype ParsedStackConfig = Record<string, unknown> | typeof showOnboardingHexclaveConfigValue;\n\nfunction unwrapStaticConfigExpression(expression: t.Expression): t.Expression {\n  if (\n    t.isTSAsExpression(expression)\n    || t.isTSSatisfiesExpression(expression)\n    || t.isTSTypeAssertion(expression)\n    || t.isTSNonNullExpression(expression)\n  ) {\n    return unwrapStaticConfigExpression(expression.expression);\n  }\n  return expression;\n}\n\nfunction evaluateStaticConfigExpression(expression: t.Expression): unknown {\n  const unwrapped = unwrapStaticConfigExpression(expression);\n  if (t.isStringLiteral(unwrapped)) return unwrapped.value;\n  if (t.isBooleanLiteral(unwrapped)) return unwrapped.value;\n  if (t.isNumericLiteral(unwrapped)) return unwrapped.value;\n  if (t.isNullLiteral(unwrapped)) return null;\n  if (t.isIdentifier(unwrapped) && unwrapped.name === \"undefined\") return undefined;\n  if (t.isUnaryExpression(unwrapped) && unwrapped.operator === \"-\" && t.isNumericLiteral(unwrapped.argument)) {\n    return -unwrapped.argument.value;\n  }\n  if (t.isArrayExpression(unwrapped)) {\n    return unwrapped.elements.map((element) => {\n      if (element == null || t.isSpreadElement(element)) {\n        throw new Error(\"Config arrays cannot contain holes or spreads.\");\n      }\n      return evaluateStaticConfigExpression(element);\n    });\n  }\n  if (t.isObjectExpression(unwrapped)) {\n    const result: Record<string, unknown> = {};\n    for (const property of unwrapped.properties) {\n      if (t.isSpreadElement(property)) {\n        throw new Error(\"Config objects cannot contain spreads.\");\n      }\n      if (property.computed) {\n        throw new Error(\"Config object keys cannot be computed.\");\n      }\n      const key = t.isIdentifier(property.key)\n        ? property.key.name\n        : t.isStringLiteral(property.key) || t.isNumericLiteral(property.key)\n          ? String(property.key.value)\n          : null;\n      if (key == null) {\n        throw new Error(\"Unsupported config object key.\");\n      }\n      if (t.isObjectMethod(property)) {\n        throw new Error(\"Config objects cannot contain methods.\");\n      }\n      if (!t.isExpression(property.value)) {\n        throw new Error(\"Unsupported config object value.\");\n      }\n      result[key] = evaluateStaticConfigExpression(property.value);\n    }\n    return result;\n  }\n  throw new Error(`Unsupported config expression: ${unwrapped.type}`);\n}\n\n/**\n * Like {@link parseHexclaveConfigFileContent}, but returns `null` instead of\n * throwing when the file is not a plain static config (e.g. it wraps the config\n * in a helper call, references imported values, or has a syntax error). Useful\n * for deciding whether a config file can be safely regenerated deterministically\n * or whether it has custom structure that must be preserved.\n */\nexport function tryParseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig | null {\n  try {\n    return parseHexclaveConfigFileContent(content, filePath);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Returns whether `content` parses as a module that exports a `config` binding.\n * Used as a lightweight structural sanity check after editing config files whose\n * values can't be evaluated by our loader (e.g. they import external text\n * files), where a full semantic comparison isn't possible.\n */\nexport function hexclaveConfigFileExportsConfig(content: string, filePath: string): boolean {\n  let ast: parser.ParseResult<t.File>;\n  try {\n    ast = parser.parse(content, {\n      sourceType: \"module\",\n      sourceFilename: filePath,\n      plugins: [\"typescript\", \"importAttributes\"],\n    });\n  } catch {\n    return false;\n  }\n  for (const statement of ast.program.body) {\n    if (!t.isExportNamedDeclaration(statement)) {\n      continue;\n    }\n    // Ignore type-only exports (`export type { config }`): they don't produce a\n    // runtime `config` value, so they must not satisfy the structural check.\n    if (statement.exportKind === \"type\") {\n      continue;\n    }\n    if (t.isVariableDeclaration(statement.declaration)) {\n      for (const declaration of statement.declaration.declarations) {\n        if (t.isIdentifier(declaration.id) && declaration.id.name === \"config\" && declaration.init != null) {\n          return true;\n        }\n      }\n    }\n    for (const specifier of statement.specifiers) {\n      if (t.isExportSpecifier(specifier) && specifier.exportKind !== \"type\") {\n        const exportedName = t.isIdentifier(specifier.exported) ? specifier.exported.name : specifier.exported.value;\n        if (exportedName === \"config\") {\n          return true;\n        }\n      }\n    }\n  }\n  return false;\n}\n\n/**\n * Returns the relative import sources (those starting with `./` or `../`)\n * declared in `content`. Used to discover the external files a config update may\n * touch — e.g. `import x from \"./welcome-email.tsx\" with { type: \"text\" }` — so\n * they can be snapshotted and rolled back if an in-place update fails. Returns\n * an empty array if the file can't be parsed.\n */\nexport function getRelativeImportSpecifiers(content: string): string[] {\n  let ast: parser.ParseResult<t.File>;\n  try {\n    ast = parser.parse(content, {\n      sourceType: \"module\",\n      plugins: [\"typescript\", \"importAttributes\"],\n    });\n  } catch {\n    return [];\n  }\n  const sources: string[] = [];\n  for (const statement of ast.program.body) {\n    if (t.isImportDeclaration(statement)) {\n      const source = statement.source.value;\n      if (source.startsWith(\"./\") || source.startsWith(\"../\")) {\n        sources.push(source);\n      }\n    }\n  }\n  return sources;\n}\n\nexport function parseHexclaveConfigFileContent(content: string, filePath: string): ParsedStackConfig {\n  if (content.trim() === \"\") return {};\n  const ast = parser.parse(content, {\n    sourceType: \"module\",\n    plugins: [\"typescript\", \"importAttributes\"],\n  });\n\n  for (const statement of ast.program.body) {\n    if (!t.isExportNamedDeclaration(statement) || !t.isVariableDeclaration(statement.declaration)) {\n      continue;\n    }\n    for (const declaration of statement.declaration.declarations) {\n      if (!t.isIdentifier(declaration.id) || declaration.id.name !== \"config\") {\n        continue;\n      }\n      if (declaration.init == null || !t.isExpression(declaration.init)) {\n        throw new Error(`Config export in ${filePath} must have an initializer.`);\n      }\n      return evaluateStaticConfigExpression(declaration.init) as ParsedStackConfig;\n    }\n  }\n\n  throw new Error(`Invalid config in ${filePath}. The file must export a plain \\`config\\` object or \"show-onboarding\".`);\n}\n"],"mappings":";;;;;;;;;AAIA,MAAa,oCAAoC;AAEjD,MAAM,gCAAgC;;;;;;;;AAStC,SAAgB,wBAAwB,QAAiB,eAAgC;AACvF,KAAI,uCAAe,OAAO,CACxB,OAAM,IAAI,MAAM,2CAA2C;CAG7D,MAAM,cAAwB,EAAE;CAChC,MAAM,qDAA6B,QAAQ;EACzC,oBAAoB;EACpB,eAAe;EACf;EACD,CAAC;AACF,KAAI,YAAY,SAAS,EACvB,OAAM,IAAI,MAAM,2EAA2E,YAAY,KAAI,MAAK,KAAK,UAAU,EAAE,CAAC,CAAC,KAAK,KAAK,GAAG;CAElJ,MAAM,MAAM,iBAAiB;AAQ7B,QAAO,GADY,wCADK,IAAI,WAAW,aAAa,GAAG,GAAG,IAAI,WAAW,IACE,IACtD,4CAA4C,KAAK,UAAU,kBAAkB,MAAM,EAAE,CAAC;;AAK7G,SAAS,6BAA6B,YAAwC;AAC5E,KACEA,aAAE,iBAAiB,WAAW,IAC3BA,aAAE,wBAAwB,WAAW,IACrCA,aAAE,kBAAkB,WAAW,IAC/BA,aAAE,sBAAsB,WAAW,CAEtC,QAAO,6BAA6B,WAAW,WAAW;AAE5D,QAAO;;AAGT,SAAS,+BAA+B,YAAmC;CACzE,MAAM,YAAY,6BAA6B,WAAW;AAC1D,KAAIA,aAAE,gBAAgB,UAAU,CAAE,QAAO,UAAU;AACnD,KAAIA,aAAE,iBAAiB,UAAU,CAAE,QAAO,UAAU;AACpD,KAAIA,aAAE,iBAAiB,UAAU,CAAE,QAAO,UAAU;AACpD,KAAIA,aAAE,cAAc,UAAU,CAAE,QAAO;AACvC,KAAIA,aAAE,aAAa,UAAU,IAAI,UAAU,SAAS,YAAa,QAAO;AACxE,KAAIA,aAAE,kBAAkB,UAAU,IAAI,UAAU,aAAa,OAAOA,aAAE,iBAAiB,UAAU,SAAS,CACxG,QAAO,CAAC,UAAU,SAAS;AAE7B,KAAIA,aAAE,kBAAkB,UAAU,CAChC,QAAO,UAAU,SAAS,KAAK,YAAY;AACzC,MAAI,WAAW,QAAQA,aAAE,gBAAgB,QAAQ,CAC/C,OAAM,IAAI,MAAM,iDAAiD;AAEnE,SAAO,+BAA+B,QAAQ;GAC9C;AAEJ,KAAIA,aAAE,mBAAmB,UAAU,EAAE;EACnC,MAAM,SAAkC,EAAE;AAC1C,OAAK,MAAM,YAAY,UAAU,YAAY;AAC3C,OAAIA,aAAE,gBAAgB,SAAS,CAC7B,OAAM,IAAI,MAAM,yCAAyC;AAE3D,OAAI,SAAS,SACX,OAAM,IAAI,MAAM,yCAAyC;GAE3D,MAAM,MAAMA,aAAE,aAAa,SAAS,IAAI,GACpC,SAAS,IAAI,OACbA,aAAE,gBAAgB,SAAS,IAAI,IAAIA,aAAE,iBAAiB,SAAS,IAAI,GACjE,OAAO,SAAS,IAAI,MAAM,GAC1B;AACN,OAAI,OAAO,KACT,OAAM,IAAI,MAAM,iCAAiC;AAEnD,OAAIA,aAAE,eAAe,SAAS,CAC5B,OAAM,IAAI,MAAM,yCAAyC;AAE3D,OAAI,CAACA,aAAE,aAAa,SAAS,MAAM,CACjC,OAAM,IAAI,MAAM,mCAAmC;AAErD,UAAO,OAAO,+BAA+B,SAAS,MAAM;;AAE9D,SAAO;;AAET,OAAM,IAAI,MAAM,kCAAkC,UAAU,OAAO;;;;;;;;;AAUrE,SAAgB,kCAAkC,SAAiB,UAA4C;AAC7G,KAAI;AACF,SAAO,+BAA+B,SAAS,SAAS;SAClD;AACN,SAAO;;;;;;;;;AAUX,SAAgB,gCAAgC,SAAiB,UAA2B;CAC1F,IAAI;AACJ,KAAI;AACF,QAAMC,cAAO,MAAM,SAAS;GAC1B,YAAY;GACZ,gBAAgB;GAChB,SAAS,CAAC,cAAc,mBAAmB;GAC5C,CAAC;SACI;AACN,SAAO;;AAET,MAAK,MAAM,aAAa,IAAI,QAAQ,MAAM;AACxC,MAAI,CAACD,aAAE,yBAAyB,UAAU,CACxC;AAIF,MAAI,UAAU,eAAe,OAC3B;AAEF,MAAIA,aAAE,sBAAsB,UAAU,YAAY,EAChD;QAAK,MAAM,eAAe,UAAU,YAAY,aAC9C,KAAIA,aAAE,aAAa,YAAY,GAAG,IAAI,YAAY,GAAG,SAAS,YAAY,YAAY,QAAQ,KAC5F,QAAO;;AAIb,OAAK,MAAM,aAAa,UAAU,WAChC,KAAIA,aAAE,kBAAkB,UAAU,IAAI,UAAU,eAAe,QAE7D;QADqBA,aAAE,aAAa,UAAU,SAAS,GAAG,UAAU,SAAS,OAAO,UAAU,SAAS,WAClF,SACnB,QAAO;;;AAKf,QAAO;;;;;;;;;AAUT,SAAgB,4BAA4B,SAA2B;CACrE,IAAI;AACJ,KAAI;AACF,QAAMC,cAAO,MAAM,SAAS;GAC1B,YAAY;GACZ,SAAS,CAAC,cAAc,mBAAmB;GAC5C,CAAC;SACI;AACN,SAAO,EAAE;;CAEX,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,aAAa,IAAI,QAAQ,KAClC,KAAID,aAAE,oBAAoB,UAAU,EAAE;EACpC,MAAM,SAAS,UAAU,OAAO;AAChC,MAAI,OAAO,WAAW,KAAK,IAAI,OAAO,WAAW,MAAM,CACrD,SAAQ,KAAK,OAAO;;AAI1B,QAAO;;AAGT,SAAgB,+BAA+B,SAAiB,UAAqC;AACnG,KAAI,QAAQ,MAAM,KAAK,GAAI,QAAO,EAAE;CACpC,MAAM,MAAMC,cAAO,MAAM,SAAS;EAChC,YAAY;EACZ,SAAS,CAAC,cAAc,mBAAmB;EAC5C,CAAC;AAEF,MAAK,MAAM,aAAa,IAAI,QAAQ,MAAM;AACxC,MAAI,CAACD,aAAE,yBAAyB,UAAU,IAAI,CAACA,aAAE,sBAAsB,UAAU,YAAY,CAC3F;AAEF,OAAK,MAAM,eAAe,UAAU,YAAY,cAAc;AAC5D,OAAI,CAACA,aAAE,aAAa,YAAY,GAAG,IAAI,YAAY,GAAG,SAAS,SAC7D;AAEF,OAAI,YAAY,QAAQ,QAAQ,CAACA,aAAE,aAAa,YAAY,KAAK,CAC/D,OAAM,IAAI,MAAM,oBAAoB,SAAS,4BAA4B;AAE3E,UAAO,+BAA+B,YAAY,KAAK;;;AAI3D,OAAM,IAAI,MAAM,qBAAqB,SAAS,wEAAwE"}

package/dist/interface/admin-interface.d.ts

@@ -3,7 +3,7 @@ import { KnownErrors } from "../known-errors.js";
 import { MoneyAmount } from "../utils/currency-constants.js";
 import { RestrictedReason, branchConfigSourceSchema } from "../schema-fields.js";
 import { AccessToken, InternalSession, RefreshToken } from "../sessions.js";
-import { MetricsResponse, MetricsUserCounts, UserActivityResponse } from "./admin-metrics.js";
+import { AnalyticsClickmapDevice, AnalyticsClickmapKind, AnalyticsClickmapResponse, AnalyticsClickmapTokenResponse, MetricsResponse, MetricsUserCounts, UserActivityResponse } from "./admin-metrics.js";
 import { AnalyticsQueryOptions, AnalyticsQueryResponse } from "./crud/analytics.js";
 import { EmailOutboxCrud } from "./crud/email-outbox.js";
 import { InternalEmailsCrud } from "./crud/emails.js";
@@ -127,6 +127,24 @@ declare class HexclaveAdminInterface extends HexclaveServerInterface {
     until?: string;
   }): Promise<MetricsResponse>;
   getUserActivity(userId: string): Promise<UserActivityResponse>;
+  getAnalyticsClickmap(options: {
+    kind: AnalyticsClickmapKind;
+    member_user_ids?: string[];
+    route_path?: string;
+    route_regex?: string;
+    url_pattern?: string;
+    user_id?: string;
+    replay_id?: string;
+    device?: AnalyticsClickmapDevice;
+    viewport_width_min?: number;
+    viewport_width_max?: number;
+    sampling?: number;
+    since: string;
+    until: string;
+  }): Promise<AnalyticsClickmapResponse>;
+  createAnalyticsClickmapToken(options: {
+    origin: string;
+  }): Promise<AnalyticsClickmapTokenResponse>;
   getMetricsUserCounts(): Promise<MetricsUserCounts>;
   sendTestEmail(data: {
     recipient_email: string;

package/dist/interface/admin-interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-interface.d.ts","names":[],"sources":["../../src/interface/admin-interface.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;KA6BK,qBAAA,GAAwB,KAAA,CAAI,SAAA,QAAiB,wBAAA;AAAA,KAEtC,WAAA,GAAc,KAAA;EACpB,IAAA;EAAc,IAAA;AAAA;EACd,IAAA;EAAmB,QAAA;EAAkB,UAAA;EAAoB,IAAA;EAAW,QAAA;EAAkB,MAAA;AAAA;AAAA,KAGhF,2BAAA,GAA8B,4BAAA;EAEtC,mBAAA;AAAA;EAGA,mBAAA,EAAqB,eAAA,UAAyB,OAAA;AAAA;AAAA,KAItC,+BAAA;EACV,0BAAA;EACA,qBAAA;EACA,0BAAA;EACA,iBAAA;EACA,WAAA;AAAA;AAAA,KAGU,gCAAA,GAAmC,mBAAA;EAC7C,sBAAA;EACA,iBAAA;EACA,sBAAA;AAAA;AAAA,cAIW,sBAAA,SAA+B,uBAAA;EAAA,SACd,OAAA,EAAS,2BAAA;cAAT,OAAA,EAAS,2BAAA;EAIxB,gBAAA,CAAiB,IAAA,UAAc,OAAA,EAAS,WAAA,EAAa,OAAA,EAAS,eAAA,SAAwB,WAAA,aAA8B,OAAA,CAAA,QAAA;;;;;;YAgBjH,kCAAA,kBAAoD,WAAA,OAAkB,WAAA,EAAA,CACpF,IAAA,UACA,cAAA,EAAgB,WAAA,EAChB,gBAAA,EAAkB,eAAA,SAClB,aAAA,WAAwB,CAAA,KACvB,OAAA,CAAQ,MAAA,CACT,QAAA;IACE,UAAA;MACE,WAAA,EAAa,WAAA;MACb,YAAA,EAAc,YAAA;IAAA;EAAA,GAGlB,YAAA,CAAa,CAAA;EAcT,UAAA,CAAA,GAAc,OAAA,CAAQ,YAAA;EAWtB,aAAA,CAAc,MAAA,EAAQ,YAAA,sBAAkC,OAAA,CAAQ,YAAA;EAehE,oBAAA,CACJ,OAAA,EAAS,+BAAA,GACR,OAAA,CAAQ,gCAAA;EAeL,mBAAA,CAAA,GAAuB,OAAA,CAAQ,mBAAA;EAM/B,wBAAA,CAAyB,EAAA,WAAU,OAAA;EAenC,iBAAA,CAAkB,EAAA,UAAY,OAAA,EAAS,eAAA,GAAkB,OAAA,CAAQ,mBAAA;EAKjE,0BAAA,CAAA,GAA8B,OAAA;IAAU,EAAA;IAAY,YAAA;IAAsB,QAAA;IAAmB,UAAA;EAAA;EAM7F,uBAAA,CAAA,GAA2B,OAAA;IAAU,EAAA;IAAY,YAAA;IAAsB,QAAA;IAAuC,UAAA;IAAoB,cAAA;EAAA;EAMlI,gBAAA,CAAiB,OAAA;IAAW,YAAA;IAAuB,QAAA;IAA2B,UAAA;EAAA,IAAwB,OAAA;IAAU,EAAA;EAAA;EAehH,gBAAA,CAAiB,EAAA,UAAY,IAAA;IAAQ,YAAA;IAAuB,QAAA;IAAkC,UAAA;IAAqB,cAAA;EAAA,IAAmC,OAAA;EActJ,gBAAA,CAAiB,EAAA,WAAa,OAAA;EAU9B,eAAA,CAAA,GAAmB,OAAA;IAAU,EAAA;IAAY,YAAA;EAAA;EAQzC,6BAAA,CAAA,GAAiC,OAAA,CAAQ,6BAAA;EAMzC,sCAAA,CACJ,OAAA;IAAW,KAAA;IAAe,MAAA;IAAiB,KAAA;EAAA,IAC1C,OAAA;IAAU,KAAA,EAAO,6BAAA;IAAkD,UAAA;EAAA;EAahE,8BAAA,CAA+B,IAAA,EAAM,6BAAA,sBAAmD,OAAA,CAAQ,6BAAA;EAehG,8BAAA,CAA+B,YAAA,UAAsB,IAAA,EAAM,6BAAA,sBAAmD,OAAA,CAAQ,6BAAA;EAetH,8BAAA,CAA+B,YAAA,WAAuB,OAAA;EAQtD,gCAAA,CAAA,GAAoC,OAAA,CAAQ,gCAAA;EAM5C,iCAAA,CAAkC,IAAA,EAAM,gCAAA,sBAAsD,OAAA,CAAQ,gCAAA;EAetG,iCAAA,CAAkC,YAAA,UAAsB,IAAA,EAAM,gCAAA,sBAAsD,OAAA,CAAQ,gCAAA;EAe5H,iCAAA,CAAkC,YAAA,WAAuB,OAAA;EAQzD,YAAA,CAAA,GAAgB,OAAA,CAAQ,aAAA;EAexB,aAAA,CAAA,GAAiB,OAAA;EAUjB,UAAA,CACJ,gBAAA,YACA,OAAA;IACE,YAAA;IACA,QAAA;IACA,OAAA;IACA,EAAA;IACA,MAAA;IACA,KAAA;IACA,KAAA;EAAA,IAED,OAAA,CAAQ,eAAA;EAoDL,eAAA,CAAgB,MAAA,WAAiB,OAAA,CAAQ,oBAAA;EAWzC,oBAAA,CAAA,GAAwB,OAAA,CAAQ,iBAAA;EAWhC,aAAA,CAAc,IAAA;IAClB,eAAA;IACA,YAAA;MACE,IAAA;MACA,IAAA;MACA,QAAA;MACA,QAAA;MACA,YAAA;MACA,WAAA;IAAA;EAAA,IAEA,OAAA;IAAU,OAAA;IAAkB,aAAA;EAAA;EAW1B,eAAA,CAAgB,IAAA;IACpB,WAAA;EAAA,IACE,OAAA;IAAU,OAAA;IAAkB,aAAA;EAAA;EAW1B,cAAA,CAAA,GAAkB,OAAA,CAAQ,kBAAA;EAO1B,yBAAA,CAA0B,IAAA;IAC9B,SAAA;IACA,iBAAA;EAAA,IACE,OAAA;IACA,SAAA;IACA,SAAA;IACA,iBAAA;IACA,mBAAA;IACA,MAAA;EAAA;EAYE,uBAAA,CAAwB,IAAA;IAC5B,SAAA;IACA,SAAA;IACA,iBAAA;EAAA,IACE,OAAA;IAAU,MAAA;EAAA;EAWR,uBAAA,CAAA,GAA2B,OAAA;IAC7B,KAAA,EAAO,KAAA;MACL,SAAA;MACA,SAAA;MACA,iBAAA;MACA,MAAA;MACA,mBAAA;IAAA;EAAA;EASA,wBAAA,CAAyB,IAAA;IAC7B,gBAAA;EAAA,IACE,OAAA;IAAU,MAAA;EAAA;EAWR,yBAAA,CAA0B,IAAA;IAC9B,SAAA;EAAA,IACE,OAAA;IAAU,MAAA;EAAA;EAWR,yBAAA,CACJ,KAAA,UACA,WAAA,WACC,OAAA;EAiBG,eAAA,CAAgB,QAAA,UAAkB,OAAA,QAAe,OAAA;EAcjD,gBAAA,CAAiB,QAAA,WAAmB,OAAA;IAAU,QAAA,EAAU,KAAA;EAAA;EASxD,kBAAA,CAAmB,OAAA;IACvB,OAAA;IACA,cAAA;IACA,UAAA;IACA,iBAAA;IACA,eAAA;IACA,cAAA;EAAA,IACE,OAAA;IAAU,IAAA;IAAc,gBAAA,GAAmB,MAAA;EAAA;EAkBzC,2BAAA,CAA4B,iBAAA,WAA4B,OAAA;IAAU,UAAA;EAAA;EAalE,gBAAA,CAAiB,WAAA,WAAsB,OAAA;IAAU,EAAA;EAAA;EAiBjD,aAAA,CAAc,EAAA,WAAa,OAAA;IAAU,YAAA;IAAsB,UAAA;EAAA;EAS3D,gBAAA,CAAiB,EAAA,UAAY,SAAA,WAAoB,OAAA;EAgBjD,gBAAA,CAAiB,EAAA,WAAa,OAAA;EAU9B,mBAAA,CAAoB,EAAA,UAAY,SAAA,UAAmB,OAAA,0BAAiC,OAAA;IAAU,aAAA;EAAA;EAe9F,SAAA,CAAA,GAAa,OAAA;IAAU,aAAA;EAAA;EASvB,iBAAA,CAAkB,KAAA,yCAA8C,OAAA;IAAU,aAAA;EAAA;EAS1E,iBAAA,CAAkB,KAAA,wCAA6C,cAAA,OAAqB,MAAA,GAAS,qBAAA,GAAwB,OAAA;EAiBrH,oBAAA,CAAqB,KAAA,wCAA6C,sBAAA,QAA8B,OAAA;EAchG,qBAAA,CAAA,GAAyB,OAAA,CAAQ,qBAAA;EAUjC,wBAAA,CAAA,GAA4B,OAAA;EAQ5B,uBAAA,CAAwB,KAAA,4BAAiC,IAAA,aAAiB,OAAA;EAa1E,mBAAA,CAAoB,WAAA,WAAsB,OAAA;IAAU,EAAA;EAAA;EAiBpD,mBAAA,CAAoB,EAAA,WAAa,OAAA;EAUjC,aAAA,CAAA,GAAiB,OAAA;IAAU,GAAA;EAAA;EAe3B,oBAAA,CAAA,GAAwB,OAAA;IAAiB,UAAA;IAAoB,eAAA;IAA0B,iBAAA;IAA4B,eAAA;EAAA;EAanH,uBAAA,CAAA,GAA2B,OAAA;IAAU,QAAA;IAAkB,OAAA,EAAS,KAAA;MAAQ,EAAA;MAAY,IAAA;MAAc,OAAA;MAAkB,SAAA;MAAoB,WAAA;IAAA;EAAA;EAiBxI,0BAAA,CAA2B,QAAA,UAAkB,OAAA,EAAS,MAAA,yBAA+B,OAAA;EAYrF,gCAAA,CAAA,GAAoC,OAAA;IAAU,aAAA;EAAA;EAe9C,gBAAA,CAAiB,MAAA;IAAW,MAAA;IAAiB,KAAA;IAAgB,IAAA,GAAO,eAAA;IAAiB,YAAA;IAA2C,UAAA;EAAA,IAAwB,OAAA;IAAU,YAAA,EAAc,WAAA;IAAe,UAAA;EAAA;EAgB/L,kBAAA,CAAmB,MAAA,GAAS,8BAAA,GAAiC,OAAA,CAAQ,+BAAA;EAmBrE,gBAAA,CAAiB,eAAA,WAA0B,OAAA,CAAQ,6BAAA;EASnD,uBAAA,CAAwB,eAAA,UAAyB,MAAA,GAAS,mCAAA,GAAsC,OAAA,CAAQ,oCAAA;EAYxG,2BAAA,CAA4B,eAAA,UAAyB,OAAA,WAAkB,OAAA,CAAQ,wCAAA;EAS/E,sBAAA,CAAuB,eAAA,UAAyB,OAAA;IAAY,MAAA;IAAiB,KAAA;EAAA,IAAmB,OAAA,CAAQ,sCAAA;EAYxG,iBAAA,CAAkB,OAAA;IACtB,IAAA;IACA,EAAA;IACA,SAAA;IACA,SAAA,EAAW,WAAA;IAt0BV;;;;;;;;IA+0BD,SAAA;EAAA,IACE,OAAA;IAAU,OAAA;IAAkB,mBAAA;EAAA;EAuB1B,sCAAA,CACJ,UAAA;IAAc,0BAAA;EAAA,GACd,KAAA,YACC,OAAA;IACD,cAAA,EAAgB,KAAA;MACd,EAAA;MACA,YAAA;MACA,aAAA;MACA,iBAAA,EAAmB,gBAAA;IAAA;IAErB,oBAAA;EAAA;EAgBI,cAAA,CAAe,OAAA,EAAS,qBAAA,GAAwB,OAAA,CAAQ,sBAAA;EAmBxD,gBAAA,CAAiB,OAAA;IAAY,MAAA;IAAiB,aAAA;IAAwB,KAAA;IAAgB,MAAA;EAAA,IAAoB,OAAA,CAAQ,eAAA;EAclH,cAAA,CAAe,EAAA,WAAa,OAAA,CAAQ,eAAA;EASpC,iBAAA,CAAkB,EAAA,UAAY,IAAA,EAAM,eAAA,uBAAsC,OAAA,CAAQ,eAAA;AAAA"}
+{"version":3,"file":"admin-interface.d.ts","names":[],"sources":["../../src/interface/admin-interface.ts"],"mappings":"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"}

package/dist/interface/admin-interface.js

@@ -184,6 +184,20 @@ var HexclaveAdminInterface = class extends __server_interface_js.HexclaveServerI
 	async getUserActivity(userId) {
 		return await (await this.sendAdminRequest(___utils_urls_js.urlString`/internal/user-activity?user_id=${userId}`, { method: "GET" }, null)).json();
 	}
+	async getAnalyticsClickmap(options) {
+		return await (await this.sendAdminRequest("/internal/analytics/clickmap", {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify(options)
+		}, null)).json();
+	}
+	async createAnalyticsClickmapToken(options) {
+		return await (await this.sendAdminRequest("/internal/analytics/clickmap-token", {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify(options)
+		}, null)).json();
+	}
 	async getMetricsUserCounts() {
 		return await (await this.sendAdminRequest("/internal/metrics/user-counts", { method: "GET" }, null)).json();
 	}