node-poppler 7.2.4 → 8.0.1

package/README.md

@@ -6,13 +6,13 @@
 [![Coverage status](https://coveralls.io/repos/github/Fdawgs/node-poppler/badge.svg?branch=main)](https://coveralls.io/github/Fdawgs/node-poppler?branch=main)
 [![code style: Prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat)](https://github.com/prettier/prettier)
 
-> Asynchronous node.js wrapper for the Poppler PDF rendering library
+> Asynchronous Node.js wrapper for the Poppler PDF rendering library
 
 ## Overview
 
 [Poppler](https://poppler.freedesktop.org/) is a PDF rendering library that also includes a collection of utility binaries, which allows for the manipulation and extraction of data from PDF documents such as converting PDF files to HTML, TXT, or PostScript.
 
-The `node-poppler` module provides an asynchronous node.js wrapper around said utility binaries for easier use.
+The `node-poppler` module provides an asynchronous Node.js wrapper around said utility binaries for easier use.
 
 ## Installation
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "node-poppler",
-	"version": "7.2.4",
-	"description": "Asynchronous node.js wrapper for the Poppler PDF rendering library",
+	"version": "8.0.1",
+	"description": "Asynchronous Node.js wrapper for the Poppler PDF rendering library",
 	"keywords": [
 		"async",
 		"attach",
@@ -47,7 +47,7 @@
 	"author": "Frazer Smith <frazer.dev@icloud.com>",
 	"funding": "https://github.com/sponsors/Fdawgs",
 	"engines": {
-		"node": ">=18"
+		"node": ">=20"
 	},
 	"dependencies": {
 		"camelcase": "^6.3.0",

package/src/index.js

@@ -22,12 +22,24 @@ const errorMessages = {
 const popplerVersionRegex = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u;
 const pdfInfoFileSizesRegex = /(File\s+size:\s+)0(\s+)bytes/u;
 
+/**
+ * @typedef {object} OptionDetails
+ * @property {string} arg The argument to pass to the binary.
+ * @property {('boolean'|'number'|'string')} type The type of the option.
+ * @property {string} [minVersion] The minimum version of the binary that supports this option.
+ * @property {string} [maxVersion] The maximum version of the binary that supports this option (optional).
+ */
+
+/**
+ * @typedef {Record<string, OptionDetails>} PopplerAcceptedOptions
+ */
+
 /**
  * @author Frazer Smith
  * @description Checks each option provided is valid, of the correct type, and can be used by specified
  * version of binary.
  * @ignore
- * @param {object} acceptedOptions - Object containing accepted options.
+ * @param {PopplerAcceptedOptions} acceptedOptions - Object containing accepted options.
  * @param {Record<string, any>} options - Object containing options to pass to binary.
  * @param {string} [version] - Version of binary.
  * @returns {string[]} Array of CLI arguments.
@@ -38,9 +50,17 @@ function parseOptions(acceptedOptions, options, version) {
 	const args = [];
 	/** @type {string[]} */
 	const invalidArgs = [];
-	for (const key of Object.keys(options)) {
+	/**
+	 * Imperative loops are faster than functional loops.
+	 * @see {@link https://romgrk.com/posts/optimizing-javascript#3-avoid-arrayobject-methods || Optimizing JavaScript}
+	 */
+	const entries = Object.entries(options);
+	const entriesLength = entries.length;
+	for (let i = 0; i < entriesLength; i += 1) {
+		// Destructuring adds overhead, so use index access
+		const key = entries[i][0];
 		if (Object.hasOwn(acceptedOptions, key)) {
-			const option = options[key];
+			const option = entries[i][1];
 			const acceptedOption = acceptedOptions[key];
 
 			// eslint-disable-next-line valid-typeof -- `type` is a string
@@ -85,6 +105,8 @@ function parseOptions(acceptedOptions, options, version) {
 }
 
 class Poppler {
+	#popplerPath;
+
 	/**
 	 * @param {string} [binPath] - Path of poppler-utils binaries.
 	 * If not provided, the constructor will attempt to find the Poppler `pdfinfo` binary
@@ -93,12 +115,12 @@ class Poppler {
 	 * if a local installation is not found.
 	 */
 	constructor(binPath) {
-		this.popplerPath = "";
+		this.#popplerPath = "";
 
 		/* istanbul ignore else: requires specific OS */
 		if (binPath) {
 			/** @type {string|undefined} */
-			this.popplerPath = binPath;
+			this.#popplerPath = binPath;
 		} else {
 			const { platform } = process;
 
@@ -108,10 +130,10 @@ class Poppler {
 			const popplerPath = /(.+)pdfinfo/u.exec(which)?.[1];
 
 			if (popplerPath) {
-				this.popplerPath = popplerPath;
+				this.#popplerPath = popplerPath;
 			}
 			if (platform === "win32" && !popplerPath) {
-				this.popplerPath = pathResolve(
+				this.#popplerPath = pathResolve(
 					__dirname,
 					"lib",
 					"win32",
@@ -123,12 +145,20 @@ class Poppler {
 		}
 
 		/* istanbul ignore next: unable to test due to https://github.com/jestjs/jest/pull/14297 */
-		if (!this.popplerPath) {
+		if (!this.#popplerPath) {
 			throw new Error(
 				`Unable to find ${process.platform} Poppler binaries, please pass the installation directory as a parameter to the Poppler instance.`
 			);
 		}
-		this.popplerPath = normalize(this.popplerPath);
+		this.#popplerPath = normalize(this.#popplerPath);
+	}
+
+	/**
+	 * @description Returns the path of the Poppler binaries.
+	 * @returns {string} Path of Poppler binaries.
+	 */
+	get path() {
+		return this.#popplerPath;
 	}
 
 	/**
@@ -143,6 +173,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfAttach(file, fileToAttach, outputFile, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			printVersionInfo: { arg: "-v", type: "boolean" },
 			replace: { arg: "-replace", type: "boolean" },
@@ -153,7 +184,7 @@ class Poppler {
 			args.push(file, fileToAttach, outputFile);
 
 			const { stdout } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdfattach"),
+				pathResolve(this.#popplerPath, "pdfattach"),
 				args
 			);
 			return Promise.resolve(stdout);
@@ -189,6 +220,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfDetach(file, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			listEmbedded: { arg: "-list", type: "boolean" },
 			outputEncoding: { arg: "-enc", type: "string" },
@@ -210,7 +242,7 @@ class Poppler {
 			args.push(file);
 
 			const { stdout } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdfdetach"),
+				pathResolve(this.#popplerPath, "pdfdetach"),
 				args
 			);
 			return Promise.resolve(stdout);
@@ -222,7 +254,7 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Lists the fonts used in a PDF file along with various information for each font.
-	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
 	 * @param {object} [options] - Object containing options to pass to binary.
 	 * @param {number} [options.firstPageToExamine] - Specifies the first page to examine.
 	 * @param {number} [options.lastPageToExamine] - Specifies the last page to examine.
@@ -234,6 +266,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfFonts(file, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			firstPageToExamine: { arg: "-f", type: "number" },
 			lastPageToExamine: { arg: "-l", type: "number" },
@@ -245,7 +278,7 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdffonts"),
+				pathResolve(this.#popplerPath, "pdffonts"),
 				["-v"]
 			);
 
@@ -258,7 +291,7 @@ class Poppler {
 				args.push(Buffer.isBuffer(file) ? "-" : file);
 
 				const child = spawn(
-					pathResolve(this.popplerPath, "pdffonts"),
+					pathResolve(this.#popplerPath, "pdffonts"),
 					args
 				);
 
@@ -289,6 +322,7 @@ class Poppler {
 					} else {
 						reject(
 							new Error(
+								// @ts-ignore: Second operand used if code is not in errorMessages
 								errorMessages[code] ||
 									`pdffonts ${args.join(
 										" "
@@ -306,7 +340,7 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Saves images from a PDF file as PPM, PBM, PNG, TIFF, JPEG, JPEG2000, or JBIG2 files.
-	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
 	 * @param {string} [outputPrefix] - Filename prefix of output files.
 	 * @param {object} [options] - Object containing options to pass to binary.
 	 * @param {boolean} [options.allFiles] - Write JPEG, JPEG2000, JBIG2, and CCITT images in their native format.
@@ -328,6 +362,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfImages(file, outputPrefix, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			allFiles: { arg: "-all", type: "boolean" },
 			ccittFile: { arg: "-ccitt", type: "boolean" },
@@ -346,7 +381,7 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdfimages"),
+				pathResolve(this.#popplerPath, "pdfimages"),
 				["-v"]
 			);
 
@@ -363,7 +398,7 @@ class Poppler {
 				}
 
 				const child = spawn(
-					pathResolve(this.popplerPath, "pdfimages"),
+					pathResolve(this.#popplerPath, "pdfimages"),
 					args
 				);
 
@@ -394,6 +429,7 @@ class Poppler {
 					} else {
 						reject(
 							new Error(
+								// @ts-ignore: Second operand used if code is not in errorMessages
 								errorMessages[code] ||
 									`pdfimages ${args.join(
 										" "
@@ -411,7 +447,7 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Prints the contents of the `Info` dictionary from a PDF file.
-	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
 	 * @param {object} [options] - Object containing options to pass to binary.
 	 * @param {number} [options.firstPageToConvert] - First page to print.
 	 * @param {number} [options.lastPageToConvert] - Last page to print.
@@ -443,6 +479,7 @@ class Poppler {
 	 * `options.printAsJson` is `true`, or rejects with an `Error` object.
 	 */
 	async pdfInfo(file, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			firstPageToConvert: { arg: "-f", type: "number" },
 			lastPageToConvert: { arg: "-l", type: "number" },
@@ -465,7 +502,7 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdfinfo"),
+				pathResolve(this.#popplerPath, "pdfinfo"),
 				["-v"]
 			);
 
@@ -490,7 +527,7 @@ class Poppler {
 				}
 
 				const child = spawn(
-					pathResolve(this.popplerPath, "pdfinfo"),
+					pathResolve(this.#popplerPath, "pdfinfo"),
 					args
 				);
 
@@ -526,13 +563,16 @@ class Poppler {
 						 */
 						if (options.printAsJson === true) {
 							const info = {};
-							stdOut.split("\n").forEach((line) => {
+							const stdOutLines = stdOut.split("\n");
+							const stdOutLinesLength = stdOutLines.length;
+							for (let i = 0; i < stdOutLinesLength; i += 1) {
+								const line = stdOutLines[i];
 								const lines = line.split(": ");
 								if (lines.length > 1) {
 									// @ts-ignore: creating dynamic object keys
 									info[camelCase(lines[0])] = lines[1].trim();
 								}
-							});
+							}
 							resolve(info);
 						} else {
 							resolve(stdOut.trim());
@@ -544,6 +584,7 @@ class Poppler {
 					} else {
 						reject(
 							new Error(
+								// @ts-ignore: Second operand used if code is not in errorMessages
 								errorMessages[code] ||
 									`pdfinfo ${args.join(
 										" "
@@ -576,6 +617,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfSeparate(file, outputPattern, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			firstPageToExtract: { arg: "-f", type: "number" },
 			lastPageToExtract: { arg: "-l", type: "number" },
@@ -584,7 +626,7 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdfseparate"),
+				pathResolve(this.#popplerPath, "pdfseparate"),
 				["-v"]
 			);
 
@@ -595,7 +637,7 @@ class Poppler {
 			args.push(file, outputPattern);
 
 			const { stdout } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdfseparate"),
+				pathResolve(this.#popplerPath, "pdfseparate"),
 				args
 			);
 			return Promise.resolve(stdout);
@@ -712,6 +754,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToCairo(file, outputFile, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			antialias: { arg: "-antialias", type: "string" },
 			cropBox: { arg: "-cropbox", type: "boolean" },
@@ -768,7 +811,7 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdftocairo"),
+				pathResolve(this.#popplerPath, "pdftocairo"),
 				["-v"]
 			);
 
@@ -784,7 +827,7 @@ class Poppler {
 				);
 
 				const child = spawn(
-					pathResolve(this.popplerPath, "pdftocairo"),
+					pathResolve(this.#popplerPath, "pdftocairo"),
 					args
 				);
 
@@ -822,6 +865,7 @@ class Poppler {
 					} else {
 						reject(
 							new Error(
+								// @ts-ignore: Second operand used if code is not in errorMessages
 								errorMessages[code] ||
 									`pdftocairo ${args.join(
 										" "
@@ -839,7 +883,7 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Converts a PDF file to HTML.
-	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
 	 * @param {string} [outputFile] - Filepath of the file to output the results to.
 	 * If `undefined` then Poppler will use the directory and name of the original file
 	 * and create a new file, with `-html` appended to the end of the filename.
@@ -877,6 +921,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToHtml(file, outputFile, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			complexOutput: { arg: "-c", type: "boolean" },
 			dataUrls: {
@@ -909,7 +954,7 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdftohtml"),
+				pathResolve(this.#popplerPath, "pdftohtml"),
 				["-v"]
 			);
 
@@ -926,7 +971,7 @@ class Poppler {
 				}
 
 				const child = spawn(
-					pathResolve(this.popplerPath, "pdftohtml"),
+					pathResolve(this.#popplerPath, "pdftohtml"),
 					args
 				);
 
@@ -968,7 +1013,7 @@ class Poppler {
 	 * @description Converts a PDF file to colour image files in Portable Pixmap (PPM) format,
 	 * grayscale image files in Portable Graymap (PGM) format, or monochrome image files
 	 * in Portable Bitmap (PBM) format.
-	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
 	 * @param {string} outputPath - Filepath to output the results to.
 	 * @param {object} [options] - Object containing options to pass to binary.
 	 * @param {('no'|'yes')} [options.antialiasFonts] - Enable or disable font anti-aliasing.
@@ -1038,6 +1083,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToPpm(file, outputPath, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			antialiasFonts: { arg: "-aa", type: "string" },
 			antialiasVectors: { arg: "-aaVector", type: "string" },
@@ -1110,7 +1156,7 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdftoppm"),
+				pathResolve(this.#popplerPath, "pdftoppm"),
 				["-v"]
 			);
 
@@ -1123,7 +1169,7 @@ class Poppler {
 				args.push(Buffer.isBuffer(file) ? "-" : file, outputPath);
 
 				const child = spawn(
-					pathResolve(this.popplerPath, "pdftoppm"),
+					pathResolve(this.#popplerPath, "pdftoppm"),
 					args
 				);
 
@@ -1147,6 +1193,7 @@ class Poppler {
 					} else {
 						reject(
 							new Error(
+								// @ts-ignore: Second operand used if code is not in errorMessages
 								errorMessages[code] ||
 									`pdftoppm ${args.join(
 										" "
@@ -1164,7 +1211,7 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Converts a PDF file to PostScript (PS).
-	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
 	 * @param {string} [outputFile] - Filepath of the file to output the results to.
 	 * If `undefined` then will write output to stdout.
 	 * @param {object} [options] - Object containing options to pass to binary.
@@ -1271,6 +1318,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToPs(file, outputFile, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			antialias: { arg: "-aaRaster", type: "string" },
 			binary: { arg: "-binary", type: "boolean" },
@@ -1342,7 +1390,7 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdftops"),
+				pathResolve(this.#popplerPath, "pdftops"),
 				["-v"]
 			);
 
@@ -1358,7 +1406,7 @@ class Poppler {
 				);
 
 				const child = spawn(
-					pathResolve(this.popplerPath, "pdftops"),
+					pathResolve(this.#popplerPath, "pdftops"),
 					args
 				);
 
@@ -1389,6 +1437,7 @@ class Poppler {
 					} else {
 						reject(
 							new Error(
+								// @ts-ignore: Second operand used if code is not in errorMessages
 								errorMessages[code] ||
 									`pdftops ${args.join(
 										" "
@@ -1406,7 +1455,7 @@ class Poppler {
 	/**
 	 * @author Frazer Smith
 	 * @description Converts a PDF file to TXT.
-	 * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+	 * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
 	 * @param {string} [outputFile] - Filepath of the file to output the results to.
 	 * If `undefined` then will write output to stdout.
 	 * @param {object} [options] - Object containing options to pass to binary.
@@ -1452,6 +1501,7 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfToText(file, outputFile, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			boundingBoxXhtml: { arg: "-bbox", type: "boolean" },
 			boundingBoxXhtmlLayout: {
@@ -1492,7 +1542,7 @@ class Poppler {
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdftotext"),
+				pathResolve(this.#popplerPath, "pdftotext"),
 				["-v"]
 			);
 
@@ -1508,7 +1558,7 @@ class Poppler {
 				);
 
 				const child = spawn(
-					pathResolve(this.popplerPath, "pdftotext"),
+					pathResolve(this.#popplerPath, "pdftotext"),
 					args
 				);
 
@@ -1541,6 +1591,7 @@ class Poppler {
 					} else {
 						reject(
 							new Error(
+								// @ts-ignore: Second operand used if code is not in errorMessages
 								errorMessages[code] ||
 									`pdftotext ${args.join(
 										" "
@@ -1567,13 +1618,14 @@ class Poppler {
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
 	async pdfUnite(files, outputFile, options = {}) {
+		/** @type {PopplerAcceptedOptions} */
 		const acceptedOptions = {
 			printVersionInfo: { arg: "-v", type: "boolean" },
 		};
 
 		try {
 			const { stderr } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdfunite"),
+				pathResolve(this.#popplerPath, "pdfunite"),
 				["-v"]
 			);
 
@@ -1581,13 +1633,10 @@ class Poppler {
 			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
-			files.forEach((element) => {
-				args.push(element);
-			});
-			args.push(outputFile);
+			args.push(...files, outputFile);
 
 			const { stdout } = await execFileAsync(
-				pathResolve(this.popplerPath, "pdfunite"),
+				pathResolve(this.#popplerPath, "pdfunite"),
 				args
 			);
 			return Promise.resolve(stdout);

package/types/index.d.ts

@@ -1,4 +1,23 @@
 export default Poppler;
+export type OptionDetails = {
+    /**
+     * The argument to pass to the binary.
+     */
+    arg: string;
+    /**
+     * The type of the option.
+     */
+    type: ("boolean" | "number" | "string");
+    /**
+     * The minimum version of the binary that supports this option.
+     */
+    minVersion?: string | undefined;
+    /**
+     * The maximum version of the binary that supports this option (optional).
+     */
+    maxVersion?: string | undefined;
+};
+export type PopplerAcceptedOptions = Record<string, OptionDetails>;
 export class Poppler {
     /**
      * @param {string} [binPath] - Path of poppler-utils binaries.
@@ -8,7 +27,11 @@ export class Poppler {
      * if a local installation is not found.
      */
     constructor(binPath?: string);
-    popplerPath: string;
+    /**
+     * @description Returns the path of the Poppler binaries.
+     * @returns {string} Path of Poppler binaries.
+     */
+    get path(): string;
     /**
      * @author Frazer Smith
      * @description Embeds files (attachments) into a PDF file.
@@ -21,8 +44,8 @@ export class Poppler {
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
     pdfAttach(file: string, fileToAttach: string, outputFile: string, options?: {
-        printVersionInfo?: boolean;
-        replace?: boolean;
+        printVersionInfo?: boolean | undefined;
+        replace?: boolean | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
@@ -51,20 +74,20 @@ export class Poppler {
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
     pdfDetach(file: string, options?: {
-        listEmbedded?: boolean;
-        outputEncoding?: string;
-        ownerPassword?: string;
-        outputPath?: string;
-        printVersionInfo?: boolean;
-        saveAllFiles?: boolean;
-        saveFile?: string;
-        saveSpecificFile?: number;
-        userPassword?: string;
+        listEmbedded?: boolean | undefined;
+        outputEncoding?: string | undefined;
+        ownerPassword?: string | undefined;
+        outputPath?: string | undefined;
+        printVersionInfo?: boolean | undefined;
+        saveAllFiles?: boolean | undefined;
+        saveFile?: string | undefined;
+        saveSpecificFile?: number | undefined;
+        userPassword?: string | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
      * @description Lists the fonts used in a PDF file along with various information for each font.
-     * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+     * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
      * @param {object} [options] - Object containing options to pass to binary.
      * @param {number} [options.firstPageToExamine] - Specifies the first page to examine.
      * @param {number} [options.lastPageToExamine] - Specifies the last page to examine.
@@ -75,18 +98,18 @@ export class Poppler {
      * @param {string} [options.userPassword] - User password (for encrypted files).
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
-    pdfFonts(file: Buffer | string, options?: {
-        firstPageToExamine?: number;
-        lastPageToExamine?: number;
-        listSubstitutes?: boolean;
-        ownerPassword?: string;
-        printVersionInfo?: boolean;
-        userPassword?: string;
+    pdfFonts(file: (Buffer | string), options?: {
+        firstPageToExamine?: number | undefined;
+        lastPageToExamine?: number | undefined;
+        listSubstitutes?: boolean | undefined;
+        ownerPassword?: string | undefined;
+        printVersionInfo?: boolean | undefined;
+        userPassword?: string | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
      * @description Saves images from a PDF file as PPM, PBM, PNG, TIFF, JPEG, JPEG2000, or JBIG2 files.
-     * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+     * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
      * @param {string} [outputPrefix] - Filename prefix of output files.
      * @param {object} [options] - Object containing options to pass to binary.
      * @param {boolean} [options.allFiles] - Write JPEG, JPEG2000, JBIG2, and CCITT images in their native format.
@@ -107,25 +130,25 @@ export class Poppler {
      * @param {string} [options.userPassword] - Specify the user password for the PDF file.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
-    pdfImages(file: Buffer | string, outputPrefix?: string, options?: {
-        allFiles?: boolean;
-        ccittFile?: boolean;
-        firstPageToConvert?: number;
-        lastPageToConvert?: number;
-        jbig2File?: boolean;
-        jpeg2000File?: boolean;
-        jpegFile?: boolean;
-        list?: boolean;
-        ownerPassword?: string;
-        pngFile?: boolean;
-        printVersionInfo?: boolean;
-        tiffFile?: boolean;
-        userPassword?: string;
+    pdfImages(file: (Buffer | string), outputPrefix?: string, options?: {
+        allFiles?: boolean | undefined;
+        ccittFile?: boolean | undefined;
+        firstPageToConvert?: number | undefined;
+        lastPageToConvert?: number | undefined;
+        jbig2File?: boolean | undefined;
+        jpeg2000File?: boolean | undefined;
+        jpegFile?: boolean | undefined;
+        list?: boolean | undefined;
+        ownerPassword?: string | undefined;
+        pngFile?: boolean | undefined;
+        printVersionInfo?: boolean | undefined;
+        tiffFile?: boolean | undefined;
+        userPassword?: string | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
      * @description Prints the contents of the `Info` dictionary from a PDF file.
-     * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+     * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
      * @param {object} [options] - Object containing options to pass to binary.
      * @param {number} [options.firstPageToConvert] - First page to print.
      * @param {number} [options.lastPageToConvert] - Last page to print.
@@ -156,24 +179,24 @@ export class Poppler {
      * @returns {Promise<object|string>} A promise that resolves with a stdout string or JSON object if
      * `options.printAsJson` is `true`, or rejects with an `Error` object.
      */
-    pdfInfo(file: Buffer | string, options?: {
-        firstPageToConvert?: number;
-        lastPageToConvert?: number;
-        listEncodingOptions?: boolean;
-        outputEncoding?: string;
-        ownerPassword?: string;
-        printAsJson?: boolean;
-        printBoundingBoxes?: boolean;
-        printDocStruct?: boolean;
-        printDocStructText?: boolean;
-        printIsoDates?: boolean;
-        printJS?: boolean;
-        printMetadata?: boolean;
-        printNamedDests?: boolean;
-        printRawDates?: boolean;
-        printUrls?: boolean;
-        printVersionInfo?: boolean;
-        userPassword?: string;
+    pdfInfo(file: (Buffer | string), options?: {
+        firstPageToConvert?: number | undefined;
+        lastPageToConvert?: number | undefined;
+        listEncodingOptions?: boolean | undefined;
+        outputEncoding?: string | undefined;
+        ownerPassword?: string | undefined;
+        printAsJson?: boolean | undefined;
+        printBoundingBoxes?: boolean | undefined;
+        printDocStruct?: boolean | undefined;
+        printDocStructText?: boolean | undefined;
+        printIsoDates?: boolean | undefined;
+        printJS?: boolean | undefined;
+        printMetadata?: boolean | undefined;
+        printNamedDests?: boolean | undefined;
+        printRawDates?: boolean | undefined;
+        printUrls?: boolean | undefined;
+        printVersionInfo?: boolean | undefined;
+        userPassword?: string | undefined;
     }): Promise<object | string>;
     /**
      * @author Frazer Smith
@@ -193,9 +216,9 @@ export class Poppler {
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
     pdfSeparate(file: string, outputPattern: string, options?: {
-        firstPageToExtract?: number;
-        lastPageToExtract?: number;
-        printVersionInfo?: boolean;
+        firstPageToExtract?: number | undefined;
+        lastPageToExtract?: number | undefined;
+        printVersionInfo?: boolean | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
@@ -305,58 +328,58 @@ export class Poppler {
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
     pdfToCairo(file: Buffer | string, outputFile?: string, options?: {
-        antialias?: ("best" | "default" | "fast" | "good" | "gray" | "none" | "subpixel");
-        cropBox?: boolean;
-        cropHeight?: number;
-        cropSize?: number;
-        cropWidth?: number;
-        cropXAxis?: number;
-        cropYAxis?: number;
-        duplex?: boolean;
-        epsFile?: boolean;
-        evenPagesOnly?: boolean;
-        fillPage?: boolean;
-        firstPageToConvert?: number;
-        grayscaleFile?: boolean;
-        iccFile?: string;
-        jpegFile?: boolean;
-        jpegOptions?: string;
-        lastPageToConvert?: number;
-        monochromeFile?: boolean;
-        noCenter?: boolean;
-        noCrop?: boolean;
-        noShrink?: boolean;
-        oddPagesOnly?: boolean;
-        originalPageSizes?: boolean;
-        ownerPassword?: string;
-        paperHeight?: number;
-        paperSize?: ("A3" | "A4" | "legal" | "letter" | "match");
-        paperWidth?: number;
-        pdfFile?: boolean;
-        pngFile?: boolean;
-        printVersionInfo?: boolean;
-        printDocStruct?: boolean;
-        psFile?: boolean;
-        psLevel2?: boolean;
-        psLevel3?: boolean;
-        quiet?: boolean;
-        resolutionXAxis?: number;
-        resolutionXYAxis?: number;
-        resolutionYAxis?: number;
-        scalePageTo?: number;
-        scalePageToXAxis?: number;
-        scalePageToYAxis?: number;
-        singleFile?: boolean;
-        svgFile?: boolean;
-        tiffCompression?: ("deflate" | "jpeg" | "lzw" | "none" | "packbits");
-        tiffFile?: boolean;
-        transparentPageColor?: boolean;
-        userPassword?: string;
+        antialias?: "none" | "default" | "best" | "fast" | "good" | "gray" | "subpixel" | undefined;
+        cropBox?: boolean | undefined;
+        cropHeight?: number | undefined;
+        cropSize?: number | undefined;
+        cropWidth?: number | undefined;
+        cropXAxis?: number | undefined;
+        cropYAxis?: number | undefined;
+        duplex?: boolean | undefined;
+        epsFile?: boolean | undefined;
+        evenPagesOnly?: boolean | undefined;
+        fillPage?: boolean | undefined;
+        firstPageToConvert?: number | undefined;
+        grayscaleFile?: boolean | undefined;
+        iccFile?: string | undefined;
+        jpegFile?: boolean | undefined;
+        jpegOptions?: string | undefined;
+        lastPageToConvert?: number | undefined;
+        monochromeFile?: boolean | undefined;
+        noCenter?: boolean | undefined;
+        noCrop?: boolean | undefined;
+        noShrink?: boolean | undefined;
+        oddPagesOnly?: boolean | undefined;
+        originalPageSizes?: boolean | undefined;
+        ownerPassword?: string | undefined;
+        paperHeight?: number | undefined;
+        paperSize?: "match" | "A3" | "A4" | "legal" | "letter" | undefined;
+        paperWidth?: number | undefined;
+        pdfFile?: boolean | undefined;
+        pngFile?: boolean | undefined;
+        printVersionInfo?: boolean | undefined;
+        printDocStruct?: boolean | undefined;
+        psFile?: boolean | undefined;
+        psLevel2?: boolean | undefined;
+        psLevel3?: boolean | undefined;
+        quiet?: boolean | undefined;
+        resolutionXAxis?: number | undefined;
+        resolutionXYAxis?: number | undefined;
+        resolutionYAxis?: number | undefined;
+        scalePageTo?: number | undefined;
+        scalePageToXAxis?: number | undefined;
+        scalePageToYAxis?: number | undefined;
+        singleFile?: boolean | undefined;
+        svgFile?: boolean | undefined;
+        tiffCompression?: "none" | "deflate" | "jpeg" | "lzw" | "packbits" | undefined;
+        tiffFile?: boolean | undefined;
+        transparentPageColor?: boolean | undefined;
+        userPassword?: string | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
      * @description Converts a PDF file to HTML.
-     * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+     * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
      * @param {string} [outputFile] - Filepath of the file to output the results to.
      * If `undefined` then Poppler will use the directory and name of the original file
      * and create a new file, with `-html` appended to the end of the filename.
@@ -393,37 +416,37 @@ export class Poppler {
      * @param {number} [options.zoom] - Zoom the PDF document (default 1.5).
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
-    pdfToHtml(file: Buffer | string, outputFile?: string, options?: {
-        complexOutput?: boolean;
-        dataUrls?: boolean;
-        exchangePdfLinks?: boolean;
-        extractHidden?: boolean;
-        firstPageToConvert?: number;
-        fontFullName?: boolean;
-        ignoreImages?: boolean;
-        imageFormat?: ("JPG" | "PNG");
-        lastPageToConvert?: number;
-        noDrm?: boolean;
-        noFrames?: boolean;
-        noMergeParagraph?: boolean;
-        noRoundedCoordinates?: boolean;
-        outputEncoding?: string;
-        ownerPassword?: string;
-        printVersionInfo?: boolean;
-        quiet?: boolean;
-        singlePage?: boolean;
-        stdout?: boolean;
-        userPassword?: string;
-        wordBreakThreshold?: number;
-        xmlOutput?: boolean;
-        zoom?: number;
+    pdfToHtml(file: (Buffer | string), outputFile?: string, options?: {
+        complexOutput?: boolean | undefined;
+        dataUrls?: boolean | undefined;
+        exchangePdfLinks?: boolean | undefined;
+        extractHidden?: boolean | undefined;
+        firstPageToConvert?: number | undefined;
+        fontFullName?: boolean | undefined;
+        ignoreImages?: boolean | undefined;
+        imageFormat?: "JPG" | "PNG" | undefined;
+        lastPageToConvert?: number | undefined;
+        noDrm?: boolean | undefined;
+        noFrames?: boolean | undefined;
+        noMergeParagraph?: boolean | undefined;
+        noRoundedCoordinates?: boolean | undefined;
+        outputEncoding?: string | undefined;
+        ownerPassword?: string | undefined;
+        printVersionInfo?: boolean | undefined;
+        quiet?: boolean | undefined;
+        singlePage?: boolean | undefined;
+        stdout?: boolean | undefined;
+        userPassword?: string | undefined;
+        wordBreakThreshold?: number | undefined;
+        xmlOutput?: boolean | undefined;
+        zoom?: number | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
      * @description Converts a PDF file to colour image files in Portable Pixmap (PPM) format,
      * grayscale image files in Portable Graymap (PGM) format, or monochrome image files
      * in Portable Bitmap (PBM) format.
-     * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+     * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
      * @param {string} outputPath - Filepath to output the results to.
      * @param {object} [options] - Object containing options to pass to binary.
      * @param {('no'|'yes')} [options.antialiasFonts] - Enable or disable font anti-aliasing.
@@ -492,51 +515,51 @@ export class Poppler {
      * @param {string} [options.userPassword] - Specify the user password for the PDF file.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
-    pdfToPpm(file: Buffer | string, outputPath: string, options?: {
-        antialiasFonts?: ("no" | "yes");
-        antialiasVectors?: ("no" | "yes");
-        cropBox?: boolean;
-        cropHeight?: number;
-        cropSize?: number;
-        cropWidth?: number;
-        cropXAxis?: number;
-        cropYAxis?: number;
-        defaultCmykProfile?: string;
-        defaultGrayProfile?: string;
-        defaultRgbProfile?: string;
-        displayProfile?: string;
-        evenPagesOnly?: boolean;
-        firstPageToConvert?: number;
-        freetype?: ("no" | "yes");
-        forcePageNumber?: boolean;
-        grayscaleFile?: boolean;
-        hideAnnotations?: boolean;
-        jpegFile?: boolean;
-        lastPageToConvert?: number;
-        monochromeFile?: boolean;
-        oddPagesOnly?: boolean;
-        ownerPassword?: string;
-        pngFile?: boolean;
-        printProgress?: boolean;
-        printVersionInfo?: boolean;
-        quiet?: boolean;
-        resolutionXAxis?: number;
-        resolutionXYAxis?: number;
-        resolutionYAxis?: number;
-        scalePageTo?: number;
-        scalePageToXAxis?: number;
-        scalePageToYAxis?: number;
-        separator?: string;
-        singleFile?: boolean;
-        thinLineMode?: ("none" | "shape" | "solid");
-        tiffCompression?: ("deflate" | "jpeg" | "lzw" | "none" | "packbits");
-        tiffFile?: boolean;
-        userPassword?: string;
+    pdfToPpm(file: (Buffer | string), outputPath: string, options?: {
+        antialiasFonts?: "no" | "yes" | undefined;
+        antialiasVectors?: "no" | "yes" | undefined;
+        cropBox?: boolean | undefined;
+        cropHeight?: number | undefined;
+        cropSize?: number | undefined;
+        cropWidth?: number | undefined;
+        cropXAxis?: number | undefined;
+        cropYAxis?: number | undefined;
+        defaultCmykProfile?: string | undefined;
+        defaultGrayProfile?: string | undefined;
+        defaultRgbProfile?: string | undefined;
+        displayProfile?: string | undefined;
+        evenPagesOnly?: boolean | undefined;
+        firstPageToConvert?: number | undefined;
+        freetype?: "no" | "yes" | undefined;
+        forcePageNumber?: boolean | undefined;
+        grayscaleFile?: boolean | undefined;
+        hideAnnotations?: boolean | undefined;
+        jpegFile?: boolean | undefined;
+        lastPageToConvert?: number | undefined;
+        monochromeFile?: boolean | undefined;
+        oddPagesOnly?: boolean | undefined;
+        ownerPassword?: string | undefined;
+        pngFile?: boolean | undefined;
+        printProgress?: boolean | undefined;
+        printVersionInfo?: boolean | undefined;
+        quiet?: boolean | undefined;
+        resolutionXAxis?: number | undefined;
+        resolutionXYAxis?: number | undefined;
+        resolutionYAxis?: number | undefined;
+        scalePageTo?: number | undefined;
+        scalePageToXAxis?: number | undefined;
+        scalePageToYAxis?: number | undefined;
+        separator?: string | undefined;
+        singleFile?: boolean | undefined;
+        thinLineMode?: "none" | "shape" | "solid" | undefined;
+        tiffCompression?: "none" | "deflate" | "jpeg" | "lzw" | "packbits" | undefined;
+        tiffFile?: boolean | undefined;
+        userPassword?: string | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
      * @description Converts a PDF file to PostScript (PS).
-     * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+     * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
      * @param {string} [outputFile] - Filepath of the file to output the results to.
      * If `undefined` then will write output to stdout.
      * @param {object} [options] - Object containing options to pass to binary.
@@ -642,53 +665,53 @@ export class Poppler {
      * @param {string} [options.userPassword] - User password (for encrypted files).
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
-    pdfToPs(file: Buffer | string, outputFile?: string, options?: {
-        antialias?: ("no" | "yes");
-        binary?: boolean;
-        defaultCmykProfile?: string;
-        defaultGrayProfile?: string;
-        defaultRgbProfile?: string;
-        duplex?: boolean;
-        epsFile?: boolean;
-        fillPage?: boolean;
-        firstPageToConvert?: number;
-        form?: number;
-        lastPageToConvert?: number;
-        level1?: boolean;
-        level1Sep?: boolean;
-        level2?: boolean;
-        level2Sep?: boolean;
-        level3?: boolean;
-        level3Sep?: boolean;
-        noCenter?: boolean;
-        noCrop?: boolean;
-        noEmbedCIDFonts?: boolean;
-        noEmbedCIDTrueTypeFonts?: boolean;
-        noEmbedTrueTypeFonts?: boolean;
-        noEmbedType1Fonts?: boolean;
-        noShrink?: boolean;
-        opi?: boolean;
-        optimizecolorspace?: boolean;
-        originalPageSizes?: boolean;
-        overprint?: boolean;
-        ownerPassword?: string;
-        paperHeight?: number;
-        paperSize?: ("A3" | "A4" | "legal" | "letter" | "match");
-        paperWidth?: number;
-        passfonts?: boolean;
-        preload?: boolean;
-        printVersionInfo?: boolean;
-        processColorFormat?: ("CMYK8" | "MONO8" | "RGB8");
-        processColorProfile?: string;
-        quiet?: boolean;
-        rasterize?: ("always" | "never" | "whenneeded");
-        resolutionXYAxis?: number;
-        userPassword?: string;
+    pdfToPs(file: (Buffer | string), outputFile?: string, options?: {
+        antialias?: "no" | "yes" | undefined;
+        binary?: boolean | undefined;
+        defaultCmykProfile?: string | undefined;
+        defaultGrayProfile?: string | undefined;
+        defaultRgbProfile?: string | undefined;
+        duplex?: boolean | undefined;
+        epsFile?: boolean | undefined;
+        fillPage?: boolean | undefined;
+        firstPageToConvert?: number | undefined;
+        form?: number | undefined;
+        lastPageToConvert?: number | undefined;
+        level1?: boolean | undefined;
+        level1Sep?: boolean | undefined;
+        level2?: boolean | undefined;
+        level2Sep?: boolean | undefined;
+        level3?: boolean | undefined;
+        level3Sep?: boolean | undefined;
+        noCenter?: boolean | undefined;
+        noCrop?: boolean | undefined;
+        noEmbedCIDFonts?: boolean | undefined;
+        noEmbedCIDTrueTypeFonts?: boolean | undefined;
+        noEmbedTrueTypeFonts?: boolean | undefined;
+        noEmbedType1Fonts?: boolean | undefined;
+        noShrink?: boolean | undefined;
+        opi?: boolean | undefined;
+        optimizecolorspace?: boolean | undefined;
+        originalPageSizes?: boolean | undefined;
+        overprint?: boolean | undefined;
+        ownerPassword?: string | undefined;
+        paperHeight?: number | undefined;
+        paperSize?: "match" | "A3" | "A4" | "legal" | "letter" | undefined;
+        paperWidth?: number | undefined;
+        passfonts?: boolean | undefined;
+        preload?: boolean | undefined;
+        printVersionInfo?: boolean | undefined;
+        processColorFormat?: "CMYK8" | "MONO8" | "RGB8" | undefined;
+        processColorProfile?: string | undefined;
+        quiet?: boolean | undefined;
+        rasterize?: "always" | "never" | "whenneeded" | undefined;
+        resolutionXYAxis?: number | undefined;
+        userPassword?: string | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
      * @description Converts a PDF file to TXT.
-     * @param {Buffer|string} file - PDF file as Buffer, or filepath of the PDF file to read.
+     * @param {(Buffer|string)} file - PDF file as Buffer, or filepath of the PDF file to read.
      * @param {string} [outputFile] - Filepath of the file to output the results to.
      * If `undefined` then will write output to stdout.
      * @param {object} [options] - Object containing options to pass to binary.
@@ -733,30 +756,30 @@ export class Poppler {
      * @param {string} [options.userPassword] - User password (for encrypted files).
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
-    pdfToText(file: Buffer | string, outputFile?: string, options?: {
-        boundingBoxXhtml?: boolean;
-        boundingBoxXhtmlLayout?: boolean;
-        cropBox?: boolean;
-        cropHeight?: number;
-        cropWidth?: number;
-        cropXAxis?: number;
-        cropYAxis?: number;
-        eolConvention?: ("dos" | "mac" | "unix");
-        firstPageToConvert?: number;
-        fixedWidthLayout?: number;
-        generateHtmlMetaFile?: boolean;
-        generateTsvFile?: boolean;
-        lastPageToConvert?: number;
-        listEncodingOptions?: boolean;
-        maintainLayout?: boolean;
-        noDiagonalText?: boolean;
-        noPageBreaks?: boolean;
-        outputEncoding?: string;
-        ownerPassword?: string;
-        printVersionInfo?: boolean;
-        quiet?: boolean;
-        rawLayout?: boolean;
-        userPassword?: string;
+    pdfToText(file: (Buffer | string), outputFile?: string, options?: {
+        boundingBoxXhtml?: boolean | undefined;
+        boundingBoxXhtmlLayout?: boolean | undefined;
+        cropBox?: boolean | undefined;
+        cropHeight?: number | undefined;
+        cropWidth?: number | undefined;
+        cropXAxis?: number | undefined;
+        cropYAxis?: number | undefined;
+        eolConvention?: "dos" | "mac" | "unix" | undefined;
+        firstPageToConvert?: number | undefined;
+        fixedWidthLayout?: number | undefined;
+        generateHtmlMetaFile?: boolean | undefined;
+        generateTsvFile?: boolean | undefined;
+        lastPageToConvert?: number | undefined;
+        listEncodingOptions?: boolean | undefined;
+        maintainLayout?: boolean | undefined;
+        noDiagonalText?: boolean | undefined;
+        noPageBreaks?: boolean | undefined;
+        outputEncoding?: string | undefined;
+        ownerPassword?: string | undefined;
+        printVersionInfo?: boolean | undefined;
+        quiet?: boolean | undefined;
+        rawLayout?: boolean | undefined;
+        userPassword?: string | undefined;
     }): Promise<string>;
     /**
      * @author Frazer Smith
@@ -770,6 +793,7 @@ export class Poppler {
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
     pdfUnite(files: string[], outputFile: string, options?: {
-        printVersionInfo?: boolean;
+        printVersionInfo?: boolean | undefined;
     }): Promise<string>;
+    #private;
 }