pdf-catalog-generator 3.1.3 → 3.1.4

package/README.md

@@ -175,6 +175,7 @@ Generates a PDF catalog from the provided configuration.
   - `companyName` (string): Your company name
   - `companyLogo` (string | null, optional): Logo URL or base64 string
   - `template` (TemplateType, optional): Template to use (default: 'template1')
+  - `imageOptimization` (ImageOptimizationOptions, optional): Resize/compress supported remote image URLs before rendering. Enabled by default.
 
 **Returns:** `Promise<Uint8Array>` - PDF file as Uint8Array (works in both Node.js and browser)
 
@@ -288,6 +289,16 @@ This library is **completely schema-free** - no fields are mandatory! You can us
 interface ProductData {
   [key: string]: string | number | boolean | null | undefined;
 }
+
+interface ImageOptimizationOptions {
+  enabled?: boolean;
+  maxWidth?: number;
+  maxHeight?: number;
+  quality?: number;
+  logoMaxWidth?: number;
+  logoMaxHeight?: number;
+  logoQuality?: number;
+}
 ```
 
 **Dynamic Field Rendering:**

package/dist/index.d.mts

@@ -5,11 +5,21 @@ interface ProductData {
     [key: string]: string | number | boolean | null | undefined;
 }
 type TemplateType = 'template1' | 'template2' | 'template3' | 'template4' | 'template5' | 'template6';
+interface ImageOptimizationOptions {
+    enabled?: boolean;
+    maxWidth?: number;
+    maxHeight?: number;
+    quality?: number;
+    logoMaxWidth?: number;
+    logoMaxHeight?: number;
+    logoQuality?: number;
+}
 interface CatalogConfig {
     products: ProductData[];
     companyLogo?: string | null;
     companyName: string;
     template?: TemplateType;
+    imageOptimization?: ImageOptimizationOptions;
 }
 interface TemplateProps {
     companyLogo?: string | null;

package/dist/index.d.ts

@@ -5,11 +5,21 @@ interface ProductData {
     [key: string]: string | number | boolean | null | undefined;
 }
 type TemplateType = 'template1' | 'template2' | 'template3' | 'template4' | 'template5' | 'template6';
+interface ImageOptimizationOptions {
+    enabled?: boolean;
+    maxWidth?: number;
+    maxHeight?: number;
+    quality?: number;
+    logoMaxWidth?: number;
+    logoMaxHeight?: number;
+    logoQuality?: number;
+}
 interface CatalogConfig {
     products: ProductData[];
     companyLogo?: string | null;
     companyName: string;
     template?: TemplateType;
+    imageOptimization?: ImageOptimizationOptions;
 }
 interface TemplateProps {
     companyLogo?: string | null;

package/dist/index.js

@@ -1005,8 +1005,137 @@ renderer.Font.registerEmojiSource({
   format: "png",
   url: "https://cdnjs.cloudflare.com/ajax/libs/twemoji/14.0.2/72x72/"
 });
+function normalizeImageSource(imageSource) {
+  const trimmedImageSource = imageSource.trim();
+  if (trimmedImageSource.startsWith("data:")) {
+    return trimmedImageSource;
+  }
+  if (trimmedImageSource.startsWith("http://") || trimmedImageSource.startsWith("https://")) {
+    return trimmedImageSource;
+  }
+  let mimeType = "image/png";
+  const base64Start = trimmedImageSource.substring(0, 20).toLowerCase();
+  if (base64Start.includes("ivborw0kggo") || trimmedImageSource.startsWith("iVBORw0KGgo")) {
+    mimeType = "image/png";
+  } else if (base64Start.includes("/9j/4aaq") || trimmedImageSource.startsWith("/9j/4AAQ")) {
+    mimeType = "image/jpeg";
+  } else if (base64Start.includes("r0lgodlh") || trimmedImageSource.startsWith("R0lGODlh")) {
+    mimeType = "image/gif";
+  } else if (base64Start.includes("uklgr") || trimmedImageSource.startsWith("UklGR")) {
+    mimeType = "image/webp";
+  }
+  return `data:${mimeType};base64,${trimmedImageSource}`;
+}
+var IMAGE_FIELD_NAMES_LOWER = /* @__PURE__ */ new Set([
+  "image",
+  "imageurl",
+  "img",
+  "photo",
+  "picture",
+  "image2",
+  "imageurl2",
+  "img2",
+  "photo2",
+  "picture2"
+]);
+var DEFAULT_IMAGE_OPTIMIZATION = {
+  enabled: true,
+  maxWidth: 900,
+  maxHeight: 900,
+  quality: 70,
+  logoMaxWidth: 400,
+  logoMaxHeight: 400,
+  logoQuality: 70
+};
+function getImageOptimizationOptions(options) {
+  return {
+    ...DEFAULT_IMAGE_OPTIMIZATION,
+    ...options
+  };
+}
+function getNumericSearchParam(url, key) {
+  const rawValue = url.searchParams.get(key);
+  if (rawValue === null || rawValue.trim() === "") {
+    return null;
+  }
+  const numericValue = Number(rawValue);
+  return Number.isFinite(numericValue) ? numericValue : null;
+}
+function optimizeImageUrl(imageSource, options, imageKind) {
+  if (!options.enabled) {
+    return normalizeImageSource(imageSource);
+  }
+  const normalizedSource = normalizeImageSource(imageSource);
+  if (!normalizedSource.startsWith("http://") && !normalizedSource.startsWith("https://")) {
+    return normalizedSource;
+  }
+  let url;
+  try {
+    url = new URL(normalizedSource);
+  } catch {
+    return normalizedSource;
+  }
+  const hostname = url.hostname.toLowerCase();
+  const isImgixStyleHost = hostname.includes("unsplash.com") || hostname.includes("imgix.net") || hostname.includes("builder.io") || hostname.includes("sanity.io");
+  if (!isImgixStyleHost) {
+    return normalizedSource;
+  }
+  const maxWidth = imageKind === "logo" ? options.logoMaxWidth : options.maxWidth;
+  const maxHeight = imageKind === "logo" ? options.logoMaxHeight : options.maxHeight;
+  const quality = imageKind === "logo" ? options.logoQuality : options.quality;
+  url.searchParams.set("auto", "format,compress");
+  url.searchParams.set("fit", "max");
+  const currentWidth = getNumericSearchParam(url, "w");
+  if (currentWidth === null || currentWidth > maxWidth) {
+    url.searchParams.set("w", String(maxWidth));
+  }
+  const currentHeight = getNumericSearchParam(url, "h");
+  if (currentHeight === null || currentHeight > maxHeight) {
+    url.searchParams.set("h", String(maxHeight));
+  }
+  const currentQuality = getNumericSearchParam(url, "q");
+  if (currentQuality === null || currentQuality > quality) {
+    url.searchParams.set("q", String(quality));
+  }
+  return url.toString();
+}
+function normalizeProductImages(products, options) {
+  const imageCache = /* @__PURE__ */ new Map();
+  const normalizeCachedImage = (value, imageKind) => {
+    const cacheKey = `${imageKind}:${value}`;
+    const cachedValue = imageCache.get(cacheKey);
+    if (cachedValue) {
+      return cachedValue;
+    }
+    const normalizedValue = optimizeImageUrl(value, options, imageKind);
+    imageCache.set(cacheKey, normalizedValue);
+    return normalizedValue;
+  };
+  return products.map((product) => {
+    const normalizedProduct = { ...product };
+    for (const [key, value] of Object.entries(product)) {
+      if (typeof value === "string" && value.trim() !== "" && IMAGE_FIELD_NAMES_LOWER.has(key.toLowerCase())) {
+        normalizedProduct[key] = normalizeCachedImage(value, "product");
+      }
+    }
+    return normalizedProduct;
+  });
+}
+async function renderPdfToUint8Array(doc) {
+  const isNodeRuntime = typeof process !== "undefined" && typeof process.versions?.node === "string";
+  if (isNodeRuntime && typeof renderer.renderToBuffer === "function") {
+    const buffer = await renderer.renderToBuffer(doc);
+    return buffer instanceof Uint8Array ? buffer : new Uint8Array(buffer);
+  }
+  const blob = await renderer.pdf(doc).toBlob();
+  const arrayBuffer = await blob.arrayBuffer();
+  return new Uint8Array(arrayBuffer);
+}
 async function generateProductCatalog(config) {
-  const { products, companyLogo, companyName, template = "template1" } = config;
+  const { products, companyLogo, companyName, template = "template1", imageOptimization } = config;
+  const optimizationOptions = getImageOptimizationOptions(imageOptimization);
+  const normalizedProducts = normalizeProductImages(products, optimizationOptions);
+  const normalizedCompanyLogo = companyLogo ? optimizeImageUrl(companyLogo, optimizationOptions, "logo") : companyLogo;
   let TemplateComponent;
   switch (template) {
     case "template1":
@@ -1034,39 +1163,33 @@ async function generateProductCatalog(config) {
     const doc2 = /* @__PURE__ */ jsxRuntime.jsx(renderer.Document, { children: /* @__PURE__ */ jsxRuntime.jsx(renderer.Page, { size: "A4", style: styles7.page, children: /* @__PURE__ */ jsxRuntime.jsx(
       Template4_default,
       {
-        products,
-        companyLogo,
+        products: normalizedProducts,
+        companyLogo: normalizedCompanyLogo,
         companyName
       }
     ) }) });
-    const blob2 = await renderer.pdf(doc2).toBlob();
-    const arrayBuffer2 = await blob2.arrayBuffer();
-    return new Uint8Array(arrayBuffer2);
+    return renderPdfToUint8Array(doc2);
   }
   if (template === "template5" || template === "template6") {
     const Template = template === "template5" ? Template5_default : Template6_default;
     const doc2 = /* @__PURE__ */ jsxRuntime.jsx(renderer.Document, { children: /* @__PURE__ */ jsxRuntime.jsx(renderer.Page, { size: "A4", orientation: "landscape", style: styles7.page, children: /* @__PURE__ */ jsxRuntime.jsx(
       Template,
       {
-        products,
-        companyLogo,
+        products: normalizedProducts,
+        companyLogo: normalizedCompanyLogo,
         companyName
       }
     ) }) });
-    const blob2 = await renderer.pdf(doc2).toBlob();
-    const arrayBuffer2 = await blob2.arrayBuffer();
-    return new Uint8Array(arrayBuffer2);
+    return renderPdfToUint8Array(doc2);
   }
   const doc = /* @__PURE__ */ jsxRuntime.jsx(renderer.Document, { children: /* @__PURE__ */ jsxRuntime.jsxs(renderer.Page, { size: "A4", style: styles7.page, children: [
     /* @__PURE__ */ jsxRuntime.jsxs(renderer.View, { style: styles7.header, children: [
-      companyLogo && /* @__PURE__ */ jsxRuntime.jsx(renderer.View, { style: styles7.logoSection, children: /* @__PURE__ */ jsxRuntime.jsx(renderer.Image, { style: styles7.logo, src: companyLogo }) }),
+      normalizedCompanyLogo && /* @__PURE__ */ jsxRuntime.jsx(renderer.View, { style: styles7.logoSection, children: /* @__PURE__ */ jsxRuntime.jsx(renderer.Image, { style: styles7.logo, src: normalizedCompanyLogo }) }),
       /* @__PURE__ */ jsxRuntime.jsx(renderer.View, { style: styles7.storeNameSection, children: /* @__PURE__ */ jsxRuntime.jsx(renderer.Text, { style: styles7.storeName, children: companyName }) })
     ] }),
-    /* @__PURE__ */ jsxRuntime.jsx(TemplateComponent, { products })
+    /* @__PURE__ */ jsxRuntime.jsx(TemplateComponent, { products: normalizedProducts })
   ] }) });
-  const blob = await renderer.pdf(doc).toBlob();
-  const arrayBuffer = await blob.arrayBuffer();
-  return new Uint8Array(arrayBuffer);
+  return renderPdfToUint8Array(doc);
 }
 function parseExcelFile(buffer) {
   const workbook = XLSX__namespace.read(buffer, {