@wix/web5-core 1.56.0

package/dist/cjs/utils/markdownPreprocessor.js

@@ -0,0 +1,268 @@
+"use strict";
+
+exports.__esModule = true;
+exports.decodeLinkText = decodeLinkText;
+exports.escapeWeb5Links = escapeWeb5Links;
+exports.fixMalformedLinks = fixMalformedLinks;
+exports.insertMissingTableSeparators = insertMissingTableSeparators;
+exports.normalizeIconUrls = normalizeIconUrls;
+exports.preprocessMarkdown = preprocessMarkdown;
+exports.recoverOrphanedEmphasisLinks = recoverOrphanedEmphasisLinks;
+exports.trimTrailingWhitespace = trimTrailingWhitespace;
+/**
+ * Markdown preprocessing utilities
+ *
+ * These functions fix common markdown formatting issues before AST parsing.
+ * They are applied in a specific order to ensure proper processing.
+ */
+
+/**
+ * Escape web5:// links by URL-encoding the URL part
+ * e.g. [text](web5://some text with spaces) → [text](web5://some%20text%20with%20spaces)
+ *
+ * @param markdown - The markdown string to process
+ * @returns The markdown string with web5:// URLs properly encoded
+ */
+function escapeWeb5Links(markdown) {
+  // Match markdown links with web5:// protocol
+  // Pattern: [text](web5://...)
+  return markdown.replace(/\[([^\]]+)\]\((web5|entity|image):\/\/([^)]+)\)/g, (match, linkText, protocol, url) => {
+    try {
+      // Decode first to avoid double-encoding (e.g. %20 → %2520)
+      const decodedUrl = decodeURIComponent(url);
+      // Use encodeURI (not encodeURIComponent) to preserve URL structure
+      // characters like /, ?, &, = while encoding spaces and unsafe chars
+      const encodedUrl = encodeURI(decodedUrl);
+      return `[${linkText}](${protocol}://${encodedUrl})`;
+    } catch {
+      // decodeURIComponent throws on a malformed percent sequence (raw `%`
+      // or truncated `%X`), encodeURI on a lone surrogate. During streaming
+      // this happens when chunks are concatenated mid-escape or a multi-byte
+      // char is split. Leave the link untouched rather than throw — an
+      // uncaught error here aborts the whole streaming parse and surfaces as
+      // a 908 conversation-streaming-error even though the page rendered.
+      return match;
+    }
+  });
+}
+
+/**
+ * Fix malformed markdown links with whitespace (spaces, tabs, newlines) between ] and (
+ * e.g. [text] (url) → [text](url)
+ * e.g. [text]\n(url) → [text](url)
+ *
+ * @param markdown - The markdown string to process
+ * @returns The markdown string with fixed link formatting
+ */
+function fixMalformedLinks(markdown) {
+  // \s matches spaces, tabs, and newlines; + means one or more
+  // Also handle cases with newlines explicitly
+  return markdown.replace(/\][\s\r\n]+\(/g, '](');
+}
+
+/**
+ * Recover inline CTA chips where the LLM emitted emphasized text followed by a
+ * dangling markdown link close, e.g. `**label →**](web5://ask/query)`.
+ */
+function recoverOrphanedEmphasisLinks(markdown) {
+  const diagnostics = [];
+  const result = markdown.replace(/(^|[^\[])\*\*([^\n\]*]+?)\*\*\]\((web5:\/\/(?:ask|action)\/[^)]+)\)/g, (match, prefix, linkText, href) => {
+    const normalized = `${prefix}[${linkText.trim()}](${href})`;
+    diagnostics.push({
+      type: 'orphaned_emphasis_link_recovered',
+      original: match,
+      normalized
+    });
+    return normalized;
+  });
+  return {
+    result,
+    diagnostics
+  };
+}
+
+/**
+ * Trim trailing whitespace from lines that contain text
+ *
+ * @param markdown - The markdown string to process
+ * @returns The markdown string with trailing whitespace trimmed from text lines
+ */
+function trimTrailingWhitespace(markdown) {
+  const lines = markdown.split('\n');
+  const processedLines = [];
+  for (const line of lines) {
+    const trimmedLine = line.trim();
+
+    // If the line has content, trim trailing whitespace (keep leading spaces for indentation)
+    if (trimmedLine.length > 0) {
+      processedLines.push(line.trimEnd());
+    } else {
+      // Lines with only whitespace become empty lines
+      processedLines.push('');
+    }
+  }
+  return processedLines.join('\n');
+}
+
+/**
+ * Normalize malformed web5://icon URLs to the canonical web5://icon/{name} format.
+ * Handles variants like web5://icon:arrow, web5://icon-arrow, web5://icon arrow → web5://icon/arrow.
+ * Only alphanumeric characters and dashes are kept in the icon name.
+ */
+function normalizeIconUrls(markdown) {
+  const diagnostics = [];
+  const result = markdown.replace(/web5:\/\/icon(?:([:/-][^)\s]+)|(?:\s+([a-zA-Z0-9-]+)))/g, (match, rest, spaceName) => {
+    const cleanName = (spaceName ?? rest ?? '').replace(/[^a-zA-Z0-9-]/g, '').replace(/^-+|-+$/g, '');
+    const normalized = `web5://icon/${cleanName}`;
+    if (match !== normalized) {
+      diagnostics.push({
+        type: 'icon_url_normalized',
+        original: match,
+        normalized
+      });
+    }
+    return normalized;
+  });
+  return {
+    result,
+    diagnostics
+  };
+}
+function isFenceToggle(line) {
+  return /^\s*(`{3,}|~{3,})/.test(line);
+}
+function splitPipeRow(line) {
+  const trimmed = line.trim();
+  if (!trimmed.startsWith('|') || !trimmed.endsWith('|')) {
+    return [];
+  }
+  return trimmed.slice(1, -1).split('|').map(cell => cell.trim());
+}
+function isPipeRow(line) {
+  return splitPipeRow(line).length >= 2;
+}
+function isTableDelimiterRow(line) {
+  const cells = splitPipeRow(line);
+  return cells.length >= 2 && cells.every(cell => /^:?-{3,}:?$/.test(cell.replace(/\s+/g, '')));
+}
+
+/**
+ * Repair LLM-emitted pipe tables that omit the GFM delimiter row.
+ * Without this line remark-gfm parses the rows as plain paragraphs, so
+ * registry sections such as comparison never receive a `table` part.
+ */
+function insertMissingTableSeparators(markdown) {
+  const diagnostics = [];
+  const lines = markdown.split('\n');
+  const result = [];
+  let inFence = false;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const previousLine = result[result.length - 1] ?? '';
+    const nextLine = lines[i + 1] ?? '';
+    if (isFenceToggle(line)) {
+      inFence = !inFence;
+      result.push(line);
+      continue;
+    }
+    result.push(line);
+    if (inFence || !isPipeRow(line) || isPipeRow(previousLine)) {
+      continue;
+    }
+    if (!isPipeRow(nextLine) || isTableDelimiterRow(nextLine)) {
+      continue;
+    }
+    const headerCells = splitPipeRow(line);
+    const nextCells = splitPipeRow(nextLine);
+    if (headerCells.length !== nextCells.length) {
+      continue;
+    }
+    const separator = `| ${headerCells.map(() => '---').join(' | ')} |`;
+    result.push(separator);
+    diagnostics.push({
+      type: 'table_separator_inserted',
+      original: line,
+      normalized: `${line}\n${separator}`
+    });
+  }
+  return {
+    result: result.join('\n'),
+    diagnostics
+  };
+}
+
+/**
+ * Decode URL-encoded text in markdown link labels.
+ * e.g. [Some%20Text](https://example.com) → [Some Text](https://example.com)
+ * e.g. [Which+solution%3F](web5://...) → [Which solution?](web5://...)
+ *
+ * Only decodes the text portion [text], never the URL portion (url).
+ * Handles both `+` (form-encoded space) and `%XX` escapes; falls back to
+ * the original string on malformed percent sequences.
+ */
+function decodeLinkText(markdown) {
+  const diagnostics = [];
+  const result = markdown.replace(/\[([^\]]+)\]\(/g, (match, linkText) => {
+    try {
+      const decoded = decodeURIComponent(linkText.replace(/\+/g, '%20'));
+      if (decoded !== linkText) {
+        diagnostics.push({
+          type: 'link_text_decoded',
+          original: linkText,
+          normalized: decoded
+        });
+      }
+      return `[${decoded}](`;
+    } catch {
+      // If decodeURIComponent fails (e.g. malformed percent sequence like %ZZ),
+      // leave the text unchanged
+      return match;
+    }
+  });
+  return {
+    result,
+    diagnostics
+  };
+}
+
+/**
+ * Preprocess markdown to fix common formatting issues before AST parsing.
+ *
+ * The preprocessing steps are applied in the following order:
+ * 1. Recover orphaned emphasized web5 links
+ * 2. Fix malformed links (remove whitespace between ] and () - must happen before web5 links are matched)
+ * 3. Decode URL-encoded link text
+ * 4. Escape web5:// links (URL-encode URLs)
+ * 5. Normalize icon URLs
+ * 6. Insert missing table separators for obvious pipe tables
+ * 7. Trim trailing whitespace from lines
+ *
+ * @param markdown - The raw markdown string to preprocess
+ * @returns The preprocessed markdown string ready for AST parsing
+ */
+function preprocessMarkdown(markdown) {
+  const {
+    result: recoveredLinks,
+    diagnostics: recoveredLinkDiagnostics
+  } = recoverOrphanedEmphasisLinks(markdown);
+  let processed = fixMalformedLinks(recoveredLinks);
+  const {
+    result: decodedText,
+    diagnostics: decodeDiagnostics
+  } = decodeLinkText(processed);
+  processed = escapeWeb5Links(decodedText);
+  const {
+    result: normalized,
+    diagnostics: iconDiagnostics
+  } = normalizeIconUrls(processed);
+  const {
+    result: tableNormalized,
+    diagnostics: tableDiagnostics
+  } = insertMissingTableSeparators(normalized);
+  processed = trimTrailingWhitespace(tableNormalized);
+  return {
+    markdown: processed,
+    diagnostics: [...recoveredLinkDiagnostics, ...decodeDiagnostics, ...iconDiagnostics, ...tableDiagnostics]
+  };
+}
+//# sourceMappingURL=markdownPreprocessor.js.map

package/dist/cjs/utils/markdownPreprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["escapeWeb5Links","markdown","replace","match","linkText","protocol","url","decodedUrl","decodeURIComponent","encodedUrl","encodeURI","fixMalformedLinks","recoverOrphanedEmphasisLinks","diagnostics","result","prefix","href","normalized","trim","push","type","original","trimTrailingWhitespace","lines","split","processedLines","line","trimmedLine","length","trimEnd","join","normalizeIconUrls","rest","spaceName","cleanName","isFenceToggle","test","splitPipeRow","trimmed","startsWith","endsWith","slice","map","cell","isPipeRow","isTableDelimiterRow","cells","every","insertMissingTableSeparators","inFence","i","previousLine","nextLine","headerCells","nextCells","separator","decodeLinkText","decoded","preprocessMarkdown","recoveredLinks","recoveredLinkDiagnostics","processed","decodedText","decodeDiagnostics","iconDiagnostics","tableNormalized","tableDiagnostics"],"sources":["../../../src/utils/markdownPreprocessor.ts"],"sourcesContent":["/**\n * Markdown preprocessing utilities\n *\n * These functions fix common markdown formatting issues before AST parsing.\n * They are applied in a specific order to ensure proper processing.\n */\n\nexport interface PreprocessorDiagnostic {\n  type: string;\n  original: string;\n  normalized: string;\n}\n\nexport interface PreprocessResult {\n  markdown: string;\n  diagnostics: PreprocessorDiagnostic[];\n}\n\n/**\n * Escape web5:// links by URL-encoding the URL part\n * e.g. [text](web5://some text with spaces) → [text](web5://some%20text%20with%20spaces)\n *\n * @param markdown - The markdown string to process\n * @returns The markdown string with web5:// URLs properly encoded\n */\nexport function escapeWeb5Links(markdown: string): string {\n  // Match markdown links with web5:// protocol\n  // Pattern: [text](web5://...)\n  return markdown.replace(\n    /\\[([^\\]]+)\\]\\((web5|entity|image):\\/\\/([^)]+)\\)/g,\n    (match, linkText, protocol, url) => {\n      try {\n        // Decode first to avoid double-encoding (e.g. %20 → %2520)\n        const decodedUrl = decodeURIComponent(url);\n        // Use encodeURI (not encodeURIComponent) to preserve URL structure\n        // characters like /, ?, &, = while encoding spaces and unsafe chars\n        const encodedUrl = encodeURI(decodedUrl);\n        return `[${linkText}](${protocol}://${encodedUrl})`;\n      } catch {\n        // decodeURIComponent throws on a malformed percent sequence (raw `%`\n        // or truncated `%X`), encodeURI on a lone surrogate. During streaming\n        // this happens when chunks are concatenated mid-escape or a multi-byte\n        // char is split. Leave the link untouched rather than throw — an\n        // uncaught error here aborts the whole streaming parse and surfaces as\n        // a 908 conversation-streaming-error even though the page rendered.\n        return match;\n      }\n    },\n  );\n}\n\n/**\n * Fix malformed markdown links with whitespace (spaces, tabs, newlines) between ] and (\n * e.g. [text] (url) → [text](url)\n * e.g. [text]\\n(url) → [text](url)\n *\n * @param markdown - The markdown string to process\n * @returns The markdown string with fixed link formatting\n */\nexport function fixMalformedLinks(markdown: string): string {\n  // \\s matches spaces, tabs, and newlines; + means one or more\n  // Also handle cases with newlines explicitly\n  return markdown.replace(/\\][\\s\\r\\n]+\\(/g, '](');\n}\n\n/**\n * Recover inline CTA chips where the LLM emitted emphasized text followed by a\n * dangling markdown link close, e.g. `**label →**](web5://ask/query)`.\n */\nexport function recoverOrphanedEmphasisLinks(markdown: string): {\n  result: string;\n  diagnostics: PreprocessorDiagnostic[];\n} {\n  const diagnostics: PreprocessorDiagnostic[] = [];\n  const result = markdown.replace(\n    /(^|[^\\[])\\*\\*([^\\n\\]*]+?)\\*\\*\\]\\((web5:\\/\\/(?:ask|action)\\/[^)]+)\\)/g,\n    (match, prefix: string, linkText: string, href: string) => {\n      const normalized = `${prefix}[${linkText.trim()}](${href})`;\n      diagnostics.push({\n        type: 'orphaned_emphasis_link_recovered',\n        original: match,\n        normalized,\n      });\n      return normalized;\n    },\n  );\n  return { result, diagnostics };\n}\n\n/**\n * Trim trailing whitespace from lines that contain text\n *\n * @param markdown - The markdown string to process\n * @returns The markdown string with trailing whitespace trimmed from text lines\n */\nexport function trimTrailingWhitespace(markdown: string): string {\n  const lines = markdown.split('\\n');\n  const processedLines: string[] = [];\n\n  for (const line of lines) {\n    const trimmedLine = line.trim();\n\n    // If the line has content, trim trailing whitespace (keep leading spaces for indentation)\n    if (trimmedLine.length > 0) {\n      processedLines.push(line.trimEnd());\n    } else {\n      // Lines with only whitespace become empty lines\n      processedLines.push('');\n    }\n  }\n\n  return processedLines.join('\\n');\n}\n\n/**\n * Normalize malformed web5://icon URLs to the canonical web5://icon/{name} format.\n * Handles variants like web5://icon:arrow, web5://icon-arrow, web5://icon arrow → web5://icon/arrow.\n * Only alphanumeric characters and dashes are kept in the icon name.\n */\nexport function normalizeIconUrls(markdown: string): {\n  result: string;\n  diagnostics: PreprocessorDiagnostic[];\n} {\n  const diagnostics: PreprocessorDiagnostic[] = [];\n  const result = markdown.replace(\n    /web5:\\/\\/icon(?:([:/-][^)\\s]+)|(?:\\s+([a-zA-Z0-9-]+)))/g,\n    (match, rest: string | undefined, spaceName: string | undefined) => {\n      const cleanName = (spaceName ?? rest ?? '')\n        .replace(/[^a-zA-Z0-9-]/g, '')\n        .replace(/^-+|-+$/g, '');\n      const normalized = `web5://icon/${cleanName}`;\n      if (match !== normalized) {\n        diagnostics.push({\n          type: 'icon_url_normalized',\n          original: match,\n          normalized,\n        });\n      }\n      return normalized;\n    },\n  );\n  return { result, diagnostics };\n}\n\nfunction isFenceToggle(line: string): boolean {\n  return /^\\s*(`{3,}|~{3,})/.test(line);\n}\n\nfunction splitPipeRow(line: string): string[] {\n  const trimmed = line.trim();\n  if (!trimmed.startsWith('|') || !trimmed.endsWith('|')) {\n    return [];\n  }\n  return trimmed\n    .slice(1, -1)\n    .split('|')\n    .map((cell) => cell.trim());\n}\n\nfunction isPipeRow(line: string): boolean {\n  return splitPipeRow(line).length >= 2;\n}\n\nfunction isTableDelimiterRow(line: string): boolean {\n  const cells = splitPipeRow(line);\n  return (\n    cells.length >= 2 &&\n    cells.every((cell) => /^:?-{3,}:?$/.test(cell.replace(/\\s+/g, '')))\n  );\n}\n\n/**\n * Repair LLM-emitted pipe tables that omit the GFM delimiter row.\n * Without this line remark-gfm parses the rows as plain paragraphs, so\n * registry sections such as comparison never receive a `table` part.\n */\nexport function insertMissingTableSeparators(markdown: string): {\n  result: string;\n  diagnostics: PreprocessorDiagnostic[];\n} {\n  const diagnostics: PreprocessorDiagnostic[] = [];\n  const lines = markdown.split('\\n');\n  const result: string[] = [];\n  let inFence = false;\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i];\n    const previousLine = result[result.length - 1] ?? '';\n    const nextLine = lines[i + 1] ?? '';\n\n    if (isFenceToggle(line)) {\n      inFence = !inFence;\n      result.push(line);\n      continue;\n    }\n\n    result.push(line);\n\n    if (inFence || !isPipeRow(line) || isPipeRow(previousLine)) {\n      continue;\n    }\n    if (!isPipeRow(nextLine) || isTableDelimiterRow(nextLine)) {\n      continue;\n    }\n\n    const headerCells = splitPipeRow(line);\n    const nextCells = splitPipeRow(nextLine);\n    if (headerCells.length !== nextCells.length) {\n      continue;\n    }\n\n    const separator = `| ${headerCells.map(() => '---').join(' | ')} |`;\n    result.push(separator);\n    diagnostics.push({\n      type: 'table_separator_inserted',\n      original: line,\n      normalized: `${line}\\n${separator}`,\n    });\n  }\n\n  return { result: result.join('\\n'), diagnostics };\n}\n\n/**\n * Decode URL-encoded text in markdown link labels.\n * e.g. [Some%20Text](https://example.com) → [Some Text](https://example.com)\n * e.g. [Which+solution%3F](web5://...) → [Which solution?](web5://...)\n *\n * Only decodes the text portion [text], never the URL portion (url).\n * Handles both `+` (form-encoded space) and `%XX` escapes; falls back to\n * the original string on malformed percent sequences.\n */\nexport function decodeLinkText(markdown: string): {\n  result: string;\n  diagnostics: PreprocessorDiagnostic[];\n} {\n  const diagnostics: PreprocessorDiagnostic[] = [];\n  const result = markdown.replace(\n    /\\[([^\\]]+)\\]\\(/g,\n    (match, linkText: string) => {\n      try {\n        const decoded = decodeURIComponent(linkText.replace(/\\+/g, '%20'));\n        if (decoded !== linkText) {\n          diagnostics.push({\n            type: 'link_text_decoded',\n            original: linkText,\n            normalized: decoded,\n          });\n        }\n        return `[${decoded}](`;\n      } catch {\n        // If decodeURIComponent fails (e.g. malformed percent sequence like %ZZ),\n        // leave the text unchanged\n        return match;\n      }\n    },\n  );\n  return { result, diagnostics };\n}\n\n/**\n * Preprocess markdown to fix common formatting issues before AST parsing.\n *\n * The preprocessing steps are applied in the following order:\n * 1. Recover orphaned emphasized web5 links\n * 2. Fix malformed links (remove whitespace between ] and () - must happen before web5 links are matched)\n * 3. Decode URL-encoded link text\n * 4. Escape web5:// links (URL-encode URLs)\n * 5. Normalize icon URLs\n * 6. Insert missing table separators for obvious pipe tables\n * 7. Trim trailing whitespace from lines\n *\n * @param markdown - The raw markdown string to preprocess\n * @returns The preprocessed markdown string ready for AST parsing\n */\nexport function preprocessMarkdown(markdown: string): PreprocessResult {\n  const { result: recoveredLinks, diagnostics: recoveredLinkDiagnostics } =\n    recoverOrphanedEmphasisLinks(markdown);\n  let processed = fixMalformedLinks(recoveredLinks);\n  const { result: decodedText, diagnostics: decodeDiagnostics } =\n    decodeLinkText(processed);\n  processed = escapeWeb5Links(decodedText);\n  const { result: normalized, diagnostics: iconDiagnostics } =\n    normalizeIconUrls(processed);\n  const { result: tableNormalized, diagnostics: tableDiagnostics } =\n    insertMissingTableSeparators(normalized);\n  processed = trimTrailingWhitespace(tableNormalized);\n  return {\n    markdown: processed,\n    diagnostics: [\n      ...recoveredLinkDiagnostics,\n      ...decodeDiagnostics,\n      ...iconDiagnostics,\n      ...tableDiagnostics,\n    ],\n  };\n}\n"],"mappings":";;;;;;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,eAAeA,CAACC,QAAgB,EAAU;EACxD;EACA;EACA,OAAOA,QAAQ,CAACC,OAAO,CACrB,kDAAkD,EAClD,CAACC,KAAK,EAAEC,QAAQ,EAAEC,QAAQ,EAAEC,GAAG,KAAK;IAClC,IAAI;MACF;MACA,MAAMC,UAAU,GAAGC,kBAAkB,CAACF,GAAG,CAAC;MAC1C;MACA;MACA,MAAMG,UAAU,GAAGC,SAAS,CAACH,UAAU,CAAC;MACxC,OAAO,IAAIH,QAAQ,KAAKC,QAAQ,MAAMI,UAAU,GAAG;IACrD,CAAC,CAAC,MAAM;MACN;MACA;MACA;MACA;MACA;MACA;MACA,OAAON,KAAK;IACd;EACF,CACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASQ,iBAAiBA,CAACV,QAAgB,EAAU;EAC1D;EACA;EACA,OAAOA,QAAQ,CAACC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC;AACjD;;AAEA;AACA;AACA;AACA;AACO,SAASU,4BAA4BA,CAACX,QAAgB,EAG3D;EACA,MAAMY,WAAqC,GAAG,EAAE;EAChD,MAAMC,MAAM,GAAGb,QAAQ,CAACC,OAAO,CAC7B,sEAAsE,EACtE,CAACC,KAAK,EAAEY,MAAc,EAAEX,QAAgB,EAAEY,IAAY,KAAK;IACzD,MAAMC,UAAU,GAAG,GAAGF,MAAM,IAAIX,QAAQ,CAACc,IAAI,CAAC,CAAC,KAAKF,IAAI,GAAG;IAC3DH,WAAW,CAACM,IAAI,CAAC;MACfC,IAAI,EAAE,kCAAkC;MACxCC,QAAQ,EAAElB,KAAK;MACfc;IACF,CAAC,CAAC;IACF,OAAOA,UAAU;EACnB,CACF,CAAC;EACD,OAAO;IAAEH,MAAM;IAAED;EAAY,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASS,sBAAsBA,CAACrB,QAAgB,EAAU;EAC/D,MAAMsB,KAAK,GAAGtB,QAAQ,CAACuB,KAAK,CAAC,IAAI,CAAC;EAClC,MAAMC,cAAwB,GAAG,EAAE;EAEnC,KAAK,MAAMC,IAAI,IAAIH,KAAK,EAAE;IACxB,MAAMI,WAAW,GAAGD,IAAI,CAACR,IAAI,CAAC,CAAC;;IAE/B;IACA,IAAIS,WAAW,CAACC,MAAM,GAAG,CAAC,EAAE;MAC1BH,cAAc,CAACN,IAAI,CAACO,IAAI,CAACG,OAAO,CAAC,CAAC,CAAC;IACrC,CAAC,MAAM;MACL;MACAJ,cAAc,CAACN,IAAI,CAAC,EAAE,CAAC;IACzB;EACF;EAEA,OAAOM,cAAc,CAACK,IAAI,CAAC,IAAI,CAAC;AAClC;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASC,iBAAiBA,CAAC9B,QAAgB,EAGhD;EACA,MAAMY,WAAqC,GAAG,EAAE;EAChD,MAAMC,MAAM,GAAGb,QAAQ,CAACC,OAAO,CAC7B,yDAAyD,EACzD,CAACC,KAAK,EAAE6B,IAAwB,EAAEC,SAA6B,KAAK;IAClE,MAAMC,SAAS,GAAG,CAACD,SAAS,IAAID,IAAI,IAAI,EAAE,EACvC9B,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAC7BA,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;IAC1B,MAAMe,UAAU,GAAG,eAAeiB,SAAS,EAAE;IAC7C,IAAI/B,KAAK,KAAKc,UAAU,EAAE;MACxBJ,WAAW,CAACM,IAAI,CAAC;QACfC,IAAI,EAAE,qBAAqB;QAC3BC,QAAQ,EAAElB,KAAK;QACfc;MACF,CAAC,CAAC;IACJ;IACA,OAAOA,UAAU;EACnB,CACF,CAAC;EACD,OAAO;IAAEH,MAAM;IAAED;EAAY,CAAC;AAChC;AAEA,SAASsB,aAAaA,CAACT,IAAY,EAAW;EAC5C,OAAO,mBAAmB,CAACU,IAAI,CAACV,IAAI,CAAC;AACvC;AAEA,SAASW,YAAYA,CAACX,IAAY,EAAY;EAC5C,MAAMY,OAAO,GAAGZ,IAAI,CAACR,IAAI,CAAC,CAAC;EAC3B,IAAI,CAACoB,OAAO,CAACC,UAAU,CAAC,GAAG,CAAC,IAAI,CAACD,OAAO,CAACE,QAAQ,CAAC,GAAG,CAAC,EAAE;IACtD,OAAO,EAAE;EACX;EACA,OAAOF,OAAO,CACXG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACZjB,KAAK,CAAC,GAAG,CAAC,CACVkB,GAAG,CAAEC,IAAI,IAAKA,IAAI,CAACzB,IAAI,CAAC,CAAC,CAAC;AAC/B;AAEA,SAAS0B,SAASA,CAAClB,IAAY,EAAW;EACxC,OAAOW,YAAY,CAACX,IAAI,CAAC,CAACE,MAAM,IAAI,CAAC;AACvC;AAEA,SAASiB,mBAAmBA,CAACnB,IAAY,EAAW;EAClD,MAAMoB,KAAK,GAAGT,YAAY,CAACX,IAAI,CAAC;EAChC,OACEoB,KAAK,CAAClB,MAAM,IAAI,CAAC,IACjBkB,KAAK,CAACC,KAAK,CAAEJ,IAAI,IAAK,aAAa,CAACP,IAAI,CAACO,IAAI,CAACzC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;AAEvE;;AAEA;AACA;AACA;AACA;AACA;AACO,SAAS8C,4BAA4BA,CAAC/C,QAAgB,EAG3D;EACA,MAAMY,WAAqC,GAAG,EAAE;EAChD,MAAMU,KAAK,GAAGtB,QAAQ,CAACuB,KAAK,CAAC,IAAI,CAAC;EAClC,MAAMV,MAAgB,GAAG,EAAE;EAC3B,IAAImC,OAAO,GAAG,KAAK;EAEnB,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAG3B,KAAK,CAACK,MAAM,EAAEsB,CAAC,EAAE,EAAE;IACrC,MAAMxB,IAAI,GAAGH,KAAK,CAAC2B,CAAC,CAAC;IACrB,MAAMC,YAAY,GAAGrC,MAAM,CAACA,MAAM,CAACc,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE;IACpD,MAAMwB,QAAQ,GAAG7B,KAAK,CAAC2B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;IAEnC,IAAIf,aAAa,CAACT,IAAI,CAAC,EAAE;MACvBuB,OAAO,GAAG,CAACA,OAAO;MAClBnC,MAAM,CAACK,IAAI,CAACO,IAAI,CAAC;MACjB;IACF;IAEAZ,MAAM,CAACK,IAAI,CAACO,IAAI,CAAC;IAEjB,IAAIuB,OAAO,IAAI,CAACL,SAAS,CAAClB,IAAI,CAAC,IAAIkB,SAAS,CAACO,YAAY,CAAC,EAAE;MAC1D;IACF;IACA,IAAI,CAACP,SAAS,CAACQ,QAAQ,CAAC,IAAIP,mBAAmB,CAACO,QAAQ,CAAC,EAAE;MACzD;IACF;IAEA,MAAMC,WAAW,GAAGhB,YAAY,CAACX,IAAI,CAAC;IACtC,MAAM4B,SAAS,GAAGjB,YAAY,CAACe,QAAQ,CAAC;IACxC,IAAIC,WAAW,CAACzB,MAAM,KAAK0B,SAAS,CAAC1B,MAAM,EAAE;MAC3C;IACF;IAEA,MAAM2B,SAAS,GAAG,KAAKF,WAAW,CAACX,GAAG,CAAC,MAAM,KAAK,CAAC,CAACZ,IAAI,CAAC,KAAK,CAAC,IAAI;IACnEhB,MAAM,CAACK,IAAI,CAACoC,SAAS,CAAC;IACtB1C,WAAW,CAACM,IAAI,CAAC;MACfC,IAAI,EAAE,0BAA0B;MAChCC,QAAQ,EAAEK,IAAI;MACdT,UAAU,EAAE,GAAGS,IAAI,KAAK6B,SAAS;IACnC,CAAC,CAAC;EACJ;EAEA,OAAO;IAAEzC,MAAM,EAAEA,MAAM,CAACgB,IAAI,CAAC,IAAI,CAAC;IAAEjB;EAAY,CAAC;AACnD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS2C,cAAcA,CAACvD,QAAgB,EAG7C;EACA,MAAMY,WAAqC,GAAG,EAAE;EAChD,MAAMC,MAAM,GAAGb,QAAQ,CAACC,OAAO,CAC7B,iBAAiB,EACjB,CAACC,KAAK,EAAEC,QAAgB,KAAK;IAC3B,IAAI;MACF,MAAMqD,OAAO,GAAGjD,kBAAkB,CAACJ,QAAQ,CAACF,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;MAClE,IAAIuD,OAAO,KAAKrD,QAAQ,EAAE;QACxBS,WAAW,CAACM,IAAI,CAAC;UACfC,IAAI,EAAE,mBAAmB;UACzBC,QAAQ,EAAEjB,QAAQ;UAClBa,UAAU,EAAEwC;QACd,CAAC,CAAC;MACJ;MACA,OAAO,IAAIA,OAAO,IAAI;IACxB,CAAC,CAAC,MAAM;MACN;MACA;MACA,OAAOtD,KAAK;IACd;EACF,CACF,CAAC;EACD,OAAO;IAAEW,MAAM;IAAED;EAAY,CAAC;AAChC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS6C,kBAAkBA,CAACzD,QAAgB,EAAoB;EACrE,MAAM;IAAEa,MAAM,EAAE6C,cAAc;IAAE9C,WAAW,EAAE+C;EAAyB,CAAC,GACrEhD,4BAA4B,CAACX,QAAQ,CAAC;EACxC,IAAI4D,SAAS,GAAGlD,iBAAiB,CAACgD,cAAc,CAAC;EACjD,MAAM;IAAE7C,MAAM,EAAEgD,WAAW;IAAEjD,WAAW,EAAEkD;EAAkB,CAAC,GAC3DP,cAAc,CAACK,SAAS,CAAC;EAC3BA,SAAS,GAAG7D,eAAe,CAAC8D,WAAW,CAAC;EACxC,MAAM;IAAEhD,MAAM,EAAEG,UAAU;IAAEJ,WAAW,EAAEmD;EAAgB,CAAC,GACxDjC,iBAAiB,CAAC8B,SAAS,CAAC;EAC9B,MAAM;IAAE/C,MAAM,EAAEmD,eAAe;IAAEpD,WAAW,EAAEqD;EAAiB,CAAC,GAC9DlB,4BAA4B,CAAC/B,UAAU,CAAC;EAC1C4C,SAAS,GAAGvC,sBAAsB,CAAC2C,eAAe,CAAC;EACnD,OAAO;IACLhE,QAAQ,EAAE4D,SAAS;IACnBhD,WAAW,EAAE,CACX,GAAG+C,wBAAwB,EAC3B,GAAGG,iBAAiB,EACpB,GAAGC,eAAe,EAClB,GAAGE,gBAAgB;EAEvB,CAAC;AACH","ignoreList":[]}

package/dist/cjs/utils/navigationStack.js

@@ -0,0 +1,35 @@
+"use strict";
+
+exports.__esModule = true;
+exports.clearForwardStack = clearForwardStack;
+exports.getForwardStack = getForwardStack;
+exports.popFromForwardStack = popFromForwardStack;
+exports.pushToForwardStack = pushToForwardStack;
+exports.setForwardStack = setForwardStack;
+const FORWARD_STACK_KEY = 'web5_conversation_forward_stack';
+function getForwardStack() {
+  try {
+    const raw = sessionStorage.getItem(FORWARD_STACK_KEY);
+    return raw ? JSON.parse(raw) : [];
+  } catch {
+    return [];
+  }
+}
+function setForwardStack(stack) {
+  sessionStorage.setItem(FORWARD_STACK_KEY, JSON.stringify(stack));
+}
+function clearForwardStack() {
+  sessionStorage.removeItem(FORWARD_STACK_KEY);
+}
+function pushToForwardStack(triggerId) {
+  const stack = getForwardStack();
+  stack.push(triggerId);
+  setForwardStack(stack);
+}
+function popFromForwardStack() {
+  const stack = getForwardStack();
+  const triggerId = stack.pop();
+  setForwardStack(stack);
+  return triggerId;
+}
+//# sourceMappingURL=navigationStack.js.map

package/dist/cjs/utils/navigationStack.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FORWARD_STACK_KEY","getForwardStack","raw","sessionStorage","getItem","JSON","parse","setForwardStack","stack","setItem","stringify","clearForwardStack","removeItem","pushToForwardStack","triggerId","push","popFromForwardStack","pop"],"sources":["../../../src/utils/navigationStack.ts"],"sourcesContent":["const FORWARD_STACK_KEY = 'web5_conversation_forward_stack';\n\nexport function getForwardStack(): string[] {\n  try {\n    const raw = sessionStorage.getItem(FORWARD_STACK_KEY);\n    return raw ? JSON.parse(raw) : [];\n  } catch {\n    return [];\n  }\n}\n\nexport function setForwardStack(stack: string[]) {\n  sessionStorage.setItem(FORWARD_STACK_KEY, JSON.stringify(stack));\n}\n\nexport function clearForwardStack() {\n  sessionStorage.removeItem(FORWARD_STACK_KEY);\n}\n\nexport function pushToForwardStack(triggerId: string) {\n  const stack = getForwardStack();\n  stack.push(triggerId);\n  setForwardStack(stack);\n}\n\nexport function popFromForwardStack(): string | undefined {\n  const stack = getForwardStack();\n  const triggerId = stack.pop();\n  setForwardStack(stack);\n  return triggerId;\n}\n"],"mappings":";;;;;;;;AAAA,MAAMA,iBAAiB,GAAG,iCAAiC;AAEpD,SAASC,eAAeA,CAAA,EAAa;EAC1C,IAAI;IACF,MAAMC,GAAG,GAAGC,cAAc,CAACC,OAAO,CAACJ,iBAAiB,CAAC;IACrD,OAAOE,GAAG,GAAGG,IAAI,CAACC,KAAK,CAACJ,GAAG,CAAC,GAAG,EAAE;EACnC,CAAC,CAAC,MAAM;IACN,OAAO,EAAE;EACX;AACF;AAEO,SAASK,eAAeA,CAACC,KAAe,EAAE;EAC/CL,cAAc,CAACM,OAAO,CAACT,iBAAiB,EAAEK,IAAI,CAACK,SAAS,CAACF,KAAK,CAAC,CAAC;AAClE;AAEO,SAASG,iBAAiBA,CAAA,EAAG;EAClCR,cAAc,CAACS,UAAU,CAACZ,iBAAiB,CAAC;AAC9C;AAEO,SAASa,kBAAkBA,CAACC,SAAiB,EAAE;EACpD,MAAMN,KAAK,GAAGP,eAAe,CAAC,CAAC;EAC/BO,KAAK,CAACO,IAAI,CAACD,SAAS,CAAC;EACrBP,eAAe,CAACC,KAAK,CAAC;AACxB;AAEO,SAASQ,mBAAmBA,CAAA,EAAuB;EACxD,MAAMR,KAAK,GAAGP,eAAe,CAAC,CAAC;EAC/B,MAAMa,SAAS,GAAGN,KAAK,CAACS,GAAG,CAAC,CAAC;EAC7BV,eAAe,CAACC,KAAK,CAAC;EACtB,OAAOM,SAAS;AAClB","ignoreList":[]}

package/dist/cjs/utils/nodeMatchers.js

@@ -0,0 +1,43 @@
+"use strict";
+
+exports.__esModule = true;
+exports.hasImage = hasImage;
+exports.isHtmlComment = isHtmlComment;
+/**
+ * Check if an HTML node is a comment
+ */
+function isHtmlComment(node) {
+  if (node.type !== 'html') {
+    return false;
+  }
+  const value = node.value;
+  return value.trim().startsWith('<!--') && value.trim().endsWith('-->');
+}
+
+/**
+ * Check if a node has images nested within it (for paragraphs with images)
+ */
+function hasImage(node) {
+  if (node.type === 'image') {
+    return true;
+  }
+  const checkChildren = children => {
+    if (!children) {
+      return false;
+    }
+    for (const child of children) {
+      if (child.type === 'image') {
+        return true;
+      }
+      if (child.children && checkChildren(child.children)) {
+        return true;
+      }
+    }
+    return false;
+  };
+  if ('children' in node && node.children) {
+    return checkChildren(node.children);
+  }
+  return false;
+}
+//# sourceMappingURL=nodeMatchers.js.map

package/dist/cjs/utils/nodeMatchers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isHtmlComment","node","type","value","trim","startsWith","endsWith","hasImage","checkChildren","children","child"],"sources":["../../../src/utils/nodeMatchers.ts"],"sourcesContent":["import type { RootContent } from 'mdast';\n\n/**\n * Check if an HTML node is a comment\n */\nexport function isHtmlComment(node: any): boolean {\n  if (node.type !== 'html') {\n    return false;\n  }\n  const value = node.value as string;\n  return value.trim().startsWith('<!--') && value.trim().endsWith('-->');\n}\n\n/**\n * Check if a node has images nested within it (for paragraphs with images)\n */\nexport function hasImage(node: RootContent): boolean {\n  if (node.type === 'image') {\n    return true;\n  }\n\n  const checkChildren = (children: any[]): boolean => {\n    if (!children) {\n      return false;\n    }\n    for (const child of children) {\n      if (child.type === 'image') {\n        return true;\n      }\n      if (child.children && checkChildren(child.children)) {\n        return true;\n      }\n    }\n    return false;\n  };\n\n  if ('children' in node && node.children) {\n    return checkChildren(node.children);\n  }\n\n  return false;\n}\n"],"mappings":";;;;;AAEA;AACA;AACA;AACO,SAASA,aAAaA,CAACC,IAAS,EAAW;EAChD,IAAIA,IAAI,CAACC,IAAI,KAAK,MAAM,EAAE;IACxB,OAAO,KAAK;EACd;EACA,MAAMC,KAAK,GAAGF,IAAI,CAACE,KAAe;EAClC,OAAOA,KAAK,CAACC,IAAI,CAAC,CAAC,CAACC,UAAU,CAAC,MAAM,CAAC,IAAIF,KAAK,CAACC,IAAI,CAAC,CAAC,CAACE,QAAQ,CAAC,KAAK,CAAC;AACxE;;AAEA;AACA;AACA;AACO,SAASC,QAAQA,CAACN,IAAiB,EAAW;EACnD,IAAIA,IAAI,CAACC,IAAI,KAAK,OAAO,EAAE;IACzB,OAAO,IAAI;EACb;EAEA,MAAMM,aAAa,GAAIC,QAAe,IAAc;IAClD,IAAI,CAACA,QAAQ,EAAE;MACb,OAAO,KAAK;IACd;IACA,KAAK,MAAMC,KAAK,IAAID,QAAQ,EAAE;MAC5B,IAAIC,KAAK,CAACR,IAAI,KAAK,OAAO,EAAE;QAC1B,OAAO,IAAI;MACb;MACA,IAAIQ,KAAK,CAACD,QAAQ,IAAID,aAAa,CAACE,KAAK,CAACD,QAAQ,CAAC,EAAE;QACnD,OAAO,IAAI;MACb;IACF;IACA,OAAO,KAAK;EACd,CAAC;EAED,IAAI,UAAU,IAAIR,IAAI,IAAIA,IAAI,CAACQ,QAAQ,EAAE;IACvC,OAAOD,aAAa,CAACP,IAAI,CAACQ,QAAQ,CAAC;EACrC;EAEA,OAAO,KAAK;AACd","ignoreList":[]}

package/dist/cjs/utils/propsExtractor.js

@@ -0,0 +1,66 @@
+"use strict";
+
+exports.__esModule = true;
+exports.createPageSection = createPageSection;
+exports.findImageInNode = exports.findImageInChildren = void 0;
+exports.generateId = generateId;
+exports.generateSectionId = generateSectionId;
+const findImageInNode = node => {
+  if (node.type === 'image') {
+    return node.url || '';
+  }
+  if ('children' in node && node.children) {
+    for (const child of node.children) {
+      const imageUrl = findImageInNode(child);
+      if (imageUrl) {
+        return imageUrl;
+      }
+    }
+  }
+  return null;
+};
+exports.findImageInNode = findImageInNode;
+const findImageInChildren = children => {
+  for (const child of children) {
+    if (child.type === 'image') {
+      return child.url || '';
+    }
+    if ('children' in child && child.children) {
+      const imageUrl = findImageInChildren(child.children);
+      if (imageUrl) {
+        return imageUrl;
+      }
+    }
+  }
+  return '';
+};
+exports.findImageInChildren = findImageInChildren;
+function generateSectionId(componentName, index) {
+  return `markdown-section-${componentName.toLowerCase()}-${index}`;
+}
+function createPageSection({
+  component,
+  sectionType,
+  componentName,
+  semantic,
+  componentOptions,
+  index,
+  id,
+  sourceMarkdown,
+  debugProps
+}) {
+  return {
+    id: id ?? generateSectionId(sectionType, index),
+    sectionType,
+    componentName,
+    semantic,
+    componentOptions,
+    component,
+    sourceMarkdown: sourceMarkdown ?? '',
+    debugProps
+  };
+}
+function generateId() {
+  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+//# sourceMappingURL=propsExtractor.js.map

package/dist/cjs/utils/propsExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["findImageInNode","node","type","url","children","child","imageUrl","exports","findImageInChildren","generateSectionId","componentName","index","toLowerCase","createPageSection","component","sectionType","semantic","componentOptions","id","sourceMarkdown","debugProps","generateId","Date","now","Math","random","toString","substr"],"sources":["../../../src/utils/propsExtractor.ts"],"sourcesContent":["import type { RootContent } from 'mdast';\nimport type { PageSection } from '../types/page-section';\nimport { ReactElement } from 'react';\n\nexport interface Product {\n  id: string;\n  imageUrl: string;\n  productName: string;\n  description?: string;\n  price?: string;\n  onClick?: string;\n  linkText?: string;\n  linkUrl?: string;\n  colorSwatches?: string[];\n  badgeText?: string;\n  rating?: number;\n  reviewCount?: number;\n}\n\nexport interface ComparisonProduct {\n  id: string;\n  imageUrl: string;\n  name: string;\n  price: string;\n  onClick?: string;\n  features: Record<string, string>;\n}\n\nexport interface ProductComparisonSectionProps {\n  title: string;\n  subtitle?: string;\n  products: ComparisonProduct[];\n  backgroundColor?: string;\n  highlightDifferences?: boolean;\n  showImages?: boolean;\n  onProductClick?: string;\n  ready: boolean;\n}\n\nexport const findImageInNode = (node: RootContent): string | null => {\n  if (node.type === 'image') {\n    return node.url || '';\n  }\n  if ('children' in node && node.children) {\n    for (const child of node.children) {\n      const imageUrl = findImageInNode(child);\n      if (imageUrl) {\n        return imageUrl;\n      }\n    }\n  }\n  return null;\n};\n\nexport const findImageInChildren = (children: RootContent[]): string => {\n  for (const child of children) {\n    if (child.type === 'image') {\n      return child.url || '';\n    }\n    if ('children' in child && child.children) {\n      const imageUrl = findImageInChildren(child.children);\n      if (imageUrl) {\n        return imageUrl;\n      }\n    }\n  }\n  return '';\n};\n\nexport function generateSectionId(\n  componentName: string,\n  index: number,\n): string {\n  return `markdown-section-${componentName.toLowerCase()}-${index}`;\n}\n\nexport function createPageSection({\n  component,\n  sectionType,\n  componentName,\n  semantic,\n  componentOptions,\n  index,\n  id,\n  sourceMarkdown,\n  debugProps,\n}: {\n  component: ReactElement | null;\n  sectionType: string;\n  componentName?: string;\n  semantic?: string;\n  componentOptions?: Record<string, any>;\n  index: number;\n  id?: string;\n  sourceMarkdown?: string;\n  debugProps?: any;\n}): PageSection {\n  return {\n    id: id ?? generateSectionId(sectionType, index),\n    sectionType,\n    componentName,\n    semantic,\n    componentOptions,\n    component,\n    sourceMarkdown: sourceMarkdown ?? '',\n    debugProps,\n  };\n}\n\nexport function generateId(): string {\n  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n}\n"],"mappings":";;;;;;;AAuCO,MAAMA,eAAe,GAAIC,IAAiB,IAAoB;EACnE,IAAIA,IAAI,CAACC,IAAI,KAAK,OAAO,EAAE;IACzB,OAAOD,IAAI,CAACE,GAAG,IAAI,EAAE;EACvB;EACA,IAAI,UAAU,IAAIF,IAAI,IAAIA,IAAI,CAACG,QAAQ,EAAE;IACvC,KAAK,MAAMC,KAAK,IAAIJ,IAAI,CAACG,QAAQ,EAAE;MACjC,MAAME,QAAQ,GAAGN,eAAe,CAACK,KAAK,CAAC;MACvC,IAAIC,QAAQ,EAAE;QACZ,OAAOA,QAAQ;MACjB;IACF;EACF;EACA,OAAO,IAAI;AACb,CAAC;AAACC,OAAA,CAAAP,eAAA,GAAAA,eAAA;AAEK,MAAMQ,mBAAmB,GAAIJ,QAAuB,IAAa;EACtE,KAAK,MAAMC,KAAK,IAAID,QAAQ,EAAE;IAC5B,IAAIC,KAAK,CAACH,IAAI,KAAK,OAAO,EAAE;MAC1B,OAAOG,KAAK,CAACF,GAAG,IAAI,EAAE;IACxB;IACA,IAAI,UAAU,IAAIE,KAAK,IAAIA,KAAK,CAACD,QAAQ,EAAE;MACzC,MAAME,QAAQ,GAAGE,mBAAmB,CAACH,KAAK,CAACD,QAAQ,CAAC;MACpD,IAAIE,QAAQ,EAAE;QACZ,OAAOA,QAAQ;MACjB;IACF;EACF;EACA,OAAO,EAAE;AACX,CAAC;AAACC,OAAA,CAAAC,mBAAA,GAAAA,mBAAA;AAEK,SAASC,iBAAiBA,CAC/BC,aAAqB,EACrBC,KAAa,EACL;EACR,OAAO,oBAAoBD,aAAa,CAACE,WAAW,CAAC,CAAC,IAAID,KAAK,EAAE;AACnE;AAEO,SAASE,iBAAiBA,CAAC;EAChCC,SAAS;EACTC,WAAW;EACXL,aAAa;EACbM,QAAQ;EACRC,gBAAgB;EAChBN,KAAK;EACLO,EAAE;EACFC,cAAc;EACdC;AAWF,CAAC,EAAe;EACd,OAAO;IACLF,EAAE,EAAEA,EAAE,IAAIT,iBAAiB,CAACM,WAAW,EAAEJ,KAAK,CAAC;IAC/CI,WAAW;IACXL,aAAa;IACbM,QAAQ;IACRC,gBAAgB;IAChBH,SAAS;IACTK,cAAc,EAAEA,cAAc,IAAI,EAAE;IACpCC;EACF,CAAC;AACH;AAEO,SAASC,UAAUA,CAAA,EAAW;EACnC,OAAO,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,IAAIC,IAAI,CAACC,MAAM,CAAC,CAAC,CAACC,QAAQ,CAAC,EAAE,CAAC,CAACC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;AACnE","ignoreList":[]}

package/dist/cjs/utils/sessionManager.js

@@ -0,0 +1,161 @@
+"use strict";
+
+exports.__esModule = true;
+exports.startNewChatId = exports.setChatId = exports.resetChatIdForTests = exports.getSessionId = exports.getOrCreateSessionId = exports.getChatId = void 0;
+/**
+ * Session identity shared across every surface that calls `/conversation`.
+ *
+ * Lives in web5-core (lifted from web50-server-ui, same move as
+ * `conversationBackend.ts`) so the main app and the embed-placement bundle
+ * send the same `sessionId` structure — a GUID persisted in sessionStorage
+ * under one key/codec. Surfaces on the same origin literally share the id;
+ * on different origins they still agree on the wire shape.
+ */
+
+const SESSION_ID_KEY = 'sessionId';
+
+/**
+ * Generates a random GUID
+ */
+const generateGuid = () => {
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
+    const r = Math.random() * 16 | 0;
+    const v = c === 'x' ? r : r & 0x3 | 0x8;
+    return v.toString(16);
+  });
+};
+const readStoredSessionId = () => {
+  try {
+    const raw = sessionStorage.getItem(SESSION_ID_KEY);
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    // sessionStorage can throw in privacy mode / non-DOM environments.
+    return null;
+  }
+};
+
+/**
+ * Gets or creates a session ID from sessionStorage.
+ * If no session ID exists, creates a new one and stores it.
+ * If it exists, returns the existing one without overriding.
+ * Falls back to an ephemeral GUID when sessionStorage is unavailable
+ * (SSR, storage disabled).
+ */
+const getOrCreateSessionId = () => {
+  const existing = readStoredSessionId();
+  if (existing) {
+    return existing;
+  }
+  const id = generateGuid();
+  try {
+    sessionStorage.setItem(SESSION_ID_KEY, JSON.stringify(id));
+  } catch {
+    // Quota exceeded / storage disabled — ephemeral id still works
+  }
+  return id;
+};
+
+/**
+ * Gets the current session ID without creating a new one
+ */
+exports.getOrCreateSessionId = getOrCreateSessionId;
+const getSessionId = () => {
+  return readStoredSessionId();
+};
+exports.getSessionId = getSessionId;
+const CHAT_ID_KEY = 'chatId';
+let chatId = null;
+const readStoredChatId = () => {
+  try {
+    const raw = sessionStorage.getItem(CHAT_ID_KEY);
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    // sessionStorage can throw in privacy mode / non-DOM environments.
+    return null;
+  }
+};
+const persistChatId = id => {
+  try {
+    sessionStorage.setItem(CHAT_ID_KEY, JSON.stringify(id));
+  } catch {
+    // Quota exceeded / storage disabled — ephemeral id still works.
+  }
+};
+
+/**
+ * Mints a `chat-id-<epoch>-<random>` id. The random suffix prevents two
+ * pages (or two visitors on the same site) that start a conversation in
+ * the same millisecond from colliding on the same conversation id — the
+ * backend locks per conversation and rejects the loser with
+ * "Conversation is busy".
+ */
+const mintChatId = () => `chat-id-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+
+/**
+ * Session-stable chat id (`chat-id-<epoch>-<random>`), persisted in
+ * sessionStorage under the same key/codec convention as the session id.
+ *
+ * Persisted (changed from the original in-memory-only page-visit scope) so
+ * the chat CARRIES OVER across same-origin navigations — main web5 page →
+ * product page and between PDPs. On the markdown-history backend the chat id
+ * is the conversation id, so this threads all of a visit's turns into one
+ * conversation (history/BO grouping) and keeps the BE's history cache
+ * (`msid_chatId`) warm across pages — classify's `<last_turn>` sees the
+ * previous page's turn. Placement prompt isolation is NOT affected: the BE's
+ * running-context key prefers the per-placement `session_id` that
+ * embed-placement sends, falling back to this chat id only for surfaces
+ * that don't send one (the main app).
+ *
+ * In-memory memo remains the fast path and the fallback when storage is
+ * unavailable (SSR, privacy mode) — there the id is page-load-stable, the
+ * previous behavior.
+ */
+const getChatId = () => {
+  if (chatId !== null) return chatId;
+  const stored = readStoredChatId();
+  if (stored) {
+    chatId = stored;
+    return chatId;
+  }
+  chatId = mintChatId();
+  persistChatId(chatId);
+  return chatId;
+};
+
+/**
+ * Mint a fresh chat id, replacing the memoized AND persisted one. Call when
+ * the user starts a NEW conversation (main app's first send of a fresh
+ * thread) — the previous conversation's id must not leak into the new one,
+ * or into the placement calls of the pages visited next.
+ */
+exports.getChatId = getChatId;
+const startNewChatId = () => {
+  chatId = mintChatId();
+  persistChatId(chatId);
+  return chatId;
+};
+
+/**
+ * Adopt an externally resolved chat id — e.g. a conversation restored from
+ * history by trigger id — as the session's current chat. Memoized and
+ * persisted so the next pages' placement calls continue that conversation.
+ */
+exports.startNewChatId = startNewChatId;
+const setChatId = id => {
+  if (!id) return;
+  chatId = id;
+  persistChatId(id);
+};
+
+/** Test-only: reset the memoized chat id and its persisted copy. */
+exports.setChatId = setChatId;
+const resetChatIdForTests = () => {
+  chatId = null;
+  try {
+    sessionStorage.removeItem(CHAT_ID_KEY);
+  } catch {
+    // Storage unavailable — nothing persisted to clear.
+  }
+};
+exports.resetChatIdForTests = resetChatIdForTests;
+//# sourceMappingURL=sessionManager.js.map

package/dist/cjs/utils/sessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SESSION_ID_KEY","generateGuid","replace","c","r","Math","random","v","toString","readStoredSessionId","raw","sessionStorage","getItem","JSON","parse","getOrCreateSessionId","existing","id","setItem","stringify","exports","getSessionId","CHAT_ID_KEY","chatId","readStoredChatId","persistChatId","mintChatId","Date","now","slice","getChatId","stored","startNewChatId","setChatId","resetChatIdForTests","removeItem"],"sources":["../../../src/utils/sessionManager.ts"],"sourcesContent":["/**\n * Session identity shared across every surface that calls `/conversation`.\n *\n * Lives in web5-core (lifted from web50-server-ui, same move as\n * `conversationBackend.ts`) so the main app and the embed-placement bundle\n * send the same `sessionId` structure — a GUID persisted in sessionStorage\n * under one key/codec. Surfaces on the same origin literally share the id;\n * on different origins they still agree on the wire shape.\n */\n\nconst SESSION_ID_KEY = 'sessionId';\n\n/**\n * Generates a random GUID\n */\nconst generateGuid = (): string => {\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n};\n\nconst readStoredSessionId = (): string | null => {\n  try {\n    const raw = sessionStorage.getItem(SESSION_ID_KEY);\n    return raw ? (JSON.parse(raw) as string) : null;\n  } catch {\n    // sessionStorage can throw in privacy mode / non-DOM environments.\n    return null;\n  }\n};\n\n/**\n * Gets or creates a session ID from sessionStorage.\n * If no session ID exists, creates a new one and stores it.\n * If it exists, returns the existing one without overriding.\n * Falls back to an ephemeral GUID when sessionStorage is unavailable\n * (SSR, storage disabled).\n */\nexport const getOrCreateSessionId = (): string => {\n  const existing = readStoredSessionId();\n  if (existing) {\n    return existing;\n  }\n  const id = generateGuid();\n  try {\n    sessionStorage.setItem(SESSION_ID_KEY, JSON.stringify(id));\n  } catch {\n    // Quota exceeded / storage disabled — ephemeral id still works\n  }\n  return id;\n};\n\n/**\n * Gets the current session ID without creating a new one\n */\nexport const getSessionId = (): string | null => {\n  return readStoredSessionId();\n};\n\nconst CHAT_ID_KEY = 'chatId';\n\nlet chatId: string | null = null;\n\nconst readStoredChatId = (): string | null => {\n  try {\n    const raw = sessionStorage.getItem(CHAT_ID_KEY);\n    return raw ? (JSON.parse(raw) as string) : null;\n  } catch {\n    // sessionStorage can throw in privacy mode / non-DOM environments.\n    return null;\n  }\n};\n\nconst persistChatId = (id: string): void => {\n  try {\n    sessionStorage.setItem(CHAT_ID_KEY, JSON.stringify(id));\n  } catch {\n    // Quota exceeded / storage disabled — ephemeral id still works.\n  }\n};\n\n/**\n * Mints a `chat-id-<epoch>-<random>` id. The random suffix prevents two\n * pages (or two visitors on the same site) that start a conversation in\n * the same millisecond from colliding on the same conversation id — the\n * backend locks per conversation and rejects the loser with\n * \"Conversation is busy\".\n */\nconst mintChatId = (): string =>\n  `chat-id-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n\n/**\n * Session-stable chat id (`chat-id-<epoch>-<random>`), persisted in\n * sessionStorage under the same key/codec convention as the session id.\n *\n * Persisted (changed from the original in-memory-only page-visit scope) so\n * the chat CARRIES OVER across same-origin navigations — main web5 page →\n * product page and between PDPs. On the markdown-history backend the chat id\n * is the conversation id, so this threads all of a visit's turns into one\n * conversation (history/BO grouping) and keeps the BE's history cache\n * (`msid_chatId`) warm across pages — classify's `<last_turn>` sees the\n * previous page's turn. Placement prompt isolation is NOT affected: the BE's\n * running-context key prefers the per-placement `session_id` that\n * embed-placement sends, falling back to this chat id only for surfaces\n * that don't send one (the main app).\n *\n * In-memory memo remains the fast path and the fallback when storage is\n * unavailable (SSR, privacy mode) — there the id is page-load-stable, the\n * previous behavior.\n */\nexport const getChatId = (): string => {\n  if (chatId !== null) return chatId;\n  const stored = readStoredChatId();\n  if (stored) {\n    chatId = stored;\n    return chatId;\n  }\n  chatId = mintChatId();\n  persistChatId(chatId);\n  return chatId;\n};\n\n/**\n * Mint a fresh chat id, replacing the memoized AND persisted one. Call when\n * the user starts a NEW conversation (main app's first send of a fresh\n * thread) — the previous conversation's id must not leak into the new one,\n * or into the placement calls of the pages visited next.\n */\nexport const startNewChatId = (): string => {\n  chatId = mintChatId();\n  persistChatId(chatId);\n  return chatId;\n};\n\n/**\n * Adopt an externally resolved chat id — e.g. a conversation restored from\n * history by trigger id — as the session's current chat. Memoized and\n * persisted so the next pages' placement calls continue that conversation.\n */\nexport const setChatId = (id: string): void => {\n  if (!id) return;\n  chatId = id;\n  persistChatId(id);\n};\n\n/** Test-only: reset the memoized chat id and its persisted copy. */\nexport const resetChatIdForTests = (): void => {\n  chatId = null;\n  try {\n    sessionStorage.removeItem(CHAT_ID_KEY);\n  } catch {\n    // Storage unavailable — nothing persisted to clear.\n  }\n};\n"],"mappings":"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","ignoreList":[]}