exodus-framework 2.1.1026 → 2.1.1027

package/lib/utils/api.d.ts

@@ -7,9 +7,9 @@ declare abstract class Api {
     constructor();
     init(): Promise<void>;
     abstract validateStatus(status: number): boolean;
-    request<T>(endpoint: string, method: Method, data?: any, params?: any, headers?: AxiosHeaders): Promise<IApiResponse<T> | import("axios").AxiosResponse<T, any>>;
-    requestDirect<T>(endpoint: string, method: Method, data?: any, params?: any, headers?: AxiosHeaders): Promise<import("axios").AxiosResponse<IApiResponse<T>, any> | import("axios").AxiosResponse<T, any>>;
-    requestExternal<T>(endpoint: string, method: Method, data?: any, params?: any, headers?: AxiosHeaders): Promise<import("axios").AxiosResponse<T, any>>;
+    request<T>(endpoint: string, method: Method, data?: any, params?: any, headers?: AxiosHeaders): Promise<IApiResponse<T> | import("axios").AxiosResponse<T, any, {}>>;
+    requestDirect<T>(endpoint: string, method: Method, data?: any, params?: any, headers?: AxiosHeaders): Promise<import("axios").AxiosResponse<IApiResponse<T>, any, {}> | import("axios").AxiosResponse<T, any, {}>>;
+    requestExternal<T>(endpoint: string, method: Method, data?: any, params?: any, headers?: AxiosHeaders): Promise<import("axios").AxiosResponse<T, any, {}>>;
     protected getLogicalSecurityId(): string;
 }
 export default Api;

package/lib/utils/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/utils/api.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAc,MAAM,OAAO,CAAC;AAG/E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,uBAAe,GAAG;IAChB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;;IAMhC,IAAI;IAWV,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAE1C,OAAO,CAAC,CAAC,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE,YAAY;IAkBlB,aAAa,CAAC,CAAC,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE,YAAY;IAkBlB,eAAe,CAAC,CAAC,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE,YAAY;IAkBxB,SAAS,CAAC,oBAAoB;CAI/B;AAED,eAAe,GAAG,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/utils/api.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAc,MAAM,OAAO,CAAC;AAG/E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA6BjD,uBAAe,GAAG;IAEhB,KAAK,EAAE,aAAa,CAAC;IAGrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;;IAuBhC,IAAI;IA0BV,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IA4B1C,OAAO,CAAC,CAAC,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE,YAAY;IAwClB,aAAa,CAAC,CAAC,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE,YAAY;IAkDlB,eAAe,CAAC,CAAC,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE,YAAY;IAiCxB,SAAS,CAAC,oBAAoB;CAI/B;AAED,eAAe,GAAG,CAAC"}

package/lib/utils/api.js

@@ -8,11 +8,62 @@ var _axios = _interopRequireDefault(require("axios"));
 var _dateFns = require("date-fns");
 var _app = require("../app");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Classe abstrata base para criação de clientes HTTP usando Axios.
