cli-pdf-generator 0.0.1

package/bin/run.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import {execute} from "@oclif/core";
+
+await execute({dir: import.meta.url});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "cli-pdf-generator",
+  "version": "0.0.1",
+  "description": "Generate PDFs from JSON data using CLI templates.",
+  "type": "module",
+  "bin": {
+    "pdfgen": "./bin/run.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "payload.example.json"
+  ],
+  "oclif": {
+    "commands": "./src/commands"
+  },
+  "scripts": {
+    "generate": "node ./bin/run.js generate",
+    "check": "node --check ./bin/run.js && node --check ./src/commands/generate.js && node --check ./src/render.js",
+    "postinstall": "playwright install chromium"
+  },
+  "dependencies": {
+    "@oclif/core": "^4.0.31",
+    "handlebars": "^4.7.8",
+    "playwright": "^1.56.1"
+  }
+}

package/payload.example.json

@@ -0,0 +1,30 @@
+{
+  "template": "invoice",
+  "filename": "sample_invoice.pdf",
+  "data": {
+    "company": {
+      "name": "Sample Company"
+    },
+    "party": {
+      "name": "Sample Customer"
+    },
+    "invoice_no": "INV-001",
+    "date": "01-01-2026",
+    "items": [
+      {
+        "description": "Sample Product",
+        "hsn": "00000000",
+        "qty": "1 Unit",
+        "rate": "1000.00/Unit",
+        "taxable": "1000.00",
+        "tax": "18%",
+        "total": "1180.00"
+      }
+    ],
+    "totals": {
+      "taxable": "1000.00",
+      "tax": "180.00",
+      "grand_total": "1180.00"
+    }
+  }
+}

package/src/commands/generate.js

@@ -0,0 +1,43 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+import {Args, Command, Flags} from "@oclif/core";
+
+import {generatePdf, safeFilename} from "../render.js";
+
+export default class Generate extends Command {
+  static description = "Generate a PDF from a JSON payload.";
+
+  static examples = [
+    "<%= config.bin %> <%= command.id %> --input payload.json --output invoice.pdf",
+  ];
+
+  static flags = {
+    input: Flags.string({
+      char: "i",
+      description: "Path to JSON payload file.",
+      required: true,
+    }),
+    output: Flags.string({
+      char: "o",
+      description: "Output PDF path.",
+    }),
+  };
+
+  static args = {
+    outputArg: Args.string({
+      description: "Optional output PDF path.",
+      required: false,
+    }),
+  };
+
+  async run() {
+    const {args, flags} = await this.parse(Generate);
+    const payload = JSON.parse(await fs.readFile(flags.input, "utf8"));
+    const output = path.resolve(flags.output || args.outputArg || safeFilename(payload.filename));
+
+    await fs.mkdir(path.dirname(output), {recursive: true});
+    await generatePdf(payload, output);
+    this.log(output);
+  }
+}

package/src/render.js

