chromiumly 2.1.0 → 2.3.1

package/src/chromium/utils/tests/converter.utils.test.ts

@@ -1,10 +1,20 @@
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import { createReadStream, promises } from "fs";
 import FormData from "form-data";
 import { ConverterUtils } from "../converter.utils";
+import { PdfFormat } from "../../../common";
 
 describe("ConverterUtils", () => {
   const mockFormDataAppend = jest.spyOn(FormData.prototype, "append");
+  const mockPromisesAccess = jest.spyOn(promises, "access");
   const data = new FormData();
 
+  beforeEach(() => {
+    (createReadStream as jest.Mock) = jest
+      .fn()
+      .mockImplementation((file) => file);
+  });
+
   afterEach(() => {
     jest.resetAllMocks();
   });
@@ -16,7 +26,7 @@ describe("ConverterUtils", () => {
           ConverterUtils.injectPageProperties(data, {
             size: { width: 8.3, height: 11.7 },
           });
-          expect(mockFormDataAppend).toBeCalledTimes(2);
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
           expect(data.append).toHaveBeenCalledWith("paperWidth", 8.3);
           expect(data.append).toHaveBeenNthCalledWith(2, "paperHeight", 11.7);
         });
@@ -29,7 +39,7 @@ describe("ConverterUtils", () => {
           ConverterUtils.injectPageProperties(data, {
             margins: { top: 0.5, bottom: 0.5, left: 1, right: 1 },
           });
-          expect(mockFormDataAppend).toBeCalledTimes(4);
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(4);
           expect(data.append).toHaveBeenCalledWith("marginTop", 0.5);
           expect(data.append).toHaveBeenNthCalledWith(2, "marginBottom", 0.5);
           expect(data.append).toHaveBeenNthCalledWith(3, "marginLeft", 1);
@@ -44,7 +54,7 @@ describe("ConverterUtils", () => {
           ConverterUtils.injectPageProperties(data, {
             preferCssPageSize: true,
           });
-          expect(mockFormDataAppend).toBeCalledTimes(1);
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
           expect(data.append).toHaveBeenCalledWith("preferCssPageSize", "true");
         });
       });
@@ -56,10 +66,20 @@ describe("ConverterUtils", () => {
           ConverterUtils.injectPageProperties(data, {
             printBackground: true,
           });
-          expect(mockFormDataAppend).toBeCalledTimes(1);
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
           expect(data.append).toHaveBeenCalledWith("printBackground", "true");
         });
       });
+
+      describe("when omitBackground parameter is set", () => {
+        it("should append omitBackground to data", () => {
+          ConverterUtils.injectPageProperties(data, {
+            omitBackground: true,
+          });
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+          expect(data.append).toHaveBeenCalledWith("omitBackground", "true");
+        });
+      });
     });
 
     describe("Page landscape", () => {
@@ -68,7 +88,7 @@ describe("ConverterUtils", () => {
           ConverterUtils.injectPageProperties(data, {
             landscape: true,
           });
-          expect(mockFormDataAppend).toBeCalledTimes(1);
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
           expect(data.append).toHaveBeenCalledWith("landscape", "true");
         });
       });
@@ -80,7 +100,7 @@ describe("ConverterUtils", () => {
           ConverterUtils.injectPageProperties(data, {
             scale: 1.5,
           });
-          expect(mockFormDataAppend).toBeCalledTimes(1);
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
           expect(data.append).toHaveBeenCalledWith("scale", 1.5);
         });
       });
@@ -92,10 +112,216 @@ describe("ConverterUtils", () => {
           ConverterUtils.injectPageProperties(data, {
             nativePageRanges: { from: 1, to: 6 },
           });
-          expect(mockFormDataAppend).toBeCalledTimes(1);
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
           expect(data.append).toHaveBeenCalledWith("nativePageRanges", "1-6");
         });
       });
     });
   });
