@arcasdk/pdf 0.2.0

package/lib/types/invoice-data.types.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Datos del emisor (quien emite la factura)
+ */
+export interface EmisorData {
+    razonSocial: string;
+    domicilioComercial: string;
+    condicionIva: string;
+    cuit: string;
+    iibb: string;
+    fechaInicioActividades: string;
+    /** Contacto del emisor (email, web, teléfono) */
+    contacto?: string;
+}
+/**
+ * Datos del receptor (a quien va dirigida la factura)
+ */
+export interface ReceptorData {
+    razonSocial: string;
+    domicilio?: string;
+    condicionIva: string;
+    documentoTipo: string;
+    documentoNro: string;
+    /** CUIT del país destino con descripción (ej: "55000002126 (ESTADOS UNIDOS - Persona Jurídica)") */
+    cuitPais?: string;
+    /** ID impositivo del receptor en el país destino */
+    idImpositivo?: string;
+}
+/**
+ * Item individual de la factura
+ */
+export interface InvoiceItem {
+    codigo?: string;
+    descripcion: string;
+    cantidad: number;
+    unidadMedida: string;
+    precioUnitario: number;
+    bonificacion?: number;
+    /** Importe de bonificación pre-calculado. Si no se provee, se calcula como precioUnitario * cantidad * (bonificacion / 100) */
+    importeBonificacion?: number;
+    subtotal: number;
+    alicuotaIva?: number;
+}
+/**
+ * Detalle de alícuota de IVA
+ */
+export interface IvaDetail {
+    id: number;
+    descripcion: string;
+    baseImponible: number;
+    importe: number;
+}
+/**
+ * Detalle de otros tributos
+ */
+export interface TributoDetail {
+    id: number;
+    descripcion: string;
+    baseImponible: number;
+    alicuota: number;
+    importe: number;
+}
+/**
+ * Comprobante asociado
+ */
+export interface ComprobanteAsociado {
+    tipo: number;
+    puntoVenta: number;
+    numero: number;
+    cuit?: string;
+    fecha?: string;
+}
+/**
+ * Datos del comprobante electrónico para generar el PDF
+ * Independiente del package core - se puede construir manualmente
+ * o mapeando datos desde @arcasdk/core
+ */
+export interface InvoiceData {
+    /** Datos del emisor */
+    emisor: EmisorData;
+    /** Datos del receptor */
+    receptor: ReceptorData;
+    /** Tipo de comprobante (ej: 1=Factura A, 6=Factura B, 11=Factura C) */
+    cbteTipo: number;
+    /** Descripción del tipo de comprobante (ej: "FACTURA") */
+    cbteDescripcion?: string;
+    /** Letra del comprobante (A, B, C, etc) */
+    cbteLetra: string;
+    /** Punto de venta */
+    puntoVenta: number;
+    /** Número de comprobante desde */
+    cbteDesde: number;
+    /** Número de comprobante hasta */
+    cbteHasta: number;
+    /** Fecha del comprobante (formato YYYY-MM-DD o YYYYMMDD) */
+    cbteFecha: string;
+    /** Concepto: 1=Productos, 2=Servicios, 3=Productos y Servicios */
+    concepto: number;
+    /** Moneda (ej: "PES" para pesos argentinos) */
+    moneda?: string;
+    /** Cotización de la moneda */
+    cotizacion?: number;
+    /** Condición de venta (ej: "Contado", "Cuenta Corriente") */
+    condicionVenta?: string;
+    /** Fecha desde del servicio (para conceptos 2 y 3) */
+    fechaServicioDesde?: string;
+    /** Fecha hasta del servicio (para conceptos 2 y 3) */
+    fechaServicioHasta?: string;
+    /** Fecha de vencimiento de pago (para conceptos 2 y 3) */
+    fechaVtoPago?: string;
+    /** Items de la factura */
+    items: InvoiceItem[];
+    /** Importe neto gravado */
+    importeNetoGravado: number;
+    /** Importe neto no gravado */
+    importeNetoNoGravado?: number;
+    /** Importe exento */
+    importeExento?: number;
+    /** Detalle de IVA por alícuota */
+    iva?: IvaDetail[];
+    /** Importe total de IVA */
+    importeIva: number;
+    /** Detalle de otros tributos */
+    tributos?: TributoDetail[];
+    /** Importe total de otros tributos */
+    importeTributos?: number;
+    /** Importe total */
+    importeTotal: number;
+    /** CAE (Código de Autorización Electrónico) */
+    cae: string;
+    /** Fecha de vencimiento del CAE (formato YYYY-MM-DD o YYYYMMDD) */
+    caeFechaVencimiento: string;
+    /** Comprobantes asociados */
+    cbtesAsociados?: ComprobanteAsociado[];
+    /** Observaciones */
+    observaciones?: string;
+    /** Divisa con descripción completa (ej: "USD - Dólar Estadounidense") */
+    divisa?: string;
+    /** País destino del comprobante */
+    destinoComprobante?: string;
+    /** Forma de pago (ej: "Transferencia SWIFT - Moneda Extranjera") */
+    formaPago?: string;
+    /** Incoterms */
+    incoterms?: string;
+    /** Fecha de pago (formato YYYYMMDD) */
+    fechaPago?: string;
+    /** Leyenda de condición IVA en exportación (ej: "IVA EXENTO OPERACIÓN DE EXPORTACIÓN") */
+    condicionIvaExportacion?: string;
+    /** Importe total expresado en pesos argentinos (para comprobantes en moneda extranjera).
+     *  Si no se provee, se calcula como importeTotal * cotizacion */
+    importeTotalPesos?: number;
+}
+/**
+ * Props recibidas por cualquier template de factura.
+ * Implementar este contrato para crear templates personalizados.
+ */
+export interface InvoiceTemplateProps {
+    data: InvoiceData;
+    options: ResolvedPdfOptions;
+    /** Data URL del QR code ya generado (undefined si includeQr=false) */
+    qrDataUrl?: string;
+}
+/**
+ * Opciones resueltas (con defaults aplicados) que recibe el template.
+ */
+export type CopyType = "ORIGINAL" | "DUPLICADO" | "TRIPLICADO" | "CUADRUPLICADO";
+export interface ResolvedPdfOptions {
+    pageSize: "A4" | "LETTER" | "LEGAL";
+    margin: number;
+    includeQr: boolean;
+    logo?: string;
+    logoWidth?: number;
+    footerText?: string;
+    copy?: CopyType;
+    copies?: CopyType[];
+}
+/**
+ * Opciones de configuración para la generación del PDF
+ */
+export interface PdfGeneratorOptions {
+    /** Tamaño de página (default: "A4") */
+    pageSize?: "A4" | "LETTER" | "LEGAL";
+    /** Márgenes en puntos (default: 10) */
+    margin?: number;
+    /** Incluir QR code de ARCA (default: true) */
+    includeQr?: boolean;
+    /** Logo del emisor como data URL (ej: "data:image/png;base64,...") */
+    logo?: string;
+    /** Ancho del logo en puntos (default: 60) */
+    logoWidth?: number;
+    /** Texto adicional en el pie de página */
+    footerText?: string;
+    /** Banner de copia individual: "ORIGINAL" | "DUPLICADO" | "TRIPLICADO" | "CUADRUPLICADO" */
+    copy?: CopyType;
+    /**
+     * Generar múltiples copias en un solo PDF.
+     * Cada entrada genera una copia completa con su banner.
+     * Si se provee, ignora `copy`.
+     *
+     * @example
+     * copies: ["ORIGINAL", "DUPLICADO", "TRIPLICADO"]
+     */
+    copies?: CopyType[];
+    /**
+     * Template personalizado. Puede ser:
+     * - Una función que reciba InvoiceTemplateProps y retorne HTML string
+     * - Un string con template Handlebars (se compila automáticamente)
+     *
+     * Los templates Handlebars tienen acceso a helpers integrados:
+     * formatDate, formatCuit, formatCurrency, formatUnitPrice,
+     * voucherNumber, descTipo, numberToWords, currencyName, etc.
+     *
+     * @example
+     * // Como función
+     * const generator = new InvoicePdfGenerator({
+     *   template: ({ data }) => `<h1>${data.emisor.razonSocial}</h1>`,
+     * });
+     *
+     * @example
+     * // Como template Handlebars
+     * const generator = new InvoicePdfGenerator({
+     *   template: "<h1>{{data.emisor.razonSocial}}</h1>",
+     * });
+     */
+    template?: ((props: InvoiceTemplateProps) => string) | string;
+}

