@stackql/provider-utils 0.1.9 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackql/provider-utils",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "Utilities for building StackQL providers from OpenAPI specifications.",
   "type": "module",
   "main": "./src/index.js",

package/src/docgen/helpers.js

@@ -23,52 +23,43 @@ export function getIndefiniteArticle(resourceName) {
   return article;
 }
 
-// export function sanitizeHtml(text) {
-//   return text
-//     // Replace "<" unless it's followed by "a", "/a", "b", "/b", "strong", or "/strong"
-//     .replace(/<(?!\/?(?:a|b|strong)\b)/gi, '&lt;')
-//     // Replace ">" unless it's preceded by "</a", "<a ...>", "</b", "<b ...>", "</strong", or "<strong ...>"
-//     .replace(/(?<!<\/?(?:a|b|strong)[^>]*)>/gi, '&gt;')
-//     // Add quotes around unquoted href values (within <a ...>)
-//     .replace(/(<a\b[^>]*?)href=([^"' \t\r\n>]+)/gi, '$1href="$2"')
-//     // Wrap backticked text with <code>
-//     .replace(/`([^`]+)`/g, '<code>$1</code>')
-//     // Replace { and }
-//     .replace(/{/g, '&#123;')
-//     .replace(/}/g, '&#125;')
-//     // Escape backslash
-//     .replace(/\\/g, '\\\\')
-//     // Replace " with &quot; UNLESS inside <code>...</code> OR inside an href="...".
-//     // The alternation matches either a whole <code>...</code> block, an href="...",
-//     // or a bare " to replace.
-//     .replace(/(<code>[\s\S]*?<\/code>)|(\bhref="[^"]*")|"/gi, (m, code, href) => {
-//       if (code) return code;          // keep code blocks untouched
-//       if (href) return href;          // keep href="..." quotes untouched
-//       return '&quot;';                // everything else: replace "
-//     });
-// }
-
 export function sanitizeHtml(text) {
   return text
-    // Replace "<" unless it's followed by "a", "/a", "b", "/b", "strong", or "/strong"
-    .replace(/<(?!\/?(?:a|b|strong|code)\b)/gi, '&lt;')
+    // Replace "<" unless it's followed by "a", "/a", "b", "/b", "strong"
+    .replace(/<(?!\/?(?:a|b|strong)\b)/gi, '&lt;')
     // Replace ">" unless it's preceded by "</a", "<a ...>", "</b", "<b ...>", "</strong", or "<strong ...>"
-    .replace(/(?<!<\/?(?:a|b|strong|code)[^>]*)>/gi, '&gt;')
+    .replace(/(?<!<\/?(?:a|b|strong)[^>]*)>/gi, '&gt;')
     // Add quotes around unquoted href values (within <a ...>)
     .replace(/(<a\b[^>]*?)href=([^"' \t\r\n>]+)/gi, '$1href="$2"')
-    // Wrap backticked text with <code>
-    .replace(/`([^`]+)`/g, '<code>$1</code>')
-    // Within code tags, escape markdown special characters
-    .replace(/(<code[^>]*>)([\s\S]*?)(<\/code>)/gi, (match, openTag, content, closeTag) => {
-      // Escape markdown characters inside code tags
-      const escapedContent = content
-        .replace(/\*/g, '&ast;')   // Escape asterisks (for italic/bold)
-        .replace(/_/g, '&lowbar;') // Escape underscores (for italic/bold)
-        .replace(/\[/g, '&#91;')   // Escape brackets (for links)
-        .replace(/\]/g, '&#93;')
-        .replace(/\(/g, '&#40;')   // Escape parentheses (for links)
-        .replace(/\)/g, '&#41;');
-      return openTag + escapedContent + closeTag;
+    // Special handling for code tags - remove them if they contain * or _
+    .replace(/<code>([\s\S]*?)<\/code>/gi, (match, content) => {
+      if (content.includes('*') || content.includes('_')) {
+        // If code block has problematic characters, remove the code tags
+        // and escape the special characters
+        return content
+          .replace(/\*/g, '&ast;')   // Escape asterisks
+          .replace(/_/g, '&lowbar;') // Escape underscores
+          .replace(/\[/g, '&#91;')   // Escape brackets
+          .replace(/\]/g, '&#93;')
+          .replace(/\(/g, '&#40;')   // Escape parentheses
+          .replace(/\)/g, '&#41;');
+      }
+      // Otherwise keep the code tags
+      return match;
+    })
+    // Wrap backticked text with <code> but only if it doesn't contain * or _
+    .replace(/`([^`]+)`/g, (match, content) => {
+      if (content.includes('*') || content.includes('_')) {
+        // If backticked content has problematic characters, don't add code tags
+        return content
+          .replace(/\*/g, '&ast;')
+          .replace(/_/g, '&lowbar;')
+          .replace(/\[/g, '&#91;')
+          .replace(/\]/g, '&#93;')
+          .replace(/\(/g, '&#40;')
+          .replace(/\)/g, '&#41;');
+      }
+      return `<code>${content}</code>`;
     })
     // Replace { and }
     .replace(/{/g, '&#123;')