@danielrebolledo/cafe-ipdh-lib 1.0.5 → 1.1.1

package/README.md

@@ -1,23 +1,31 @@
 # cafe-ipdh-lib
 
-Librería NPM para gestionar impresoras fiscales y de recibos. Simplifica la construcción de comandos para diferentes modelos de impresoras.
+Librería para gestionar impresoras fiscales y de recibos. Construye comandos y los envía mediante una API unificada (`sendPrinterCommands`) que soporta AEG y DTP.
 
 ## Modelos soportados
 
-- **AEG-R1**: Impresora fiscal vía HTTP (comandos JSON)
+| Marca | Modelo | Transporte |
+|-------|--------|------------|
+| **AEG** | R1 | HTTP (POST a `/cmdoJson`) |
+| **DTP** | 80i | TCP |
 
 ## Instalación
 
 ```bash
-npm install cafe-ipdh-lib
+npm install @danielrebolledo/cafe-ipdh-lib
 ```
 
-## Uso
+## Uso unificado: `sendPrinterCommands`
 
-### Imprimir factura fiscal (AEG-R1)
+Tanto AEG como DTP usan la misma función:
 
 ```ts
-import { aegPrinter } from "cafe-ipdh-lib";
+import {
+  aegPrinter,
+  dtpPrinter,
+  sendPrinterCommands,
+  DtpClient,
+} from "@danielrebolledo/cafe-ipdh-lib";
 
 const order = {
   client: { id: "V12345678", name: "Cliente", email: "c@mail.com" },
@@ -26,53 +34,188 @@ const order = {
   total: 10,
 };
 
-const commands = aegPrinter.buildInvoiceCommands(order, {
-  paymentMethodId: "cash_nat",
-  storeName: "Mi Tienda",
+// AEG-R1 (HTTP)
+const resultAeg = await sendPrinterCommands({
+  brand: "AEG",
+  model: "R1",
+  ip: "http://192.168.1.100",
+  commands: aegPrinter.buildInvoiceCommands(order, {
+    paymentMethodId: "cash_nat",
+    storeName: "Mi Tienda",
+  }),
 });
 
-// Enviar commands a tu API/impresora (HTTP, etc.)
+// DTP-80i (TCP; requiere client ya conectado)
+const resultDtp = await sendPrinterCommands({
+  brand: "DTP",
+  model: "80i",
+  client: dtpClient, // DtpClient conectado
+  commands: dtpPrinter.buildInvoiceCommands(order, {
+    paymentMethodId: "cash_nat",
+    storeName: "Mi Tienda",
+  }),
+});
 ```
 
-### Imprimir recibo de pago
+## Ejemplos por entorno
+
+### Web (AEG-R1)
+
+En un proyecto web (Next.js, Vite, etc.), normalmente se usa AEG por HTTP:
 
 ```ts
-const receiptCommands = aegPrinter.buildReceiptCommands({
-  orderId: "ORD-123",
-  amountPaid: 150.5,
-  paymentMethod: "Tarjeta débito",
-  organizationName: "Mi Negocio",
-});
+import {
+  aegPrinter,
+  sendPrinterCommands,
+  type Order,
+} from "@danielrebolledo/cafe-ipdh-lib";
+
+async function imprimirFactura(order: Order, printerIp: string) {
+  const commands = aegPrinter.buildInvoiceCommands(order, {
+    paymentMethodId: "cash_nat",
+    storeName: "Mi Tienda",
+  });
+
+  const result = await sendPrinterCommands({
+    brand: "AEG",
+    model: "R1",
+    ip: printerIp,
+    commands,
+  });
+
+  const invoiceRef = Array.isArray(result)
+    ? result.find((r) => r.cmd === "endFac")?.dataD ?? 0
+    : result.documentNumber ?? 0;
+
+  return { success: true, invoiceRef };
+}
+```
+
+### React Native (DTP-80i)
+
+En React Native (Expo, etc.) se suele usar DTP vía TCP con `react-native-tcp-socket`:
+
+```bash
+npm install react-native-tcp-socket
+```
+
+```ts
+import TcpSocket from "react-native-tcp-socket";
+import {
+  DtpClient,
+  dtpPrinter,
+  sendPrinterCommands,
+  type Order,
+} from "@danielrebolledo/cafe-ipdh-lib";
+
+const createConnection = (opts: { host: string; port: number }) =>
+  new Promise((resolve, reject) => {
+    const socket = TcpSocket.createConnection(opts, () => resolve(socket));
+    socket.once("error", reject);
+  });
+
+async function imprimirFactura(order: Order, host: string, port: number) {
+  const client = new DtpClient({
+    host,
+    port,
+    connectTimeoutMs: 15000,
+    createConnection: createConnection as any,
+  });
+
+  try {
+    await client.connect();
+
+    const commands = dtpPrinter.buildInvoiceCommands(order, {
+      paymentMethodId: "cash_nat",
+      storeName: "Mi Tienda",
+    });
+
+    const result = await sendPrinterCommands({
+      brand: "DTP",
+      model: "80i",
+      client,
+      commands,
+    });
+
+    return {
+      success: true,
+      invoiceRef: result.documentNumber ?? 0,
+    };
+  } finally {
+    client.close();
+  }
+}
 ```
 
 ## API
 