package/lib/types/invoice-data.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=invoice-data.types.js.map

package/lib/types/invoice-data.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-data.types.js","sourceRoot":"","sources":["../../src/types/invoice-data.types.ts"],"names":[],"mappings":""}

package/lib/utils/format.utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Formatea una fecha de YYYYMMDD o YYYY-MM-DD a DD/MM/YYYY
+ */
+export declare function formatDate(date: string): string;
+/**
+ * Formatea un número de comprobante con ceros a la izquierda
+ */
+export declare function formatVoucherNumber(puntoVenta: number, numero: number): string;
+/**
+ * Formatea un CUIT con guiones: XX-XXXXXXXX-X
+ */
+export declare function formatCuit(cuit: string): string;
+/**
+ * Formatea un monto como moneda con separador de miles
+ * Ejemplo: 1234567.89 -> "$ 1.234.567,89"
+ */
+export declare function formatCurrency(amount: number, monedaId?: string): string;
+/**
+ * Formatea un número con separador de miles (.) y decimales (,)
+ * Formato argentino: 1.234.567,89
+ */
+export declare function formatNumber(value: number): string;

package/lib/utils/format.utils.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = formatDate;
+exports.formatVoucherNumber = formatVoucherNumber;
+exports.formatCuit = formatCuit;
+exports.formatCurrency = formatCurrency;
+exports.formatNumber = formatNumber;
+const voucher_constants_1 = require("../constants/voucher.constants");
+/**
+ * Formatea una fecha de YYYYMMDD o YYYY-MM-DD a DD/MM/YYYY
+ */
+function formatDate(date) {
+    const clean = date.replace(/-/g, "");
+    if (clean.length !== 8)
+        return date;
+    const day = clean.substring(6, 8);
+    const month = clean.substring(4, 6);
+    const year = clean.substring(0, 4);
+    return `${day}/${month}/${year}`;
+}
+/**
+ * Formatea un número de comprobante con ceros a la izquierda
+ */
+function formatVoucherNumber(puntoVenta, numero) {
+    const pv = String(puntoVenta).padStart(5, "0");
+    const nro = String(numero).padStart(8, "0");
+    return `${pv}-${nro}`;
+}
+/**
+ * Formatea un CUIT con guiones: XX-XXXXXXXX-X
+ */
+function formatCuit(cuit) {
+    const clean = cuit.replace(/-/g, "");
+    if (clean.length !== 11)
+        return cuit;
+    return `${clean.substring(0, 2)}-${clean.substring(2, 10)}-${clean.substring(10)}`;
+}
+/**
+ * Formatea un monto como moneda con separador de miles
+ * Ejemplo: 1234567.89 -> "$ 1.234.567,89"
+ */
+function formatCurrency(amount, monedaId) {
+    const symbol = (monedaId && voucher_constants_1.CURRENCY_SYMBOL[monedaId]) || "$";
+    const formatted = formatNumber(amount);
+    return `${symbol}\u00a0${formatted}`;
+}
+/**
+ * Formatea un número con separador de miles (.) y decimales (,)
+ * Formato argentino: 1.234.567,89
+ */
+function formatNumber(value) {
+    const [intPart, decPart] = value.toFixed(2).split(".");
+    const withDots = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, ".");
+    return `${withDots},${decPart}`;
+}
+//# sourceMappingURL=format.utils.js.map

