chromiumly 2.0.8 → 2.2.0

package/dist/chromium/converters/html.converter.d.ts

@@ -3,13 +3,16 @@
 import { PathLike } from "fs";
 import { PdfFormat } from "../../common";
 import { IConverter } from "../interfaces/converter.interface";
-import { PageProperties } from "../interfaces/converter.types";
+import { EmulatedMediaType, PageProperties } from "../interfaces/converter.types";
 import { Converter } from "./converter";
 export declare class HtmlConverter extends Converter implements IConverter {
     constructor();
-    convert({ html, properties, pdfFormat, }: {
+    convert({ html, header, footer, properties, pdfFormat, emulatedMediaType, }: {
         html: PathLike;
+        header?: PathLike;
+        footer?: PathLike;
         properties?: PageProperties;
         pdfFormat?: PdfFormat;
+        emulatedMediaType?: EmulatedMediaType;
     }): Promise<Buffer>;
 }

package/dist/chromium/converters/html.converter.js

@@ -12,23 +12,29 @@ class HtmlConverter extends converter_1.Converter {
     constructor() {
         super(main_config_1.ChromiumRoute.HTML);
     }
-    convert({ html, properties, pdfFormat, }) {
+    convert({ html, header, footer, properties, pdfFormat, emulatedMediaType, }) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                yield fs_1.promises.access(html, fs_1.constants.R_OK);
-                const data = new form_data_1.default();
-                if (pdfFormat) {
-                    data.append("pdfFormat", pdfFormat);
-                }
-                data.append("index.html", (0, fs_1.createReadStream)(html));
-                if (properties) {
-                    converter_utils_1.ConverterUtils.injectPageProperties(data, properties);
-                }
-                return common_1.GotenbergUtils.fetch(this.endpoint, data);
+            yield fs_1.promises.access(html, fs_1.constants.R_OK);
+            const data = new form_data_1.default();
+            if (pdfFormat) {
+                data.append("pdfFormat", pdfFormat);
             }
-            catch (error) {
-                throw error;
+            data.append("index.html", (0, fs_1.createReadStream)(html));
+            if (header) {
+                yield fs_1.promises.access(header, fs_1.constants.R_OK);
+                data.append("header.html", (0, fs_1.createReadStream)(header));
             }
+            if (footer) {
+                yield fs_1.promises.access(footer, fs_1.constants.R_OK);
+                data.append("footer.html", (0, fs_1.createReadStream)(footer));
+            }
+            if (emulatedMediaType) {
+                data.append("emulatedMediaType", emulatedMediaType);
+            }
+            if (properties) {
+                converter_utils_1.ConverterUtils.injectPageProperties(data, properties);
+            }
+            return common_1.GotenbergUtils.fetch(this.endpoint, data);
         });
     }
 }

package/dist/chromium/converters/html.converter.js.map

@@ -1 +1 @@
-{"version":3,"file":"html.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/html.converter.ts"],"names":[],"mappings":";;;;AAAA,2BAAqE;AAErE,kEAAiC;AAEjC,yCAAyD;AAGzD,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAElD,MAAa,aAAc,SAAQ,qBAAS;IAC1C;QACE,KAAK,CAAC,2BAAa,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEK,OAAO,CAAC,EACZ,IAAI,EACJ,UAAU,EACV,SAAS,GAKV;;YACC,IAAI;gBACF,MAAM,aAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;gBAC5B,IAAI,SAAS,EAAE;oBACb,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;iBACrC;gBACD,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;gBAClD,IAAI,UAAU,EAAE;oBACd,gCAAc,CAAC,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;iBACvD;gBACD,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;aAClD;YAAC,OAAO,KAAK,EAAE;gBACd,MAAM,KAAK,CAAC;aACb;QACH,CAAC;KAAA;CACF;AA7BD,sCA6BC"}
+{"version":3,"file":"html.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/html.converter.ts"],"names":[],"mappings":";;;;AAAA,2BAAqE;AAErE,kEAAiC;AAEjC,yCAAyD;AAMzD,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAElD,MAAa,aAAc,SAAQ,qBAAS;IAC1C;QACE,KAAK,CAAC,2BAAa,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEK,OAAO,CAAC,EACZ,IAAI,EACJ,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,GAQlB;;YACC,MAAM,aAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAE5B,IAAI,SAAS,EAAE;gBACb,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;aACrC;YAED,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;YAElD,IAAI,MAAM,EAAE;gBACV,MAAM,aAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAA,qBAAgB,EAAC,MAAM,CAAC,CAAC,CAAC;aACtD;YAED,IAAI,MAAM,EAAE;gBACV,MAAM,aAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAA,qBAAgB,EAAC,MAAM,CAAC,CAAC,CAAC;aACtD;YAED,IAAI,iBAAiB,EAAE;gBACrB,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;aACrD;YAED,IAAI,UAAU,EAAE;gBACd,gCAAc,CAAC,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;aACvD;YAED,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;KAAA;CACF;AAjDD,sCAiDC"}

package/dist/chromium/converters/markdown.converter.d.ts

@@ -3,14 +3,17 @@
 import { PathLike } from "fs";
 import { PdfFormat } from "../../common";
 import { IConverter } from "../interfaces/converter.interface";
