@ironsoftware/ironpdf 2026.4.1 → 2026.5.1

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

@@ -0,0 +1,309 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+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.saveAsLinearizedFromBytes = exports.linearizeCoreFromId = exports.linearizeCoreFromBytes = exports.linearizeInMemoryFromBytes = exports.linearizeInMemoryFromIdStream = exports.linearizeInMemoryFromId = exports.isLinearizedFromBytes = void 0;
+const buffer_1 = require("buffer");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const stream_1 = require("stream");
+const access_1 = require("../../access");
+const render_1 = require("../../../public/render");
+const util_1 = require("../util");
+/**
+ * Check if the given PDF bytes represent a linearized ("Fast Web View") PDF.
+ */
+function isLinearizedFromBytes(pdfBytes, password = "") {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            const stream = client.QPdf_Linearization_IsLinearized((err, value) => {
+                var _a;
+                if (err) {
+                    reject(`${err.name}/n${err.message}`);
+                }
+                else if (value) {
+                    if (value.exception) {
+                        (0, util_1.handleRemoteException)(value.exception, reject);
+                        return;
+                    }
+                    resolve((_a = value.result) !== null && _a !== void 0 ? _a : false);
+                }
+                else {
+                    reject("No response from IronPdfEngine for isLinearized");
+                }
+            });
+            stream.write({ info: { password: password !== null && password !== void 0 ? password : "" } });
+            (0, util_1.chunkBuffer)(pdfBytes).forEach((chunk) => {
+                stream.write({ pdfBytesChunk: chunk });
+            });
+            stream.end();
+        });
+    });
+}
+exports.isLinearizedFromBytes = isLinearizedFromBytes;
+/**
+ * Linearize a PDF held by the engine (by document id) and return the linearized bytes
+ * via the {@code QPdf_Linearization_LinearizeInMemoryFromId} unary-request/server-streaming RPC.
+ */
+function linearizeInMemoryFromId(id, password = "") {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            const stream = client.QPdf_Linearization_LinearizeInMemoryFromId({
+                document: { documentId: id },
+                password: password !== null && password !== void 0 ? password : "",
+            });
+            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", () => {
+                resolve(buffer_1.Buffer.concat(buffers));
+            });
+        });
+    });
+}
+exports.linearizeInMemoryFromId = linearizeInMemoryFromId;
+/**
+ * Linearize a PDF held by the engine (by document id) and stream the linearized bytes
+ * as a {@link Readable}. Useful for piping to HTTP responses or file streams without
+ * buffering the entire PDF in memory.
+ */
+function linearizeInMemoryFromIdStream(id, password = "") {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        const passThrough = new stream_1.PassThrough();
+        const stream = client.QPdf_Linearization_LinearizeInMemoryFromId({
+            document: { documentId: id },
+            password: password !== null && password !== void 0 ? password : "",
+        });
+        stream.on("data", (data) => {
+            if (data.exception) {
+                passThrough.destroy(new Error(`${data.exception.message}/n${data.exception.remoteStackTrace}`));
+            }
+            else if (data.resultChunk) {
+                passThrough.write(data.resultChunk);
+            }
+        });
+        stream.on("error", (err) => {
+            passThrough.destroy(err);
+        });
+        stream.on("end", () => {
+            passThrough.end();
+        });
+        return passThrough;
+    });
+}
+exports.linearizeInMemoryFromIdStream = linearizeInMemoryFromIdStream;
+/**
+ * Linearize a PDF provided as raw bytes and return the linearized bytes via the
+ * bidirectional streaming {@code QPdf_Linearization_LinearizeInMemory} RPC.
+ */
+function linearizeInMemoryFromBytes(pdfBytes, password = "") {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            const stream = client.QPdf_Linearization_LinearizeInMemory();
+            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", () => {
+                resolve(buffer_1.Buffer.concat(buffers));
+            });
+            stream.write({ info: { password: password !== null && password !== void 0 ? password : "" } });
+            (0, util_1.chunkBuffer)(pdfBytes).forEach((chunk) => {
+                stream.write({ pdfBytesChunk: chunk });
+            });
+            stream.end();
+        });
+    });
+}
+exports.linearizeInMemoryFromBytes = linearizeInMemoryFromBytes;
+/**
+ * Core linearization logic shared across all linearization entry points. Implements the
+ * {@link LinearizationMode} strategy pattern. Mirrors {@code PdfDocument.LinearizePdfCore}
+ * on the C# side.
+ */
+function linearizeCoreFromBytes(pdfBytes, password = "", mode = render_1.LinearizationMode.Automatic) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!pdfBytes || pdfBytes.length === 0) {
+            throw new Error("The PDF bytes cannot be null or empty.");
+        }
+        if (mode === render_1.LinearizationMode.InMemory) {
+            return linearizeInMemoryFromBytes(pdfBytes, password);
+        }
+        if (mode === render_1.LinearizationMode.FileBased) {
+            // Explicit FileBased — let any disk error bubble up.
+            return linearizeViaTempFile(pdfBytes, password);
+        }
+        // Automatic mode
+        if (canWriteToTemp()) {
+            try {
+                return yield linearizeViaTempFile(pdfBytes, password);
+            }
+            catch (e) {
+                console.warn(`Automatic Linearization: Disk attempt failed (${e.message}). ` +
+                    "Falling back to Memory linearization.");
+                return linearizeInMemoryFromBytes(pdfBytes, password);
+            }
+        }
+        console.warn("Automatic Linearization: No write permission detected. Using Memory linearization.");
+        return linearizeInMemoryFromBytes(pdfBytes, password);
+    });
+}
+exports.linearizeCoreFromBytes = linearizeCoreFromBytes;
+/**
+ * Variant of {@link linearizeCoreFromBytes} that starts from an open document on the engine.
+ * For {@link LinearizationMode.InMemory} we use the cheap document-id RPC; for the disk-based
+ * paths we have to fetch the bytes once and delegate to {@link linearizeCoreFromBytes}.
+ */
+function linearizeCoreFromId(id, getBytes, password = "", mode = render_1.LinearizationMode.Automatic) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (mode === render_1.LinearizationMode.InMemory) {
+            return linearizeInMemoryFromId(id, password);
+        }
+        const pdfBytes = yield getBytes();
+        return linearizeCoreFromBytes(pdfBytes, password, mode);
+    });
+}
+exports.linearizeCoreFromId = linearizeCoreFromId;
+/**
+ * Linearize via the engine's file-based RPC and persist the result through a client-side
+ * temporary file. The client-side disk write is the difference between this and
+ * {@link linearizeInMemoryFromBytes} — when the client filesystem is read-only,
+ * {@code FileBased} mode fails here so {@link LinearizationMode.Automatic} can fall back.
+ *
+ * Mirrors C# {@code PdfDocument.LinearizeViaTempFile}.
+ */
+function linearizeViaTempFile(pdfBytes, password) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const linearized = yield saveAsLinearizedFromBytes(pdfBytes, "", password);
+        const tempPath = path.join(os.tmpdir(), `ironpdf-linearize-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 10)}.pdf`);
+        try {
+            fs.writeFileSync(tempPath, linearized);
+            return fs.readFileSync(tempPath);
+        }
+        finally {
+            try {
+                if (fs.existsSync(tempPath)) {
+                    fs.unlinkSync(tempPath);
+                }
+            }
+            catch (_a) {
+                // best-effort cleanup
+            }
+        }
+    });
+}
+/**
+ * Probe whether the current process can create files in the system temp directory.
+ */
+function canWriteToTemp() {
+    const probePath = path.join(os.tmpdir(), `ironpdf-probe-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 10)}.tmp`);
+    try {
+        fs.writeFileSync(probePath, "");
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+    finally {
+        try {
+            if (fs.existsSync(probePath)) {
+                fs.unlinkSync(probePath);
+            }
+        }
+        catch (_b) {
+            // best-effort cleanup
+        }
+    }
+}
+/**
+ * Linearize a PDF provided as raw bytes and save the result to disk via the file-based
+ * streaming {@code QPdf_Linearization_SaveAsLinearizedFromBytes} RPC.
+ *
+ * Mirrors the in-memory behavior used by {@link compressInMemory} in {@code compress.ts}:
+ * the engine streams the linearized bytes back, and we concatenate and persist them
+ * locally at {@code outputPath}.
+ */
+function saveAsLinearizedFromBytes(pdfBytes, outputPath, password = "") {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            const stream = client.QPdf_Linearization_SaveAsLinearizedFromBytes();
+            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", () => {
+                resolve(buffer_1.Buffer.concat(buffers));
+            });
+            stream.write({
+                info: { outputPath: outputPath, password: password !== null && password !== void 0 ? password : "" },
+            });
+            (0, util_1.chunkBuffer)(pdfBytes).forEach((chunk) => {
+                stream.write({ pdfBytesChunk: chunk });
+            });
+            stream.end();
+        });
+    });
+}
+exports.saveAsLinearizedFromBytes = saveAsLinearizedFromBytes;
+//# sourceMappingURL=linearize.js.map

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

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

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

