@ironsoftware/ironpdf 2026.5.1 → 2026.6.1

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

@@ -1,10 +1,38 @@
 /// <reference types="node" />
 /// <reference types="node" />
 /// <reference types="node" />
+import { QPdfCompressionFlagsP } from "../../generated_proto/ironpdfengineproto/QPdfCompressionFlagsP";
 import { Readable } from "stream";
+import { Buffer } from "buffer";
+import { AdvancedCompressionOptions } from "../../../public/compression";
 export declare function compressImage(id: string, imageQuality: number, scaleToVisibleSize?: boolean): Promise<void>;
 export declare function compressStructTree(id: string): Promise<void>;
 export declare function compressAndSaveAs(id: string, outputPath: string, imageQuality?: number): Promise<void>;
 export declare function compressInMemory(id: string, imageQuality?: number): Promise<Buffer>;
+/**
+ * Map a user-facing {@link AdvancedCompressionOptions} onto the wire
+ * {@link QPdfCompressionFlagsP}.
+ */
+export declare function toFlagsProto(options: AdvancedCompressionOptions): QPdfCompressionFlagsP;
+/**
+ * Apply the advanced compression pipeline to an open engine document and
+ * save the result to disk. Mirrors .NET
+ * {@code PdfDocument.CompressAndSaveAs(string, AdvancedCompressionOptions)}.
+ *
+ * Step 1 (optional) — pdfium image re-encoding when {@code targetImageDpi > 0}
+ * and {@code jpegQuality != null}.
+ * Step 2 (optional) — struct-tree removal when {@code removeStructureTree}.
+ * Step 3 — qpdf {@code QPdf_Compression_CompressAndSaveAsAdvanced}.
+ */
+export declare function compressAndSaveAsAdvanced(id: string, outputPath: string, options: AdvancedCompressionOptions, password?: string): Promise<void>;
+/**
+ * Apply the advanced compression pipeline to byte[] input and stream the
+ * result back. Mirrors .NET
+ * {@code PdfDocument.CompressAndSaveAs(byte[], string, AdvancedCompressionOptions, ...)}.
+ *
+ * Returns the compressed bytes; when {@code outputPath} is non-empty also
+ * writes them to disk.
+ */
+export declare function compressAndSaveAsAdvancedFromBytes(pdfBytes: Buffer, outputPath: string, options: AdvancedCompressionOptions, password?: string): Promise<Buffer>;
 export declare function compressInMemoryStream(id: string, imageQuality?: number): Promise<Readable>;
 //# sourceMappingURL=compress.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["compress.ts"],"names":[],"mappings":";;;AAOA,OAAO,EAAc,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAG7C,wBAAsB,aAAa,CAClC,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EACpB,kBAAkB,UAAQ,GACxB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,kBAAkB,CACvC,EAAE,EAAE,MAAM,GACR,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,iBAAiB,CACtC,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED,wBAAsB,gBAAgB,CACrC,EAAE,EAAE,MAAM,EACV,YAAY,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED,wBAAsB,sBAAsB,CAC3C,EAAE,EAAE,MAAM,EACV,YAAY,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,QAAQ,CAAC,CAiCnB"}
+{"version":3,"file":"compress.d.ts","sourceRoot":"","sources":["compress.ts"],"names":[],"mappings":";;;AAMA,OAAO,EAAC,qBAAqB,EAAC,MAAM,gEAAgE,CAAC;AAKrG,OAAO,EAAc,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAE7C,OAAO,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAC,0BAA0B,EAAmB,MAAM,6BAA6B,CAAC;AAEzF,wBAAsB,aAAa,CAClC,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EACpB,kBAAkB,UAAQ,GACxB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,kBAAkB,CACvC,EAAE,EAAE,MAAM,GACR,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,iBAAiB,CACtC,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED,wBAAsB,gBAAgB,CACrC,EAAE,EAAE,MAAM,EACV,YAAY,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,0BAA0B,GAAG,qBAAqB,CA0BvF;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC9C,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,EACnC,QAAQ,SAAK,GACX,OAAO,CAAC,IAAI,CAAC,CA8Df;AAED;;;;;;;GAOG;AACH,wBAAsB,kCAAkC,CACvD,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,EACnC,QAAQ,SAAK,GACX,OAAO,CAAC,MAAM,CAAC,CA0DjB;AAED,wBAAsB,sBAAsB,CAC3C,EAAE,EAAE,MAAM,EACV,YAAY,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,QAAQ,CAAC,CAiCnB"}

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

