@ecency/render-helper 2.4.14 → 2.4.16

package/dist/browser/index.d.ts

@@ -9,7 +9,27 @@ interface Entry {
     json_metadata?: any;
 }
 
-declare function markdown2Html(obj: Entry | string, forApp?: boolean, webp?: boolean, parentDomain?: string): string;
+/**
+ * SEO context for controlling rel attributes on external links in user-generated content.
+ *
+ * By default, all external links get rel="nofollow ugc noopener" to prevent link spam.
+ * High-quality content (high author reputation + meaningful post rewards) earns followed links.
+ */
+interface SeoContext {
+    /** Human-readable author reputation score (after accountReputation() conversion) */
+    authorReputation?: number;
+    /** Total post payout in USD */
+    postPayout?: number;
+}
+
+/**
+ * @param obj - Entry object or raw markdown string
+ * @param forApp - Whether rendering for app context
+ * @param _webp - @deprecated Ignored. Format is now handled server-side via Accept header content negotiation.
+ * @param parentDomain - Parent domain for iframe embed parameters
+ * @param seoContext - Optional SEO context for structured data
+ */
+declare function markdown2Html(obj: Entry | string, forApp?: boolean, _webp?: boolean, parentDomain?: string, seoContext?: SeoContext): string;
 
 declare function catchPostImage(obj: Entry | string, width?: number, height?: number, format?: string): string | null;
 