-import { PageProperties } from "../interfaces/converter.types";
+import { EmulatedMediaType, PageProperties } from "../interfaces/converter.types";
 import { Converter } from "./converter";
 export declare class MarkdownConverter extends Converter implements IConverter {
     constructor();
-    convert({ html, markdown, properties, pdfFormat, }: {
+    convert({ html, markdown, header, footer, properties, pdfFormat, emulatedMediaType, }: {
         html: PathLike;
         markdown: PathLike;
+        header?: PathLike;
+        footer?: PathLike;
         properties?: PageProperties;
         pdfFormat?: PdfFormat;
+        emulatedMediaType?: EmulatedMediaType;
     }): Promise<Buffer>;
 }

package/dist/chromium/converters/markdown.converter.js

@@ -12,25 +12,31 @@ class MarkdownConverter extends converter_1.Converter {
     constructor() {
         super(main_config_1.ChromiumRoute.MARKDOWN);
     }
-    convert({ html, markdown, properties, pdfFormat, }) {
+    convert({ html, markdown, header, footer, properties, pdfFormat, emulatedMediaType, }) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                yield fs_1.promises.access(html, fs_1.constants.R_OK);
-                yield fs_1.promises.access(markdown, fs_1.constants.R_OK);
-                const data = new form_data_1.default();
-                if (pdfFormat) {
-                    data.append("pdfFormat", pdfFormat);
-                }
-                data.append("index.html", (0, fs_1.createReadStream)(html));
-                data.append("file.md", (0, fs_1.createReadStream)(markdown));
-                if (properties) {
-                    converter_utils_1.ConverterUtils.injectPageProperties(data, properties);
-                }
-                return common_1.GotenbergUtils.fetch(this.endpoint, data);
+            yield fs_1.promises.access(html, fs_1.constants.R_OK);
+            yield fs_1.promises.access(markdown, fs_1.constants.R_OK);
+            const data = new form_data_1.default();
+            if (pdfFormat) {
+                data.append("pdfFormat", pdfFormat);
             }
-            catch (error) {
-                throw error;
+            data.append("index.html", (0, fs_1.createReadStream)(html));
+            data.append("file.md", (0, fs_1.createReadStream)(markdown));
+            if (header) {
+                yield fs_1.promises.access(header, fs_1.constants.R_OK);
+                data.append("header.html", (0, fs_1.createReadStream)(header));
             }
+            if (footer) {
+                yield fs_1.promises.access(footer, fs_1.constants.R_OK);
+                data.append("footer.html", (0, fs_1.createReadStream)(footer));
+            }
+            if (emulatedMediaType) {
+                data.append("emulatedMediaType", emulatedMediaType);
+            }
+            if (properties) {
+                converter_utils_1.ConverterUtils.injectPageProperties(data, properties);
+            }
+            return common_1.GotenbergUtils.fetch(this.endpoint, data);
         });
     }
 }

package/dist/chromium/converters/markdown.converter.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/markdown.converter.ts"],"names":[],"mappings":";;;;AAAA,2BAAqE;AAErE,kEAAiC;AAEjC,yCAAyD;AAGzD,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAElD,MAAa,iBAAkB,SAAQ,qBAAS;IAC9C;QACE,KAAK,CAAC,2BAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAEK,OAAO,CAAC,EACZ,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,SAAS,GAMV;;YACC,IAAI;gBACF,MAAM,aAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,aAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAChD,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;gBAC5B,IAAI,SAAS,EAAE;oBACb,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;iBACrC;gBACD,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;gBAClD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAA,qBAAgB,EAAC,QAAQ,CAAC,CAAC,CAAC;gBACnD,IAAI,UAAU,EAAE;oBACd,gCAAc,CAAC,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;iBACvD;gBACD,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;aAClD;YAAC,OAAO,KAAK,EAAE;gBACd,MAAM,KAAK,CAAC;aACb;QACH,CAAC;KAAA;CACF;AAjCD,8CAiCC"}
+{"version":3,"file":"markdown.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/markdown.converter.ts"],"names":[],"mappings":";;;;AAAA,2BAAqE;AAErE,kEAAiC;AAEjC,yCAAyD;AAMzD,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAElD,MAAa,iBAAkB,SAAQ,qBAAS;IAC9C;QACE,KAAK,CAAC,2BAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAEK,OAAO,CAAC,EACZ,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,GASlB;;YACC,MAAM,aAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,aAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAC5B,IAAI,SAAS,EAAE;gBACb,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;aACrC;YACD,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAA,qBAAgB,EAAC,QAAQ,CAAC,CAAC,CAAC;YAEnD,IAAI,MAAM,EAAE;gBACV,MAAM,aAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAA,qBAAgB,EAAC,MAAM,CAAC,CAAC,CAAC;aACtD;YAED,IAAI,MAAM,EAAE;gBACV,MAAM,aAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAA,qBAAgB,EAAC,MAAM,CAAC,CAAC,CAAC;aACtD;YAED,IAAI,iBAAiB,EAAE;gBACrB,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;aACrD;YAED,IAAI,UAAU,EAAE;gBACd,gCAAc,CAAC,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;aACvD;YAED,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;KAAA;CACF;AAnDD,8CAmDC"}

package/dist/chromium/converters/url.converter.d.ts

@@ -1,13 +1,18 @@
 /// <reference types="node" />
+/// <reference types="node" />
+import { PathLike } from "fs";
 import { PdfFormat } from "../../common";
 import { IConverter } from "../interfaces/converter.interface";