package/lib/utils/format.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.utils.js","sourceRoot":"","sources":["../../src/utils/format.utils.ts"],"names":[],"mappings":";;AAKA,gCAOC;AAKD,kDAOC;AAKD,gCAIC;AAMD,wCAIC;AAMD,oCAIC;AArDD,wEAAmE;AAEnE;;GAEG;AACH,SAAgB,UAAU,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,GAAG,GAAG,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,UAAkB,EAClB,MAAc;IAEd,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;AACrF,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,MAAc,EAAE,QAAiB;IAC9D,MAAM,MAAM,GAAG,CAAC,QAAQ,IAAI,mCAAe,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC;IAC9D,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,GAAG,MAAM,SAAS,SAAS,EAAE,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;IAC/D,OAAO,GAAG,QAAQ,IAAI,OAAO,EAAE,CAAC;AAClC,CAAC"}

package/lib/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./format.utils";
+export * from "./qr.utils";
+export * from "./number-to-words.utils";

package/lib/utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./format.utils"), exports);
+__exportStar(require("./qr.utils"), exports);
+__exportStar(require("./number-to-words.utils"), exports);
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,6CAA2B;AAC3B,0DAAwC"}

package/lib/utils/number-to-words.utils.d.ts

@@ -0,0 +1 @@
+export declare function numberToWords(n: number): string;

