@linkiez/boleto-sdk 1.1.0 → 1.1.4

package/dist/generators/pdf/PdfRenderer.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderBoletoToPdf = renderBoletoToPdf;
+const BarcodeRenderer_1 = require("../barcode/BarcodeRenderer");
+const formatters_1 = require("../../utils/formatters");
+const PixPayloadValidator_1 = require("../qrcode/PixPayloadValidator");
+const QRCodeRenderer_1 = require("../qrcode/QRCodeRenderer");
+const PdfTemplate_1 = require("./PdfTemplate");
+const PIX_QR_SIZE = 120;
+async function renderBoletoToPdf(document, data, options, dependencies = {}) {
+    const { showInstructions, showAdditionalInfo } = (0, PdfTemplate_1.derivePdfLayoutFlags)(options.layout);
+    const fonts = dependencies.fonts;
+    setBoldFont(document, fonts);
+    document.fontSize(18).text(options.title, { align: 'center' });
+    document.moveDown();
+    setRegularFont(document, fonts);
+    document.fontSize(12).text(`Banco: ${data.bank.code} - ${data.bank.name}`);
+    document.text(`Beneficiário: ${data.beneficiary.name}`);
+    document.text(`Pagador: ${data.payer.name}`);
+    document.text(`Valor: ${(0, formatters_1.formatMoney)(data.payment.amount)}`);
+    document.text(`Vencimento: ${formatDateIso(data.payment.dueDate)}`);
+    document.moveDown();
+    setMonoFont(document, fonts);
+    document.fontSize(11).text(`Linha digitável: ${data.payment.digitableLine}`);
+    if (options.includeBarcode && data.payment.barcode) {
+        const barcodeRenderer = dependencies.renderBarcodePng ?? BarcodeRenderer_1.renderI2of5Png;
+        const barcodePng = barcodeRenderer(data.payment.barcode);
+        document.image(barcodePng, {
+            width: options.barcode.width,
+            height: options.barcode.height,
+        });
+    }
+    else {
+        document.fontSize(9).text(`Código de barras: ${data.payment.barcode}`);
+    }
+    document.moveDown();
+    if (showInstructions) {
+        setBoldFont(document, fonts);
+        document.fontSize(12).text('Instruções', { underline: true });
+        if (data.instructions && data.instructions.length > 0) {
+            data.instructions.forEach((instruction) => {
+                setRegularFont(document, fonts);
+                document.fontSize(10).text(`- ${instruction}`);
+            });
+        }
+        else {
+            setRegularFont(document, fonts);
+            document.fontSize(10).text('Sem instruções');
+        }
+        document.moveDown();
+    }
+    if (showAdditionalInfo) {
+        setBoldFont(document, fonts);
+        document.fontSize(12).text('Informações adicionais', { underline: true });
+        const additionalInfo = data.additionalInfo ?? {};
+        const entries = Object.entries(additionalInfo);
+        if (entries.length > 0) {
+            entries.forEach(([key, value]) => {
+                setRegularFont(document, fonts);
+                document.fontSize(10).text(`${key}: ${value}`);
+            });
+        }
+        else {
+            setRegularFont(document, fonts);
+            document.fontSize(10).text('Sem informações adicionais');
+        }
+        document.moveDown();
+    }
+    if (!options.includePixQr || !data.payment.pix?.payload) {
+        return;
+    }
+    setBoldFont(document, fonts);
+    document.fontSize(12).text('PIX', { underline: true });
+    setMonoFont(document, fonts);
+    document.fontSize(9).text(data.payment.pix.payload);
+    (0, PixPayloadValidator_1.validatePixPayload)(data.payment.pix.payload);
+    const qrRenderer = dependencies.renderPixQrCodePng ?? QRCodeRenderer_1.renderPixQrCodePng;
+    const qrPng = await qrRenderer(data.payment.pix.payload, {
+        width: PIX_QR_SIZE,
+        margin: 1,
+    });
+    document.image(qrPng, {
+        width: PIX_QR_SIZE,
+        height: PIX_QR_SIZE,
+    });
+}
+function formatDateIso(value) {
+    return value.toISOString().slice(0, 10);
+}
+function setRegularFont(document, fonts) {
+    document.font(fonts?.regular ?? 'Helvetica');
+}
+function setBoldFont(document, fonts) {
+    document.font(fonts?.bold ?? 'Helvetica-Bold');
+}
+function setMonoFont(document, fonts) {
+    document.font(fonts?.mono ?? 'Courier');
+}
+//# sourceMappingURL=PdfRenderer.js.map