@@ -12,11 +12,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compressInMemoryStream = exports.compressInMemory = exports.compressAndSaveAs = exports.compressStructTree = exports.compressImage = void 0;
+exports.compressInMemoryStream = exports.compressAndSaveAsAdvancedFromBytes = exports.compressAndSaveAsAdvanced = exports.toFlagsProto = exports.compressInMemory = exports.compressAndSaveAs = exports.compressStructTree = exports.compressImage = void 0;
 const access_1 = require("../../access");
 const util_1 = require("../util");
 const stream_1 = require("stream");
 const fs_1 = __importDefault(require("fs"));
+const buffer_1 = require("buffer");
+const compression_1 = require("../../../public/compression");
 function compressImage(id, imageQuality, scaleToVisibleSize = false) {
     return __awaiter(this, void 0, void 0, function* () {
         const client = yield access_1.Access.ensureConnection();
@@ -76,7 +78,7 @@ function compressAndSaveAs(id, outputPath, imageQuality) {
                 reject(`${err.name}/n${err.message}`);
             });
             stream.on("end", () => {
-                fs_1.default.writeFileSync(outputPath, Buffer.concat(buffers));
+                fs_1.default.writeFileSync(outputPath, buffer_1.Buffer.concat(buffers));
                 resolve();
             });
         });
@@ -102,12 +104,161 @@ function compressInMemory(id, imageQuality) {
                 reject(`${err.name}/n${err.message}`);
             });
             stream.on("end", () => {
-                resolve(Buffer.concat(buffers));
+                resolve(buffer_1.Buffer.concat(buffers));
             });
         });
     });
 }
 exports.compressInMemory = compressInMemory;