-import { PageProperties } from "../interfaces/converter.types";
+import { EmulatedMediaType, PageProperties } from "../interfaces/converter.types";
 import { Converter } from "./converter";
 export declare class UrlConverter extends Converter implements IConverter {
     constructor();
-    convert({ url, properties, pdfFormat, }: {
+    convert({ url, header, footer, properties, pdfFormat, emulatedMediaType, }: {
         url: string;
+        header?: PathLike;
+        footer?: PathLike;
         properties?: PageProperties;
         pdfFormat?: PdfFormat;
+        emulatedMediaType?: EmulatedMediaType;
     }): Promise<Buffer>;
 }

package/dist/chromium/converters/url.converter.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UrlConverter = void 0;
 const tslib_1 = require("tslib");
+const fs_1 = require("fs");
 const url_1 = require("url");
 const form_data_1 = tslib_1.__importDefault(require("form-data"));
 const common_1 = require("../../common");
@@ -12,23 +13,29 @@ class UrlConverter extends converter_1.Converter {
     constructor() {
         super(main_config_1.ChromiumRoute.URL);
     }
-    convert({ url, properties, pdfFormat, }) {
+    convert({ url, header, footer, properties, pdfFormat, emulatedMediaType, }) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                const _url = new url_1.URL(url);
-                const data = new form_data_1.default();
-                if (pdfFormat) {
-                    data.append("pdfFormat", pdfFormat);
-                }
-                data.append("url", _url.href);
-                if (properties) {
-                    converter_utils_1.ConverterUtils.injectPageProperties(data, properties);
-                }
-                return common_1.GotenbergUtils.fetch(this.endpoint, data);
+            const _url = new url_1.URL(url);
+            const data = new form_data_1.default();
+            if (pdfFormat) {
+                data.append("pdfFormat", pdfFormat);
             }
-            catch (error) {
-                throw error;
+            data.append("url", _url.href);
+            if (header) {
+                yield fs_1.promises.access(header, fs_1.constants.R_OK);
+                data.append("header.html", (0, fs_1.createReadStream)(header));
             }
+            if (footer) {
+                yield fs_1.promises.access(footer, fs_1.constants.R_OK);
+                data.append("footer.html", (0, fs_1.createReadStream)(footer));
+            }
+            if (emulatedMediaType) {
+                data.append("emulatedMediaType", emulatedMediaType);
+            }
+            if (properties) {
+                converter_utils_1.ConverterUtils.injectPageProperties(data, properties);
+            }
+            return common_1.GotenbergUtils.fetch(this.endpoint, data);
         });
     }
 }

package/dist/chromium/converters/url.converter.js.map

@@ -1 +1 @@
-{"version":3,"file":"url.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/url.converter.ts"],"names":[],"mappings":";;;;AAAA,6BAA0B;AAE1B,kEAAiC;AAEjC,yCAAyD;AAGzD,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAElD,MAAa,YAAa,SAAQ,qBAAS;IACzC;QACE,KAAK,CAAC,2BAAa,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAEK,OAAO,CAAC,EACZ,GAAG,EACH,UAAU,EACV,SAAS,GAKV;;YACC,IAAI;gBACF,MAAM,IAAI,GAAG,IAAI,SAAG,CAAC,GAAG,CAAC,CAAC;gBAC1B,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;gBAC5B,IAAI,SAAS,EAAE;oBACb,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;iBACrC;gBACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9B,IAAI,UAAU,EAAE;oBACd,gCAAc,CAAC,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;iBACvD;gBACD,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;aAClD;YAAC,OAAO,KAAK,EAAE;gBACd,MAAM,KAAK,CAAC;aACb;QACH,CAAC;KAAA;CACF;AA7BD,oCA6BC"}
+{"version":3,"file":"url.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/url.converter.ts"],"names":[],"mappings":";;;;AAAA,2BAAqE;AAErE,6BAA0B;AAE1B,kEAAiC;AAEjC,yCAAyD;AAMzD,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAElD,MAAa,YAAa,SAAQ,qBAAS;IACzC;QACE,KAAK,CAAC,2BAAa,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAEK,OAAO,CAAC,EACZ,GAAG,EACH,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,GAQlB;;YACC,MAAM,IAAI,GAAG,IAAI,SAAG,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAC5B,IAAI,SAAS,EAAE;gBACb,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;aACrC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAE9B,IAAI,MAAM,EAAE;gBACV,MAAM,aAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAA,qBAAgB,EAAC,MAAM,CAAC,CAAC,CAAC;aACtD;YAED,IAAI,MAAM,EAAE;gBACV,MAAM,aAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAA,qBAAgB,EAAC,MAAM,CAAC,CAAC,CAAC;aACtD;YAED,IAAI,iBAAiB,EAAE;gBACrB,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;aACrD;YAED,IAAI,UAAU,EAAE;gBACd,gCAAc,CAAC,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;aACvD;YACD,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;KAAA;CACF;AA/CD,oCA+CC"}

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

@@ -20,4 +20,5 @@ export type PageProperties = {
         to: number;
     };
 };
+export type EmulatedMediaType = "screen" | "print";
 export {};

package/dist/common/constants.js

@@ -6,5 +6,5 @@ var PdfFormat;
     PdfFormat["A_1a"] = "PDF/A-1a";
     PdfFormat["A_2b"] = "PDF/A-2b";
     PdfFormat["A_3b"] = "PDF/A-3b";
-})(PdfFormat = exports.PdfFormat || (exports.PdfFormat = {}));
+})(PdfFormat || (exports.PdfFormat = PdfFormat = {}));
 //# sourceMappingURL=constants.js.map

package/dist/common/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":";;;AAAA,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;AACnB,CAAC,EAJW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAIpB"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":";;;AAAA,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;AACnB,CAAC,EAJW,SAAS,yBAAT,SAAS,QAIpB"}

package/dist/gotenberg.d.ts

@@ -1,4 +1,3 @@
-import "dotenv/config";
 export declare class Gotenberg {
     static endpoint: string;
 }

package/dist/gotenberg.js

@@ -3,10 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Gotenberg = void 0;
 const tslib_1 = require("tslib");
 process.env.SUPPRESS_NO_CONFIG_WARNING = "y";
-require("dotenv/config");
+const dotenv = tslib_1.__importStar(require("dotenv"));
+const path = tslib_1.__importStar(require("path"));
 const config_1 = tslib_1.__importDefault(require("config"));
+// Load endpoint from environment-specific file (e.g., .env.development)
+const envFile = `.env.${process.env.NODE_ENV}`;
+const envFileFallback = ".env";
+const dotenvConfig = dotenv.config({ path: path.resolve(envFile) });
+// Fallback to loading the default environment file.
+if (dotenvConfig.error) {
+    dotenv.config({ path: path.resolve(envFileFallback) });
+}
 class Gotenberg {
 }
-Gotenberg.endpoint = process.env.GOTENBERG_ENDPOINT || config_1.default.get("gotenberg.endpoint");
 exports.Gotenberg = Gotenberg;
+Gotenberg.endpoint = process.env.GOTENBERG_ENDPOINT || config_1.default.get("gotenberg.endpoint");
 //# sourceMappingURL=gotenberg.js.map

package/dist/gotenberg.js.map