package/dist/generators/pdf/PdfRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdfRenderer.js","sourceRoot":"","sources":["../../../src/generators/pdf/PdfRenderer.ts"],"names":[],"mappings":"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"}

package/dist/generators/pdf/PdfTemplate.d.ts

@@ -0,0 +1,59 @@
+export type PdfLayout = 'simple' | 'instructions' | 'detailed';
+export interface PdfMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export interface PdfFontOptions {
+    regularPath?: string;
+    boldPath?: string;
+    monoPath?: string;
+}
+export interface PdfBarcodeOptions {
+    width?: number;
+    height?: number;
+}
+export interface PdfTemplateOptions {
+    title?: string;
+    author?: string;
+    subject?: string;
+    keywords?: string;
+    creator?: string;
+    includePixQr?: boolean;
+    includeBarcode?: boolean;
+    barcode?: PdfBarcodeOptions;
+    pageSize?: string | [number, number];
+    layout?: PdfLayout;
+    compress?: boolean;
+    boletosPerPage?: number;
+    sectionSpacing?: number;
+    margins?: number | Partial<PdfMargins>;
+    bleed?: number;
+    fonts?: PdfFontOptions;
+}
+export interface ResolvedPdfTemplateOptions {
+    title: string;
+    author: string;
+    subject: string;
+    keywords: string;
+    creator: string;
+    includePixQr: boolean;
+    includeBarcode: boolean;
+    barcode: Required<PdfBarcodeOptions>;
+    pageSize: string | [number, number];
+    layout: PdfLayout;
+    compress: boolean;
+    boletosPerPage: number;
+    sectionSpacing: number;
+    margins: PdfMargins;
+    bleed: number;
+    fonts: PdfFontOptions;
+}
+export interface PdfLayoutFlags {
+    showInstructions: boolean;
+    showAdditionalInfo: boolean;
+}
+export declare function resolvePdfTemplateOptions(options?: PdfTemplateOptions): ResolvedPdfTemplateOptions;
+export declare function derivePdfLayoutFlags(layout: PdfLayout): PdfLayoutFlags;
+//# sourceMappingURL=PdfTemplate.d.ts.map

package/dist/generators/pdf/PdfTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdfTemplate.d.ts","sourceRoot":"","sources":["../../../src/generators/pdf/PdfTemplate.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,cAAc,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAEhC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAgCD,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,kBAAuB,GAC/B,0BAA0B,CAqC5B;AAQD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAKtE"}

