Troubleshooting

const { data, error } = await client.generate({ react: <Invoice /> });

if (error) {
  console.error(error.code, error.message);
  return;
}

// Success - use data.buffer

import { PdfnError } from '@pdfn/react';

class PdfnError extends Error {
  code: PdfnErrorCode;      // Machine-readable code
  message: string;           // Human-readable message
  suggestion?: string;       // How to fix it
  statusCode?: number;       // HTTP status (if applicable)
}

import { PdfnError } from '@pdfn/react';

if (error instanceof PdfnError) {
  console.error(`[${error.code}] ${error.message}`);
  if (error.suggestion) {
    console.error(`Fix: ${error.suggestion}`);
  }
}

[network_error] Cannot connect to pdfn server at http://localhost:3456

npx pdfn dev

[timeout_error] PDF generation timed out

const client = pdfn({
  timeout: 60000, // 60 seconds
});

[authentication_error] Invalid API key.

render() can only be used on the server.

Local font paths detected: ./fonts/custom.woff2
Edge runtimes don't have filesystem access.

// next.config.ts
import { withPdfn } from '@pdfn/next';
export default withPdfn()(nextConfig);

// vite.config.ts
import { pdfn } from '@pdfn/vite';
export default { plugins: [pdfn()] };

[render_error] Failed to render: ...