@ironsoftware/ironpdf 2026.4.1 → 2026.5.1

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

@@ -0,0 +1,161 @@
+"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.getAnnotationCount = exports.addLinkAnnotation = exports.getAnnotations = void 0;
+const access_1 = require("../../access");
+const annotation_1 = require("../../../public/annotation");
+const util_1 = require("../util");
+/**
+ * URL prefix used to encode an internal hyperlink (goto-page) target inside the
+ * existing {@code Pdfium_Annotation_AddLinkAnnotation} RPC. Must match the
+ * {@code InternalLinkPrefixes.InternalLinkPrefix} constant in the C#
+ * {@code IronPdf.GrpcLayer.InternalPrefixes} / {@code IronPdfServiceHandler}.
+ *
+ * <p>The {@code x-} prefix follows RFC 6648 conventions for experimental /
+ * private URL schemes and cannot collide with any real URL scheme a user would
+ * construct.</p>
+ */
+const INTERNAL_LINK_PREFIX = "x-ironpdf-goto-page:";
+/**
+ * Retrieve all heterogeneous annotations (text, free-text, link, ...) on a single page
+ * via the {@code Pdfium_Annotation_GetAnnotations} unary RPC.
+ *
+ * The returned wrapped annotations carry one of the proto sub-types ({@code text},
+ * {@code freetext}, {@code link}). Callers inspect the {@code annotations} oneof to
+ * dispatch by sub-type.
+ */
+function getAnnotations(id, pageIndex) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            client.Pdfium_Annotation_GetAnnotationsRequestP({
+                document: { documentId: id },
+                pageIndex: pageIndex,
+            }, (err, value) => {
+                var _a, _b;
+                if (err) {
+                    reject(`${err.name}/n${err.message}`);
+                    return;
+                }
+                if (!value) {
+                    reject("No response from IronPdfEngine for getAnnotations");
+                    return;
+                }
+                if (value.exception) {
+                    (0, util_1.handleRemoteException)(value.exception, reject);
+                    return;
+                }
+                resolve((_b = (_a = value.result) === null || _a === void 0 ? void 0 : _a.annotations) !== null && _b !== void 0 ? _b : []);
+            });
+        });
+    });
+}
+exports.getAnnotations = getAnnotations;
+/**
+ * Add an internal hyperlink annotation to the document. The link navigates to a
+ * destination page within the same PDF when clicked.
+ *
+ * <p>Reuses the existing {@code Pdfium_Annotation_AddLinkAnnotation} RPC by encoding
+ * the destination parameters into a special URL format:
+ * {@code x-ironpdf-goto-page:{destPage},{destType},{left},{right},{top},{bottom},{zoom},{showBorder}}.
+ * The engine detects this prefix and routes the request to its internal link handler.</p>
+ *
+ * <p>Mirrors {@code IronPdf.Engines.Pdfium.GrpcPdfClient.AddInternalLinkAnnotation}
+ * on the C# side.</p>
+ */
+function addLinkAnnotation(id, link) {
+    var _a, _b, _c, _d, _e, _f;
+    return __awaiter(this, void 0, void 0, function* () {
+        if (link.pageIndex < 0) {
+            throw new Error("Invalid page index when adding link annotation");
+        }
+        if (link.destinationPageIndex < 0) {
+            throw new Error("Invalid destination page index when adding link annotation");
+        }
+        const client = yield access_1.Access.ensureConnection();
+        const destType = (_a = link.destinationType) !== null && _a !== void 0 ? _a : annotation_1.BookmarkDestinations.Page;
+        const destLeft = (_b = link.destinationLeft) !== null && _b !== void 0 ? _b : 0;
+        const destRight = (_c = link.destinationRight) !== null && _c !== void 0 ? _c : 0;
+        const destTop = (_d = link.destinationTop) !== null && _d !== void 0 ? _d : 0;
+        const destBottom = (_e = link.destinationBottom) !== null && _e !== void 0 ? _e : 0;
+        const destZoom = (_f = link.destinationZoom) !== null && _f !== void 0 ? _f : 0;
+        const showBorderFlag = link.showBorder ? 1 : 0;
+        // Matches the 8-field encoding produced by C# AddInternalLinkAnnotation:
+        //   {prefix}{destPageIndex},{destType},{destLeft},{destRight},{destTop},{destBottom},{destZoom},{showBorder}
+        const encodedUrl = `${INTERNAL_LINK_PREFIX}${link.destinationPageIndex},${destType},` +
+            `${destLeft},${destRight},${destTop},${destBottom},${destZoom},${showBorderFlag}`;
+        // Color fallback: the engine parses `color_code` into IronSoftware.Drawing.Color and
+        // throws on an empty string. Match the C# AddLinkAnnotation behavior by always
+        // sending a valid color — default to black when the caller hasn't specified one.
+        const colorCode = link.colorCode && link.colorCode.length > 0 ? link.colorCode : "#000000";
+        return new Promise((resolve, reject) => {
+            var _a, _b;
+            client.Pdfium_Annotation_AddLinkAnnotation({
+                document: { documentId: id },
+                name: (_a = link.title) !== null && _a !== void 0 ? _a : "",
+                url: encodedUrl,
+                pageIndex: link.pageIndex,
+                rectangle: {
+                    x: link.x,
+                    y: link.y,
+                    width: link.width,
+                    height: link.height,
+                },
+                colorCode: colorCode,
+                Hidden: (_b = link.hidden) !== null && _b !== void 0 ? _b : false,
+            }, (err, value) => {
+                if (err) {
+                    reject(`${err.name}/n${err.message}`);
+                    return;
+                }
+                if (!value) {
+                    reject("No response from IronPdfEngine for addLinkAnnotation");
+                    return;
+                }
+                (0, util_1.handleEmptyResultP__Output)(value, reject);
+                resolve();
+            });
+        });
+    });
+}
+exports.addLinkAnnotation = addLinkAnnotation;
+/**
+ * Retrieve the number of annotations contained on the specified page via the
+ * {@code Pdfium_Annotation_GetAnnotationCount} unary RPC.
+ */
+function getAnnotationCount(id, pageIndex) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            client.Pdfium_Annotation_GetAnnotationCountRequestP({
+                document: { documentId: id },
+                pageIndex: pageIndex,
+            }, (err, value) => {
+                var _a;
+                if (err) {
+                    reject(`${err.name}/n${err.message}`);
+                    return;
+                }
+                if (!value) {
+                    reject("No response from IronPdfEngine for getAnnotationCount");
+                    return;
+                }
+                if (value.exception) {
+                    (0, util_1.handleRemoteException)(value.exception, reject);
+                    return;
+                }
+                resolve((_a = value.result) !== null && _a !== void 0 ? _a : 0);
+            });
+        });
+    });
+}
+exports.getAnnotationCount = getAnnotationCount;
+//# sourceMappingURL=annotations.js.map

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

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

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