package/dist/generators/pdf/PdfTemplate.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePdfTemplateOptions = resolvePdfTemplateOptions;
+exports.derivePdfLayoutFlags = derivePdfLayoutFlags;
+const DEFAULT_TEMPLATE_OPTIONS = {
+    title: 'Boleto',
+    author: 'BoletoSDK',
+    subject: '',
+    keywords: '',
+    creator: 'BoletoSDK',
+    includePixQr: false,
+    includeBarcode: true,
+    barcode: { width: 350, height: 50 },
+    pageSize: 'A4',
+    layout: 'detailed',
+    compress: true,
+    boletosPerPage: 1,
+    sectionSpacing: 0,
+    margins: {
+        top: 40,
+        right: 40,
+        bottom: 40,
+        left: 40,
+    },
+    bleed: 0,
+    fonts: {},
+};
+function resolvePdfTemplateOptions(options = {}) {
+    const boletosPerPage = normalizePositiveInteger(options.boletosPerPage, DEFAULT_TEMPLATE_OPTIONS.boletosPerPage);
+    const sectionSpacing = normalizeNonNegativeNumber(options.sectionSpacing, DEFAULT_TEMPLATE_OPTIONS.sectionSpacing);
+    const margins = normalizeMargins(options.margins, DEFAULT_TEMPLATE_OPTIONS.margins);
+    const bleed = normalizeNonNegativeNumber(options.bleed, DEFAULT_TEMPLATE_OPTIONS.bleed);
+    return {
+        title: options.title ?? DEFAULT_TEMPLATE_OPTIONS.title,
+        author: options.author ?? DEFAULT_TEMPLATE_OPTIONS.author,
+        subject: options.subject ?? DEFAULT_TEMPLATE_OPTIONS.subject,
+        keywords: options.keywords ?? DEFAULT_TEMPLATE_OPTIONS.keywords,
+        creator: options.creator ?? DEFAULT_TEMPLATE_OPTIONS.creator,
+        includePixQr: options.includePixQr ?? DEFAULT_TEMPLATE_OPTIONS.includePixQr,
+        includeBarcode: options.includeBarcode ?? DEFAULT_TEMPLATE_OPTIONS.includeBarcode,
+        barcode: {
+            width: normalizeDimension(options.barcode?.width, DEFAULT_TEMPLATE_OPTIONS.barcode.width),
+            height: normalizeDimension(options.barcode?.height, DEFAULT_TEMPLATE_OPTIONS.barcode.height),
+        },
+        pageSize: options.pageSize ?? DEFAULT_TEMPLATE_OPTIONS.pageSize,
+        layout: options.layout ?? DEFAULT_TEMPLATE_OPTIONS.layout,
+        compress: options.compress ?? DEFAULT_TEMPLATE_OPTIONS.compress,
+        boletosPerPage,
+        sectionSpacing,
+        margins,
+        bleed,
+        fonts: {
+            regularPath: normalizeString(options.fonts?.regularPath),
+            boldPath: normalizeString(options.fonts?.boldPath),
+            monoPath: normalizeString(options.fonts?.monoPath),
+        },
+    };
+}
+function derivePdfLayoutFlags(layout) {
+    return {
+        showInstructions: layout !== 'simple',
+        showAdditionalInfo: layout === 'detailed',
+    };
+}
+function normalizeDimension(value, fallback) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+        return fallback;
+    }
+    return value;
+}
+function normalizePositiveInteger(value, fallback) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return fallback;
+    }
+    const normalized = Math.floor(value);
+    return normalized > 0 ? normalized : fallback;
+}
+function normalizeNonNegativeNumber(value, fallback) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return fallback;
+    }
+    return value >= 0 ? value : fallback;
+}
+function normalizeMargins(value, fallback) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        const normalized = Math.max(value, 0);
+        return {
+            top: normalized,
+            right: normalized,
+            bottom: normalized,
+            left: normalized,
+        };
+    }
+    if (!value || typeof value !== 'object') {
+        return { ...fallback };
+    }
+    return {
+        top: normalizeNonNegativeNumber(value.top, fallback.top),
+        right: normalizeNonNegativeNumber(value.right, fallback.right),
+        bottom: normalizeNonNegativeNumber(value.bottom, fallback.bottom),
+        left: normalizeNonNegativeNumber(value.left, fallback.left),
+    };
+}
+function normalizeString(value) {
+    if (!value) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+//# sourceMappingURL=PdfTemplate.js.map

package/dist/generators/pdf/PdfTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PdfTemplate.js","sourceRoot":"","sources":["../../../src/generators/pdf/PdfTemplate.ts"],"names":[],"mappings":";;AAiGA,8DAuCC;AAQD,oDAKC;AAlFD,MAAM,wBAAwB,GAA+B;IAC3D,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,WAAW;IACpB,YAAY,EAAE,KAAK;IACnB,cAAc,EAAE,IAAI;IACpB,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;IACnC,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,IAAI;IACd,cAAc,EAAE,CAAC;IACjB,cAAc,EAAE,CAAC;IACjB,OAAO,EAAE;QACP,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,EAAE;KACT;IACD,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,EAAE;CACV,CAAC;AAQF,SAAgB,yBAAyB,CACvC,UAA8B,EAAE;IAEhC,MAAM,cAAc,GAAG,wBAAwB,CAC7C,OAAO,CAAC,cAAc,EACtB,wBAAwB,CAAC,cAAc,CACxC,CAAC;IACF,MAAM,cAAc,GAAG,0BAA0B,CAC/C,OAAO,CAAC,cAAc,EACtB,wBAAwB,CAAC,cAAc,CACxC,CAAC;IACF,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,0BAA0B,CAAC,OAAO,CAAC,KAAK,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAExF,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAAC,KAAK;QACtD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,wBAAwB,CAAC,MAAM;QACzD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,wBAAwB,CAAC,OAAO;QAC5D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,wBAAwB,CAAC,QAAQ;QAC/D,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,wBAAwB,CAAC,OAAO;QAC5D,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,wBAAwB,CAAC,YAAY;QAC3E,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC,cAAc;QACjF,OAAO,EAAE;YACP,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC;YACzF,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,wBAAwB,CAAC,OAAO,CAAC,MAAM,CAAC;SAC7F;QACD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,wBAAwB,CAAC,QAAQ;QAC/D,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,wBAAwB,CAAC,MAAM;QACzD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,wBAAwB,CAAC,QAAQ;QAC/D,cAAc;QACd,cAAc;QACd,OAAO;QACP,KAAK;QACL,KAAK,EAAE;YACL,WAAW,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC;YACxD,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAClD,QAAQ,EAAE,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;SACnD;KACF,CAAC;AACJ,CAAC;AAQD,SAAgB,oBAAoB,CAAC,MAAiB;IACpD,OAAO;QACL,gBAAgB,EAAE,MAAM,KAAK,QAAQ;QACrC,kBAAkB,EAAE,MAAM,KAAK,UAAU;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB,EAAE,QAAgB;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAyB,EAAE,QAAgB;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChD,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAyB,EAAE,QAAgB;IAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvC,CAAC;AAED,SAAS,gBAAgB,CACvB,KAA+C,EAC/C,QAAoB;IAEpB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtC,OAAO;YACL,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,UAAU;SACjB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,OAAO;QACL,GAAG,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC;QACxD,KAAK,EAAE,0BAA0B,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;QAC9D,MAAM,EAAE,0BAA0B,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;QACjE,IAAI,EAAE,0BAA0B,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC"}

package/dist/generators/pdf/index.d.ts

@@ -0,0 +1,5 @@
+export * from './BoletoPdfGenerator';
+export * from './DirectPdfGenerator';
+export * from './PdfRenderer';
+export * from './PdfTemplate';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/pdf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/pdf/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/generators/pdf/index.js

@@ -0,0 +1,21 @@
+"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("./BoletoPdfGenerator"), exports);
+__exportStar(require("./DirectPdfGenerator"), exports);
+__exportStar(require("./PdfRenderer"), exports);
+__exportStar(require("./PdfTemplate"), exports);
+//# sourceMappingURL=index.js.map

package/dist/generators/pdf/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/pdf/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,gDAA8B;AAC9B,gDAA8B"}

package/dist/generators/qrcode/PixPayloadGenerator.d.ts

@@ -0,0 +1,10 @@
+export interface PixPayloadData {
+    key: string;
+    amount?: number;
+    merchantName: string;
+    merchantCity: string;
+    transactionId: string;
+    description?: string;
+}
+export declare function generatePixPayload(data: PixPayloadData): string;
+//# sourceMappingURL=PixPayloadGenerator.d.ts.map

package/dist/generators/qrcode/PixPayloadGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixPayloadGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/qrcode/PixPayloadGenerator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CA4B/D"}

package/dist/generators/qrcode/PixPayloadGenerator.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePixPayload = generatePixPayload;
+const generators_1 = require("../../utils/generators");
+const PAYLOAD_FORMAT_INDICATOR = '01';
+const MERCHANT_ACCOUNT_GUI = 'br.gov.bcb.pix';
+const MERCHANT_CATEGORY_CODE = '0000';
+const TRANSACTION_CURRENCY = '986';
+const COUNTRY_CODE = 'BR';
+const CRC_ID = '63';
+const CRC_LENGTH = '04';
+function generatePixPayload(data) {
+    const key = validateRequired(data.key, 'PIX key');
+    const merchantName = normalizeText(data.merchantName, 'Merchant name', 25);
+    const merchantCity = normalizeText(data.merchantCity, 'Merchant city', 15);
+    const transactionId = normalizeText(data.transactionId, 'Transaction ID', 25, false, false);
+    const description = data.description
+        ? normalizeText(data.description, 'Description', 99, false)
+        : undefined;
+    const merchantAccountInfo = buildMerchantAccountInfo(key, description);
+    const additionalData = buildAdditionalData(transactionId);
+    const fields = [
+        formatTlv('00', PAYLOAD_FORMAT_INDICATOR),
+        formatTlv('26', merchantAccountInfo),
+        formatTlv('52', MERCHANT_CATEGORY_CODE),
+        formatTlv('53', TRANSACTION_CURRENCY),
+        ...buildAmountField(data.amount),
+        formatTlv('58', COUNTRY_CODE),
+        formatTlv('59', merchantName),
+        formatTlv('60', merchantCity),
+        formatTlv('62', additionalData),
+    ];
+    const payloadWithoutCrc = `${fields.join('')}${CRC_ID}${CRC_LENGTH}`;
+    const crc = calculateCrc16(payloadWithoutCrc);
+    return `${payloadWithoutCrc}${crc}`;
+}
+function validateRequired(value, fieldName) {
+    if (!value?.trim()) {
+        throw new Error(`${fieldName} is required`);
+    }
+    return value.trim();
+}
+function normalizeText(value, fieldName, maxLength, upperCase = true, validateMaxLength = true) {
+    const trimmed = validateRequired(value, fieldName);
+    const normalized = trimmed.normalize('NFD').replaceAll(/[\u0300-\u036f]/g, '');
+    const output = upperCase ? normalized.toUpperCase() : normalized;
+    if (validateMaxLength && output.length > maxLength) {
+        throw new Error(`${fieldName} must be at most ${maxLength} characters`);
+    }
+    return output;
+}
+function buildAmountField(amount) {
+    if (amount === undefined || amount <= 0) {
+        return [];
+    }
+    if (!Number.isFinite(amount)) {
+        throw new TypeError('Amount must be a valid number');
+    }
+    const formatted = amount.toFixed(2);
+    return [formatTlv('54', formatted)];
+}
+function buildMerchantAccountInfo(key, description) {
+    const fields = [formatTlv('00', MERCHANT_ACCOUNT_GUI), formatTlv('01', key)];
+    if (description) {
+        fields.push(formatTlv('02', description));
+    }
+    return fields.join('');
+}
+function buildAdditionalData(transactionId) {
+    if (transactionId.length < 1 || transactionId.length > 25) {
+        throw new Error('Transaction ID must be between 1 and 25 characters');
+    }
+    return formatTlv('05', transactionId);
+}
+function formatTlv(id, value) {
+    if (value.length > 99) {
+        throw new Error(`Value length for ${id} must be at most 99 characters`);
+    }
+    return `${id}${(0, generators_1.padLeft)(value.length, 2)}${value}`;
+}
+function calculateCrc16(payload) {
+    let crc = 0xffff;
+    for (let i = 0; i < payload.length; i += 1) {
+        crc ^= (payload.codePointAt(i) ?? 0) << 8;
+        for (let j = 0; j < 8; j += 1) {
+            if ((crc & 0x8000) === 0) {
+                crc <<= 1;
+            }
+            else {
+                crc = (crc << 1) ^ 0x1021;
+            }
+            crc &= 0xffff;
+        }
+    }
+    return crc.toString(16).toUpperCase().padStart(4, '0');
+}
+//# sourceMappingURL=PixPayloadGenerator.js.map

package/dist/generators/qrcode/PixPayloadGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixPayloadGenerator.js","sourceRoot":"","sources":["../../../src/generators/qrcode/PixPayloadGenerator.ts"],"names":[],"mappings":"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"}

package/dist/generators/qrcode/PixPayloadValidator.d.ts

@@ -0,0 +1,2 @@
+export declare function validatePixPayload(payload: string): void;
+//# sourceMappingURL=PixPayloadValidator.d.ts.map

package/dist/generators/qrcode/PixPayloadValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixPayloadValidator.d.ts","sourceRoot":"","sources":["../../../src/generators/qrcode/PixPayloadValidator.ts"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CA6BxD"}

