pdf-gen-js 1.0.0

package/README.md

@@ -0,0 +1,179 @@
+# pdf-gen-js
+
+JavaScript/TypeScript implementation of [universal-pdf-gen](https://github.com/Ahmedz182/universal-pdf-gen) — professional invoice, receipt, and certificate PDFs with a programmatic API. Built on [PDFKit](http://pdfkit.org/).
+
+See the [root README](../../README.md) for full screenshots and a side-by-side comparison with the Python package.
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+(Once published: `npm install pdf-gen-js`.)
+
+## Quick Start
+
+```javascript
+const { PDFGenerator, Templates } = require('pdf-gen-js');
+
+const pdf = new PDFGenerator({ pageSize: 'A4', orientation: 'portrait' });
+Templates.register(pdf);
+
+await pdf.useTemplate('invoice', {
+  invoiceNumber: 'INV-001',
+  date: '2024-01-15',
+  companyName: 'ACME Corp',
+  clientName: 'John Doe',
+  items: [{ description: 'Service', quantity: 1, unitPrice: 100 }],
+  subtotal: 100,
+  total: 100
+});
+
+await pdf.generate('invoice.pdf');
+```
+
+> `useTemplate` is `async` — image embedding (WEBP normalization, SVG parsing) may need to do async work — so always `await` it.
+
+TypeScript types are included — `InvoiceData`, `ReceiptData`, `CertificateData`, `PDFConfig`, and `Theme` are all exported.
+
+## Templates
+
+See the [templates reference in the root README](../../README.md#templates-reference) for the full field list. All keys are `camelCase` in JS/TS.
+
+### Invoice
+
+```typescript
+import { InvoiceData } from 'pdf-gen-js';
+
+const data: InvoiceData = {
+  invoiceNumber: 'INV-001',
+  date: '2024-01-15',
+  dueDate: '2024-02-14',
+  status: 'DUE',
+  companyName: 'ACME Corp',
+  companyAddress: 'Optional address',
+  clientName: 'John Doe',
+  clientAddress: 'Optional address',
+  items: [{ description: 'Service', quantity: 1, unitPrice: 100 }],
+  subtotal: 100,
+  tax: 10,
+  taxRate: 10,
+  total: 110,
+  notes: 'Optional notes',
+  paymentTerms: 'Net 30'
+};
+```
+
+### Receipt
+
+```typescript
+const data = {
+  storeName: 'Store Name',
+  storeAddress: 'Optional address',
+  receiptNumber: 'RCP-001',
+  dateTime: '2024-01-15 10:30',
+  items: [{ name: 'Item', quantity: 1, price: 25.0 }],
+  subtotal: 25.0,
+  tax: 2.5,
+  total: 27.5,
+  paymentMethod: 'Cash',
+  thankYouMessage: 'Thank you for your purchase!'
+};
+```
+
+### Certificate
+
+```typescript
+const data = {
+  title: 'Certificate of Achievement',
+  recipientName: 'John Doe',
+  achievementText: 'For successfully completing the course',
+  issuerName: 'Institution Name',
+  issueDate: '2024-01-15',
+  certificationNumber: 'CERT-001',
+  borderColor: '#1a5f7a'
+};
+```
+
+## Logos (PNG, JPG, WEBP, SVG)
+
+```javascript
+await pdf.useTemplate('invoice', {
+  logo: 'logo.svg', // or .png / .jpg / .webp, a Buffer, or { src, width, height }
+  // ...
+});
+```
+
+WEBP is transparently normalized to PNG via `sharp` (PDFKit has no native WEBP support). SVG is drawn as true vector paths via `svg-to-pdfkit` — not rasterized — so it stays crisp. See [Logos & Images in the root README](../../README.md#logos--images) for the full picture, including a side-by-side comparison of all four formats.
+
+## CLI Usage
+
+```bash
+node bin/cli.js invoice output.pdf --config invoice-data.json
+node bin/cli.js invoice output.pdf --config invoice-data.json --logo logo.svg
+node bin/cli.js receipt receipt.pdf --config receipt-data.json --page-size A4
+node bin/cli.js certificate cert.pdf --config cert-data.json --orientation portrait
+```
+
+Or, once installed as a package, simply `pdf-gen invoice output.pdf --config invoice-data.json`.
+
+## Programmatic (non-template) API
+
+```javascript
+const pdf = new PDFGenerator({ pageSize: 'A4', orientation: 'portrait' });
+
+// Text
+pdf.addText('Hello World', { align: 'left' });
+
+// Line
+pdf.addLine(100, 200, 300, 200);
+
+// Table with automatic word-wrap and pagination
+pdf.addTable(
+  [
+    { header: 'Name', key: 'name' },
+    { header: 'Score', key: 'score', align: 'right' }
+  ],
+  [
+    { name: 'Alice', score: '95' },
+    { name: 'Bob', score: '88' }
+  ]
+);
+
+// New page
+pdf.addPage();
+
+// Image (PNG, JPG, WEBP, or SVG — file path or Buffer)
+await pdf.addImage('logo.svg', 100, 50, 80, 80); // x, y, width, height
+
+// Write to disk, or get raw bytes for an HTTP response
+await pdf.generate('output.pdf');
+const buffer = await pdf.generateBuffer();
+```
+
+## Theming
+
+```javascript
+const pdf = new PDFGenerator({
+  theme: { primary: '#7a2048', accent: '#d4af37' }
+});
+```
+
+## Page numbers
+
+```javascript
+pdf.addPageNumbers(); // call once, right before generate() — stamps "Page N of M"
+await pdf.generate('output.pdf');
+```
+
+## Running tests
+
+```bash
+npm test   # builds TypeScript, then runs the test suite
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const { PDFGenerator, Templates } = require('../dist/index');
+
+const args = process.argv.slice(2);
+
+function flag(name) {
+  const idx = args.indexOf(name);
+  return idx === -1 ? null : args[idx + 1];
+}
+
+if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+  console.log(`
+PDF Generator CLI
+
+Usage: pdf-gen <template> <output> [options]
+
+Templates:
+  invoice   - Generate an invoice PDF
+  receipt   - Generate a receipt PDF
+  certificate - Generate a certificate PDF
+
+Options:
+  --config <file>        JSON file with template data
+  --page-size <size>     Page size: A4 (default), Letter, A3, A5
+  --orientation <o>      portrait (default) or landscape
+  --logo <file>          Logo image to embed (png, jpg, webp, or svg) —
+                         overrides/sets the "logo" field from --config
+  --help, -h             Show this help message
+
+Examples:
+  pdf-gen invoice invoice.pdf --config invoice-data.json
+  pdf-gen invoice invoice.pdf --config invoice-data.json --logo logo.svg
+  pdf-gen certificate cert.pdf --config cert-data.json --page-size A4
+  `);
+  process.exit(0);
+}
+
+const template = args[0];
+const output = args[1];
+const configFile = flag('--config');
+const pageSize = flag('--page-size') || 'A4';
+const orientation = flag('--orientation') || 'portrait';
+const logoFile = flag('--logo');
+
+if (!template || !output) {
+  console.error('Error: template and output arguments are required');
+  process.exit(1);
+}
+
+if (!configFile) {
+  console.error('Error: --config file is required');
+  process.exit(1);
+}
+
+async function main() {
+  const config = JSON.parse(fs.readFileSync(configFile, 'utf8'));
+  if (logoFile) {
+    config.logo = logoFile;
+  }
+
+  const pdf = new PDFGenerator({ pageSize, orientation });
+  Templates.register(pdf);
+
+  await pdf.useTemplate(template, config);
+  await pdf.generate(output);
+  console.log(`✓ PDF generated: ${output}`);
+}
+
+main().catch((error) => {
+  console.error(`Error: ${error.message}`);
+  process.exit(1);
+});

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+import { Theme } from './theme';
+export interface PDFConfig {
+    pageSize: 'A4' | 'Letter' | 'A3' | 'A5';
+    orientation: 'portrait' | 'landscape';
+    margins: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    defaultFont?: string;
+    fontSize?: number;
+    lineHeight?: number;
+    theme?: Partial<Theme>;
+}
+export declare const DEFAULT_CONFIG: PDFConfig;
+export declare const PAGE_SIZES: Record<string, [number, number]>;
+/** Resolves the final [width, height] in points for a config, accounting for orientation. */
+export declare function resolvePageDimensions(config: PDFConfig): [number, number];
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACxB;AAED,eAAO,MAAM,cAAc,EAAE,SAO5B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAKvD,CAAC;AAEF,6FAA6F;AAC7F,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGzE"}

package/dist/config.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGE_SIZES = exports.DEFAULT_CONFIG = void 0;
+exports.resolvePageDimensions = resolvePageDimensions;
+exports.DEFAULT_CONFIG = {
+    pageSize: 'A4',
+    orientation: 'portrait',
+    margins: { top: 40, bottom: 40, left: 40, right: 40 },
+    defaultFont: 'Helvetica',
+    fontSize: 12,
+    lineHeight: 1.5
+};
+exports.PAGE_SIZES = {
+    A4: [595.28, 841.89],
+    Letter: [612, 792],
+    A3: [841.89, 1190.55],
+    A5: [419.53, 595.28]
+};
+/** Resolves the final [width, height] in points for a config, accounting for orientation. */
+function resolvePageDimensions(config) {
+    const [width, height] = exports.PAGE_SIZES[config.pageSize] || exports.PAGE_SIZES.A4;
+    return config.orientation === 'landscape' ? [height, width] : [width, height];
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AA6BA,sDAGC;AApBY,QAAA,cAAc,GAAc;IACvC,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,UAAU;IACvB,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;IACrD,WAAW,EAAE,WAAW;IACxB,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,GAAG;CAChB,CAAC;AAEW,QAAA,UAAU,GAAqC;IAC1D,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IACrB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,6FAA6F;AAC7F,SAAgB,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,kBAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,kBAAU,CAAC,EAAE,CAAC;IACrE,OAAO,MAAM,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAChF,CAAC"}

package/dist/generator.d.ts

@@ -0,0 +1,44 @@
+import { PDFConfig } from './config';
+import { Theme } from './theme';
+import { PDFDoc } from './types';
+import { TableColumn, TableOptions } from './utils/table';
+export interface TemplateData {
+    [key: string]: any;
+}
+export type TemplateRenderer = (pdf: PDFDoc, config: PDFConfig, data: TemplateData, theme: Theme) => void | Promise<void>;
+export type { TableColumn, TableOptions };
+export declare class PDFGenerator {
+    private doc;
+    private config;
+    private theme;
+    private templates;
+    constructor(config?: Partial<PDFConfig>);
+    registerTemplate(name: string, renderer: TemplateRenderer): void;
+    useTemplate(templateName: string, data: TemplateData): Promise<this>;
+    /** Usable content width between the left and right margins. */
+    get contentWidth(): number;
+    get contentHeight(): number;
+    addText(text: string, options?: any): this;
+    /** Embeds PNG, JPEG, GIF, WEBP, or SVG (file path or Buffer) at the given top-left position. */
+    addImage(source: string | Buffer, x: number, y: number, width?: number, height?: number): Promise<this>;
+    /**
+     * Renders a table with word-wrapped cells, an optional striped body, and automatic
+     * page breaks when the table would run past the bottom margin.
+     */
+    addTable(columns: TableColumn[], rows: Array<Record<string, any> | any[]>, options?: TableOptions): this;
+    /** Adds a new page if the given height would not fit before the bottom margin. */
+    ensureSpace(height: number): this;
+    addPage(): this;
+    addLine(x1: number, y1: number, x2: number, y2: number, color?: string, width?: number): this;
+    addRect(x: number, y: number, width: number, height: number, fillColor?: string, radius?: number): this;
+    setFont(fontName: string, size: number): this;
+    moveDown(amount?: number): this;
+    /** Stamps "Page N of M" at the bottom-right of every page. Call once, right before generate(). */
+    addPageNumbers(): this;
+    generate(filename: string): Promise<void>;
+    /** Resolves with the raw PDF bytes instead of writing to disk — useful for HTTP responses. */
+    generateBuffer(): Promise<Buffer>;
+    getDocument(): PDFDoc;
+    getTheme(): Theme;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAyC,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAc,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAmB,MAAM,SAAS,CAAC;AAClD,OAAO,EAAa,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGrE,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,KAAK,KACT,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AAE1C,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,SAAS,CAA4C;gBAEjD,MAAM,GAAE,OAAO,CAAC,SAAS,CAAM;IAc3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAI1D,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1E,+DAA+D;IAC/D,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,IAAI;IAK9C,gGAAgG;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7G;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAK5G,kFAAkF;IAClF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOjC,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,MAA0B,EAAE,KAAK,SAAI,GAAG,IAAI;IAK3G,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,IAAI;IAclG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7C,QAAQ,CAAC,MAAM,GAAE,MAAU,GAAG,IAAI;IAKlC,kGAAkG;IAClG,cAAc,IAAI,IAAI;IAkBhB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/C,8FAA8F;IACxF,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAUvC,WAAW,IAAI,MAAM;IAIrB,QAAQ,IAAI,KAAK;CAGlB"}

package/dist/generator.js

@@ -0,0 +1,144 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PDFGenerator = void 0;
+const fs_1 = __importDefault(require("fs"));
+const config_1 = require("./config");
+const theme_1 = require("./theme");
+const types_1 = require("./types");
+const table_1 = require("./utils/table");
+const image_1 = require("./utils/image");
+class PDFGenerator {
+    constructor(config = {}) {
+        this.templates = new Map();
+        this.config = { ...config_1.DEFAULT_CONFIG, ...config, margins: { ...config_1.DEFAULT_CONFIG.margins, ...config.margins } };
+        this.theme = (0, theme_1.mergeTheme)(this.config.theme);
+        const [width, height] = (0, config_1.resolvePageDimensions)(this.config);
+        this.doc = new types_1.PDFDocumentCtor({
+            size: [width, height],
+            margins: this.config.margins,
+            bufferPages: true,
+            info: { Producer: 'universal-pdf-gen', Creator: 'universal-pdf-gen' }
+        });
+    }
+    registerTemplate(name, renderer) {
+        this.templates.set(name, renderer);
+    }
+    async useTemplate(templateName, data) {
+        const template = this.templates.get(templateName);
+        if (!template) {
+            throw new Error(`Template "${templateName}" not found. Available: ${Array.from(this.templates.keys()).join(', ') || '(none registered)'}`);
+        }
+        await template(this.doc, this.config, data, this.theme);
+        return this;
+    }
+    /** Usable content width between the left and right margins. */
+    get contentWidth() {
+        return this.doc.page.width - this.config.margins.left - this.config.margins.right;
+    }
+    get contentHeight() {
+        return this.doc.page.height - this.config.margins.top - this.config.margins.bottom;
+    }
+    addText(text, options = {}) {
+        this.doc.text(text, options);
+        return this;
+    }
+    /** Embeds PNG, JPEG, GIF, WEBP, or SVG (file path or Buffer) at the given top-left position. */
+    async addImage(source, x, y, width, height) {
+        await (0, image_1.embedImage)(this.doc, source, x, y, { width, height });
+        return this;
+    }
+    /**
+     * Renders a table with word-wrapped cells, an optional striped body, and automatic
+     * page breaks when the table would run past the bottom margin.
+     */
+    addTable(columns, rows, options = {}) {
+        (0, table_1.drawTable)(this.doc, this.config, this.theme, columns, rows, options);
+        return this;
+    }
+    /** Adds a new page if the given height would not fit before the bottom margin. */
+    ensureSpace(height) {
+        if (this.doc.y + height > this.doc.page.height - this.config.margins.bottom) {
+            this.doc.addPage();
+        }
+        return this;
+    }
+    addPage() {
+        this.doc.addPage();
+        return this;
+    }
+    addLine(x1, y1, x2, y2, color = this.theme.border, width = 1) {
+        this.doc.strokeColor(color).lineWidth(width).moveTo(x1, y1).lineTo(x2, y2).stroke();
+        return this;
+    }
+    addRect(x, y, width, height, fillColor, radius = 0) {
+        if (radius > 0) {
+            this.doc.roundedRect(x, y, width, height, radius);
+        }
+        else {
+            this.doc.rect(x, y, width, height);
+        }
+        if (fillColor) {
+            this.doc.fill(fillColor);
+        }
+        else {
+            this.doc.stroke();
+        }
+        return this;
+    }
+    setFont(fontName, size) {
+        this.doc.font(fontName).fontSize(size);
+        return this;
+    }
+    moveDown(amount = 1) {
+        this.doc.moveDown(amount);
+        return this;
+    }
+    /** Stamps "Page N of M" at the bottom-right of every page. Call once, right before generate(). */
+    addPageNumbers() {
+        const { doc, theme, config } = this;
+        const range = doc.bufferedPageRange();
+        for (let i = range.start; i < range.start + range.count; i++) {
+            doc.switchToPage(i);
+            const pageNum = i - range.start + 1;
+            doc
+                .font('Helvetica')
+                .fontSize(8)
+                .fillColor(theme.muted)
+                .text(`Page ${pageNum} of ${range.count}`, 0, doc.page.height - config.margins.bottom + 10, {
+                width: doc.page.width,
+                align: 'center'
+            });
+        }
+        return this;
+    }
+    async generate(filename) {
+        return new Promise((resolve, reject) => {
+            const stream = fs_1.default.createWriteStream(filename);
+            this.doc.pipe(stream);
+            this.doc.end();
+            stream.on('finish', () => resolve());
+            stream.on('error', reject);
+        });
+    }
+    /** Resolves with the raw PDF bytes instead of writing to disk — useful for HTTP responses. */
+    async generateBuffer() {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            this.doc.on('data', (chunk) => chunks.push(chunk));
+            this.doc.on('end', () => resolve(Buffer.concat(chunks)));
+            this.doc.on('error', reject);
+            this.doc.end();
+        });
+    }
+    getDocument() {
+        return this.doc;
+    }
+    getTheme() {
+        return this.theme;
+    }
+}
+exports.PDFGenerator = PDFGenerator;
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { PDFGenerator } from './generator';
+export type { PDFConfig } from './config';
+export { DEFAULT_CONFIG, PAGE_SIZES, resolvePageDimensions } from './config';
+export type { Theme } from './theme';
+export { DEFAULT_THEME, mergeTheme } from './theme';
+export type { TableColumn, TableOptions } from './utils/table';
+export type { LogoInput } from './utils/logo';
+export { detectFormat } from './utils/image';
+export type { ImageFormat } from './utils/image';
+import { PDFGenerator } from './generator';
+import { renderInvoice } from './templates/invoice';
+import { renderReceipt } from './templates/receipt';
+import { renderCertificate } from './templates/certificate';
+export declare class Templates {
+    static readonly INVOICE = "invoice";
+    static readonly RECEIPT = "receipt";
+    static readonly CERTIFICATE = "certificate";
+    static register(generator: PDFGenerator): void;
+}
+export { renderInvoice, renderReceipt, renderCertificate };
+export type { InvoiceData, InvoiceItem } from './templates/invoice';
+export type { ReceiptData, ReceiptItem } from './templates/receipt';
+export type { CertificateData } from './templates/certificate';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAC7E,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;CAK/C;AAED,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderCertificate = exports.renderReceipt = exports.renderInvoice = exports.Templates = exports.detectFormat = exports.mergeTheme = exports.DEFAULT_THEME = exports.resolvePageDimensions = exports.PAGE_SIZES = exports.DEFAULT_CONFIG = exports.PDFGenerator = void 0;
+var generator_1 = require("./generator");
+Object.defineProperty(exports, "PDFGenerator", { enumerable: true, get: function () { return generator_1.PDFGenerator; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return config_1.DEFAULT_CONFIG; } });
+Object.defineProperty(exports, "PAGE_SIZES", { enumerable: true, get: function () { return config_1.PAGE_SIZES; } });
+Object.defineProperty(exports, "resolvePageDimensions", { enumerable: true, get: function () { return config_1.resolvePageDimensions; } });
+var theme_1 = require("./theme");
+Object.defineProperty(exports, "DEFAULT_THEME", { enumerable: true, get: function () { return theme_1.DEFAULT_THEME; } });
+Object.defineProperty(exports, "mergeTheme", { enumerable: true, get: function () { return theme_1.mergeTheme; } });
+var image_1 = require("./utils/image");
+Object.defineProperty(exports, "detectFormat", { enumerable: true, get: function () { return image_1.detectFormat; } });
+const invoice_1 = require("./templates/invoice");
+Object.defineProperty(exports, "renderInvoice", { enumerable: true, get: function () { return invoice_1.renderInvoice; } });
+const receipt_1 = require("./templates/receipt");
+Object.defineProperty(exports, "renderReceipt", { enumerable: true, get: function () { return receipt_1.renderReceipt; } });
+const certificate_1 = require("./templates/certificate");
+Object.defineProperty(exports, "renderCertificate", { enumerable: true, get: function () { return certificate_1.renderCertificate; } });
+class Templates {
+    static register(generator) {
+        generator.registerTemplate('invoice', invoice_1.renderInvoice);
+        generator.registerTemplate('receipt', receipt_1.renderReceipt);
+        generator.registerTemplate('certificate', certificate_1.renderCertificate);
+    }
+}
+exports.Templates = Templates;
+Templates.INVOICE = 'invoice';
+Templates.RECEIPT = 'receipt';
+Templates.CERTIFICATE = 'certificate';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AAErB,mCAA6E;AAApE,wGAAA,cAAc,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAE1D,iCAAoD;AAA3C,sGAAA,aAAa,OAAA;AAAE,mGAAA,UAAU,OAAA;AAGlC,uCAA6C;AAApC,qGAAA,YAAY,OAAA;AAIrB,iDAAoD;AAgB3C,8FAhBA,uBAAa,OAgBA;AAftB,iDAAoD;AAe5B,8FAff,uBAAa,OAee;AAdrC,yDAA4D;AAcrB,kGAd9B,+BAAiB,OAc8B;AAZxD,MAAa,SAAS;IAKpB,MAAM,CAAC,QAAQ,CAAC,SAAuB;QACrC,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,uBAAiC,CAAC,CAAC;QACzE,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,uBAAiC,CAAC,CAAC;QACzE,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,+BAAqC,CAAC,CAAC;IACnF,CAAC;;AATH,8BAUC;AATiB,iBAAO,GAAG,SAAS,CAAC;AACpB,iBAAO,GAAG,SAAS,CAAC;AACpB,qBAAW,GAAG,aAAa,CAAC"}

package/dist/templates/certificate.d.ts

@@ -0,0 +1,17 @@
+import { PDFConfig } from '../config';
+import { Theme } from '../theme';
+import { PDFDoc } from '../types';
+import { LogoInput } from '../utils/logo';
+export interface CertificateData {
+    title: string;
+    logo?: LogoInput;
+    recipientName: string;
+    achievementText: string;
+    issuerName: string;
+    issueDate: Date | string;
+    certificationNumber?: string;
+    borderColor?: string;
+    decorativeElements?: boolean;
+}
+export declare function renderCertificate(pdf: PDFDoc, config: PDFConfig, data: CertificateData, theme: Theme): Promise<void>;
+//# sourceMappingURL=certificate.d.ts.map

package/dist/templates/certificate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certificate.d.ts","sourceRoot":"","sources":["../../src/templates/certificate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAc,SAAS,EAAe,MAAM,eAAe,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAsF1H"}