@ironsoftware/ironpdf 2026.5.1 → 2026.6.1

package/src/internal/grpc_layer/pdfium/form.ts

@@ -0,0 +1,119 @@
+import * as grpc from "@grpc/grpc-js";
+import {Buffer} from "buffer";
+import {Access} from "../../access";
+import {IronPdfServiceClient} from "../../generated_proto/ironpdfengineproto/IronPdfService";
+import {
+	PdfiumSetFormFontRequestStreamP
+} from "../../generated_proto/ironpdfengineproto/PdfiumSetFormFontRequestStreamP";
+import {
+	PdfiumSetFormFontResultP__Output
+} from "../../generated_proto/ironpdfengineproto/PdfiumSetFormFontResultP";
+import {
+	PdfiumDisableFormFontFallbackResultP__Output
+} from "../../generated_proto/ironpdfengineproto/PdfiumDisableFormFontFallbackResultP";
+import {chunkBuffer, handleRemoteException} from "../util";
+import {validateFormFontData, validateFormFontName} from "./formFontValidator";
+
+/**
+ * Stream a font (or just a name reference) to the engine so subsequent
+ * form-field fills with non-ASCII values use the supplied font instead of
+ * triggering the automatic Tahoma/Arial fallback embed.
+ */
+export async function setFormFont(
+	id: string,
+	fontName: string,
+	fontData: Buffer | undefined,
+	forceEmbed: boolean
+): Promise<void> {
+	validateFormFontName(fontName);
+	// Distinguish between "name-only mode" (caller passed undefined/null) and
+	// "caller passed bytes". An explicit Buffer — even an empty one — runs the
+	// data validator, which rejects empty/oversize/non-sfnt payloads. Mirrors
+	// .NET FormFontValidator behaviour where an empty byte[] is a caller error.
+	if (fontData !== undefined && fontData !== null) {
+		validateFormFontData(fontData);
+	}
+
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+
+	return new Promise(
+		(resolve: () => void, reject: (errorMsg: string) => void) => {
+			let resolved = false;
+			const stream: grpc.ClientWritableStream<PdfiumSetFormFontRequestStreamP> =
+				client.Pdfium_Form_SetFormFont(
+					(
+						err: grpc.ServiceError | null,
+						value: PdfiumSetFormFontResultP__Output | undefined
+					) => {
+						if (resolved) return;
+						resolved = true;
+						if (err) {
+							reject(`${err.name}/n${err.message}`);
+							return;
+						}
+						if (!value) {
+							reject("No response from IronPdfEngine for setFormFont");
+							return;
+						}
+						if (value.exception) {
+							handleRemoteException(value.exception, reject);
+							return;
+						}
+						resolve();
+					}
+				);
+
+			// Send Info first.
+			stream.write({
+				info: {
+					document: {documentId: id},
+					fontName: fontName,
+					fontBytesSize: fontData ? fontData.length : 0,
+					forceEmbed: forceEmbed,
+				},
+			});
+
+			// Stream bytes (if any).
+			if (fontData && fontData.length > 0) {
+				for (const chunk of chunkBuffer(fontData)) {
+					stream.write({fontBytesChunk: chunk});
+				}
+			}
+			stream.end();
+		}
+	);
+}
+
+/**
+ * Suppress the engine's automatic Tahoma/Arial fallback embed for non-ASCII
+ * form-field values without registering a replacement font.
+ */
+export async function disableFormFontFallback(id: string): Promise<void> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+
+	return new Promise(
+		(resolve: () => void, reject: (errorMsg: string) => void) => {
+			client.Pdfium_Form_DisableFormFontFallback(
+				{document: {documentId: id}},
+				(
+					err: grpc.ServiceError | null,
+					value: PdfiumDisableFormFontFallbackResultP__Output | undefined
+				) => {
+					if (err) {
+						reject(`${err.name}/n${err.message}`);
+						return;
+					}
+					if (!value) {
+						reject("No response from IronPdfEngine for disableFormFontFallback");
+						return;
+					}
+					if (value.exception) {
+						handleRemoteException(value.exception, reject);
+						return;
+					}
+					resolve();
+				}
+			);
+		}
+	);
+}