@@ -0,0 +1,72 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import {fileURLToPath} from "node:url";
+
+import Handlebars from "handlebars";
+import {chromium} from "playwright";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const baseDir = path.resolve(__dirname, "..");
+
+const templates = {
+  generic: "generic.html",
+  invoice: "invoice.html",
+};
+
+Handlebars.registerHelper("or", (left, right) => left || right);
+Handlebars.registerHelper("entries", (value) =>
+  Object.entries(value || {}).map(([key, val]) => ({
+    key: key.replaceAll("_", " ").replace(/\b\w/g, (char) => char.toUpperCase()),
+    val,
+    isObject: val && typeof val === "object" && !Array.isArray(val),
+    isArray: Array.isArray(val),
+  })),
+);
+
+export function safeFilename(value, fallback = "generated.pdf") {
+  const filename = String(value || fallback).replace(/[^a-zA-Z0-9._/-]/g, "_");
+  return filename.toLowerCase().endsWith(".pdf") ? filename : `${filename}.pdf`;
+}
+
+export async function renderHtml(payload) {
+  const templateKey = payload.template || "generic";
+  const templateFile = templates[templateKey];
+  if (!templateFile) {
+    throw new Error(`Unsupported template '${templateKey}'. Use one of: ${Object.keys(templates).join(", ")}`);
+  }
+
+  const templatePath = path.join(baseDir, "templates", templateFile);
+  const source = await fs.readFile(templatePath, "utf8");
+  const template = Handlebars.compile(source, {noEscape: false});
+
+  return template({
+    title: payload.title || payload.data?.title || "Generated Document",
+    rawText: payload.raw_text || payload.rawText || "",
+    data: payload.data || {},
+    generatedAt: new Date().toLocaleString("en-IN"),
+  });
+}
+
+export async function generatePdf(payload, outputPath) {
+  const html = await renderHtml(payload);
+  const browser = await chromium.launch({headless: true});
+
+  try {
+    const page = await browser.newPage();
+    await page.setContent(html, {waitUntil: "networkidle"});
+    await page.pdf({
+      path: outputPath,
+      format: "A4",
+      printBackground: true,
+      margin: {
+        top: "14mm",
+        right: "14mm",
+        bottom: "14mm",
+        left: "14mm",
+      },
+    });
+  } finally {
+    await browser.close();
+  }
+}

package/templates/generic.html

