@cosmicdrift/kumiko-renderer-puppeteer-client 0.386.0 → 0.388.0

package/LICENSE

@@ -1,57 +1,21 @@
-Business Source License 1.1
-
-Parameters
-
-Licensor:             Marc Frost
-
-Licensed Work:        @cosmicdrift/kumiko-renderer-puppeteer-client
-                      The Licensed Work is © 2026 Marc Frost.
-
-Additional Use Grant: 
-You may use the Licensed Work in production for any purpose, including 
-commercially, EXCEPT for the Restricted Use. 
-
-"Restricted Use" is defined as using the Licensed Work to provide a platform 
-or service to third parties that allows them to host, deploy, or run their 
-own applications built with the Licensed Work. This includes, but is not 
-limited to: managed hosting services, software-as-a-service (SaaS) platforms, 
-platform-as-a-service (PaaS), developer platforms, or any multi-tenant 
-managed offering of the Licensed Work.
-
-This restriction does not apply to the Licensor, any entity controlled by, 
-controlling, or under common control with the Licensor ("Affiliates"), or 
-contractors acting on their behalf. The Licensor remains free to use the 
-Licensed Work for any purpose, including for the operation of kumiko.rocks.
-
-Change Date:          2030-05-05
-Change License:       Apache License, Version 2.0
-
-
-Terms
-
-The Licensor hereby grants you the right to copy, modify, create derivative works, 
-redistribute, and make non-production use of the Licensed Work. The Licensor may 
-make an Additional Use Grant, above, permitting limited production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly 
-available distribution of the Licensed Work under this License, whichever comes 
-first, this License will convert to the Change License.
-
-This Business Source License governs use of the Licensed Work in all cases, except 
-as to any use that is explicitly granted in the Additional Use Grant above or 
-under the Change License after the Change Date.
-
-If your use of the Licensed Work does not comply with the requirements of this 
-License, you must cease use of the Licensed Work immediately.
-
-All copies of the Licensed Work, and all derivative works thereof, must include 
-this License.
-
-This License does not grant you any right, title, or interest in any trademark, 
-logo, or branding of the Licensor, except as required to comply with this License.
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN 
-“AS IS” BASIS. LICENSOR DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING 
-WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, 
-TITLE, AND NON-INFRINGEMENT. IN NO EVENT WILL LICENSOR BE LIABLE FOR ANY DAMAGES 
-ARISING OUT OF OR RELATED TO THIS LICENSE OR THE USE OF THE LICENSED WORK.
+MIT License
+
+Copyright (c) 2026 Marc Frost
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/document-pdf.js