@@ -1 +1 @@
-{"version":3,"file":"gotenberg.js","sourceRoot":"","sources":["../src/gotenberg.ts"],"names":[],"mappings":";;;;AAAA,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,GAAG,CAAC;AAE7C,yBAAuB;AACvB,4DAA4B;AAE5B,MAAa,SAAS;;AACN,kBAAQ,GACpB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,gBAAM,CAAC,GAAG,CAAS,oBAAoB,CAAC,CAAC;AAFlE,8BAAS"}
+{"version":3,"file":"gotenberg.js","sourceRoot":"","sources":["../src/gotenberg.ts"],"names":[],"mappings":";;;;AAAA,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,GAAG,CAAC;AAE7C,uDAAiC;AACjC,mDAA6B;AAC7B,4DAA4B;AAE5B,wEAAwE;AACxE,MAAM,OAAO,GAAG,QAAQ,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;AAC/C,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAEpE,oDAAoD;AACpD,IAAI,YAAY,CAAC,KAAK,EAAE;IACtB,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;CACxD;AAED,MAAa,SAAS;;AAAtB,8BAGC;AAFe,kBAAQ,GACpB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,gBAAM,CAAC,GAAG,CAAS,oBAAoB,CAAC,CAAC"}

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

@@ -10,19 +10,14 @@ class LibreOfficeUtils {
     static injectFiles(files, data) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             for (const file of files) {
-                try {
-                    yield fs_1.promises.access(file, fs_1.constants.R_OK);
-                    const filename = path_1.default.basename(file.toString());
-                    const extension = path_1.default.extname(filename);
-                    if (constants_1.LIBRE_OFFICE_EXTENSIONS.includes(extension)) {
-                        data.append(filename, (0, fs_1.createReadStream)(file));
-                    }
-                    else {
-                        throw new Error(`${extension} is not supported`);
-                    }
+                yield fs_1.promises.access(file, fs_1.constants.R_OK);
+                const filename = path_1.default.basename(file.toString());
+                const extension = path_1.default.extname(filename);
+                if (constants_1.LIBRE_OFFICE_EXTENSIONS.includes(extension)) {
+                    data.append(filename, (0, fs_1.createReadStream)(file));
                 }
-                catch (error) {
-                    throw error;
+                else {
+                    throw new Error(`${extension} is not supported`);
                 }
             }
         });

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,2BAAqE;AACrE,wDAAwB;AAIxB,yCAA8C;AAC9C,2CAAsD;AAGtD,MAAa,gBAAgB;IACpB,MAAM,CAAO,WAAW,CAAC,KAAiB,EAAE,IAAc;;YAC/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;gBACxB,IAAI;oBACF,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,mCAAuB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;wBAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;qBAC/C;yBAAM;wBACL,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,mBAAmB,CAAC,CAAC;qBAClD;iBACF;gBAAC,OAAO,KAAK,EAAE;oBACd,MAAM,KAAK,CAAC;iBACb;aACF;QACH,CAAC;KAAA;IAEM,MAAM,CAAC,oBAAoB,CAChC,IAAc,EACd,cAA8B;QAE9B,IAAI,cAAc,CAAC,SAAS,EAAE;YAC5B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;SAC5D;QAED,IAAI,cAAc,CAAC,gBAAgB,EAAE;YACnC,uBAAc,CAAC,MAAM,CACnB,cAAc,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC;gBACtC,cAAc,CAAC,gBAAgB,CAAC,EAAE,GAAG,CAAC;gBACtC,cAAc,CAAC,gBAAgB,CAAC,EAAE;oBAChC,cAAc,CAAC,gBAAgB,CAAC,IAAI,EACxC,0BAA0B,CAC3B,CAAC;YAEF,IAAI,CAAC,MAAM,CACT,kBAAkB,EAClB,GAAG,cAAc,CAAC,gBAAgB,CAAC,IAAI,IAAI,cAAc,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAChF,CAAC;SACH;IACH,CAAC;CACF;AAzCD,4CAyCC"}
+{"version":3,"file":"libre-office.utils.js","sourceRoot":"","sources":["../../../src/libre-office/utils/libre-office.utils.ts"],"names":[],"mappings":";;;;AAAA,2BAAqE;AACrE,wDAAwB;AAIxB,yCAA8C;AAC9C,2CAAsD;AAGtD,MAAa,gBAAgB;IACpB,MAAM,CAAO,WAAW,CAAC,KAAiB,EAAE,IAAc;;YAC/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;gBACxB,MAAM,aAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAChD,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACzC,IAAI,mCAAuB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;oBAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;iBAC/C;qBAAM;oBACL,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,mBAAmB,CAAC,CAAC;iBAClD;aACF;QACH,CAAC;KAAA;IAEM,MAAM,CAAC,oBAAoB,CAChC,IAAc,EACd,cAA8B;QAE9B,IAAI,cAAc,CAAC,SAAS,EAAE;YAC5B,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC;SAC5D;QAED,IAAI,cAAc,CAAC,gBAAgB,EAAE;YACnC,uBAAc,CAAC,MAAM,CACnB,cAAc,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC;gBACtC,cAAc,CAAC,gBAAgB,CAAC,EAAE,GAAG,CAAC;gBACtC,cAAc,CAAC,gBAAgB,CAAC,EAAE;oBAChC,cAAc,CAAC,gBAAgB,CAAC,IAAI,EACxC,0BAA0B,CAC3B,CAAC;YAEF,IAAI,CAAC,MAAM,CACT,kBAAkB,EAClB,GAAG,cAAc,CAAC,gBAAgB,CAAC,IAAI,IAAI,cAAc,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAChF,CAAC;SACH;IACH,CAAC;CACF;AArCD,4CAqCC"}

package/dist/main.config.js

@@ -7,7 +7,7 @@ var ChromiumRoute;
     ChromiumRoute["URL"] = "url";
     ChromiumRoute["HTML"] = "html";
     ChromiumRoute["MARKDOWN"] = "markdown";
-})(ChromiumRoute = exports.ChromiumRoute || (exports.ChromiumRoute = {}));
+})(ChromiumRoute || (exports.ChromiumRoute = ChromiumRoute = {}));
 var PdfEngineRoute;
 (function (PdfEngineRoute) {
     PdfEngineRoute["MERGE"] = "merge";
@@ -18,6 +18,7 @@ var LibreOfficeRoute;
 })(LibreOfficeRoute || (LibreOfficeRoute = {}));
 class Chromiumly {
 }