package/src/internal/grpc_layer/pdfium/formFontValidator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Client-side validation for {@link setFormFont} arguments. Mirrors the
+ * Java FormFontValidator and .NET FormFontValidator added for PDF-2184.
+ *
+ * The engine validates again on receipt — this client check is the
+ * fail-fast layer that surfaces obvious mistakes before any network I/O.
+ */
+/// <reference types="node" />
+/// <reference types="node" />
+/**
+ * Validate a PDF font name. Allowed characters: letters, digits, '_', '-',
+ * '.', '+'. The '+' is permitted to accept subset prefixes like
+ * "AAAAAA+Poppins-Regular". Names must be 1-63 characters.
+ *
+ * @throws Error when the name fails validation.
+ */
+export declare function validateFormFontName(fontName: string): void;
+/**
+ * Validate raw font bytes look like a TrueType / OpenType / TTC sfnt
+ * container. Catches the obvious cases: empty payload, oversize payload,
+ * ASCII text passed instead of bytes, and all-zero payloads.
+ *
+ * @throws Error when the data fails validation.
+ */
+export declare function validateFormFontData(fontData: Buffer): void;
+//# sourceMappingURL=formFontValidator.d.ts.map

package/src/internal/grpc_layer/pdfium/formFontValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formFontValidator.d.ts","sourceRoot":"","sources":["formFontValidator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;;;AAMH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAc3D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CA2C3D"}

package/src/internal/grpc_layer/pdfium/formFontValidator.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Client-side validation for {@link setFormFont} arguments. Mirrors the
+ * Java FormFontValidator and .NET FormFontValidator added for PDF-2184.
+ *
+ * The engine validates again on receipt — this client check is the
+ * fail-fast layer that surfaces obvious mistakes before any network I/O.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFormFontData = exports.validateFormFontName = void 0;
+const MAX_NAME_LENGTH = 63;
+const MAX_FONT_BYTES = 50 * 1024 * 1024; // 50 MB
+const ALLOWED_NAME = /^[A-Za-z0-9_\-.+]+$/;
+/**
+ * Validate a PDF font name. Allowed characters: letters, digits, '_', '-',
+ * '.', '+'. The '+' is permitted to accept subset prefixes like
+ * "AAAAAA+Poppins-Regular". Names must be 1-63 characters.
+ *
+ * @throws Error when the name fails validation.
+ */
+function validateFormFontName(fontName) {
+    if (fontName == null || typeof fontName !== "string" || fontName.length === 0) {
+        throw new Error("fontName must be a non-empty string");
+    }
+    if (fontName.length > MAX_NAME_LENGTH) {
+        throw new Error(`fontName must be at most ${MAX_NAME_LENGTH} characters (got ${fontName.length})`);
+    }
+    if (!ALLOWED_NAME.test(fontName)) {
+        throw new Error("fontName may only contain letters, digits, and the characters '_', '-', '.', '+'");
+    }
+}
+exports.validateFormFontName = validateFormFontName;
+/**
+ * Validate raw font bytes look like a TrueType / OpenType / TTC sfnt
+ * container. Catches the obvious cases: empty payload, oversize payload,
+ * ASCII text passed instead of bytes, and all-zero payloads.
+ *
+ * @throws Error when the data fails validation.
+ */
+function validateFormFontData(fontData) {
+    var _a;
+    if (!fontData || fontData.length === 0) {
+        throw new Error("fontData must not be empty");
+    }
+    if (fontData.length > MAX_FONT_BYTES) {
+        throw new Error(`fontData exceeds the ${MAX_FONT_BYTES} byte limit (got ${fontData.length})`);
+    }
+    if (fontData.length < 4) {
+        throw new Error("fontData is too small to be a valid font file");
+    }
+    // Reject obviously-non-font payloads: all-zero buffer or a pure ASCII text
+    // payload. We don't try to fully parse the sfnt header here — the engine
+    // does that — but we do catch the common mistakes.
+    let nonZero = false;
+    let asciiOnly = true;
+    for (let i = 0; i < Math.min(fontData.length, 4096); i++) {
+        const b = (_a = fontData[i]) !== null && _a !== void 0 ? _a : 0;
+        if (b !== 0)
+            nonZero = true;
+        if (b > 0x7e || (b < 0x20 && b !== 0x09 && b !== 0x0a && b !== 0x0d)) {
+            asciiOnly = false;
+        }
+    }
+    if (!nonZero) {
+        throw new Error("fontData is all zeros — not a valid font file");
+    }
+    if (asciiOnly) {
+        throw new Error("fontData looks like ASCII text — not a valid font file");
+    }
+    // sfnt magic — TTF (0x00010000), OTF ('OTTO'), TTC ('ttcf'), or 'true'.
+    const m0 = fontData[0], m1 = fontData[1], m2 = fontData[2], m3 = fontData[3];
+    const isTtfV1 = m0 === 0x00 && m1 === 0x01 && m2 === 0x00 && m3 === 0x00;
+    const isOtto = m0 === 0x4f && m1 === 0x54 && m2 === 0x54 && m3 === 0x4f;
+    const isTtcf = m0 === 0x74 && m1 === 0x74 && m2 === 0x63 && m3 === 0x66;
+    const isTrue = m0 === 0x74 && m1 === 0x72 && m2 === 0x75 && m3 === 0x65;
+    if (!(isTtfV1 || isOtto || isTtcf || isTrue)) {
+        throw new Error("fontData does not have a recognised TTF/OTF/TTC sfnt magic");
+    }
+}
+exports.validateFormFontData = validateFormFontData;
+//# sourceMappingURL=formFontValidator.js.map