+/**
+ * Map a user-facing {@link AdvancedCompressionOptions} onto the wire
+ * {@link QPdfCompressionFlagsP}.
+ */
+function toFlagsProto(options) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    const pdfiumWillReEncode = options.targetImageDpi !== null &&
+        options.targetImageDpi !== undefined &&
+        options.targetImageDpi > 0;
+    const optimizeImages = !pdfiumWillReEncode && options.jpegQuality != null;
+    const flags = {
+        compressStreams: (_a = options.compressStreams) !== null && _a !== void 0 ? _a : true,
+        coalesceContents: (_b = options.coalesceContents) !== null && _b !== void 0 ? _b : true,
+        removeUnreferencedResources: (_c = options.removeUnreferencedResources) !== null && _c !== void 0 ? _c : true,
+        recompressFlate: (_d = options.recompressFlate) !== null && _d !== void 0 ? _d : true,
+        compressionLevel: (_e = options.compressionLevel) !== null && _e !== void 0 ? _e : 9,
+        objectStreams: ((_f = options.objectStreams) !== null && _f !== void 0 ? _f : compression_1.ObjectStreamMode.Generate),
+        decodeGeneralizedStreams: (_g = options.decodeGeneralizedStreams) !== null && _g !== void 0 ? _g : true,
+        optimizeImagesMinWidth: (_h = options.optimizeImagesMinWidth) !== null && _h !== void 0 ? _h : 0,
+        optimizeImagesMinHeight: (_j = options.optimizeImagesMinHeight) !== null && _j !== void 0 ? _j : 0,
+        optimizeImagesMinArea: (_k = options.optimizeImagesMinArea) !== null && _k !== void 0 ? _k : 0,
+        optimizeImages: optimizeImages,
+    };
+    if (!pdfiumWillReEncode && options.jpegQuality != null) {
+        flags.jpegQuality = options.jpegQuality;
+    }
+    return flags;
+}
+exports.toFlagsProto = toFlagsProto;
+/**
+ * Apply the advanced compression pipeline to an open engine document and
+ * save the result to disk. Mirrors .NET
+ * {@code PdfDocument.CompressAndSaveAs(string, AdvancedCompressionOptions)}.
+ *
+ * Step 1 (optional) — pdfium image re-encoding when {@code targetImageDpi > 0}
+ * and {@code jpegQuality != null}.
+ * Step 2 (optional) — struct-tree removal when {@code removeStructureTree}.
+ * Step 3 — qpdf {@code QPdf_Compression_CompressAndSaveAsAdvanced}.
+ */
+function compressAndSaveAsAdvanced(id, outputPath, options, password = "") {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!options) {
+            throw new Error("options must not be null");
+        }
+        // Step 1 — pdfium image re-encoding (gated, matches .NET pdfiumWillReEncode).
+        const pdfiumWillReEncode = options.targetImageDpi !== null &&
+            options.targetImageDpi !== undefined &&
+            options.targetImageDpi > 0;
+        if (pdfiumWillReEncode && options.jpegQuality != null) {
+            yield compressImage(id, options.jpegQuality, false /* scaleToVisibleSize */);
+        }
+        // Step 2 — struct-tree removal.
+        if (options.removeStructureTree) {
+            yield compressStructTree(id);
+        }
+        // Step 3 — qpdf advanced pass.
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            const stream = client.QPdf_Compression_CompressAndSaveAsAdvanced({
+                document: { documentId: id },
+                outputPath: "",
+                password: password !== null && password !== void 0 ? password : "",
+                flags: toFlagsProto(options),
+            });
+            const buffers = [];
+            stream.on("data", (data) => {
+                if (data.exception) {
+                    (0, util_1.handleRemoteException)(data.exception, reject);
+                }
+                else if (data.resultChunk) {
+                    buffers.push(data.resultChunk);
+                }
+            });
+            stream.on("error", (err) => {
+                reject(`${err.name}/n${err.message}`);
+            });
+            stream.on("end", () => {
+                try {
+                    fs_1.default.writeFileSync(outputPath, buffer_1.Buffer.concat(buffers));
+                }
+                catch (e) {
+                    reject(`Failed to write compressed PDF to ${outputPath}: ${e.message}`);
+                    return;
+                }
+                resolve();
+            });
+        });
+    });
+}
+exports.compressAndSaveAsAdvanced = compressAndSaveAsAdvanced;
+/**
+ * Apply the advanced compression pipeline to byte[] input and stream the
+ * result back. Mirrors .NET
+ * {@code PdfDocument.CompressAndSaveAs(byte[], string, AdvancedCompressionOptions, ...)}.
+ *
+ * Returns the compressed bytes; when {@code outputPath} is non-empty also
+ * writes them to disk.
+ */
+function compressAndSaveAsAdvancedFromBytes(pdfBytes, outputPath, options, password = "") {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!pdfBytes || pdfBytes.length === 0) {
+            throw new Error("pdfBytes must not be null or empty");
+        }
+        if (!options) {
+            throw new Error("options must not be null");
+        }
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            const stream = client.QPdf_Compression_CompressAndSaveAsAdvancedFromBytes();
+            const buffers = [];
+            stream.on("data", (data) => {
+                if (data.exception) {
+                    (0, util_1.handleRemoteException)(data.exception, reject);
+                }
+                else if (data.resultChunk) {
+                    buffers.push(data.resultChunk);
+                }
+            });
+            stream.on("error", (err) => {
+                reject(`${err.name}/n${err.message}`);
+            });
+            stream.on("end", () => {
+                const result = buffer_1.Buffer.concat(buffers);
+                if (outputPath) {
+                    try {
+                        fs_1.default.writeFileSync(outputPath, result);
+                    }
+                    catch (e) {
+                        reject(`Failed to write compressed PDF to ${outputPath}: ${e.message}`);
+                        return;
+                    }
+                }
+                resolve(result);
+            });
+            stream.write({
+                info: {
+                    outputPath: outputPath !== null && outputPath !== void 0 ? outputPath : "",
+                    password: password !== null && password !== void 0 ? password : "",
+                    flags: toFlagsProto(options),
+                },
+            });
+            for (const chunk of (0, util_1.chunkBuffer)(pdfBytes)) {
+                stream.write({ pdfBytesChunk: chunk });
+            }
+            stream.end();
+        });
+    });
+}
+exports.compressAndSaveAsAdvancedFromBytes = compressAndSaveAsAdvancedFromBytes;
 function compressInMemoryStream(id, imageQuality) {
     return __awaiter(this, void 0, void 0, function* () {
         const client = yield access_1.Access.ensureConnection();

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

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

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

@@ -4,9 +4,15 @@ import {IronPdfServiceClient} from "../../generated_proto/ironpdfengineproto/Iro
 import {Access} from "../../access";
 import {EmptyResultP__Output} from "../../generated_proto/ironpdfengineproto/EmptyResultP";
 import {BytesResultStreamP__Output} from "../../generated_proto/ironpdfengineproto/BytesResultStreamP";
-import {handleEmptyResultP__Output} from "../util";
+import {QPdfCompressionFlagsP} from "../../generated_proto/ironpdfengineproto/QPdfCompressionFlagsP";
+import {
+	QPdfCompressAndSaveAsAdvancedFromBytesRequestStreamP
+} from "../../generated_proto/ironpdfengineproto/QPdfCompressAndSaveAsAdvancedFromBytesRequestStreamP";
+import {chunkBuffer, handleEmptyResultP__Output, handleRemoteException} from "../util";
 import {PassThrough, Readable} from "stream";
 import fs from "fs";
+import {Buffer} from "buffer";
+import {AdvancedCompressionOptions, ObjectStreamMode} from "../../../public/compression";
 
 export async function compressImage(
 	id: string,
@@ -144,6 +150,190 @@ export async function compressInMemory(
 	);
 }
 
+/**
+ * Map a user-facing {@link AdvancedCompressionOptions} onto the wire
+ * {@link QPdfCompressionFlagsP}.
+ */
+export function toFlagsProto(options: AdvancedCompressionOptions): QPdfCompressionFlagsP {
+	const pdfiumWillReEncode =
+		options.targetImageDpi !== null &&
+		options.targetImageDpi !== undefined &&
+		options.targetImageDpi > 0;
+	const optimizeImages = !pdfiumWillReEncode && options.jpegQuality != null;
+
+	const flags: QPdfCompressionFlagsP = {
+		compressStreams: options.compressStreams ?? true,
+		coalesceContents: options.coalesceContents ?? true,
+		removeUnreferencedResources: options.removeUnreferencedResources ?? true,
+		recompressFlate: options.recompressFlate ?? true,
+		compressionLevel: options.compressionLevel ?? 9,
+		objectStreams: (options.objectStreams ?? ObjectStreamMode.Generate) as string,
+		decodeGeneralizedStreams: options.decodeGeneralizedStreams ?? true,
+		optimizeImagesMinWidth: options.optimizeImagesMinWidth ?? 0,
+		optimizeImagesMinHeight: options.optimizeImagesMinHeight ?? 0,
+		optimizeImagesMinArea: options.optimizeImagesMinArea ?? 0,
+		optimizeImages: optimizeImages,
+	};
+
+	if (!pdfiumWillReEncode && options.jpegQuality != null) {
+		flags.jpegQuality = options.jpegQuality;
+	}
+
+	return flags;
+}
+
+/**
+ * Apply the advanced compression pipeline to an open engine document and
+ * save the result to disk. Mirrors .NET
+ * {@code PdfDocument.CompressAndSaveAs(string, AdvancedCompressionOptions)}.
+ *
+ * Step 1 (optional) — pdfium image re-encoding when {@code targetImageDpi > 0}
+ * and {@code jpegQuality != null}.
+ * Step 2 (optional) — struct-tree removal when {@code removeStructureTree}.
+ * Step 3 — qpdf {@code QPdf_Compression_CompressAndSaveAsAdvanced}.
+ */
+export async function compressAndSaveAsAdvanced(
+	id: string,
+	outputPath: string,
+	options: AdvancedCompressionOptions,
+	password = ""
+): Promise<void> {
+	if (!options) {
+		throw new Error("options must not be null");
+	}
+
+	// Step 1 — pdfium image re-encoding (gated, matches .NET pdfiumWillReEncode).
+	const pdfiumWillReEncode =
+		options.targetImageDpi !== null &&
+		options.targetImageDpi !== undefined &&
+		options.targetImageDpi > 0;
+	if (pdfiumWillReEncode && options.jpegQuality != null) {
+		await compressImage(
+			id,
+			options.jpegQuality,
+			false /* scaleToVisibleSize */
+		);
+	}
+
+	// Step 2 — struct-tree removal.
+	if (options.removeStructureTree) {
+		await compressStructTree(id);
+	}
+
+	// Step 3 — qpdf advanced pass.
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+
+	return new Promise(
+		(resolve: () => void, reject: (errorMsg: string) => void) => {
+			const stream: grpc.ClientReadableStream<BytesResultStreamP__Output> =
+				client.QPdf_Compression_CompressAndSaveAsAdvanced({
+					document: {documentId: id},
+					outputPath: "",
+					password: password ?? "",
+					flags: toFlagsProto(options),
+				});
+
+			const buffers: Buffer[] = [];
+			stream.on("data", (data: BytesResultStreamP__Output) => {
+				if (data.exception) {
+					handleRemoteException(data.exception, reject);
+				} else if (data.resultChunk) {
+					buffers.push(data.resultChunk);
+				}
+			});
+
+			stream.on("error", (err: Error) => {
+				reject(`${err.name}/n${err.message}`);
+			});
+
+			stream.on("end", () => {
+				try {
+					fs.writeFileSync(outputPath, Buffer.concat(buffers));
+				} catch (e) {
+					reject(
+						`Failed to write compressed PDF to ${outputPath}: ${(e as Error).message}`
+					);
+					return;
+				}
+				resolve();
+			});
+		}
+	);
+}
+
+/**
+ * Apply the advanced compression pipeline to byte[] input and stream the
+ * result back. Mirrors .NET
+ * {@code PdfDocument.CompressAndSaveAs(byte[], string, AdvancedCompressionOptions, ...)}.
+ *
+ * Returns the compressed bytes; when {@code outputPath} is non-empty also
+ * writes them to disk.
+ */
+export async function compressAndSaveAsAdvancedFromBytes(
+	pdfBytes: Buffer,
+	outputPath: string,
+	options: AdvancedCompressionOptions,
+	password = ""
+): Promise<Buffer> {
+	if (!pdfBytes || pdfBytes.length === 0) {
+		throw new Error("pdfBytes must not be null or empty");
+	}
+	if (!options) {
+		throw new Error("options must not be null");
+	}
+
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+
+	return new Promise(
+		(resolve: (_: Buffer) => void, reject: (errorMsg: string) => void) => {
+			const stream: grpc.ClientDuplexStream<
+				QPdfCompressAndSaveAsAdvancedFromBytesRequestStreamP,
+				BytesResultStreamP__Output
+			> = client.QPdf_Compression_CompressAndSaveAsAdvancedFromBytes();
+
+			const buffers: Buffer[] = [];
+			stream.on("data", (data: BytesResultStreamP__Output) => {
+				if (data.exception) {
+					handleRemoteException(data.exception, reject);
+				} else if (data.resultChunk) {
+					buffers.push(data.resultChunk);
+				}
+			});
+
+			stream.on("error", (err: Error) => {
+				reject(`${err.name}/n${err.message}`);
+			});
+
+			stream.on("end", () => {
+				const result = Buffer.concat(buffers);
+				if (outputPath) {
+					try {
+						fs.writeFileSync(outputPath, result);
+					} catch (e) {
+						reject(
+							`Failed to write compressed PDF to ${outputPath}: ${(e as Error).message}`
+						);
+						return;
+					}
+				}
+				resolve(result);
+			});
+
+			stream.write({
+				info: {
+					outputPath: outputPath ?? "",
+					password: password ?? "",
+					flags: toFlagsProto(options),
+				},
+			});
+			for (const chunk of chunkBuffer(pdfBytes)) {
+				stream.write({pdfBytesChunk: chunk});
+			}
+			stream.end();
+		}
+	);
+}
+
 export async function compressInMemoryStream(
 	id: string,
 	imageQuality?: number

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

@@ -0,0 +1,15 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { Buffer } from "buffer";
+/**
+ * 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 declare function setFormFont(id: string, fontName: string, fontData: Buffer | undefined, forceEmbed: boolean): Promise<void>;
+/**
+ * Suppress the engine's automatic Tahoma/Arial fallback embed for non-ASCII
+ * form-field values without registering a replacement font.
+ */
+export declare function disableFormFontFallback(id: string): Promise<void>;
+//# sourceMappingURL=form.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["form.ts"],"names":[],"mappings":";;AACA,OAAO,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAe9B;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,UAAU,EAAE,OAAO,GACjB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BvE"}

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

@@ -0,0 +1,99 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.disableFormFontFallback = exports.setFormFont = void 0;
+const access_1 = require("../../access");
+const util_1 = require("../util");
+const formFontValidator_1 = require("./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.
+ */
+function setFormFont(id, fontName, fontData, forceEmbed) {
+    return __awaiter(this, void 0, void 0, function* () {
+        (0, formFontValidator_1.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) {
+            (0, formFontValidator_1.validateFormFontData)(fontData);
+        }
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            let resolved = false;
+            const stream = client.Pdfium_Form_SetFormFont((err, value) => {
+                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) {
+                    (0, util_1.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 (0, util_1.chunkBuffer)(fontData)) {
+                    stream.write({ fontBytesChunk: chunk });
+                }
+            }
+            stream.end();
+        });
+    });
+}
+exports.setFormFont = setFormFont;
+/**
+ * Suppress the engine's automatic Tahoma/Arial fallback embed for non-ASCII
+ * form-field values without registering a replacement font.
+ */
+function disableFormFontFallback(id) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            client.Pdfium_Form_DisableFormFontFallback({ document: { documentId: id } }, (err, value) => {
+                if (err) {
+                    reject(`${err.name}/n${err.message}`);
+                    return;
+                }
+                if (!value) {
+                    reject("No response from IronPdfEngine for disableFormFontFallback");
+                    return;
+                }
+                if (value.exception) {
+                    (0, util_1.handleRemoteException)(value.exception, reject);
+                    return;
+                }
+                resolve();
+            });
+        });
+    });
+}
+exports.disableFormFontFallback = disableFormFontFallback;
+//# sourceMappingURL=form.js.map

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

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