package/dist/generators/qrcode/PixPayloadValidator.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePixPayload = validatePixPayload;
+const CRC_FIELD_ID = '63';
+const CRC_LENGTH = 4;
+function validatePixPayload(payload) {
+    if (!payload?.trim()) {
+        throw new Error('PIX payload cannot be empty');
+    }
+    const fields = parseTlvFields(payload.trim());
+    const lastField = fields.at(-1);
+    if (lastField?.id !== CRC_FIELD_ID) {
+        throw new Error('PIX payload must end with CRC field 63');
+    }
+    if (lastField.length !== CRC_LENGTH) {
+        throw new Error('PIX payload CRC field must have length 4');
+    }
+    const expectedCrc = calculateCrc16(payload.slice(0, -CRC_LENGTH));
+    if (lastField.value !== expectedCrc) {
+        throw new Error('PIX payload CRC is invalid');
+    }
+    ensureRequiredField(fields, '00', 'payload format indicator');
+    ensureRequiredField(fields, '26', 'merchant account information');
+    ensureRequiredField(fields, '52', 'merchant category code');
+    ensureRequiredField(fields, '53', 'transaction currency');
+    ensureRequiredField(fields, '58', 'country code');
+    ensureRequiredField(fields, '59', 'merchant name');
+    ensureRequiredField(fields, '60', 'merchant city');
+    ensureRequiredField(fields, '62', 'additional data');
+}
+function parseTlvFields(payload) {
+    const fields = [];
+    let index = 0;
+    while (index + 4 <= payload.length) {
+        const id = payload.slice(index, index + 2);
+        const lengthText = payload.slice(index + 2, index + 4);
+        const length = Number.parseInt(lengthText, 10);
+        if (!Number.isInteger(length) || length < 0) {
+            throw new Error(`Invalid TLV length for field ${id}`);
+        }
+        const valueStart = index + 4;
+        const valueEnd = valueStart + length;
+        if (valueEnd > payload.length) {
+            throw new Error(`TLV field ${id} exceeds payload length`);
+        }
+        fields.push({ id, length, value: payload.slice(valueStart, valueEnd) });
+        index = valueEnd;
+        if (id === CRC_FIELD_ID) {
+            break;
+        }
+    }
+    return fields;
+}
+function ensureRequiredField(fields, id, fieldName) {
+    const field = fields.find((item) => item.id === id);
+    if (!field || field.length === 0) {
+        throw new Error(`PIX payload is missing ${fieldName}`);
+    }
+}
+function calculateCrc16(payload) {
+    let crc = 0xffff;
+    for (let i = 0; i < payload.length; i += 1) {
+        crc ^= (payload.codePointAt(i) ?? 0) << 8;
+        for (let j = 0; j < 8; j += 1) {
+            if ((crc & 0x8000) === 0) {
+                crc <<= 1;
+            }
+            else {
+                crc = (crc << 1) ^ 0x1021;
+            }
+            crc &= 0xffff;
+        }
+    }
+    return crc.toString(16).toUpperCase().padStart(4, '0');
+}
+//# sourceMappingURL=PixPayloadValidator.js.map

