Migrating to 0.9.0

​

Breaking Changes

​

sign → certify rename

​

Migration Examples

​

React (<Document> prop)

  <Document
    title="Contract"
-   signature={{
+   certification={{
      certificatePem,
      privateKeyPem,
      reason: 'Approved',
    }}
  >

​

Node.js (@formepdf/core)

- import { signPdf } from '@formepdf/core';
+ import { certifyPdf } from '@formepdf/core';

- const signed = await signPdf(pdfBytes, config);
+ const certified = await certifyPdf(pdfBytes, config);

​

API endpoint

- POST /v1/sign
+ POST /v1/certify

​

Go SDK

- signed, err := client.Sign(pdfBytes, opts)
+ certified, err := client.Certify(pdfBytes, opts)

​

Python SDK

- signed = client.sign_pdf(pdf_bytes, opts)
+ certified = client.certify_pdf(pdf_bytes, opts)

​

New in 0.9.0

​

New API Endpoints

​

New Features

• Documents archive — every render auto-saved with metadata
• Certificate storage — save certificates, reference by ID
• Redaction templates — reusable pattern sets
• Text-search redaction — literal, regex, and preset patterns
• Audit trail — full operation history on documents
• Developer metadata — tag renders with custom key-value pairs
• Resource listing — list templates, documents, certificates via API

​

Bug Fixes

• SVG children API — JSX children auto-serialized to SVG content
• SVG opacity support (opacity, fill-opacity, stroke-opacity)
• Page style prop inheritance fix
• WASM time panic fix in certify and redact (browser WASM)
• PKCS#1 private key auto-conversion to PKCS#8

​

Upgrade Checklist

1. Update @formepdf/react, @formepdf/core, and @formepdf/cli to 0.9.0
2. Search your codebase for signature prop, signPdf, SignatureConfig, /v1/sign
3. Replace with certification, certifyPdf, CertificationConfig, /v1/certify
4. Update Go/Python SDK method calls if applicable
5. Test that existing certifications still verify correctly