node-poppler 7.0.1 → 7.1.0

package/README.md

@@ -1,10 +1,10 @@
 # node-poppler
 
-[![GitHub Release](https://img.shields.io/github/release/Fdawgs/node-poppler.svg)](https://github.com/Fdawgs/node-poppler/releases/latest/)
+[![GitHub release](https://img.shields.io/github/release/Fdawgs/node-poppler.svg)](https://github.com/Fdawgs/node-poppler/releases/latest/)
 [![npm version](https://img.shields.io/npm/v/node-poppler)](https://npmjs.com/package/node-poppler)
-![Build Status](https://github.com/Fdawgs/node-poppler/workflows/CI/badge.svg?branch=main)
-[![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)
+[![Build status](https://github.com/Fdawgs/node-poppler/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Fdawgs/node-poppler/actions/workflows/ci.yml)
+[![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
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "node-poppler",
-	"version": "7.0.1",
+	"version": "7.1.0",
 	"description": "Asynchronous node.js wrapper for the Poppler PDF rendering library",
 	"keywords": [
 		"async",

package/src/index.js

@@ -18,6 +18,10 @@ const errorMessages = {
 	3221226505: "Internal process error",
 };
 
+// Cache immutable regex as they are expensive to create and garbage collect
+const popplerVersionRegex = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u;
+const pdfInfoFileSizesRegex = /(File\s+size:\s+)0(\s+)bytes/u;
+
 /**
  * @author Frazer Smith
  * @description Checks each option provided is valid, of the correct type, and can be used by specified
@@ -36,7 +40,7 @@ function parseOptions(acceptedOptions, options, version) {
 	const invalidArgs = [];
 	Object.keys(options).forEach((key) => {
 		if (Object.hasOwn(acceptedOptions, key)) {
-			// eslint-disable-next-line valid-typeof
+			// eslint-disable-next-line valid-typeof -- `type` is a string
 			if (typeof options[key] === acceptedOptions[key].type) {
 				// Skip boolean options if false
 
@@ -90,7 +94,7 @@ class Poppler {
 				__dirname,
 				"lib",
 				"win32",
-				"poppler-23.07.0",
+				"poppler-23.11.0",
 				"Library",
 				"bin"
 			);
@@ -222,7 +226,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 
@@ -327,7 +331,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 
@@ -451,7 +455,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 
@@ -496,7 +500,7 @@ class Poppler {
 					if (stdOut !== "") {
 						if (fileSize) {
 							stdOut = stdOut.replace(
-								/(File\s+size:\s+)0(\s+)bytes/u,
+								pdfInfoFileSizesRegex,
 								`$1${fileSize}$2bytes`
 							);
 						}
@@ -570,7 +574,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 			args.push(file);
@@ -661,6 +665,8 @@ class Poppler {
 	 * @param {boolean} [options.pdfFile] - Generate PDF file.
 	 * @param {boolean} [options.pngFile] - Generate PNG file(s).
 	 * @param {boolean} [options.printVersionInfo] - Print copyright and version information.
+	 * @param {boolean} [options.printDocStruct] - If the input file contains structural information
+	 * about the document's content, write this information to the output file (PDF only).
 	 * @param {boolean} [options.psFile] - Generate PS file.
 	 * @param {boolean} [options.psLevel2] - Generate Level 2 PostScript (PS only).
 	 * @param {boolean} [options.psLevel3] - Generate Level 3 PostScript (PS only). This enables all
@@ -722,6 +728,11 @@ class Poppler {
 			paperWidth: { arg: "-paperw", type: "number" },
 			pdfFile: { arg: "-pdf", type: "boolean" },
 			pngFile: { arg: "-png", type: "boolean" },
+			printDocStruct: {
+				arg: "-struct",
+				type: "boolean",
+				minVersion: "23.11.0",
+			},
 			printVersionInfo: { arg: "-v", type: "boolean" },
 			psFile: { arg: "-ps", type: "boolean" },
 			psLevel2: { arg: "-level2", type: "boolean" },
@@ -748,7 +759,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 
@@ -896,7 +907,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 
@@ -1101,7 +1112,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 
@@ -1339,7 +1350,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 
@@ -1496,7 +1507,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 
@@ -1582,7 +1593,7 @@ class Poppler {
 			);
 
 			// @ts-ignore: parseOptions checks if falsy
-			const versionInfo = /(\d{1,2}\.\d{1,2}\.\d{1,2})/u.exec(stderr)[1];
+			const versionInfo = popplerVersionRegex.exec(stderr)[1];
 
 			const args = parseOptions(acceptedOptions, options, versionInfo);
 			files.forEach((element) => {

package/types/index.d.ts

@@ -289,6 +289,8 @@ export class Poppler {
 	 * @param {boolean} [options.pdfFile] - Generate PDF file.
 	 * @param {boolean} [options.pngFile] - Generate PNG file(s).
 	 * @param {boolean} [options.printVersionInfo] - Print copyright and version information.
+	 * @param {boolean} [options.printDocStruct] - If the input file contains structural information
+	 * about the document's content, write this information to the output file (PDF only).
 	 * @param {boolean} [options.psFile] - Generate PS file.
 	 * @param {boolean} [options.psLevel2] - Generate Level 2 PostScript (PS only).
 	 * @param {boolean} [options.psLevel3] - Generate Level 3 PostScript (PS only). This enables all
@@ -360,6 +362,7 @@ export class Poppler {
 			pdfFile?: boolean;
 			pngFile?: boolean;
 			printVersionInfo?: boolean;
+			printDocStruct?: boolean;
 			psFile?: boolean;
 			psLevel2?: boolean;
 			psLevel3?: boolean;