Node.js

import { PdfNoodle } from 'pdfnoodle';

const pdfnoodle = new PdfNoodle('pdfnoodle_api_...');

const pdfnoodle = new PdfNoodle(); // reads from PDFNOODLE_API_KEY

const { data, error } = await pdfnoodle.pdf.fromHTML({ html: '<h1>Hello</h1>' });

if (error) {
  // error.name is a typed error code like "validation_error" or "rate_limit_exceeded"
  console.error(error.name, error.message);
  return;
}

// TypeScript knows data is not null here
console.log(data.signedUrl);

import { PdfNoodle } from 'pdfnoodle';

const pdfnoodle = new PdfNoodle('pdfnoodle_api_...');

const { data, error } = await pdfnoodle.pdf.fromHTML({
  html: `
    <html>
      <head>
        <style>
          body { font-family: Arial, sans-serif; padding: 40px; }
          h1 { color: #F55C3D; }
          table { width: 100%; border-collapse: collapse; margin-top: 20px; }
          th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
          th { background-color: #f4f4f4; }
          .total { font-weight: bold; font-size: 1.2em; }
        </style>
      </head>
      <body>
        <h1>Invoice #INV-2025-042</h1>
        <p>Bill to: Acme Corp</p>
        <table>
          <tr><th>Item</th><th>Amount</th></tr>
          <tr><td>Web Development</td><td>$2,500</td></tr>
          <tr><td>Hosting (Annual)</td><td>$500</td></tr>
        </table>
        <p class="total">Total: $3,000</p>
      </body>
    </html>
  `,
  pdfParams: {
    format: 'A4',
    printBackground: true,
    margin: { top: '20mm', bottom: '20mm', left: '15mm', right: '15mm' },
  },
});

if (error) {
  console.error('PDF generation failed:', error.message);
  return;
}

console.log('Download your PDF:', data.signedUrl);
// => https://pdforge-production.s3.us-east-2.amazonaws.com/...
console.log('File size:', data.metadata.fileSize);
// => "4.066 kB"

import { PdfNoodle } from 'pdfnoodle';

const pdfnoodle = new PdfNoodle('pdfnoodle_api_...');

const { data, error } = await pdfnoodle.pdf.fromTemplate({
  templateId: 'your-invoice-template-id',
  data: {
    invoice_number: 'INV-2025-042',
    company_info: {
      name: 'Acme Corp',
      address_line_1: '123 Main Street, New York, NY',
    },
    items: [
      { description: 'Web Development', quantity: '1', price: '$2,500' },
      { description: 'Hosting (Annual)', quantity: '1', price: '$500' },
    ],
    total: '$3,000',
    due_date: 'March 1, 2025',
  },
});

if (error) {
  console.error('Failed:', error.message);
  return;
}

console.log('Download your PDF:', data.signedUrl);

import { PdfNoodle } from 'pdfnoodle';

const pdfnoodle = new PdfNoodle('pdfnoodle_api_...');

// Step 1: Start template creation
const { data: created, error: createError } = await pdfnoodle.templates.create({
  prompt: 'Create a professional invoice template with company logo, billing address, itemized table with description/quantity/price columns, subtotal, tax, and total. Use a clean blue and white color scheme.',
  displayName: 'Professional Invoice',
});

if (createError) {
  console.error('Failed to create template:', createError.message);
  return;
}

console.log('Template creation started:', created.templateId);
// => "a1b2c3d4e5"

// Step 2: Poll until ready (template creation takes ~2 minutes)
let template;
while (true) {
  const { data } = await pdfnoodle.templates.get(created.templateId);

  // Check if it's still being created (has a status field)
  const status = data as Record<string, unknown>;
  if (status?.status === 'SUCCESS') {
    console.log('Template is ready!');
    break;
  }
  if (status?.status === 'FAILED') {
    console.error('Template creation failed');
    return;
  }

  // Still creating, wait 15 seconds
  await new Promise((resolve) => setTimeout(resolve, 15000));
}

// Step 3: Check what variables the template expects
const { data: variables } = await pdfnoodle.templates.getVariables(created.templateId);
console.log('Template variables:', JSON.stringify(variables, null, 2));
// => { "invoice_number": "string", "items": [{ "description": "string", ... }], ... }

// Step 4: List all your templates
const { data: list } = await pdfnoodle.templates.list();
console.log('All templates:', list.templates);
// => [{ id: "a1b2c3d4e5", displayName: "Professional Invoice" }, ...]

import { PdfNoodle } from 'pdfnoodle';

const pdfnoodle = new PdfNoodle('pdfnoodle_api_...');

const { data, error } = await pdfnoodle.tools.mergePdfs({
  urls: [
    'https://example.com/cover-page.pdf',
    'https://example.com/chapter-1.pdf',
    'https://example.com/chapter-2.pdf',
    'https://example.com/appendix.pdf',
  ],
  finalFilename: 'complete-report.pdf',
  expiration: 7200, // signed URL valid for 2 hours
});

if (error) {
  console.error('Merge failed:', error.message);
  return;
}

console.log('Merged PDF:', data.url);
// => https://s3.amazonaws.com/.../complete-report.pdf
console.log('Valid until:', data.urlValidUntil);

const { data, error } = await pdfnoodle.pdf.fromHTML(
  { html: '<h1>Large document</h1>' },
  {
    pollInterval: 2000,        // initial delay between polls (default: 2000ms)
    maxAttempts: 20,            // max polls before timeout (default: 20)
    backoffMultiplier: 1.5,     // exponential backoff factor (default: 1.5)
    maxPollInterval: 10000,     // maximum delay cap (default: 10000ms)
    signal: controller.signal,  // AbortSignal to cancel polling
  },
);

const controller = new AbortController();

// Cancel after 60 seconds
setTimeout(() => controller.abort(), 60000);

const { data, error } = await pdfnoodle.pdf.fromHTML(
  { html: '<h1>Hello</h1>' },
  { signal: controller.signal },
);

if (error?.name === 'polling_aborted') {
  console.log('Generation was cancelled');
}