package/lib/utils/number-to-words.utils.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.numberToWords = numberToWords;
+const UNITS = [
+    "",
+    "un",
+    "dos",
+    "tres",
+    "cuatro",
+    "cinco",
+    "seis",
+    "siete",
+    "ocho",
+    "nueve",
+    "diez",
+    "once",
+    "doce",
+    "trece",
+    "catorce",
+    "quince",
+    "dieciséis",
+    "diecisiete",
+    "dieciocho",
+    "diecinueve",
+    "veinte",
+    "veintiún",
+    "veintidós",
+    "veintitrés",
+    "veinticuatro",
+    "veinticinco",
+    "veintiséis",
+    "veintisiete",
+    "veintiocho",
+    "veintinueve",
+];
+const TENS = [
+    "",
+    "",
+    "",
+    "treinta",
+    "cuarenta",
+    "cincuenta",
+    "sesenta",
+    "setenta",
+    "ochenta",
+    "noventa",
+];
+const HUNDREDS = [
+    "",
+    "ciento",
+    "doscientos",
+    "trescientos",
+    "cuatrocientos",
+    "quinientos",
+    "seiscientos",
+    "setecientos",
+    "ochocientos",
+    "novecientos",
+];
+function intToWords(n) {
+    if (n === 0)
+        return "cero";
+    if (n < 30)
+        return UNITS[n];
+    if (n < 100) {
+        const t = Math.floor(n / 10);
+        const u = n % 10;
+        return u === 0 ? TENS[t] : `${TENS[t]} y ${UNITS[u]}`;
+    }
+    if (n === 100)
+        return "cien";
+    if (n < 1000) {
+        const h = Math.floor(n / 100);
+        const r = n % 100;
+        return r === 0 ? HUNDREDS[h] : `${HUNDREDS[h]} ${intToWords(r)}`;
+    }
+    if (n < 1000000) {
+        const thou = Math.floor(n / 1000);
+        const r = n % 1000;
+        const s = thou === 1 ? "mil" : `${intToWords(thou)} mil`;
+        return r === 0 ? s : `${s} ${intToWords(r)}`;
+    }
+    if (n < 1000000000) {
+        const mill = Math.floor(n / 1000000);
+        const r = n % 1000000;
+        const s = mill === 1 ? "un millón" : `${intToWords(mill)} millones`;
+        return r === 0 ? s : `${s} ${intToWords(r)}`;
+    }
+    return String(n);
+}
+function numberToWords(n) {
+    const cents = Math.round((n % 1) * 100);
+    const integer = Math.floor(n);
+    const centStr = `${String(cents).padStart(2, "0")}/100`;
+    if (integer === 0)
+        return `CERO CON ${centStr}`;
+    return `${intToWords(integer).toUpperCase()} CON ${centStr}`;
+}
+//# sourceMappingURL=number-to-words.utils.js.map

