@projetoacbr/acbrlib-base-node 1.0.4 → 1.0.6

package/README.md

@@ -20,7 +20,30 @@ npm install @projetoacbr/acbrlib-base-node
 
 ## 📖 Como Usar
 
-### Importação
+### 🎯 Importação
+
+#### 📝 TypeScript (Recomendado)
+
+```typescript
+// Importa a classe ACBrLibBaseMT oficial conforme documentação
+import ACBrLibBaseMT from "@projetoacbr/acbrlib-base-node/dist/src";
+```
+
+**⚙️ Configuração tsconfig.json recomendada:**
+```json
+{
+  "compilerOptions": {
+    "target": "es2022",
+    "module": "commonjs",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  }
+}
+```
+
+#### 🔧 JavaScript/CommonJS
 
 ```javascript
 const ACBrLibBaseMT = require('@projetoacbr/acbrlib-base-node/dist/src').default

package/dist/src/ACBrBuffer/index.d.ts

@@ -7,10 +7,34 @@ export default class ACBrBuffer {
     private bufferSize;
     private bufferData;
     private disposed;
-    constructor(size: number);
+    /**
+     *
+     * @param size Tamanho do buffer (usa valor padrão se inválido)
+     */
+    constructor(size?: number);
+    /**
+     * @description Retorna a referencia do tamanho do buffer
+     * @returns Referencia do tamanho do buffer
+     */
     getRefTamanhoBuffer(): any;
+    /**
+     * @description Retorna o buffer
+     * @returns Buffer
+     */
     getBuffer(): Buffer<ArrayBufferLike>;
+    /**
+     * @description Retorna a string do conteudo do buffer
+     * @returns String do conteudo do buffer
+     */
     toString(): string;
+    /**
+     *
+     * @description Destroi o buffer e liberando memoria dos recursos alocados
+     */
     destroy(): void;
+    /**
+     *
+     * @description Implementação do auto-cleanup com 'using' declaration
+     */
     [Symbol.dispose](): void;
 }

package/dist/src/ACBrBuffer/index.js

@@ -47,22 +47,46 @@ class ACBrBuffer {
     bufferSize;
     bufferData;
     disposed = false;
-    constructor(size) {
+    /**
+     *
+     * @param size Tamanho do buffer (usa valor padrão se inválido)
+     */
+    constructor(size = exports.TAMANHO_PADRAO) {
+        // Se o valor for inválido, usa o padrão
+        if (!Number.isFinite(size) || size <= 0) {
+            size = exports.TAMANHO_PADRAO;
+        }
         this.bufferSize = koffi.alloc("int", 1);
         this.bufferData = Buffer.alloc(size);
         koffi.encode(this.bufferSize, 'int', size);
     }
+    /**
+     * @description Retorna a referencia do tamanho do buffer
+     * @returns Referencia do tamanho do buffer
+     */
     getRefTamanhoBuffer() {
         return this.bufferSize;
     }
+    /**
+     * @description Retorna o buffer
+     * @returns Buffer
+     */
     getBuffer() {
         return this.bufferData;
     }
+    /**
+     * @description Retorna a string do conteudo do buffer
+     * @returns String do conteudo do buffer
+     */
     toString() {
         let size = deref(this.bufferSize, 'int');
         let strBuffer = this.bufferData.toString('utf8', 0, (Math.min(size, this.bufferData.length)));
         return strBuffer;
     }
+    /**
+     *
+     * @description Destroi o buffer e liberando memoria dos recursos alocados
+     */
     destroy() {
         if (!this.disposed) {
             koffi.free(this.bufferSize);
@@ -70,7 +94,10 @@ class ACBrBuffer {
             this.disposed = true;
         }
     }
-    // Implementação do auto-cleanup com 'using' declaration
+    /**
+     *
+     * @description Implementação do auto-cleanup com 'using' declaration
+     */
     [Symbol.dispose]() {
         this.destroy();
     }

package/dist/src/exception/ACBrLibResultCodes.js

@@ -1,4 +1,7 @@
 "use strict";
+/*
+* @description Enum com os códigos de resultado da ACBrLib
+*/
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ACBrLibResultCodes = void 0;
 var ACBrLibResultCodes;

package/dist/src/exception/index.d.ts

@@ -1,43 +1,81 @@
+/***
+ * Exceções da ACBrLib
+ */
 /**
- * ACBrLibError  é uma classe de Exception para lançar Exceçoes da ACBr
- *
+ * ACBrLibError é uma classe de Exception para lançar Exceçoes da ACBr
  */
 export default class ACBrLibError extends Error {
     constructor(msg: string);
 }
+/**
+ * ACBrLibLibNaoInicializadaError é uma classe que lança uma exceção quando a biblioteca não está inicializada
+ */
 export declare class ACBrLibLibNaoInicializadaError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibLibNaoFinalizadaError é uma classe que lança uma exceção quando a biblioteca não está finalizada
+ */
 export declare class ACBrLibLibNaoFinalizadaError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibConfigLerError é uma classe que lança uma exceção quando ocorre um erro ao ler a configuração
+ */
 export declare class ACBrLibConfigLerError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibConfigGravarError é uma classe que lança uma exceção quando ocorre um erro ao gravar a configuração
+ */
 export declare class ACBrLibConfigGravarError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibArquivoNaoExisteError é uma classe que lança uma exceção quando o arquivo não existe
+ */
 export declare class ACBrLibArquivoNaoExisteError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibDiretorioNaoExisteError é uma classe que lança uma exceção quando o diretório não existe
+ */
 export declare class ACBrLibDiretorioNaoExisteError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibHttpError é uma classe que lança uma exceção quando ocorre um erro ao fazer uma requisição HTTP
+ */
 export declare class ACBrLibHttpError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibParametroInvalidoError é uma classe que lança uma exceção quando o parâmetro é inválido
+ */
 export declare class ACBrLibParametroInvalidoError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibExecutandoMetodoError é uma classe que lança uma exceção quando o método está sendo executado
+ */
 export declare class ACBrLibExecutandoMetodoError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibNaoDisponivelEmModoConsoleError é uma classe que lança uma exceção quando a biblioteca não está disponível em modo console
+ */
 export declare class ACBrLibNaoDisponivelEmModoConsoleError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibTimeOutError é uma classe que lança uma exceção quando o tempo de espera expira
+ */
 export declare class ACBrLibTimeOutError extends ACBrLibError {
     constructor(msg: string);
 }
+/**
+ * ACBrLibDemoExpiradoError é uma classe que lança uma exceção quando o demo expira
+ */
 export declare class ACBrLibDemoExpiradoError extends ACBrLibError {
     constructor(msg: string);
 }

package/dist/src/exception/index.js

@@ -1,9 +1,11 @@
 "use strict";
+/***
+ * Exceções da ACBrLib
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ACBrLibDemoExpiradoError = exports.ACBrLibTimeOutError = exports.ACBrLibNaoDisponivelEmModoConsoleError = exports.ACBrLibExecutandoMetodoError = exports.ACBrLibParametroInvalidoError = exports.ACBrLibHttpError = exports.ACBrLibDiretorioNaoExisteError = exports.ACBrLibArquivoNaoExisteError = exports.ACBrLibConfigGravarError = exports.ACBrLibConfigLerError = exports.ACBrLibLibNaoFinalizadaError = exports.ACBrLibLibNaoInicializadaError = void 0;
 /**
- * ACBrLibError  é uma classe de Exception para lançar Exceçoes da ACBr
- *
+ * ACBrLibError é uma classe de Exception para lançar Exceçoes da ACBr
  */
 class ACBrLibError extends Error {
     constructor(msg) {
@@ -11,72 +13,108 @@ class ACBrLibError extends Error {
     }
 }
 exports.default = ACBrLibError;
+/**
+ * ACBrLibLibNaoInicializadaError é uma classe que lança uma exceção quando a biblioteca não está inicializada
+ */
 class ACBrLibLibNaoInicializadaError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibLibNaoInicializadaError = ACBrLibLibNaoInicializadaError;
+/**
+ * ACBrLibLibNaoFinalizadaError é uma classe que lança uma exceção quando a biblioteca não está finalizada
+ */
 class ACBrLibLibNaoFinalizadaError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibLibNaoFinalizadaError = ACBrLibLibNaoFinalizadaError;
+/**
+ * ACBrLibConfigLerError é uma classe que lança uma exceção quando ocorre um erro ao ler a configuração
+ */
 class ACBrLibConfigLerError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibConfigLerError = ACBrLibConfigLerError;
+/**
+ * ACBrLibConfigGravarError é uma classe que lança uma exceção quando ocorre um erro ao gravar a configuração
+ */
 class ACBrLibConfigGravarError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibConfigGravarError = ACBrLibConfigGravarError;
+/**
+ * ACBrLibArquivoNaoExisteError é uma classe que lança uma exceção quando o arquivo não existe
+ */
 class ACBrLibArquivoNaoExisteError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibArquivoNaoExisteError = ACBrLibArquivoNaoExisteError;
+/**
+ * ACBrLibDiretorioNaoExisteError é uma classe que lança uma exceção quando o diretório não existe
+ */
 class ACBrLibDiretorioNaoExisteError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibDiretorioNaoExisteError = ACBrLibDiretorioNaoExisteError;
+/**
+ * ACBrLibHttpError é uma classe que lança uma exceção quando ocorre um erro ao fazer uma requisição HTTP
+ */
 class ACBrLibHttpError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibHttpError = ACBrLibHttpError;
+/**
+ * ACBrLibParametroInvalidoError é uma classe que lança uma exceção quando o parâmetro é inválido
+ */
 class ACBrLibParametroInvalidoError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibParametroInvalidoError = ACBrLibParametroInvalidoError;
+/**
+ * ACBrLibExecutandoMetodoError é uma classe que lança uma exceção quando o método está sendo executado
+ */
 class ACBrLibExecutandoMetodoError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibExecutandoMetodoError = ACBrLibExecutandoMetodoError;
+/**
+ * ACBrLibNaoDisponivelEmModoConsoleError é uma classe que lança uma exceção quando a biblioteca não está disponível em modo console
+ */
 class ACBrLibNaoDisponivelEmModoConsoleError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibNaoDisponivelEmModoConsoleError = ACBrLibNaoDisponivelEmModoConsoleError;
+/**
+ * ACBrLibTimeOutError é uma classe que lança uma exceção quando o tempo de espera expira
+ */
 class ACBrLibTimeOutError extends ACBrLibError {
     constructor(msg) {
         super(msg);
     }
 }
 exports.ACBrLibTimeOutError = ACBrLibTimeOutError;
+/**
+ * ACBrLibDemoExpiradoError é uma classe que lança uma exceção quando o demo expira
+ */
 class ACBrLibDemoExpiradoError extends ACBrLibError {
     constructor(msg) {
         super(msg);

package/dist/src/index.js

@@ -457,11 +457,6 @@ class ACBrLibBaseMT {
         if (status === ACBrLibResultCodes_1.ACBrLibResultCodes.OK) {
             this.isHandleInitialized = true;
         }
-        else {
-            // por segurança, se a inicialização falhar, libera o handle
-            this.#releaseHandle();
-            this.isHandleInitialized = false;
-        }
         this._checkResult(status);
         return status;
     }

package/dist/src/utils/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Classe utilitária para conversões de tipos de dados específicas da ACBrLib
+ *
+ * Esta classe fornece métodos estáticos para converter entre tipos de dados
+ * JavaScript/TypeScript e os formatos esperados pelas bibliotecas nativas ACBr.
+ *
+ */
+export declare class ACBrDateConverter {
+    private static readonly MILLIS_PER_DAY;
+    private static readonly UNIX_EPOCH_START_PASCAL;
+    /**
+     * Converte uma data JavaScript para o formato Pascal TDateTime
+     *
+     * Pascal TDateTime representa datas como número de dias desde 30/12/1899
+     * com a parte fracionária representando a hora do dia.
+     *
+     * @param date - Data JavaScript a ser convertida
+     * @returns O valor em Pascal TDateTime
+     * @throws {TypeError} Quando o parâmetro não é uma instância de Date
+     * @throws {RangeError} Quando a data é inválida ou anterior ao epoch Unix
+     *
+     * @example
+     * ```typescript
+     * const date = new Date('2023-01-01T12:00:00Z');
+     * const pascalDateTime = ACBrConverters.convertDateToPascalTDateTime(date);
+     * console.log(pascalDateTime); // 44927.5
+     * ```
+     */
+    static convertDateToPascalTDateTime(date: Date): number;
+    /**
+     * Construtor privado para prevenir instanciação
+     * Esta classe deve ser usada apenas através de seus métodos estáticos
+     */
+    private constructor();
+}

package/dist/src/utils/index.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACBrDateConverter = void 0;
+/**
+ * Classe utilitária para conversões de tipos de dados específicas da ACBrLib
+ *
+ * Esta classe fornece métodos estáticos para converter entre tipos de dados
+ * JavaScript/TypeScript e os formatos esperados pelas bibliotecas nativas ACBr.
+ *
+ */
+class ACBrDateConverter {
+    // Constantes para conversão Pascal TDateTime - ES2022 compatible
+    static MILLIS_PER_DAY = 86_400_000.0;
+    static UNIX_EPOCH_START_PASCAL = 25_569.0;
+    /**
+     * Converte uma data JavaScript para o formato Pascal TDateTime
+     *
+     * Pascal TDateTime representa datas como número de dias desde 30/12/1899
+     * com a parte fracionária representando a hora do dia.
+     *
+     * @param date - Data JavaScript a ser convertida
+     * @returns O valor em Pascal TDateTime
+     * @throws {TypeError} Quando o parâmetro não é uma instância de Date
+     * @throws {RangeError} Quando a data é inválida ou anterior ao epoch Unix
+     *
+     * @example
+     * ```typescript
+     * const date = new Date('2023-01-01T12:00:00Z');
+     * const pascalDateTime = ACBrConverters.convertDateToPascalTDateTime(date);
+     * console.log(pascalDateTime); // 44927.5
+     * ```
+     */
+    static convertDateToPascalTDateTime(date) {
+        // Validação de tipo usando ES2022 features
+        if (!(date instanceof Date)) {
+            throw new TypeError('Parâmetro deve ser uma instância de Date');
+        }
+        // Verificação de data inválida usando Number.isNaN (ES2015+, compatível com ES2022)
+        if (Number.isNaN(date.getTime())) {
+            throw new RangeError('Data inválida para conversão para Pascal TDateTime');
+        }
+        // Verificação de data anterior ao epoch Unix (1970-01-01)
+        if (date.getTime() < 0) {
+            throw new RangeError('Data anterior ao epoch Unix não é suportada');
+        }
+        // Conversão usando operadores matemáticos modernos
+        return (date.getTime() / this.MILLIS_PER_DAY) + this.UNIX_EPOCH_START_PASCAL;
+    }
+    /**
+     * Construtor privado para prevenir instanciação
+     * Esta classe deve ser usada apenas através de seus métodos estáticos
+     */
+    constructor() {
+        throw new Error('ACBrDateConvert é uma classe utilitária e não deve ser instanciada');
+    }
+}
+exports.ACBrDateConverter = ACBrDateConverter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@projetoacbr/acbrlib-base-node",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",