@@ -0,0 +1,190 @@
+import {ServiceError} from "@grpc/grpc-js";
+import {Access} from "../../access";
+import {IronPdfServiceClient} from "../../generated_proto/ironpdfengineproto/IronPdfService";
+import {EmptyResultP__Output} from "../../generated_proto/ironpdfengineproto/EmptyResultP";
+import {PdfiumGetAnnotationsResultP__Output} from "../../generated_proto/ironpdfengineproto/PdfiumGetAnnotationsResultP";
+import {PdfiumWrappedPdfAnnotationP__Output} from "../../generated_proto/ironpdfengineproto/PdfiumWrappedPdfAnnotationP";
+import {BookmarkDestinations, LinkAnnotation} from "../../../public/annotation";
+import {handleEmptyResultP__Output, handleRemoteException} from "../util";
+ 
+/**
+ * URL prefix used to encode an internal hyperlink (goto-page) target inside the
+ * existing {@code Pdfium_Annotation_AddLinkAnnotation} RPC. Must match the
+ * {@code InternalLinkPrefixes.InternalLinkPrefix} constant in the C#
+ * {@code IronPdf.GrpcLayer.InternalPrefixes} / {@code IronPdfServiceHandler}.
+ *
+ * <p>The {@code x-} prefix follows RFC 6648 conventions for experimental /
+ * private URL schemes and cannot collide with any real URL scheme a user would
+ * construct.</p>
+ */
+const INTERNAL_LINK_PREFIX = "x-ironpdf-goto-page:";
+ 
+/**
+ * Retrieve all heterogeneous annotations (text, free-text, link, ...) on a single page
+ * via the {@code Pdfium_Annotation_GetAnnotations} unary RPC.
+ *
+ * The returned wrapped annotations carry one of the proto sub-types ({@code text},
+ * {@code freetext}, {@code link}). Callers inspect the {@code annotations} oneof to
+ * dispatch by sub-type.
+ */
+export async function getAnnotations(
+	id: string,
+	pageIndex: number
+): Promise<PdfiumWrappedPdfAnnotationP__Output[]> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+ 
+	return new Promise(
+		(
+			resolve: (_: PdfiumWrappedPdfAnnotationP__Output[]) => void,
+			reject: (errorMsg: string) => void
+		) => {
+			client.Pdfium_Annotation_GetAnnotationsRequestP(
+				{
+					document: {documentId: id},
+					pageIndex: pageIndex,
+				},
+				(
+					err: ServiceError | null,
+					value: PdfiumGetAnnotationsResultP__Output | undefined
+				) => {
+					if (err) {
+						reject(`${err.name}/n${err.message}`);
+						return;
+					}
+					if (!value) {
+						reject("No response from IronPdfEngine for getAnnotations");
+						return;
+					}
+					if (value.exception) {
+						handleRemoteException(value.exception, reject);
+						return;
+					}
+					resolve(value.result?.annotations ?? []);
+				}
+			);
+		}
+	);
+}
+ 
+/**
+ * Add an internal hyperlink annotation to the document. The link navigates to a
+ * destination page within the same PDF when clicked.
+ *
+ * <p>Reuses the existing {@code Pdfium_Annotation_AddLinkAnnotation} RPC by encoding
+ * the destination parameters into a special URL format:
+ * {@code x-ironpdf-goto-page:{destPage},{destType},{left},{right},{top},{bottom},{zoom},{showBorder}}.
+ * The engine detects this prefix and routes the request to its internal link handler.</p>
+ *
+ * <p>Mirrors {@code IronPdf.Engines.Pdfium.GrpcPdfClient.AddInternalLinkAnnotation}
+ * on the C# side.</p>
+ */
+export async function addLinkAnnotation(
+	id: string,
+	link: LinkAnnotation
+): Promise<void> {
+	if (link.pageIndex < 0) {
+		throw new Error("Invalid page index when adding link annotation");
+	}
+	if (link.destinationPageIndex < 0) {
+		throw new Error("Invalid destination page index when adding link annotation");
+	}
+ 
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+ 
+	const destType: BookmarkDestinations = link.destinationType ?? BookmarkDestinations.Page;
+	const destLeft = link.destinationLeft ?? 0;
+	const destRight = link.destinationRight ?? 0;
+	const destTop = link.destinationTop ?? 0;
+	const destBottom = link.destinationBottom ?? 0;
+	const destZoom = link.destinationZoom ?? 0;
+	const showBorderFlag = link.showBorder ? 1 : 0;
+ 
+	// Matches the 8-field encoding produced by C# AddInternalLinkAnnotation:
+	//   {prefix}{destPageIndex},{destType},{destLeft},{destRight},{destTop},{destBottom},{destZoom},{showBorder}
+	const encodedUrl =
+		`${INTERNAL_LINK_PREFIX}${link.destinationPageIndex},${destType},` +
+		`${destLeft},${destRight},${destTop},${destBottom},${destZoom},${showBorderFlag}`;
+ 
+	// Color fallback: the engine parses `color_code` into IronSoftware.Drawing.Color and
+	// throws on an empty string. Match the C# AddLinkAnnotation behavior by always
+	// sending a valid color — default to black when the caller hasn't specified one.
+	const colorCode = link.colorCode && link.colorCode.length > 0 ? link.colorCode : "#000000";
+ 
+	return new Promise(
+		(resolve: () => void, reject: (errorMsg: string) => void) => {
+			client.Pdfium_Annotation_AddLinkAnnotation(
+				{
+					document: {documentId: id},
+					name: link.title ?? "",
+					url: encodedUrl,
+					pageIndex: link.pageIndex,
+					rectangle: {
+						x: link.x,
+						y: link.y,
+						width: link.width,
+						height: link.height,
+					},
+					colorCode: colorCode,
+					Hidden: link.hidden ?? false,
+				},
+				(
+					err: ServiceError | null,
+					value: EmptyResultP__Output | undefined
+				) => {
+					if (err) {
+						reject(`${err.name}/n${err.message}`);
+						return;
+					}
+					if (!value) {
+						reject("No response from IronPdfEngine for addLinkAnnotation");
+						return;
+					}
+					handleEmptyResultP__Output(value, reject);
+					resolve();
+				}
+			);
+		}
+	);
+}
+ 
+/**
+ * Retrieve the number of annotations contained on the specified page via the
+ * {@code Pdfium_Annotation_GetAnnotationCount} unary RPC.
+ */
+export async function getAnnotationCount(
+	id: string,
+	pageIndex: number
+): Promise<number> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+ 
+	return new Promise(
+		(resolve: (_: number) => void, reject: (errorMsg: string) => void) => {
+			client.Pdfium_Annotation_GetAnnotationCountRequestP(
+				{
+					document: {documentId: id},
+					pageIndex: pageIndex,
+				},
+				(
+					err: ServiceError | null,
+					value:
+						| import("../../generated_proto/ironpdfengineproto/IntResultP").IntResultP__Output
+						| undefined
+				) => {
+					if (err) {
+						reject(`${err.name}/n${err.message}`);
+						return;
+					}
+					if (!value) {
+						reject("No response from IronPdfEngine for getAnnotationCount");
+						return;
+					}
+					if (value.exception) {
+						handleRemoteException(value.exception, reject);
+						return;
+					}
+					resolve(value.result ?? 0);
+				}
+			);
+		}
+	);
+}

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

