@danielrebolledo/cafe-ipdh-lib 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,386 @@
+/**
+ * Comandos JSON para impresora fiscal AEG-R1.
+ * Según documentación oficial AEG-R1.
+ */
+type AegPrinterCommand = {
+    cmd: "cliF";
+    data: {
+        rifCI: string;
+        razSoc: string[];
+        LineAd: string[];
+    };
+} | {
+    cmd: "proF";
+    data: {
+        imp: number;
+        pre: number;
+        cant: number;
+        des01: string;
+    };
+} | {
+    cmd: "subToF";
+    data: number;
+    valor: number;
+} | {
+    cmd: "fpaF";
+    data: {
+        tipo: number;
+        monto: number;
+        tasaConv: number;
+    };
+} | {
+    cmd: "endFac";
+    data: number;
+} | {
+    cmd: "encDNF";
+    data: [string, string];
+} | {
+    cmd: "txtDNF";
+    data: [string, string, string, string, string];
+} | {
+    cmd: "aperDNF";
+    data: string;
+} | {
+    cmd: "efeNorJuIzDNF";
+    data: string;
+} | {
+    cmd: "endDNF";
+    data: string;
+} | {
+    cmd: "encNC";
+    data: [string, string] | [string, string, string];
+} | {
+    cmd: "nroFacNC";
+    data: number;
+} | {
+    cmd: "fechFacNC";
+    data: string;
+} | {
+    cmd: "conSerNC";
+    data: string;
+} | {
+    cmd: "rifCiNC";
+    data: string;
+} | {
+    cmd: "razSocNC";
+    data: {
+        razSoc: string[];
+        LineAd: string[];
+    };
+} | {
+    cmd: "prodNC";
+    data: {
+        imp: number;
+        pre: number;
+        cant: number;
+        des01: string;
+    };
+} | {
+    cmd: "endPoNC";
+    data: number;
+} | {
+    cmd: "fpaNC";
+    data: {
+        tipo: number;
+        monto: number;
+        tasaConv: number;
+    };
+} | {
+    cmd: "endNC";
+    data: number;
+};
+
+/**
+ * Cliente para facturación fiscal.
+ * Interface mínima requerida para construir comandos de impresora.
+ */
+interface FiscalClient {
+    id: string;
+    name: string;
+    email?: string;
+    phone?: string;
+    address?: string;
+}
+/**
+ * Impuesto de un item (usado para mapeo a códigos de impresora).
+ * id puede ser null (ej: GraphQL ItemTax).
+ */
+interface ItemTax {
+    id: string | null;
+}
+/**
+ * Item de orden para facturación fiscal.
+ */
+interface OrderItem {
+    id: string;
+    name: string;
+    sku: string;
+    price: number;
+    quantity: number;
+    total: number;
+    taxes?: ItemTax[];
+    selectedQuantity?: number;
+}
+/**
+ * Pago completado de una orden.
+ */
+interface OrderPayment {
+    amount: number;
+    paymentMethod: string;
+    cardLast4?: string;
+}
+/**
+ * Orden para facturación.
+ * Interface mínima para construir comandos de impresora.
+ */
+interface Order {
+    items: OrderItem[];
+    payments: OrderPayment[];
+    total: number;
+    client: FiscalClient | null;
+    status?: "pending" | "completed" | "canceled" | null;
+}
+
+/**
+ * Tipo de documento a imprimir.
+ */
+type DocumentType = "invoice" | "receipt" | "credit_note";
+/**
+ * Resultado de envío de comandos a una impresora.
+ */
+interface PrinterCommandResponse$1 {
+    cmd: string;
+    code: number;
+    dataD?: number;
+    dataS?: Record<string, unknown>;
+    message?: string;
+}
+/**
+ * Opciones para construir comandos de factura.
+ */
+interface BuildInvoiceOptions {
+    paymentMethodId: "pos_credit" | "pos_debit" | "pos_debit_credit_int" | "cash_int" | "cash_nat";
+    storeName?: string;
+}
+/**
+ * Opciones para construir comandos de recibo de pago.
+ */
+interface BuildReceiptOptions {
+    orderId: string;
+    amountPaid: number;
+    paymentMethod: string;
+    organizationName?: string;
+    paidAt?: Date;
+    cardLast4?: string | null;
+}
+/**
+ * Interface abstracta para un driver de impresora.
+ * Cada modelo (AEG-R1, DTP, etc.) implementa esta interface.
+ */
+interface PrinterDriver<TCmd = unknown> {
+    readonly model: string;
+    /**
+     * Construye comandos para imprimir una factura fiscal.
+     */
+    buildInvoiceCommands(order: Order, options: BuildInvoiceOptions): TCmd[];
+    /**
+     * Construye comandos para imprimir un recibo de pago (DNF).
+     */
+    buildReceiptCommands(options: BuildReceiptOptions): TCmd[];
+}
+
+/**
+ * Driver para impresora fiscal AEG-R1.
+ * Construye comandos JSON según documentación oficial.
+ */
+declare const aegPrinter: PrinterDriver<AegPrinterCommand>;
+
+type AbrirCfArgs = {
+    iTipo?: number;
+    sNombreCliente: string;
+    sRifCliente: string;
+    iFacturaReferencia?: number;
+    fechaReferencia?: Date;
+    sSerialReferencia?: string;
+    bLogo?: boolean;
+    sLineaAdicional?: string;
+};
+type ItemCfArgs = {
+    iTipo?: number;
+    sDescripcion: string;
+    sCodigo: string;
+    lCantidad: number;
+    sUnidad: string;
+    lPrecio: number;
+    iImpuesto: number;
+    iDecPrecio: number;
+    iDecCantidad: number;
+};
+type PagoCfArgs = {
+    iTipoPago?: number;
+    iFormaPago: number;
+    sDescripcion: string;
+    lMonto: number;
+};
+
+/**
+ * Comandos para impresora fiscal DTP-80i.
+ * Cada comando se ejecuta secuencialmente contra un DtpClient.
+ */
+type DtpPrinterCommand = {
+    cmd: "F0";
+    data: AbrirCfArgs;
+} | {
+    cmd: "F1";
+    data: ItemCfArgs;
+} | {
+    cmd: "F2";
+    data: {
+        mode?: number;
+        foreignCurrencyAmount?: number;
+    };
+} | {
+    cmd: "F4";
+    data: PagoCfArgs;
+} | {
+    cmd: "F5";
+    data?: {
+        additionalLine?: string;
+    };
+} | {
+    cmd: "F11";
+    data: {
+        iFormaPago: number;
+        sDescripcion: string;
+        lMonto: number;
+        lTasaCambio: number;
+        sSimbolo: string;
+    };
+} | {
+    cmd: "N0";
+} | {
+    cmd: "N1";
+    data: {
+        line: string;
+        size?: number;
+        align?: number;
+        style?: number;
+    };
+} | {
+    cmd: "N3";
+};
+
+/**
+ * Resultado de ejecutar comandos DTP.
+ * Incluye documentNumber y totalAmount cuando el último comando es F5 (cerrar factura).
+ */
+interface ExecuteDtpCommandsResult {
+    documentNumber?: number;
+    totalAmount?: number;
+}
+
+/**
+ * Marcas de impresoras soportadas.
+ */
+type PrinterBrand = "AEG" | "DTP";
+/**
+ * Modelos por marca.
+ * AEG: R1 (impresora fiscal HTTP)
+ * DTP: 80i (impresora fiscal TCP - requiere módulo nativo)
+ */
+type AegModel = "R1";
+type DtpModel = "80i";
+/**
+ * Argumentos para AEG-R1.
+ * Usa comandos JSON sobre HTTP POST a /cmdoJson.
+ */
+interface SendPrinterCommandsAeg {
+    brand: "AEG";
+    model: AegModel;
+    ip: string;
+    commands: AegPrinterCommand[];
+}
+/**
+ * Argumentos para DTP-80i.
+ * DTP usa TCP vía módulo nativo - el envío desde esta librería
+ * no está soportado. El consumidor debe usar ExpoDtpFiscalPrinter.
+ */
+interface SendPrinterCommandsDtp {
+    brand: "DTP";
+    model: DtpModel;
+    ip: string;
+    commands: unknown[];
+}
+/**
+ * Argumentos de sendPrinterCommands.
+ * Discriminados por brand para validar model.
+ */
+type SendPrinterCommandsArgs = SendPrinterCommandsAeg | SendPrinterCommandsDtp;
+/**
+ * Respuesta de un comando de impresora.
+ */
+interface PrinterCommandResponse {
+    cmd: string;
+    code: number;
+    dataD?: number;
+    dataS?: Record<string, unknown>;
+    message?: string;
+}
+type PrinterResponse = PrinterCommandResponse[];
+
+/**
+ * Envía comandos a una impresora fiscal.
+ *
+ * - **AEG-R1**: POST HTTP a {ip}/cmdoJson con body = commands (JSON)
+ * - **DTP-80i**: No soportado en esta librería (usa TCP vía módulo nativo).
+ *   El consumidor debe usar ExpoDtpFiscalPrinter directamente.
+ */
+declare function sendPrinterCommands(args: SendPrinterCommandsArgs, options?: {
+    timeout?: number;
+}): Promise<PrinterResponse>;
+
+/**
+ * Valores de impuestos (porcentajes) según legislación venezolana.
+ */
+declare enum TaxValues {
+    EXENTO_E = 0,
+    BI_G = 16,
+    IVA_G = 16,
+    BI_R = 8,
+    IVA_R = 8,
+    BI_A = 31,
+    IVA_A = 31,
+    PERCIBIDO = 0,
+    BI_IGTF = 3,
+    IVA_IGTF = 3
+}
+/**
+ * Códigos de impuesto para impresora fiscal AEG-R1.
+ */
+declare enum PrinterTaxValues {
+    EXENTO_E = 1,
+    BI_G = 2,
+    IVA_G = 2,
+    BI_R = 3,
+    IVA_R = 3,
+    BI_A = 4,
+    IVA_A = 4,
+    PERCIBIDO = 5,
+    BI_IGTF = 5,
+    IVA_IGTF = 5
+}
+/**
+ * IDs de método de pago para impresora fiscal AEG-R1.
+ * Efectivo: 1, Débito: 2, Crédito: 3, Pago Móvil: 5,
+ * Débito/Crédito int: 11, Efectivo int: 12
+ */
+declare enum PaymentMethodId {
+    CASH = 1,
+    POS_DEBIT = 2,
+    POS_CREDIT = 3,
+    PAGO_MOVIL = 5,
+    POS_DEBIT_CREDIT_INT = 11,
+    CASH_INT = 12
+}
+
+export { type AegModel, type AegPrinterCommand, type BuildInvoiceOptions, type BuildReceiptOptions, type DocumentType, type DtpModel, type DtpPrinterCommand, type ExecuteDtpCommandsResult, type FiscalClient, type ItemTax, type Order, type OrderItem, type OrderPayment, PaymentMethodId, type PrinterBrand, type PrinterCommandResponse$1 as PrinterCommandResponse, type PrinterDriver, PrinterTaxValues, type SendPrinterCommandsAeg, type SendPrinterCommandsArgs, type SendPrinterCommandsDtp, TaxValues, aegPrinter, sendPrinterCommands };