ixc-orm 1.10.4 → 1.10.6

package/CHANGELOG.md

@@ -1,4 +1,6 @@
 # 🔄 CHANGELOG
+- [v1.10.6 - 23 de dezembro de 2025](#v1106)
+- [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 +12,20 @@
 - [v1.4.3 - 15 de agosto de 2025](#v143)
 - [v1.4.1 - 14 de agosto de 2025](#v141)
 
+
 ## 🚀 Novidades
 
+### v1.10.6
+* **Correção:** Removido o bug que ocorria ao tentar utilizar o recurso `liberacaoTemporaria({ id_contrato })` sem que as antigas variáveis de ambiente estivessem definidas.
+
+### 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

@@ -1,5 +1,5 @@
 <div align="center">
-  
+
 # IXC-ORM
 
 ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white)
@@ -30,13 +30,10 @@ yarn add ixc-orm
 
 ## Como utilizar
 
-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`
+Para configurar a comunicação da biblioteca com o seu IXC Provedor, será necessário adicionar as seguintes variáveis de ambiente a um arquivo `.env`, que esteja localizado no diretório raiz do seu projeto.
 
 - **IXC_ACCESS_TOKEN** Um token de API gerado dentro do IXC Provedor.
-- **IXC_SERVER_DOMAIN** O domínio do seu servidor IXC Provedor.
+- **IXC_SERVER_DOMAIN** O domínio do seu IXC Provedor.
 
 ```ini
 IXC_ACCESS_TOKEN=conteúdo-do-token-gerado-dentro-do-ixc
@@ -48,8 +45,10 @@ Você também poderá configurar para que o Docker carregue as variáveis, ao in
 ```yaml
 services:
   sua-aplicacao:
-    build: .
-    image: sua-imagem-docker
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: sua-imagem-docker:0.0.0
     environment:
       - IXC_ACCESS_TOKEN=${IXC_ACCESS_TOKEN}
       - IXC_SERVER_DOMAIN=${IXC_SERVER_DOMAIN}
@@ -57,10 +56,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`
+As classes que representarão os diferentes tipos de registros no seu **IXC Provedor**, deverão herdar da classe `IxcOrm`, como no exemplo a seguir:
 
 ```typescript
 import { IxcOrm } from 'ixc-orm';
@@ -73,10 +69,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`
+Após instanciar um objeto com o tipo criado (**Contrato**, como no exemplo a cima), você poderá acessar os métodos de construção da query de busca, da seguinte forma:
 
 ```typescript
 import { IxcResponse, Sort } from 'ixc-orm';
@@ -95,7 +88,7 @@ const contratos = response.registros();
 
 ## Recursos da API do IXC Provedor
 
-Existem alguns `endpoints` que a API do IXC Provedor disponibiliza, a fim de "encurtar o caminho" para chegar até algumas informações. Como por exemplo, obter o arquivo PDF de uma fatura. Para isso, você não precisará se preocupar em criar uma classe `Boleto` que herde da classe `IxcOrm`, por exemplo, nem encadear chamadas de filtros. Basta fazer como no exemplo a seguir:
+Existem alguns `endpoints` que a API do IXC Provedor disponibiliza, a fim de "encurtar o caminho" para chegar até algumas informações ou executar determinadas ações. Como por exemplo, obter o arquivo PDF de uma fatura! Para isso, você não precisará se preocupar em criar uma classe `Boleto` que herde da classe `IxcOrm`, por exemplo, nem encadear chamadas de filtros. Basta fazer como no exemplo a seguir:
 
 ```typescript
 import { Recurso } from 'ixc-orm';
@@ -104,16 +97,23 @@ 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:
+
+| Método da biblioteca | Recurso IXC | 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.
+Se você conhece uma maneira melhor de fazer algo, por favor, me avise!\
+Ou sinta-se a vontade para criar um novo PR!
 
 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/cliente_contrato_btn_lib_temp_24722.d.ts

@@ -1,4 +1,4 @@
-import { IXCResponse } from '../types';
+import IxcResponse from '../IxcResponse';
 export default function cliente_contrato(args: {
     id_contrato?: string | number;
-}): Promise<IXCResponse>;
+}): Promise<IxcResponse>;

package/dist/recursos/cliente_contrato_btn_lib_temp_24722.js

@@ -13,16 +13,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = cliente_contrato;
-const recurso_1 = __importDefault(require("./recurso"));
+const RequestEmitter_1 = __importDefault(require("../api/RequestEmitter"));
 const src = 'cliente_contrato_btn_lib_temp_24722';
 function cliente_contrato(args) {
     return __awaiter(this, void 0, void 0, function* () {
         const { id_contrato } = args;
-        return yield (0, recurso_1.default)({
-            src,
-            data: {
-                id_contrato
-            }
+        const requestEmitter = new RequestEmitter_1.default(src);
+        requestEmitter.setupQuery({
+            id: id_contrato
         });
+        return yield requestEmitter.sendRequestToResource();
     });
 }

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';
@@ -6,7 +7,6 @@ import radusuarios_25452 from './radusuarios_25452';
  * @deprecated Acesse os recursos através da constante {@link Recurso}
  */
 declare const recursos: {
-    cliente_contrato: typeof cliente_contrato_btn_lib_temp_24722;
     desbloqueio_confianca: typeof desbloqueio_confianca;
     get_boleto: typeof get_boleto;
 };
@@ -16,6 +16,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 +43,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"));
@@ -22,7 +23,6 @@ const radusuarios_25452_1 = __importDefault(require("./radusuarios_25452"));
  * @deprecated Acesse os recursos através da constante {@link Recurso}
  */
 const recursos = {
-    cliente_contrato: cliente_contrato_btn_lib_temp_24722_1.default,
     desbloqueio_confianca: desbloqueio_confianca_1.default,
     get_boleto: get_boleto_1.default
 };
@@ -31,6 +31,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 +58,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.6",
   "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",