@projetoacbr/acbrlib-base-node 1.0.3 → 1.0.5

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/index.js

@@ -169,7 +169,6 @@ class ACBrLibBaseMT {
         if (!this.handle) {
             return;
         }
-        koffi.encode(this.getHandle(), 'void *', null);
         koffi.free(this.handle);
         this.handle = null;
     }

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.3",
+  "version": "1.0.5",
   "description": "",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",