nexdf 0.1.0 → 0.1.1

package/README.md

@@ -9,6 +9,7 @@ Plug-and-play PDF generation for Next.js using customizable HTML/HTMX templates
 - Tailwind-friendly templates you can edit directly
 - A4-ready default template
 - Fast runtime path: browser prewarm + page pool reuse + template compile cache
+- Optional DB template resolver with file-template fallback
 
 ## Install
 
@@ -50,6 +51,7 @@ curl -X POST http://localhost:3000/api/pdf \
   -H "content-type: application/json" \
   -d '{
     "filename": "invoice.pdf",
+    "templateKey": "basic",
     "templatePath": "basic.html",
     "data": {
       "title": "Invoice #001",
@@ -86,6 +88,7 @@ Body:
 ```json
 {
   "filename": "document.pdf",
+  "templateKey": "basic",
   "templatePath": "basic.html",
   "data": {
     "title": "Any value"
@@ -93,6 +96,14 @@ Body:
 }
 ```
 
+`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`
@@ -123,4 +134,36 @@ export const POST = createPdfRouteHandler({
   defaultTemplate: "basic.html",
   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/index.d.ts

@@ -8,13 +8,20 @@ declare function listPlaceholders(template: string): string[];
 type PdfRequestBody = {
     data?: TemplateData;
     templatePath?: string;
+    templateKey?: string;
     filename?: string;
 };
+type ResolveTemplateContext = {
+    body: PdfRequestBody;
+    templatesDir: string;
+    defaultTemplate: string;
+};
 type CreatePdfRouteHandlerOptions = {
     templatesDir?: string;
     defaultTemplate?: string;
     prewarm?: boolean;
     poolSize?: number;
+    resolveTemplate?: (context: ResolveTemplateContext) => Promise<string | null>;
 };
 declare function createPdfRouteHandler(options?: CreatePdfRouteHandlerOptions): (request: Request) => Promise<Response>;
 

package/dist/index.js

@@ -189,16 +189,26 @@ function createPdfRouteHandler(options = {}) {
     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 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 });
       return new Response(new Uint8Array(pdfBuffer), {
         status: 200,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexdf",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Plug-and-play Next.js PDF endpoint with customizable HTML/HTMX templates",
   "license": "MIT",
   "keywords": [
@@ -48,4 +48,4 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.3"
   }
-}
+}