@@ -24,7 +44,10 @@ declare function catchPostImage(obj: Entry | string, width?: number, height?: nu
 declare function getPostBodySummary(obj: Entry | string, length?: number, platform?: 'ios' | 'android' | 'web'): string;
 
 declare function setProxyBase(p: string): void;
-declare function proxifyImageSrc(url?: string, width?: number, height?: number, format?: string): string;
+/**
+ * @param _format - @deprecated Ignored. Always uses 'match' — format is handled server-side via Accept header.
+ */
+declare function proxifyImageSrc(url?: string, width?: number, height?: number, _format?: string): string;
 
 declare function setCacheSize(size: number): void;
 
@@ -32,4 +55,4 @@ declare const SECTION_LIST: string[];
 
 declare function isValidPermlink(permlink: string): boolean;
 
-export { type Entry, SECTION_LIST, catchPostImage, isValidPermlink, getPostBodySummary as postBodySummary, proxifyImageSrc, markdown2Html as renderPostBody, setCacheSize, setProxyBase };
+export { type Entry, SECTION_LIST, type SeoContext, catchPostImage, isValidPermlink, getPostBodySummary as postBodySummary, proxifyImageSrc, markdown2Html as renderPostBody, setCacheSize, setProxyBase };

package/dist/browser/index.js

@@ -78,8 +78,8 @@ var LBRY_REGEX = /^(https?:)?\/\/lbry.tv\/\$\/embed\/[^?#]+(?:$|[?#])/i;
 var ODYSEE_REGEX = /^(https?:)?\/\/odysee\.com\/(?:\$|%24)\/embed\/[^/?#]+(?:$|[?#])/i;
 var SKATEHIVE_IPFS_REGEX = /^https?:\/\/ipfs\.skatehive\.app\/ipfs\/([^/?#]+)/i;
 var ARCH_REGEX = /^(https?:)?\/\/archive.org\/embed\/[^/?#]+(?:$|[?#])/i;
-var SPEAK_REGEX = /(?:https?:\/\/(?:(?:play\.)?3speak.([a-z]+)\/watch\?v=)|(?:(?:play\.)?3speak.([a-z]+)\/embed\?v=))([A-Za-z0-9\_\-\.\/]+)(&.*)?/i;
-var SPEAK_EMBED_REGEX = /^(https?:)?\/\/(?:play\.)?3speak.([a-z]+)\/embed\?[^/]+$/i;
+var SPEAK_REGEX = /(?:https?:\/\/(?:(?:play\.)?3speak\.([a-z]+)\/watch\?v=)|(?:(?:play\.)?3speak\.([a-z]+)\/embed\?v=))([A-Za-z0-9_\-\.\/]+)(&.*)?/i;
+var SPEAK_EMBED_REGEX = /^(https?:)?\/\/(?:play\.)?3speak\.([a-z]+)\/(?:embed|watch)\?.+$/i;
 var TWITTER_REGEX = /(?:https?:\/\/(?:(?:twitter\.com\/(.*?)\/status\/(.*))))/gi;
 var SPOTIFY_REGEX = /^https:\/\/open\.spotify\.com\/playlist\/(.*)?$/gi;
 var RUMBLE_REGEX = /^https:\/\/rumble.com\/embed\/([a-zA-Z0-9-]+)\/\?pub=\w+/;
@@ -284,15 +284,13 @@ function sanitizeHtml(html) {
   });
 }
 var proxyBase = "https://images.ecency.com";
-var fileExtension = true;
 function setProxyBase(p2) {
   proxyBase = p2;
-  fileExtension = proxyBase == "https://images.ecency.com";
 }
 function extractPHash(url) {
   if (url.startsWith(`${proxyBase}/p/`)) {
     const [hash] = url.split("/p/")[1].split("?");
-    return hash.replace(/.webp/, "").replace(/.png/, "");
+    return hash.replace(/\.(webp|png)$/, "");
   }
   return null;
 }
@@ -307,7 +305,7 @@ function getLatestUrl(str) {
   const [last] = [...str.replace(/https?:\/\//g, "\n$&").trim().split("\n")].reverse();
   return last;
 }
-function proxifyImageSrc(url, width = 0, height = 0, format = "match") {
+function proxifyImageSrc(url, width = 0, height = 0, _format = "match") {
   if (!url || typeof url !== "string" || !isValidUrl(url)) {
     return "";
   }
@@ -320,7 +318,7 @@ function proxifyImageSrc(url, width = 0, height = 0, format = "match") {
   const realUrl = getLatestUrl(url);
   const pHash = extractPHash(realUrl);
   const options = {
-    format,
+    format: "match",
     mode: "fit"
   };
   if (width > 0) {
@@ -331,31 +329,29 @@ function proxifyImageSrc(url, width = 0, height = 0, format = "match") {
   }
   const qs = querystring.stringify(options);
   if (pHash) {
-    if (fileExtension) {
-      return `${proxyBase}/p/${pHash}${format === "webp" ? ".webp" : ".png"}?${qs}`;
-    } else {
-      return `${proxyBase}/p/${pHash}?${qs}`;
-    }
+    return `${proxyBase}/p/${pHash}?${qs}`;
   }
   const b58url = multihash.toB58String(Buffer.from(realUrl.toString()));
-  return `${proxyBase}/p/${b58url}${fileExtension ? format === "webp" ? ".webp" : ".png" : ""}?${qs}`;
+  return `${proxyBase}/p/${b58url}?${qs}`;
 }
 
 // src/methods/img.method.ts
-function img(el, webp, state) {
-  let src = el.getAttribute("src") || "";
+function img(el, state) {
+  const src = el.getAttribute("src") || "";
   const decodedSrc = decodeURIComponent(
     src.replace(/&#(\d+);/g, (_, dec) => String.fromCharCode(dec)).replace(/&#x([0-9a-f]+);/gi, (_, hex) => String.fromCharCode(parseInt(hex, 16)))
   ).trim();
+  ["onerror", "dynsrc", "lowsrc", "width", "height"].forEach((attr) => el.removeAttribute(attr));
   const isInvalid = !src || decodedSrc.startsWith("javascript") || decodedSrc.startsWith("vbscript") || decodedSrc === "x";
   if (isInvalid) {
-    src = "";
+    el.removeAttribute("src");
+    return;
   }
   const isRelative = !/^https?:\/\//i.test(decodedSrc) && !decodedSrc.startsWith("/");
   if (isRelative) {
-    src = "";
+    el.removeAttribute("src");
+    return;
   }
-  ["onerror", "dynsrc", "lowsrc", "width", "height"].forEach((attr) => el.removeAttribute(attr));
   el.setAttribute("itemprop", "image");
   const isLCP = state && !state.firstImageFound;
   if (isLCP) {
@@ -370,14 +366,17 @@ function img(el, webp, state) {
   const shouldReplace = !cls.includes("no-replace");
   const hasAlreadyProxied = src.startsWith("https://images.ecency.com");
   if (shouldReplace && !hasAlreadyProxied) {
-    const proxified = proxifyImageSrc(src, 0, 0, webp ? "webp" : "match");
-    el.setAttribute("src", proxified);
+    const proxified = proxifyImageSrc(decodedSrc);
+    if (proxified) {
+      el.setAttribute("src", proxified);
+    }
   }
 }
-function createImageHTML(src, isLCP, webp) {
+function createImageHTML(src, isLCP) {
+  const proxified = proxifyImageSrc(src);
+  if (!proxified) return "";
   const loading = isLCP ? "eager" : "lazy";
   const fetch = isLCP ? 'fetchpriority="high"' : 'decoding="async"';
-  const proxified = proxifyImageSrc(src, 0, 0, webp ? "webp" : "match");
   return `<img
     class="markdown-img-link"
     src="${proxified}"
@@ -388,6 +387,14 @@ function createImageHTML(src, isLCP, webp) {
 }
 
 // src/methods/a.method.ts
+var NOFOLLOW_REPUTATION_THRESHOLD = 40;
+var FOLLOW_PAYOUT_THRESHOLD = 5;
+function getExternalLinkRel(seoContext) {
+  if (seoContext?.authorReputation !== void 0 && seoContext?.postPayout !== void 0 && seoContext.authorReputation >= NOFOLLOW_REPUTATION_THRESHOLD && seoContext.postPayout > FOLLOW_PAYOUT_THRESHOLD) {
+    return "noopener";
+  }
+  return "nofollow ugc noopener";
+}
 var normalizeValue = (value) => value ? value.trim() : "";
 var matchesHref = (href, value) => {
   const normalizedHref = normalizeValue(href);
@@ -421,7 +428,7 @@ var addLineBreakBeforePostLink = (el, forApp, isInline) => {
     el.parentNode.insertBefore(br, el);
   }
 };
-function a(el, forApp, webp, parentDomain = "ecency.com") {
+function a(el, forApp, parentDomain = "ecency.com", seoContext) {
   if (!el || !el.parentNode) {
     return;
   }
@@ -439,7 +446,7 @@ function a(el, forApp, webp, parentDomain = "ecency.com") {
   }
   if (href.match(IMG_REGEX) && href.trim().replace(/&amp;/g, "&") === getSerializedInnerHTML(el).trim().replace(/&amp;/g, "&")) {
     const isLCP = false;
-    const imgHTML = createImageHTML(href, isLCP, webp);
+    const imgHTML = createImageHTML(href, isLCP);
     const doc = DOMParser.parseFromString(imgHTML, "text/html");
     const replaceNode = doc.body?.firstChild || doc.firstChild;
     if (replaceNode) {
@@ -761,7 +768,7 @@ function a(el, forApp, webp, parentDomain = "ecency.com") {
     el.setAttribute("class", "markdown-video-link markdown-video-link-youtube");
     el.removeAttribute("href");
     const vid = match[1];
-    const thumbnail = proxifyImageSrc(`https://img.youtube.com/vi/${vid.split("?")[0]}/hqdefault.jpg`, 0, 0, webp ? "webp" : "match");
+    const thumbnail = proxifyImageSrc(`https://img.youtube.com/vi/${vid.split("?")[0]}/hqdefault.jpg`, 0, 0, "match");
     const embedSrc = `https://www.youtube.com/embed/${vid}?autoplay=1`;
     el.textContent = "";
     el.setAttribute("data-embed-src", embedSrc);
@@ -857,7 +864,7 @@ function a(el, forApp, webp, parentDomain = "ecency.com") {
       if (imgEls.length === 1) {
         const src = imgEls[0].getAttribute("src");
         if (src) {
-          const thumbnail = proxifyImageSrc(src.replace(/\s+/g, ""), 0, 0, webp ? "webp" : "match");
+          const thumbnail = proxifyImageSrc(src.replace(/\s+/g, ""), 0, 0, "match");
           const thumbImg = el.ownerDocument.createElement("img");
           thumbImg.setAttribute("class", "no-replace video-thumbnail");
           thumbImg.setAttribute("itemprop", "thumbnailUrl");
@@ -892,7 +899,7 @@ function a(el, forApp, webp, parentDomain = "ecency.com") {
     const imgEls2 = el.getElementsByTagName("img");
     if (imgEls2.length === 1 || el.textContent.trim() === href) {
       if ((match[1] || match[2]) && match[3]) {
-        const videoHref = `https://play.3speak.tv/watch?v=${match[3]}&mode=iframe`;
+        const videoHref = `https://play.3speak.tv/embed?v=${match[3]}&mode=iframe`;
         el.setAttribute("class", "markdown-video-link markdown-video-link-speak");
         el.removeAttribute("href");
         el.setAttribute("data-embed-src", videoHref);
@@ -902,7 +909,7 @@ function a(el, forApp, webp, parentDomain = "ecency.com") {
         if (imgEls2.length === 1) {
           const src = imgEls2[0].getAttribute("src");
           if (src) {
-            const thumbnail = proxifyImageSrc(src.replace(/\s+/g, ""), 0, 0, webp ? "webp" : "match");
+            const thumbnail = proxifyImageSrc(src.replace(/\s+/g, ""), 0, 0, "match");
             const thumbImg = el.ownerDocument.createElement("img");
             thumbImg.setAttribute("class", "no-replace video-thumbnail");
             thumbImg.setAttribute("itemprop", "thumbnailUrl");
@@ -981,7 +988,7 @@ function a(el, forApp, webp, parentDomain = "ecency.com") {
       el.setAttribute("class", "markdown-internal-link");
     } else {
       el.setAttribute("target", "_blank");
-      el.setAttribute("rel", "noopener");
+      el.setAttribute("rel", getExternalLinkRel(seoContext));
     }
     el.setAttribute("href", href);
   }
@@ -1025,7 +1032,8 @@ function iframe(el, parentDomain = "ecency.com") {
     return;
   }
   if (src.match(SPEAK_EMBED_REGEX)) {
-    let normalizedSrc = src.replace(/3speak\.[a-z]+/i, "play.3speak.tv");
+    let normalizedSrc = src.replace(/(?:play\.)?3speak\.[a-z]+/i, "play.3speak.tv");
+    normalizedSrc = normalizedSrc.replace(/\/watch\?/, "/embed?");
     const hasMode = /[?&]mode=/.test(normalizedSrc);
     if (!hasMode) {
       normalizedSrc = `${normalizedSrc}&mode=iframe`;
@@ -1033,6 +1041,7 @@ function iframe(el, parentDomain = "ecency.com") {
     const hasAutoplay = /[?&]autoplay=/.test(normalizedSrc);
     const s = hasAutoplay ? normalizedSrc : `${normalizedSrc}&autoplay=true`;
     el.setAttribute("src", s);
+    el.setAttribute("class", "speak-iframe");
     return;
   }
   if (src.match(SPOTIFY_EMBED_REGEX)) {
@@ -1141,7 +1150,7 @@ function p(el) {
 }
 
 // src/methods/linkify.method.ts
-function linkify(content, forApp, webp) {
+function linkify(content, forApp) {
   content = content.replace(/(^|\s|>)(#[-a-z\d]+)/gi, (tag) => {
     if (/#[\d]+$/.test(tag)) return tag;
     const preceding = /^\s|>/.test(tag) ? tag[0] : "";
@@ -1183,21 +1192,21 @@ function linkify(content, forApp, webp) {
   content = content.replace(IMG_REGEX, (imglink) => {
     const isLCP = !firstImageUsed;
     firstImageUsed = true;
-    return createImageHTML(imglink, isLCP, webp);
+    return createImageHTML(imglink, isLCP);
   });
   return content;
 }
 
 // src/methods/text.method.ts
-function text(node, forApp, webp) {
+function text(node, forApp) {
   if (!node || !node.parentNode) {
     return;
   }
-  if (node.parentNode && ["a", "code"].includes(node.parentNode.nodeName.toLowerCase())) {
+  if (["a", "code"].includes(node.parentNode.nodeName.toLowerCase())) {
     return;
   }
   const nodeValue = node.nodeValue || "";
-  const linkified = linkify(nodeValue, forApp, webp);
+  const linkified = linkify(nodeValue, forApp);
   if (linkified !== nodeValue) {
     const doc = DOMParser.parseFromString(
       `<span class="wr">${linkified}</span>`,
@@ -1212,7 +1221,7 @@ function text(node, forApp, webp) {
   }
   if (nodeValue.match(IMG_REGEX)) {
     const isLCP = false;
-    const imageHTML = createImageHTML(nodeValue, isLCP, webp);
+    const imageHTML = createImageHTML(nodeValue, isLCP);
     const doc = DOMParser.parseFromString(imageHTML, "text/html");
     const replaceNode = doc.body?.firstChild || doc.firstChild;
     if (replaceNode) {
@@ -1224,7 +1233,7 @@ function text(node, forApp, webp) {
     const e = YOUTUBE_REGEX.exec(nodeValue);
     if (e && e[1]) {
       const vid = e[1];
-      const thumbnail = proxifyImageSrc(`https://img.youtube.com/vi/${vid.split("?")[0]}/hqdefault.jpg`, 0, 0, webp ? "webp" : "match");
+      const thumbnail = proxifyImageSrc(`https://img.youtube.com/vi/${vid.split("?")[0]}/hqdefault.jpg`, 0, 0, "match");
       const embedSrc = `https://www.youtube.com/embed/${vid}?autoplay=1`;
       const startTime = extractYtStartTime(nodeValue);
       const container = node.ownerDocument.createElement("p");
@@ -1270,7 +1279,7 @@ function text(node, forApp, webp) {
 }
 
 // src/methods/traverse.method.ts
-function traverse(node, forApp, depth = 0, webp = false, state = { firstImageFound: false }, parentDomain = "ecency.com") {
+function traverse(node, forApp, depth = 0, state = { firstImageFound: false }, parentDomain = "ecency.com", seoContext) {
   if (!node || !node.childNodes) {
     return;
   }
@@ -1278,23 +1287,23 @@ function traverse(node, forApp, depth = 0, webp = false, state = { firstImageFou
     const child = node.childNodes[i];
     if (!child) return;
     if (child.nodeName.toLowerCase() === "a") {
-      a(child, forApp, webp, parentDomain);
+      a(child, forApp, parentDomain, seoContext);
     }
     if (child.nodeName.toLowerCase() === "iframe") {
       iframe(child, parentDomain);
     }
     if (child.nodeName === "#text") {
-      text(child, forApp, webp);
+      text(child, forApp);
     }
     if (child.nodeName.toLowerCase() === "img") {
-      img(child, webp, state);
+      img(child, state);
     }
     if (child.nodeName.toLowerCase() === "p") {
       p(child);
     }
     const currentChild = node.childNodes[i];
     if (currentChild) {
-      traverse(currentChild, forApp, depth + 1, webp, state, parentDomain);
+      traverse(currentChild, forApp, depth + 1, state, parentDomain, seoContext);
     }
   });
 }
@@ -1345,7 +1354,7 @@ function fixBlockLevelTagsInParagraphs(html) {
   html = html.replace(/<p><br>\s*<\/p>/g, "");
   return html;
 }
-function markdownToHTML(input, forApp, webp, parentDomain = "ecency.com") {
+function markdownToHTML(input, forApp, parentDomain = "ecency.com", seoContext) {
   input = input.replace(new RegExp("https://leofinance.io/threads/view/", "g"), "/@");
   input = input.replace(new RegExp("https://leofinance.io/posts/", "g"), "/@");
   input = input.replace(new RegExp("https://leofinance.io/threads/", "g"), "/@");
@@ -1405,7 +1414,7 @@ function markdownToHTML(input, forApp, webp, parentDomain = "ecency.com") {
     output = md.render(input);
     output = fixBlockLevelTagsInParagraphs(output);
     const doc = DOMParser.parseFromString(`<body id="root">${removeDuplicateAttributes(output)}</body>`, "text/html");
-    traverse(doc, forApp, 0, webp, { firstImageFound: false }, parentDomain);
+    traverse(doc, forApp, 0, { firstImageFound: false }, parentDomain, seoContext);
     output = serializer.serializeToString(doc);
   } catch (error) {
     try {
@@ -1418,7 +1427,7 @@ function markdownToHTML(input, forApp, webp, parentDomain = "ecency.com") {
       });
       const repairedHtml = domSerializer(dom.children);
       const doc = DOMParser.parseFromString(`<body id="root">${removeDuplicateAttributes(repairedHtml)}</body>`, "text/html");
-      traverse(doc, forApp, 0, webp, { firstImageFound: false }, parentDomain);
+      traverse(doc, forApp, 0, { firstImageFound: false }, parentDomain, seoContext);
       output = serializer.serializeToString(doc);
     } catch (fallbackError) {
       const escapedContent = he2.encode(output || md.render(input));
@@ -1446,18 +1455,18 @@ function cacheSet(key, value) {
 }
 
 // src/markdown-2-html.ts
-function markdown2Html(obj, forApp = true, webp = false, parentDomain = "ecency.com") {
+function markdown2Html(obj, forApp = true, _webp = false, parentDomain = "ecency.com", seoContext) {
   if (typeof obj === "string") {
     const cleanedStr = cleanReply(obj);
-    return markdownToHTML(cleanedStr, forApp, webp, parentDomain);
+    return markdownToHTML(cleanedStr, forApp, parentDomain, seoContext);
   }
-  const key = `${makeEntryCacheKey(obj)}-md${webp ? "-webp" : ""}-${forApp ? "app" : "site"}-${parentDomain}`;
+  const key = `${makeEntryCacheKey(obj)}-md-${forApp ? "app" : "site"}-${parentDomain}${seoContext ? `-seo${seoContext.authorReputation ?? ""}-${seoContext.postPayout ?? ""}` : ""}`;
   const item = cacheGet(key);
   if (item) {
     return item;
   }
   const cleanBody = cleanReply(obj.body);
-  const res = markdownToHTML(cleanBody, forApp, webp, parentDomain);
+  const res = markdownToHTML(cleanBody, forApp, parentDomain, seoContext);
   cacheSet(key, res);
   return res;
 }