@@ -0,0 +1,7 @@
+import { Bookmark } from "../../../public/bookmark";
+/**
+ * Retrieve the document's outline bookmarks via the {@code Pdfium_Bookmark_GetBookmarksDescriptor}
+ * unary RPC. Mirrors {@code IronPdf.PdfDocument.Bookmarks} on the C# side.
+ */
+export declare function getBookmarks(id: string): Promise<Bookmark[]>;
+//# sourceMappingURL=bookmarks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bookmarks.d.ts","sourceRoot":"","sources":["bookmarks.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,QAAQ,EAAC,MAAM,0BAA0B,CAAC;AAGlD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsClE"}

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

@@ -0,0 +1,53 @@
+"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.getBookmarks = void 0;
+const access_1 = require("../../access");
+const util_1 = require("../util");
+/**
+ * Retrieve the document's outline bookmarks via the {@code Pdfium_Bookmark_GetBookmarksDescriptor}
+ * unary RPC. Mirrors {@code IronPdf.PdfDocument.Bookmarks} on the C# side.
+ */
+function getBookmarks(id) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            client.Pdfium_Bookmark_GetBookmarksDescriptor({ document: { documentId: id } }, (err, value) => {
+                var _a, _b;
+                if (err) {
+                    reject(`${err.name}/n${err.message}`);
+                    return;
+                }
+                if (!value) {
+                    reject("No response from IronPdfEngine for getBookmarks");
+                    return;
+                }
+                if (value.exception) {
+                    (0, util_1.handleRemoteException)(value.exception, reject);
+                    return;
+                }
+                const descriptors = (_b = (_a = value.result) === null || _a === void 0 ? void 0 : _a.bookmarkDescriptors) !== null && _b !== void 0 ? _b : [];
+                resolve(descriptors.map(d => {
+                    var _a, _b, _c, _d, _e;
+                    return ({
+                        text: (_a = d.text) !== null && _a !== void 0 ? _a : "",
+                        pageIndex: (_b = d.pageIndex) !== null && _b !== void 0 ? _b : 0,
+                        hierarchy: (_c = d.hierarchy) !== null && _c !== void 0 ? _c : "",
+                        itemId: (_d = d.itemId) !== null && _d !== void 0 ? _d : "",
+                        parentItemId: (_e = d.parentItemId) !== null && _e !== void 0 ? _e : "",
+                    });
+                }));
+            });
+        });
+    });
+}
+exports.getBookmarks = getBookmarks;
+//# sourceMappingURL=bookmarks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bookmarks.js","sourceRoot":"","sources":["bookmarks.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,yCAAoC;AAIpC,kCAA8C;AAE9C;;;GAGG;AACH,SAAsB,YAAY,CAAC,EAAU;;QAC5C,MAAM,MAAM,GAAyB,MAAM,eAAM,CAAC,gBAAgB,EAAE,CAAC;QAErE,OAAO,IAAI,OAAO,CACjB,CAAC,OAAgC,EAAE,MAAkC,EAAE,EAAE;YACxE,MAAM,CAAC,sCAAsC,CAC5C,EAAC,QAAQ,EAAE,EAAC,UAAU,EAAE,EAAE,EAAC,EAAC,EAC5B,CACC,GAAwB,EACxB,KAA8D,EAC7D,EAAE;;gBACH,IAAI,GAAG,EAAE;oBACR,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;oBACtC,OAAO;iBACP;gBACD,IAAI,CAAC,KAAK,EAAE;oBACX,MAAM,CAAC,iDAAiD,CAAC,CAAC;oBAC1D,OAAO;iBACP;gBACD,IAAI,KAAK,CAAC,SAAS,EAAE;oBACpB,IAAA,4BAAqB,EAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;oBAC/C,OAAO;iBACP;gBAED,MAAM,WAAW,GAAG,MAAA,MAAA,KAAK,CAAC,MAAM,0CAAE,mBAAmB,mCAAI,EAAE,CAAC;gBAC5D,OAAO,CACN,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;;oBAAC,OAAA,CAAC;wBACrB,IAAI,EAAE,MAAA,CAAC,CAAC,IAAI,mCAAI,EAAE;wBAClB,SAAS,EAAE,MAAA,CAAC,CAAC,SAAS,mCAAI,CAAC;wBAC3B,SAAS,EAAE,MAAA,CAAC,CAAC,SAAS,mCAAI,EAAE;wBAC5B,MAAM,EAAE,MAAA,CAAC,CAAC,MAAM,mCAAI,EAAE;wBACtB,YAAY,EAAE,MAAA,CAAC,CAAC,YAAY,mCAAI,EAAE;qBAClC,CAAC,CAAA;iBAAA,CAAC,CACH,CAAC;YACH,CAAC,CACD,CAAC;QACH,CAAC,CACD,CAAC;IACH,CAAC;CAAA;AAtCD,oCAsCC"}

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