@@ -0,0 +1,52 @@
+<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <style>
+    body { color: #1f2937; font-family: Arial, sans-serif; font-size: 12px; line-height: 1.5; }
+    h1 { border-bottom: 2px solid #111827; color: #111827; font-size: 22px; margin: 0 0 16px; padding-bottom: 8px; }
+    h2 { color: #111827; font-size: 15px; margin: 18px 0 8px; }
+    table { border-collapse: collapse; margin: 10px 0 18px; width: 100%; }
+    th, td { border: 1px solid #d1d5db; padding: 7px 8px; text-align: left; vertical-align: top; }
+    th { background: #f3f4f6; color: #111827; font-weight: 700; }
+    pre { background: #f9fafb; border: 1px solid #e5e7eb; padding: 12px; white-space: pre-wrap; }
+    .meta { color: #6b7280; font-size: 10px; margin-bottom: 18px; text-align: right; }
+  </style>
+</head>
+<body>
+  <div class="meta">Generated: {{generatedAt}}</div>
+  <h1>{{title}}</h1>
+
+  {{#each (entries data)}}
+    {{#if isObject}}
+      <h2>{{key}}</h2>
+      <table>
+        <tbody>
+          {{#each (entries val)}}
+            <tr>
+              <th>{{key}}</th>
+              <td>{{val}}</td>
+            </tr>
+          {{/each}}
+        </tbody>
+      </table>
+    {{else if isArray}}
+      <h2>{{key}}</h2>
+      <table>
+        <tbody>
+          {{#each val}}
+            <tr><td>{{this}}</td></tr>
+          {{/each}}
+        </tbody>
+      </table>
+    {{else}}
+      <p><strong>{{key}}:</strong> {{val}}</p>
+    {{/if}}
+  {{/each}}
+
+  {{#if rawText}}
+    <h2>Details</h2>
+    <pre>{{rawText}}</pre>
+  {{/if}}
+</body>
+</html>

package/templates/invoice.html

@@ -0,0 +1,94 @@
+<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <style>
+    body { color: #111827; font-family: Arial, sans-serif; font-size: 11px; }
+    h1 { font-size: 24px; letter-spacing: .08em; margin: 0; text-align: right; }
+    h2 { border-bottom: 1px solid #d1d5db; font-size: 13px; margin: 18px 0 8px; padding-bottom: 4px; }
+    table { border-collapse: collapse; width: 100%; }
+    th, td { border: 1px solid #d1d5db; padding: 7px; vertical-align: top; }
+    th { background: #f3f4f6; font-weight: 700; }
+    .top { display: table; margin-bottom: 18px; width: 100%; }
+    .left, .right { display: table-cell; vertical-align: top; width: 50%; }
+    .right { text-align: right; }
+    .muted { color: #6b7280; }
+    .no-border td { border: 0; padding: 2px 0; }
+    .amount { text-align: right; white-space: nowrap; }
+    .totals { margin-left: auto; margin-top: 18px; width: 45%; }
+    .grand-total td { background: #111827; color: #fff; font-size: 13px; font-weight: 700; }
+    .notes { background: #f9fafb; border: 1px solid #e5e7eb; margin-top: 18px; padding: 10px; white-space: pre-wrap; }
+  </style>
+</head>
+<body>
+  <div class="top">
+    <div class="left">
+      <strong>{{or data.company.name data.company_name}}</strong><br>
+      {{#if data.company.address}}{{data.company.address}}<br>{{/if}}
+      {{#if data.company.gstin}}GSTIN: {{data.company.gstin}}<br>{{/if}}
+      {{#if data.company.email}}Email: {{data.company.email}}<br>{{/if}}
+      {{#if data.company.phone}}Phone: {{data.company.phone}}{{/if}}
+    </div>
+    <div class="right">
+      <h1>INVOICE</h1>
+      <table class="no-border">
+        <tr><td class="muted">Invoice No:</td><td>{{or data.invoice_no "-"}}</td></tr>
+        <tr><td class="muted">Date:</td><td>{{or data.date "-"}}</td></tr>
+        {{#if data.due_date}}<tr><td class="muted">Due Date:</td><td>{{data.due_date}}</td></tr>{{/if}}
+      </table>
+    </div>
+  </div>
+
+  <h2>Bill To</h2>
+  <strong>{{or data.party.name data.party_name}}</strong><br>
+  {{#if data.party.address}}{{data.party.address}}<br>{{/if}}
+  {{#if data.party.gstin}}GSTIN: {{data.party.gstin}}{{/if}}
+
+  <h2>Items</h2>
+  <table>
+    <thead>
+      <tr>
+        <th style="width: 38%">Description</th>
+        <th>HSN</th>
+        <th class="amount">Qty</th>
+        <th class="amount">Rate</th>
+        <th class="amount">Taxable</th>
+        <th class="amount">Tax</th>
+        <th class="amount">Total</th>
+      </tr>
+    </thead>
+    <tbody>
+      {{#each data.items}}
+      <tr>
+        <td>{{or description name}}</td>
+        <td>{{hsn}}</td>
+        <td class="amount">{{or qty quantity}}</td>
+        <td class="amount">{{rate}}</td>
+        <td class="amount">{{or taxable amount}}</td>
+        <td class="amount">{{or tax gst}}</td>
+        <td class="amount">{{total}}</td>
+      </tr>
+      {{/each}}
+    </tbody>
+  </table>
+
+  <table class="totals">
+    <tbody>
+      {{#if data.totals.taxable}}<tr><td>Taxable Value</td><td class="amount">{{data.totals.taxable}}</td></tr>{{/if}}
+      {{#if data.totals.cgst}}<tr><td>CGST</td><td class="amount">{{data.totals.cgst}}</td></tr>{{/if}}
+      {{#if data.totals.sgst}}<tr><td>SGST</td><td class="amount">{{data.totals.sgst}}</td></tr>{{/if}}
+      {{#if data.totals.igst}}<tr><td>IGST</td><td class="amount">{{data.totals.igst}}</td></tr>{{/if}}
+      {{#if data.totals.tax}}<tr><td>Total Tax</td><td class="amount">{{data.totals.tax}}</td></tr>{{/if}}
+      <tr class="grand-total"><td>Grand Total</td><td class="amount">{{or data.totals.grand_total data.total}}</td></tr>
+    </tbody>
+  </table>
+
+  {{#if data.amount_in_words}}
+    <p><strong>Amount in words:</strong> {{data.amount_in_words}}</p>
+  {{/if}}
+
+  {{#if data.notes}}
+    <div class="notes">{{data.notes}}</div>
+  {{/if}}
+</body>
+</html>