chromiumly 3.0.1 → 3.1.0

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

@@ -29,7 +29,7 @@ class PDFEngines {
                 metadata
             });
             const endpoint = `${main_config_1.Chromiumly.GOTENBERG_ENDPOINT}/${main_config_1.Chromiumly.PDF_ENGINES_PATH}/${main_config_1.Chromiumly.PDF_ENGINE_ROUTES.merge}`;
-            return common_1.GotenbergUtils.fetch(endpoint, data);
+            return common_1.GotenbergUtils.fetch(endpoint, data, main_config_1.Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME, main_config_1.Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD);
         });
     }
     /**
@@ -50,7 +50,7 @@ class PDFEngines {
                 pdfUA
             });
             const endpoint = `${main_config_1.Chromiumly.GOTENBERG_ENDPOINT}/${main_config_1.Chromiumly.LIBRE_OFFICE_PATH}/${main_config_1.Chromiumly.LIBRE_OFFICE_ROUTES.convert}`;
-            return common_1.GotenbergUtils.fetch(endpoint, data);
+            return common_1.GotenbergUtils.fetch(endpoint, data, main_config_1.Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME, main_config_1.Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD);
         });
     }
     /**
@@ -64,7 +64,7 @@ class PDFEngines {
             const data = new form_data_1.default();
             yield pdf_engines_utils_1.PDFEnginesUtils.addFiles(files, data);
             const endpoint = `${main_config_1.Chromiumly.GOTENBERG_ENDPOINT}/${main_config_1.Chromiumly.PDF_ENGINES_PATH}/${main_config_1.Chromiumly.PDF_ENGINE_ROUTES.readMetadata}`;
-            return common_1.GotenbergUtils.fetch(endpoint, data);
+            return common_1.GotenbergUtils.fetch(endpoint, data, main_config_1.Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME, main_config_1.Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD);
         });
     }
     /**
@@ -80,7 +80,7 @@ class PDFEngines {
             data.append('metadata', JSON.stringify(metadata));
             yield pdf_engines_utils_1.PDFEnginesUtils.addFiles(files, data);
             const endpoint = `${main_config_1.Chromiumly.GOTENBERG_ENDPOINT}/${main_config_1.Chromiumly.PDF_ENGINES_PATH}/${main_config_1.Chromiumly.PDF_ENGINE_ROUTES.writeMetadata}`;
-            return common_1.GotenbergUtils.fetch(endpoint, data);
+            return common_1.GotenbergUtils.fetch(endpoint, data, main_config_1.Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME, main_config_1.Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD);
         });
     }
     /**

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

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

package/package.json

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

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

@@ -6,10 +6,10 @@ import {
     PathLikeOrReadStream,
     PdfFormat
 } from '../../common';
-import { PageProperties } from '../interfaces/converter.types';
+import { Cookie, PageProperties } from '../interfaces/converter.types';
 import { ConverterUtils } from '../utils/converter.utils';
 import { Converter } from './converter';
-import { ChromiumRoute } from '../../main.config';
+import { ChromiumRoute, Chromiumly } from '../../main.config';
 import { EmulatedMediaType } from '../interfaces/common.types';
 
 /**
@@ -46,6 +46,7 @@ export class HtmlConverter extends Converter {
      * @param {boolean} [options.failOnConsoleExceptions] - Whether to fail on console exceptions during conversion.
      * @param {boolean} [options.skipNetworkIdleEvent] - Whether to skip network idle event.
      * @param {Metadata} options.metadata - Metadata to be written.
+     * @param {Cookie[]} options.cookies - Cookies to be written.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
     async convert({
@@ -64,7 +65,8 @@ export class HtmlConverter extends Converter {
         failOnHttpStatusCodes,
         failOnConsoleExceptions,
         skipNetworkIdleEvent,
-        metadata
+        metadata,
+        cookies
     }: {
         html: PathLikeOrReadStream;
         assets?: { file: PathLikeOrReadStream; name: string }[];
@@ -90,6 +92,7 @@ export class HtmlConverter extends Converter {
         failOnConsoleExceptions?: boolean;
         skipNetworkIdleEvent?: boolean;
         metadata?: Metadata;
+        cookies?: Cookie[];
     }): Promise<Buffer> {
         const data = new FormData();
 
@@ -117,9 +120,15 @@ export class HtmlConverter extends Converter {
             failOnHttpStatusCodes,
             failOnConsoleExceptions,
             skipNetworkIdleEvent,
-            metadata
+            metadata,
+            cookies
         });
 
-        return GotenbergUtils.fetch(this.endpoint, data);
+        return GotenbergUtils.fetch(
+            this.endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 }

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

@@ -6,10 +6,10 @@ import {
     PathLikeOrReadStream,
     Metadata
 } from '../../common';
-import { PageProperties } from '../interfaces/converter.types';
+import { Cookie, PageProperties } from '../interfaces/converter.types';
 import { ConverterUtils } from '../utils/converter.utils';
 import { Converter } from './converter';
-import { ChromiumRoute } from '../../main.config';
+import { ChromiumRoute, Chromiumly } from '../../main.config';
 import { EmulatedMediaType } from '../interfaces/common.types';
 
 /**
@@ -47,6 +47,7 @@ export class MarkdownConverter extends Converter {
      * @param {boolean} [options.failOnConsoleExceptions] - Whether to fail on console exceptions during conversion.
      * @param {boolean} [options.skipNetworkIdleEvent] - Whether to skip network idle event.
      * @param {Metadata} options.metadata - Metadata to be written.
+     * @param {Cookie[]} options.cookies - Cookies to be written.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
     async convert({
@@ -65,7 +66,8 @@ export class MarkdownConverter extends Converter {
         failOnHttpStatusCodes,
         failOnConsoleExceptions,
         skipNetworkIdleEvent,
-        metadata
+        metadata,
+        cookies
     }: {
         html: PathLikeOrReadStream;
         markdown: PathLikeOrReadStream;
@@ -91,6 +93,7 @@ export class MarkdownConverter extends Converter {
         failOnConsoleExceptions?: boolean;
         skipNetworkIdleEvent?: boolean;
         metadata?: Metadata;
+        cookies?: Cookie[];
     }): Promise<Buffer> {
         const data = new FormData();
 
@@ -112,9 +115,15 @@ export class MarkdownConverter extends Converter {
             failOnHttpStatusCodes,
             failOnConsoleExceptions,
             skipNetworkIdleEvent,
-            metadata
+            metadata,
+            cookies
         });
 
-        return GotenbergUtils.fetch(this.endpoint, data);
+        return GotenbergUtils.fetch(
+            this.endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 }

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

@@ -6,10 +6,10 @@ import {
     PathLikeOrReadStream,
     Metadata
 } from '../../common';
-import { PageProperties } from '../interfaces/converter.types';
+import { Cookie, PageProperties } from '../interfaces/converter.types';
 import { ConverterUtils } from '../utils/converter.utils';
 import { Converter } from './converter';
-import { ChromiumRoute } from '../../main.config';
+import { ChromiumRoute, Chromiumly } from '../../main.config';
 import { EmulatedMediaType } from '../interfaces/common.types';
 
 /**
@@ -46,6 +46,7 @@ export class UrlConverter extends Converter {
      * @param {boolean} [options.failOnConsoleExceptions] - Whether to fail on console exceptions during conversion.
      * @param {boolean} [options.skipNetworkIdleEvent] - Whether to skip network idle event.
      * @param {Metadata} options.metadata - Metadata to be written.
+     * @param {Cookie[]} options.cookies - Cookies to be written.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
     async convert({
@@ -63,7 +64,8 @@ export class UrlConverter extends Converter {
         failOnHttpStatusCodes,
         failOnConsoleExceptions,
         skipNetworkIdleEvent,
-        metadata
+        metadata,
+        cookies
     }: {
         url: string;
         header?: PathLikeOrReadStream;
@@ -88,6 +90,7 @@ export class UrlConverter extends Converter {
         failOnConsoleExceptions?: boolean;
         skipNetworkIdleEvent?: boolean;
         metadata?: Metadata;
+        cookies?: Cookie[];
     }): Promise<Buffer> {
         const _url = new URL(url);
         const data = new FormData();
@@ -108,9 +111,15 @@ export class UrlConverter extends Converter {
             failOnHttpStatusCodes,
             failOnConsoleExceptions,
             skipNetworkIdleEvent,
-            metadata
+            metadata,
+            cookies
         });
 
-        return GotenbergUtils.fetch(this.endpoint, data);
+        return GotenbergUtils.fetch(
+            this.endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 }

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

@@ -25,10 +25,21 @@ export type PageProperties = {
     nativePageRanges?: { from: number; to: number }; // Page ranges to print
 };
 
+export type Cookie = {
+    name: string;
+    value: string;
+    domain: string;
+    path?: string;
+    secure?: boolean;
+    httpOnly?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+};
+
 export type ConversionOptions = ChromiumOptions & {
     properties?: PageProperties;
     pdfFormat?: PdfFormat;
     pdfUA?: boolean; // Enable PDF for Universal Access for optimal accessibility (default false)
     userAgent?: string;
     metadata?: Metadata;
+    cookies?: Cookie[];
 };

package/src/chromium/screenshots/html.screenshot.ts

@@ -1,7 +1,7 @@
 import FormData from 'form-data';
 
 import { GotenbergUtils, PathLikeOrReadStream } from '../../common';
-import { ChromiumRoute } from '../../main.config';
+import { ChromiumRoute, Chromiumly } from '../../main.config';
 import { EmulatedMediaType } from '../interfaces/common.types';
 import { ScreenshotUtils } from '../utils/screenshot.utils';
 import { Screenshot } from './screenshot';
@@ -95,6 +95,11 @@ export class HtmlScreenshot extends Screenshot {
             optimizeForSpeed
         });
 
-        return GotenbergUtils.fetch(this.endpoint, data);
+        return GotenbergUtils.fetch(
+            this.endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 }

package/src/chromium/screenshots/markdown.screenshot.ts

@@ -4,7 +4,7 @@ import { GotenbergUtils, PathLikeOrReadStream } from '../../common';
 import { ImageProperties } from '../interfaces/screenshot.types';
 import { ScreenshotUtils } from '../utils/screenshot.utils';
 import { Screenshot } from './screenshot';
-import { ChromiumRoute } from '../../main.config';
+import { ChromiumRoute, Chromiumly } from '../../main.config';
 import { EmulatedMediaType } from '../interfaces/common.types';
 
 /**
@@ -90,6 +90,11 @@ export class MarkdownScreenshot extends Screenshot {
             optimizeForSpeed
         });
 
-        return GotenbergUtils.fetch(this.endpoint, data);
+        return GotenbergUtils.fetch(
+            this.endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 }

package/src/chromium/screenshots/url.screenshot.ts

@@ -4,7 +4,7 @@ import { GotenbergUtils, PathLikeOrReadStream } from '../../common';
 import { ImageProperties } from '../interfaces/screenshot.types';
 import { ScreenshotUtils } from '../utils/screenshot.utils';
 import { Screenshot } from './screenshot';
-import { ChromiumRoute } from '../../main.config';
+import { ChromiumRoute, Chromiumly } from '../../main.config';
 import { EmulatedMediaType } from '../interfaces/common.types';
 
 /**
@@ -86,6 +86,11 @@ export class UrlScreenshot extends Screenshot {
             optimizeForSpeed
         });
 
-        return GotenbergUtils.fetch(this.endpoint, data);
+        return GotenbergUtils.fetch(
+            this.endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 }

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

@@ -179,5 +179,9 @@ export class ConverterUtils {
         if (options.metadata) {
             data.append('metadata', JSON.stringify(options.metadata));
         }
+
+        if (options.cookies) {
+            data.append('cookies', JSON.stringify(options.cookies));
+        }
     }
 }

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

@@ -364,6 +364,39 @@ describe('GotenbergUtils', () => {
             });
         });
 
+        describe('when cookies parameter is passed', () => {
+            it('should append cookies', async () => {
+                await ConverterUtils.customize(data, {
+                    cookies: [
+                        {
+                            name: 'sample_id',
+                            value: 'sample_value',
+                            domain: 'example.com',
+                            path: '/',
+                            secure: true,
+                            httpOnly: true,
+                            sameSite: 'Strict'
+                        }
+                    ]
+                });
+                expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+                expect(data.append).toHaveBeenCalledWith(
+                    'cookies',
+                    JSON.stringify([
+                        {
+                            name: 'sample_id',
+                            value: 'sample_value',
+                            domain: 'example.com',
+                            path: '/',
+                            secure: true,
+                            httpOnly: true,
+                            sameSite: 'Strict'
+                        }
+                    ])
+                );
+            });
+        });
+
         describe('when all options are passed', () => {
             it('should append all options', async () => {
                 await ConverterUtils.customize(data, {

package/src/common/gotenberg.utils.ts

@@ -27,20 +27,31 @@ export class GotenbergUtils {
      * Performs a POST request to the specified Gotenberg endpoint with the provided FormData.
      *
      * @param {string} endpoint - The Gotenberg endpoint URL.
+     * @param {string} username - The username for basic authentication.
+     * @param {string} password - The password for basic authentication.
      * @param {FormData} data - The FormData object to be sent in the POST request.
      * @returns {Promise<Buffer>} A Promise that resolves to the response body as a Buffer.
      * @throws {Error} Throws an error if the HTTP response status is not OK.
      */
     public static async fetch(
         endpoint: string,
-        data: FormData
+        data: FormData,
+        username?: string,
+        password?: string
     ): Promise<Buffer> {
+        const headers: Record<string, string> = { ...data.getHeaders() };
+
+        if (username && password) {
+            const authHeader =
+                'Basic ' +
+                Buffer.from(username + ':' + password).toString('base64');
+            headers['Authorization'] = authHeader;
+        }
+
         const response = await fetch(endpoint, {
             method: 'post',
             body: data,
-            headers: {
-                ...data.getHeaders()
-            }
+            headers
         });
 
         if (!response.ok) {

package/src/common/tests/gotenberg.utils.test.ts

@@ -39,11 +39,18 @@ describe('GotenbergUtils', () => {
         const mockFetch = fetch as jest.MockedFunction<typeof fetch>;
         const data = new FormData();
         const endpoint = 'http://localhost:3000/forms/chromium/convert/html';
+        const basicAuthUsername = 'username';
+        const basicAuthPassword = 'pass';
 
         describe('when fetch request succeeds', () => {
             it('should return a buffer', async () => {
                 mockFetch.mockResolvedValueOnce(new Response('content'));
-                const response = await GotenbergUtils.fetch(endpoint, data);
+                const response = await GotenbergUtils.fetch(
+                    endpoint,
+                    data,
+                    basicAuthUsername,
+                    basicAuthPassword
+                );
                 await expect(response).toEqual(Buffer.from('content'));
             });
         });
@@ -57,7 +64,12 @@ describe('GotenbergUtils', () => {
                         new FetchError(errorMessage)
                     );
                     await expect(() =>
-                        GotenbergUtils.fetch(endpoint, data)
+                        GotenbergUtils.fetch(
+                            endpoint,
+                            data,
+                            basicAuthUsername,
+                            basicAuthPassword
+                        )
                     ).rejects.toThrow(errorMessage);
                 });
             });
@@ -74,7 +86,12 @@ describe('GotenbergUtils', () => {
                         )
                     );
                     await expect(() =>
-                        GotenbergUtils.fetch(endpoint, data)
+                        GotenbergUtils.fetch(
+                            endpoint,
+                            data,
+                            basicAuthUsername,
+                            basicAuthPassword
+                        )
                     ).rejects.toThrow('500 Internal server error');
                 });
             });