@@ -0,0 +1,338 @@
+import * as grpc from "@grpc/grpc-js";
+import {Buffer} from "buffer";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import {PassThrough, Readable} from "stream";
+import {Access} from "../../access";
+import {IronPdfServiceClient} from "../../generated_proto/ironpdfengineproto/IronPdfService";
+import {BytesResultStreamP__Output} from "../../generated_proto/ironpdfengineproto/BytesResultStreamP";
+import {BooleanResultP__Output} from "../../generated_proto/ironpdfengineproto/BooleanResultP";
+import {
+	QPdfIsLinearizedRequestStreamP
+} from "../../generated_proto/ironpdfengineproto/QPdfIsLinearizedRequestStreamP";
+import {
+	QPdfLinearizeInMemoryRequestStreamP
+} from "../../generated_proto/ironpdfengineproto/QPdfLinearizeInMemoryRequestStreamP";
+import {
+	QPdfSaveAsLinearizedFromBytesRequestStreamP
+} from "../../generated_proto/ironpdfengineproto/QPdfSaveAsLinearizedFromBytesRequestStreamP";
+import {LinearizationMode} from "../../../public/render";
+import {chunkBuffer, handleRemoteException} from "../util";
+ 
+/**
+ * Check if the given PDF bytes represent a linearized ("Fast Web View") PDF.
+ */
+export async function isLinearizedFromBytes(
+	pdfBytes: Buffer,
+	password = ""
+): Promise<boolean> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+ 
+	return new Promise(
+		(resolve: (_: boolean) => void, reject: (errorMsg: string) => void) => {
+			const stream: grpc.ClientWritableStream<QPdfIsLinearizedRequestStreamP> =
+				client.QPdf_Linearization_IsLinearized(
+					(err: grpc.ServiceError | null, value: BooleanResultP__Output | undefined) => {
+						if (err) {
+							reject(`${err.name}/n${err.message}`);
+						} else if (value) {
+							if (value.exception) {
+								handleRemoteException(value.exception, reject);
+								return;
+							}
+							resolve(value.result ?? false);
+						} else {
+							reject("No response from IronPdfEngine for isLinearized");
+						}
+					}
+				);
+ 
+			stream.write({info: {password: password ?? ""}});
+			chunkBuffer(pdfBytes).forEach((chunk) => {
+				stream.write({pdfBytesChunk: chunk});
+			});
+			stream.end();
+		}
+	);
+}
+ 
+/**
+ * Linearize a PDF held by the engine (by document id) and return the linearized bytes
+ * via the {@code QPdf_Linearization_LinearizeInMemoryFromId} unary-request/server-streaming RPC.
+ */
+export async function linearizeInMemoryFromId(
+	id: string,
+	password = ""
+): Promise<Buffer> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+ 
+	return new Promise(
+		(resolve: (_: Buffer) => void, reject: (errorMsg: string) => void) => {
+			const stream: grpc.ClientReadableStream<BytesResultStreamP__Output> =
+				client.QPdf_Linearization_LinearizeInMemoryFromId({
+					document: {documentId: id},
+					password: password ?? "",
+				});
+ 
+			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", () => {
+				resolve(Buffer.concat(buffers));
+			});
+		}
+	);
+}
+ 
+/**
+ * Linearize a PDF held by the engine (by document id) and stream the linearized bytes
+ * as a {@link Readable}. Useful for piping to HTTP responses or file streams without
+ * buffering the entire PDF in memory.
+ */
+export async function linearizeInMemoryFromIdStream(
+	id: string,
+	password = ""
+): Promise<Readable> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+ 
+	const passThrough = new PassThrough();
+ 
+	const stream: grpc.ClientReadableStream<BytesResultStreamP__Output> =
+		client.QPdf_Linearization_LinearizeInMemoryFromId({
+			document: {documentId: id},
+			password: password ?? "",
+		});
+ 
+	stream.on("data", (data: BytesResultStreamP__Output) => {
+		if (data.exception) {
+			passThrough.destroy(
+				new Error(`${data.exception.message}/n${data.exception.remoteStackTrace}`)
+			);
+		} else if (data.resultChunk) {
+			passThrough.write(data.resultChunk);
+		}
+	});
+ 
+	stream.on("error", (err: Error) => {
+		passThrough.destroy(err);
+	});
+ 
+	stream.on("end", () => {
+		passThrough.end();
+	});
+ 
+	return passThrough;
+}
+ 
+/**
+ * Linearize a PDF provided as raw bytes and return the linearized bytes via the
+ * bidirectional streaming {@code QPdf_Linearization_LinearizeInMemory} RPC.
+ */
+export async function linearizeInMemoryFromBytes(
+	pdfBytes: Buffer,
+	password = ""
+): Promise<Buffer> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+ 
+	return new Promise(
+		(resolve: (_: Buffer) => void, reject: (errorMsg: string) => void) => {
+			const stream: grpc.ClientDuplexStream<
+				QPdfLinearizeInMemoryRequestStreamP,
+				BytesResultStreamP__Output
+			> = client.QPdf_Linearization_LinearizeInMemory();
+ 
+			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", () => {
+				resolve(Buffer.concat(buffers));
+			});
+ 
+			stream.write({info: {password: password ?? ""}});
+			chunkBuffer(pdfBytes).forEach((chunk) => {
+				stream.write({pdfBytesChunk: chunk});
+			});
+			stream.end();
+		}
+	);
+}
+ 
+/**
+ * Core linearization logic shared across all linearization entry points. Implements the
+ * {@link LinearizationMode} strategy pattern. Mirrors {@code PdfDocument.LinearizePdfCore}
+ * on the C# side.
+ */
+export async function linearizeCoreFromBytes(
+	pdfBytes: Buffer,
+	password = "",
+	mode: LinearizationMode = LinearizationMode.Automatic
+): Promise<Buffer> {
+	if (!pdfBytes || pdfBytes.length === 0) {
+		throw new Error("The PDF bytes cannot be null or empty.");
+	}
+ 
+	if (mode === LinearizationMode.InMemory) {
+		return linearizeInMemoryFromBytes(pdfBytes, password);
+	}
+ 
+	if (mode === LinearizationMode.FileBased) {
+		// Explicit FileBased — let any disk error bubble up.
+		return linearizeViaTempFile(pdfBytes, password);
+	}
+ 
+	// Automatic mode
+	if (canWriteToTemp()) {
+		try {
+			return await linearizeViaTempFile(pdfBytes, password);
+		} catch (e) {
+			console.warn(
+				`Automatic Linearization: Disk attempt failed (${(e as Error).message}). ` +
+					"Falling back to Memory linearization."
+			);
+			return linearizeInMemoryFromBytes(pdfBytes, password);
+		}
+	}
+	console.warn("Automatic Linearization: No write permission detected. Using Memory linearization.");
+	return linearizeInMemoryFromBytes(pdfBytes, password);
+}
+ 
+/**
+ * Variant of {@link linearizeCoreFromBytes} that starts from an open document on the engine.
+ * For {@link LinearizationMode.InMemory} we use the cheap document-id RPC; for the disk-based
+ * paths we have to fetch the bytes once and delegate to {@link linearizeCoreFromBytes}.
+ */
+export async function linearizeCoreFromId(
+	id: string,
+	getBytes: () => Promise<Buffer>,
+	password = "",
+	mode: LinearizationMode = LinearizationMode.Automatic
+): Promise<Buffer> {
+	if (mode === LinearizationMode.InMemory) {
+		return linearizeInMemoryFromId(id, password);
+	}
+	const pdfBytes = await getBytes();
+	return linearizeCoreFromBytes(pdfBytes, password, mode);
+}
+ 
+/**
+ * Linearize via the engine's file-based RPC and persist the result through a client-side
+ * temporary file. The client-side disk write is the difference between this and
+ * {@link linearizeInMemoryFromBytes} — when the client filesystem is read-only,
+ * {@code FileBased} mode fails here so {@link LinearizationMode.Automatic} can fall back.
+ *
+ * Mirrors C# {@code PdfDocument.LinearizeViaTempFile}.
+ */
+async function linearizeViaTempFile(pdfBytes: Buffer, password: string): Promise<Buffer> {
+	const linearized = await saveAsLinearizedFromBytes(pdfBytes, "", password);
+	const tempPath = path.join(
+		os.tmpdir(),
+		`ironpdf-linearize-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 10)}.pdf`
+	);
+	try {
+		fs.writeFileSync(tempPath, linearized);
+		return fs.readFileSync(tempPath);
+	} finally {
+		try {
+			if (fs.existsSync(tempPath)) {
+				fs.unlinkSync(tempPath);
+			}
+		} catch {
+			// best-effort cleanup
+		}
+	}
+}
+ 
+/**
+ * Probe whether the current process can create files in the system temp directory.
+ */
+function canWriteToTemp(): boolean {
+	const probePath = path.join(
+		os.tmpdir(),
+		`ironpdf-probe-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 10)}.tmp`
+	);
+	try {
+		fs.writeFileSync(probePath, "");
+		return true;
+	} catch {
+		return false;
+	} finally {
+		try {
+			if (fs.existsSync(probePath)) {
+				fs.unlinkSync(probePath);
+			}
+		} catch {
+			// best-effort cleanup
+		}
+	}
+}
+ 
+/**
+ * Linearize a PDF provided as raw bytes and save the result to disk via the file-based
+ * streaming {@code QPdf_Linearization_SaveAsLinearizedFromBytes} RPC.
+ *
+ * Mirrors the in-memory behavior used by {@link compressInMemory} in {@code compress.ts}:
+ * the engine streams the linearized bytes back, and we concatenate and persist them
+ * locally at {@code outputPath}.
+ */
+export async function saveAsLinearizedFromBytes(
+	pdfBytes: Buffer,
+	outputPath: string,
+	password = ""
+): Promise<Buffer> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+ 
+	return new Promise(
+		(resolve: (_: Buffer) => void, reject: (errorMsg: string) => void) => {
+			const stream: grpc.ClientDuplexStream<
+				QPdfSaveAsLinearizedFromBytesRequestStreamP,
+				BytesResultStreamP__Output
+			> = client.QPdf_Linearization_SaveAsLinearizedFromBytes();
+ 
+			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", () => {
+				resolve(Buffer.concat(buffers));
+			});
+ 
+			stream.write({
+				info: {outputPath: outputPath, password: password ?? ""},
+			});
+			chunkBuffer(pdfBytes).forEach((chunk) => {
+				stream.write({pdfBytesChunk: chunk});
+			});
+			stream.end();
+		}
+	);
+}