package/src/internal/grpc_layer/pdfium/formFontValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formFontValidator.js","sourceRoot":"","sources":["formFontValidator.ts"],"names":[],"mappings":"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"}

package/src/internal/grpc_layer/pdfium/formFontValidator.ts

@@ -0,0 +1,86 @@
+/**
+ * Client-side validation for {@link setFormFont} arguments. Mirrors the
+ * Java FormFontValidator and .NET FormFontValidator added for PDF-2184.
+ *
+ * The engine validates again on receipt — this client check is the
+ * fail-fast layer that surfaces obvious mistakes before any network I/O.
+ */
+
+const MAX_NAME_LENGTH = 63;
+const MAX_FONT_BYTES = 50 * 1024 * 1024; // 50 MB
+const ALLOWED_NAME = /^[A-Za-z0-9_\-.+]+$/;
+
+/**
+ * Validate a PDF font name. Allowed characters: letters, digits, '_', '-',
+ * '.', '+'. The '+' is permitted to accept subset prefixes like
+ * "AAAAAA+Poppins-Regular". Names must be 1-63 characters.
+ *
+ * @throws Error when the name fails validation.
+ */
+export function validateFormFontName(fontName: string): void {
+	if (fontName == null || typeof fontName !== "string" || fontName.length === 0) {
+		throw new Error("fontName must be a non-empty string");
+	}
+	if (fontName.length > MAX_NAME_LENGTH) {
+		throw new Error(
+			`fontName must be at most ${MAX_NAME_LENGTH} characters (got ${fontName.length})`
+		);
+	}
+	if (!ALLOWED_NAME.test(fontName)) {
+		throw new Error(
+			"fontName may only contain letters, digits, and the characters '_', '-', '.', '+'"
+		);
+	}
+}
+
+/**
+ * Validate raw font bytes look like a TrueType / OpenType / TTC sfnt
+ * container. Catches the obvious cases: empty payload, oversize payload,
+ * ASCII text passed instead of bytes, and all-zero payloads.
+ *
+ * @throws Error when the data fails validation.
+ */
+export function validateFormFontData(fontData: Buffer): void {
+	if (!fontData || fontData.length === 0) {
+		throw new Error("fontData must not be empty");
+	}
+	if (fontData.length > MAX_FONT_BYTES) {
+		throw new Error(
+			`fontData exceeds the ${MAX_FONT_BYTES} byte limit (got ${fontData.length})`
+		);
+	}
+	if (fontData.length < 4) {
+		throw new Error("fontData is too small to be a valid font file");
+	}
+
+	// Reject obviously-non-font payloads: all-zero buffer or a pure ASCII text
+	// payload. We don't try to fully parse the sfnt header here — the engine
+	// does that — but we do catch the common mistakes.
+	let nonZero = false;
+	let asciiOnly = true;
+	for (let i = 0; i < Math.min(fontData.length, 4096); i++) {
+		const b = fontData[i] ?? 0;
+		if (b !== 0) nonZero = true;
+		if (b > 0x7e || (b < 0x20 && b !== 0x09 && b !== 0x0a && b !== 0x0d)) {
+			asciiOnly = false;
+		}
+	}
+	if (!nonZero) {
+		throw new Error("fontData is all zeros — not a valid font file");
+	}
+	if (asciiOnly) {
+		throw new Error("fontData looks like ASCII text — not a valid font file");
+	}
+
+	// sfnt magic — TTF (0x00010000), OTF ('OTTO'), TTC ('ttcf'), or 'true'.
+	const m0 = fontData[0], m1 = fontData[1], m2 = fontData[2], m3 = fontData[3];
+	const isTtfV1 = m0 === 0x00 && m1 === 0x01 && m2 === 0x00 && m3 === 0x00;
+	const isOtto = m0 === 0x4f && m1 === 0x54 && m2 === 0x54 && m3 === 0x4f;
+	const isTtcf = m0 === 0x74 && m1 === 0x74 && m2 === 0x63 && m3 === 0x66;
+	const isTrue = m0 === 0x74 && m1 === 0x72 && m2 === 0x75 && m3 === 0x65;
+	if (!(isTtfV1 || isOtto || isTtcf || isTrue)) {
+		throw new Error(
+			"fontData does not have a recognised TTF/OTF/TTC sfnt magic"
+		);
+	}
+}