package/lib/utils/number-to-words.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-to-words.utils.js","sourceRoot":"","sources":["../../src/utils/number-to-words.utils.ts"],"names":[],"mappings":";;AAwFA,sCAMC;AA9FD,MAAM,KAAK,GAAG;IACZ,EAAE;IACF,IAAI;IACJ,KAAK;IACL,MAAM;IACN,QAAQ;IACR,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;IACT,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,WAAW;IACX,YAAY;IACZ,cAAc;IACd,aAAa;IACb,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,aAAa;CACd,CAAC;AAEF,MAAM,IAAI,GAAG;IACX,EAAE;IACF,EAAE;IACF,EAAE;IACF,SAAS;IACT,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,MAAM,QAAQ,GAAG;IACf,EAAE;IACF,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,eAAe;IACf,YAAY;IACZ,aAAa;IACb,aAAa;IACb,aAAa;IACb,aAAa;CACd,CAAC;AAEF,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IAC7B,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,GAAG,OAAS,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;QACzD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,GAAG,UAAa,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,OAAS,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,GAAG,OAAS,CAAC;QACxB,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC;QACpE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,SAAgB,aAAa,CAAC,CAAS;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC;IACxD,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,YAAY,OAAO,EAAE,CAAC;IAChD,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,QAAQ,OAAO,EAAE,CAAC;AAC/D,CAAC"}

package/lib/utils/qr.utils.d.ts

@@ -0,0 +1,8 @@
+import { InvoiceData } from "../types/invoice-data.types";
+/**
+ * Genera la URL del QR de ARCA para un comprobante electrónico.
+ * El QR codifica los datos del comprobante en base64 como parámetro de la URL.
+ *
+ * @see https://www.afip.gob.ar/fe/qr/especificaciones.asp
+ */
+export declare function buildArcaQrUrl(data: InvoiceData): string;

package/lib/utils/qr.utils.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildArcaQrUrl = buildArcaQrUrl;
+const ARCA_QR_BASE_URL = "https://www.afip.gob.ar/fe/qr/";
+/**
+ * Genera la URL del QR de ARCA para un comprobante electrónico.
+ * El QR codifica los datos del comprobante en base64 como parámetro de la URL.
+ *
+ * @see https://www.afip.gob.ar/fe/qr/especificaciones.asp
+ */
+function buildArcaQrUrl(data) {
+    const cuitEmisor = data.emisor.cuit.replace(/-/g, "");
+    const cuitReceptor = data.receptor.documentoNro.replace(/-/g, "");
+    const fecha = normalizeDate(data.cbteFecha);
+    const qrData = {
+        ver: 1,
+        fecha,
+        cuit: Number(cuitEmisor),
+        ptoVta: data.puntoVenta,
+        tipoCmp: data.cbteTipo,
+        nroCmp: data.cbteDesde,
+        importe: data.importeTotal,
+        moneda: data.moneda || "PES",
+        ctz: data.cotizacion || 1,
+        tipoDocRec: getDocTipoNumber(data.receptor.documentoTipo),
+        nroDocRec: Number(cuitReceptor) || 0,
+        tipoCodAut: "E",
+        codAut: Number(data.cae),
+    };
+    const jsonStr = JSON.stringify(qrData);
+    const base64 = Buffer.from(jsonStr).toString("base64");
+    return `${ARCA_QR_BASE_URL}?p=${base64}`;
+}
+function normalizeDate(date) {
+    const clean = date.replace(/-/g, "");
+    if (clean.length !== 8)
+        return date;
+    return `${clean.substring(0, 4)}-${clean.substring(4, 6)}-${clean.substring(6, 8)}`;
+}
+function getDocTipoNumber(docTipo) {
+    var _a;
+    const mapping = {
+        CUIT: 80,
+        CUIL: 86,
+        CDI: 87,
+        DNI: 96,
+        LE: 89,
+        LC: 90,
+        "CI Extranjera": 91,
+        Pasaporte: 94,
+        "CI Buenos Aires": 0,
+        "Sin Identificar": 99,
+    };
+    return (_a = mapping[docTipo]) !== null && _a !== void 0 ? _a : (Number(docTipo) || 99);
+}
+//# sourceMappingURL=qr.utils.js.map