package/dist/generators/qrcode/PixPayloadValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PixPayloadValidator.js","sourceRoot":"","sources":["../../../src/generators/qrcode/PixPayloadValidator.ts"],"names":[],"mappings":"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"}

package/dist/generators/qrcode/QRCodeGenerator.d.ts

@@ -0,0 +1,10 @@
+import { PixPayloadData } from './PixPayloadGenerator';
+export interface PixQRCodeOptions {
+    renderer?: (payload: string) => string;
+}
+export interface PixQRCodeResult {
+    payload: string;
+    qrCode?: string;
+}
+export declare function generatePixQRCode(data: PixPayloadData, options?: PixQRCodeOptions): PixQRCodeResult;
+//# sourceMappingURL=QRCodeGenerator.d.ts.map

package/dist/generators/qrcode/QRCodeGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QRCodeGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/qrcode/QRCodeGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG3E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAQjB"}

package/dist/generators/qrcode/QRCodeGenerator.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePixQRCode = generatePixQRCode;
+const PixPayloadGenerator_1 = require("./PixPayloadGenerator");
+const PixPayloadValidator_1 = require("./PixPayloadValidator");
+function generatePixQRCode(data, options = {}) {
+    const payload = (0, PixPayloadGenerator_1.generatePixPayload)(data);
+    (0, PixPayloadValidator_1.validatePixPayload)(payload);
+    return {
+        payload,
+        qrCode: options.renderer ? options.renderer(payload) : undefined,
+    };
+}
+//# sourceMappingURL=QRCodeGenerator.js.map