package/src/public/compression.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Object stream mode used when writing the compressed PDF.
+ *
+ * Values are the literal strings the engine expects on
+ * {@code QPdfCompressionFlagsP.object_streams}.
+ */
+export declare enum ObjectStreamMode {
+    /**
+     * Pack indirect objects into object streams. Smallest output for PDF 1.5+ (default).
+     */
+    Generate = "generate",
+    /**
+     * Keep the input's object stream layout unchanged.
+     */
+    Preserve = "preserve",
+    /**
+     * Write every object as a top-level indirect object (no object streams).
+     * Use when consumer tools cannot read object streams.
+     */
+    Disable = "disable"
+}
+/**
+ * Configuration for the advanced compression pipeline.
+ *
+ * @example Web/email (strongest size reduction)
+ * ```ts
+ * const opts: AdvancedCompressionOptions = {
+ *   jpegQuality: 70,
+ *   targetImageDpi: 150,
+ *   removeStructureTree: true,
+ * };
+ * ```
+ *
+ * @example Print quality
+ * ```ts
+ * const opts: AdvancedCompressionOptions = {
+ *   jpegQuality: 90,
+ *   targetImageDpi: 300,
+ * };
+ * ```
+ */
+export interface AdvancedCompressionOptions {
+    /**
+     * JPEG quality used when re-encoding images during optimization (1-100).
+     * When set, automatically enables image optimization.
+     *
+     * Default: `null` (no image re-encoding).
+     *
+     * Where the re-encoding happens depends on {@link targetImageDpi}:
+     * - `targetImageDpi` set (default 150): each image is downsampled and
+     *   re-encoded at this quality.
+     * - `targetImageDpi = null`: qpdf re-encodes images at this quality
+     *   without changing pixel dimensions.
+     */
+    jpegQuality?: number | null;
+    /**
+     * Target DPI for image downsampling during advanced compression.
+     * Images whose effective rendered DPI exceeds this value are
+     * downsampled before re-encoding.
+     *
+     * Default: `150`. Set to `null` (or `0`) to disable downsampling.
+     *
+     * **Lossy** — once an image is downsampled it cannot be restored to its
+     * original resolution.
+     */
+    targetImageDpi?: number | null;
+    /** 4:4:4 chroma subsampling when true (better color), 4:1:1 when false. Default true. */
+    highQualityImageSubsampling?: boolean;
+    /** Remove the document structure tree before compression. Default false. */
+    removeStructureTree?: boolean;
+    /** Compress content streams using zlib/Flate. Default true. */
+    compressStreams?: boolean;
+    /** Re-compress already Flate-encoded streams using {@link compressionLevel}. Default true. */
+    recompressFlate?: boolean;
+    /** zlib compression level (0-9). Default 9. */
+    compressionLevel?: number;
+    /** Object stream mode used when writing the output PDF. Default {@link ObjectStreamMode.Generate}. */
+    objectStreams?: ObjectStreamMode;
+    /** Drop indirect objects that are not referenced from the catalog. Default true. */
+    removeUnreferencedResources?: boolean;
+    /** Merge a page's content streams so they Flate-compress together. Default true. */
+    coalesceContents?: boolean;
+    /** Decode generalized filters (FlateDecode, LZW, ASCII85, ASCIIHex) before re-encoding. Default true. */
+    decodeGeneralizedStreams?: boolean;
+    /** Minimum image width (pixels) for image optimization to apply. Default 0. */
+    optimizeImagesMinWidth?: number;
+    /** Minimum image height (pixels) for image optimization to apply. Default 0. */
+    optimizeImagesMinHeight?: number;
+    /** Minimum image area (width × height) for image optimization to apply. Default 0. */
+    optimizeImagesMinArea?: number;
+}
+//# sourceMappingURL=compression.d.ts.map