-### `aegPrinter`
+### Drivers
 
-Driver para impresora AEG-R1.
+| Driver | Modelo | Métodos |
+|--------|--------|---------|
+| `aegPrinter` | AEG-R1 | `buildInvoiceCommands`, `buildReceiptCommands` |
+| `dtpPrinter` | DTP-80i | `buildInvoiceCommands`, `buildReceiptCommands`, `buildCreditNoteCommands` |
 
-- `buildInvoiceCommands(order, options)` → comandos para factura fiscal
-- `buildReceiptCommands(options)` → comandos para recibo DNF
+### `sendPrinterCommands`
+
+Función unificada para enviar comandos a cualquier impresora.
+
+- **AEG**: `{ brand: "AEG", model: "R1", ip, commands }`
+- **DTP**: `{ brand: "DTP", model: "80i", client, commands }`
+
+Retorna:
+- AEG: `PrinterCommandResponse[]`
+- DTP: `{ documentNumber?: number; totalAmount?: number }`
+
+### Node.js y DTP
+
+Para usar DTP en Node.js (backend), importa `createNodeDtpConnection` del entry `node`:
+
+```ts
+import {
+  DtpClient,
+  dtpPrinter,
+  sendPrinterCommands,
+} from "@danielrebolledo/cafe-ipdh-lib";
+import {
+  createNodeDtpConnection,
+} from "@danielrebolledo/cafe-ipdh-lib/node";
+
+const client = new DtpClient({
+  host: "192.168.1.10",
+  port: 3010,
+  createConnection: createNodeDtpConnection,
+});
+await client.connect();
+
+const result = await sendPrinterCommands({
+  brand: "DTP",
+  model: "80i",
+  client,
+  commands: dtpPrinter.buildInvoiceCommands(order, opts),
+});
+```
 
 ### Tipos exportados
 
 - `Order`, `OrderItem`, `FiscalClient`, `OrderPayment`
-- `AegPrinterCommand`
-- `BuildInvoiceOptions`, `BuildReceiptOptions`
+- `AegPrinterCommand`, `DtpPrinterCommand`
+- `BuildInvoiceOptions`, `BuildReceiptOptions`, `BuildCreditNoteOptions`
+- `SendPrinterCommandsArgs`, `SendPrinterCommandsResult`
 - `PaymentMethodId`, `PrinterTaxValues`, `TaxValues`
 
 ## Scripts
 
 ```bash
-npm run build    # Compilar con tsup
-npm run dev      # Watch mode
-npm run lint     # Biome check
-npm run test     # Vitest
+npm run build    # Compilar
+npm run dev     # Watch mode
+npm run lint    # Biome
+npm run test    # Vitest
 ```
 
 ## Stack
 
 - TypeScript
-- tsup (bundle)
-- Biome (lint/format)
-- Vitest (tests)
+- tsup
+- Biome
+- Vitest

package/dist/{dtp-printer-driver-DV3x3OdX.d.cts → dtp-printer-driver-cgh_5rBr.d.cts}

@@ -70,6 +70,19 @@ interface BuildInvoiceOptions {
     paymentMethodId: "pos_credit" | "pos_debit" | "pos_debit_credit_int" | "cash_int" | "cash_nat";
     storeName?: string;
 }
+/**
+ * Opciones para construir comandos de nota de crédito.
+ */
+interface BuildCreditNoteOptions {
+    /** Número de la factura original que se está anulando. */
+    referenceInvoiceNumber: number;
+    /** Fecha de la factura original. */
+    referenceInvoiceDate: Date;
+    /** Serial fiscal de la factura original (opcional). */
+    referenceInvoiceSerial?: string;
+    paymentMethodId: "pos_credit" | "pos_debit" | "pos_debit_credit_int" | "cash_int" | "cash_nat";
+    storeName?: string;
+}
 /**
  * Opciones para construir comandos de recibo de pago.
  */
@@ -95,6 +108,10 @@ interface PrinterDriver<TCmd = unknown> {
      * Construye comandos para imprimir un recibo de pago (DNF).
      */
     buildReceiptCommands(options: BuildReceiptOptions): TCmd[];
+    /**
+     * Construye comandos para imprimir una nota de crédito fiscal (opcional).
+     */
+    buildCreditNoteCommands?(order: Order, options: BuildCreditNoteOptions): TCmd[];
 }
 
 /**
@@ -255,4 +272,4 @@ interface ExecuteDtpCommandsResult {
  */
 declare function executeDtpCommands(client: DtpClient, commands: DtpPrinterCommand[]): Promise<ExecuteDtpCommandsResult>;
 