+exports.Chromiumly = Chromiumly;
 Chromiumly.GOTENBERG_ENDPOINT = gotenberg_1.Gotenberg.endpoint;
 Chromiumly.CHROMIUM_PATH = "forms/chromium/convert";
 Chromiumly.PDF_ENGINES_PATH = "forms/pdfengines";
@@ -33,5 +34,4 @@ Chromiumly.PDF_ENGINE_ROUTES = {
 Chromiumly.LIBRE_OFFICE_ROUTES = {
     convert: LibreOfficeRoute.CONVERT,
 };
-exports.Chromiumly = Chromiumly;
 //# sourceMappingURL=main.config.js.map

package/dist/main.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.config.js","sourceRoot":"","sources":["../src/main.config.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,sCAAqB,CAAA;AACvB,CAAC,EAJW,aAAa,GAAb,qBAAa,KAAb,qBAAa,QAIxB;AAED,IAAK,cAEJ;AAFD,WAAK,cAAc;IACjB,iCAAe,CAAA;AACjB,CAAC,EAFI,cAAc,KAAd,cAAc,QAElB;AAED,IAAK,gBAEJ;AAFD,WAAK,gBAAgB;IACnB,uCAAmB,CAAA;AACrB,CAAC,EAFI,gBAAgB,KAAhB,gBAAgB,QAEpB;AACD,MAAa,UAAU;;AACE,6BAAkB,GAAG,qBAAS,CAAC,QAAQ,CAAC;AAExC,wBAAa,GAAG,wBAAwB,CAAC;AACzC,2BAAgB,GAAG,kBAAkB,CAAC;AACtC,4BAAiB,GAAG,mBAAmB,CAAC;AAExC,0BAAe,GAAG;IACvC,GAAG,EAAE,aAAa,CAAC,GAAG;IACtB,IAAI,EAAE,aAAa,CAAC,IAAI;IACxB,QAAQ,EAAE,aAAa,CAAC,QAAQ;CACjC,CAAC;AAEqB,4BAAiB,GAAG;IACzC,KAAK,EAAE,cAAc,CAAC,KAAK;CAC5B,CAAC;AAEqB,8BAAmB,GAAG;IAC3C,OAAO,EAAE,gBAAgB,CAAC,OAAO;CAClC,CAAC;AAnBS,gCAAU"}
+{"version":3,"file":"main.config.js","sourceRoot":"","sources":["../src/main.config.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,sCAAqB,CAAA;AACvB,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAED,IAAK,cAEJ;AAFD,WAAK,cAAc;IACjB,iCAAe,CAAA;AACjB,CAAC,EAFI,cAAc,KAAd,cAAc,QAElB;AAED,IAAK,gBAEJ;AAFD,WAAK,gBAAgB;IACnB,uCAAmB,CAAA;AACrB,CAAC,EAFI,gBAAgB,KAAhB,gBAAgB,QAEpB;AACD,MAAa,UAAU;;AAAvB,gCAoBC;AAnBwB,6BAAkB,GAAG,qBAAS,CAAC,QAAQ,CAAC;AAExC,wBAAa,GAAG,wBAAwB,CAAC;AACzC,2BAAgB,GAAG,kBAAkB,CAAC;AACtC,4BAAiB,GAAG,mBAAmB,CAAC;AAExC,0BAAe,GAAG;IACvC,GAAG,EAAE,aAAa,CAAC,GAAG;IACtB,IAAI,EAAE,aAAa,CAAC,IAAI;IACxB,QAAQ,EAAE,aAAa,CAAC,QAAQ;CACjC,CAAC;AAEqB,4BAAiB,GAAG;IACzC,KAAK,EAAE,cAAc,CAAC,KAAK;CAC5B,CAAC;AAEqB,8BAAmB,GAAG;IAC3C,OAAO,EAAE,gBAAgB,CAAC,OAAO;CAClC,CAAC"}

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

@@ -8,19 +8,14 @@ class PDFEngineUtils {
     static injectFiles(files, data) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             for (const file of files) {
-                try {
-                    yield fs_1.promises.access(file, fs_1.constants.R_OK);
-                    const filename = path_1.default.basename(file.toString());
-                    const extension = path_1.default.extname(filename);
-                    if (extension === ".pdf") {
-                        data.append(filename, (0, fs_1.createReadStream)(file));
-                    }
-                    else {
-                        throw new Error(`${extension} is not supported`);
-                    }
+                yield fs_1.promises.access(file, fs_1.constants.R_OK);
+                const filename = path_1.default.basename(file.toString());
+                const extension = path_1.default.extname(filename);
+                if (extension === ".pdf") {
+                    data.append(filename, (0, fs_1.createReadStream)(file));
                 }
-                catch (error) {
-                    throw error;
+                else {
+                    throw new Error(`${extension} is not supported`);
                 }
             }
         });

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

@@ -1 +1 @@
-{"version":3,"file":"engine.utils.js","sourceRoot":"","sources":["../../../src/pdf-engines/utils/engine.utils.ts"],"names":[],"mappings":";;;;AAAA,2BAAqE;AACrE,wDAAwB;AAIxB,MAAa,cAAc;IAClB,MAAM,CAAO,WAAW,CAAC,KAAiB,EAAE,IAAc;;YAC/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;gBACxB,IAAI;oBACF,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;wBACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;qBAC/C;yBAAM;wBACL,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,mBAAmB,CAAC,CAAC;qBAClD;iBACF;gBAAC,OAAO,KAAK,EAAE;oBACd,MAAM,KAAK,CAAC;iBACb;aACF;QACH,CAAC;KAAA;CACF;AAjBD,wCAiBC"}
+{"version":3,"file":"engine.utils.js","sourceRoot":"","sources":["../../../src/pdf-engines/utils/engine.utils.ts"],"names":[],"mappings":";;;;AAAA,2BAAqE;AACrE,wDAAwB;AAIxB,MAAa,cAAc;IAClB,MAAM,CAAO,WAAW,CAAC,KAAiB,EAAE,IAAc;;YAC/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;gBACxB,MAAM,aAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,cAAS,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAChD,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACzC,IAAI,SAAS,KAAK,MAAM,EAAE;oBACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAA,qBAAgB,EAAC,IAAI,CAAC,CAAC,CAAC;iBAC/C;qBAAM;oBACL,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,mBAAmB,CAAC,CAAC;iBAClD;aACF;QACH,CAAC;KAAA;CACF;AAbD,wCAaC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromiumly",
-  "version": "2.0.8",
+  "version": "2.2.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",
@@ -15,7 +15,7 @@
   "author": "Taha Cherfia <taha.cherfia@gmail.com>",
   "license": "MIT",
   "engines": {
-    "node": ">=14.x"
+    "node": ">=16.x"
   },
   "keywords": [
     "gotenberg",
@@ -32,26 +32,27 @@
     "test": "jest --runInBand --ci --coverage --reporters=default --reporters=jest-junit"
   },
   "devDependencies": {
-    "@babel/preset-typescript": "7.21.5",
-    "@types/config": "3.3.0",
+    "@babel/preset-typescript": "7.23.2",
+    "@types/config": "3.3.2",
     "@types/dotenv": "8.2.0",
     "@types/form-data": "2.5.0",
-    "@types/jest": "29.2.6",
-    "@types/node": "18.16.2",
-    "@types/node-fetch": "2.6.3",
-    "@typescript-eslint/eslint-plugin": "5.59.1",
-    "@typescript-eslint/parser": "5.59.1",
-    "eslint": "8.39.0",
-    "jest": "29.3.1",
+    "@types/jest": "29.5.7",
+    "@types/node": "20.8.10",
+    "@types/node-fetch": "2.6.8",
+    "@typescript-eslint/eslint-plugin": "6.9.1",
+    "@typescript-eslint/parser": "6.9.1",
+    "eslint": "8.52.0",
+    "jest": "29.7.0",
     "jest-junit": "16.0.0",
-    "ts-jest": "29.1.0",
+    "ts-jest": "29.1.1",
     "ts-node": "10.9.1",
-    "typescript": "5.0.4"
+    "tslib": "2.6.2",
+    "typescript": "5.2.2"
   },
   "dependencies": {
     "config": "3.3.9",
-    "dotenv": "16.0.3",
+    "dotenv": "16.3.1",
     "form-data": "4.0.0",
-    "node-fetch": "2.6.8"
+    "node-fetch": "2.7.0"
   }
 }

package/src/chromium/converters/html.converter.ts

@@ -4,7 +4,10 @@ import FormData from "form-data";
 
 import { GotenbergUtils, PdfFormat } from "../../common";
 import { IConverter } from "../interfaces/converter.interface";
-import { PageProperties } from "../interfaces/converter.types";
+import {
+  EmulatedMediaType,
+  PageProperties,
+} from "../interfaces/converter.types";
 import { ConverterUtils } from "../utils/converter.utils";
 import { Converter } from "./converter";
 import { ChromiumRoute } from "../../main.config";
@@ -16,26 +19,46 @@ export class HtmlConverter extends Converter implements IConverter {
 
   async convert({
     html,
+    header,
+    footer,
     properties,
     pdfFormat,
+    emulatedMediaType,
   }: {
     html: PathLike;
+    header?: PathLike;
+    footer?: PathLike;
     properties?: PageProperties;
     pdfFormat?: PdfFormat;
+    emulatedMediaType?: EmulatedMediaType;
   }): Promise<Buffer> {
-    try {
-      await promises.access(html, constants.R_OK);
-      const data = new FormData();
-      if (pdfFormat) {
-        data.append("pdfFormat", pdfFormat);
-      }
-      data.append("index.html", createReadStream(html));
-      if (properties) {
-        ConverterUtils.injectPageProperties(data, properties);
-      }
-      return GotenbergUtils.fetch(this.endpoint, data);
-    } catch (error) {
-      throw error;
+    await promises.access(html, constants.R_OK);
+    const data = new FormData();
+
+    if (pdfFormat) {
+      data.append("pdfFormat", pdfFormat);
+    }
+
+    data.append("index.html", createReadStream(html));
+
+    if (header) {
+      await promises.access(header, constants.R_OK);
+      data.append("header.html", createReadStream(header));
+    }
+
+    if (footer) {
+      await promises.access(footer, constants.R_OK);
+      data.append("footer.html", createReadStream(footer));
     }
+
+    if (emulatedMediaType) {
+      data.append("emulatedMediaType", emulatedMediaType);
+    }
+
+    if (properties) {
+      ConverterUtils.injectPageProperties(data, properties);
+    }
+
+    return GotenbergUtils.fetch(this.endpoint, data);
   }
 }

package/src/chromium/converters/markdown.converter.ts

@@ -4,7 +4,10 @@ import FormData from "form-data";
 
 import { GotenbergUtils, PdfFormat } from "../../common";
 import { IConverter } from "../interfaces/converter.interface";
-import { PageProperties } from "../interfaces/converter.types";
+import {
+  EmulatedMediaType,
+  PageProperties,
+} from "../interfaces/converter.types";
 import { ConverterUtils } from "../utils/converter.utils";
 import { Converter } from "./converter";
 import { ChromiumRoute } from "../../main.config";
@@ -17,29 +20,47 @@ export class MarkdownConverter extends Converter implements IConverter {
   async convert({
     html,
     markdown,
+    header,
+    footer,
     properties,
     pdfFormat,
+    emulatedMediaType,
   }: {
     html: PathLike;
     markdown: PathLike;
+    header?: PathLike;
+    footer?: PathLike;
     properties?: PageProperties;
     pdfFormat?: PdfFormat;
+    emulatedMediaType?: EmulatedMediaType;
   }): Promise<Buffer> {
-    try {
-      await promises.access(html, constants.R_OK);
-      await promises.access(markdown, constants.R_OK);
-      const data = new FormData();
-      if (pdfFormat) {
-        data.append("pdfFormat", pdfFormat);
-      }
-      data.append("index.html", createReadStream(html));
-      data.append("file.md", createReadStream(markdown));
-      if (properties) {
-        ConverterUtils.injectPageProperties(data, properties);
-      }
-      return GotenbergUtils.fetch(this.endpoint, data);
-    } catch (error) {
-      throw error;
+    await promises.access(html, constants.R_OK);
+    await promises.access(markdown, constants.R_OK);
+    const data = new FormData();
+    if (pdfFormat) {
+      data.append("pdfFormat", pdfFormat);
     }
+    data.append("index.html", createReadStream(html));
+    data.append("file.md", createReadStream(markdown));
+
+    if (header) {
+      await promises.access(header, constants.R_OK);
+      data.append("header.html", createReadStream(header));
+    }
+
+    if (footer) {
+      await promises.access(footer, constants.R_OK);
+      data.append("footer.html", createReadStream(footer));
+    }
+
+    if (emulatedMediaType) {
+      data.append("emulatedMediaType", emulatedMediaType);
+    }
+
+    if (properties) {
+      ConverterUtils.injectPageProperties(data, properties);
+    }
+
+    return GotenbergUtils.fetch(this.endpoint, data);
   }
 }

package/src/chromium/converters/tests/html.converter.test.ts

@@ -1,4 +1,5 @@
-import { promises, createReadStream } from "fs";
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+import { createReadStream, promises } from "fs";
 
 import fetch from "node-fetch";
 import FormData from "form-data";
@@ -51,7 +52,7 @@ describe("HtmlConverter", () => {
           html: "path/to/index.html",
           pdfFormat: PdfFormat.A_1a,
         });
-        expect(mockFormDataAppend).toBeCalledTimes(2);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
         expect(buffer).toEqual(Buffer.from("content"));
       });
     });
@@ -64,7 +65,63 @@ describe("HtmlConverter", () => {
           html: "path/to/index.html",
           properties: { size: { width: 8.3, height: 11.7 } },
         });
-        expect(mockFormDataAppend).toBeCalledTimes(3);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(3);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when header parameter is passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          html: "path/to/index.html",
+          header: "path/to/header.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when footer parameter is passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          html: "path/to/index.html",
+          footer: "path/to/footer.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when emulatedMediaType parameter is passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          html: "path/to/index.html",
+          emulatedMediaType: "screen",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when all parameters are passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          html: "path/to/index.html",
+          header: "path/to/header.html",
+          footer: "path/to/footer.html",
+          pdfFormat: PdfFormat.A_1a,
+          emulatedMediaType: "screen",
+          properties: { size: { width: 8.3, height: 11.7 } },
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(7);
         expect(buffer).toEqual(Buffer.from("content"));
       });
     });