package/src/gotenberg.ts

@@ -20,11 +20,35 @@ if (dotenvConfig.error) {
  */
 export class Gotenberg {
     /**
-     * The Gotenberg service endpoint.
-     * Defaults to the value from the environment variable `GOTENBERG_ENDPOINT`, or falls back to the configuration file.
+     * The endpoint for the Gotenberg service.
      * @type {string}
      */
-    public static endpoint: string =
-        process.env.GOTENBERG_ENDPOINT ||
-        config.get<string>('gotenberg.endpoint');
+    static get endpoint(): string {
+        return (
+            process.env.GOTENBERG_ENDPOINT ||
+            config.get<string>('gotenberg.endpoint')
+        );
+    }
+
+    /**
+     * The username for basic authentication with the Gotenberg service.
+     * @type {string | undefined}
+     */
+    static get username(): string | undefined {
+        const hasUsername = config.has('gotenberg.api.basicAuth.username');
+        return hasUsername
+            ? config.get<string>('gotenberg.api.basicAuth.username')
+            : process.env.GOTENBERG_API_BASIC_AUTH_USERNAME;
+    }
+
+    /**
+     * The password for basic authentication with the Gotenberg service.
+     * @type {string | undefined}
+     */
+    static get password(): string | undefined {
+        const hasPassword = config.has('gotenberg.api.basicAuth.password');
+        return hasPassword
+            ? config.get<string>('gotenberg.api.basicAuth.password')
+            : process.env.GOTENBERG_API_BASIC_AUTH_PASSWORD;
+    }
 }

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

@@ -144,6 +144,7 @@ export type PageProperties = {
     landscape?: boolean; // Set the paper orientation to landscape (default false)
     nativePageRanges?: { from: number; to: number }; // Page ranges to print
     exportFormFields?: boolean; // Set whether to export the form fields or to use the inputted/selected content of the fields (default true)
+    singlePageSheets?: boolean; // Set whether to render the entire spreadsheet as a single page. (default false)
 };
 
 export type ConversionOptions = {

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

@@ -51,6 +51,11 @@ export class LibreOffice {
 
         const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.LIBRE_OFFICE_PATH}/${Chromiumly.LIBRE_OFFICE_ROUTES.convert}`;
 
-        return GotenbergUtils.fetch(endpoint, data);
+        return GotenbergUtils.fetch(
+            endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 }

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

@@ -85,6 +85,13 @@ export class LibreOfficeUtils {
                 String(pageProperties.exportFormFields)
             );
         }
+
+        if (pageProperties.singlePageSheets) {
+            data.append(
+                'singlePageSheets',
+                String(pageProperties.singlePageSheets)
+            );
+        }
     }
 
     /**

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

@@ -137,5 +137,20 @@ describe('LibreOfficeUtils', () => {
                 });
             });
         });
+
+        describe('Single page sheets', () => {
+            describe('when singlePageSheets parameter is set', () => {
+                it('should append singlePageSheets to data', () => {
+                    LibreOfficeUtils.addPageProperties(data, {
+                        singlePageSheets: true
+                    });
+                    expect(mockFormDataAppend).toHaveBeenCalledTimes(1);
+                    expect(data.append).toHaveBeenCalledWith(
+                        'singlePageSheets',
+                        'true'
+                    );
+                });
+            });
+        });
     });
 });

package/src/main.config.ts

@@ -38,6 +38,20 @@ export class Chromiumly {
      */
     public static readonly GOTENBERG_ENDPOINT = Gotenberg.endpoint;
 
+    /**
+     * The username for basic authentication with the Gotenberg service.
+     * @type {string | undefined}
+     */
+    public static readonly GOTENBERG_API_BASIC_AUTH_USERNAME =
+        Gotenberg.username;
+
+    /**
+     * The password for basic authentication with the Gotenberg service.
+     * @type {string | undefined}
+     */
+    public static readonly GOTENBERG_API_BASIC_AUTH_PASSWORD =
+        Gotenberg.password;
+
     /**
      * The path for Chromium-related conversions.
      * @type {string}

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

@@ -42,7 +42,12 @@ export class PDFEngines {
             metadata
         });
         const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.PDF_ENGINES_PATH}/${Chromiumly.PDF_ENGINE_ROUTES.merge}`;
-        return GotenbergUtils.fetch(endpoint, data);
+        return GotenbergUtils.fetch(
+            endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 
     /**
@@ -73,7 +78,12 @@ export class PDFEngines {
 
         const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.LIBRE_OFFICE_PATH}/${Chromiumly.LIBRE_OFFICE_ROUTES.convert}`;
 
-        return GotenbergUtils.fetch(endpoint, data);
+        return GotenbergUtils.fetch(
+            endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 
     /**
@@ -91,7 +101,12 @@ export class PDFEngines {
 
         const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.PDF_ENGINES_PATH}/${Chromiumly.PDF_ENGINE_ROUTES.readMetadata}`;
 
-        return GotenbergUtils.fetch(endpoint, data);
+        return GotenbergUtils.fetch(
+            endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 
     /**
@@ -115,7 +130,12 @@ export class PDFEngines {
 
         const endpoint = `${Chromiumly.GOTENBERG_ENDPOINT}/${Chromiumly.PDF_ENGINES_PATH}/${Chromiumly.PDF_ENGINE_ROUTES.writeMetadata}`;
 
-        return GotenbergUtils.fetch(endpoint, data);
+        return GotenbergUtils.fetch(
+            endpoint,
+            data,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME,
+            Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD
+        );
     }
 
     /**