node-poppler 9.1.1 → 9.1.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019-present Frazer Smith
+Copyright (c) 2019-present Frazer Smith <frazer.dev@icloud.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -6,36 +6,36 @@
 [![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 utilities
 
 ## 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.
+[Poppler](https://poppler.freedesktop.org/) is a PDF rendering library that also includes a collection of utilities, 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 binaries for easier use.
 
 ## Installation
 
 Install using `npm`:
 
-```bash
+```sh
 npm i node-poppler
 ```
 
 ### Linux and macOS/Darwin support
 
 64-bit Windows binaries are provided via an optional dependency on the [`node-poppler-win32`](https://www.npmjs.com/package/node-poppler-win32) package.
-For Linux and Mac users, the `poppler-data` and `poppler-utils` binaries binary will need to be installed separately.
+For Linux and Mac users, the `poppler-data` and `poppler-utils` binaries will need to be installed separately.
 
 An example of downloading the binaries on a Debian system:
 
-```
+```sh
 sudo apt-get install poppler-data poppler-utils
 ```
 
 For macOS users, the binaries can be installed with [Homebrew](https://brew.sh/):
 
-```
+```sh
 brew install poppler
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "node-poppler",
-	"version": "9.1.1",
-	"description": "Asynchronous Node.js wrapper for the Poppler PDF rendering library",
+	"version": "9.1.2",
+	"description": "Asynchronous Node.js wrapper for the Poppler PDF rendering utilities",
 	"keywords": [
 		"async",
 		"attach",

package/src/index.js

@@ -34,7 +34,7 @@ const PDF_INFO_PATH_REG = /(.+)pdfinfo/u;
  * @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).
+ * @property {string} [maxVersion] The maximum version of the binary that supports this option.
  */
 
 /**
@@ -489,6 +489,8 @@ const PDF_INFO_PATH_REG = /(.+)pdfinfo/u;
  * @property {boolean} [printVersionInfo] Print copyright and version information.
  */
 
+/** @typedef {(PdfAttachOptions|PdfDetachOptions|PdfFontsOptions|PdfImagesOptions|PdfInfoOptions|PdfSeparateOptions|PdfToCairoOptions|PdfToHtmlOptions|PdfToPpmOptions|PdfToPsOptions|PdfToTextOptions|PdfUniteOptions)} PopplerOptions */
+
 /**
  * @typedef {object} PopplerExtraOptions
  * @property {AbortSignal} [signal] An `AbortSignal` that can be used to cancel the operation.
@@ -576,12 +578,13 @@ function execBinary(binary, args, file, options = {}) {
 
 /**
  * @author Frazer Smith
- * @description Checks each option provided is valid, of the correct type, and can be used by specified
- * version of binary.
+ * @description Checks each option provided is valid, of the correct type, and can be used by the
+ * specified version of the binary.
+ * @ignore
  * @ignore
  * @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.
+ * @param {PopplerOptions} options - Object containing options to pass to the binary.
+ * @param {string} [version] - Semantic version of the binary.
  * @returns {string[]} Array of CLI arguments.
  * @throws {Error} If invalid arguments provided.
  */
@@ -601,27 +604,34 @@ function parseOptions(acceptedOptions, options, version) {
 			continue;
 		}
 
-		// @ts-ignore: Keys are from options, TS cannot infer this
+		// @ts-expect-error: Keys are from options, TS cannot infer this
 		const option = options[key];
 		const acceptedOption = acceptedOptions[key];
+		const optionType = typeof option;
 
-		if (acceptedOption.type === typeof option) {
-			// Skip boolean options if false
-			if (acceptedOption.type !== "boolean" || option) {
-				// Arg will be empty for some non-standard options
-				if (acceptedOption.arg !== "") {
-					args.push(acceptedOption.arg);
-				}
+		if (optionType === "undefined") {
+			continue;
+		}
 
-				if (typeof option !== "boolean") {
-					args.push(option);
-				}
+		if (acceptedOption.type === optionType) {
+			// Boolean options set to false won't be passed to the binary; skip arg and version checks
+			if (acceptedOption.type === "boolean" && !option) {
+				continue;
+			}
+
+			// Arg will be empty for some non-standard options
+			if (acceptedOption.arg !== "") {
+				args.push(acceptedOption.arg);
+			}
+
+			if (optionType !== "boolean") {
+				args.push(option);
 			}
 		} else {
 			invalidArgs.push(
 				`Invalid value type provided for option '${key}', expected ${
 					acceptedOption.type
-				} but received ${typeof option}`
+				} but received ${optionType}`
 			);
 		}
 
@@ -661,11 +671,11 @@ class Poppler {
 	#acceptedOptions = new Map();
 
 	/**
-	 * @param {string} [binPath] - Path of poppler-utils binaries.
+	 * @param {string} [binPath] - Path to the directory containing the poppler-utils binaries.
 	 * If not provided, the constructor will attempt to find the Poppler `pdfinfo` binary
 	 * in the PATH environment variable and use that as the path for all binaries.
 	 * For `win32` the binaries are bundled with the package and will be used
-	 * if a local installation is not found.
+	 * if local binaries cannot be found.
 	 * @throws {Error} If the Poppler binaries cannot be found.
 	 */
 	constructor(binPath) {
@@ -676,6 +686,7 @@ class Poppler {
 			/** @type {string|undefined} */
 			this.#popplerPath = binPath;
 		} else {
+			// Use regex over dirname as `where` on Windows returns a newline-delimited list
 			const which = spawnSync(platform === "win32" ? "where" : "which", [
 				"pdfinfo",
 			]).stdout.toString();
@@ -698,7 +709,7 @@ class Poppler {
 
 		if (!this.#popplerPath) {
 			throw new Error(
-				`Unable to find ${platform} Poppler binaries, please pass the installation directory as a parameter to the Poppler instance.`
+				`Unable to find ${platform} Poppler binaries, please pass the path to the binaries' directory as an argument to the Poppler constructor.`
 			);
 		}
 		this.#popplerPath = normalize(this.#popplerPath);
@@ -719,7 +730,7 @@ class Poppler {
 
 	/**
 	 * @description Returns the path of the Poppler binaries.
-	 * @returns {string} Path of Poppler binaries.
+	 * @returns {string} Path of the Poppler binaries' directory.
 	 */
 	get path() {
 		return this.#popplerPath;
@@ -734,7 +745,7 @@ class Poppler {
 	async #getVersion(binary) {
 		if (!this.#binVersions.has(binary)) {
 			const { stderr } = await execFileAsync(binary, ["-v"]);
-			// @ts-ignore: parseOptions checks if falsy
+			// @ts-expect-error: parseOptions checks if falsy
 			const version = POPPLER_VERSION_REG.exec(stderr)[1];
 			this.#binVersions.set(binary, version);
 		}
@@ -1230,7 +1241,7 @@ class Poppler {
 	 * @param {string} file - Filepath of the PDF file to read.
 	 * @param {string} fileToAttach - Filepath of the attachment to be embedded into the PDF file.
 	 * @param {string} outputFile - Filepath of the file to output the results to.
-	 * @param {PdfAttachOptions} [options] - Options to pass to pdfattach binary.
+	 * @param {PdfAttachOptions} [options] - Options to pass to the pdfattach binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1247,7 +1258,7 @@ class Poppler {
 	 * @author Frazer Smith
 	 * @description Lists or extracts embedded files (attachments) from a PDF file.
 	 * @param {string} file - Filepath of the PDF file to read.
-	 * @param {PdfDetachOptions} [options] - Options to pass to pdfdetach binary.
+	 * @param {PdfDetachOptions} [options] - Options to pass to the pdfdetach binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1267,7 +1278,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 {PdfFontsOptions} [options] - Options to pass to pdffonts binary.
+	 * @param {PdfFontsOptions} [options] - Options to pass to the pdffonts binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1286,7 +1297,7 @@ class Poppler {
 	 * @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 {string} [outputPrefix] - Filename prefix of output files.
-	 * @param {PdfImagesOptions} [options] - Options to pass to pdfimages binary.
+	 * @param {PdfImagesOptions} [options] - Options to pass to the pdfimages binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1309,7 +1320,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 {PdfInfoOptions} [options] - Options to pass to pdfinfo binary.
+	 * @param {PdfInfoOptions} [options] - Options to pass to the pdfinfo binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<Record<string, string>|string>} A promise that resolves with a stdout string or JSON object if
 	 * `options.printAsJson` is `true`, or rejects with an `Error` object.
@@ -1413,7 +1424,7 @@ class Poppler {
 	 * @param {string} outputPattern - Should contain %d (or any variant respecting printf format),
 	 * since %d is replaced by the page number.
 	 * As an example, `sample-%d.pdf` will produce `sample-1.pdf` for a single page document.
-	 * @param {PdfSeparateOptions} [options] - Options to pass to pdfseparate binary.
+	 * @param {PdfSeparateOptions} [options] - Options to pass to the pdfseparate binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1438,7 +1449,7 @@ class Poppler {
 	 * Encoding is set to `binary` if used with `options.singleFile` or `options.pdfFile`.
 	 *
 	 * If not set then the output filename will be derived from the PDF file name.
-	 * @param {PdfToCairoOptions} [options] - Options to pass to pdftocairo binary.
+	 * @param {PdfToCairoOptions} [options] - Options to pass to the pdftocairo binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1468,7 +1479,7 @@ class Poppler {
 	 * and create a new file, with `-html` appended to the end of the filename.
 	 *
 	 * Required if `file` is a Buffer.
-	 * @param {PdfToHtmlOptions} [options] - Options to pass to pdftohtml binary.
+	 * @param {PdfToHtmlOptions} [options] - Options to pass to the pdftohtml binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1496,7 +1507,7 @@ class Poppler {
 	 * in Portable Bitmap (PBM) format.
 	 * @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 {PdfToPpmOptions} [options] - Options to pass to pdftoppm binary.
+	 * @param {PdfToPpmOptions} [options] - Options to pass to the pdftoppm binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1516,7 +1527,7 @@ class Poppler {
 	 * @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 {PdfToPsOptions} [options] - Options to pass to pdftops binary.
+	 * @param {PdfToPsOptions} [options] - Options to pass to the pdftops binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1536,7 +1547,7 @@ class Poppler {
 	 * @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 {PdfToTextOptions} [options] - Options to pass to pdftotext binary.
+	 * @param {PdfToTextOptions} [options] - Options to pass to the pdftotext binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */
@@ -1560,7 +1571,7 @@ class Poppler {
 	 * @param {string[]} files - Filepaths of the PDF files to merge.
 	 * An entire directory of PDF files can be merged like so: `path/to/directory/*.pdf`.
 	 * @param {string} outputFile - Filepath of the file to output the resulting merged PDF to.
-	 * @param {PdfUniteOptions} [options] - Options to pass to pdfunite binary.
+	 * @param {PdfUniteOptions} [options] - Options to pass to the pdfunite binary.
 	 * @param {PopplerExtraOptions} [extras] - Extra options.
 	 * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
 	 */

package/types/index.d.ts

@@ -13,7 +13,7 @@ export type OptionDetails = {
      */
     minVersion?: string | undefined;
     /**
-     * The maximum version of the binary that supports this option (optional).
+     * The maximum version of the binary that supports this option.
      */
     maxVersion?: string | undefined;
 };
@@ -1114,6 +1114,7 @@ export type PdfUniteOptions = {
      */
     printVersionInfo?: boolean | undefined;
 };
+export type PopplerOptions = (PdfAttachOptions | PdfDetachOptions | PdfFontsOptions | PdfImagesOptions | PdfInfoOptions | PdfSeparateOptions | PdfToCairoOptions | PdfToHtmlOptions | PdfToPpmOptions | PdfToPsOptions | PdfToTextOptions | PdfUniteOptions);
 export type PopplerExtraOptions = {
     /**
      * An `AbortSignal` that can be used to cancel the operation.
@@ -1122,17 +1123,17 @@ export type PopplerExtraOptions = {
 };
 export class Poppler {
     /**
-     * @param {string} [binPath] - Path of poppler-utils binaries.
+     * @param {string} [binPath] - Path to the directory containing the poppler-utils binaries.
      * If not provided, the constructor will attempt to find the Poppler `pdfinfo` binary
      * in the PATH environment variable and use that as the path for all binaries.
      * For `win32` the binaries are bundled with the package and will be used
-     * if a local installation is not found.
+     * if local binaries cannot be found.
      * @throws {Error} If the Poppler binaries cannot be found.
      */
     constructor(binPath?: string);
     /**
      * @description Returns the path of the Poppler binaries.
-     * @returns {string} Path of Poppler binaries.
+     * @returns {string} Path of the Poppler binaries' directory.
      */
     get path(): string;
     /**
@@ -1141,7 +1142,7 @@ export class Poppler {
      * @param {string} file - Filepath of the PDF file to read.
      * @param {string} fileToAttach - Filepath of the attachment to be embedded into the PDF file.
      * @param {string} outputFile - Filepath of the file to output the results to.
-     * @param {PdfAttachOptions} [options] - Options to pass to pdfattach binary.
+     * @param {PdfAttachOptions} [options] - Options to pass to the pdfattach binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1150,7 +1151,7 @@ export class Poppler {
      * @author Frazer Smith
      * @description Lists or extracts embedded files (attachments) from a PDF file.
      * @param {string} file - Filepath of the PDF file to read.
-     * @param {PdfDetachOptions} [options] - Options to pass to pdfdetach binary.
+     * @param {PdfDetachOptions} [options] - Options to pass to the pdfdetach binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1159,7 +1160,7 @@ export 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 {PdfFontsOptions} [options] - Options to pass to pdffonts binary.
+     * @param {PdfFontsOptions} [options] - Options to pass to the pdffonts binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1169,7 +1170,7 @@ export class Poppler {
      * @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 {string} [outputPrefix] - Filename prefix of output files.
-     * @param {PdfImagesOptions} [options] - Options to pass to pdfimages binary.
+     * @param {PdfImagesOptions} [options] - Options to pass to the pdfimages binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1178,7 +1179,7 @@ export 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 {PdfInfoOptions} [options] - Options to pass to pdfinfo binary.
+     * @param {PdfInfoOptions} [options] - Options to pass to the pdfinfo binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<Record<string, string>|string>} A promise that resolves with a stdout string or JSON object if
      * `options.printAsJson` is `true`, or rejects with an `Error` object.
@@ -1193,7 +1194,7 @@ export class Poppler {
      * @param {string} outputPattern - Should contain %d (or any variant respecting printf format),
      * since %d is replaced by the page number.
      * As an example, `sample-%d.pdf` will produce `sample-1.pdf` for a single page document.
-     * @param {PdfSeparateOptions} [options] - Options to pass to pdfseparate binary.
+     * @param {PdfSeparateOptions} [options] - Options to pass to the pdfseparate binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1209,7 +1210,7 @@ export class Poppler {
      * Encoding is set to `binary` if used with `options.singleFile` or `options.pdfFile`.
      *
      * If not set then the output filename will be derived from the PDF file name.
-     * @param {PdfToCairoOptions} [options] - Options to pass to pdftocairo binary.
+     * @param {PdfToCairoOptions} [options] - Options to pass to the pdftocairo binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1223,7 +1224,7 @@ export class Poppler {
      * and create a new file, with `-html` appended to the end of the filename.
      *
      * Required if `file` is a Buffer.
-     * @param {PdfToHtmlOptions} [options] - Options to pass to pdftohtml binary.
+     * @param {PdfToHtmlOptions} [options] - Options to pass to the pdftohtml binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1235,7 +1236,7 @@ export class Poppler {
      * in Portable Bitmap (PBM) format.
      * @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 {PdfToPpmOptions} [options] - Options to pass to pdftoppm binary.
+     * @param {PdfToPpmOptions} [options] - Options to pass to the pdftoppm binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1246,7 +1247,7 @@ export class Poppler {
      * @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 {PdfToPsOptions} [options] - Options to pass to pdftops binary.
+     * @param {PdfToPsOptions} [options] - Options to pass to the pdftops binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1257,7 +1258,7 @@ export class Poppler {
      * @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 {PdfToTextOptions} [options] - Options to pass to pdftotext binary.
+     * @param {PdfToTextOptions} [options] - Options to pass to the pdftotext binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */
@@ -1269,7 +1270,7 @@ export class Poppler {
      * @param {string[]} files - Filepaths of the PDF files to merge.
      * An entire directory of PDF files can be merged like so: `path/to/directory/*.pdf`.
      * @param {string} outputFile - Filepath of the file to output the resulting merged PDF to.
-     * @param {PdfUniteOptions} [options] - Options to pass to pdfunite binary.
+     * @param {PdfUniteOptions} [options] - Options to pass to the pdfunite binary.
      * @param {PopplerExtraOptions} [extras] - Extra options.
      * @returns {Promise<string>} A promise that resolves with a stdout string, or rejects with an `Error` object.
      */