chromiumly 2.2.0 → 2.4.0

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,250 @@ 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 as file", () => {
+      it("should append header", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        await ConverterUtils.customize(data, {
+          header: "path/to/header.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith(
+          "files",
+          "path/to/header.html",
+          "header.html"
+        );
+      });
+    });
+
+    describe("when header parameter is passed as buffer", () => {
+      it("should append header", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        await ConverterUtils.customize(data, {
+          header: Buffer.from("header"),
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith(
+          "files",
+          Buffer.from("header"),
+          "header.html"
+        );
+      });
+    });
+
+    describe("when footer parameter is passed as file", () => {
+      it("should append footer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        await ConverterUtils.customize(data, {
+          footer: "path/to/footer.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith(
+          "files",
+          "path/to/footer.html",
+          "footer.html"
+        );
+      });
+    });
+
+    describe("when footer parameter is passed as buffer", () => {
+      it("should append footer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        await ConverterUtils.customize(data, {
+          footer: Buffer.from("footer"),
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+        expect(data.append).toHaveBeenCalledWith(
+          "files",
+          Buffer.from("footer"),
+          "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,
+          "files",
+          "path/to/header.html",
+          "header.html"
+        );
+        expect(data.append).toHaveBeenNthCalledWith(
+          4,
+          "files",
+          "path/to/footer.html",
+          "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/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

@@ -47,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).toHaveBeenCalledTimes(5);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(6);
       });
     });
   });

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>;
-}