renderer-puppeteer-client

Enterprise Part of the commercial Kumiko Enterprise offering — not in the open framework.

A renderer-foundation plugin that handles kind="document-pdf" and kind="image-snapshot" by forwarding the render request over HTTP to a separately deployed puppeteer-service. Configure the service endpoint and auth token via PUPPETEER_SERVICE_URL and PUPPETEER_AUTH_TOKEN env vars. The client retries on 5xx and network errors with exponential backoff (default 3 retries); 4xx responses fail immediately. The plugin returns raw bytes — callers are responsible for persisting to S3 or streaming to the client. Register it alongside renderer-foundation and reach it through foundation.createRendererForTenant({ kind: "document-pdf" }).render(...). Use this when you need PDF generation or screenshot capabilities without bundling a browser into the app process.

How it fits

What this feature needs to run (Requires, top) and the write commands it provides (Provides, bottom).

flowchart TB
  n_renderer_puppeteer_client["renderer-puppeteer-client"]
  subgraph how_reqs["Requires"]
    n_renderer_foundation["renderer-foundation"]
  end
  n_renderer_foundation --> n_renderer_puppeteer_client

Dependencies

• Requires: renderer-foundation
• Activation: always on (not toggleable)

Extensions & cross-feature APIs

• Registers extension: renderer → puppeteer