@projetoacbr/acbrlib-base-node 1.0.10 → 1.0.11

package/README.md

@@ -1,7 +1,7 @@
 # @projetoacbr/acbrlib-base-node
 
 [![License: LGPL-2.1](https://img.shields.io/badge/License-LGPL--2.1-green.svg)](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html)
-[![Version](https://img.shields.io/badge/version-1.0.1-blue.svg)](https://www.npmjs.com/package/@projetoacbr/acbrlib-base-node)
+[![Version](https://img.shields.io/badge/version-1.0.11-blue.svg)](https://www.npmjs.com/package/@projetoacbr/acbrlib-base-node)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.5.4-blue.svg)](https://www.typescriptlang.org/)
 
 ## 📋 Descrição
@@ -22,19 +22,26 @@ npm install @projetoacbr/acbrlib-base-node
 
 ### 🎯 Importação
 
-#### 📝 TypeScript (Recomendado)
+#### 📝 TypeScript 
+
+Configurações recomendas para Typescript com CommonJS
 
 ```typescript
 // Importa a classe ACBrLibBaseMT oficial conforme documentação
 import ACBrLibBaseMT from "@projetoacbr/acbrlib-base-node/dist/src";
 ```
 
-**⚙️ Configuração tsconfig.json recomendada:**
+**⚙️ Configuração tsconfig.json  recomendada:**
+
 ```json
 {
   "compilerOptions": {
     "target": "es2022",
     "module": "commonjs",
+     "lib": [
+      "esnext"
+    ],
+    "moduleResolution": "node",
     "strict": true,
     "esModuleInterop": true,
     "skipLibCheck": true,
@@ -115,6 +122,6 @@ LGPL-2.1 License - veja o arquivo [LICENSE](../LICENSE) para detalhes.
 ---
 
 **ACBrLib Base Node** - Classe base fundamental para ACBrLib-Nodejs  
-**Versão**: 1.0.1  
+**Versão**: 1.0.11 
 **Desenvolvido por**: [Projeto ACBr](https://www.projetoacbr.com.br/)
 

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

@@ -21,6 +21,8 @@ export declare class ACBrLibLibNaoFinalizadaError extends ACBrLibError {
 }
 /**
  * ACBrLibConfigLerError é uma classe que lança uma exceção quando ocorre um erro ao ler a configuração
+ * ou quando o arquivo de configuração tem configurações inválidas
+ * Erro comum é conversão de configurações para enumerado, por exemplo, Ambiente=2, quando o valor 2 não é um valor válido para o enumerado Ambiente, que tem os valores 1 (Produção) e 2 (Homologação)
  */
 export declare class ACBrLibConfigLerError extends ACBrLibError {
     constructor(msg: string);
@@ -38,7 +40,8 @@ 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
+ * ACBrLibDiretorioNaoExisteError é uma classe que lança uma exceção quando o diretório acessado pelo método não existe
+ * Erro comum é quando o método espera um diretório para salvar um arquivo, por exemplo, e o diretório não existe, ou seja, o caminho do diretório é inválido
  */
 export declare class ACBrLibDiretorioNaoExisteError extends ACBrLibError {
     constructor(msg: string);
@@ -75,6 +78,7 @@ export declare class ACBrLibTimeOutError extends ACBrLibError {
 }
 /**
  * ACBrLibDemoExpiradoError é uma classe que lança uma exceção quando o demo expira
+ * Ocorre quando passa 30 minutos após inicialização da biblioteca, ou seja, quando o tempo de uso do demo expira
  */
 export declare class ACBrLibDemoExpiradoError extends ACBrLibError {
     constructor(msg: string);

package/dist/src/exception/index.js

@@ -33,6 +33,8 @@ class ACBrLibLibNaoFinalizadaError extends ACBrLibError {
 exports.ACBrLibLibNaoFinalizadaError = ACBrLibLibNaoFinalizadaError;
 /**
  * ACBrLibConfigLerError é uma classe que lança uma exceção quando ocorre um erro ao ler a configuração
+ * ou quando o arquivo de configuração tem configurações inválidas
+ * Erro comum é conversão de configurações para enumerado, por exemplo, Ambiente=2, quando o valor 2 não é um valor válido para o enumerado Ambiente, que tem os valores 1 (Produção) e 2 (Homologação)
  */
 class ACBrLibConfigLerError extends ACBrLibError {
     constructor(msg) {
@@ -59,7 +61,8 @@ class ACBrLibArquivoNaoExisteError extends ACBrLibError {
 }
 exports.ACBrLibArquivoNaoExisteError = ACBrLibArquivoNaoExisteError;
 /**
- * ACBrLibDiretorioNaoExisteError é uma classe que lança uma exceção quando o diretório não existe
+ * ACBrLibDiretorioNaoExisteError é uma classe que lança uma exceção quando o diretório acessado pelo método não existe
+ * Erro comum é quando o método espera um diretório para salvar um arquivo, por exemplo, e o diretório não existe, ou seja, o caminho do diretório é inválido
  */
 class ACBrLibDiretorioNaoExisteError extends ACBrLibError {
     constructor(msg) {
@@ -114,6 +117,7 @@ class ACBrLibTimeOutError extends ACBrLibError {
 exports.ACBrLibTimeOutError = ACBrLibTimeOutError;
 /**
  * ACBrLibDemoExpiradoError é uma classe que lança uma exceção quando o demo expira
+ * Ocorre quando passa 30 minutos após inicialização da biblioteca, ou seja, quando o tempo de uso do demo expira
  */
 class ACBrLibDemoExpiradoError extends ACBrLibError {
     constructor(msg) {

package/dist/src/index.js

@@ -381,25 +381,25 @@ class ACBrLibBaseMT {
         if (!this._isResultErrorCode(result)) {
             return;
         }
-        let errorMessage = this.#isInitialized() ? `${result}: ${this.ultimoRetorno()}` : `${result}: Biblioteca não inicializada`;
+        let errorMessage = this.#isInitialized() ? `${result}: ${this.ultimoRetorno()}` : "";
         switch (result) {
             case ACBrLibResultCodes_1.ACBrLibResultCodes.ErrLibNaoInicializada:
-                throw new exception_1.ACBrLibLibNaoInicializadaError("Erro ao inicializar " + this.constructor.name);
+                throw new exception_1.ACBrLibLibNaoInicializadaError("Erro ao inicializar a biblioteca " + this.constructor.name);
                 break;
             case ACBrLibResultCodes_1.ACBrLibResultCodes.ErrLibNaoFinalizada:
                 throw new exception_1.ACBrLibLibNaoFinalizadaError("Erro ao finalizar a biblioteca");
                 break;
             case ACBrLibResultCodes_1.ACBrLibResultCodes.ErrConfigLer:
-                throw new exception_1.ACBrLibConfigLerError(errorMessage);
+                throw new exception_1.ACBrLibConfigLerError("Erro ao ler arquivo de configuração/arquivo com configurações inválidas: " + errorMessage);
                 break;
             case ACBrLibResultCodes_1.ACBrLibResultCodes.ErrConfigGravar:
-                throw new exception_1.ACBrLibConfigGravarError(errorMessage);
+                throw new exception_1.ACBrLibConfigGravarError("Erro ao gravar configuração: " + errorMessage);
                 break;
             case ACBrLibResultCodes_1.ACBrLibResultCodes.ErrArquivoNaoExiste:
-                throw new exception_1.ACBrLibArquivoNaoExisteError(errorMessage);
+                throw new exception_1.ACBrLibArquivoNaoExisteError("Erro: Arquivo não existe: " + errorMessage);
                 break;
             case ACBrLibResultCodes_1.ACBrLibResultCodes.ErrDiretorioNaoExiste:
-                throw new exception_1.ACBrLibDiretorioNaoExisteError(errorMessage);
+                throw new exception_1.ACBrLibDiretorioNaoExisteError("Erro: Diretório não existe: " + errorMessage);
                 break;
             case ACBrLibResultCodes_1.ACBrLibResultCodes.ErrHttp:
                 throw new exception_1.ACBrLibHttpError(errorMessage);

package/package.json

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