package/lib/utils/qr.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.utils.js","sourceRoot":"","sources":["../../src/utils/qr.utils.ts"],"names":[],"mappings":";;AAUA,wCAyBC;AAjCD,MAAM,gBAAgB,GAAG,gCAAgC,CAAC;AAE1D;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,IAAiB;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE5C,MAAM,MAAM,GAAG;QACb,GAAG,EAAE,CAAC;QACN,KAAK;QACL,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC;QACxB,MAAM,EAAE,IAAI,CAAC,UAAU;QACvB,OAAO,EAAE,IAAI,CAAC,QAAQ;QACtB,MAAM,EAAE,IAAI,CAAC,SAAS;QACtB,OAAO,EAAE,IAAI,CAAC,YAAY;QAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK;QAC5B,GAAG,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;QACzB,UAAU,EAAE,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QACzD,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;QACpC,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;KACzB,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEvD,OAAO,GAAG,gBAAgB,MAAM,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;;IACvC,MAAM,OAAO,GAA2B;QACtC,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,EAAE;QACR,GAAG,EAAE,EAAE;QACP,GAAG,EAAE,EAAE;QACP,EAAE,EAAE,EAAE;QACN,EAAE,EAAE,EAAE;QACN,eAAe,EAAE,EAAE;QACnB,SAAS,EAAE,EAAE;QACb,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,EAAE;KACtB,CAAC;IACF,OAAO,MAAA,OAAO,CAAC,OAAO,CAAC,mCAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@arcasdk/pdf",
+  "version": "0.2.0",
+  "description": "Arca TypeScript SDK - PDF invoice generator for ARCA electronic billing",
+  "source": "src/index.ts",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "scripts": {
+    "build": "npx tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && rsync -a --include='*/' --include='*.hbs' --exclude='*' src/ lib/",
+    "test": "jest --config jest.config.js",
+    "test:unit": "jest --config jest.config.js",
+    "test:coverage": "jest --config jest.config.js --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "handlebars": "^4.7.9",
+    "html2pdf.js": "^0.14.0",
+    "jsdom": "^29.1.1",
+    "pdf-lib": "^1.17.1",
+    "puppeteer": "^24.43.1",
+    "qrcode": "^1.5.4"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.0.0",
+    "@types/handlebars": "^4.0.40",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.10.1",
+    "@types/qrcode": "^1.5.5",
+    "jest": "^30.0.0",
+    "ts-jest": "^29.0.0",
+    "ts-node": "^10.9.1",
+    "tsc-alias": "^1.8.16",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^6.0.3"
+  },
+  "author": "valiuLab",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ralcorta/arcasdk.git",
+    "directory": "packages/pdf"
+  },
+  "bugs": {
+    "url": "https://github.com/ralcorta/arcasdk/issues"
+  },
+  "homepage": "https://github.com/ralcorta/arcasdk#readme",
+  "files": [
+    "lib/**/*"
+  ],
+  "keywords": [
+    "factura-electronica",
+    "pdf",
+    "arca",
+    "afip",
+    "invoice",
+    "comprobante"
+  ]
+}