-export { type BuildInvoiceOptions as B, type CreateDtpConnection as C, type DocumentType as D, type ExecuteDtpCommandsResult as E, type FiscalClient as F, type ItemTax as I, type Order as O, type PrinterDriver as P, type BuildReceiptOptions as a, DtpClient as b, type DtpOptions as c, type DtpPrinterCommand as d, type DtpSocketLike as e, type OrderItem as f, type OrderPayment as g, type PrinterCommandResponse as h, dtpPrinter as i, executeDtpCommands as j };
+export { type BuildCreditNoteOptions as B, type CreateDtpConnection as C, DtpClient as D, type ExecuteDtpCommandsResult as E, type FiscalClient as F, type ItemTax as I, type Order as O, type PrinterDriver as P, type DtpPrinterCommand as a, type BuildInvoiceOptions as b, type BuildReceiptOptions as c, type DocumentType as d, type DtpOptions as e, type DtpSocketLike as f, type OrderItem as g, type OrderPayment as h, type PrinterCommandResponse as i, dtpPrinter as j, executeDtpCommands as k };

package/dist/{dtp-printer-driver-DV3x3OdX.d.ts → dtp-printer-driver-cgh_5rBr.d.ts}

@@ -70,6 +70,19 @@ interface BuildInvoiceOptions {
     paymentMethodId: "pos_credit" | "pos_debit" | "pos_debit_credit_int" | "cash_int" | "cash_nat";
     storeName?: string;
 }
+/**
+ * Opciones para construir comandos de nota de crédito.
+ */
+interface BuildCreditNoteOptions {
+    /** Número de la factura original que se está anulando. */
+    referenceInvoiceNumber: number;
+    /** Fecha de la factura original. */
+    referenceInvoiceDate: Date;
+    /** Serial fiscal de la factura original (opcional). */
+    referenceInvoiceSerial?: string;
+    paymentMethodId: "pos_credit" | "pos_debit" | "pos_debit_credit_int" | "cash_int" | "cash_nat";
+    storeName?: string;
+}
 /**
  * Opciones para construir comandos de recibo de pago.
  */
@@ -95,6 +108,10 @@ interface PrinterDriver<TCmd = unknown> {
      * Construye comandos para imprimir un recibo de pago (DNF).
      */
     buildReceiptCommands(options: BuildReceiptOptions): TCmd[];
+    /**
+     * Construye comandos para imprimir una nota de crédito fiscal (opcional).
+     */
+    buildCreditNoteCommands?(order: Order, options: BuildCreditNoteOptions): TCmd[];
 }
 
 /**
@@ -255,4 +272,4 @@ interface ExecuteDtpCommandsResult {
  */
 declare function executeDtpCommands(client: DtpClient, commands: DtpPrinterCommand[]): Promise<ExecuteDtpCommandsResult>;
 
-export { type BuildInvoiceOptions as B, type CreateDtpConnection as C, type DocumentType as D, type ExecuteDtpCommandsResult as E, type FiscalClient as F, type ItemTax as I, type Order as O, type PrinterDriver as P, type BuildReceiptOptions as a, DtpClient as b, type DtpOptions as c, type DtpPrinterCommand as d, type DtpSocketLike as e, type OrderItem as f, type OrderPayment as g, type PrinterCommandResponse as h, dtpPrinter as i, executeDtpCommands as j };
+export { type BuildCreditNoteOptions as B, type CreateDtpConnection as C, DtpClient as D, type ExecuteDtpCommandsResult as E, type FiscalClient as F, type ItemTax as I, type Order as O, type PrinterDriver as P, type DtpPrinterCommand as a, type BuildInvoiceOptions as b, type BuildReceiptOptions as c, type DocumentType as d, type DtpOptions as e, type DtpSocketLike as f, type OrderItem as g, type OrderPayment as h, type PrinterCommandResponse as i, dtpPrinter as j, executeDtpCommands as k };

package/dist/index.cjs

@@ -666,6 +666,121 @@ var dtpPrinter = {
     commands.push({ cmd: "F5", data: {} });
     return commands;
   },
