demat-kyc-pdf 1.0.0

package/README.md

@@ -0,0 +1,62 @@
+# demat-kyc-pdf
+
+`demat-kyc-pdf` is a Node.js package for:
+
+- generating KYC PDFs from the bundled EJS template
+- converting remote PDF documents into inline images for the template
+- extracting selected pages from an existing PDF
+
+## Install
+
+```bash
+npm install demat-kyc-pdf
+```
+
+## Use as a package
+
+```js
+const { createKycPdf, extractPdfPages } = require("demat-kyc-pdf");
+
+async function main() {
+  const pdf = await createKycPdf({
+    id: "12345",
+    applicant_name: "Aman Sharma",
+    aadhar: "https://example.com/aadhar.pdf",
+    pancard: "https://example.com/pan.pdf",
+    statement: "https://example.com/statement.pdf",
+  });
+
+  const extracted = await extractPdfPages({
+    pdfUrl: "https://example.com/source.pdf",
+    pages: [1, 3],
+  });
+
+  console.log(pdf.length, extracted.length);
+}
+
+main().catch(console.error);
+```
+
+## Use as an API server
+
+```bash
+PORT=3000 CHROME_PATH=/path/to/chrome npm start
+```
+
+Available routes:
+
+- `POST /api/generate-kyc`
+- `POST /api/kra`
+
+## Exported API
+
+- `createKycPdf(data, options?)`
+- `extractPdfPages({ pdfUrl, pages })`
+- `createKycApp(options?)`
+- `getPdfAsImages(pdfUrl, options?)`
+- `renderKycHtml(data, options?)`
+
+## Notes
+
+- The package expects a working Chromium or Chrome executable for Puppeteer.
+- By default it looks at `process.env.CHROME_PATH`, then `/snap/chromium/current/usr/lib/chromium-browser/chrome`.

package/index.js

