ixc-orm 1.10.4 → 1.10.5

package/CHANGELOG.md

@@ -1,4 +1,5 @@
 # 🔄 CHANGELOG
+- [v1.10.5 - 20 de dezembro de 2025](#v1105)
 - [v1.10.4 - 20 de novembro de 2025](#v1104)
 - [v1.9.0 - 09 de outubro de 2025](#v190)
 - [v1.8.0 - 18 de outubro de 2025](#v180)
@@ -10,13 +11,18 @@
 - [v1.4.3 - 15 de agosto de 2025](#v143)
 - [v1.4.1 - 14 de agosto de 2025](#v141)
 
+
 ## 🚀 Novidades
 
+
+### v1.10.5
+* **Correção:** Removida a utilização da biblioteca nativa DOMParser, que quebrava ao tentar extrair a mensagem de erro de uma resposta do IXC Provedor.
+
 ### v1.10.4
-* **Melhoria:** O recurso `Recurso.getArquivoBoleto()`, que obtém um arquivo PDF de um boleto, passou a utilizar o 'RequestEmitter' da API para executar a requisição. A resposta desse recurso será uma Promise contendo a instância de um objeto do tipo `IxcResponse`.
+* **Melhoria:** O recurso `Recurso.getArquivoBoleto()`, que obtém um arquivo PDF de um boleto, passou a utilizar o 'RequestEmitter' da API para executar a requisição. A resposta desse recurso será uma Promise contendo a instância de um objeto do tipo <a href="https://github.com/SousaFelipe/ixc-orm/blob/main/src/IxcResponse.ts">IxcResponse</a>.
 
 ### v1.9.0
-* **Melhoria:** Novo recurso para remoção de MAC de um PPPoE, através do recurso `radusuarios_25452`, que é disponibilizado pela própria API do IXC Provedor. Para utilizar o recurso, invocar o método assícrono `Recurso.limparMAC({ id_login: number });`. O método irá retornar a instãncia de um <a href="https://github.com/SousaFelipe/ixc-orm/blob/main/src/IxcResponse.ts">IxcResponse</a>.
+* **Melhoria:** Novo recurso para remoção de MAC de um PPPoE, através do recurso `radusuarios_25452`, que é disponibilizado pela própria API do IXC Provedor. Para utilizar o recurso, invocar o método assícrono `Recurso.limparMAC({ id_login: number });`. O método irá retornar a instância de um <a href="https://github.com/SousaFelipe/ixc-orm/blob/main/src/IxcResponse.ts">IxcResponse</a>.
 
 ### v1.8.0
 * **Melhoria:** O processo de carregamento do ambiente consegue detectar se as variáveis já foram carregas por um container Docker e interrompe o carregamento através do `.env`, evitando que a aplicação encerre o processo com erro..

package/README.md

@@ -33,7 +33,7 @@ yarn add ixc-orm
 Para configurar a comunicação da biblioteca com seu servidor IXC Provedor, é necessário adicionar as seguintes variáveis de ambiente a um arquivo `.env`, que esteja localizado no diretório raiz do seu projeto.
 
 > [!NOTE]\
-> Versão 1.10.4 `stable`
+> Versão 1.10.5 `stable`
 
 - **IXC_ACCESS_TOKEN** Um token de API gerado dentro do IXC Provedor.
 - **IXC_SERVER_DOMAIN** O domínio do seu servidor IXC Provedor.
@@ -60,7 +60,7 @@ services:
 As classes que representarão os diferentes tipos de registros no seu **IXC Provedor**, deverão herdar da classe `IxcOrm` (nova versão), como no exemplo a seguir:
 
 > [!NOTE]\
-> Versão 1.10.4 `stable`
+> Versão 1.10.5 `stable`
 
 ```typescript
 import { IxcOrm } from 'ixc-orm';
@@ -76,7 +76,7 @@ class Contrato extends IxcOrm {
 Após instanciar um objeto com o tipo que você criou (`Contrato, como no exemplo a cima`), você poderá acessar os métodos de construção da query de busca.
 
 > [!NOTE]\
-> Versão 1.10.4 `stable`
+> Versão 1.10.5 `stable`
 
 ```typescript
 import { IxcResponse, Sort } from 'ixc-orm';
@@ -104,16 +104,22 @@ const id_contrato = 45852;
 const response = await Recurso.desbloqueioDeConfianca({ id_contrato });
 ```
 
-> Dos recursos disponibilizados pela API do **IXC Provedor**, essa biblioteca já possui as implementações de:\
-> `cliente_contrato_ativar_cliente`, `cliente_contrato_btn_lib_temp_24722`, `desbloqueio_confianca`, `get_boleto` e `radusuarios_25452`.\
-> Obs: Os nomes dos recursos estão de acordo com a API do **IXC Provedor** a fim de facilitar o estudo através da sua própria documentação oficial.
+
+### Recursos disponíveis:
+
+| Recurso IXC | Método da biblioteca | Descrição
+| :---------- | :--------- | :---------- |
+| ativaContrato({ id_contrato }) | cliente_contrato_ativar_cliente | Ativa um contrato que esteja com o status de `pré-contrato` |
+| desbloqueioDeConfianca({ id_contrato }) | desbloqueio_confianca | Solicita liberação de um cliente que já tenha sido desbloqueado |
+| getArquivoBoleto({ id_fatura }) | get_boleto | Obtém uma string base64 com o conteúdo do PDF da fatura de um cliente |
+| limparMAC({ id_login }) | radusuarios_25452 | Remove o endereço de MAC do login de um cliente |
+| liberacaoTemporaria({ id_contrato }) | cliente_contrato_btn_lib_temp_24722 | Desbloqueia, por 72 horas, o contrato de um cliente bloqueado |
 
 
 # Contribuições
 
 Contribuições são sempre bem-vindas!\
 Se você conhece uma maneira melhor de fazer algo, por favor, me avise!
-Caso contrário, é sempre melhor fazer um PR na branch main.
 
 At.te,\
 <b>Felipe S. Carmo</b>.

package/dist/IxcResponse.js

@@ -119,13 +119,13 @@ class IxcResponse {
         }
     }
     createDataFromHtml() {
-        const parser = new DOMParser();
-        const document = parser.parseFromString(this.text, 'text/html');
+        const match = this.text.match(/>(.*?)<\/div>/);
+        const message = match ? match[1] : undefined;
         return {
             type: 'error',
             page: 0,
             total: 0,
-            message: document.body.textContent
+            message
         };
     }
 }

package/dist/recursos/index.d.ts

@@ -1,3 +1,4 @@
+import cliente_contrato_ativar_cliente from './cliente_contrato_ativar_cliente';
 import cliente_contrato_btn_lib_temp_24722 from './cliente_contrato_btn_lib_temp_24722';
 import desbloqueio_confianca from './desbloqueio_confianca';
 import get_boleto from './get_boleto';
@@ -16,6 +17,16 @@ type Recursos = typeof recursos;
  * **ATENÇÃO** --- Nem todos os recursos da API do IXC foram implementados por esta biblioteca
  */
 export declare const Recurso: {
+    /**
+     * Ativa o contrato de um cliente que esteja com o status de "pré-contrato". Este recurso não
+     * é capaz de ativar contratos que tenha sido desativados, ou estejam bloqueados.
+     *
+     * @description Corresponde ao recurso `cliente_contrato_ativar_cliente`
+     *
+     * @param id_contrato O ID do contrato que se deseja ativar
+     * @returns Um objeto **IxcResponse** contendo a resposta enviada pelo IXC
+     */
+    ativaContrato: typeof cliente_contrato_ativar_cliente;
     /**
      * Solicita ao IXC que desbloqueie o contrato de um cliente bloqueado, que já solicitou
      * a liberação temporária dentro de um período de 30 dias. Este recurso só funciona, caso
@@ -33,7 +44,7 @@ export declare const Recurso: {
      * @description Corresponde ao recurso `get_boleto`
      *
      * @param id_fatura O ID da fatura
-     * @returns Um **IXCResponse**, caso a requisição falhe, ou um **IXCRecursoResponse**
+     * @returns Um **IxcResponse**, caso a requisição falhe, ou um **IXCRecursoResponse**
      * contendo o conteúdo do boleto, caso a requisição seja bem-sucedida
      */
     getArquivoBoleto: typeof get_boleto;

package/dist/recursos/index.js

@@ -14,6 +14,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Recurso = void 0;
 exports.default = RecursoIXC;
+const cliente_contrato_ativar_cliente_1 = __importDefault(require("./cliente_contrato_ativar_cliente"));
 const cliente_contrato_btn_lib_temp_24722_1 = __importDefault(require("./cliente_contrato_btn_lib_temp_24722"));
 const desbloqueio_confianca_1 = __importDefault(require("./desbloqueio_confianca"));
 const get_boleto_1 = __importDefault(require("./get_boleto"));
@@ -31,6 +32,16 @@ const recursos = {
  * **ATENÇÃO** --- Nem todos os recursos da API do IXC foram implementados por esta biblioteca
  */
 exports.Recurso = {
+    /**
+     * Ativa o contrato de um cliente que esteja com o status de "pré-contrato". Este recurso não
+     * é capaz de ativar contratos que tenha sido desativados, ou estejam bloqueados.
+     *
+     * @description Corresponde ao recurso `cliente_contrato_ativar_cliente`
+     *
+     * @param id_contrato O ID do contrato que se deseja ativar
+     * @returns Um objeto **IxcResponse** contendo a resposta enviada pelo IXC
+     */
+    ativaContrato: cliente_contrato_ativar_cliente_1.default,
     /**
      * Solicita ao IXC que desbloqueie o contrato de um cliente bloqueado, que já solicitou
      * a liberação temporária dentro de um período de 30 dias. Este recurso só funciona, caso
@@ -48,7 +59,7 @@ exports.Recurso = {
      * @description Corresponde ao recurso `get_boleto`
      *
      * @param id_fatura O ID da fatura
-     * @returns Um **IXCResponse**, caso a requisição falhe, ou um **IXCRecursoResponse**
+     * @returns Um **IxcResponse**, caso a requisição falhe, ou um **IXCRecursoResponse**
      * contendo o conteúdo do boleto, caso a requisição seja bem-sucedida
      */
     getArquivoBoleto: get_boleto_1.default,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ixc-orm",
-  "version": "1.10.4",
+  "version": "1.10.5",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "MIT",
@@ -40,7 +40,6 @@
     "@jest/globals": "^30.2.0",
     "@testing-library/jest-dom": "^6.9.1",
     "@types/jest": "^30.0.0",
-    "@types/jsdom": "^27.0.0",
     "@types/node": "^24.10.1",
     "babel-jest": "^30.2.0",
     "jest": "^30.2.0",