@excofy/utils 2.1.2 → 2.2.0

package/dist/index.cjs

@@ -96,6 +96,30 @@ function isValidCNPJ(cnpj) {
   return digit1 === digits[1];
 }
 
+// src/helpers/file.ts
+var fileUtils = {
+  base64ToFile: (base64, filename) => {
+    if (!base64 || base64 === "") {
+      return null;
+    }
+    const arr = base64.split(",");
+    if (arr.length !== 2) {
+      return null;
+    }
+    const mime = arr[0].match(/:(.*?);/)?.[1];
+    if (!mime) {
+      return null;
+    }
+    const bstr = atob(arr[1]);
+    let n = bstr.length;
+    const u8arr = new Uint8Array(n);
+    while (n--) {
+      u8arr[n] = bstr.charCodeAt(n);
+    }
+    return new File([u8arr], filename, { type: mime });
+  }
+};
+
 // src/helpers/sanitize.ts
 var import_xss = require("xss");
 var allTags = [
@@ -234,6 +258,8 @@ function createValidator() {
         isValidType = typeof value === "object" && value !== null && !Array.isArray(value);
       } else if (type === "file") {
         isValidType = value instanceof File;
+      } else if (type === "base64") {
+        isValidType = typeof value === "string" && !!value.match(/^data:([A-Za-z-+\/]+);base64,([A-Za-z0-9+/=]+)$/);
       } else if (type === "date") {
         isValidType = typeof value === "string" && !Number.isNaN(new Date(value).getTime());
       } else {
@@ -592,6 +618,22 @@ function createValidator() {
         current.inputs[current.field] = arr;
       }
       return validator;
+    },
+    asFileFromBase64(message, filename) {
+      if (shouldSkipValidation()) return validator;
+      const value = current.value;
+      if (typeof value !== "string") {
+        current.pushError(message);
+        return validator;
+      }
+      if (!value.match(/^data:([A-Za-z-+\/]+);base64,([A-Za-z0-9+/=]+)$/)) {
+        current.pushError(message);
+        return validator;
+      }
+      const file = fileUtils.base64ToFile(value, filename);
+      current.value = file;
+      current.inputs[current.field] = file;
+      return validator;
     }
   };
   return {

package/dist/index.d.cts

@@ -13,7 +13,7 @@ type TMessage = {
 };
 type TValue = string | number | boolean | File | object | null | undefined;
 type TInputValue = TValue;
-type TTypes = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'file' | 'date';
+type TTypes = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'file' | 'base64' | 'date';
 interface IInputErrors {
     [key: string]: TMessage[] | IInputErrors[];
 }
@@ -48,6 +48,7 @@ interface ValidatorField {
     asNumber(message: string): ValidatorField;
     asBoolean(message: string): ValidatorField;
     asStringArray(message: string): ValidatorField;
+    asFileFromBase64(message: string, filename: string): ValidatorField;
 }
 /**
  * Cria um validador de inputs com suporte a validações encadeadas, transformação e sanitização.

package/dist/index.d.ts

@@ -13,7 +13,7 @@ type TMessage = {
 };
 type TValue = string | number | boolean | File | object | null | undefined;
 type TInputValue = TValue;
-type TTypes = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'file' | 'date';
+type TTypes = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'file' | 'base64' | 'date';
 interface IInputErrors {
     [key: string]: TMessage[] | IInputErrors[];
 }
@@ -48,6 +48,7 @@ interface ValidatorField {
     asNumber(message: string): ValidatorField;
     asBoolean(message: string): ValidatorField;
     asStringArray(message: string): ValidatorField;
+    asFileFromBase64(message: string, filename: string): ValidatorField;
 }
 /**
  * Cria um validador de inputs com suporte a validações encadeadas, transformação e sanitização.

package/dist/index.js

@@ -58,6 +58,30 @@ function isValidCNPJ(cnpj) {
   return digit1 === digits[1];
 }
 
+// src/helpers/file.ts
+var fileUtils = {
+  base64ToFile: (base64, filename) => {
+    if (!base64 || base64 === "") {
+      return null;
+    }
+    const arr = base64.split(",");
+    if (arr.length !== 2) {
+      return null;
+    }
+    const mime = arr[0].match(/:(.*?);/)?.[1];
+    if (!mime) {
+      return null;
+    }
+    const bstr = atob(arr[1]);
+    let n = bstr.length;
+    const u8arr = new Uint8Array(n);
+    while (n--) {
+      u8arr[n] = bstr.charCodeAt(n);
+    }
+    return new File([u8arr], filename, { type: mime });
+  }
+};
+
 // src/helpers/sanitize.ts
 import { FilterXSS } from "xss";
 var allTags = [
@@ -196,6 +220,8 @@ function createValidator() {
         isValidType = typeof value === "object" && value !== null && !Array.isArray(value);
       } else if (type === "file") {
         isValidType = value instanceof File;
+      } else if (type === "base64") {
+        isValidType = typeof value === "string" && !!value.match(/^data:([A-Za-z-+\/]+);base64,([A-Za-z0-9+/=]+)$/);
       } else if (type === "date") {
         isValidType = typeof value === "string" && !Number.isNaN(new Date(value).getTime());
       } else {
@@ -554,6 +580,22 @@ function createValidator() {
         current.inputs[current.field] = arr;
       }
       return validator;
+    },
+    asFileFromBase64(message, filename) {
+      if (shouldSkipValidation()) return validator;
+      const value = current.value;
+      if (typeof value !== "string") {
+        current.pushError(message);
+        return validator;
+      }
+      if (!value.match(/^data:([A-Za-z-+\/]+);base64,([A-Za-z0-9+/=]+)$/)) {
+        current.pushError(message);
+        return validator;
+      }
+      const file = fileUtils.base64ToFile(value, filename);
+      current.value = file;
+      current.inputs[current.field] = file;
+      return validator;
     }
   };
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excofy/utils",
-  "version": "2.1.2",
+  "version": "2.2.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/**/*.spec.ts' --testTimeout=10000"
+    "test": "tsx --test 'tests/helpers/crypto.spec.ts' --testTimeout=10000"
   },
   "repository": {
     "type": "git",

package/src/helpers/crypto.ts

@@ -153,7 +153,7 @@ export async function verifyDeterministicHash(
 export const cryptoUtils: ICrypto = {
   uuidV4: (): string => crypto.randomUUID(),
 
-  hash: async (password: string, salt: number = 10): Promise<string> => {
+  hash: async (password: string, salt = 10): Promise<string> => {
     const importedKey = await crypto.subtle.importKey(
       'raw',
       encoder.encode(password),

package/src/helpers/file.ts

@@ -0,0 +1,28 @@
+export const fileUtils = {
+  base64ToFile: (base64: string | null, filename: string): File | null => {
+    if (!base64 || base64 === '') {
+      return null;
+    }
+
+    const arr = base64.split(',');
+    if (arr.length !== 2) {
+      return null;
+    }
+
+    const mime = arr[0].match(/:(.*?);/)?.[1];
+
+    if (!mime) {
+      return null;
+    }
+
+    const bstr = atob(arr[1]);
+    let n = bstr.length;
+    const u8arr = new Uint8Array(n);
+
+    while (n--) {
+      u8arr[n] = bstr.charCodeAt(n);
+    }
+
+    return new File([u8arr], filename, { type: mime });
+  },
+};

package/src/helpers/validator.ts

@@ -1,4 +1,5 @@
 import { isValidCNPJ, isValidCPF } from './document';
+import { fileUtils } from './file';
 import { sanitizeValue, type AllowedTag } from './sanitize';
 import { video } from './video';
 
@@ -12,6 +13,7 @@ type TTypes =
   | 'object'
   | 'array'
   | 'file'
+  | 'base64'
   | 'date';
 
 interface IInputErrors {
@@ -56,6 +58,7 @@ interface ValidatorField {
   asNumber(message: string): ValidatorField;
   asBoolean(message: string): ValidatorField;
   asStringArray(message: string): ValidatorField;
+  asFileFromBase64(message: string, filename: string): ValidatorField;
 }
 
 /**
@@ -139,6 +142,10 @@ export function createValidator<
           typeof value === 'object' && value !== null && !Array.isArray(value);
       } else if (type === 'file') {
         isValidType = value instanceof File;
+      } else if (type === 'base64') {
+        isValidType =
+          typeof value === 'string' &&
+          !!value.match(/^data:([A-Za-z-+\/]+);base64,([A-Za-z0-9+/=]+)$/);
       } else if (type === 'date') {
         isValidType =
           typeof value === 'string' && !Number.isNaN(new Date(value).getTime());
@@ -629,6 +636,28 @@ export function createValidator<
 
       return validator;
     },
+
+    asFileFromBase64(message: string, filename: string) {
+      if (shouldSkipValidation()) return validator;
+
+      const value = current.value;
+
+      if (typeof value !== 'string') {
+        current.pushError(message);
+        return validator;
+      }
+
+      if (!value.match(/^data:([A-Za-z-+\/]+);base64,([A-Za-z0-9+/=]+)$/)) {
+        current.pushError(message);
+        return validator;
+      }
+
+      const file = fileUtils.base64ToFile(value, filename);
+      current.value = file;
+      current.inputs[current.field] = file as TRaw[keyof TRaw];
+
+      return validator;
+    },
   };
 
   return {

package/tests/helpers/crypto.spec.ts

@@ -0,0 +1,22 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { cryptoUtils } from '../../src/helpers/crypto';
+
+const AUTH_PAYLOAD_SECRET = '98c026b8-80d7-43ac-80d0-5118cb9c0102';
+const code = 'N3HDL5';
+
+describe('cryptoUtils', () => {
+  it('uuidV4 deve gerar um UUID válido', async () => {
+    const encrypted = await cryptoUtils.encryptPayload({
+      AUTH_PAYLOAD_SECRET,
+      payload: code,
+    });
+
+    const hash = await cryptoUtils.generateDeterministicHash(
+      code,
+      AUTH_PAYLOAD_SECRET
+    );
+
+    console.log({ encrypted, hash });
+  });
+});