@@ -0,0 +1,177 @@
+const express = require("express");
+const ejs = require("ejs");
+const path = require("path");
+const puppeteer = require("puppeteer");
+const { pdfToPng } = require("pdf-to-png-converter");
+const { PDFDocument } = require("pdf-lib");
+
+const DEFAULT_TEMPLATE_PATH = path.join(__dirname, "views", "kyc_template.ejs");
+const DEFAULT_CHROME_PATH =
+  process.env.CHROME_PATH || "/snap/chromium/current/usr/lib/chromium-browser/chrome";
+
+async function fetchPdfBuffer(pdfUrl, headers = {}) {
+  const response = await fetch(pdfUrl, {
+    headers: {
+      "User-Agent":
+        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122 Safari/537.36",
+      Accept: "application/pdf",
+      ...headers,
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to fetch PDF: ${response.status} ${response.statusText}`);
+  }
+
+  const arrayBuffer = await response.arrayBuffer();
+  return Buffer.from(arrayBuffer);
+}
+
+async function getPdfAsImages(pdfUrl, options = {}) {
+  try {
+    const pdfBuffer = await fetchPdfBuffer(pdfUrl, options.headers);
+    const pngPages = await pdfToPng(pdfBuffer, {
+      disableFontFace: true,
+      useSystemFonts: true,
+      viewportScale: 2.0,
+      pagesToProcess: options.pagesToProcess || [1],
+      ...options.converter,
+    });
+
+    return pngPages.map((page) => `data:image/png;base64,${page.content.toString("base64")}`);
+  } catch (error) {
+    if (options.throwOnError) {
+      throw error;
+    }
+
+    return [];
+  }
+}
+
+async function renderKycHtml(data, options = {}) {
+  return ejs.renderFile(options.templatePath || DEFAULT_TEMPLATE_PATH, { data }, { async: true });
+}
+
+async function createBrowser(browserOptions = {}) {
+  return puppeteer.launch({
+    executablePath: browserOptions.executablePath || DEFAULT_CHROME_PATH,
+    headless: true,
+    pipe: true,
+    timeout: 45000,
+    args: [
+      "--no-sandbox",
+      "--disable-setuid-sandbox",
+      "--disable-dev-shm-usage",
+      "--disable-gpu",
+      "--remote-debugging-pipe",
+      ...(browserOptions.args || []),
+    ],
+    ...browserOptions,
+  });
+}
+
+async function createKycPdf(input = {}, options = {}) {
+  const merged = { ...input };
+  const pdfImageFields = options.pdfImageFields || ["aadhar", "pancard", "statement"];
+
+  for (const field of pdfImageFields) {
+    if (merged[field]) {
+      merged[field] = await getPdfAsImages(merged[field], options.imageOptions);
+    }
+  }
+
+  const html = await renderKycHtml(merged, options);
+  const browser = await createBrowser(options.browser);
+
+  try {
+    const page = await browser.newPage();
+    await page.setContent(html, { waitUntil: "networkidle0" });
+    await page.emulateMediaType("screen");
+
+    return await page.pdf({
+      format: "A4",
+      printBackground: true,
+      margin: { top: "1mm", bottom: "1mm", left: "4mm", right: "4mm" },
+      ...options.pdf,
+    });
+  } finally {
+    await browser.close();
+  }
+}
+
+async function extractPdfPages({ pdfUrl, pages }) {
+  if (!pdfUrl) {
+    throw new Error("pdfUrl is required");
+  }
+
+  if (!Array.isArray(pages) || pages.length === 0) {
+    throw new Error("pages must be an array like [1, 2, 3]");
+  }
+
+  const pdfBuffer = await fetchPdfBuffer(pdfUrl);
+  const pdfDoc = await PDFDocument.load(pdfBuffer);
+  const pageIndexes = pages.map((page) => page - 1);
+  const newPdf = await PDFDocument.create();
+  const copiedPages = await newPdf.copyPages(pdfDoc, pageIndexes);
+
+  copiedPages.forEach((page) => newPdf.addPage(page));
+
+  return Buffer.from(await newPdf.save());
+}
+
+function createKycApp(options = {}) {
+  const app = express();
+
+  app.use(express.json({ limit: options.jsonLimit || "30mb" }));
+
+  app.post("/api/generate-kyc", async (req, res) => {
+    try {
+      const pdfBuffer = await createKycPdf(req.body || {}, options);
+      const filename = `KYC_${req.body?.id || "document"}.pdf`;
+
+      res.set({
+        "Content-Type": "application/pdf",
+        "Content-Disposition": `attachment; filename="${filename}"`,
+        "Content-Length": pdfBuffer.length,
+      });
+      res.send(pdfBuffer);
+    } catch (error) {
+      res.status(500).json({
+        error: "Failed to generate PDF",
+        details: error.message,
+      });
+    }
+  });
+
+  app.post("/api/kra", async (req, res) => {
+    try {
+      const pdfBuffer = await extractPdfPages(req.body || {});
+
+      res.set({
+        "Content-Type": "application/pdf",
+        "Content-Disposition": 'attachment; filename="extracted_pages.pdf"',
+        "Content-Length": pdfBuffer.length,
+      });
+      res.send(pdfBuffer);
+    } catch (error) {
+      const statusCode =
+        error.message === "pdfUrl is required" || error.message.startsWith("pages must be")
+          ? 400
+          : 500;
+
+      res.status(statusCode).json({ error: error.message });
+    }
+  });
+
+  return app;
+}
+
+module.exports = {
+  DEFAULT_TEMPLATE_PATH,
+  createKycApp,
+  createKycPdf,
+  extractPdfPages,
+  fetchPdfBuffer,
+  getPdfAsImages,
+  renderKycHtml,
+};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "demat-kyc-pdf",
+  "version": "1.0.0",
+  "description": "Generate KYC PDFs and extract PDF pages from Node.js.",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "views"
+  ],
+  "scripts": {
+    "start": "node server.js",
+    "dev": "nodemon server.js"
+  },
+  "keywords": [
+    "kyc",
+    "pdf",
+    "puppeteer",
+    "ejs",
+    "node"
+  ],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@sparticuz/chromium": "^143.0.4",
+    "dotenv": "^17.2.3",
+    "ejs": "^3.1.10",
+    "express": "^5.1.0",
+    "pdf-lib": "^1.17.1",
+    "pdf-to-png-converter": "^3.11.0",
+    "puppeteer": "^24.27.0",
+    "puppeteer-core": "^24.39.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.10"
+  }
+}