@ironsoftware/ironpdf 2026.4.1 → 2026.6.1

package/src/public/annotation.ts

@@ -0,0 +1,166 @@
+/**
+ * Destination type that controls how a PDF reader displays the target page when a
+ * bookmark or internal hyperlink is followed.
+ *
+ * Mirrors {@code IronPdf.Bookmarks.BookmarkDestinations} on the C# side. The numeric
+ * value of each entry is what the engine expects on the wire, so the order must match
+ * the C# enum.
+ *
+ * Corresponds to the PDF 1.7 specification §12.3.2 "Explicit Destinations".
+ */
+export enum BookmarkDestinations {
+	/**
+	 * Fit the entire destination page within the window (PDF {@code /Fit}).
+	 * No additional coordinates are used.
+	 */
+	Page = 0,
+	/**
+	 * Scroll to a specific Y coordinate on the destination page while fitting the
+	 * page width to the window (PDF {@code /FitH}).
+	 * Uses {@link LinkAnnotation.destinationTop}.
+	 */
+	PageY = 1,
+	/**
+	 * Scroll to a specific X coordinate on the destination page while fitting the
+	 * page height to the window (PDF {@code /FitV}).
+	 * Uses {@link LinkAnnotation.destinationLeft}.
+	 */
+	PageX = 2,
+	/**
+	 * Scroll to a specific position and zoom level (PDF {@code /XYZ}).
+	 * Uses {@link LinkAnnotation.destinationLeft}, {@link LinkAnnotation.destinationTop},
+	 * and {@link LinkAnnotation.destinationZoom}. A {@code destinationZoom} of 0 means
+	 * "inherit the current zoom".
+	 */
+	PageZoom = 3,
+	/**
+	 * Fit the specified rectangle of the destination page into the window (PDF {@code /FitR}).
+	 * Uses {@link LinkAnnotation.destinationLeft}, {@link LinkAnnotation.destinationBottom},
+	 * {@link LinkAnnotation.destinationRight}, and {@link LinkAnnotation.destinationTop}.
+	 */
+	PageRect = 4,
+	/**
+	 * Fit the bounding box of the destination page into the window (PDF {@code /FitB}).
+	 */
+	PageBounds = 5,
+	/**
+	 * Scroll to a Y coordinate while fitting the bounding box width to the window
+	 * (PDF {@code /FitBH}). Uses {@link LinkAnnotation.destinationTop}.
+	 */
+	PageBoundsY = 6,
+	/**
+	 * Scroll to an X coordinate while fitting the bounding box height to the window
+	 * (PDF {@code /FitBV}). Uses {@link LinkAnnotation.destinationLeft}.
+	 */
+	PageBoundsX = 7,
+}
+ 
+/**
+ * Defines a clickable link annotation that navigates to a specific page within the same
+ * PDF document. Useful for building custom tables of contents, cross-references, and
+ * in-document navigation.
+ *
+ * Mirrors {@code IronPdf.Annotations.LinkAnnotation} on the C# side.
+ *
+ * @example
+ * ```ts
+ * // Simple TOC link: from page 0 to page 3
+ * await pdf.addLinkAnnotation({
+ *     pageIndex: 0,
+ *     destinationPageIndex: 3,
+ *     x: 72, y: 700,
+ *     width: 300, height: 18,
+ *     contents: "Chapter 1 - Introduction",
+ * });
+ *
+ * // Scroll-to-position link: jump to y=400 on page 1
+ * await pdf.addLinkAnnotation({
+ *     pageIndex: 0,
+ *     destinationPageIndex: 1,
+ *     destinationType: BookmarkDestinations.PageZoom,
+ *     destinationTop: 400,
+ *     destinationZoom: 100,
+ *     x: 72, y: 650,
+ *     width: 300, height: 18,
+ * });
+ * ```
+ *
+ * <b>Coordinate note:</b> {@code y} sets the <em>bottom</em> edge of the clickable area
+ * using PDF coordinates (origin at bottom-left of page).
+ */
+export interface LinkAnnotation {
+	/** Zero-based index of the page where the link is placed. */
+	pageIndex: number;
+	/** Zero-based index of the page to navigate to when clicked. */
+	destinationPageIndex: number;
+	/**
+	 * Destination type controlling how the target page is displayed.
+	 * @default BookmarkDestinations.Page
+	 */
+	destinationType?: BookmarkDestinations;
+	/**
+	 * Left coordinate of the destination position, in points.
+	 * Used by {@link BookmarkDestinations.PageZoom}, {@link BookmarkDestinations.PageX},
+	 * {@link BookmarkDestinations.PageRect}, and {@link BookmarkDestinations.PageBoundsX}.
+	 */
+	destinationLeft?: number;
+	/**
+	 * Right coordinate of the destination position, in points.
+	 * Used by {@link BookmarkDestinations.PageRect}.
+	 */
+	destinationRight?: number;
+	/**
+	 * Top coordinate of the destination position, in points.
+	 * Used by {@link BookmarkDestinations.PageZoom}, {@link BookmarkDestinations.PageY},
+	 * {@link BookmarkDestinations.PageRect}, and {@link BookmarkDestinations.PageBoundsY}.
+	 */
+	destinationTop?: number;
+	/**
+	 * Bottom coordinate of the destination position, in points.
+	 * Used by {@link BookmarkDestinations.PageRect}.
+	 */
+	destinationBottom?: number;
+	/**
+	 * Zoom level (in percent) for the destination. Used by
+	 * {@link BookmarkDestinations.PageZoom}. A value of 0 means inherit the current zoom.
+	 */
+	destinationZoom?: number;
+	/**
+	 * Horizontal X position from the LEFT edge of the page, in points.
+	 */
+	x: number;
+	/**
+	 * Vertical Y position from the BOTTOM edge of the page, in points.
+	 * PDF coordinate system places Y=0 at the bottom of the page.
+	 */
+	y: number;
+	/** Width of the clickable link area, in points. */
+	width: number;
+	/** Height of the clickable link area, in points. */
+	height: number;
+	/**
+	 * Color code for the link border in CSS `#RRGGBB` format.
+	 * @default undefined (no explicit color)
+	 */
+	colorCode?: string;
+	/**
+	 * Whether the link annotation is hidden from users.
+	 * @default false
+	 */
+	hidden?: boolean;
+	/**
+	 * Descriptive text content for this link annotation.
+	 * @default ""
+	 */
+	contents?: string;
+	/**
+	 * Title for this link annotation.
+	 * @default ""
+	 */
+	title?: string;
+	/**
+	 * Whether the link annotation displays a visible border when clicked.
+	 * @default false
+	 */
+	showBorder?: boolean;
+}

