chromiumly 3.0.1 → 3.2.0

package/dist/main.config.d.ts

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

package/dist/main.config.js

@@ -41,6 +41,16 @@ exports.Chromiumly = Chromiumly;
  * @type {string}
  */
 Chromiumly.GOTENBERG_ENDPOINT = gotenberg_1.Gotenberg.endpoint;
+/**
+ * The username for basic authentication with the Gotenberg service.
+ * @type {string | undefined}
+ */
+Chromiumly.GOTENBERG_API_BASIC_AUTH_USERNAME = gotenberg_1.Gotenberg.username;
+/**
+ * The password for basic authentication with the Gotenberg service.
+ * @type {string | undefined}
+ */
+Chromiumly.GOTENBERG_API_BASIC_AUTH_PASSWORD = gotenberg_1.Gotenberg.password;
 /**
  * The path for Chromium-related conversions.
  * @type {string}

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;;;GAGG;AACH,IAAY,aAIX;AAJD,WAAY,aAAa;IACrB,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,sCAAqB,CAAA;AACzB,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAED;;;GAGG;AACH,IAAK,cAIJ;AAJD,WAAK,cAAc;IACf,iCAAe,CAAA;IACf,iDAA+B,CAAA;IAC/B,mDAAiC,CAAA;AACrC,CAAC,EAJI,cAAc,KAAd,cAAc,QAIlB;AAED;;;GAGG;AACH,IAAK,gBAEJ;AAFD,WAAK,gBAAgB;IACjB,uCAAmB,CAAA;AACvB,CAAC,EAFI,gBAAgB,KAAhB,gBAAgB,QAEpB;AAED;;GAEG;AACH,MAAa,UAAU;;AAAvB,gCA0DC;AAzDG;;;GAGG;AACoB,6BAAkB,GAAG,qBAAS,CAAC,QAAQ,CAAC;AAE/D;;;GAGG;AACoB,gCAAqB,GAAG,wBAAwB,CAAC;AAExE;;;GAGG;AACoB,mCAAwB,GAC3C,2BAA2B,CAAC;AAChC;;;GAGG;AACoB,2BAAgB,GAAG,kBAAkB,CAAC;AAE7D;;;GAGG;AACoB,4BAAiB,GAAG,mBAAmB,CAAC;AAE/D;;;GAGG;AACoB,0BAAe,GAAG;IACrC,GAAG,EAAE,aAAa,CAAC,GAAG;IACtB,IAAI,EAAE,aAAa,CAAC,IAAI;IACxB,QAAQ,EAAE,aAAa,CAAC,QAAQ;CACnC,CAAC;AAEF;;;GAGG;AACoB,4BAAiB,GAAG;IACvC,KAAK,EAAE,cAAc,CAAC,KAAK;IAC3B,YAAY,EAAE,cAAc,CAAC,aAAa;IAC1C,aAAa,EAAE,cAAc,CAAC,cAAc;CAC/C,CAAC;AAEF;;;GAGG;AACoB,8BAAmB,GAAG;IACzC,OAAO,EAAE,gBAAgB,CAAC,OAAO;CACpC,CAAC"}
+{"version":3,"file":"main.config.js","sourceRoot":"","sources":["../src/main.config.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAExC;;;GAGG;AACH,IAAY,aAIX;AAJD,WAAY,aAAa;IACrB,4BAAW,CAAA;IACX,8BAAa,CAAA;IACb,sCAAqB,CAAA;AACzB,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB;AAED;;;GAGG;AACH,IAAK,cAIJ;AAJD,WAAK,cAAc;IACf,iCAAe,CAAA;IACf,iDAA+B,CAAA;IAC/B,mDAAiC,CAAA;AACrC,CAAC,EAJI,cAAc,KAAd,cAAc,QAIlB;AAED;;;GAGG;AACH,IAAK,gBAEJ;AAFD,WAAK,gBAAgB;IACjB,uCAAmB,CAAA;AACvB,CAAC,EAFI,gBAAgB,KAAhB,gBAAgB,QAEpB;AAED;;GAEG;AACH,MAAa,UAAU;;AAAvB,gCAwEC;AAvEG;;;GAGG;AACoB,6BAAkB,GAAG,qBAAS,CAAC,QAAQ,CAAC;AAE/D;;;GAGG;AACoB,4CAAiC,GACpD,qBAAS,CAAC,QAAQ,CAAC;AAEvB;;;GAGG;AACoB,4CAAiC,GACpD,qBAAS,CAAC,QAAQ,CAAC;AAEvB;;;GAGG;AACoB,gCAAqB,GAAG,wBAAwB,CAAC;AAExE;;;GAGG;AACoB,mCAAwB,GAC3C,2BAA2B,CAAC;AAChC;;;GAGG;AACoB,2BAAgB,GAAG,kBAAkB,CAAC;AAE7D;;;GAGG;AACoB,4BAAiB,GAAG,mBAAmB,CAAC;AAE/D;;;GAGG;AACoB,0BAAe,GAAG;IACrC,GAAG,EAAE,aAAa,CAAC,GAAG;IACtB,IAAI,EAAE,aAAa,CAAC,IAAI;IACxB,QAAQ,EAAE,aAAa,CAAC,QAAQ;CACnC,CAAC;AAEF;;;GAGG;AACoB,4BAAiB,GAAG;IACvC,KAAK,EAAE,cAAc,CAAC,KAAK;IAC3B,YAAY,EAAE,cAAc,CAAC,aAAa;IAC1C,aAAa,EAAE,cAAc,CAAC,cAAc;CAC/C,CAAC;AAEF;;;GAGG;AACoB,8BAAmB,GAAG;IACzC,OAAO,EAAE,gBAAgB,CAAC,OAAO;CACpC,CAAC"}

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.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",
@@ -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.7.1",
+    "@typescript-eslint/parser": "7.7.1",
     "commitizen": "4.3.0",
     "eslint": "8.57.0",
     "eslint-config-prettier": "^9.1.0",
@@ -63,11 +63,11 @@
     "jest-junit": "16.0.0",
     "lint-staged": "^15.2.2",
     "prettier": "3.2.5",
-    "release-it": "17.1.1",
+    "release-it": "17.2.1",
     "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/interfaces/screenshot.types.ts

@@ -4,6 +4,9 @@ export type ImageProperties = {
     format: 'png' | 'jpeg' | 'webp'; //The image compression format, either "png", "jpeg" or "webp".
     quality?: number; // The compression quality from range 0 to 100 (jpeg only).
     omitBackground?: boolean; // Hide the default white background and allow generating screenshots with transparency.
+    width?: number; // The device screen width in pixels (default 800).
+    height?: number; // The device screen height in pixels (default 600).
+    clip?: boolean; // Define whether to clip the screenshot according to the device dimensions (default false).
 };
 
 export type ScreenshotOptions = ChromiumOptions & {

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/screenshot.utils.ts

@@ -41,6 +41,18 @@ export class ScreenshotUtils {
                 String(imageProperties.omitBackground)
             );
         }
+
+        if (imageProperties.width) {
+            data.append('width', imageProperties.width);
+        }
+
+        if (imageProperties.height) {
+            data.append('height', imageProperties.height);
+        }
+
+        if (imageProperties.clip) {
+            data.append('clip', String(imageProperties.clip));
+        }
     }
 
     /**

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/chromium/utils/tests/screenshot.utils.test.ts

@@ -42,8 +42,8 @@ describe('GotenbergUtils', () => {
         });
 
         describe('Image quality', () => {
-            describe('when omitBackground parameter is set', () => {
-                it('should append omitBackground to data', () => {
+            describe('when quality parameter is set', () => {
+                it('should append quality to data', () => {
                     ScreenshotUtils.addImageProperties(data, {
                         format: 'jpeg',
                         quality: 50
@@ -58,6 +58,60 @@ describe('GotenbergUtils', () => {
                 });
             });
         });
+
+        describe('Image width', () => {
+            describe('when width parameter is set', () => {
+                it('should append width to data', () => {
+                    ScreenshotUtils.addImageProperties(data, {
+                        format: 'jpeg',
+                        width: 800
+                    });
+                    expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+                    expect(data.append).toHaveBeenCalledWith('format', 'jpeg');
+                    expect(data.append).toHaveBeenNthCalledWith(
+                        2,
+                        'width',
+                        800
+                    );
+                });
+            });
+        });
+
+        describe('Image height', () => {
+            describe('when height parameter is set', () => {
+                it('should append height to data', () => {
+                    ScreenshotUtils.addImageProperties(data, {
+                        format: 'jpeg',
+                        height: 600
+                    });
+                    expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+                    expect(data.append).toHaveBeenCalledWith('format', 'jpeg');
+                    expect(data.append).toHaveBeenNthCalledWith(
+                        2,
+                        'height',
+                        600
+                    );
+                });
+            });
+        });
+
+        describe('Image clip', () => {
+            describe('when clip parameter is set', () => {
+                it('should append clip to data', () => {
+                    ScreenshotUtils.addImageProperties(data, {
+                        format: 'png',
+                        clip: true
+                    });
+                    expect(mockFormDataAppend).toHaveBeenCalledTimes(2);
+                    expect(data.append).toHaveBeenCalledWith('format', 'png');
+                    expect(data.append).toHaveBeenNthCalledWith(
+                        2,
+                        'clip',
+                        'true'
+                    );
+                });
+            });
+        });
     });
 
     describe('customize', () => {

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