@excofy/utils 2.5.1 → 2.6.0

package/dist/index.cjs

@@ -36,7 +36,7 @@ __export(index_exports, {
   cryptoUtils: () => cryptoUtils,
   generateCode: () => generateCode,
   htmlEntityDecode: () => htmlEntityDecode,
-  htmlToPlainText: () => sanitizeValue,
+  htmlToPlainText: () => htmlToPlainText,
   numberUtils: () => number_exports,
   slugUtils: () => slug_exports,
   stringUtils: () => stringUtils
@@ -164,6 +164,14 @@ function htmlEntityDecode(str = "") {
     (_, code) => String.fromCharCode(Number.parseInt(code, 16))
   ).replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">");
 }
+function htmlToPlainText(html) {
+  if (!html || typeof html !== "string" || html.length === 0) {
+    return "";
+  }
+  const decodedHtml = htmlEntityDecode(html);
+  const plainText = decodedHtml.replace(/<br\s*\/?>/gi, "\n").replace(/<\/p>/gi, "\n").replace(/<\/li>/gi, "\n").replace(/<li>/gi, "\u2022 ").replace(/<\/?[^>]+(>|$)/g, "").replace(/\n{2,}/g, "\n").trim();
+  return plainText;
+}
 
 // src/helpers/video.ts
 var video = {

package/dist/index.d.cts

@@ -6,8 +6,8 @@ type AllowedTag = Tag | {
     tag: Tag;
     attributes?: Attributes[];
 };
-declare function sanitizeValue(value: string, allowedTags?: AllowedTag[]): string;
 declare function htmlEntityDecode(str?: string): string;
+declare function htmlToPlainText(html: string): string;
 
 type TMessage = {
     message: string;
@@ -242,4 +242,4 @@ declare class ExpiredTokenError extends CryptoError {
     constructor(message?: string);
 }
 
-export { ExpiredTokenError, InvalidTokenError, createValidator, cryptoUtils, generateCode, htmlEntityDecode, sanitizeValue as htmlToPlainText, number as numberUtils, slug as slugUtils, stringUtils };
+export { ExpiredTokenError, InvalidTokenError, createValidator, cryptoUtils, generateCode, htmlEntityDecode, htmlToPlainText, number as numberUtils, slug as slugUtils, stringUtils };

package/dist/index.d.ts

@@ -6,8 +6,8 @@ type AllowedTag = Tag | {
     tag: Tag;
     attributes?: Attributes[];
 };
-declare function sanitizeValue(value: string, allowedTags?: AllowedTag[]): string;
 declare function htmlEntityDecode(str?: string): string;
+declare function htmlToPlainText(html: string): string;
 
 type TMessage = {
     message: string;
@@ -242,4 +242,4 @@ declare class ExpiredTokenError extends CryptoError {
     constructor(message?: string);
 }
 
-export { ExpiredTokenError, InvalidTokenError, createValidator, cryptoUtils, generateCode, htmlEntityDecode, sanitizeValue as htmlToPlainText, number as numberUtils, slug as slugUtils, stringUtils };
+export { ExpiredTokenError, InvalidTokenError, createValidator, cryptoUtils, generateCode, htmlEntityDecode, htmlToPlainText, number as numberUtils, slug as slugUtils, stringUtils };

package/dist/index.js

@@ -125,6 +125,14 @@ function htmlEntityDecode(str = "") {
     (_, code) => String.fromCharCode(Number.parseInt(code, 16))
   ).replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">");
 }
+function htmlToPlainText(html) {
+  if (!html || typeof html !== "string" || html.length === 0) {
+    return "";
+  }
+  const decodedHtml = htmlEntityDecode(html);
+  const plainText = decodedHtml.replace(/<br\s*\/?>/gi, "\n").replace(/<\/p>/gi, "\n").replace(/<\/li>/gi, "\n").replace(/<li>/gi, "\u2022 ").replace(/<\/?[^>]+(>|$)/g, "").replace(/\n{2,}/g, "\n").trim();
+  return plainText;
+}
 
 // src/helpers/video.ts
 var video = {
@@ -934,7 +942,7 @@ export {
   cryptoUtils,
   generateCode,
   htmlEntityDecode,
-  sanitizeValue as htmlToPlainText,
+  htmlToPlainText,
   number_exports as numberUtils,
   slug_exports as slugUtils,
   stringUtils

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excofy/utils",
-  "version": "2.5.1",
+  "version": "2.6.0",
   "description": "Biblioteca de utilitários para o Excofy",
   "main": "dist/index.js",
   "type": "module",
@@ -16,7 +16,7 @@
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build",
     "deploy": "act",
-    "test": "tsx --test 'tests/helpers/crypto.spec.ts' --testTimeout=10000"
+    "test": "tsx --test 'tests/helpers/htmlToPlainText.spec.ts' --testTimeout=10000"
   },
   "repository": {
     "type": "git",

package/src/helpers/sanitize.ts

@@ -69,7 +69,7 @@ const allAttributes: Attributes[] = [
 
 export function sanitizeValue(
   value: string,
-  allowedTags?: AllowedTag[]
+  allowedTags?: AllowedTag[],
 ): string {
   let whiteList: IWhiteList = {};
 
@@ -109,7 +109,7 @@ export function htmlEntityDecode(str = ''): string {
   return str
     .replace(/&#(\d+);/g, (_, code) => String.fromCharCode(code))
     .replace(/&#x([0-9a-f]+);/gi, (_, code) =>
-      String.fromCharCode(Number.parseInt(code, 16))
+      String.fromCharCode(Number.parseInt(code, 16)),
     )
     .replace(/&/g, '&')
     .replace(/"/g, '"')
@@ -117,3 +117,22 @@ export function htmlEntityDecode(str = ''): string {
     .replace(/&lt;/g, '<')
     .replace(/&gt;/g, '>');
 }
+
+export function htmlToPlainText(html: string): string {
+  if (!html || typeof html !== 'string' || html.length === 0) {
+    return '';
+  }
+
+  const decodedHtml = htmlEntityDecode(html);
+
+  const plainText = decodedHtml
+    .replace(/<br\s*\/?>/gi, '\n')
+    .replace(/<\/p>/gi, '\n')
+    .replace(/<\/li>/gi, '\n')
+    .replace(/<li>/gi, '• ')
+    .replace(/<\/?[^>]+(>|$)/g, '') // Remove outras tags
+    .replace(/\n{2,}/g, '\n') // Remove quebras de linha duplicadas
+    .trim();
+
+  return plainText;
+}

package/src/index.ts

@@ -1,8 +1,5 @@
 import { createValidator } from './helpers/validator';
-import {
-  htmlEntityDecode,
-  sanitizeValue as htmlToPlainText,
-} from './helpers/sanitize';
+import { htmlEntityDecode, htmlToPlainText } from './helpers/sanitize';
 import { generateCode } from './helpers/generateCode';
 import { stringUtils } from './helpers/string';
 import { cryptoUtils } from './helpers/crypto';

package/tests/helpers/htmlToPlainText.spec.ts

@@ -0,0 +1,33 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { htmlToPlainText } from '../../src/helpers/sanitize';
+
+test('Converte <br> em quebra de linha', () => {
+  const html = 'Linha 1<br>Linha 2';
+  const expected = 'Linha 1\nLinha 2';
+  assert.equal(htmlToPlainText(html), expected);
+});
+
+test('Remove todas as tags HTML exceto marcadores de lista', () => {
+  const html = '<ul><li>Item 1</li><li>Item 2</li></ul>';
+  const expected = '• Item 1\n• Item 2';
+  assert.equal(htmlToPlainText(html), expected);
+});
+
+test('Converte <p> em quebra de linha', () => {
+  const html = '<p>Parágrafo 1</p><p>Parágrafo 2</p>';
+  const expected = 'Parágrafo 1\nParágrafo 2';
+  assert.equal(htmlToPlainText(html), expected);
+});
+
+test('Decodifica entidades HTML', () => {
+  const html = 'Tom &amp; Jerry &lt;3';
+  const expected = 'Tom & Jerry';
+  assert.equal(htmlToPlainText(html), expected);
+});
+
+test('Remove quebras de linha duplicadas', () => {
+  const html = 'Linha 1<br><br>Linha 2';
+  const expected = 'Linha 1\nLinha 2';
+  assert.equal(htmlToPlainText(html), expected);
+});