@cosmicdrift/kumiko-renderer-puppeteer-client 0.378.0 → 0.379.0

package/dist/document-pdf.js

@@ -289,7 +289,7 @@ async function findOwnPdfTemplate(tplApi, ctx, slug, locale, scope) {
 }
 async function assembleDocument(input, ctx, markers, recordImages = "placeholder") {
     const { slug, locale, variables } = input;
-    const tplApi = createTemplateResolverApi(ctx.db);
+    const tplApi = createTemplateResolverApi(ctx.db, ctx.registry);
     const template = input.draft === undefined
         ? await resolvePdfTemplate(tplApi, ctx, slug, locale)
         : applyPdfDraft(await findStoredPdfTemplate(tplApi, ctx, slug, locale), await findOwnPdfTemplate(tplApi, ctx, slug, locale, input.draftScope ?? "tenant"), input.draft, slug, locale);

package/dist/feature.js

@@ -14,11 +14,12 @@ import { puppeteerStatusQuery } from "./status.query.js";
 //   - PUPPETEER_CLIENT_TIMEOUT_MS    default 60000
 //   - PUPPETEER_CLIENT_MAX_RETRIES   default 3
 //
-// **Retry strategy:** 5xx + network errors → exponential backoff (200ms,
+// **Retry strategy:** 502/503 + network errors → exponential backoff (200ms,
 // 400ms, 800ms) + jitter. 4xx → NO retry (config bug, fail immediately).
+// Other 5xx and client timeouts → NO retry (the render already ran).
 export function createRendererPuppeteerClientFeature() {
     return defineFeature("renderer-puppeteer-client", (r) => {
-        r.describe("A `renderer-foundation` plugin that prints documents to PDF through a separately deployed `puppeteer-service`. A `document-pdf` request names a stored template (`{ slug, locale, variables }`): the plugin resolves the template and its `pdf-layout` (header, signature and footer regions), embeds every image as a data URI, turns repeating table header rows into a real table head and sends the finished HTML to the service, which performs no network fetches itself. The page format, margins, file name pattern and title come from the template meta. A write handler renders with `renderPdfBeforeTransaction(ctx, { slug, locale, variables })` as its `beforeTransaction` phase, so the print service call holds no database connection, and stores the result with `storeRenderedPdf(ctx, event.prepared)` in the handler: a file plus a `rendered-pdf` record that keeps the template and layout version, so a stored document can always be traced to the text it was created from. The `puppeteer-status` query tells a TenantAdmin whether the service answers; while it does not, rendering fails with a `puppeteer_unavailable` error (HTTP 503) and no PDF is created. `image-snapshot` requests still take ready HTML in `payload.content`, which must embed all resources as data: URIs because the service fetches no http(s) resources. Configure the endpoint and token with `PUPPETEER_SERVICE_URL` and `PUPPETEER_AUTH_TOKEN`; the client retries 5xx and network errors with exponential backoff (default 3 retries), 4xx fails at once. The feature adds the `rendered_pdfs` table, so apps that mount it need a schema migration.");
+        r.describe("A `renderer-foundation` plugin that prints documents to PDF through a separately deployed `puppeteer-service`. A `document-pdf` request names a stored template (`{ slug, locale, variables }`): the plugin resolves the template and its `pdf-layout` (header, signature and footer regions), embeds every image as a data URI, turns repeating table header rows into a real table head and sends the finished HTML to the service, which performs no network fetches itself. The page format, margins, file name pattern and title come from the template meta. A write handler renders with `renderPdfBeforeTransaction(ctx, { slug, locale, variables })` as its `beforeTransaction` phase, so the print service call holds no database connection, and stores the result with `storeRenderedPdf(ctx, event.prepared)` in the handler: a file plus a `rendered-pdf` record that keeps the template and layout version, so a stored document can always be traced to the text it was created from. The `puppeteer-status` query tells a TenantAdmin whether the service answers; while it does not, rendering fails with a `puppeteer_unavailable` error (HTTP 503) and no PDF is created. `image-snapshot` requests still take ready HTML in `payload.content`, which must embed all resources as data: URIs because the service fetches no http(s) resources. Configure the endpoint and token with `PUPPETEER_SERVICE_URL` and `PUPPETEER_AUTH_TOKEN`; the client retries 502, 503 and network errors with exponential backoff (default 3 retries); 4xx, other 5xx and client timeouts fail at once, because the render has already run. The feature adds the `rendered_pdfs` table, so apps that mount it need a schema migration.");
         r.requires({ features: ["renderer-foundation"] });
         r.useExtension("renderer", "puppeteer", {
             kinds: ["document-pdf", "image-snapshot"],

package/kumiko-es-tables.json

@@ -0,0 +1,6 @@
+[
+  {
+    "module": "entity",
+    "export": "renderedPdfsTable"
+  }
+]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer-puppeteer-client",
-  "version": "0.378.0",
+  "version": "0.379.0",
   "description": "Renderer-Foundation plugin: HTTP client for puppeteer-service (PDF + image snapshot via remote browser).",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -19,13 +19,13 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.378.0",
-    "@cosmicdrift/kumiko-framework": "0.378.0",
-    "@cosmicdrift/kumiko-renderer-mail-html": "0.378.0",
-    "@cosmicdrift/kumiko-types": "0.378.0"
+    "@cosmicdrift/kumiko-bundled-features": "0.379.0",
+    "@cosmicdrift/kumiko-framework": "0.379.0",
+    "@cosmicdrift/kumiko-renderer-mail-html": "0.379.0",
+    "@cosmicdrift/kumiko-types": "0.379.0"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-testing": "0.378.0"
+    "@cosmicdrift/kumiko-testing": "0.379.0"
   },
   "repository": {
     "type": "git",
@@ -52,6 +52,7 @@
   },
   "files": [
     "dist",
+    "kumiko-es-tables.json",
     "src/changes.json",
     "README.md",
     "LICENSE"

package/src/changes.json

@@ -1,4 +1,16 @@
 [
+  {
+    "version": "0.379.0",
+    "type": "improvement",
+    "title": "Retry documentation matches the client",
+    "detail": "The client retries 502, 503 and network errors; other 5xx and client timeouts fail at once because the render already ran. The feature description no longer promises a retry for every 5xx."
+  },
+  {
+    "version": "0.379.0",
+    "type": "improvement",
+    "title": "Package ships its event-store table catalog",
+    "detail": "kumiko-es-tables.json is included in the published files; no runtime change."
+  },
   {
     "version": "0.365.0",
     "type": "improvement",