+
+  describe("customize", () => {
+    describe("when no option is passed", () => {
+      it("should not append anything", async () => {
+        await ConverterUtils.customize(data, {});
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(0);
+      });
+    });
+
+    describe("when header parameter is passed", () => {
+      it("should append header", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        await ConverterUtils.customize(data, {
+          header: "path/to/header.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith(
+          "header.html",
+          "path/to/header.html"
+        );
+      });
+    });
+
+    describe("when footer parameter is passed", () => {
+      it("should append footer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        await ConverterUtils.customize(data, {
+          footer: "path/to/footer.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith(
+          "footer.html",
+          "path/to/footer.html"
+        );
+      });
+    });
+
+    describe("when pdf format parameter is passed", () => {
+      it("should append pdf format", async () => {
+        await ConverterUtils.customize(data, {
+          pdfFormat: PdfFormat.A_1a,
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith("pdfa", "PDF/A-1a");
+      });
+    });
+
+    describe("when pdf universal access parameter is passed", () => {
+      it("should append pdfua format", async () => {
+        await ConverterUtils.customize(data, {
+          pdfUA: true,
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith("pdfua", "true");
+      });
+    });
+
+    describe("when page properties parameter is passed", () => {
+      it("should append page propertiers", async () => {
+        await ConverterUtils.customize(data, {
+          properties: { size: { width: 8.3, height: 11.7 } },
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+        expect(data.append).toHaveBeenCalledWith("paperWidth", 8.3);
+        expect(data.append).toHaveBeenNthCalledWith(2, "paperHeight", 11.7);
+      });
+    });
+
+    describe("when emulatedMediaType parameter is passed", () => {
+      it("should append emulatedMediaType", async () => {
+        await ConverterUtils.customize(data, {
+          emulatedMediaType: "screen",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith("emulatedMediaType", "screen");
+      });
+    });
+
+    describe("when waitDelay parameter is passed", () => {
+      it("should append waitDelay", async () => {
+        await ConverterUtils.customize(data, {
+          waitDelay: "5s",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith("waitDelay", "5s");
+      });
+    });
+
+    describe("when waitForExpression parameter is passed", () => {
+      it("should append waitForExpression", async () => {
+        await ConverterUtils.customize(data, {
+          waitForExpression: "document.readyState === 'complete'",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith(
+          "waitForExpression",
+          "document.readyState === 'complete'"
+        );
+      });
+    });
+
+    describe("when userAgent parameter is passed", () => {
+      it("should append userAgent", async () => {
+        const userAgent =
+          "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36";
+
+        await ConverterUtils.customize(data, {
+          userAgent,
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith("userAgent", userAgent);
+      });
+    });
+
+    describe("when extraHttpHeaders parameter is passed", () => {
+      it("should append extraHttpHeaders", async () => {
+        const extraHttpHeaders = {
+          "X-Custom-Header": "value",
+        };
+
+        await ConverterUtils.customize(data, {
+          extraHttpHeaders,
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith(
+          "extraHttpHeaders",
+          JSON.stringify(extraHttpHeaders)
+        );
+      });
+    });
+
+    describe("when failOnConsoleExceptions parameter is passed", () => {
+      it("should append failOnConsoleExceptions", async () => {
+        await ConverterUtils.customize(data, {
+          failOnConsoleExceptions: true,
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith(
+          "failOnConsoleExceptions",
+          "true"
+        );
+      });
+    });
+
+    describe("when all options are passed", () => {
+      it("should append all options", async () => {
+        mockPromisesAccess.mockResolvedValue();
+
+        await ConverterUtils.customize(data, {
+          header: "path/to/header.html",
+          footer: "path/to/footer.html",
+          pdfFormat: PdfFormat.A_1a,
+          pdfUA: true,
+          emulatedMediaType: "screen",
+          properties: { size: { width: 8.3, height: 11.7 } },
+          waitDelay: "5s",
+          waitForExpression: "document.readyState === 'complete'",
+          userAgent:
+            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36",
+          extraHttpHeaders: { "X-Custom-Header": "value" },
+          failOnConsoleExceptions: true,
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(12);
+        expect(data.append).toHaveBeenNthCalledWith(1, "pdfa", "PDF/A-1a");
+        expect(data.append).toHaveBeenNthCalledWith(2, "pdfua", "true");
+        expect(data.append).toHaveBeenNthCalledWith(
+          3,
+          "header.html",
+          "path/to/header.html"
+        );
+        expect(data.append).toHaveBeenNthCalledWith(
+          4,
+          "footer.html",
+          "path/to/footer.html"
+        );
+        expect(data.append).toHaveBeenNthCalledWith(
+          5,
+          "emulatedMediaType",
+          "screen"
+        );
+        expect(data.append).toHaveBeenNthCalledWith(6, "paperWidth", 8.3);
+        expect(data.append).toHaveBeenNthCalledWith(7, "paperHeight", 11.7);
+        expect(data.append).toHaveBeenNthCalledWith(8, "waitDelay", "5s");
+        expect(data.append).toHaveBeenNthCalledWith(
+          9,
+          "waitForExpression",
+          "document.readyState === 'complete'"
+        );
+        expect(data.append).toHaveBeenNthCalledWith(
+          10,
+          "userAgent",
+          "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36"
+        );
+        expect(data.append).toHaveBeenNthCalledWith(
+          11,
+          "extraHttpHeaders",
+          JSON.stringify({ "X-Custom-Header": "value" })
+        );
+        expect(data.append).toHaveBeenNthCalledWith(
+          12,
+          "failOnConsoleExceptions",
+          "true"
+        );
+      });
+    });
+  });
 });

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

@@ -10,17 +10,13 @@ import { PageProperties } from "../interfaces/libre-office.types";
 export class LibreOfficeUtils {
   public static async injectFiles(files: PathLike[], data: FormData) {
     for (const file of files) {
-      try {
-        await promises.access(file, constants.R_OK);
-        const filename = path.basename(file.toString());
-        const extension = path.extname(filename);
-        if (LIBRE_OFFICE_EXTENSIONS.includes(extension)) {
-          data.append(filename, createReadStream(file));
-        } else {
-          throw new Error(`${extension} is not supported`);
-        }
-      } catch (error) {
-        throw error;
+      await promises.access(file, constants.R_OK);
+      const filename = path.basename(file.toString());
+      const extension = path.extname(filename);
+      if (LIBRE_OFFICE_EXTENSIONS.includes(extension)) {
+        data.append(filename, createReadStream(file));
+      } else {
+        throw new Error(`${extension} is not supported`);
       }
     }
   }

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

@@ -1,5 +1,6 @@
-import { LibreOfficeUtils } from "../libre-office.utils";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 import { promises, createReadStream } from "fs";
+import { LibreOfficeUtils } from "../libre-office.utils";
 
 import FormData from "form-data";
 
@@ -26,7 +27,7 @@ describe("LibreOfficeUtils", () => {
           ["path/to/file.docx", "path/to/file.bib"],
           data
         );
-        expect(mockFormDataAppend).toBeCalledTimes(2);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
       });
     });
 
@@ -64,7 +65,7 @@ describe("LibreOfficeUtils", () => {
           LibreOfficeUtils.injectPageProperties(data, {
             landscape: true,
           });
-          expect(mockFormDataAppend).toBeCalledTimes(1);
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
           expect(data.append).toHaveBeenCalledWith("landscape", "true");
         });
       });
@@ -76,7 +77,7 @@ describe("LibreOfficeUtils", () => {
           LibreOfficeUtils.injectPageProperties(data, {
             nativePageRanges: { from: 1, to: 6 },
           });
-          expect(mockFormDataAppend).toBeCalledTimes(1);
+          expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
           expect(data.append).toHaveBeenCalledWith("nativePageRanges", "1-6");
         });
       });

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

@@ -20,25 +20,37 @@ export class PDFEngine {
     files,
     properties,
     pdfFormat,
+    pdfUA,
     merge,
   }: {
     files: PathLike[];
     properties?: PageProperties;
     pdfFormat?: PdfFormat;
+    pdfUA?: boolean;
     merge?: boolean;
   }): Promise<Buffer> {
     const data = new FormData();
+
     if (pdfFormat) {
-      data.append("pdfFormat", pdfFormat);
+      data.append("pdfa", pdfFormat);
+    }
+
+    if (pdfUA) {
+      data.append("pdfUA", String(pdfUA));
     }
+
     if (merge) {
       data.append("merge", String(merge));
     }
+
     if (properties) {
       LibreOfficeUtils.injectPageProperties(data, properties);
     }
+
     await LibreOfficeUtils.injectFiles(files, data);
+
     const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.LIBRE_OFFICE_PATH}/${Chromiumly.LIBRE_OFFICE_ROUTES.convert}`;
+
     return GotenbergUtils.fetch(endpoint, data);
   }
 

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

@@ -1,21 +1,18 @@
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import { createReadStream, promises } from "fs";
+import FormData from "form-data";
+import fs from "fs/promises";
+import fetch from "node-fetch";
 import path from "path";
 
-import { PDFEngine } from "./../pdf.engine";
 import { PdfFormat } from "../../common";
-
-import { promises, createReadStream } from "fs";
-
-import fetch from "node-fetch";
-import FormData from "form-data";
+import { PDFEngine } from "../pdf.engine";
 
 const { Response } = jest.requireActual("node-fetch");
 jest.mock("node-fetch", () => jest.fn());
 
 describe("PDFEngine", () => {
-  const mockProcessCwd = jest.spyOn(process, "cwd");
   const mockPromisesAccess = jest.spyOn(promises, "access");
-  const mockPromisesMkDir = jest.spyOn(promises, "mkdir");
-  const mockPromisesWriteFile = jest.spyOn(promises, "writeFile");
   const mockFetch = fetch as jest.MockedFunction<typeof fetch>;
   const mockFormDataAppend = jest.spyOn(FormData.prototype, "append");
 
@@ -38,7 +35,7 @@ describe("PDFEngine", () => {
           files: ["path/to/file.docx", "path/to/file.bib"],
         });
         expect(buffer).toEqual(Buffer.from("content"));
-        expect(mockFormDataAppend).toBeCalledTimes(2);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
       });
     });
 
@@ -50,10 +47,11 @@ describe("PDFEngine", () => {
           files: ["path/to/file.docx", "path/to/file.bib"],
           properties: { landscape: true },
           pdfFormat: PdfFormat.A_1a,
+          pdfUA: true,
           merge: true,
         });
         expect(buffer).toEqual(Buffer.from("content"));
-        expect(mockFormDataAppend).toBeCalledTimes(5);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(6);
       });
     });
   });
@@ -66,19 +64,60 @@ describe("PDFEngine", () => {
         files: ["path/to/file.pdf", "path/to/another-file.pdf"],
       });
       expect(buffer).toEqual(Buffer.from("content"));
-      expect(mockFormDataAppend).toBeCalledTimes(2);
+      expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
     });
   });
 
   describe("generate", () => {
+    const mockFilename = "test.pdf";
+    const mockBuffer = Buffer.from("mock pdf content");
+
+    afterAll(() => {
+      jest.restoreAllMocks();
+    });
+
     it("should generate a PDF file", async () => {
-      mockProcessCwd.mockReturnValue("path/to/");
-      mockPromisesMkDir.mockResolvedValue("__generated__");
-      await PDFEngine.generate("file.pdf", Buffer.from("content"));
-      expect(mockPromisesWriteFile).toBeCalledWith(
-        path.resolve("path/to/__generated__/file.pdf"),
-        Buffer.from("content")
+      const mockGeneratedDir = path.join(process.cwd(), "__generated__");
+      const mockGeneratedFilePath = path.join(mockGeneratedDir, mockFilename);
+
+      const mockPromisesMkDir = jest
+        .spyOn(fs, "mkdir")
+        .mockResolvedValueOnce(mockGeneratedDir);
+
+      const mockPromisesWriteFile = jest
+        .spyOn(fs, "writeFile")
+        .mockResolvedValueOnce();
+
+      await PDFEngine.generate(mockFilename, mockBuffer);
+
+      expect(mockPromisesMkDir).toHaveBeenCalledWith(mockGeneratedDir, {
+        recursive: true,
+      });
+
+      expect(mockPromisesWriteFile).toHaveBeenCalledWith(
+        mockGeneratedFilePath,
+        mockBuffer
       );
     });
+
+    it("should handle errors during file generation", async () => {
+      jest
+        .spyOn(fs, "mkdir")
+        .mockRejectedValueOnce(new Error("Cannot create directory"));
+
+      await expect(
+        PDFEngine.generate(mockFilename, mockBuffer)
+      ).rejects.toThrow("Cannot create directory");
+    });
+
+    it("should handle errors during file writing", async () => {
+      jest
+        .spyOn(fs, "writeFile")
+        .mockRejectedValueOnce(new Error("Failed to write to file"));
+
+      await expect(
+        PDFEngine.generate(mockFilename, mockBuffer)
+      ).rejects.toThrow("Failed to write to file");
+    });
   });
 });

package/src/pdf-engines/utils/engine.utils.ts

@@ -6,17 +6,13 @@ import FormData from "form-data";
 export class PDFEngineUtils {
   public static async injectFiles(files: PathLike[], data: FormData) {
     for (const file of files) {
-      try {
-        await promises.access(file, constants.R_OK);
-        const filename = path.basename(file.toString());
-        const extension = path.extname(filename);
-        if (extension === ".pdf") {
-          data.append(filename, createReadStream(file));
-        } else {
-          throw new Error(`${extension} is not supported`);
-        }
-      } catch (error) {
-        throw error;
+      await promises.access(file, constants.R_OK);
+      const filename = path.basename(file.toString());
+      const extension = path.extname(filename);
+      if (extension === ".pdf") {
+        data.append(filename, createReadStream(file));
+      } else {
+        throw new Error(`${extension} is not supported`);
       }
     }
   }

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

@@ -1,8 +1,9 @@
-import { PDFEngineUtils } from "./../engine.utils";
-import { promises, createReadStream } from "fs";
-
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import { createReadStream, promises } from "fs";
 import FormData from "form-data";
 
+import { PDFEngineUtils } from "./../engine.utils";
+
 describe("PDFEngineUtils", () => {
   const mockPromisesAccess = jest.spyOn(promises, "access");
   const mockFormDataAppend = jest.spyOn(FormData.prototype, "append");
@@ -26,7 +27,7 @@ describe("PDFEngineUtils", () => {
           ["path/to/file.pdf", "path/to/another-file.pdf"],
           data
         );
-        expect(mockFormDataAppend).toBeCalledTimes(2);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
       });
     });
 

package/dist/chromium/interfaces/converter.interface.d.ts

@@ -1,10 +0,0 @@
-/// <reference types="node" />
-/// <reference types="node" />
-import { PathLike } from "fs";
-import { PdfFormat } from "../../common";
-import { PageProperties } from "./converter.types";
-export interface IConverter {
-    convert({ ...args }: {
-        [x: string]: string | PathLike | PageProperties | PdfFormat;
-    }): Promise<Buffer>;
-}

package/dist/chromium/interfaces/converter.interface.js

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

package/dist/chromium/interfaces/converter.interface.js.map

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

package/src/chromium/interfaces/converter.interface.ts

@@ -1,12 +0,0 @@
-import { PathLike } from "fs";
-
-import { PdfFormat } from "../../common";
-import { PageProperties } from "./converter.types";
-
-export interface IConverter {
-  convert({
-    ...args
-  }: {
-    [x: string]: string | PathLike | PageProperties | PdfFormat;
-  }): Promise<Buffer>;
-}