package/src/chromium/converters/tests/markdown.converter.test.ts

@@ -1,7 +1,8 @@
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 import { createReadStream, promises } from "fs";
 
-import fetch from "node-fetch";
 import FormData from "form-data";
+import fetch from "node-fetch";
 
 import { PdfFormat } from "../../../common";
 import { MarkdownConverter } from "../markdown.converter";
@@ -29,7 +30,9 @@ describe("MarkdownConverter", () => {
 
   describe("convert", () => {
     beforeEach(() => {
-      (createReadStream as jest.Mock) = jest.fn().mockImplementation(() => {});
+      (createReadStream as jest.Mock) = jest
+        .fn()
+        .mockImplementation((file) => file);
     });
 
     describe("when file exists", () => {
@@ -53,7 +56,7 @@ describe("MarkdownConverter", () => {
           markdown: "path/to/file.md",
           pdfFormat: PdfFormat.A_2b,
         });
-        expect(mockFormDataAppend).toBeCalledTimes(3);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(3);
         expect(buffer).toEqual(Buffer.from("content"));
       });
     });
@@ -67,7 +70,68 @@ describe("MarkdownConverter", () => {
           markdown: "path/to/file.md",
           properties: { size: { width: 8.3, height: 11.7 } },
         });
-        expect(mockFormDataAppend).toBeCalledTimes(4);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(4);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when header parameter is passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          html: "path/to/index.html",
+          markdown: "path/to/file.md",
+          header: "path/to/header.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(3);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when footer parameter is passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          html: "path/to/index.html",
+          markdown: "path/to/file.md",
+          footer: "path/to/footer.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(3);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when emulatedMediaType parameter is passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          html: "path/to/index.html",
+          markdown: "path/to/file.md",
+          emulatedMediaType: "screen",
+        });
+
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(3);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when all parameters are passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          html: "path/to/index.html",
+          markdown: "path/to/file.md",
+          header: "path/to/header.html",
+          footer: "path/to/footer.html",
+          pdfFormat: PdfFormat.A_1a,
+          emulatedMediaType: "screen",
+          properties: { size: { width: 8.3, height: 11.7 } },
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(8);
         expect(buffer).toEqual(Buffer.from("content"));
       });
     });

