@excofy/utils 2.5.0 → 2.5.1

package/dist/index.cjs

@@ -36,6 +36,7 @@ __export(index_exports, {
   cryptoUtils: () => cryptoUtils,
   generateCode: () => generateCode,
   htmlEntityDecode: () => htmlEntityDecode,
+  htmlToPlainText: () => sanitizeValue,
   numberUtils: () => number_exports,
   slugUtils: () => slug_exports,
   stringUtils: () => stringUtils
@@ -973,6 +974,7 @@ var divide = (numerator, denominator) => {
   cryptoUtils,
   generateCode,
   htmlEntityDecode,
+  htmlToPlainText,
   numberUtils,
   slugUtils,
   stringUtils

package/dist/index.d.cts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -934,6 +934,7 @@ export {
   cryptoUtils,
   generateCode,
   htmlEntityDecode,
+  sanitizeValue as htmlToPlainText,
   number_exports as numberUtils,
   slug_exports as slugUtils,
   stringUtils

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excofy/utils",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Biblioteca de utilitários para o Excofy",
   "main": "dist/index.js",
   "type": "module",
@@ -32,7 +32,7 @@
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
     "@types/big.js": "^6.2.2",
-    "@types/node": "^24.0.3",
+    "@types/node": "^24.10.13",
     "tsup": "^8.5.0",
     "tsx": "^4.20.4",
     "typescript": "^5.8.3"

package/src/index.ts

@@ -1,5 +1,8 @@
 import { createValidator } from './helpers/validator';
-import { htmlEntityDecode } from './helpers/sanitize';
+import {
+  htmlEntityDecode,
+  sanitizeValue as htmlToPlainText,
+} from './helpers/sanitize';
 import { generateCode } from './helpers/generateCode';
 import { stringUtils } from './helpers/string';
 import { cryptoUtils } from './helpers/crypto';
@@ -9,6 +12,7 @@ import * as numberUtils from './helpers/number';
 export {
   createValidator,
   htmlEntityDecode,
+  htmlToPlainText,
   slugUtils,
   numberUtils,
   stringUtils,

package/tests/helpers/validator.spec.ts

@@ -0,0 +1,75 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { createValidator } from '../../src/helpers/validator';
+
+describe('validator', () => {
+  describe('asNumber', () => {
+    it('deve converter uma string "10" para o número 10', () => {
+      type InputRaw = { limit: string };
+      type InputParsed = { limit: number };
+
+      const v = createValidator<InputRaw, InputParsed>();
+      v.setInputs({ limit: '10' });
+      v.validate('limit')
+        .isRequired('Limite é obrigatório')
+        .type('string', 'Limite deve ser uma string')
+        .asNumber('Limite deve ser um número válido');
+
+      const inputs = v.getSanitizedInputs();
+
+      assert.equal(inputs.limit, 10);
+      assert.equal(typeof inputs.limit, 'number');
+      assert.equal(v.hasErrors(), false);
+    });
+
+    it('deve adicionar erro quando o valor não pode ser convertido para número', () => {
+      type InputRaw = { limit: string };
+      type InputParsed = { limit: number };
+
+      const v = createValidator<InputRaw, InputParsed>();
+      v.setInputs({ limit: 'abc' });
+      v.validate('limit')
+        .isRequired('Limite é obrigatório')
+        .type('string', 'Limite deve ser uma string')
+        .asNumber('Limite deve ser um número válido');
+
+      assert.equal(v.hasErrors(), true);
+      const errors = v.getFlatErrors();
+      assert.equal(errors.limit[0].message, 'Limite deve ser um número válido');
+    });
+
+    it('deve converter um número diretamente', () => {
+      type InputRaw = { limit: number };
+      type InputParsed = { limit: number };
+
+      const v = createValidator<InputRaw, InputParsed>();
+      v.setInputs({ limit: 25 });
+      v.validate('limit')
+        .isRequired('Limite é obrigatório')
+        .type('number', 'Limite deve ser um número')
+        .asNumber('Limite deve ser um número válido');
+
+      const inputs = v.getSanitizedInputs();
+
+      assert.equal(inputs.limit, 25);
+      assert.equal(typeof inputs.limit, 'number');
+      assert.equal(v.hasErrors(), false);
+    });
+
+    it('deve lidar com valores opcionais quando não fornecidos', () => {
+      type InputRaw = { limit?: string };
+      type InputParsed = { limit?: number };
+
+      const v = createValidator<InputRaw, InputParsed>();
+      v.setInputs({});
+      v.validate('limit')
+        .isNotRequired()
+        .type('string', 'Limite deve ser uma string')
+        .asNumber('Limite deve ser um número válido');
+
+      assert.equal(v.hasErrors(), false);
+      const inputs = v.getSanitizedInputs();
+      assert.equal(inputs.limit, undefined);
+    });
+  });
+});

package/tsconfig.json

@@ -11,7 +11,8 @@
     "strict": true,
     "skipLibCheck": true,
     "resolveJsonModule": true,
-    "isolatedModules": true
+    "isolatedModules": true,
+    "types": ["node"]
   },
   "include": ["src", "tests"],
   "exclude": ["dist", "node_modules", "**/*.test.ts"]