package/src/internal/zod/renderSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderSchema.d.ts","sourceRoot":"","sources":["renderSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAA;AACrB,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,OAAO,EACP,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EAAE,kBAAkB,EACnC,WAAW,EACX,MAAM,qBAAqB,CAAC;AAK7B,eAAO,MAAM,iBAAiB,EAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAA6B,CAAA;AAEnF,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAKjE,CAAA;AAEF,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAK/D,CAAA;AAEF,eAAO,MAAM,yBAAyB,EAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAKpE,CAAA;AAEF,eAAO,MAAM,yBAAyB,EAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAKpE,CAAA;AAEF,eAAO,MAAM,yBAAyB,EAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAKpE,CAAA;AAEF,eAAO,MAAM,qBAAqB,EAAG,CAAC,CAAC,OAAO,CAAC,eAAe,CAE5D,CAAA;AAEF,eAAO,MAAM,8BAA8B,EAAG,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAM9E,CAAA;AAEF,eAAO,MAAM,aAAa,EAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAQ5C,CAAA;AAEF,eAAO,MAAM,0BAA0B,EAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAKtE,CAAA;AAEF,eAAO,MAAM,4BAA4B,EAAG,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAuB1E,CAAA"}
+{"version":3,"file":"renderSchema.d.ts","sourceRoot":"","sources":["renderSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAA;AACrB,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,OAAO,EACP,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EAAE,kBAAkB,EACnC,WAAW,EACX,MAAM,qBAAqB,CAAC;AAK7B,eAAO,MAAM,iBAAiB,EAAG,CAAC,CAAC,OAAO,CAAC,WAAW,CAA6B,CAAA;AAEnF,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAKjE,CAAA;AAEF,eAAO,MAAM,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAK/D,CAAA;AAEF,eAAO,MAAM,yBAAyB,EAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAKpE,CAAA;AAEF,eAAO,MAAM,yBAAyB,EAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAKpE,CAAA;AAEF,eAAO,MAAM,yBAAyB,EAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAKpE,CAAA;AAEF,eAAO,MAAM,qBAAqB,EAAG,CAAC,CAAC,OAAO,CAAC,eAAe,CAE5D,CAAA;AAEF,eAAO,MAAM,8BAA8B,EAAG,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAM9E,CAAA;AAEF,eAAO,MAAM,aAAa,EAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAQ5C,CAAA;AAEF,eAAO,MAAM,0BAA0B,EAAG,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAKtE,CAAA;AAEF,eAAO,MAAM,4BAA4B,EAAG,CAAC,CAAC,OAAO,CAAC,sBAAsB,CA4B1E,CAAA"}

package/src/internal/zod/renderSchema.js

@@ -84,6 +84,11 @@ exports.chromePdfRenderOptionsSchema = zod_1.z.object({
     htmlFooter: affixSchema_1.htmlAffixSchema.optional(),
     textHeader: affixSchema_1.textAffixSchema.optional(),
     textFooter: affixSchema_1.textAffixSchema.optional(),
-    useMarginsOnHeaderAndFooter: typeSchema_1.useMarginsSchema.optional()
+    useMarginsOnHeaderAndFooter: typeSchema_1.useMarginsSchema.optional(),
+    autoBookmarksFromHeadings: zod_1.z.boolean().optional(),
+    autoBookmarkMinHeadingLevel: zod_1.z.number().int().min(1).max(6).optional(),
+    autoBookmarkMaxHeadingLevel: zod_1.z.number().int().min(1).max(6).optional(),
+    autoBookmarkCssSelectors: zod_1.z.array(zod_1.z.string()).optional(),
+    elementQuerySelectors: zod_1.z.array(zod_1.z.string()).optional()
 });
 //# sourceMappingURL=renderSchema.js.map