@@ -10,6 +10,7 @@ import { collectRegionResourceKeys, compileDocumentSource, createDocumentHandleb
 const LINE_BREAKS = /[\r\n]+/g;
 const IMAGE_CONTENT_TYPE_PREFIX = "image/";
 const MAX_RECORD_IMAGES = 24;
+const MAX_RECORD_IMAGE_LOOKUPS = 100;
 const MAX_RECORD_IMAGES_TOTAL_BYTES = 20 * 1024 * 1024;
 const PREVIEW_PAGE_NUMBER = "1";
 const EMPTY_CHROMIUM_REGION = "<span></span>";
@@ -176,8 +177,10 @@ async function loadRecordImageDataUris(ctx, variables, imageVariableNames) {
         for (const fileRefId of fileRefIdsOf(variables[name])) {
             if (seenIds.has(fileRefId))
                 continue;
+            if (seenIds.size >= MAX_RECORD_IMAGE_LOOKUPS)
+                break;
             seenIds.add(fileRefId);
-            if (loadedCount >= MAX_RECORD_IMAGES)
+            if (loadedCount >= MAX_RECORD_IMAGES || loadedBytes >= MAX_RECORD_IMAGES_TOTAL_BYTES)
                 break;
             const image = await readRecordImage(ctx, filesForTenant, fileRefId, Math.min(maxBytes, MAX_RECORD_IMAGES_TOTAL_BYTES - loadedBytes));
             if (image === null)
@@ -190,10 +193,22 @@ async function loadRecordImageDataUris(ctx, variables, imageVariableNames) {
     }
     return dataUrisByVariable;
 }
-// Text context without images variables: their value is file ids, which no placeholder,
-// title or file name pattern may print.
-function withoutImageVariables(variables, definitions) {
-    return Object.fromEntries(Object.entries(variables).filter(([name]) => !(Object.hasOwn(definitions, name) && definitions[name]?.type === "images")));
+function isImagesVariable(definitions, name) {
+    return Object.hasOwn(definitions, name) && definitions[name]?.type === "images";
+}
+// An images variable's value is file ids, which no placeholder, title or file name pattern
+// may print; the text context carries only whether images exist, so a condition on it works.
+function imagesAsPresenceFlags(variables, definitions, recordImages, recordImageUris) {
+    const hasImages = (name) => {
+        if (recordImages === "placeholder")
+            return true;
+        const resolved = recordImageUris.get(name);
+        return resolved !== undefined ? resolved.length > 0 : fileRefIdsOf(variables[name]).length > 0;
+    };
+    return Object.fromEntries(Object.entries(variables).map(([name, value]) => [
+        name,
+        isImagesVariable(definitions, name) ? hasImages(name) : value,
+    ]));
 }
 function renderRegion(hbs, region, context, resourceSrc) {
     if (region.trim() === "")
@@ -304,17 +319,17 @@ async function assembleDocument(input, ctx, markers, recordImages = "placeholder
         ]);
         const hbs = createDocumentHandlebars(format);
         const variableDefinitions = resolveTemplateVariables(ctx.registry, slug, template.variableSchema);
+        const recordImageUris = recordImages === "resolve"
+            ? await loadRecordImageDataUris(ctx, variables, collectDocumentImageVariables(template.content).filter((name) => isImagesVariable(variableDefinitions, name)))
+            : new Map();
         const context = {
-            ...withoutImageVariables(variables, variableDefinitions),
+            ...imagesAsPresenceFlags(variables, variableDefinitions, recordImages, recordImageUris),
             tenantName,
             signature: "",
             imprint: "",
             page: "",
             pages: "",
         };
-        const recordImageUris = recordImages === "resolve"
-            ? await loadRecordImageDataUris(ctx, variables, collectDocumentImageVariables(template.content))
-            : new Map();
         const bodyKeys = collectDocumentResourceKeys(template.content);
         const layoutKeys = collectRegionResourceKeys(layout.regions);
         const bodyRefs = await resolveResourceFileRefs(tplApi, ctx, template, bodyKeys);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@cosmicdrift/kumiko-renderer-puppeteer-client",
-  "version": "0.386.0",
+  "version": "0.388.0",
   "description": "Renderer-Foundation plugin: HTTP client for puppeteer-service (PDF + image snapshot via remote browser).",
-  "license": "BUSL-1.1",
+  "license": "MIT",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
   "type": "module",
   "kumiko": {
@@ -19,13 +19,13 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.386.0",
-    "@cosmicdrift/kumiko-framework": "0.386.0",
-    "@cosmicdrift/kumiko-renderer-mail-html": "0.386.0",
-    "@cosmicdrift/kumiko-types": "0.386.0"
+    "@cosmicdrift/kumiko-bundled-features": "0.388.0",
+    "@cosmicdrift/kumiko-framework": "0.388.0",
+    "@cosmicdrift/kumiko-renderer-mail-html": "0.388.0",
+    "@cosmicdrift/kumiko-types": "0.388.0"
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-testing": "0.386.0"
+    "@cosmicdrift/kumiko-testing": "0.388.0"
   },
   "repository": {
     "type": "git",

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.388.0",
+    "type": "fix",
+    "title": "Conditions on images variables work in the PDF render",
+    "detail": "A data-condition on an images variable now shows its block when the record has resolvable images, instead of never. Record image loading stops once the byte budget is used up, caps the number of looked-up ids, and ignores image blocks whose variable is not declared as images."
+  },
   {
     "version": "0.379.0",
     "type": "improvement",