+ *
+ * Esta classe fornece uma estrutura comum para realizar requisições HTTP
+ * com tratamento de erros padronizado, validação de status customizável
+ * e diferentes tipos de requisições (interna, externa, direta).
+ *
+ * @example
+ * ```typescript
+ * class MyApiClient extends Api {
+ *   host = 'https://api.example.com';
+ *   headers = { 'Authorization': 'Bearer token' };
+ *
+ *   validateStatus(status: number): boolean {
+ *     return status >= 200 && status < 300;
+ *   }
+ * }
+ *
+ * const client = new MyApiClient();
+ * const response = await client.request('/users', 'GET');
+ * ```
+ *
+ * @abstract
+ * @class Api
+ * @version 1.0.0
+ * @author Exodus Framework
+ */
 class Api {
+  /** Instância do Axios configurada */
   axios;
+
+  /** URL base para as requisições (deve ser implementado nas classes filhas) */
+
+  /** Headers padrão para as requisições (deve ser implementado nas classes filhas) */
+
+  /**
+   * Construtor da classe Api.
+   * Inicializa automaticamente a instância do Axios.
+   */
   constructor() {
     this.init();
   }
+
+  /**
+   * Inicializa a instância do Axios com configurações padrão.
+   *
+   * @protected
+   * @async
+   * @returns Promise<void>
+   *
+   * @example
+   * ```typescript
+   * // Chamado automaticamente no constructor
+   * await this.init();
+   * ```
+   */
   async init() {
     this.axios = _axios.default.create({
       baseURL: this.host,
@@ -23,6 +74,49 @@ class Api {
       validateStatus: this.validateStatus
     });
   }
+
+  /**
+   * Método abstrato para validação de status HTTP.
+   * Deve ser implementado nas classes filhas para definir quais status são considerados válidos.
+   *
+   * @abstract
+   * @param status - Código de status HTTP da resposta
+   * @returns true se o status é válido, false caso contrário
+   *
+   * @example
+   * ```typescript
+   * validateStatus(status: number): boolean {
+   *   return status >= 200 && status < 400; // Aceita 2xx e 3xx
+   * }
+   * ```
+   */
+
+  /**
+   * Realiza uma requisição HTTP e retorna apenas os dados da resposta.
+   *
+   * @template T - Tipo dos dados esperados na resposta
+   * @param endpoint - Endpoint da API (será concatenado com host)
+   * @param method - Método HTTP (GET, POST, PUT, DELETE, etc.)
+   * @param data - Dados para envio no corpo da requisição (opcional)
+   * @param params - Parâmetros de query string (opcional)
+   * @param headers - Headers adicionais para a requisição (opcional)
+   * @returns Promise com os dados da resposta ou undefined em caso de erro
+   *
+   * @example
+   * ```typescript
+   * // GET request
+   * const users = await this.request<User[]>('/users', 'GET');
+   *
+   * // POST request com dados
+   * const newUser = await this.request<User>('/users', 'POST', {
+   *   name: 'João',
+   *   email: 'joao@example.com'
+   * });
+   *
+   * // GET com parâmetros
+   * const user = await this.request<User>('/users', 'GET', null, { id: 123 });
+   * ```
+   */
   async request(endpoint, method, data, params, headers) {
     try {
       const res = await this.axios({
@@ -42,6 +136,29 @@ class Api {
       return e.response;
     }
   }
+
+  /**
+   * Realiza uma requisição HTTP e retorna a resposta completa do Axios.
+   *
+   * Este método é útil quando você precisa acessar headers, status code,
+   * ou outras propriedades da resposta além dos dados.
+   *
+   * @template T - Tipo dos dados esperados na resposta
+   * @param endpoint - Endpoint da API (será concatenado com host)
+   * @param method - Método HTTP (GET, POST, PUT, DELETE, etc.)
+   * @param data - Dados para envio no corpo da requisição (opcional)
+   * @param params - Parâmetros de query string (opcional)
+   * @param headers - Headers adicionais para a requisição (opcional)
+   * @returns Promise com a resposta completa do Axios ou undefined em caso de erro
+   *
+   * @example
+   * ```typescript
+   * const response = await this.requestDirect<User>('/users/1', 'GET');
+   * console.log(response.status); // 200
+   * console.log(response.headers); // Headers da resposta
+   * console.log(response.data); // Dados do usuário
+   * ```
+   */
   async requestDirect(endpoint, method, data, params, headers) {
     try {
       const res = await this.axios({
@@ -61,6 +178,39 @@ class Api {
       return e.response;
     }
   }
+
+  /**
+   * Realiza uma requisição HTTP para APIs externas.
+   *
+   * Este método é otimizado para chamadas a APIs de terceiros,
+   * não utilizando a interface IApiResponse padrão do framework.
+   *
+   * @template T - Tipo dos dados esperados na resposta
+   * @param endpoint - Endpoint da API (será concatenado com host)
+   * @param method - Método HTTP (GET, POST, PUT, DELETE, etc.)
+   * @param data - Dados para envio no corpo da requisição (opcional)
+   * @param params - Parâmetros de query string (opcional)
+   * @param headers - Headers adicionais para a requisição (opcional)
+   * @returns Promise com a resposta da API externa ou undefined em caso de erro
+   *
+   * @example
+   * ```typescript
+   * // Chamada para API externa (ex: GitHub)
+   * const githubUser = await this.requestExternal<GitHubUser>(
+   *   '/users/octocat',
+   *   'GET'
+   * );
+   *
+   * // API externa com autenticação
+   * const data = await this.requestExternal<ExternalData>(
+   *   '/api/data',
+   *   'GET',
+   *   null,
+   *   null,
+   *   { 'X-API-Key': 'external-api-key' }
+   * );
+   * ```
+   */
   async requestExternal(endpoint, method, data, params, headers) {
     try {
       const res = await this.axios({
@@ -80,6 +230,22 @@ class Api {
       return e.response;
     }
   }
+
+  /**
+   * Gera um ID de segurança lógica baseado na data atual.
+   *
+   * Este método cria um identificador único baseado na data atual,
+   * útil para implementações de segurança ou cache temporal.
+   *
+   * @protected
+   * @returns String contendo o ID de segurança lógica
+   *
+   * @example
+   * ```typescript
+   * const securityId = this.getLogicalSecurityId();
+   * console.log(securityId); // "1695513600000" (exemplo)
+   * ```
+   */
   getLogicalSecurityId() {
     const date = (0, _dateFns.format)(new Date(), 'yyyy-MM-dd');
     return String(Date.parse(date) - 5000);

package/lib/utils/index.d.ts

@@ -3,4 +3,5 @@ export * from './database';
 export * from './date';
 export { default as logger } from './logger';
 export * from './session';
+export { default as Phone } from './phone';
 //# sourceMappingURL=index.d.ts.map

package/lib/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,OAAO,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,OAAO,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/lib/utils/index.js

@@ -5,7 +5,8 @@ Object.defineProperty(exports, "__esModule", {
 });
 var _exportNames = {
   Api: true,
-  logger: true
+  logger: true,
+  Phone: true
 };
 Object.defineProperty(exports, "Api", {
   enumerable: true,
@@ -13,6 +14,12 @@ Object.defineProperty(exports, "Api", {
     return _api.default;
   }
 });
+Object.defineProperty(exports, "Phone", {
+  enumerable: true,
+  get: function () {
+    return _phone.default;
+  }
+});
 Object.defineProperty(exports, "logger", {
   enumerable: true,
   get: function () {
@@ -57,4 +64,5 @@ Object.keys(_session).forEach(function (key) {
     }
   });
 });
+var _phone = _interopRequireDefault(require("./phone"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }

package/lib/utils/phone.d.ts

@@ -0,0 +1,23 @@
+declare class Phone {
+    private phone;
+    private ddi;
+    private ddd;
+    private nine;
+    private phonePart1;
+    private phonePart2;
+    private isValid;
+    private number;
+    constructor(phone: string);
+    getDDI(): string;
+    getDDD(): string;
+    hasNine(): boolean;
+    getNumber(): string;
+    getMaskedPhone(ddi?: boolean, ddd?: boolean, nine?: boolean): string;
+    getPhone(ddi?: boolean, ddd?: boolean, nine?: boolean): string;
+    getPhonePart1(): string;
+    getPhonePart2(): string;
+    getOriginalPhone(): string;
+    isValidPhone(): boolean;
+}
+export default Phone;
+//# sourceMappingURL=phone.d.ts.map

package/lib/utils/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../src/utils/phone.ts"],"names":[],"mappings":"AA8BA,cAAM,KAAK;IAkCG,OAAO,CAAC,KAAK;IAhCzB,OAAO,CAAC,GAAG,CAAS;IAGpB,OAAO,CAAC,GAAG,CAAS;IAGpB,OAAO,CAAC,IAAI,CAAS;IAGrB,OAAO,CAAC,UAAU,CAAS;IAG3B,OAAO,CAAC,UAAU,CAAS;IAG3B,OAAO,CAAC,OAAO,CAAU;IAGzB,OAAO,CAAC,MAAM,CAAS;gBAcH,KAAK,EAAE,MAAM;IAuD1B,MAAM;IAeN,MAAM;IAiBN,OAAO;IAeP,SAAS;IAoBT,cAAc,CAAC,GAAG,UAAO,EAAE,GAAG,UAAO,EAAE,IAAI,UAAO;IA2BlD,QAAQ,CAAC,GAAG,UAAO,EAAE,GAAG,UAAO,EAAE,IAAI,UAAO;IAqB5C,aAAa;IAeb,aAAa;IAeb,gBAAgB;IAiBhB,YAAY,IAAI,OAAO;CAG/B;AAED,eAAe,KAAK,CAAC"}

package/lib/utils/phone.js

@@ -0,0 +1,289 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _libphonenumberJs = require("libphonenumber-js");
+/**
+ * Classe utilitária para manipulação e validação de números de telefone brasileiros.
+ *
+ * Esta classe utiliza a biblioteca `libphonenumber-js` para parsing e validação,
+ * oferecendo métodos para extrair componentes do telefone (DDI, DDD, nono dígito)
+ * e formatação em diferentes padrões.
+ *
+ * @example
+ * ```typescript
+ * // Criando uma instância com número brasileiro
+ * const phone = new Phone('(11) 99999-8888');
+ *
+ * // Verificando se é válido
+ * console.log(phone.isValidPhone()); // true
+ *
+ * // Obtendo componentes
+ * console.log(phone.getDDD()); // '11'
+ * console.log(phone.hasNine()); // true
+ *
+ * // Formatação
+ * console.log(phone.getMaskedPhone()); // '+55 (11) 9 9999-8888'
+ * console.log(phone.getPhone(false, true, true)); // '1199999888'
+ * ```
+ *
+ * @class Phone
+ * @version 1.0.0
+ * @author Exodus Framework
+ */
+class Phone {
+  /** Código do país (DDI) */
+  ddi;
+
+  /** Código de área (DDD) */
+  ddd;
+
+  /** Nono dígito para celulares */
+  nine;
+
+  /** Primeira parte do número (4 primeiros dígitos) */
+  phonePart1;
+
+  /** Segunda parte do número (4 últimos dígitos) */
+  phonePart2;
+
+  /** Indica se o número é válido */
+  isValid;
+
+  /** Número limpo (apenas dígitos) */
+  number;
+
+  /**
+   * Cria uma nova instância da classe Phone.
+   *
+   * @param phone - Número de telefone em qualquer formato (com ou sem máscara)
+   *
+   * @example
+   * ```typescript
+   * const phone1 = new Phone('11999998888');
+   * const phone2 = new Phone('(11) 99999-8888');
+   * const phone3 = new Phone('+55 11 99999-8888');
+   * ```
+   */
+  constructor(phone) {
+    this.phone = phone;
+    // Remove todos os caracteres não numéricos
+    this.number = phone.replace(/\D/g, '');
+
+    // Utiliza libphonenumber-js para parsing do número brasileiro
+    const parsed = (0, _libphonenumberJs.parsePhoneNumberFromString)(this.number, 'BR');
+    this.isValid = !!parsed;
+
+    // Se não foi possível fazer o parse, marca como inválido
+    if (!parsed) {
+      this.isValid = false;
+      return;
+    }
+
+    // Extrai o DDI (código do país)
+    this.ddi = parsed.countryCallingCode;
+
+    // Processa baseado no tamanho do número nacional
+    if (parsed.nationalNumber.length > 10) {
+      // Celular com DDD e nono dígito (11 dígitos)
+      this.ddd = parsed.nationalNumber.slice(0, 2);
+      this.nine = parsed.nationalNumber[2];
+      this.phonePart1 = parsed.nationalNumber.slice(3, 7);
+      this.phonePart2 = parsed.nationalNumber.slice(7, parsed.nationalNumber.length);
+    } else if (parsed.nationalNumber.length == 10) {
+      // Telefone fixo com DDD (10 dígitos)
+      this.ddd = parsed.nationalNumber.slice(0, 2);
+      this.phonePart1 = parsed.nationalNumber.slice(2, 6);
+      this.phonePart2 = parsed.nationalNumber.slice(6, parsed.nationalNumber.length);
+    } else if (parsed.nationalNumber.length >= 9) {
+      // Celular sem DDD mas com nono dígito (9 dígitos)
+      this.nine = parsed.nationalNumber[0];
+      this.phonePart1 = parsed.nationalNumber.slice(1, 5);
+      this.phonePart2 = parsed.nationalNumber.slice(5, parsed.nationalNumber.length);
+    } else if (parsed.nationalNumber.length == 8) {
+      // Telefone fixo sem DDD (8 dígitos)
+      this.phonePart1 = parsed.nationalNumber.slice(0, 4);
+      this.phonePart2 = parsed.nationalNumber.slice(4, parsed.nationalNumber.length);
+    } else {
+      // Número inválido
+      this.isValid = false;
+    }
+  }
+
+  /**
+   * Retorna o código do país (DDI).
+   *
+   * @returns O DDI do número (ex: '55' para Brasil)
+   *
+   * @example
+   * ```typescript
+   * const phone = new Phone('+55 11 99999-8888');
+   * console.log(phone.getDDI()); // '55'
+   * ```
+   */
+  getDDI() {
+    return this.ddi;
+  }
+
+  /**
+   * Retorna o código de área (DDD).
+   *
+   * @returns O DDD do número (ex: '11' para São Paulo)
+   *
+   * @example
+   * ```typescript
+   * const phone = new Phone('(11) 99999-8888');
+   * console.log(phone.getDDD()); // '11'
+   * ```
+   */
+  getDDD() {
+    return this.ddd;
+  }
+
+  /**
+   * Verifica se o número possui o nono dígito (celular).
+   *
+   * @returns true se possui o nono dígito, false caso contrário
+   *
+   * @example
+   * ```typescript
+   * const celular = new Phone('11999998888');
+   * const fixo = new Phone('1133334444');
+   * console.log(celular.hasNine()); // true
+   * console.log(fixo.hasNine()); // false
+   * ```
+   */
+  hasNine() {
+    return !!this.nine;
+  }
+
+  /**
+   * Retorna o número limpo (apenas dígitos).
+   *
+   * @returns Número sem formatação, apenas dígitos
+   *
+   * @example
+   * ```typescript
+   * const phone = new Phone('(11) 99999-8888');
+   * console.log(phone.getNumber()); // '11999998888'
+   * ```
+   */
+  getNumber() {
+    return this.number;
+  }
+
+  /**
+   * Retorna o número formatado com máscara.
+   *
+   * @param ddi - Incluir DDI na formatação (padrão: true)
+   * @param ddd - Incluir DDD na formatação (padrão: true)
+   * @param nine - Incluir nono dígito na formatação (padrão: true)
+   * @returns Número formatado com máscara
+   *
+   * @example
+   * ```typescript
+   * const phone = new Phone('5511999998888');
+   * console.log(phone.getMaskedPhone()); // '+55 (11) 9 9999-8888'
+   * console.log(phone.getMaskedPhone(false)); // '(11) 9 9999-8888'
+   * console.log(phone.getMaskedPhone(true, false)); // '+55 9 9999-8888'
+   * ```
+   */
+  getMaskedPhone(ddi = true, ddd = true, nine = true) {
+    let fullNumber = '';
+    if (ddi && this.ddi) fullNumber += `+${this.ddi} `;
+    if (ddd && this.ddd) fullNumber += `(${this.ddd}) `;
+    if (nine && this.nine) fullNumber += `9 `;
+    fullNumber += `${this.getPhonePart1()}-${this.getPhonePart2()}`;
+    return fullNumber;
+  }
+
+  /**
+   * Retorna o número sem formatação, incluindo apenas os componentes selecionados.
+   *
+   * @param ddi - Incluir DDI no resultado (padrão: true)
+   * @param ddd - Incluir DDD no resultado (padrão: true)
+   * @param nine - Incluir nono dígito no resultado (padrão: true)
+   * @returns Número sem formatação
+   *
+   * @example
+   * ```typescript
+   * const phone = new Phone('5511999998888');
+   * console.log(phone.getPhone()); // '5511999998888'
+   * console.log(phone.getPhone(false)); // '11999998888'
+   * console.log(phone.getPhone(false, true, false)); // '1199998888'
+   * ```
+   */
+  getPhone(ddi = true, ddd = true, nine = true) {
+    let fullNumber = '';
+    if (ddi && this.ddi) fullNumber += this.ddi;
+    if (ddd && this.ddd) fullNumber += this.ddd;
+    if (nine && this.nine) fullNumber += this.nine;
+    fullNumber += this.getPhonePart1() + this.getPhonePart2();
+    return fullNumber;
+  }
+
+  /**
+   * Retorna a primeira parte do número (primeiros 4 dígitos após DDD/nono dígito).
+   *
+   * @returns Primeira parte do número
+   *
+   * @example
+   * ```typescript
+   * const phone = new Phone('11999998888');
+   * console.log(phone.getPhonePart1()); // '9999'
+   * ```
+   */
+  getPhonePart1() {
+    return this.phonePart1;
+  }
+
+  /**
+   * Retorna a segunda parte do número (últimos 4 dígitos).
+   *
+   * @returns Segunda parte do número
+   *
+   * @example
+   * ```typescript
+   * const phone = new Phone('11999998888');
+   * console.log(phone.getPhonePart2()); // '8888'
+   * ```
+   */
+  getPhonePart2() {
+    return this.phonePart2;
+  }
+
+  /**
+   * Retorna o número original fornecido no construtor.
+   *
+   * @returns Número original sem alterações
+   *
+   * @example
+   * ```typescript
+   * const phone = new Phone('(11) 99999-8888');
+   * console.log(phone.getOriginalPhone()); // '(11) 99999-8888'
+   * ```
+   */
+  getOriginalPhone() {
+    return this.phone;
+  }
+
+  /**
+   * Verifica se o número de telefone é válido.
+   *
+   * @returns true se o número é válido, false caso contrário
+   *
+   * @example
+   * ```typescript
+   * const validPhone = new Phone('11999998888');
+   * const invalidPhone = new Phone('123');
+   * console.log(validPhone.isValidPhone()); // true
+   * console.log(invalidPhone.isValidPhone()); // false
+   * ```
+   */
+  isValidPhone() {
+    return this.isValid;
+  }
+}
+var _default = exports.default = Phone;

package/lib/utils/session.d.ts

@@ -6,6 +6,6 @@ export declare class SessionAPI extends Api {
         'X-Exodus-Core-Version': string;
     };
     validateStatus(status: number): boolean;
-    getCertificate(): Promise<import("..").IApiResponse<string> | import("axios").AxiosResponse<string, any>>;
+    getCertificate(): Promise<import("..").IApiResponse<string> | import("axios").AxiosResponse<string, any, {}>>;
 }
 //# sourceMappingURL=session.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exodus-framework",
-  "version": "2.1.1026",
+  "version": "2.1.1027",
   "description": "Exodus Framework",
   "author": "jhownpaixao",
   "license": "ISC",
@@ -40,6 +40,7 @@
     "fs": "^0.0.1-security",
     "fs-extra": "^11.3.0",
     "install": "^0.13.0",
+    "libphonenumber-js": "^1.12.18",
     "lodash": "^4.17.21",
     "mariadb": "^3.3.1",
     "multer": "^1.4.5-lts.1",