nexdf 0.1.0 → 0.1.2

package/README.md

@@ -1,14 +1,20 @@
 # nexdf
 
-Plug-and-play PDF generation for Next.js using customizable HTML/HTMX templates and Handlebars placeholders.
+Plug-and-play PDF generation for Next.js with two engines:
+
+- `chromium`: strongest CSS compatibility (Tailwind, advanced layouts), slower startup.
+- `native`: built-in fast HTML/CSS renderer (classic classes + HTMX-friendly templates), lower CSS coverage.
 
 ## Features
 
 - Ready `/api/pdf` endpoint (via one scaffold command)
 - Unlimited placeholders (`{{anyField}}`)
-- Tailwind-friendly templates you can edit directly
+- Two rendering engines (`chromium` and `native`)
+- Tailwind-friendly templates for Chromium path
+- Fast built-in native path for classic CSS classes
 - A4-ready default template
 - Fast runtime path: browser prewarm + page pool reuse + template compile cache
+- Optional DB template resolver with file-template fallback
 
 ## Install
 
@@ -28,6 +34,7 @@ This creates:
 
 - `app/api/pdf/route.ts`
 - `templates/pdf/basic.html`
+- `templates/pdf/native.html`
 
 2) Ensure Node runtime in route (generated by default):
 
@@ -39,6 +46,7 @@ export const runtime = "nodejs";
 export const POST = createPdfRouteHandler({
   templatesDir: process.cwd() + "/templates/pdf",
   defaultTemplate: "basic.html",
+  defaultEngine: "chromium", // or "native"
   poolSize: 2
 });
 ```
@@ -50,7 +58,9 @@ curl -X POST http://localhost:3000/api/pdf \
   -H "content-type: application/json" \
   -d '{
     "filename": "invoice.pdf",
-    "templatePath": "basic.html",
+    "engine": "native",
+    "templateKey": "basic",
+    "templatePath": "native.html",
     "data": {
       "title": "Invoice #001",
       "subtitle": "Thanks for your business",
@@ -86,6 +96,8 @@ Body:
 ```json
 {
   "filename": "document.pdf",
+  "engine": "chromium",
+  "templateKey": "basic",
   "templatePath": "basic.html",
   "data": {
     "title": "Any value"
@@ -93,10 +105,28 @@ Body:
 }
 ```
 
+Engine behavior:
+
+- `chromium`: best for Tailwind and modern CSS features.
+- `native`: best for speed with classic class-based CSS (`font-size`, `font-weight`, `color`, `margin-top`, `margin-bottom`, `line-height`, `text-align`).
+
+Recommended pairing:
+
+- `basic.html` + `engine: "chromium"`
+- `native.html` + `engine: "native"`
+
+`templateKey` is available when you use a custom template resolver.
+
+Template resolution behavior:
+
+1. If `resolveTemplate` returns HTML, that HTML is rendered.
+2. If `resolveTemplate` returns `null`, file-template rendering is used.
+3. File-template path is `templatePath` or `defaultTemplate`.
+
 ## Runtime requirements
 
 - Next route runtime must be `nodejs`
-- Chrome/Chromium must be available
+- Chrome/Chromium must be available only when using `chromium` engine
 - Set executable path if needed:
 
 ```bash
@@ -108,6 +138,7 @@ export PUPPETEER_EXECUTABLE_PATH="/Applications/Google Chrome.app/Contents/MacOS
 - Prewarms Chromium when route handler is created
 - Reuses hot pages via an internal pool (`poolSize`)
 - Caches compiled templates with file mtime invalidation
+- Native engine skips browser boot and is typically much faster for text/document layouts
 
 Note: true zero cold start is not possible if your hosting platform starts a brand-new container/process.
 
@@ -121,6 +152,39 @@ await prewarmPdfEngine({ poolSize: 2 });
 export const POST = createPdfRouteHandler({
   templatesDir: process.cwd() + "/templates/pdf",
   defaultTemplate: "basic.html",
+  defaultEngine: "chromium",
   poolSize: 2
 });
+```
+
+## Database-backed templates
+
+Use `resolveTemplate` to fetch HTML from DB and render server-side:
+
+```ts
+export const POST = createPdfRouteHandler({
+  templatesDir: process.cwd() + "/templates/pdf",
+  defaultTemplate: "basic.html",
+  poolSize: 2,
+  resolveTemplate: async ({ body }) => {
+    const templateKey = body.templateKey ?? "basic";
+    const html = await loadTemplateHtmlFromDb(templateKey);
+    return html;
+  }
+});
+```
+
+If `resolveTemplate` returns `null`, file-based template loading is used as fallback.
+
+Example request body with DB-first + file fallback support:
+
+```json
+{
+  "filename": "document.pdf",
+  "templateKey": "basic",
+  "templatePath": "basic.html",
+  "data": {
+    "title": "Any value"
+  }
+}
 ```

package/dist/cli/index.js

@@ -8,6 +8,7 @@ var cwd = process.cwd();
 var routeFilePath = path.join(cwd, "app", "api", "pdf", "route.ts");
 var templateDir = path.join(cwd, "templates", "pdf");
 var templatePath = path.join(templateDir, "basic.html");
+var nativeTemplatePath = path.join(templateDir, "native.html");
 var routeTemplate = `import { createPdfRouteHandler } from "nexdf";
 
 export const runtime = "nodejs";
@@ -15,6 +16,7 @@ export const runtime = "nodejs";
 export const POST = createPdfRouteHandler({
   templatesDir: process.cwd() + "/templates/pdf",
   defaultTemplate: "basic.html",
+  defaultEngine: "chromium",
   poolSize: 2
 });
 `;
@@ -70,6 +72,81 @@ var defaultHtmlTemplate = `<!doctype html>
   </body>
 </html>
 `;
+var nativeHtmlTemplate = `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{title}}</title>
+    <style>
+      body {
+        font-size: 11pt;
+        color: #111827;
+      }
+
+      .document-title {
+        font-size: 24pt;
+        font-weight: 700;
+        margin-bottom: 4pt;
+      }
+
+      .document-subtitle {
+        font-size: 11pt;
+        color: #4b5563;
+        margin-bottom: 14pt;
+      }
+
+      .section-title {
+        font-size: 13pt;
+        font-weight: 700;
+        margin-top: 10pt;
+        margin-bottom: 4pt;
+      }
+
+      .muted {
+        color: #6b7280;
+      }
+
+      .small {
+        font-size: 10pt;
+      }
+
+      .row {
+        margin-bottom: 2pt;
+      }
+
+      .summary {
+        margin-top: 8pt;
+        margin-bottom: 10pt;
+        line-height: 1.55;
+      }
+
+      .footer {
+        margin-top: 18pt;
+        font-size: 9pt;
+        color: #9ca3af;
+      }
+    </style>
+  </head>
+  <body>
+    <h1 class="document-title">{{title}}</h1>
+    <p class="document-subtitle">{{subtitle}}</p>
+
+    <h2 class="section-title">From</h2>
+    <p class="row">{{fromName}}</p>
+    <p class="row muted">{{fromEmail}}</p>
+
+    <h2 class="section-title">To</h2>
+    <p class="row">{{toName}}</p>
+    <p class="row muted">{{toEmail}}</p>
+
+    <h2 class="section-title">Summary</h2>
+    <p class="summary">{{summary}}</p>
+
+    <p class="footer">Generated on {{generatedAt}}</p>
+  </body>
+</html>
+`;
 async function exists(filePath) {
   try {
     await access(filePath, fsConstants.F_OK);
@@ -93,6 +170,12 @@ async function main() {
   } else {
     console.log("Skipped templates/pdf/basic.html (already exists)");
   }
+  if (!await exists(nativeTemplatePath)) {
+    await writeFile(nativeTemplatePath, nativeHtmlTemplate, "utf8");
+    console.log("Created templates/pdf/native.html");
+  } else {
+    console.log("Skipped templates/pdf/native.html (already exists)");
+  }
   console.log("PDF endpoint is ready at /api/pdf");
 }
 main().catch((error) => {

package/dist/index.d.ts

@@ -1,5 +1,19 @@
 import { PDFOptions } from 'puppeteer-core';
 
+type PdfEngine = "chromium" | "native";
+type GeneratePdfInput = {
+    html: string;
+    engine?: PdfEngine;
+    pdf?: PDFOptions;
+    executablePath?: string;
+};
+type PrewarmPdfEngineOptions = {
+    executablePath?: string;
+    poolSize?: number;
+};
+declare function prewarmPdfEngine(options?: PrewarmPdfEngineOptions): Promise<void>;
+declare function generatePdfBuffer(input: GeneratePdfInput): Promise<Buffer>;
+
 type TemplateData = Record<string, unknown>;
 declare function renderTemplateString(template: string, data: TemplateData): string;
 declare function renderTemplateFile(templatePath: string, data: TemplateData): Promise<string>;
@@ -8,26 +22,23 @@ declare function listPlaceholders(template: string): string[];
 type PdfRequestBody = {
     data?: TemplateData;
     templatePath?: string;
+    templateKey?: string;
     filename?: string;
+    engine?: PdfEngine;
+};
+type ResolveTemplateContext = {
+    body: PdfRequestBody;
+    templatesDir: string;
+    defaultTemplate: string;
 };
 type CreatePdfRouteHandlerOptions = {
     templatesDir?: string;
     defaultTemplate?: string;
+    defaultEngine?: PdfEngine;
     prewarm?: boolean;
     poolSize?: number;
+    resolveTemplate?: (context: ResolveTemplateContext) => Promise<string | null>;
 };
 declare function createPdfRouteHandler(options?: CreatePdfRouteHandlerOptions): (request: Request) => Promise<Response>;
 
-type GeneratePdfInput = {
-    html: string;
-    pdf?: PDFOptions;
-    executablePath?: string;
-};
-type PrewarmPdfEngineOptions = {
-    executablePath?: string;
-    poolSize?: number;
-};
-declare function prewarmPdfEngine(options?: PrewarmPdfEngineOptions): Promise<void>;
-declare function generatePdfBuffer(input: GeneratePdfInput): Promise<Buffer>;
-
-export { type CreatePdfRouteHandlerOptions, type GeneratePdfInput, type PdfRequestBody, type PrewarmPdfEngineOptions, type TemplateData, createPdfRouteHandler, generatePdfBuffer, listPlaceholders, prewarmPdfEngine, renderTemplateFile, renderTemplateString };
+export { type CreatePdfRouteHandlerOptions, type GeneratePdfInput, type PdfEngine, type PdfRequestBody, type PrewarmPdfEngineOptions, type TemplateData, createPdfRouteHandler, generatePdfBuffer, listPlaceholders, prewarmPdfEngine, renderTemplateFile, renderTemplateString };

package/dist/index.js

@@ -5,6 +5,393 @@ import path from "path";
 
 // src/pdf.ts
 import puppeteer from "puppeteer-core";
+
+// src/native.ts
+import { PDFDocument, StandardFonts, rgb } from "pdf-lib";
+import { parse } from "node-html-parser";
+var A4_WIDTH = 595.28;
+var A4_HEIGHT = 841.89;
+var BLOCK_TAGS = /* @__PURE__ */ new Set([
+  "html",
+  "body",
+  "main",
+  "section",
+  "article",
+  "header",
+  "footer",
+  "aside",
+  "nav",
+  "div",
+  "p",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "ul",
+  "ol",
+  "li"
+]);
+var DEFAULT_STYLE = {
+  fontSize: 11,
+  fontWeight: "normal",
+  color: rgb(0, 0, 0),
+  lineHeight: 1.4,
+  marginTop: 0,
+  marginBottom: 0,
+  textAlign: "left"
+};
+var HEADING_STYLES = {
+  h1: { fontSize: 28, fontWeight: "bold", marginBottom: 8 },
+  h2: { fontSize: 22, fontWeight: "bold", marginBottom: 6 },
+  h3: { fontSize: 18, fontWeight: "bold", marginBottom: 5 },
+  h4: { fontSize: 15, fontWeight: "bold", marginBottom: 4 },
+  h5: { fontSize: 13, fontWeight: "bold", marginBottom: 4 },
+  h6: { fontSize: 11, fontWeight: "bold", marginBottom: 3 }
+};
+var BLOCK_DEFAULTS = {
+  p: { marginBottom: 6 },
+  div: { marginBottom: 4 },
+  section: { marginBottom: 6 },
+  article: { marginBottom: 6 },
+  header: { marginBottom: 8 },
+  footer: { marginTop: 8 },
+  li: { marginBottom: 2 },
+  ul: { marginBottom: 4 },
+  ol: { marginBottom: 4 }
+};
+function toPoints(value) {
+  const normalized = value.trim().toLowerCase();
+  if (!normalized) {
+    return null;
+  }
+  if (normalized.endsWith("px")) {
+    const px = Number.parseFloat(normalized.slice(0, -2));
+    return Number.isFinite(px) ? px * 0.75 : null;
+  }
+  if (normalized.endsWith("pt")) {
+    const pt = Number.parseFloat(normalized.slice(0, -2));
+    return Number.isFinite(pt) ? pt : null;
+  }
+  const raw = Number.parseFloat(normalized);
+  return Number.isFinite(raw) ? raw : null;
+}
+function parseHexColor(input) {
+  const value = input.trim().toLowerCase();
+  if (!value.startsWith("#")) {
+    return null;
+  }
+  const hex = value.slice(1);
+  if (hex.length === 3) {
+    const r = Number.parseInt(hex[0] + hex[0], 16);
+    const g = Number.parseInt(hex[1] + hex[1], 16);
+    const b = Number.parseInt(hex[2] + hex[2], 16);
+    return rgb(r / 255, g / 255, b / 255);
+  }
+  if (hex.length === 6) {
+    const r = Number.parseInt(hex.slice(0, 2), 16);
+    const g = Number.parseInt(hex.slice(2, 4), 16);
+    const b = Number.parseInt(hex.slice(4, 6), 16);
+    return rgb(r / 255, g / 255, b / 255);
+  }
+  return null;
+}
+function parseRgbColor(input) {
+  const match = input.trim().match(/^rgb\((\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\)$/i);
+  if (!match) {
+    return null;
+  }
+  const r = Number.parseInt(match[1], 10);
+  const g = Number.parseInt(match[2], 10);
+  const b = Number.parseInt(match[3], 10);
+  if (r > 255 || g > 255 || b > 255) {
+    return null;
+  }
+  return rgb(r / 255, g / 255, b / 255);
+}
+function parseColor(value) {
+  return parseHexColor(value) ?? parseRgbColor(value);
+}
+function parseStyleDeclarations(cssText) {
+  const out = {};
+  const parts = cssText.split(";");
+  for (const part of parts) {
+    const index = part.indexOf(":");
+    if (index === -1) {
+      continue;
+    }
+    const property = part.slice(0, index).trim().toLowerCase();
+    const value = part.slice(index + 1).trim();
+    if (!property || !value) {
+      continue;
+    }
+    if (property === "font-size") {
+      const parsed = toPoints(value);
+      if (parsed !== null) {
+        out.fontSize = parsed;
+      }
+      continue;
+    }
+    if (property === "font-weight") {
+      if (value === "bold" || Number.parseInt(value, 10) >= 600) {
+        out.fontWeight = "bold";
+      } else {
+        out.fontWeight = "normal";
+      }
+      continue;
+    }
+    if (property === "color") {
+      const parsed = parseColor(value);
+      if (parsed) {
+        out.color = parsed;
+      }
+      continue;
+    }
+    if (property === "line-height") {
+      const numeric = Number.parseFloat(value);
+      if (Number.isFinite(numeric) && numeric > 0) {
+        out.lineHeight = numeric;
+      } else {
+        const parsed = toPoints(value);
+        if (parsed !== null) {
+          out.lineHeight = parsed;
+        }
+      }
+      continue;
+    }
+    if (property === "margin-top") {
+      const parsed = toPoints(value);
+      if (parsed !== null) {
+        out.marginTop = parsed;
+      }
+      continue;
+    }
+    if (property === "margin-bottom") {
+      const parsed = toPoints(value);
+      if (parsed !== null) {
+        out.marginBottom = parsed;
+      }
+      continue;
+    }
+    if (property === "text-align") {
+      if (value === "left" || value === "center" || value === "right") {
+        out.textAlign = value;
+      }
+    }
+  }
+  return out;
+}
+function extractClassStyles(html) {
+  const map = /* @__PURE__ */ new Map();
+  const styleRegex = /<style[^>]*>([\s\S]*?)<\/style>/gi;
+  let styleMatch;
+  while (styleMatch = styleRegex.exec(html)) {
+    const css = styleMatch[1] ?? "";
+    const ruleRegex = /([^{}]+)\{([^{}]+)\}/g;
+    let ruleMatch;
+    while (ruleMatch = ruleRegex.exec(css)) {
+      const selector = ruleMatch[1]?.trim() ?? "";
+      const declarations = ruleMatch[2] ?? "";
+      const parsed = parseStyleDeclarations(declarations);
+      const selectors = selector.split(",").map((value) => value.trim());
+      for (const currentSelector of selectors) {
+        if (!currentSelector.startsWith(".")) {
+          continue;
+        }
+        const className = currentSelector.slice(1).split(/\s|:|>/)[0]?.trim();
+        if (!className) {
+          continue;
+        }
+        map.set(className, {
+          ...map.get(className) ?? {},
+          ...parsed
+        });
+      }
+    }
+  }
+  return map;
+}
+function mergeStyles(...styles) {
+  return styles.reduce(
+    (acc, item) => ({
+      ...acc,
+      ...item,
+      color: item.color ?? acc.color
+    }),
+    { ...DEFAULT_STYLE }
+  );
+}
+function getTagStyle(tag) {
+  const heading = HEADING_STYLES[tag];
+  if (heading) {
+    return heading;
+  }
+  return BLOCK_DEFAULTS[tag] ?? {};
+}
+function getElementStyle(element, classStyles, inherited) {
+  const tag = element.tagName.toLowerCase();
+  const classAttr = element.getAttribute("class") ?? "";
+  const inlineStyle = element.getAttribute("style") ?? "";
+  const classes = classAttr.split(/\s+/).map((value) => value.trim()).filter(Boolean);
+  const classMerged = classes.reduce((acc, className) => {
+    return {
+      ...acc,
+      ...classStyles.get(className) ?? {}
+    };
+  }, {});
+  const inlineParsed = inlineStyle ? parseStyleDeclarations(inlineStyle) : {};
+  return mergeStyles(inherited, getTagStyle(tag), classMerged, inlineParsed);
+}
+function ensureRoom(state, heightNeeded) {
+  if (state.cursorY - heightNeeded >= state.marginBottom) {
+    return;
+  }
+  state.page = state.doc.addPage([state.pageWidth, state.pageHeight]);
+  state.cursorY = state.pageHeight - state.marginTop;
+}
+function collapseWhitespace(value) {
+  return value.replace(/\s+/g, " ").trim();
+}
+function wrapText(text, font, fontSize, maxWidth) {
+  const words = text.split(/\s+/).filter(Boolean);
+  if (words.length === 0) {
+    return [];
+  }
+  const lines = [];
+  let current = words[0];
+  for (let index = 1; index < words.length; index += 1) {
+    const candidate = `${current} ${words[index]}`;
+    if (font.widthOfTextAtSize(candidate, fontSize) <= maxWidth) {
+      current = candidate;
+    } else {
+      lines.push(current);
+      current = words[index];
+    }
+  }
+  lines.push(current);
+  return lines;
+}
+function drawTextBlock(state, text, style) {
+  const cleaned = collapseWhitespace(text);
+  if (!cleaned) {
+    return;
+  }
+  const font = style.fontWeight === "bold" ? state.fontBold : state.fontRegular;
+  const fontSize = style.fontSize;
+  const resolvedLineHeight = style.lineHeight > 3 ? style.lineHeight : style.lineHeight * fontSize;
+  const maxWidth = state.pageWidth - state.marginLeft - state.marginRight;
+  const lines = wrapText(cleaned, font, fontSize, maxWidth);
+  for (const line of lines) {
+    ensureRoom(state, resolvedLineHeight);
+    const lineWidth = font.widthOfTextAtSize(line, fontSize);
+    let x = state.marginLeft;
+    if (style.textAlign === "center") {
+      x = state.marginLeft + (maxWidth - lineWidth) / 2;
+    } else if (style.textAlign === "right") {
+      x = state.pageWidth - state.marginRight - lineWidth;
+    }
+    state.page.drawText(line, {
+      x,
+      y: state.cursorY - resolvedLineHeight,
+      size: fontSize,
+      font,
+      color: style.color
+    });
+    state.cursorY -= resolvedLineHeight;
+  }
+}
+function addVerticalGap(state, points) {
+  if (points <= 0) {
+    return;
+  }
+  ensureRoom(state, points);
+  state.cursorY -= points;
+}
+function renderNode(node, state, inheritedStyle, classStyles, listDepth = 0) {
+  if (node.nodeType === 3) {
+    const textNode = node;
+    drawTextBlock(state, textNode.rawText, inheritedStyle);
+    return;
+  }
+  if (node.nodeType !== 1) {
+    return;
+  }
+  const element = node;
+  const tag = element.tagName.toLowerCase();
+  if (tag === "style" || tag === "script" || tag === "head") {
+    return;
+  }
+  const style = getElementStyle(element, classStyles, inheritedStyle);
+  if (tag === "br") {
+    const resolvedLineHeight = style.lineHeight > 3 ? style.lineHeight : style.lineHeight * style.fontSize;
+    addVerticalGap(state, resolvedLineHeight);
+    return;
+  }
+  if (tag === "hr") {
+    addVerticalGap(state, 4);
+    ensureRoom(state, 8);
+    state.page.drawLine({
+      start: { x: state.marginLeft, y: state.cursorY },
+      end: { x: state.pageWidth - state.marginRight, y: state.cursorY },
+      thickness: 0.8,
+      color: rgb(0.82, 0.82, 0.82)
+    });
+    addVerticalGap(state, 8);
+    return;
+  }
+  const isBlock = BLOCK_TAGS.has(tag);
+  if (isBlock) {
+    addVerticalGap(state, style.marginTop);
+  }
+  if (tag === "li") {
+    const bulletIndent = 10 + listDepth * 8;
+    drawTextBlock(state, `${" ".repeat(Math.max(0, bulletIndent / 4))}\u2022 ${element.textContent}`, style);
+  } else if (tag === "ul" || tag === "ol") {
+    for (const child of element.childNodes) {
+      renderNode(child, state, style, classStyles, listDepth + 1);
+    }
+  } else if (element.childNodes.length > 0) {
+    for (const child of element.childNodes) {
+      renderNode(child, state, style, classStyles, listDepth);
+    }
+  } else {
+    drawTextBlock(state, element.textContent, style);
+  }
+  if (isBlock) {
+    addVerticalGap(state, style.marginBottom);
+  }
+}
+async function generateNativePdfBuffer(html) {
+  const classStyles = extractClassStyles(html);
+  const root = parse(html);
+  const pdfDoc = await PDFDocument.create();
+  const fontRegular = await pdfDoc.embedFont(StandardFonts.Helvetica);
+  const fontBold = await pdfDoc.embedFont(StandardFonts.HelveticaBold);
+  const page = pdfDoc.addPage([A4_WIDTH, A4_HEIGHT]);
+  const state = {
+    doc: pdfDoc,
+    page,
+    fontRegular,
+    fontBold,
+    cursorY: A4_HEIGHT - 36,
+    pageWidth: A4_WIDTH,
+    pageHeight: A4_HEIGHT,
+    marginLeft: 36,
+    marginRight: 36,
+    marginTop: 36,
+    marginBottom: 36
+  };
+  const body = root.querySelector("body");
+  const startNode = body ?? root;
+  for (const child of startNode.childNodes) {
+    renderNode(child, state, DEFAULT_STYLE, classStyles);
+  }
+  const bytes = await pdfDoc.save();
+  return Buffer.from(bytes);
+}
+
+// src/pdf.ts
 var DEFAULT_EXECUTABLE_PATHS = [
   process.env.PUPPETEER_EXECUTABLE_PATH,
   "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
@@ -100,6 +487,9 @@ process.once("SIGTERM", () => {
   void closeSharedBrowser().finally(() => process.exit(0));
 });
 async function generatePdfBuffer(input) {
+  if (input.engine === "native") {
+    return generateNativePdfBuffer(input.html);
+  }
   const executablePath = getExecutablePath(input.executablePath);
   const browser = await getBrowser(executablePath);
   const page = await acquirePage(browser);
@@ -181,25 +571,40 @@ var DEFAULT_TEMPLATE_NAME = "basic.html";
 function createPdfRouteHandler(options = {}) {
   const templatesDir = options.templatesDir ?? path.join(process.cwd(), "templates", "pdf");
   const defaultTemplate = options.defaultTemplate ?? DEFAULT_TEMPLATE_NAME;
+  const defaultEngine = options.defaultEngine ?? "chromium";
   const prewarm = options.prewarm ?? true;
-  if (prewarm) {
+  if (prewarm && defaultEngine === "chromium") {
     void prewarmPdfEngine({ poolSize: options.poolSize });
   }
   return async function POST(request) {
     try {
       const body = await request.json();
       const filename = body.filename || "document.pdf";
-      const templateName = body.templatePath || defaultTemplate;
-      const safeTemplatePath = path.resolve(templatesDir, templateName);
-      if (!safeTemplatePath.startsWith(path.resolve(templatesDir))) {
-        return Response.json(
-          { error: "Invalid templatePath. Template must be inside templates directory." },
-          { status: 400 }
-        );
+      const engine = body.engine ?? defaultEngine;
+      const resolvedTemplate = options.resolveTemplate ? await options.resolveTemplate({
+        body,
+        templatesDir,
+        defaultTemplate
+      }) : null;
+      let html;
+      if (resolvedTemplate) {
+        html = renderTemplateString(resolvedTemplate, body.data ?? {});
+      } else {
+        const templateName = body.templatePath || defaultTemplate;
+        const safeTemplatePath = path.resolve(templatesDir, templateName);
+        if (!safeTemplatePath.startsWith(path.resolve(templatesDir))) {
+          return Response.json(
+            { error: "Invalid templatePath. Template must be inside templates directory." },
+            { status: 400 }
+          );
+        }
+        await access(safeTemplatePath, fsConstants.R_OK);
+        html = await renderTemplateFile(safeTemplatePath, body.data ?? {});
       }
-      await access(safeTemplatePath, fsConstants.R_OK);
-      const html = await renderTemplateFile(safeTemplatePath, body.data ?? {});
-      const pdfBuffer = await generatePdfBuffer({ html });
+      const pdfBuffer = await generatePdfBuffer({
+        html,
+        engine
+      });
       return new Response(new Uint8Array(pdfBuffer), {
         status: 200,
         headers: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexdf",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Plug-and-play Next.js PDF endpoint with customizable HTML/HTMX templates",
   "license": "MIT",
   "keywords": [
@@ -41,6 +41,8 @@
   },
   "dependencies": {
     "handlebars": "^4.7.8",
+    "node-html-parser": "^7.0.1",
+    "pdf-lib": "^1.17.1",
     "puppeteer-core": "^24.2.0"
   },
   "devDependencies": {
@@ -48,4 +50,4 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.3"
   }
-}
+}

package/templates/native/native.html

@@ -0,0 +1,74 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{title}}</title>
+    <style>
+      body {
+        font-size: 11pt;
+        color: #111827;
+      }
+
+      .document-title {
+        font-size: 24pt;
+        font-weight: 700;
+        margin-bottom: 4pt;
+      }
+
+      .document-subtitle {
+        font-size: 11pt;
+        color: #4b5563;
+        margin-bottom: 14pt;
+      }
+
+      .section-title {
+        font-size: 13pt;
+        font-weight: 700;
+        margin-top: 10pt;
+        margin-bottom: 4pt;
+      }
+
+      .muted {
+        color: #6b7280;
+      }
+
+      .small {
+        font-size: 10pt;
+      }
+
+      .row {
+        margin-bottom: 2pt;
+      }
+
+      .summary {
+        margin-top: 8pt;
+        margin-bottom: 10pt;
+        line-height: 1.55;
+      }
+
+      .footer {
+        margin-top: 18pt;
+        font-size: 9pt;
+        color: #9ca3af;
+      }
+    </style>
+  </head>
+  <body>
+    <h1 class="document-title">{{title}}</h1>
+    <p class="document-subtitle">{{subtitle}}</p>
+
+    <h2 class="section-title">From</h2>
+    <p class="row">{{fromName}}</p>
+    <p class="row muted">{{fromEmail}}</p>
+
+    <h2 class="section-title">To</h2>
+    <p class="row">{{toName}}</p>
+    <p class="row muted">{{toEmail}}</p>
+
+    <h2 class="section-title">Summary</h2>
+    <p class="summary">{{summary}}</p>
+
+    <p class="footer">Generated on {{generatedAt}}</p>
+  </body>
+</html>