chromiumly 2.10.0 → 3.0.0

package/README.md

@@ -8,7 +8,7 @@
 [![downloads](https://img.shields.io/npm/dt/chromiumly.svg?color=brightgreen&style=flat-square)](https://npm-stat.com/charts.html?package=chromiumly)
 ![licence](https://img.shields.io/github/license/cherfia/chromiumly?style=flat-square)
 
-A lightweight Typescript library that interacts with [Gotenberg](https://gotenberg.dev/)'s different modules to convert
+A lightweight Typescript library that interacts with [Gotenberg](https://gotenberg.dev/)'s different routes to convert
 a variety of document formats to PDF files.
 
 # Table of Contents
@@ -21,6 +21,7 @@ a variety of document formats to PDF files.
    - [dotenv](#dotenv)
    - [config](#config)
 3. [Modules](#modules)
+
    - [Chromium](#chromium)
      - [URL](#url)
      - [HTML](#html)
@@ -28,12 +29,14 @@ a variety of document formats to PDF files.
    - [Customization](#customization)
      - [Conversion](#conversion)
      - [Screenshot](#screenshot)
-   - [PDF Engine](#pdf-engine)
+   - [LibreOffice](#libreoffice)
+   - [PDFEngines](#pdfengines)
      - [convert](#convert)
+     - [merge](#merge)
      - [readMetadata](#readmetadata)
      - [writeMetadata](#writemetadata)
-     - [merge](#merge)
      - [generate](#generate)
+
 4. [Snippet](#snippet)
 
 ## Install
@@ -245,44 +248,59 @@ type ScreenshotOptions = {
 };
 ```
 
-### PDF Engine
-
-The `PDFEngine` combines the functionality of
-Gotenberg's [PDF Engines](https://gotenberg.dev/docs/routes#convert-into-pdfa--pdfua-route)
-and [LibreOffice](https://gotenberg.dev/docs/routes#convert-with-libreoffice) modules to manipulate different file formats.
+### LibreOffice
 
-#### convert
-
-This method interacts with [LibreOffice](https://gotenberg.dev/docs/routes#convert-with-libreoffice) module to convert different
-documents to PDF files. You can find the file extensions
+The `LibreOffice` class comes with a single method `convert`. This method interacts with [LibreOffice](https://gotenberg.dev/docs/routes#convert-with-libreoffice) route to convert different documents to PDF files. You can find the file extensions
 accepted [here](https://gotenberg.dev/docs/routes#convert-with-libreoffice#route).
 
 ```typescript
-import { PDFEngine } from "chromiumly";
+import { LibreOffice } from "chromiumly";
 
-const buffer = await PDFEngine.convert({
+const buffer = await LibreOffice.convert({
   files: ["path/to/file.docx", "path/to/file.png"],
 });
 ```
 
-Similarly to Chromium's module `convert` method, this method takes the following optional parameters :
+Similarly to Chromium's route `convert` method, this method takes the following optional parameters :
 
 - `properties`: changes how the PDF generated file will look like.
-- `pdfFormat`: PDF format of the conversion resulting file (i.e. `PDF/A-1a`, `PDF/A-2b`, `PDF/A-3b`).
-- `merge`: merge all the resulting files from the conversion into an individual PDF file.
+- `pdfa`: PDF format of the conversion resulting file (i.e. `PDF/A-1a`, `PDF/A-2b`, `PDF/A-3b`).
+- `pdfUA`: enables PDF for Universal Access for optimal accessibility.
+- `merge`: merges all the resulting files from the conversion into an individual PDF file.
+- `metadata`: writes metadata to the generated PDF file.
+
+### PDFEngines
+
+The `PDFEngines` class interacts with Gotenberg's [PDF Engines](https://gotenberg.dev/docs/routes#convert-into-pdfa--pdfua-route) routes to manupilate PDF files.
+
+#### convert
+
+This method interacts with [PDF Engines](https://gotenberg.dev/docs/routes#convert-into-pdfa--pdfua-route) convertion route to transform PDF files into the requested PDF/A format and/or PDF/UA.
+
+```typescript
+import { PDFEngines } from "chromiumly";
+
+const buffer = await PDFEngines.convert({
+  files: ["path/to/file_1.pdf", "path/to/file_2.pdf"],
+  pdfa: PdfFormat.A_2b,
+  pdfUA: true,
+});
+```
 
 #### merge
 
-This method interacts with [PDF Engines](https://gotenberg.dev/docs/routes#merge-pdfs-route) module which gathers different
+This method interacts with [PDF Engines](https://gotenberg.dev/docs/routes#merge-pdfs-route) merge route which gathers different
 engines that can manipulate and merge PDF files such
 as: [PDFtk](https://gitlab.com/pdftk-java/pdftk), [PDFcpu](https://github.com/pdfcpu/pdfcpu), [QPDF](https://github.com/qpdf/qpdf),
 and [UNO](https://github.com/unoconv/unoconv).
 
 ```typescript
-import { PDFEngine } from "chromiumly";
+import { PDFEngines } from "chromiumly";
 
-const buffer = await PDFEngine.merge({
-  files: ["path/to/file.docx", "path/to/file.png"],
+const buffer = await PDFEngines.merge({
+  files: ["path/to/file_1.pdf", "path/to/file_2.pdf"],
+  pdfa: PdfFormat.A_2b,
+  pdfUA: true,
 });
 ```
 
@@ -291,9 +309,9 @@ const buffer = await PDFEngine.merge({
 This method reads metadata from the provided PDF files.
 
 ```typescript
-import { PDFEngine } from "chromiumly";
+import { PDFEngines } from "chromiumly";
 
-const metadataBuffer = await PDFEngine.readMetadata([
+const metadataBuffer = await PDFEngines.readMetadata([
   "path/to/file_1.pdf",
   "path/to/file_2.pdf",
 ]);
@@ -304,9 +322,9 @@ const metadataBuffer = await PDFEngine.readMetadata([
 This method writes metadata to the provided PDF files.
 
 ```typescript
-import { PDFEngine } from "chromiumly";
+import { PDFEngines } from "chromiumly";
 
-const buffer = await PDFEngine.writeMetadata({
+const buffer = await PDFEngines.writeMetadata({
   files: [
   "path/to/file_1.pdf",
   "path/to/file_2.pdf",
@@ -333,7 +351,7 @@ Please note that all the PDF files can be found `__generated__` folder in the ro
 The following is a short snippet of how to use the library.
 
 ```typescript
-import { PDFEngine, UrlConverter } from "chromiumly";
+import { PDFEngines, UrlConverter } from "chromiumly";
 
 async function run() {
   const urlConverter = new UrlConverter();
@@ -341,7 +359,7 @@ async function run() {
     url: "https://gotenberg.dev/",
   });
 
-  await PDFEngine.generate("gotenberg.pdf", buffer);
+  await PDFEngines.generate("gotenberg.pdf", buffer);
 }
 
 run();

package/dist/libre-office/index.d.ts

@@ -1,2 +1 @@
-export { PageProperties } from './interfaces/libre-office.types';
-export { LibreOfficeUtils } from './utils/libre-office.utils';
+export { LibreOffice } from './libre-office';

package/dist/libre-office/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LibreOfficeUtils = void 0;
-var libre_office_utils_1 = require("./utils/libre-office.utils");
-Object.defineProperty(exports, "LibreOfficeUtils", { enumerable: true, get: function () { return libre_office_utils_1.LibreOfficeUtils; } });
+exports.LibreOffice = void 0;
+var libre_office_1 = require("./libre-office");
+Object.defineProperty(exports, "LibreOffice", { enumerable: true, get: function () { return libre_office_1.LibreOffice; } });
 //# sourceMappingURL=index.js.map

package/dist/libre-office/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/libre-office/index.ts"],"names":[],"mappings":";;;AACA,iEAA8D;AAArD,sHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/libre-office/index.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAApC,2GAAA,WAAW,OAAA"}

package/dist/libre-office/interfaces/libre-office.types.d.ts

@@ -1,3 +1,4 @@
+import { Metadata, PdfFormat } from '../../common';
 export type PageProperties = {
     landscape?: boolean;
     nativePageRanges?: {
@@ -6,3 +7,10 @@ export type PageProperties = {
     };
     exportFormFields?: boolean;
 };
+export type ConversionOptions = {
+    properties?: PageProperties;
+    merge?: boolean;
+    pdfa?: PdfFormat;
+    pdfUA?: boolean;
+    metadata?: Metadata;
+};

package/dist/libre-office/libre-office.d.ts

@@ -0,0 +1,27 @@
+/// <reference types="node" />
+import { PathLikeOrReadStream, PdfFormat, Metadata } from '../common';
+import { PageProperties } from './interfaces/libre-office.types';
+/**
+ * Class representing a LibreOffice for various operations such as merging and conversion.
+ */
+export declare class LibreOffice {
+    /**
+     * Converts various document formats to PDF.
+     *
+     * @param {Object} options - Options for the conversion operation.
+     * @param {PathLikeOrReadStream[]} options.files - An array of PathLikes or ReadStreams to the files to be converted to PDF.
+     * @param {PageProperties} [options.properties] - Page properties for the conversion.
+     * @param {pdfa} [options.pdfFormat] - PDF format options.
+     * @param {boolean} [options.pdfUA] - Indicates whether to generate PDF/UA compliant output.
+     * @param {boolean} [options.merge] - Indicates whether to merge the resulting PDFs.
+     * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
+     */
+    static convert({ files, properties, pdfa, pdfUA, merge, metadata }: {
+        files: PathLikeOrReadStream[];
+        properties?: PageProperties;
+        pdfa?: PdfFormat;
+        pdfUA?: boolean;
+        merge?: boolean;
+        metadata?: Metadata;
+    }): Promise<Buffer>;
+}

package/dist/libre-office/libre-office.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LibreOffice = void 0;
+const tslib_1 = require("tslib");
+const form_data_1 = tslib_1.__importDefault(require("form-data"));
+const main_config_1 = require("../main.config");
+const common_1 = require("../common");
+const libre_office_utils_1 = require("./utils/libre-office.utils");
+/**
+ * Class representing a LibreOffice for various operations such as merging and conversion.
+ */
+class LibreOffice {
+    /**
+     * Converts various document formats to PDF.
+     *
+     * @param {Object} options - Options for the conversion operation.
+     * @param {PathLikeOrReadStream[]} options.files - An array of PathLikes or ReadStreams to the files to be converted to PDF.
+     * @param {PageProperties} [options.properties] - Page properties for the conversion.
+     * @param {pdfa} [options.pdfFormat] - PDF format options.
+     * @param {boolean} [options.pdfUA] - Indicates whether to generate PDF/UA compliant output.
+     * @param {boolean} [options.merge] - Indicates whether to merge the resulting PDFs.
+     * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
+     */
+    static convert(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ files, properties, pdfa, pdfUA, merge, metadata }) {
+            const data = new form_data_1.default();
+            yield libre_office_utils_1.LibreOfficeUtils.addFiles(files, data);
+            yield libre_office_utils_1.LibreOfficeUtils.customize(data, {
+                properties,
+                merge,
+                pdfa,
+                pdfUA,
+                metadata
+            });
+            const endpoint = `${main_config_1.Chromiumly.GOTENBERG_ENDPOINT}/${main_config_1.Chromiumly.LIBRE_OFFICE_PATH}/${main_config_1.Chromiumly.LIBRE_OFFICE_ROUTES.convert}`;
+            return common_1.GotenbergUtils.fetch(endpoint, data);
+        });
+    }
+}
+exports.LibreOffice = LibreOffice;
+//# sourceMappingURL=libre-office.js.map

package/dist/libre-office/libre-office.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libre-office.js","sourceRoot":"","sources":["../../src/libre-office/libre-office.ts"],"names":[],"mappings":";;;;AAAA,kEAAiC;AAEjC,gDAA4C;AAC5C,sCAKmB;AAEnB,mEAA8D;AAE9D;;GAEG;AACH,MAAa,WAAW;IACpB;;;;;;;;;;OAUG;IACI,MAAM,CAAO,OAAO;qEAAC,EACxB,KAAK,EACL,UAAU,EACV,IAAI,EACJ,KAAK,EACL,KAAK,EACL,QAAQ,EAQX;YACG,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAE5B,MAAM,qCAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC7C,MAAM,qCAAgB,CAAC,SAAS,CAAC,IAAI,EAAE;gBACnC,UAAU;gBACV,KAAK;gBACL,IAAI;gBACJ,KAAK;gBACL,QAAQ;aACX,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,GAAG,wBAAU,CAAC,kBAAkB,IAAI,wBAAU,CAAC,iBAAiB,IAAI,wBAAU,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC;YAE9H,OAAO,uBAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;KAAA;CACJ;AA1CD,kCA0CC"}

package/dist/libre-office/utils/libre-office.utils.d.ts

@@ -1,6 +1,6 @@
 import FormData from 'form-data';
 import { PathLikeOrReadStream } from '../../common';
-import { PageProperties } from '../interfaces/libre-office.types';
+import { ConversionOptions, PageProperties } from '../interfaces/libre-office.types';
 /**
  * Utility class for handling common tasks related to LibreOffice conversions.
  */
@@ -20,4 +20,12 @@ export declare class LibreOfficeUtils {
      * @param {PageProperties} pageProperties - The page properties to be added to the FormData.
      */
     static addPageProperties(data: FormData, pageProperties: PageProperties): void;
+    /**
+     * Customizes the FormData object based on the provided conversion options.
+     *
+     * @param {FormData} data - The FormData object to be customized.
+     * @param {ConversionOptions} options - The conversion options to apply to the FormData.
+     * @returns {Promise<void>} A Promise that resolves once the customization is complete.
+     */
+    static customize(data: FormData, options: ConversionOptions): Promise<void>;
 }

package/dist/libre-office/utils/libre-office.utils.js

@@ -69,6 +69,32 @@ class LibreOfficeUtils {
             data.append('exportFormFields', String(pageProperties.exportFormFields));
         }
     }
+    /**
+     * Customizes the FormData object based on the provided conversion options.
+     *
+     * @param {FormData} data - The FormData object to be customized.
+     * @param {ConversionOptions} options - The conversion options to apply to the FormData.
+     * @returns {Promise<void>} A Promise that resolves once the customization is complete.
+     */
+    static customize(data, options) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (options.pdfa) {
+                data.append('pdfa', options.pdfa);
+            }
+            if (options.pdfUA) {
+                data.append('pdfUA', String(options.pdfUA));
+            }
+            if (options.merge) {
+                data.append('merge', String(options.merge));
+            }
+            if (options.metadata) {
+                data.append('metadata', JSON.stringify(options.metadata));
+            }
+            if (options.properties) {
+                LibreOfficeUtils.addPageProperties(data, options.properties);
+            }
+        });
+    }
 }
 exports.LibreOfficeUtils = LibreOfficeUtils;
 //# sourceMappingURL=libre-office.utils.js.map

package/dist/libre-office/utils/libre-office.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"libre-office.utils.js","sourceRoot":"","sources":["../../../src/libre-office/utils/libre-office.utils.ts"],"names":[],"mappings":";;;;AAAA,2BAAuE;AACvE,wDAAwB;AAExB,yCAAmD;AAInD,yCAAoE;AACpE,2CAAsD;AAGtD;;GAEG;AACH,MAAa,gBAAgB;IACzB;;;;;;OAMG;IACI,MAAM,CAAO,QAAQ,CACxB,KAA6B,EAC7B,IAAc;;YAEd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACzC,IAAI,IAAI,GAAG,KAAK,CAAC;gBACjB,IAAI,QAAQ,CAAC;gBAEb,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,QAAQ,GAAG,MAAM,IAAA,sBAAU,EAAC,KAAK,CAAC,CAAC;gBACvC,CAAC;qBAAM,IAAI,KAAK,YAAY,eAAU,EAAE,CAAC;oBACrC,QAAQ,GAAG,MAAM,IAAA,sBAAU,EAAC,KAAK,CAAC,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACJ,MAAM,aAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;oBAC7C,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;oBACjD,QAAQ,GAAG,EAAE,GAAG,EAAE,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpD,IAAI,GAAG,IAAA,qBAAgB,EAAC,KAAK,CAAC,CAAC;gBACnC,CAAC;gBAED,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACzD,CAAC;gBAED,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC;gBAE/B,IAAI,mCAAuB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,CAAC;gBACtD,CAAC;qBAAM,CAAC;oBACJ,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,mBAAmB,CAAC,CAAC;gBACrD,CAAC;YACL,CAAC;QACL,CAAC;KAAA;IAED;;;;;OAKG;IACI,MAAM,CAAC,iBAAiB,CAC3B,IAAc,EACd,cAA8B;QAE9B,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,cAAc,CAAC,gBAAgB,EAAE,CAAC;YAClC,uBAAc,CAAC,MAAM,CACjB,cAAc,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC;gBACpC,cAAc,CAAC,gBAAgB,CAAC,EAAE,GAAG,CAAC;gBACtC,cAAc,CAAC,gBAAgB,CAAC,EAAE;oBAC9B,cAAc,CAAC,gBAAgB,CAAC,IAAI,EAC5C,0BAA0B,CAC7B,CAAC;YAEF,IAAI,CAAC,MAAM,CACP,kBAAkB,EAClB,GAAG,cAAc,CAAC,gBAAgB,CAAC,IAAI,IAAI,cAAc,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAClF,CAAC;QACN,CAAC;QAED,IAAI,cAAc,CAAC,gBAAgB,KAAK,KAAK,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,CACP,kBAAkB,EAClB,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAC1C,CAAC;QACN,CAAC;IACL,CAAC;CACJ;AA7ED,4CA6EC"}
+{"version":3,"file":"libre-office.utils.js","sourceRoot":"","sources":["../../../src/libre-office/utils/libre-office.utils.ts"],"names":[],"mappings":"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"}

package/dist/main.d.ts

@@ -1,3 +1,4 @@
 export { PdfFormat } from './common/constants';
 export { HtmlConverter, HtmlScreenshot, MarkdownConverter, MarkdownScreenshot, UrlConverter, UrlScreenshot } from './chromium';
-export { PDFEngine } from './pdf-engines';
+export { PDFEngines } from './pdf-engines';
+export { LibreOffice } from './libre-office';

package/dist/main.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PDFEngine = exports.UrlScreenshot = exports.UrlConverter = exports.MarkdownScreenshot = exports.MarkdownConverter = exports.HtmlScreenshot = exports.HtmlConverter = exports.PdfFormat = void 0;
+exports.LibreOffice = exports.PDFEngines = exports.UrlScreenshot = exports.UrlConverter = exports.MarkdownScreenshot = exports.MarkdownConverter = exports.HtmlScreenshot = exports.HtmlConverter = exports.PdfFormat = void 0;
 var constants_1 = require("./common/constants");
 Object.defineProperty(exports, "PdfFormat", { enumerable: true, get: function () { return constants_1.PdfFormat; } });
 var chromium_1 = require("./chromium");
@@ -11,5 +11,7 @@ Object.defineProperty(exports, "MarkdownScreenshot", { enumerable: true, get: fu
 Object.defineProperty(exports, "UrlConverter", { enumerable: true, get: function () { return chromium_1.UrlConverter; } });
 Object.defineProperty(exports, "UrlScreenshot", { enumerable: true, get: function () { return chromium_1.UrlScreenshot; } });
 var pdf_engines_1 = require("./pdf-engines");
-Object.defineProperty(exports, "PDFEngine", { enumerable: true, get: function () { return pdf_engines_1.PDFEngine; } });
+Object.defineProperty(exports, "PDFEngines", { enumerable: true, get: function () { return pdf_engines_1.PDFEngines; } });
+var libre_office_1 = require("./libre-office");
+Object.defineProperty(exports, "LibreOffice", { enumerable: true, get: function () { return libre_office_1.LibreOffice; } });
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;AAAA,gDAA+C;AAAtC,sGAAA,SAAS,OAAA;AAClB,uCAOoB;AANhB,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,8GAAA,kBAAkB,OAAA;AAClB,wGAAA,YAAY,OAAA;AACZ,yGAAA,aAAa,OAAA;AAEjB,6CAA0C;AAAjC,wGAAA,SAAS,OAAA"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;AAAA,gDAA+C;AAAtC,sGAAA,SAAS,OAAA;AAClB,uCAOoB;AANhB,yGAAA,aAAa,OAAA;AACb,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,8GAAA,kBAAkB,OAAA;AAClB,wGAAA,YAAY,OAAA;AACZ,yGAAA,aAAa,OAAA;AAEjB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,+CAA6C;AAApC,2GAAA,WAAW,OAAA"}

package/dist/pdf-engines/index.d.ts

@@ -1 +1 @@
-export { PDFEngine } from './pdf.engine';
+export { PDFEngines } from './pdf-engines';

package/dist/pdf-engines/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PDFEngine = void 0;
-var pdf_engine_1 = require("./pdf.engine");
-Object.defineProperty(exports, "PDFEngine", { enumerable: true, get: function () { return pdf_engine_1.PDFEngine; } });
+exports.PDFEngines = void 0;
+var pdf_engines_1 = require("./pdf-engines");
+Object.defineProperty(exports, "PDFEngines", { enumerable: true, get: function () { return pdf_engines_1.PDFEngines; } });
 //# sourceMappingURL=index.js.map

package/dist/pdf-engines/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pdf-engines/index.ts"],"names":[],"mappings":";;;AAAA,2CAAyC;AAAhC,uGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pdf-engines/index.ts"],"names":[],"mappings":";;;AAAA,6CAA2C;AAAlC,yGAAA,UAAU,OAAA"}

package/dist/pdf-engines/interfaces/pdf-engines.types.d.ts

@@ -0,0 +1,8 @@
+import { Metadata, PdfFormat } from '../../common';
+export type ConversionOptions = {
+    pdfa?: PdfFormat;
+    pdfUA?: boolean;
+};
+export type MergeOptions = ConversionOptions & {
+    metadata?: Metadata;
+};

package/dist/pdf-engines/interfaces/pdf-engines.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pdf-engines.types.js.map

package/dist/pdf-engines/interfaces/pdf-engines.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-engines.types.js","sourceRoot":"","sources":["../../../src/pdf-engines/interfaces/pdf-engines.types.ts"],"names":[],"mappings":""}

package/dist/pdf-engines/{pdf.engine.d.ts → pdf-engines.d.ts}

@@ -1,10 +1,9 @@
 /// <reference types="node" />
 import { PathLikeOrReadStream, PdfFormat, Metadata } from '../common';
-import { PageProperties } from '../libre-office';
 /**
- * Class representing a PDF engine for various operations such as merging and conversion.
+ * Class uses PDF engines for various operations such as merging and conversion.
  */
-export declare class PDFEngine {
+export declare class PDFEngines {
     /**
      * Merges multiple PDF files into a single PDF document.
      *
@@ -12,30 +11,25 @@ export declare class PDFEngine {
      * @param {PathLikeOrReadStream[]} options.files - An array of PathLikes or ReadStreams to the PDF files to be merged.
      * @returns {Promise<Buffer>} A Promise resolving to the merged PDF content as a Buffer.
      */
-    static merge({ files }: {
+    static merge({ files, pdfa, pdfUA, metadata }: {
         files: PathLikeOrReadStream[];
+        pdfa?: PdfFormat;
+        pdfUA?: boolean;
+        metadata?: Metadata;
     }): Promise<Buffer>;
     /**
      * Converts various document formats to PDF.
      *
      * @param {Object} options - Options for the conversion operation.
      * @param {PathLikeOrReadStream[]} options.files - An array of PathLikes or ReadStreams to the files to be converted to PDF.
-     * @param {PageProperties} [options.properties] - Page properties for the conversion.
-     * @param {PdfFormat} [options.pdfFormat] - PDF format options.
+     * @param {pdfa} [options.pdfa] - PDF format options.
      * @param {boolean} [options.pdfUA] - Indicates whether to generate PDF/UA compliant output.
-     * @param {boolean} [options.merge] - Indicates whether to merge the resulting PDFs.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
-    static convert({ files, properties, pdfFormat, pdfUA, merge }: {
+    static convert({ files, pdfa, pdfUA }: {
         files: PathLikeOrReadStream[];
-        properties?: PageProperties;
-        /**
-         * @deprecated Starting from Gotenberg version 8.0.0, LibreOffice no longer provides support for pdfFormat.
-         * @see {@link https://github.com/gotenberg/gotenberg/releases/tag/v8.0.0}
-         */
-        pdfFormat?: PdfFormat;
+        pdfa?: PdfFormat;
         pdfUA?: boolean;
-        merge?: boolean;
     }): Promise<Buffer>;
     /**
      * Reads metadata from the provided files.

package/dist/pdf-engines/{pdf.engine.js → pdf-engines.js}

@@ -1,18 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PDFEngine = void 0;
+exports.PDFEngines = void 0;
 const tslib_1 = require("tslib");
 const fs_1 = require("fs");
 const path_1 = tslib_1.__importDefault(require("path"));
 const form_data_1 = tslib_1.__importDefault(require("form-data"));
 const main_config_1 = require("../main.config");
 const common_1 = require("../common");
-const libre_office_1 = require("../libre-office");
-const engine_utils_1 = require("./utils/engine.utils");
+const pdf_engines_utils_1 = require("./utils/pdf-engines.utils");
 /**
- * Class representing a PDF engine for various operations such as merging and conversion.
+ * Class uses PDF engines for various operations such as merging and conversion.
  */
-class PDFEngine {
+class PDFEngines {
     /**
      * Merges multiple PDF files into a single PDF document.
      *
@@ -21,9 +20,14 @@ class PDFEngine {
      * @returns {Promise<Buffer>} A Promise resolving to the merged PDF content as a Buffer.
      */
     static merge(_a) {
-        return tslib_1.__awaiter(this, arguments, void 0, function* ({ files }) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ files, pdfa, pdfUA, metadata }) {
             const data = new form_data_1.default();
-            yield engine_utils_1.PDFEngineUtils.addFiles(files, data);
+            yield pdf_engines_utils_1.PDFEnginesUtils.addFiles(files, data);
+            yield pdf_engines_utils_1.PDFEnginesUtils.customize(data, {
+                pdfa,
+                pdfUA,
+                metadata
+            });
             const endpoint = `${main_config_1.Chromiumly.GOTENBERG_ENDPOINT}/${main_config_1.Chromiumly.PDF_ENGINES_PATH}/${main_config_1.Chromiumly.PDF_ENGINE_ROUTES.merge}`;
             return common_1.GotenbergUtils.fetch(endpoint, data);
         });
@@ -33,28 +37,18 @@ class PDFEngine {
      *
      * @param {Object} options - Options for the conversion operation.
      * @param {PathLikeOrReadStream[]} options.files - An array of PathLikes or ReadStreams to the files to be converted to PDF.
-     * @param {PageProperties} [options.properties] - Page properties for the conversion.
-     * @param {PdfFormat} [options.pdfFormat] - PDF format options.
+     * @param {pdfa} [options.pdfa] - PDF format options.
      * @param {boolean} [options.pdfUA] - Indicates whether to generate PDF/UA compliant output.
-     * @param {boolean} [options.merge] - Indicates whether to merge the resulting PDFs.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
     static convert(_a) {
-        return tslib_1.__awaiter(this, arguments, void 0, function* ({ files, properties, pdfFormat, pdfUA, merge }) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ files, pdfa, pdfUA }) {
             const data = new form_data_1.default();
-            if (pdfFormat) {
-                data.append('pdfa', pdfFormat);
-            }
-            if (pdfUA) {
-                data.append('pdfUA', String(pdfUA));
-            }
-            if (merge) {
-                data.append('merge', String(merge));
-            }
-            if (properties) {
-                libre_office_1.LibreOfficeUtils.addPageProperties(data, properties);
-            }
-            yield libre_office_1.LibreOfficeUtils.addFiles(files, data);
+            yield pdf_engines_utils_1.PDFEnginesUtils.addFiles(files, data);
+            yield pdf_engines_utils_1.PDFEnginesUtils.customize(data, {
+                pdfa,
+                pdfUA
+            });
             const endpoint = `${main_config_1.Chromiumly.GOTENBERG_ENDPOINT}/${main_config_1.Chromiumly.LIBRE_OFFICE_PATH}/${main_config_1.Chromiumly.LIBRE_OFFICE_ROUTES.convert}`;
             return common_1.GotenbergUtils.fetch(endpoint, data);
         });
@@ -68,7 +62,7 @@ class PDFEngine {
     static readMetadata(files) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             const data = new form_data_1.default();
-            yield engine_utils_1.PDFEngineUtils.addFiles(files, data);
+            yield pdf_engines_utils_1.PDFEnginesUtils.addFiles(files, data);
             const endpoint = `${main_config_1.Chromiumly.GOTENBERG_ENDPOINT}/${main_config_1.Chromiumly.PDF_ENGINES_PATH}/${main_config_1.Chromiumly.PDF_ENGINE_ROUTES.readMetadata}`;
             return common_1.GotenbergUtils.fetch(endpoint, data);
         });
@@ -84,7 +78,7 @@ class PDFEngine {
         return tslib_1.__awaiter(this, arguments, void 0, function* ({ files, metadata }) {
             const data = new form_data_1.default();
             data.append('metadata', JSON.stringify(metadata));
-            yield engine_utils_1.PDFEngineUtils.addFiles(files, data);
+            yield pdf_engines_utils_1.PDFEnginesUtils.addFiles(files, data);
             const endpoint = `${main_config_1.Chromiumly.GOTENBERG_ENDPOINT}/${main_config_1.Chromiumly.PDF_ENGINES_PATH}/${main_config_1.Chromiumly.PDF_ENGINE_ROUTES.writeMetadata}`;
             return common_1.GotenbergUtils.fetch(endpoint, data);
         });
@@ -104,5 +98,5 @@ class PDFEngine {
         });
     }
 }
-exports.PDFEngine = PDFEngine;
-//# sourceMappingURL=pdf.engine.js.map
+exports.PDFEngines = PDFEngines;
+//# sourceMappingURL=pdf-engines.js.map

package/dist/pdf-engines/pdf-engines.js.map

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

package/dist/pdf-engines/utils/{engine.utils.d.ts → pdf-engines.utils.d.ts}

@@ -1,9 +1,10 @@
 import FormData from 'form-data';
 import { PathLikeOrReadStream } from '../../common';
+import { ConversionOptions, MergeOptions } from '../interfaces/pdf-engines.types';
 /**
  * Utility class for handling common tasks related to PDF engine operations.
  */
-export declare class PDFEngineUtils {
+export declare class PDFEnginesUtils {
     /**
      * Adds PDF files to the FormData object.
      *
@@ -12,4 +13,12 @@ export declare class PDFEngineUtils {
      * @throws {Error} Throws an error if the file extension is not supported.
      */
     static addFiles(files: PathLikeOrReadStream[], data: FormData): Promise<void>;
+    /**
+     * Customizes the FormData object based on the provided conversion options.
+     *
+     * @param {FormData} data - The FormData object to be customized.
+     * @param {ConversionOptions | MergeOptions} options - The options to apply to the FormData.
+     * @returns {Promise<void>} A Promise that resolves once the customization is complete.
+     */
+    static customize(data: FormData, options: ConversionOptions | MergeOptions): Promise<void>;
 }

package/dist/pdf-engines/utils/{engine.utils.js → pdf-engines.utils.js}

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PDFEngineUtils = void 0;
+exports.PDFEnginesUtils = void 0;
 const tslib_1 = require("tslib");
 const fs_1 = require("fs");
 const path_1 = tslib_1.__importDefault(require("path"));
 /**
  * Utility class for handling common tasks related to PDF engine operations.
  */
-class PDFEngineUtils {
+class PDFEnginesUtils {
     /**
      * Adds PDF files to the FormData object.
      *
@@ -39,6 +39,26 @@ class PDFEngineUtils {
             }
         });
     }
+    /**
+     * Customizes the FormData object based on the provided conversion options.
+     *
+     * @param {FormData} data - The FormData object to be customized.
+     * @param {ConversionOptions | MergeOptions} options - The options to apply to the FormData.
+     * @returns {Promise<void>} A Promise that resolves once the customization is complete.
+     */
+    static customize(data, options) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (options.pdfa) {
+                data.append('pdfa', options.pdfa);
+            }
+            if (options.pdfUA) {
+                data.append('pdfUA', String(options.pdfUA));
+            }
+            if ('metadata' in options && options.metadata) {
+                data.append('metadata', JSON.stringify(options.metadata));
+            }
+        });
+    }
 }
-exports.PDFEngineUtils = PDFEngineUtils;
-//# sourceMappingURL=engine.utils.js.map
+exports.PDFEnginesUtils = PDFEnginesUtils;
+//# sourceMappingURL=pdf-engines.utils.js.map

package/dist/pdf-engines/utils/pdf-engines.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-engines.utils.js","sourceRoot":"","sources":["../../../src/pdf-engines/utils/pdf-engines.utils.ts"],"names":[],"mappings":";;;;AAAA,2BAAuE;AACvE,wDAAwB;AASxB;;GAEG;AACH,MAAa,eAAe;IACxB;;;;;;OAMG;IACI,MAAM,CAAO,QAAQ,CACxB,KAA6B,EAC7B,IAAc;;YAEd,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;gBAClC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACzC,CAAC;qBAAM,IAAI,IAAI,YAAY,eAAU,EAAE,CAAC;oBACpC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACzC,CAAC;qBAAM,CAAC;oBACJ,MAAM,aAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;oBAC5C,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAChD,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;oBACzC,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;wBACvB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;oBAClD,CAAC;yBAAM,CAAC;wBACJ,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,mBAAmB,CAAC,CAAC;oBACrD,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;KAAA;IAED;;;;;;OAMG;IACI,MAAM,CAAO,SAAS,CACzB,IAAc,EACd,OAAyC;;YAEzC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,CAAC;YAED,IAAI,UAAU,IAAI,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAC5C,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC9D,CAAC;QACL,CAAC;KAAA;CACJ;AAtDD,0CAsDC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromiumly",
-  "version": "2.10.0",
+  "version": "3.0.0",
   "description": "A lightweight Typescript library that interacts with Gotenberg's different modules to convert a variety of document formats to PDF files.",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",
@@ -50,7 +50,7 @@
     "@types/dotenv": "8.2.0",
     "@types/form-data": "2.5.0",
     "@types/jest": "29.5.12",
-    "@types/node": "20.12.4",
+    "@types/node": "20.12.5",
     "@types/node-fetch": "2.6.11",
     "@typescript-eslint/eslint-plugin": "7.5.0",
     "@typescript-eslint/parser": "7.5.0",
@@ -67,7 +67,7 @@
     "ts-jest": "29.1.2",
     "ts-node": "10.9.2",
     "tslib": "2.6.2",
-    "typescript": "5.4.3"
+    "typescript": "5.4.4"
   },
   "dependencies": {
     "config": "3.3.11",

package/src/chromium/interfaces/common.types.ts

@@ -6,7 +6,7 @@ export type ChromiumOptions = {
     header?: PathLikeOrReadStream;
     footer?: PathLikeOrReadStream;
     emulatedMediaType?: EmulatedMediaType;
-    waitDelay?: string; // Duration (e.g, '5s') to wait when loading an HTML document before convertion.
+    waitDelay?: string; // Duration (e.g, '5s') to wait when loading an HTML document before conversion.
     waitForExpression?: string; // JavaScript's expression to wait before converting an HTML document into PDF until it returns true.
     extraHttpHeaders?: Record<string, string>;
     failOnHttpStatusCodes?: number[]; // Return a 409 Conflict response if the HTTP status code is in the list (default [499,599])

package/src/libre-office/index.ts

@@ -1,2 +1 @@
-export { PageProperties } from './interfaces/libre-office.types';
-export { LibreOfficeUtils } from './utils/libre-office.utils';
+export { LibreOffice } from './libre-office';

package/src/libre-office/interfaces/libre-office.types.ts

@@ -1,5 +1,15 @@
+import { Metadata, PdfFormat } from '../../common';
+
 export type PageProperties = {
     landscape?: boolean; // Set the paper orientation to landscape (default false)
     nativePageRanges?: { from: number; to: number }; // Page ranges to print
     exportFormFields?: boolean; // Set whether to export the form fields or to use the inputted/selected content of the fields (default true)
 };
+
+export type ConversionOptions = {
+    properties?: PageProperties;
+    merge?: boolean;
+    pdfa?: PdfFormat;
+    pdfUA?: boolean;
+    metadata?: Metadata;
+};

package/src/libre-office/libre-office.ts

@@ -0,0 +1,58 @@
+import FormData from 'form-data';
+
+import { Chromiumly } from '../main.config';
+import {
+    GotenbergUtils,
+    PathLikeOrReadStream,
+    PdfFormat,
+    Metadata
+} from '../common';
+import { PageProperties } from './interfaces/libre-office.types';
+import { LibreOfficeUtils } from './utils/libre-office.utils';
+
+/**
+ * Class representing a LibreOffice for various operations such as merging and conversion.
+ */
+export class LibreOffice {
+    /**
+     * Converts various document formats to PDF.
+     *
+     * @param {Object} options - Options for the conversion operation.
+     * @param {PathLikeOrReadStream[]} options.files - An array of PathLikes or ReadStreams to the files to be converted to PDF.
+     * @param {PageProperties} [options.properties] - Page properties for the conversion.
+     * @param {pdfa} [options.pdfFormat] - PDF format options.
+     * @param {boolean} [options.pdfUA] - Indicates whether to generate PDF/UA compliant output.
+     * @param {boolean} [options.merge] - Indicates whether to merge the resulting PDFs.
+     * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
+     */
+    public static async convert({
+        files,
+        properties,
+        pdfa,
+        pdfUA,
+        merge,
+        metadata
+    }: {
+        files: PathLikeOrReadStream[];
+        properties?: PageProperties;
+        pdfa?: PdfFormat;
+        pdfUA?: boolean;
+        merge?: boolean;
+        metadata?: Metadata;
+    }): Promise<Buffer> {
+        const data = new FormData();
+
+        await LibreOfficeUtils.addFiles(files, data);
+        await LibreOfficeUtils.customize(data, {
+            properties,
+            merge,
+            pdfa,
+            pdfUA,
+            metadata
+        });
+
+        const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.LIBRE_OFFICE_PATH}/${Chromiumly.LIBRE_OFFICE_ROUTES.convert}`;
+
+        return GotenbergUtils.fetch(endpoint, data);
+    }
+}

package/src/libre-office/tests/libre-office.test.ts

@@ -0,0 +1,56 @@
+import { LibreOffice } from '../libre-office';
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import { createReadStream, promises } from 'fs';
+import FormData from 'form-data';
+import fetch from 'node-fetch';
+import { PdfFormat } from '../../common';
+
+const { Response } = jest.requireActual('node-fetch');
+jest.mock('node-fetch', () => jest.fn());
+
+describe('LibreOffice', () => {
+    const mockPromisesAccess = jest.spyOn(promises, 'access');
+    const mockFetch = fetch as jest.MockedFunction<typeof fetch>;
+    const mockFormDataAppend = jest.spyOn(FormData.prototype, 'append');
+
+    beforeEach(() => {
+        (createReadStream as jest.Mock) = jest
+            .fn()
+            .mockImplementation((file) => file);
+    });
+
+    afterEach(() => {
+        jest.resetAllMocks();
+    });
+
+    describe('convert', () => {
+        describe('when no properties are passed', () => {
+            it('should return a buffer', async () => {
+                mockPromisesAccess.mockResolvedValue();
+                mockFetch.mockResolvedValue(new Response('content'));
+                const buffer = await LibreOffice.convert({
+                    files: ['path/to/file.docx', 'path/to/file.bib']
+                });
+                expect(buffer).toEqual(Buffer.from('content'));
+                expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+            });
+        });
+
+        describe('when properties are passed', () => {
+            it('should return a buffer', async () => {
+                mockPromisesAccess.mockResolvedValue();
+                mockFetch.mockResolvedValue(new Response('content'));
+                const buffer = await LibreOffice.convert({
+                    files: ['path/to/file.docx', 'path/to/file.bib'],
+                    properties: { landscape: true },
+                    pdfa: PdfFormat.A_2b,
+                    pdfUA: true,
+                    metadata: { author: 'John Doe' },
+                    merge: true
+                });
+                expect(buffer).toEqual(Buffer.from('content'));
+                expect(mockFormDataAppend).toHaveBeenCalledTimes(7);
+            });
+        });
+    });
+});

package/src/libre-office/utils/libre-office.utils.ts

@@ -7,7 +7,10 @@ import FormData from 'form-data';
 
 import { GotenbergUtils, PathLikeOrReadStream } from '../../common';
 import { LIBRE_OFFICE_EXTENSIONS } from './constants';
-import { PageProperties } from '../interfaces/libre-office.types';
+import {
+    ConversionOptions,
+    PageProperties
+} from '../interfaces/libre-office.types';
 
 /**
  * Utility class for handling common tasks related to LibreOffice conversions.
@@ -89,4 +92,36 @@ export class LibreOfficeUtils {
             );
         }
     }
+
+    /**
+     * Customizes the FormData object based on the provided conversion options.
+     *
+     * @param {FormData} data - The FormData object to be customized.
+     * @param {ConversionOptions} options - The conversion options to apply to the FormData.
+     * @returns {Promise<void>} A Promise that resolves once the customization is complete.
+     */
+    public static async customize(
+        data: FormData,
+        options: ConversionOptions
+    ): Promise<void> {
+        if (options.pdfa) {
+            data.append('pdfa', options.pdfa);
+        }
+
+        if (options.pdfUA) {
+            data.append('pdfUA', String(options.pdfUA));
+        }
+
+        if (options.merge) {
+            data.append('merge', String(options.merge));
+        }
+
+        if (options.metadata) {
+            data.append('metadata', JSON.stringify(options.metadata));
+        }
+
+        if (options.properties) {
+            LibreOfficeUtils.addPageProperties(data, options.properties);
+        }
+    }
 }

package/src/main.ts

@@ -7,4 +7,5 @@ export {
     UrlConverter,
     UrlScreenshot
 } from './chromium';
-export { PDFEngine } from './pdf-engines';
+export { PDFEngines } from './pdf-engines';
+export { LibreOffice } from './libre-office';

package/src/pdf-engines/index.ts

@@ -1 +1 @@
-export { PDFEngine } from './pdf.engine';
+export { PDFEngines } from './pdf-engines';

package/src/pdf-engines/interfaces/pdf-engines.types.ts

@@ -0,0 +1,10 @@
+import { Metadata, PdfFormat } from '../../common';
+
+export type ConversionOptions = {
+    pdfa?: PdfFormat;
+    pdfUA?: boolean;
+};
+
+export type MergeOptions = ConversionOptions & {
+    metadata?: Metadata;
+};

package/src/pdf-engines/{pdf.engine.ts → pdf-engines.ts}

@@ -10,13 +10,12 @@ import {
     PdfFormat,
     Metadata
 } from '../common';
-import { LibreOfficeUtils, PageProperties } from '../libre-office';
-import { PDFEngineUtils } from './utils/engine.utils';
+import { PDFEnginesUtils } from './utils/pdf-engines.utils';
 
 /**
- * Class representing a PDF engine for various operations such as merging and conversion.
+ * Class uses PDF engines for various operations such as merging and conversion.
  */
-export class PDFEngine {
+export class PDFEngines {
     /**
      * Merges multiple PDF files into a single PDF document.
      *
@@ -25,12 +24,23 @@ export class PDFEngine {
      * @returns {Promise<Buffer>} A Promise resolving to the merged PDF content as a Buffer.
      */
     public static async merge({
-        files
+        files,
+        pdfa,
+        pdfUA,
+        metadata
     }: {
         files: PathLikeOrReadStream[];
+        pdfa?: PdfFormat;
+        pdfUA?: boolean;
+        metadata?: Metadata;
     }): Promise<Buffer> {
         const data = new FormData();
-        await PDFEngineUtils.addFiles(files, data);
+        await PDFEnginesUtils.addFiles(files, data);
+        await PDFEnginesUtils.customize(data, {
+            pdfa,
+            pdfUA,
+            metadata
+        });
         const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.PDF_ENGINES_PATH}/${Chromiumly.PDF_ENGINE_ROUTES.merge}`;
         return GotenbergUtils.fetch(endpoint, data);
     }
@@ -40,48 +50,26 @@ export class PDFEngine {
      *
      * @param {Object} options - Options for the conversion operation.
      * @param {PathLikeOrReadStream[]} options.files - An array of PathLikes or ReadStreams to the files to be converted to PDF.
-     * @param {PageProperties} [options.properties] - Page properties for the conversion.
-     * @param {PdfFormat} [options.pdfFormat] - PDF format options.
+     * @param {pdfa} [options.pdfa] - PDF format options.
      * @param {boolean} [options.pdfUA] - Indicates whether to generate PDF/UA compliant output.
-     * @param {boolean} [options.merge] - Indicates whether to merge the resulting PDFs.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
     public static async convert({
         files,
-        properties,
-        pdfFormat,
-        pdfUA,
-        merge
+        pdfa,
+        pdfUA
     }: {
         files: PathLikeOrReadStream[];
-        properties?: PageProperties;
-        /**
-         * @deprecated Starting from Gotenberg version 8.0.0, LibreOffice no longer provides support for pdfFormat.
-         * @see {@link https://github.com/gotenberg/gotenberg/releases/tag/v8.0.0}
-         */
-        pdfFormat?: PdfFormat;
+        pdfa?: PdfFormat;
         pdfUA?: boolean;
-        merge?: boolean;
     }): Promise<Buffer> {
         const data = new FormData();
 
-        if (pdfFormat) {
-            data.append('pdfa', pdfFormat);
-        }
-
-        if (pdfUA) {
-            data.append('pdfUA', String(pdfUA));
-        }
-
-        if (merge) {
-            data.append('merge', String(merge));
-        }
-
-        if (properties) {
-            LibreOfficeUtils.addPageProperties(data, properties);
-        }
-
-        await LibreOfficeUtils.addFiles(files, data);
+        await PDFEnginesUtils.addFiles(files, data);
+        await PDFEnginesUtils.customize(data, {
+            pdfa,
+            pdfUA
+        });
 
         const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.LIBRE_OFFICE_PATH}/${Chromiumly.LIBRE_OFFICE_ROUTES.convert}`;
 
@@ -99,7 +87,7 @@ export class PDFEngine {
     ): Promise<Buffer> {
         const data = new FormData();
 
-        await PDFEngineUtils.addFiles(files, data);
+        await PDFEnginesUtils.addFiles(files, data);
 
         const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.PDF_ENGINES_PATH}/${Chromiumly.PDF_ENGINE_ROUTES.readMetadata}`;
 
@@ -123,7 +111,7 @@ export class PDFEngine {
         const data = new FormData();
         data.append('metadata', JSON.stringify(metadata));
 
-        await PDFEngineUtils.addFiles(files, data);
+        await PDFEnginesUtils.addFiles(files, data);
 
         const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.PDF_ENGINES_PATH}/${Chromiumly.PDF_ENGINE_ROUTES.writeMetadata}`;
 

package/src/pdf-engines/tests/pdf.engine.test.ts

@@ -6,12 +6,12 @@ import fetch from 'node-fetch';
 import path from 'path';
 
 import { PdfFormat } from '../../common';
-import { PDFEngine } from '../pdf.engine';
+import { PDFEngines } from '../pdf-engines';
 
 const { Response } = jest.requireActual('node-fetch');
 jest.mock('node-fetch', () => jest.fn());
 
-describe('PDFEngine', () => {
+describe('PDFEngines', () => {
     const mockPromisesAccess = jest.spyOn(promises, 'access');
     const mockFetch = fetch as jest.MockedFunction<typeof fetch>;
     const mockFormDataAppend = jest.spyOn(FormData.prototype, 'append');
@@ -31,8 +31,8 @@ describe('PDFEngine', () => {
             it('should return a buffer', async () => {
                 mockPromisesAccess.mockResolvedValue();
                 mockFetch.mockResolvedValue(new Response('content'));
-                const buffer = await PDFEngine.convert({
-                    files: ['path/to/file.docx', 'path/to/file.bib']
+                const buffer = await PDFEngines.convert({
+                    files: ['path/to/file_1.pdf', 'path/to/file_2.pdf']
                 });
                 expect(buffer).toEqual(Buffer.from('content'));
                 expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
@@ -43,15 +43,13 @@ describe('PDFEngine', () => {
             it('should return a buffer', async () => {
                 mockPromisesAccess.mockResolvedValue();
                 mockFetch.mockResolvedValue(new Response('content'));
-                const buffer = await PDFEngine.convert({
-                    files: ['path/to/file.docx', 'path/to/file.bib'],
-                    properties: { landscape: true },
-                    pdfFormat: PdfFormat.A_1a,
-                    pdfUA: true,
-                    merge: true
+                const buffer = await PDFEngines.convert({
+                    files: ['path/to/file_1.pdf', 'path/to/file_2.pdf'],
+                    pdfa: PdfFormat.A_2b,
+                    pdfUA: true
                 });
                 expect(buffer).toEqual(Buffer.from('content'));
-                expect(mockFormDataAppend).toHaveBeenCalledTimes(6);
+                expect(mockFormDataAppend).toHaveBeenCalledTimes(4);
             });
         });
     });
@@ -60,11 +58,14 @@ describe('PDFEngine', () => {
         it('should return a buffer', async () => {
             mockPromisesAccess.mockResolvedValue();
             mockFetch.mockResolvedValue(new Response('content'));
-            const buffer = await PDFEngine.merge({
-                files: ['path/to/file.pdf', 'path/to/another-file.pdf']
+            const buffer = await PDFEngines.merge({
+                files: ['path/to/file.pdf', 'path/to/another-file.pdf'],
+                pdfa: PdfFormat.A_2b,
+                pdfUA: true,
+                metadata: { Author: 'John Doe' }
             });
             expect(buffer).toEqual(Buffer.from('content'));
-            expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+            expect(mockFormDataAppend).toHaveBeenCalledTimes(5);
         });
     });
 
@@ -72,7 +73,7 @@ describe('PDFEngine', () => {
         it('should return a buffer', async () => {
             mockPromisesAccess.mockResolvedValue();
             mockFetch.mockResolvedValue(new Response('content'));
-            const buffer = await PDFEngine.readMetadata(['path/to/file.pdf']);
+            const buffer = await PDFEngines.readMetadata(['path/to/file.pdf']);
             expect(buffer).toEqual(Buffer.from('content'));
             expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
         });
@@ -82,7 +83,7 @@ describe('PDFEngine', () => {
         it('should return a buffer', async () => {
             mockPromisesAccess.mockResolvedValue();
             mockFetch.mockResolvedValue(new Response('content'));
-            const buffer = await PDFEngine.writeMetadata({
+            const buffer = await PDFEngines.writeMetadata({
                 files: ['path/to/file.pdf'],
                 metadata: {
                     Author: 'John Doe',
@@ -127,7 +128,7 @@ describe('PDFEngine', () => {
                 .spyOn(fs, 'writeFile')
                 .mockResolvedValueOnce();
 
-            await PDFEngine.generate(mockFilename, mockBuffer);
+            await PDFEngines.generate(mockFilename, mockBuffer);
 
             expect(mockPromisesMkDir).toHaveBeenCalledWith(mockGeneratedDir, {
                 recursive: true
@@ -145,7 +146,7 @@ describe('PDFEngine', () => {
             );
 
             await expect(
-                PDFEngine.generate(mockFilename, mockBuffer)
+                PDFEngines.generate(mockFilename, mockBuffer)
             ).rejects.toThrow('Cannot create directory');
         });
 
@@ -155,7 +156,7 @@ describe('PDFEngine', () => {
             );
 
             await expect(
-                PDFEngine.generate(mockFilename, mockBuffer)
+                PDFEngines.generate(mockFilename, mockBuffer)
             ).rejects.toThrow('Failed to write to file');
         });
     });

package/src/pdf-engines/utils/{engine.utils.ts → pdf-engines.utils.ts}

@@ -3,11 +3,15 @@ import path from 'path';
 
 import FormData from 'form-data';
 import { PathLikeOrReadStream } from '../../common';
+import {
+    ConversionOptions,
+    MergeOptions
+} from '../interfaces/pdf-engines.types';
 
 /**
  * Utility class for handling common tasks related to PDF engine operations.
  */
-export class PDFEngineUtils {
+export class PDFEnginesUtils {
     /**
      * Adds PDF files to the FormData object.
      *
@@ -37,4 +41,28 @@ export class PDFEngineUtils {
             }
         }
     }
+
+    /**
+     * Customizes the FormData object based on the provided conversion options.
+     *
+     * @param {FormData} data - The FormData object to be customized.
+     * @param {ConversionOptions | MergeOptions} options - The options to apply to the FormData.
+     * @returns {Promise<void>} A Promise that resolves once the customization is complete.
+     */
+    public static async customize(
+        data: FormData,
+        options: ConversionOptions | MergeOptions
+    ): Promise<void> {
+        if (options.pdfa) {
+            data.append('pdfa', options.pdfa);
+        }
+
+        if (options.pdfUA) {
+            data.append('pdfUA', String(options.pdfUA));
+        }
+
+        if ('metadata' in options && options.metadata) {
+            data.append('metadata', JSON.stringify(options.metadata));
+        }
+    }
 }

package/src/pdf-engines/utils/tests/{engine.utils.test.ts → pdf-engines.utils.test.ts}

@@ -1,10 +1,9 @@
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 import { createReadStream, promises } from 'fs';
 import FormData from 'form-data';
+import { PDFEnginesUtils } from '../pdf-engines.utils';
 
-import { PDFEngineUtils } from '../engine.utils';
-
-describe('PDFEngineUtils', () => {
+describe('PDFEnginesUtils', () => {
     const mockPromisesAccess = jest.spyOn(promises, 'access');
     const mockFormDataAppend = jest.spyOn(FormData.prototype, 'append');
     const data = new FormData();
@@ -24,7 +23,7 @@ describe('PDFEngineUtils', () => {
             describe('when files parameter contains paths', () => {
                 it('should append each file to data', async () => {
                     mockPromisesAccess.mockResolvedValue();
-                    await PDFEngineUtils.addFiles(
+                    await PDFEnginesUtils.addFiles(
                         ['path/to/file.pdf', 'path/to/another-file.pdf'],
                         data
                     );
@@ -34,7 +33,7 @@ describe('PDFEngineUtils', () => {
             describe('when files parameter contains a buffer', () => {
                 it('should append each file to data', async () => {
                     mockPromisesAccess.mockResolvedValue();
-                    await PDFEngineUtils.addFiles(
+                    await PDFEnginesUtils.addFiles(
                         [Buffer.from('data'), 'path/to/another-file.pdf'],
                         data
                     );
@@ -47,7 +46,7 @@ describe('PDFEngineUtils', () => {
             it('should throw an error', async () => {
                 mockPromisesAccess.mockResolvedValue();
                 await expect(() =>
-                    PDFEngineUtils.addFiles(
+                    PDFEnginesUtils.addFiles(
                         ['path/to/file.docx', 'path/to/file.pdf'],
                         data
                     )
@@ -61,7 +60,7 @@ describe('PDFEngineUtils', () => {
                     "ENOENT: no such file or directory, access 'path/to/index.html'";
                 mockPromisesAccess.mockRejectedValue(new Error(errorMessage));
                 await expect(() =>
-                    PDFEngineUtils.addFiles(
+                    PDFEnginesUtils.addFiles(
                         ['path/to/file.pdf', 'path/to/another-file.pdf'],
                         data
                     )

package/dist/pdf-engines/pdf.engine.js.map

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

package/dist/pdf-engines/utils/engine.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.utils.js","sourceRoot":"","sources":["../../../src/pdf-engines/utils/engine.utils.ts"],"names":[],"mappings":";;;;AAAA,2BAAuE;AACvE,wDAAwB;AAKxB;;GAEG;AACH,MAAa,cAAc;IACvB;;;;;;OAMG;IACI,MAAM,CAAO,QAAQ,CACxB,KAA6B,EAC7B,IAAc;;YAEd,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;gBAClC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACzC,CAAC;qBAAM,IAAI,IAAI,YAAY,eAAU,EAAE,CAAC;oBACpC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACzC,CAAC;qBAAM,CAAC;oBACJ,MAAM,aAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;oBAC5C,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAChD,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;oBACzC,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;wBACvB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;oBAClD,CAAC;yBAAM,CAAC;wBACJ,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,mBAAmB,CAAC,CAAC;oBACrD,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;KAAA;CACJ;AA9BD,wCA8BC"}