+  buildCreditNoteCommands(order, options) {
+    const commands = [];
+    if (!order) {
+      throw new Error("Order es requerido");
+    }
+    if (!order.client) {
+      throw new Error("Order debe tener un cliente asociado");
+    }
+    if (!order.items || order.items.length === 0) {
+      throw new Error("Order debe tener al menos un item");
+    }
+    const {
+      referenceInvoiceNumber,
+      referenceInvoiceDate,
+      referenceInvoiceSerial = "",
+      paymentMethodId,
+      storeName = "N/A"
+    } = options;
+    const clientName = order.client.name || "";
+    const clientRif = order.client.id || "";
+    const storeLine = `Tienda: ${storeName}`;
+    commands.push({
+      cmd: "F0",
+      data: {
+        iTipo: 1,
+        sNombreCliente: truncateString2(clientName, 64),
+        sRifCliente: truncateString2(clientRif, 20),
+        iFacturaReferencia: referenceInvoiceNumber,
+        fechaReferencia: referenceInvoiceDate,
+        sSerialReferencia: truncateString2(referenceInvoiceSerial, 20),
+        bLogo: false,
+        sLineaAdicional: truncateString2(storeLine, 64)
+      }
+    });
+    let subtotalWithoutTaxes = 0;
+    for (const item of order.items) {
+      if (!item.name) continue;
+      const taxId = item.taxes && item.taxes.length > 0 ? item.taxes[0].id : null;
+      const iImpuesto = mapTaxIdToDtpCode(taxId);
+      const price = item.price ?? 0;
+      const lPrecio = Math.round(Math.max(price, 0) * 100);
+      const quantity = item.selectedQuantity ?? item.quantity ?? 1;
+      const lCantidad = -Math.round(Math.max(quantity, 1) * 1e3);
+      subtotalWithoutTaxes += price * Math.max(quantity, 1);
+      commands.push({
+        cmd: "F1",
+        data: {
+          iTipo: 1,
+          sDescripcion: truncateString2(item.name, 64),
+          sCodigo: truncateString2(item.sku ?? "N/A", 20),
+          lCantidad,
+          sUnidad: "UND",
+          lPrecio,
+          iImpuesto,
+          iDecPrecio: 2,
+          iDecCantidad: 3
+        }
+      });
+    }
+    const isForeignCurrency = paymentMethodId === "pos_debit_credit_int" || paymentMethodId === "cash_int";
+    if (isForeignCurrency && subtotalWithoutTaxes > 0) {
+      const roundedSubtotal = Math.round((subtotalWithoutTaxes + Number.EPSILON) * 100) / 100;
+      const igtfPercentage = 3 /* BI_IGTF */ / 100;
+      const igtfAmount = Math.round((roundedSubtotal * igtfPercentage + Number.EPSILON) * 100) / 100;
+      commands.push({
+        cmd: "F1",
+        data: {
+          iTipo: 1,
+          sDescripcion: "IGTF 3% pago en divisas",
+          sCodigo: "IGTF",
+          lCantidad: -1e3,
+          sUnidad: "UND",
+          lPrecio: Math.round(igtfAmount * 100),
+          iImpuesto: 4,
+          iDecPrecio: 2,
+          iDecCantidad: 3
+        }
+      });
+    }
+    commands.push({
+      cmd: "F2",
+      data: { mode: 1, foreignCurrencyAmount: 0 }
+    });
+    if (!order.payments?.length) {
+      throw new Error("Order debe tener al menos un pago exitoso");
+    }
+    for (const payment of order.payments) {
+      const tipo = mapPaymentMethod2(payment.paymentMethod);
+      const lMonto = Math.round(payment.amount * 100);
+      const isForeign = payment.paymentMethod === "pos_debit_credit_int" || payment.paymentMethod === "cash_int";
+      if (isForeign) {
+        commands.push({
+          cmd: "F11",
+          data: {
+            iFormaPago: tipo,
+            sDescripcion: paymentMethodLabel(tipo),
+            lMonto,
+            lTasaCambio: 1,
+            sSimbolo: "USD"
+          }
+        });
+      } else {
+        commands.push({
+          cmd: "F4",
+          data: {
+            iFormaPago: tipo,
+            sDescripcion: paymentMethodLabel(tipo),
+            lMonto
+          }
+        });
+      }
+    }
+    commands.push({ cmd: "F5", data: {} });
+    return commands;
+  },
   buildReceiptCommands(options) {
     const {
       orderId,
@@ -803,9 +918,7 @@ async function sendPrinterCommands(args, options) {
           `Modelo inv\xE1lido para DTP: "${model}". Solo se soporta "80i".`
         );
       }
-      throw new Error(
-        "DTP-80i requiere el m\xF3dulo nativo ExpoDtpFiscalPrinter. Use la conexi\xF3n TCP directamente desde su aplicaci\xF3n."
-      );
+      return sendDtpCommands(args);
     default: {
       const _exhaustive = brand;
       throw new Error(
@@ -814,6 +927,10 @@ async function sendPrinterCommands(args, options) {
     }
   }
 }
+async function sendDtpCommands(args) {
+  const { client, commands } = args;
+  return executeDtpCommands(client, commands);
+}
 async function sendAegCommands(args, options) {
   const { ip, commands } = args;
   const baseUrl = normalizeBaseUrl(ip);