package/src/chromium/converters/tests/url.converter.test.ts

@@ -1,5 +1,7 @@
-import fetch from "node-fetch";
+// 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";
 import { UrlConverter } from "../url.converter";
@@ -10,9 +12,16 @@ jest.mock("node-fetch", () => jest.fn());
 describe("HtmlConverter", () => {
   const mockFetch = fetch as jest.MockedFunction<typeof fetch>;
   const mockFormDataAppend = jest.spyOn(FormData.prototype, "append");
+  const mockPromisesAccess = jest.spyOn(promises, "access");
 
   const converter = new UrlConverter();
 
+  beforeEach(() => {
+    (createReadStream as jest.Mock) = jest
+      .fn()
+      .mockImplementation((file) => file);
+  });
+
   afterEach(() => {
     jest.resetAllMocks();
   });
@@ -36,6 +45,34 @@ describe("HtmlConverter", () => {
       });
     });
 
+    describe("when header parameter is passed", () => {
+      it("should return a buffer", async () => {
+        mockFetch.mockResolvedValueOnce(new Response("content"));
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          url: "http://www.example.com/",
+          header: "path/to/header.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when footer parameter is passed", () => {
+      it("should return a buffer", async () => {
+        mockFetch.mockResolvedValueOnce(new Response("content"));
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          url: "http://www.example.com/",
+          footer: "path/to/footer.html",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
     describe("when pdf format parameter is passed", () => {
       it("should return a buffer", async () => {
         mockFetch.mockResolvedValueOnce(new Response("content"));
@@ -43,7 +80,7 @@ describe("HtmlConverter", () => {
           url: "http://www.example.com/",
           pdfFormat: PdfFormat.A_3b,
         });
-        expect(mockFormDataAppend).toBeCalledTimes(2);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
         expect(buffer).toEqual(Buffer.from("content"));
       });
     });
@@ -55,7 +92,37 @@ describe("HtmlConverter", () => {
           url: "http://www.example.com/",
           properties: { size: { width: 8.3, height: 11.7 } },
         });
-        expect(mockFormDataAppend).toBeCalledTimes(3);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(3);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when emulatedMediaType parameter is passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          url: "http://www.example.com/",
+          emulatedMediaType: "screen",
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+        expect(buffer).toEqual(Buffer.from("content"));
+      });
+    });
+
+    describe("when all parameters are passed", () => {
+      it("should return a buffer", async () => {
+        mockPromisesAccess.mockResolvedValue();
+        mockFetch.mockResolvedValue(new Response("content"));
+        const buffer = await converter.convert({
+          url: "http://www.example.com/",
+          header: "path/to/header.html",
+          footer: "path/to/footer.html",
+          pdfFormat: PdfFormat.A_1a,
+          emulatedMediaType: "screen",
+          properties: { size: { width: 8.3, height: 11.7 } },
+        });
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(7);
         expect(buffer).toEqual(Buffer.from("content"));
       });
     });
@@ -64,7 +131,7 @@ describe("HtmlConverter", () => {
       it("should throw an error", async () => {
         await expect(() =>
           converter.convert({ url: "invalid url" })
-        ).rejects.toThrow("Invalid URL: invalid url");
+        ).rejects.toThrow("Invalid URL");
       });
     });
 

package/src/chromium/converters/url.converter.ts

@@ -1,10 +1,15 @@
+import { PathLike, constants, createReadStream, promises } from "fs";
+
 import { URL } from "url";
 
 import FormData from "form-data";
 
 import { GotenbergUtils, PdfFormat } from "../../common";
 import { IConverter } from "../interfaces/converter.interface";
-import { PageProperties } from "../interfaces/converter.types";
+import {
+  EmulatedMediaType,
+  PageProperties,
+} from "../interfaces/converter.types";
 import { ConverterUtils } from "../utils/converter.utils";
 import { Converter } from "./converter";
 import { ChromiumRoute } from "../../main.config";
@@ -16,26 +21,44 @@ export class UrlConverter extends Converter implements IConverter {
 
   async convert({
     url,
+    header,
+    footer,
     properties,
     pdfFormat,
+    emulatedMediaType,
   }: {
     url: string;
+    header?: PathLike;
+    footer?: PathLike;
     properties?: PageProperties;
     pdfFormat?: PdfFormat;
+    emulatedMediaType?: EmulatedMediaType;
   }): Promise<Buffer> {
-    try {
-      const _url = new URL(url);
-      const data = new FormData();
-      if (pdfFormat) {
-        data.append("pdfFormat", pdfFormat);
-      }
-      data.append("url", _url.href);
-      if (properties) {
-        ConverterUtils.injectPageProperties(data, properties);
-      }
-      return GotenbergUtils.fetch(this.endpoint, data);
-    } catch (error) {
-      throw error;
+    const _url = new URL(url);
+    const data = new FormData();
+    if (pdfFormat) {
+      data.append("pdfFormat", pdfFormat);
+    }
+
+    data.append("url", _url.href);
+
+    if (header) {
+      await promises.access(header, constants.R_OK);
+      data.append("header.html", createReadStream(header));
+    }
+
+    if (footer) {
+      await promises.access(footer, constants.R_OK);
+      data.append("footer.html", createReadStream(footer));
+    }
+
+    if (emulatedMediaType) {
+      data.append("emulatedMediaType", emulatedMediaType);
+    }
+
+    if (properties) {
+      ConverterUtils.injectPageProperties(data, properties);
     }
+    return GotenbergUtils.fetch(this.endpoint, data);
   }
 }

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

@@ -19,3 +19,5 @@ export type PageProperties = {
   scale?: number; // The scale of the page rendering (default 1.0)
   nativePageRanges?: { from: number; to: number }; // Page ranges to print
 };
+
+export type EmulatedMediaType = "screen" | "print";

package/src/gotenberg.ts

@@ -1,8 +1,20 @@
 process.env.SUPPRESS_NO_CONFIG_WARNING = "y";
 
-import "dotenv/config";
+import * as dotenv from "dotenv";
+import * as path from "path";
 import config from "config";
 
+// Load endpoint from environment-specific file (e.g., .env.development)
+const envFile = `.env.${process.env.NODE_ENV}`;
+const envFileFallback = ".env";
+
+const dotenvConfig = dotenv.config({ path: path.resolve(envFile) });
+
+// Fallback to loading the default environment file.
+if (dotenvConfig.error) {
+  dotenv.config({ path: path.resolve(envFileFallback) });
+}
+
 export class Gotenberg {
   public static endpoint: string =
     process.env.GOTENBERG_ENDPOINT || config.get<string>("gotenberg.endpoint");

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/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);
       });
     });
 
@@ -53,7 +50,7 @@ describe("PDFEngine", () => {
           merge: true,
         });
         expect(buffer).toEqual(Buffer.from("content"));
-        expect(mockFormDataAppend).toBeCalledTimes(5);
+        expect(mockFormDataAppend).toHaveBeenCalledTimes(5);
       });
     });
   });
@@ -66,19 +63,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);
       });
     });