@@ -0,0 +1,50 @@
+import {ServiceError} from "@grpc/grpc-js";
+import {Access} from "../../access";
+import {IronPdfServiceClient} from "../../generated_proto/ironpdfengineproto/IronPdfService";
+import {PdfiumGetBookmarksDescriptorResultP__Output} from "../../generated_proto/ironpdfengineproto/PdfiumGetBookmarksDescriptorResultP";
+import {Bookmark} from "../../../public/bookmark";
+import {handleRemoteException} from "../util";
+
+/**
+ * Retrieve the document's outline bookmarks via the {@code Pdfium_Bookmark_GetBookmarksDescriptor}
+ * unary RPC. Mirrors {@code IronPdf.PdfDocument.Bookmarks} on the C# side.
+ */
+export async function getBookmarks(id: string): Promise<Bookmark[]> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+
+	return new Promise(
+		(resolve: (_: Bookmark[]) => void, reject: (errorMsg: string) => void) => {
+			client.Pdfium_Bookmark_GetBookmarksDescriptor(
+				{document: {documentId: id}},
+				(
+					err: ServiceError | null,
+					value: PdfiumGetBookmarksDescriptorResultP__Output | undefined
+				) => {
+					if (err) {
+						reject(`${err.name}/n${err.message}`);
+						return;
+					}
+					if (!value) {
+						reject("No response from IronPdfEngine for getBookmarks");
+						return;
+					}
+					if (value.exception) {
+						handleRemoteException(value.exception, reject);
+						return;
+					}
+
+					const descriptors = value.result?.bookmarkDescriptors ?? [];
+					resolve(
+						descriptors.map(d => ({
+							text: d.text ?? "",
+							pageIndex: d.pageIndex ?? 0,
+							hierarchy: d.hierarchy ?? "",
+							itemId: d.itemId ?? "",
+							parentItemId: d.parentItemId ?? "",
+						}))
+					);
+				}
+			);
+		}
+	);
+}

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

