@ironsoftware/ironpdf 2026.3.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/compress.d.ts

@@ -4,6 +4,7 @@
 import { Readable } from "stream";
 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>;
 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;AAE7C,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,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":";;;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"}

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

@@ -8,11 +8,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+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.compressStructTree = exports.compressImage = void 0;
+exports.compressInMemoryStream = 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"));
 function compressImage(id, imageQuality, scaleToVisibleSize = false) {
     return __awaiter(this, void 0, void 0, function* () {
         const client = yield access_1.Access.ensureConnection();
@@ -53,6 +57,32 @@ function compressStructTree(id) {
     });
 }
 exports.compressStructTree = compressStructTree;
+function compressAndSaveAs(id, outputPath, imageQuality) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = yield access_1.Access.ensureConnection();
+        return new Promise((resolve, reject) => {
+            const request = Object.assign({ document: { documentId: id }, outputPath: "", password: "" }, (imageQuality !== undefined ? { jpeg: imageQuality } : {}));
+            const stream = client.QPdf_Compression_CompressAndSaveAs(request);
+            const buffers = [];
+            stream.on("data", (data) => {
+                if (data.exception) {
+                    reject(`${data.exception.message}/n${data.exception.remoteStackTrace}`);
+                }
+                else if (data.resultChunk) {
+                    buffers.push(data.resultChunk);
+                }
+            });
+            stream.on("error", (err) => {
+                reject(`${err.name}/n${err.message}`);
+            });
+            stream.on("end", () => {
+                fs_1.default.writeFileSync(outputPath, Buffer.concat(buffers));
+                resolve();
+            });
+        });
+    });
+}
+exports.compressAndSaveAs = compressAndSaveAs;
 function compressInMemory(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

@@ -6,6 +6,7 @@ import {EmptyResultP__Output} from "../../generated_proto/ironpdfengineproto/Emp
 import {BytesResultStreamP__Output} from "../../generated_proto/ironpdfengineproto/BytesResultStreamP";
 import {handleEmptyResultP__Output} from "../util";
 import {PassThrough, Readable} from "stream";
+import fs from "fs";
 
 export async function compressImage(
 	id: string,
@@ -63,6 +64,47 @@ export async function compressStructTree(
 	);
 }
 
+export async function compressAndSaveAs(
+	id: string,
+	outputPath: string,
+	imageQuality?: number
+): Promise<void> {
+	const client: IronPdfServiceClient = await Access.ensureConnection();
+
+	return new Promise(
+		(resolve: () => void, reject: (errorMsg: string) => void) => {
+			const request = {
+					document: {documentId: id},
+					outputPath: "",
+					password: "",
+					...(imageQuality !== undefined ? {jpeg: imageQuality} : {}),
+				};
+			const stream: grpc.ClientReadableStream<BytesResultStreamP__Output> =
+				client.QPdf_Compression_CompressAndSaveAs(request);
+
+			const buffers: Buffer[] = [];
+			stream.on("data", (data: BytesResultStreamP__Output) => {
+				if (data.exception) {
+					reject(
+						`${data.exception.message}/n${data.exception.remoteStackTrace}`
+					);
+				} else if (data.resultChunk) {
+					buffers.push(data.resultChunk);
+				}
+			});
+
+			stream.on("error", (err: Error) => {
+				reject(`${err.name}/n${err.message}`);
+			});
+
+			stream.on("end", () => {
+				fs.writeFileSync(outputPath, Buffer.concat(buffers));
+				resolve();
+			});
+		}
+	);
+}
+
 export async function compressInMemory(
 	id: string,
 	imageQuality?: number