ixc-orm 1.10.2 → 1.10.4

package/CHANGELOG.md

@@ -1,5 +1,5 @@
 # 🔄 CHANGELOG
-- [v1.10.2 - 20 de novembro de 2025](#v1102)
+- [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)
 - [v1.7.1 - 18 de outubro de 2025](#v171)
@@ -12,7 +12,7 @@
 
 ## 🚀 Novidades
 
-### v1.10.2
+### 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`.
 
 ### v1.9.0

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.2 `stable`
+> Versão 1.10.4 `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.2 `stable`
+> Versão 1.10.4 `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.2 `stable`
+> Versão 1.10.4 `stable`
 
 ```typescript
 import { IxcResponse, Sort } from 'ixc-orm';

package/dist/recursos/get_boleto.d.ts

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

package/dist/recursos/get_boleto.js

@@ -27,20 +27,6 @@ function get_boleto(args) {
             tipo_boleto: 'arquivo',
             base64: 'S'
         });
-        const response = yield requestEmitter.sendRequestToResource();
-        const content = response.content();
-        return contentConvertedToPDF(content);
+        return yield requestEmitter.sendRequestToResource();
     });
 }
-function contentConvertedToPDF(content) {
-    const bits = atob(content);
-    if (!bits.length) {
-        return '';
-    }
-    const bytes = new Uint8Array(bits.length);
-    for (let i = 0; i < bits.length; i++) {
-        bytes[i] = bits.charCodeAt(i);
-    }
-    const decoder = new TextDecoder('utf-8');
-    return decoder.decode(bytes);
-}

package/dist/recursos/index.d.ts

@@ -60,5 +60,5 @@ export declare const Recurso: {
  *
  * @deprecated Acesse os recursos através da constante {@link Recurso}
  */
-export default function RecursoIXC<T extends keyof Recursos>(recurso: T, args: Parameters<Recursos[T]>[0]): Promise<string | import("..").IXCResponse>;
+export default function RecursoIXC<T extends keyof Recursos>(recurso: T, args: Parameters<Recursos[T]>[0]): Promise<import("..").IXCResponse | import("..").IxcResponse>;
 export {};

package/dist/utils/TextUtils.d.ts

@@ -1,3 +1,18 @@
 export declare class TextUtils {
+    /**
+     * Remove caracteres "anormais" de uma string.
+     *
+     * @param text Uma string contendo caracteres "anormais".
+     * @returns Uma string com apenas letras de 'a' a 'z' (minúsculas ou maiúsculas), dígitos de '0'
+     *          a '9' e o caractere de sublinhado _.
+     */
     static normalize(text: string): string;
+    /**
+     * Converte uma string de um formato para outro definido pelo parâmetro **format**.
+     *
+     * @param text Uma string codificada (geralmente em algum formato não legível por seres humanos).
+     * @param format O formato para o qual se deseja converter. (UTF-8 é o padrão)
+     * @returns Uma string convertida para o formato definido pelo parâmetro **format**.
+     */
+    static convertTo(text: string, format?: string): string;
 }

package/dist/utils/TextUtils.js

@@ -2,8 +2,34 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TextUtils = void 0;
 class TextUtils {
+    /**
+     * Remove caracteres "anormais" de uma string.
+     *
+     * @param text Uma string contendo caracteres "anormais".
+     * @returns Uma string com apenas letras de 'a' a 'z' (minúsculas ou maiúsculas), dígitos de '0'
+     *          a '9' e o caractere de sublinhado _.
+     */
     static normalize(text) {
         return text.replace(/[^a-z0-9_]/gi, '').trim();
     }
+    /**
+     * Converte uma string de um formato para outro definido pelo parâmetro **format**.
+     *
+     * @param text Uma string codificada (geralmente em algum formato não legível por seres humanos).
+     * @param format O formato para o qual se deseja converter. (UTF-8 é o padrão)
+     * @returns Uma string convertida para o formato definido pelo parâmetro **format**.
+     */
+    static convertTo(text, format = 'utf-8') {
+        const chars = atob(text);
+        if (!chars.length) {
+            return '';
+        }
+        const bytes = new Uint8Array(chars.length);
+        for (let i = 0; i < chars.length; i++) {
+            bytes[i] = chars.charCodeAt(i);
+        }
+        const decoder = new TextDecoder(format);
+        return decoder.decode(bytes);
+    }
 }
 exports.TextUtils = TextUtils;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ixc-orm",
-  "version": "1.10.2",
+  "version": "1.10.4",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "license": "MIT",