package/src/public/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["compression.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,gBAAgB;IAC3B;;OAEG;IACH,QAAQ,aAAa;IAErB;;OAEG;IACH,QAAQ,aAAa;IAErB;;;OAGG;IACH,OAAO,YAAY;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,yFAAyF;IACzF,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,8FAA8F;IAC9F,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,sGAAsG;IACtG,aAAa,CAAC,EAAE,gBAAgB,CAAC;IAEjC,oFAAoF;IACpF,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,yGAAyG;IACzG,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC,gFAAgF;IAChF,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC,sFAAsF;IACtF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/src/public/compression.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectStreamMode = void 0;
+/**
+ * Object stream mode used when writing the compressed PDF.
+ *
+ * Values are the literal strings the engine expects on
+ * {@code QPdfCompressionFlagsP.object_streams}.
+ */
+var ObjectStreamMode;
+(function (ObjectStreamMode) {
+    /**
+     * Pack indirect objects into object streams. Smallest output for PDF 1.5+ (default).
+     */
+    ObjectStreamMode["Generate"] = "generate";
+    /**
+     * Keep the input's object stream layout unchanged.
+     */
+    ObjectStreamMode["Preserve"] = "preserve";
+    /**
+     * Write every object as a top-level indirect object (no object streams).
+     * Use when consumer tools cannot read object streams.
+     */
+    ObjectStreamMode["Disable"] = "disable";
+})(ObjectStreamMode = exports.ObjectStreamMode || (exports.ObjectStreamMode = {}));
+//# sourceMappingURL=compression.js.map

package/src/public/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["compression.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,gBAgBX;AAhBD,WAAY,gBAAgB;IAC3B;;OAEG;IACH,yCAAqB,CAAA;IAErB;;OAEG;IACH,yCAAqB,CAAA;IAErB;;;OAGG;IACH,uCAAmB,CAAA;AACpB,CAAC,EAhBW,gBAAgB,GAAhB,wBAAgB,KAAhB,wBAAgB,QAgB3B"}

package/src/public/compression.ts

@@ -0,0 +1,107 @@
+/**
+ * Object stream mode used when writing the compressed PDF.
+ *
+ * Values are the literal strings the engine expects on
+ * {@code QPdfCompressionFlagsP.object_streams}.
+ */
+export enum ObjectStreamMode {
+	/**
+	 * Pack indirect objects into object streams. Smallest output for PDF 1.5+ (default).
+	 */
+	Generate = "generate",
+
+	/**
+	 * Keep the input's object stream layout unchanged.
+	 */
+	Preserve = "preserve",
+
+	/**
+	 * Write every object as a top-level indirect object (no object streams).
+	 * Use when consumer tools cannot read object streams.
+	 */
+	Disable = "disable",
+}
+
+/**
+ * Configuration for the advanced compression pipeline.
+ *
+ * @example Web/email (strongest size reduction)
+ * ```ts
+ * const opts: AdvancedCompressionOptions = {
+ *   jpegQuality: 70,
+ *   targetImageDpi: 150,
+ *   removeStructureTree: true,
+ * };
+ * ```
+ *
+ * @example Print quality
+ * ```ts
+ * const opts: AdvancedCompressionOptions = {
+ *   jpegQuality: 90,
+ *   targetImageDpi: 300,
+ * };
+ * ```
+ */
+export interface AdvancedCompressionOptions {
+	/**
+	 * JPEG quality used when re-encoding images during optimization (1-100).
+	 * When set, automatically enables image optimization.
+	 *
+	 * Default: `null` (no image re-encoding).
+	 *
+	 * Where the re-encoding happens depends on {@link targetImageDpi}:
+	 * - `targetImageDpi` set (default 150): each image is downsampled and
+	 *   re-encoded at this quality.
+	 * - `targetImageDpi = null`: qpdf re-encodes images at this quality
+	 *   without changing pixel dimensions.
+	 */
+	jpegQuality?: number | null;
+
+	/**
+	 * Target DPI for image downsampling during advanced compression.
+	 * Images whose effective rendered DPI exceeds this value are
+	 * downsampled before re-encoding.
+	 *
+	 * Default: `150`. Set to `null` (or `0`) to disable downsampling.
+	 *
+	 * **Lossy** — once an image is downsampled it cannot be restored to its
+	 * original resolution.
+	 */
+	targetImageDpi?: number | null;
+
+	/** 4:4:4 chroma subsampling when true (better color), 4:1:1 when false. Default true. */
+	highQualityImageSubsampling?: boolean;
+
+	/** Remove the document structure tree before compression. Default false. */
+	removeStructureTree?: boolean;
+
+	/** Compress content streams using zlib/Flate. Default true. */
+	compressStreams?: boolean;
+
+	/** Re-compress already Flate-encoded streams using {@link compressionLevel}. Default true. */
+	recompressFlate?: boolean;
+
+	/** zlib compression level (0-9). Default 9. */
+	compressionLevel?: number;
+
+	/** Object stream mode used when writing the output PDF. Default {@link ObjectStreamMode.Generate}. */
+	objectStreams?: ObjectStreamMode;
+
+	/** Drop indirect objects that are not referenced from the catalog. Default true. */
+	removeUnreferencedResources?: boolean;
+
+	/** Merge a page's content streams so they Flate-compress together. Default true. */
+	coalesceContents?: boolean;
+
+	/** Decode generalized filters (FlateDecode, LZW, ASCII85, ASCIIHex) before re-encoding. Default true. */
+	decodeGeneralizedStreams?: boolean;
+
+	/** Minimum image width (pixels) for image optimization to apply. Default 0. */
+	optimizeImagesMinWidth?: number;
+
+	/** Minimum image height (pixels) for image optimization to apply. Default 0. */
+	optimizeImagesMinHeight?: number;
+
+	/** Minimum image area (width × height) for image optimization to apply. Default 0. */
+	optimizeImagesMinArea?: number;
+}

package/src/public/ironpdfglobalconfig.d.ts

@@ -91,5 +91,17 @@ export interface IronPdfConfig {
      * @default true
      */
     autoInstallDependency?: boolean | undefined;
+    /**
+     * Watchdog timeout (in seconds) for queued IronPdfEngine Chrome jobs. If a
+     * render does not complete within this window the queue slot is reclaimed
+     * so a single hung native call cannot wedge the engine queue under load.
+     *
+     * Forwarded to the engine subprocess
+     * via the {@code job_queue_watchdog_timeout_seconds} CLI argument; leave
+     * undefined or 0 to use the engine's built-in default.
+     *
+     * @default undefined
+     */
+    jobQueueWatchdogTimeoutSeconds?: number | undefined;
 }
 //# sourceMappingURL=ironpdfglobalconfig.d.ts.map

package/src/public/ironpdfglobalconfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ironpdfglobalconfig.d.ts","sourceRoot":"","sources":["ironpdfglobalconfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAsB;IAE9C,OAAO,CAAC,MAAM,CAAC,OAAO,CAKpB;IACF,OAAO;WASO,WAAW;IAIzB;;;;OAIG;WACW,SAAS,CAAC,aAAa,EAAE,aAAa;WAiBtC,SAAS,IAAI,aAAa;IAIxC,OAAc,oBAAoB,EAAE,MAAM,CAEU;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;;;;;OAQG;IACH,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C;;;OAGG;IACH,aAAa,CAAC,EAAC,cAAc,GAAG,SAAS,CAAC;IAC1C;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5C"}
+{"version":3,"file":"ironpdfglobalconfig.d.ts","sourceRoot":"","sources":["ironpdfglobalconfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAsB;IAE9C,OAAO,CAAC,MAAM,CAAC,OAAO,CAKpB;IACF,OAAO;WASO,WAAW;IAIzB;;;;OAIG;WACW,SAAS,CAAC,aAAa,EAAE,aAAa;WAwBtC,SAAS,IAAI,aAAa;IAIxC,OAAc,oBAAoB,EAAE,MAAM,CAEU;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;;;;;OAQG;IACH,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC;;;;;;;;;;;;;;;OAeG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C;;;OAGG;IACH,aAAa,CAAC,EAAC,cAAc,GAAG,SAAS,CAAC;IAC1C;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C;;;;;;;;;;OAUG;IACH,8BAA8B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpD"}

package/src/public/ironpdfglobalconfig.js

@@ -36,6 +36,13 @@ class IronPdfGlobalConfig {
             IronPdfGlobalConfig._config.ironPdfEngineDockerAddress =
                 ironPdfConfig.ironPdfEngineDockerAddress;
         }
+        if (ironPdfConfig.jobQueueWatchdogTimeoutSeconds != undefined) {
+            if (ironPdfConfig.jobQueueWatchdogTimeoutSeconds < 0) {
+                throw new Error("jobQueueWatchdogTimeoutSeconds must be non-negative");
+            }
+            IronPdfGlobalConfig._config.jobQueueWatchdogTimeoutSeconds =
+                ironPdfConfig.jobQueueWatchdogTimeoutSeconds;
+        }
     }
     static getConfig() {
         return IronPdfGlobalConfig._config;

package/src/public/ironpdfglobalconfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"ironpdfglobalconfig.js","sourceRoot":"","sources":["ironpdfglobalconfig.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,mBAAmB;IAS/B;QACC,IAAI,mBAAmB,CAAC,SAAS,EAAE;YAClC,MAAM,IAAI,KAAK,CACd,uEAAuE,CACvE,CAAC;SACF;QACD,mBAAmB,CAAC,SAAS,GAAG,IAAI,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,WAAW;QACxB,OAAO,mBAAmB,CAAC,SAAS,IAAI,CAAC,mBAAmB,CAAC,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC,CAAC;IACrG,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAS,CAAC,aAA4B;QACnD,IAAI,aAAa,CAAC,SAAS,IAAI,SAAS,EAAE;YACzC,mBAAmB,CAAC,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;SAChE;QACD,IAAI,aAAa,CAAC,UAAU,EAAE;YAC7B,mBAAmB,CAAC,OAAO,CAAC,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC;SAClE;QACD,IAAI,aAAa,CAAC,oBAAoB,EAAE;YACvC,mBAAmB,CAAC,OAAO,CAAC,oBAAoB;gBAC/C,aAAa,CAAC,oBAAoB,CAAC;SACpC;QACD,IAAI,aAAa,CAAC,0BAA0B,EAAE;YAC7C,mBAAmB,CAAC,OAAO,CAAC,0BAA0B;gBACrD,aAAa,CAAC,0BAA0B,CAAC;SAC1C;IACF,CAAC;IAEM,MAAM,CAAC,SAAS;QACtB,OAAO,mBAAmB,CAAC,OAAO,CAAC;IACpC,CAAC;;AA9CF,kDAmDC;AAhDe,2BAAO,GAAkB;IACvC,oBAAoB,EAAE,iBAAiB;IACvC,0BAA0B,EAAE,SAAS;IACrC,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE,SAAS;CACrB,CAAC;AAwCY,wCAAoB;AACjC,8DAA8D;AAC9D,OAAO,CAAC,oBAAoB,CAAC,CAAC,oBAAoB,CAAC"}
+{"version":3,"file":"ironpdfglobalconfig.js","sourceRoot":"","sources":["ironpdfglobalconfig.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,mBAAmB;IAS/B;QACC,IAAI,mBAAmB,CAAC,SAAS,EAAE;YAClC,MAAM,IAAI,KAAK,CACd,uEAAuE,CACvE,CAAC;SACF;QACD,mBAAmB,CAAC,SAAS,GAAG,IAAI,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,WAAW;QACxB,OAAO,mBAAmB,CAAC,SAAS,IAAI,CAAC,mBAAmB,CAAC,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC,CAAC;IACrG,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAS,CAAC,aAA4B;QACnD,IAAI,aAAa,CAAC,SAAS,IAAI,SAAS,EAAE;YACzC,mBAAmB,CAAC,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;SAChE;QACD,IAAI,aAAa,CAAC,UAAU,EAAE;YAC7B,mBAAmB,CAAC,OAAO,CAAC,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC;SAClE;QACD,IAAI,aAAa,CAAC,oBAAoB,EAAE;YACvC,mBAAmB,CAAC,OAAO,CAAC,oBAAoB;gBAC/C,aAAa,CAAC,oBAAoB,CAAC;SACpC;QACD,IAAI,aAAa,CAAC,0BAA0B,EAAE;YAC7C,mBAAmB,CAAC,OAAO,CAAC,0BAA0B;gBACrD,aAAa,CAAC,0BAA0B,CAAC;SAC1C;QACD,IAAI,aAAa,CAAC,8BAA8B,IAAI,SAAS,EAAE;YAC9D,IAAI,aAAa,CAAC,8BAA8B,GAAG,CAAC,EAAE;gBACrD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;aACvE;YACD,mBAAmB,CAAC,OAAO,CAAC,8BAA8B;gBACzD,aAAa,CAAC,8BAA8B,CAAC;SAC9C;IACF,CAAC;IAEM,MAAM,CAAC,SAAS;QACtB,OAAO,mBAAmB,CAAC,OAAO,CAAC;IACpC,CAAC;;AArDF,kDA0DC;AAvDe,2BAAO,GAAkB;IACvC,oBAAoB,EAAE,iBAAiB;IACvC,0BAA0B,EAAE,SAAS;IACrC,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE,SAAS;CACrB,CAAC;AA+CY,wCAAoB;AACjC,8DAA8D;AAC9D,OAAO,CAAC,oBAAoB,CAAC,CAAC,oBAAoB,CAAC"}

package/src/public/ironpdfglobalconfig.ts

@@ -47,6 +47,13 @@ export class IronPdfGlobalConfig {
 			IronPdfGlobalConfig._config.ironPdfEngineDockerAddress =
 				ironPdfConfig.ironPdfEngineDockerAddress;
 		}
+		if (ironPdfConfig.jobQueueWatchdogTimeoutSeconds != undefined) {
+			if (ironPdfConfig.jobQueueWatchdogTimeoutSeconds < 0) {
+				throw new Error("jobQueueWatchdogTimeoutSeconds must be non-negative");
+			}
+			IronPdfGlobalConfig._config.jobQueueWatchdogTimeoutSeconds =
+				ironPdfConfig.jobQueueWatchdogTimeoutSeconds;
+		}
 	}
 
 	public static getConfig(): IronPdfConfig {
@@ -131,4 +138,16 @@ export interface IronPdfConfig {
 	 * @default true
 	 */
 	autoInstallDependency?: boolean | undefined;
+	/**
+	 * Watchdog timeout (in seconds) for queued IronPdfEngine Chrome jobs. If a
+	 * render does not complete within this window the queue slot is reclaimed
+	 * so a single hung native call cannot wedge the engine queue under load.
+	 *
+	 * Forwarded to the engine subprocess
+	 * via the {@code job_queue_watchdog_timeout_seconds} CLI argument; leave
+	 * undefined or 0 to use the engine's built-in default.
+	 *
+	 * @default undefined
+	 */
+	jobQueueWatchdogTimeoutSeconds?: number | undefined;
 }