n8n-nodes-pdfkraft 0.3.0 → 0.4.0

package/README.md

@@ -0,0 +1,131 @@
+# n8n-nodes-pdfkraft
+
+An n8n community node for [PDFKraft](https://pdfkraft.com) — generate PDFs and images from templates using your n8n workflows.
+
+## Installation
+
+In your n8n instance, go to **Settings → Community Nodes → Install** and enter:
+
+```
+n8n-nodes-pdfkraft
+```
+
+## Credentials
+
+After installation, create a **PDFKraft API** credential:
+
+1. Go to [pdfkraft.com/dashboard/account](https://pdfkraft.com/dashboard/account) and copy your API key.
+2. In n8n, go to **Credentials → New → PDFKraft API**.
+3. Paste your API key. Leave the Base URL as `https://api.pdfkraft.com/api/v1`.
+
+## PDFKraft Node
+
+Provides six operations:
+
+### Generate Document
+Queues a document for generation and returns immediately with a document ID. Use this when you want to fire-and-forget and handle completion via a webhook trigger.
+
+**Inputs:** Template, Payload (JSON), Filename (optional)  
+**Output:** `{ id, status: "pending", ... }`
+
+### Generate Document and Wait
+Generates a document and polls until complete. Returns the final document record including `download_url`.
+
+**Inputs:** Template, Payload (JSON), Filename, Timeout (seconds)  
+**Output:** `{ id, status: "success", download_url, filename, ... }`
+
+### Generate Document and Download
+The most common operation. Generates a document, waits for completion, and downloads the file — all in one step.
+
+**Inputs:** Template, Payload (JSON), Filename, Timeout, Output Field Name  
+**Output:** JSON (`id`, `filename`, `download_url`) + Binary file in the configured output field
+
+### Get Document
+Fetches the current status and metadata of any document by ID.
+
+**Inputs:** Document ID  
+**Output:** Full document record
+
+### Download Document
+Downloads a completed document as binary data.
+
+**Inputs:** Document ID, Output Field Name  
+**Output:** JSON (`documentId`, `filename`, `download_url`) + Binary file
+
+### List Documents
+Returns generated documents with optional status filtering and pagination.
+
+**Inputs:** Status Filter (All / Success / Pending / Failure), Limit or Return All  
+**Output:** One item per document
+
+### List Templates
+Returns all templates in your account.
+
+**Output:** One item per template
+
+---
+
+### Template Variables helper
+
+When you select a template, open the **Template Variables** dropdown to see what variables that template expects, along with their sample values. This is a read-only reference — it does not affect the generated document.
+
+To define sample data for your templates, open the template editor in PDFKraft and fill in the **Sample Data** section.
+
+---
+
+## PDFKraft Trigger Node
+
+Listens for webhook events from PDFKraft and triggers your workflow when documents are generated.
+
+### Setup
+
+1. In PDFKraft, go to **Settings → Webhooks → Create Endpoint**.
+2. Set the URL to the webhook URL shown in your n8n trigger node.
+3. Copy the **Secret** shown after creation.
+4. In n8n, paste the secret into the **Webhook Secret** field.
+
+### Options
+
+| Field | Description |
+|---|---|
+| Webhook Secret | The secret from your PDFKraft webhook endpoint. Used to verify request authenticity. |
+| Verify Signature | Recommended. Rejects requests that don't have a valid HMAC signature. |
+| Event Types | Choose Document Succeeded, Document Failed, or both. |
+| Template Filter | Only fire for documents from a specific template. Select "All Templates" to receive all events. |
+
+### Output
+
+The trigger outputs the full webhook payload:
+
+```json
+{
+  "event": "document.success",
+  "document": {
+    "id": "...",
+    "status": "success",
+    "filename": "invoice-1234.pdf",
+    "download_url": "https://...",
+    "document_template_identifier": "invoice",
+    "meta": {},
+    "generated_at": "2026-06-22T10:00:00.000Z"
+  }
+}
+```
+
+## Example Workflow
+
+**Generate an invoice PDF and save it to Google Drive:**
+
+1. **HTTP Request** (or any trigger) → provides order data
+2. **PDFKraft** → Generate Document and Download
+   - Template: `Invoice [PDF]`
+   - Payload: `{ "order_id": "{{ $json.id }}", "customer_name": "{{ $json.customer }}", "total": "{{ $json.total }}" }`
+   - Filename: `invoice-{{order_id}}.pdf`
+3. **Google Drive** → Upload File
+   - File Name: `{{ $json.filename }}`
+   - Binary Property: `data`
+
+## Resources
+
+- [PDFKraft](https://pdfkraft.com)
+- [n8n Community Nodes documentation](https://docs.n8n.io/integrations/community-nodes/)

package/dist/nodes/PDFKraft/PDFKraft.node.js

@@ -254,14 +254,14 @@ class PDFKraft {
                     const apiKey = credentials.apiKey;
                     const response = await this.helpers.request({
                         method: 'GET',
-                        url: `${baseUrl}/document_template_cards/${templateId}`,
+                        url: `${baseUrl}/document_templates/${templateId}`,
                         headers: { Authorization: `Bearer ${apiKey}` },
                         json: true,
                     });
-                    const sampleData = response.sample_data ?? {};
+                    const sampleData = response.sample_data ?? response.sample_data_draft ?? {};
                     const entries = Object.entries(sampleData);
                     if (entries.length === 0) {
-                        return [{ name: '(No sample data defined for this template)', value: '' }];
+                        return [{ name: '(No sample data defined — add it in the template editor under Sample Data)', value: '' }];
                     }
                     return entries.map(([key, value]) => ({
                         name: key,

package/dist/nodes/PDFKraftTrigger/PDFKraftTrigger.node.js

@@ -63,8 +63,6 @@ class PDFKraftTrigger {
                     typeOptions: { loadOptionsMethod: 'getTemplates' },
                     default: '*',
                     description: 'Only trigger for documents generated from this template. Select "All Templates" to receive events from every template.',
-                    // We inject "All Templates" as the first option so there is always a valid fallback
-                    options: [{ name: 'All Templates', value: '*' }],
                 },
             ],
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-pdfkraft",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "n8n community node for PDFKraft — generate PDFs and images via the PDFKraft API",
   "keywords": ["n8n-community-node-package"],
   "main": "dist/index.js",