package/src/public/bookmark.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A single PDF bookmark (outline entry). Mirrors the C# {@code IronPdf.Bookmark}
+ * shape — flat structure with parent linkage instead of nested children.
+ *
+ * <p>Returned by {@link PdfDocument.getBookmarks}. Hierarchy is conveyed via
+ * {@link parentItemId} (a bookmark's parent has matching {@link itemId}) and
+ * {@link hierarchy} (a path-like string describing depth in the outline tree).</p>
+ */
+export interface Bookmark {
+    /** Human-readable label shown in the PDF reader's bookmark panel. */
+    text: string;
+    /** Zero-based page index this bookmark navigates to. */
+    pageIndex: number;
+    /**
+     * Path-like string describing this bookmark's depth in the outline tree.
+     * Empty string for roots; nested entries have something like "0/1" or
+     * "Chapter 1/Section 1.1" depending on engine encoding.
+     */
+    hierarchy: string;
+    /** Stable identifier for this bookmark within the document. */
+    itemId: string;
+    /** {@link itemId} of the parent bookmark, or empty string for roots. */
+    parentItemId: string;
+}
+//# sourceMappingURL=bookmark.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bookmark.d.ts","sourceRoot":"","sources":["bookmark.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACxB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IAEb,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IAEf,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;CACrB"}

package/src/public/bookmark.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=bookmark.js.map

package/src/public/bookmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookmark.js","sourceRoot":"","sources":["bookmark.ts"],"names":[],"mappings":""}

package/src/public/bookmark.ts

@@ -0,0 +1,28 @@
+/**
+ * A single PDF bookmark (outline entry). Mirrors the C# {@code IronPdf.Bookmark}
+ * shape — flat structure with parent linkage instead of nested children.
+ *
+ * <p>Returned by {@link PdfDocument.getBookmarks}. Hierarchy is conveyed via
+ * {@link parentItemId} (a bookmark's parent has matching {@link itemId}) and
+ * {@link hierarchy} (a path-like string describing depth in the outline tree).</p>
+ */
+export interface Bookmark {
+	/** Human-readable label shown in the PDF reader's bookmark panel. */
+	text: string;
+
+	/** Zero-based page index this bookmark navigates to. */
+	pageIndex: number;
+
+	/**
+	 * Path-like string describing this bookmark's depth in the outline tree.
+	 * Empty string for roots; nested entries have something like "0/1" or
+	 * "Chapter 1/Section 1.1" depending on engine encoding.
+	 */
+	hierarchy: string;
+
+	/** Stable identifier for this bookmark within the document. */
+	itemId: string;
+
+	/** {@link itemId} of the parent bookmark, or empty string for roots. */
+	parentItemId: string;
+}

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;
 }