package/dist/generators/qrcode/QRCodeGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QRCodeGenerator.js","sourceRoot":"","sources":["../../../src/generators/qrcode/QRCodeGenerator.ts"],"names":[],"mappings":";;AAYA,8CAWC;AAvBD,+DAA2E;AAC3E,+DAA2D;AAW3D,SAAgB,iBAAiB,CAC/B,IAAoB,EACpB,UAA4B,EAAE;IAE9B,MAAM,OAAO,GAAG,IAAA,wCAAkB,EAAC,IAAI,CAAC,CAAC;IACzC,IAAA,wCAAkB,EAAC,OAAO,CAAC,CAAC;IAE5B,OAAO;QACL,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;KACjE,CAAC;AACJ,CAAC"}

package/dist/generators/qrcode/QRCodeRenderer.d.ts

@@ -0,0 +1,8 @@
+export interface QRCodeRenderOptions {
+    width?: number;
+    margin?: number;
+    errorCorrectionLevel?: 'L' | 'M' | 'Q' | 'H';
+}
+export declare function renderPixQrCodeSvg(payload: string, options?: QRCodeRenderOptions): Promise<string>;
+export declare function renderPixQrCodePng(payload: string, options?: QRCodeRenderOptions): Promise<Buffer>;
+//# sourceMappingURL=QRCodeRenderer.d.ts.map