@@ -0,0 +1,48 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import { Buffer } from "buffer";
+import { Readable } from "stream";
+import { LinearizationMode } from "../../../public/render";
+/**
+ * Check if the given PDF bytes represent a linearized ("Fast Web View") PDF.
+ */
+export declare function isLinearizedFromBytes(pdfBytes: Buffer, password?: string): Promise<boolean>;
+/**
+ * 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 declare function linearizeInMemoryFromId(id: string, password?: string): Promise<Buffer>;
+/**
+ * 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 declare function linearizeInMemoryFromIdStream(id: string, password?: string): Promise<Readable>;
+/**
+ * Linearize a PDF provided as raw bytes and return the linearized bytes via the
+ * bidirectional streaming {@code QPdf_Linearization_LinearizeInMemory} RPC.
+ */
+export declare function linearizeInMemoryFromBytes(pdfBytes: Buffer, password?: string): Promise<Buffer>;
+/**
+ * Core linearization logic shared across all linearization entry points. Implements the
+ * {@link LinearizationMode} strategy pattern. Mirrors {@code PdfDocument.LinearizePdfCore}
+ * on the C# side.
+ */
+export declare function linearizeCoreFromBytes(pdfBytes: Buffer, password?: string, mode?: LinearizationMode): Promise<Buffer>;
+/**
+ * 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 declare function linearizeCoreFromId(id: string, getBytes: () => Promise<Buffer>, password?: string, mode?: LinearizationMode): Promise<Buffer>;
+/**
+ * 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 declare function saveAsLinearizedFromBytes(pdfBytes: Buffer, outputPath: string, password?: string): Promise<Buffer>;
+//# sourceMappingURL=linearize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linearize.d.ts","sourceRoot":"","sources":["linearize.ts"],"names":[],"mappings":";;;AACA,OAAO,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAI9B,OAAO,EAAc,QAAQ,EAAC,MAAM,QAAQ,CAAC;AAc7C,OAAO,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AAGzD;;GAEG;AACH,wBAAsB,qBAAqB,CAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAK,GACX,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC5C,EAAE,EAAE,MAAM,EACV,QAAQ,SAAK,GACX,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CAClD,EAAE,EAAE,MAAM,EACV,QAAQ,SAAK,GACX,OAAO,CAAC,QAAQ,CAAC,CA8BnB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC/C,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAK,GACX,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC3C,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAK,EACb,IAAI,GAAE,iBAA+C,GACnD,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACxC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAC/B,QAAQ,SAAK,EACb,IAAI,GAAE,iBAA+C,GACnD,OAAO,CAAC,MAAM,CAAC,CAMjB;AAsDD;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC9C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,SAAK,GACX,OAAO,CAAC,MAAM,CAAC,CAoCjB"}