@projetoacbr/acbrlib-base-node 1.0.5 → 1.0.7

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

@@ -114,6 +114,9 @@ class ACBrLibBaseMT {
         return this.acbrlib;
     }
     getHandle() {
+        if (!this.#isInitialized()) {
+            throw new exception_1.ACBrLibLibNaoInicializadaError("Biblioteca não inicializada. Chame o método inicializar antes de usar outros métodos.");
+        }
         return koffi.decode(this.handle, 'void *');
     }
     #isInitialized() {
@@ -235,6 +238,9 @@ class ACBrLibBaseMT {
     ultimoRetorno() {
         const env_3 = { stack: [], error: void 0, hasError: false };
         try {
+            if (!this.#isInitialized()) {
+                return "";
+            }
             const acbrBuffer = __addDisposableResource(env_3, new ACBrBuffer_2.default(ACBrBuffer_1.TAMANHO_PADRAO), false);
             this.LIB_UltimoRetorno(this.getHandle(), acbrBuffer.getBuffer(), acbrBuffer.getRefTamanhoBuffer());
             return this._processaResult(acbrBuffer);
@@ -457,11 +463,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@projetoacbr/acbrlib-base-node",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -10,7 +10,7 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "build": "npx tsc",
-    "local-release": "npm run build && npm link"
+    "local-release": "npm run build && npx yalc publish"
   },
   "repository": {
     "type": "git",