package/dist/generators/qrcode/QRCodeRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QRCodeRenderer.d.ts","sourceRoot":"","sources":["../../../src/generators/qrcode/QRCodeRenderer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAC9C;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/generators/qrcode/QRCodeRenderer.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPixQrCodeSvg = renderPixQrCodeSvg;
+exports.renderPixQrCodePng = renderPixQrCodePng;
+const qrcode_1 = __importDefault(require("qrcode"));
+async function renderPixQrCodeSvg(payload, options = {}) {
+    return qrcode_1.default.toString(payload, {
+        type: 'svg',
+        width: options.width,
+        margin: options.margin,
+        errorCorrectionLevel: options.errorCorrectionLevel,
+    });
+}
+async function renderPixQrCodePng(payload, options = {}) {
+    return qrcode_1.default.toBuffer(payload, {
+        type: 'png',
+        width: options.width,
+        margin: options.margin,
+        errorCorrectionLevel: options.errorCorrectionLevel,
+    });
+}
+//# sourceMappingURL=QRCodeRenderer.js.map

package/dist/generators/qrcode/QRCodeRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QRCodeRenderer.js","sourceRoot":"","sources":["../../../src/generators/qrcode/QRCodeRenderer.ts"],"names":[],"mappings":";;;;;AAQA,gDAUC;AAED,gDAUC;AA9BD,oDAA4B;AAQrB,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,UAA+B,EAAE;IAEjC,OAAO,gBAAM,CAAC,QAAQ,CAAC,OAAO,EAAE;QAC9B,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;KACnD,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,kBAAkB,CACtC,OAAe,EACf,UAA+B,EAAE;IAEjC,OAAO,gBAAM,CAAC,QAAQ,CAAC,OAAO,EAAE;QAC9B,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;KACnD,CAAC,CAAC;AACL,CAAC"}

package/dist/generators/qrcode/index.d.ts

@@ -0,0 +1,5 @@
+export * from './PixPayloadGenerator';
+export * from './PixPayloadValidator';
+export * from './QRCodeGenerator';
+export * from './QRCodeRenderer';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/qrcode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/qrcode/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}