chromiumly 2.7.0 → 2.9.0

package/README.md

@@ -11,6 +11,29 @@
 A lightweight Typescript library that interacts with [Gotenberg](https://gotenberg.dev/)'s different modules to convert
 a variety of document formats to PDF files.
 
+# Table of Contents
+
+1. [Introduction](#introduction)
+   - [Install](#install)
+   - [Prerequisites](#prerequisites)
+   - [Get Started](#get-started)
+2. [Configuration](#configuration)
+   - [dotenv](#dotenv)
+   - [config](#config)
+3. [Modules](#modules)
+   - [Chromium](#chromium)
+     - [URL](#url)
+     - [HTML](#html)
+     - [Markdown](#markdown)
+   - [Customization](#customization)
+     - [Conversion](#conversion)
+     - [Screenshot](#screenshot)
+   - [PDF Engine](#pdf-engine)
+     - [convert](#convert)
+     - [merge](#merge)
+     - [generate](#generate)
+4. [Snippet](#snippet)
+
 ## Install
 
 Using npm:
@@ -62,16 +85,18 @@ GOTENBERG_ENDPOINT=http://localhost:3000
 ## Modules
 
 Chromiumly introduces different classes that serve as wrappers to
-Gotenberg's [modules](https://gotenberg.dev/docs/modules/api#modules). These classes encompass methods featuring an
+Gotenberg's [routes](https://gotenberg.dev/docs/routes). These classes encompass methods featuring an
 input file parameter, such as `html`, `header`, `footer`, and `markdown`, capable of accepting inputs in the form of a
 `string` (i.e. file path), `Buffer`, or `ReadStream`.
 
 ### Chormium
 
 There are three different classes that come with a single method (i.e.`convert`) which calls one of
-Chromium's [routes](https://gotenberg.dev/docs/modules/chromium#routes) to convert `html` and `markdown` files, or
+Chromium's [Conversion routes](https://gotenberg.dev/docs/routes#convert-with-chromium) to convert `html` and `markdown` files, or
 a `url` to a `buffer` which contains the converted PDF file content.
 
+Similarly, a new set of classes have been added to harness the recently introduced Gotenberg [Screenshot routes](https://gotenberg.dev/docs/routes#screenshots-route). These classes include a single method called `capture`, which allows capturing full-page screenshots of `html`, `markdown`, and `url`.
+
 #### URL
 
 ```typescript
@@ -83,6 +108,15 @@ const buffer = await urlConverter.convert({
 });
 ```
 
+```typescript
+import { UrlScreenshot } from "chromiumly";
+
+const screenshot = new UrlScreenshot();
+const buffer = await screenshot.capture({
+  url: "https://www.example.com/",
+});
+```
+
 #### HTML
 
 The only requirement is that the file name should be `index.html`.
@@ -96,6 +130,15 @@ const buffer = await htmlConverter.convert({
 });
 ```
 
+```typescript
+import { HtmlScreenshot } from "chromiumly";
+
+const screenshot = new HtmlScreenshot();
+const buffer = await screenshot.capture({
+  html: "path/to/index.html",
+});
+```
+
 #### Markdown
 
 This route accepts an `index.html` file plus a markdown file.
@@ -110,8 +153,20 @@ const buffer = await markdownConverter.convert({
 });
 ```
 
+```typescript
+import { MarkdownScreenshot } from "chromiumly";
+
+const screenshot = new MarkdownScreenshot();
+const buffer = await screenshot.capture({
+  html: "path/to/index.html",
+  markdown: "path/to/file.md",
+});
+```
+
 ### Customization
 
+#### Conversion
+
 `convert()` method takes an optional `properties` parameter of the following type which dictates how the PDF generated
 file will look like.
 
@@ -154,20 +209,51 @@ type ConversionOptions = {
   failOnHttpStatusCodes?: number[]; // List of HTTP status codes triggering a 409 Conflict response (default [499, 599])
   failOnConsoleExceptions?: boolean; // Return a 409 Conflict response if there are exceptions in the Chromium console (default false)
   skipNetworkIdleEvent?: boolean; // Do not wait for Chromium network to be idle (default false)
+  metadata?: Metadata; // Metadata to be written.
+};
+```
+
+#### Screenshot
+
+Similarly, the `capture()` method takes an optional `properties` parameter of the specified type, influencing the appearance of the captured screenshot file.
+
+```typescript
+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.
+};
+```
+
+Furthermore, alongside the customization options offered by `ImageProperties`, the `capture()` method accommodates a variety of parameters to expand the versatility of the screenshot process. Below is a comprehensive overview of all parameters available:
+
+```typescript
+type ScreenshotOptions = {
+  properties?: ImageProperties;
+  header?: PathLikeOrReadStream;
+  footer?: PathLikeOrReadStream;
+  emulatedMediaType?: EmulatedMediaType;
+  waitDelay?: string; // Duration (e.g, '5s') to wait when loading an HTML document before convertion.
+  waitForExpression?: string; // JavaScript's expression to wait before converting an HTML document into PDF until it returns true.
+  extraHttpHeaders?: Record<string, string>;
+  failOnHttpStatusCodes?: number[]; // Return a 409 Conflict response if the HTTP status code is in the list (default [499,599])
+  failOnConsoleExceptions?: boolean; // Return a 409 Conflict response if there are exceptions in the Chromium console (default false)
+  skipNetworkIdleEvent?: boolean; // Do not wait for Chromium network to be idle (default false)
+  optimizeForSpeed?: boolean; // Define whether to optimize image encoding for speed, not for resulting size.
 };
 ```
 
 ### PDF Engine
 
-The `PDFEngine` combines the functionality of both
-Gotenberg's [PDF Engines](https://gotenberg.dev/docs/modules/pdf-engines)
-and [LibreOffice](https://gotenberg.dev/docs/modules/libreoffice) modules to manipulate different file formats.
+The `PDFEngine` combines the functionality of
+Gotenberg's [PDF Engines](https://gotenberg.dev/docs/routes#convert-into-pdfa--pdfua-route)
+and [LibreOffice](https://gotenberg.dev/docs/routes#convert-with-libreoffice) modules to manipulate different file formats.
 
 #### convert
 
-This method interacts with [LibreOffice](https://gotenberg.dev/docs/modules/libreoffice) module to convert different
+This method interacts with [LibreOffice](https://gotenberg.dev/docs/routes#convert-with-libreoffice) module to convert different
 documents to PDF files. You can find the file extensions
-accepted [here](https://gotenberg.dev/docs/modules/libreoffice#route).
+accepted [here](https://gotenberg.dev/docs/routes#convert-with-libreoffice#route).
 
 ```typescript
 import { PDFEngine } from "chromiumly";
@@ -185,7 +271,7 @@ Similarly to Chromium's module `convert` method, this method takes the following
 
 #### merge
 
-This method interacts with [PDF Engines](https://gotenberg.dev/docs/modules/pdf-engines) module which gathers different
+This method interacts with [PDF Engines](https://gotenberg.dev/docs/routes#merge-pdfs-route) module which gathers different
 engines that can manipulate and merge PDF files such
 as: [PDFtk](https://gitlab.com/pdftk-java/pdftk), [PDFcpu](https://github.com/pdfcpu/pdfcpu), [QPDF](https://github.com/qpdf/qpdf),
 and [UNO](https://github.com/unoconv/unoconv).
@@ -198,6 +284,41 @@ const buffer = await PDFEngine.merge({
 });
 ```
 
+#### readMetadata
+
+This method reads metadata from the provided PDF files.
+
+```typescript
+import { PDFEngine } from "chromiumly";
+
+const metadataBuffer = await PDFEngine.readMetadata([
+  "path/to/file_1.pdf",
+  "path/to/file_2.pdf",
+]);
+```
+
+#### writeMetadata
+
+This method writes metadata to the provided PDF files.
+
+```typescript
+import { PDFEngine } from "chromiumly";
+
+const buffer = await PDFEngine.writeMetadata({
+  files: [
+  "path/to/file_1.pdf",
+  "path/to/file_2.pdf",
+  ],
+  metadata: {
+    Author: 'Taha Cherfia',
+    Tite: 'Chromiumly'
+    Keywords: ['pdf', 'html', 'gotenberg'],
+  }
+});
+```
+
+Please consider referring to [ExifTool](https://exiftool.org/TagNames/XMP.html#pdf) for a comprehensive list of accessible metadata options.
+
 #### generate
 
 It is just a generic complementary method that takes the `buffer` returned by the `convert` method, and a

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

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { PathLikeOrReadStream, PdfFormat } from '../../common';
+import { Metadata, PathLikeOrReadStream, PdfFormat } from '../../common';
 import { PageProperties } from '../interfaces/converter.types';
 import { Converter } from './converter';
 import { EmulatedMediaType } from '../interfaces/common.types';
@@ -33,9 +33,10 @@ export declare class HtmlConverter extends Converter {
      * @param {number[]} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
      * @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.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
-    convert({ html, assets, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent }: {
+    convert({ html, assets, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, metadata }: {
         html: PathLikeOrReadStream;
         assets?: {
             file: PathLikeOrReadStream;
@@ -44,15 +45,24 @@ export declare class HtmlConverter extends Converter {
         header?: PathLikeOrReadStream;
         footer?: PathLikeOrReadStream;
         properties?: PageProperties;
+        /**
+         * @deprecated Starting from Gotenberg version 8.0.0, Chromium no longer provides support for pdfFormat.
+         * @see {@link https://github.com/gotenberg/gotenberg/releases/tag/v8.0.0}
+         */
         pdfFormat?: PdfFormat;
         pdfUA?: boolean;
         emulatedMediaType?: EmulatedMediaType;
         waitDelay?: string;
         waitForExpression?: string;
+        /**
+         * @deprecated Starting from Gotenberg version 8.0.0, Chromium no longer provides support for userAgent.
+         * @see {@link https://github.com/gotenberg/gotenberg/releases/tag/v8.0.0}
+         */
         userAgent?: string;
         extraHttpHeaders?: Record<string, string>;
         failOnHttpStatusCodes?: number[];
         failOnConsoleExceptions?: boolean;
         skipNetworkIdleEvent?: boolean;
+        metadata?: Metadata;
     }): Promise<Buffer>;
 }

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

@@ -39,10 +39,11 @@ class HtmlConverter extends converter_1.Converter {
      * @param {number[]} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
      * @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.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
-    convert({ html, assets, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent }) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+    convert(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ html, assets, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, metadata }) {
             const data = new form_data_1.default();
             yield common_1.GotenbergUtils.addFile(data, html, 'index.html');
             if (assets === null || assets === void 0 ? void 0 : assets.length) {
@@ -61,7 +62,8 @@ class HtmlConverter extends converter_1.Converter {
                 extraHttpHeaders,
                 failOnHttpStatusCodes,
                 failOnConsoleExceptions,
-                skipNetworkIdleEvent
+                skipNetworkIdleEvent,
+                metadata
             });
             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,kEAAiC;AAEjC,yCAA+E;AAE/E,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAGlD;;;;;GAKG;AACH,MAAa,aAAc,SAAQ,qBAAS;IACxC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACG,OAAO,CAAC,EACV,IAAI,EACJ,MAAM,EACN,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EAiBvB;;YACG,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAEvD,IAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,EAAE,CAAC;gBACjB,MAAM,OAAO,CAAC,GAAG,CACb,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAC1B,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAC3C,CACJ,CAAC;YACN,CAAC;YAED,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;gBACjC,MAAM;gBACN,MAAM;gBACN,UAAU;gBACV,SAAS;gBACT,KAAK;gBACL,iBAAiB;gBACjB,SAAS;gBACT,iBAAiB;gBACjB,SAAS;gBACT,gBAAgB;gBAChB,qBAAqB;gBACrB,uBAAuB;gBACvB,oBAAoB;aACvB,CAAC,CAAC;YAEH,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;KAAA;CACJ;AA5FD,sCA4FC"}
+{"version":3,"file":"html.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/html.converter.ts"],"names":[],"mappings":";;;;AAAA,kEAAiC;AAEjC,yCAKsB;AAEtB,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAGlD;;;;;GAKG;AACH,MAAa,aAAc,SAAQ,qBAAS;IACxC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,OAAO;qEAAC,EACV,IAAI,EACJ,MAAM,EACN,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EA0BX;YACG,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAEvD,IAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,EAAE,CAAC;gBACjB,MAAM,OAAO,CAAC,GAAG,CACb,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAC1B,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAC3C,CACJ,CAAC;YACN,CAAC;YAED,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;gBACjC,MAAM;gBACN,MAAM;gBACN,UAAU;gBACV,SAAS;gBACT,KAAK;gBACL,iBAAiB;gBACjB,SAAS;gBACT,iBAAiB;gBACjB,SAAS;gBACT,gBAAgB;gBAChB,qBAAqB;gBACrB,uBAAuB;gBACvB,oBAAoB;gBACpB,QAAQ;aACX,CAAC,CAAC;YAEH,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;KAAA;CACJ;AAxGD,sCAwGC"}

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

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { PdfFormat, PathLikeOrReadStream } from '../../common';
+import { PdfFormat, PathLikeOrReadStream, Metadata } from '../../common';
 import { PageProperties } from '../interfaces/converter.types';
 import { Converter } from './converter';
 import { EmulatedMediaType } from '../interfaces/common.types';
@@ -34,23 +34,33 @@ export declare class MarkdownConverter extends Converter {
      * @param {number []} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
      * @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.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
-    convert({ html, markdown, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent }: {
+    convert({ html, markdown, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, metadata }: {
         html: PathLikeOrReadStream;
         markdown: PathLikeOrReadStream;
         header?: PathLikeOrReadStream;
         footer?: PathLikeOrReadStream;
         properties?: PageProperties;
+        /**
+         * @deprecated Starting from Gotenberg version 8.0.0, Chromium no longer provides support for pdfFormat.
+         * @see {@link https://github.com/gotenberg/gotenberg/releases/tag/v8.0.0}
+         */
         pdfFormat?: PdfFormat;
         pdfUA?: boolean;
         emulatedMediaType?: EmulatedMediaType;
         waitDelay?: string;
         waitForExpression?: string;
+        /**
+         * @deprecated Starting from Gotenberg version 8.0.0, Chromium no longer provides support for userAgent.
+         * @see {@link https://github.com/gotenberg/gotenberg/releases/tag/v8.0.0}
+         */
         userAgent?: string;
         extraHttpHeaders?: Record<string, string>;
         failOnHttpStatusCodes?: number[];
         failOnConsoleExceptions?: boolean;
         skipNetworkIdleEvent?: boolean;
+        metadata?: Metadata;
     }): Promise<Buffer>;
 }

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

@@ -40,10 +40,11 @@ class MarkdownConverter extends converter_1.Converter {
      * @param {number []} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
      * @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.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
-    convert({ html, markdown, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent }) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+    convert(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ html, markdown, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, metadata }) {
             const data = new form_data_1.default();
             yield common_1.GotenbergUtils.addFile(data, html, 'index.html');
             yield common_1.GotenbergUtils.addFile(data, markdown, 'file.md');
@@ -60,7 +61,8 @@ class MarkdownConverter extends converter_1.Converter {
                 extraHttpHeaders,
                 failOnHttpStatusCodes,
                 failOnConsoleExceptions,
-                skipNetworkIdleEvent
+                skipNetworkIdleEvent,
+                metadata
             });
             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,kEAAiC;AAEjC,yCAA+E;AAE/E,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAGlD;;;;;GAKG;AACH,MAAa,iBAAkB,SAAQ,qBAAS;IAC5C;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,OAAO,CAAC,EACV,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EAiBvB;;YACG,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAEvD,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAExD,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;gBACjC,MAAM;gBACN,MAAM;gBACN,UAAU;gBACV,SAAS;gBACT,KAAK;gBACL,iBAAiB;gBACjB,SAAS;gBACT,iBAAiB;gBACjB,SAAS;gBACT,gBAAgB;gBAChB,qBAAqB;gBACrB,uBAAuB;gBACvB,oBAAoB;aACvB,CAAC,CAAC;YAEH,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;KAAA;CACJ;AAvFD,8CAuFC"}
+{"version":3,"file":"markdown.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/markdown.converter.ts"],"names":[],"mappings":";;;;AAAA,kEAAiC;AAEjC,yCAKsB;AAEtB,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAGlD;;;;;GAKG;AACH,MAAa,iBAAkB,SAAQ,qBAAS;IAC5C;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,OAAO;qEAAC,EACV,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EA0BX;YACG,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAEvD,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAExD,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;gBACjC,MAAM;gBACN,MAAM;gBACN,UAAU;gBACV,SAAS;gBACT,KAAK;gBACL,iBAAiB;gBACjB,SAAS;gBACT,iBAAiB;gBACjB,SAAS;gBACT,gBAAgB;gBAChB,qBAAqB;gBACrB,uBAAuB;gBACvB,oBAAoB;gBACpB,QAAQ;aACX,CAAC,CAAC;YAEH,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;KAAA;CACJ;AAnGD,8CAmGC"}

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

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { PdfFormat, PathLikeOrReadStream } from '../../common';
+import { PdfFormat, PathLikeOrReadStream, Metadata } from '../../common';
 import { PageProperties } from '../interfaces/converter.types';
 import { Converter } from './converter';
 import { EmulatedMediaType } from '../interfaces/common.types';
@@ -33,22 +33,32 @@ export declare class UrlConverter extends Converter {
      * @param {number[]} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
      * @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.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
-    convert({ url, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent }: {
+    convert({ url, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, metadata }: {
         url: string;
         header?: PathLikeOrReadStream;
         footer?: PathLikeOrReadStream;
         properties?: PageProperties;
+        /**
+         * @deprecated Starting from Gotenberg version 8.0.0, Chromium no longer provides support for pdfFormat.
+         * @see {@link https://github.com/gotenberg/gotenberg/releases/tag/v8.0.0}
+         */
         pdfFormat?: PdfFormat;
         pdfUA?: boolean;
         emulatedMediaType?: EmulatedMediaType;
         waitDelay?: string;
         waitForExpression?: string;
+        /**
+         * @deprecated Starting from Gotenberg version 8.0.0, Chromium no longer provides support for userAgent.
+         * @see {@link https://github.com/gotenberg/gotenberg/releases/tag/v8.0.0}
+         */
         userAgent?: string;
         extraHttpHeaders?: Record<string, string>;
         failOnHttpStatusCodes?: number[];
         failOnConsoleExceptions?: boolean;
         skipNetworkIdleEvent?: boolean;
+        metadata?: Metadata;
     }): Promise<Buffer>;
 }

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

@@ -40,10 +40,11 @@ class UrlConverter extends converter_1.Converter {
      * @param {number[]} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
      * @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.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a Buffer.
      */
-    convert({ url, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent }) {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+    convert(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ url, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, metadata }) {
             const _url = new url_1.URL(url);
             const data = new form_data_1.default();
             data.append('url', _url.href);
@@ -60,7 +61,8 @@ class UrlConverter extends converter_1.Converter {
                 extraHttpHeaders,
                 failOnHttpStatusCodes,
                 failOnConsoleExceptions,
-                skipNetworkIdleEvent
+                skipNetworkIdleEvent,
+                metadata
             });
             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;AAC1B,kEAAiC;AACjC,yCAA+E;AAE/E,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAGlD;;;;;GAKG;AACH,MAAa,YAAa,SAAQ,qBAAS;IACvC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACG,OAAO,CAAC,EACV,GAAG,EACH,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EAgBvB;;YACG,MAAM,IAAI,GAAG,IAAI,SAAG,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAE5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAE9B,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;gBACjC,MAAM;gBACN,MAAM;gBACN,UAAU;gBACV,SAAS;gBACT,KAAK;gBACL,iBAAiB;gBACjB,SAAS;gBACT,iBAAiB;gBACjB,SAAS;gBACT,gBAAgB;gBAChB,qBAAqB;gBACrB,uBAAuB;gBACvB,oBAAoB;aACvB,CAAC,CAAC;YAEH,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;KAAA;CACJ;AAnFD,oCAmFC"}
+{"version":3,"file":"url.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/url.converter.ts"],"names":[],"mappings":";;;;AAAA,6BAA0B;AAC1B,kEAAiC;AACjC,yCAKsB;AAEtB,8DAA0D;AAC1D,2CAAwC;AACxC,mDAAkD;AAGlD;;;;;GAKG;AACH,MAAa,YAAa,SAAQ,qBAAS;IACvC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,OAAO;qEAAC,EACV,GAAG,EACH,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EAyBX;YACG,MAAM,IAAI,GAAG,IAAI,SAAG,CAAC,GAAG,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAE5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAE9B,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;gBACjC,MAAM;gBACN,MAAM;gBACN,UAAU;gBACV,SAAS;gBACT,KAAK;gBACL,iBAAiB;gBACjB,SAAS;gBACT,iBAAiB;gBACjB,SAAS;gBACT,gBAAgB;gBAChB,qBAAqB;gBACrB,uBAAuB;gBACvB,oBAAoB;gBACpB,QAAQ;aACX,CAAC,CAAC;YAEH,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;KAAA;CACJ;AA/FD,oCA+FC"}

package/dist/chromium/index.d.ts

@@ -1,3 +1,6 @@
+export { UrlScreenshot } from './screenshots/url.screenshot';
+export { MarkdownScreenshot } from './screenshots/markdown.screenshot';
+export { HtmlScreenshot } from './screenshots/html.screenshot';
 export { HtmlConverter } from './converters/html.converter';
 export { MarkdownConverter } from './converters/markdown.converter';
 export { UrlConverter } from './converters/url.converter';

package/dist/chromium/index.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UrlConverter = exports.MarkdownConverter = exports.HtmlConverter = void 0;
+exports.UrlConverter = exports.MarkdownConverter = exports.HtmlConverter = exports.HtmlScreenshot = exports.MarkdownScreenshot = exports.UrlScreenshot = void 0;
+var url_screenshot_1 = require("./screenshots/url.screenshot");
+Object.defineProperty(exports, "UrlScreenshot", { enumerable: true, get: function () { return url_screenshot_1.UrlScreenshot; } });
+var markdown_screenshot_1 = require("./screenshots/markdown.screenshot");
+Object.defineProperty(exports, "MarkdownScreenshot", { enumerable: true, get: function () { return markdown_screenshot_1.MarkdownScreenshot; } });
+var html_screenshot_1 = require("./screenshots/html.screenshot");
+Object.defineProperty(exports, "HtmlScreenshot", { enumerable: true, get: function () { return html_screenshot_1.HtmlScreenshot; } });
 var html_converter_1 = require("./converters/html.converter");
 Object.defineProperty(exports, "HtmlConverter", { enumerable: true, get: function () { return html_converter_1.HtmlConverter; } });
 var markdown_converter_1 = require("./converters/markdown.converter");

package/dist/chromium/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chromium/index.ts"],"names":[],"mappings":";;;AAAA,8DAA4D;AAAnD,+GAAA,aAAa,OAAA;AACtB,sEAAoE;AAA3D,uHAAA,iBAAiB,OAAA;AAC1B,4DAA0D;AAAjD,6GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chromium/index.ts"],"names":[],"mappings":";;;AAAA,+DAA6D;AAApD,+GAAA,aAAa,OAAA;AACtB,yEAAuE;AAA9D,yHAAA,kBAAkB,OAAA;AAC3B,iEAA+D;AAAtD,iHAAA,cAAc,OAAA;AACvB,8DAA4D;AAAnD,+GAAA,aAAa,OAAA;AACtB,sEAAoE;AAA3D,uHAAA,iBAAiB,OAAA;AAC1B,4DAA0D;AAAjD,6GAAA,YAAY,OAAA"}

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

@@ -1,4 +1,4 @@
-import { PdfFormat } from '../../common';
+import { Metadata, PdfFormat } from '../../common';
 import { ChromiumOptions } from './common.types';
 type PageSize = {
     width: number;
@@ -29,5 +29,6 @@ export type ConversionOptions = ChromiumOptions & {
     pdfFormat?: PdfFormat;
     pdfUA?: boolean;
     userAgent?: string;
+    metadata?: Metadata;
 };
 export {};

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

@@ -0,0 +1,10 @@
+import { ChromiumOptions } from './common.types';
+export type ImageProperties = {
+    format: 'png' | 'jpeg' | 'webp';
+    quality?: number;
+    omitBackground?: boolean;
+};
+export type ScreenshotOptions = ChromiumOptions & {
+    properties?: ImageProperties;
+    optimizeForSpeed?: boolean;
+};

package/dist/chromium/interfaces/screenshot.types.js

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

package/dist/chromium/interfaces/screenshot.types.js.map

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

package/dist/chromium/screenshots/html.screenshot.d.ts

@@ -0,0 +1,54 @@
+/// <reference types="node" />
+import { PathLikeOrReadStream } from '../../common';
+import { EmulatedMediaType } from '../interfaces/common.types';
+import { Screenshot } from './screenshot';
+import { ImageProperties } from '../interfaces/screenshot.types';
+/**
+ * Class representing an HTML Screenshot that extends the base Screenshot class.
+ * This class is used to screenshot HTML content using Gotenberg service.
+ *
+ * @extends Screenshot
+ */
+export declare class HtmlScreenshot extends Screenshot {
+    /**
+     * Creates an instance of HtmlScreenshot.
+     * Initializes the Screenshot with the HTML screenshot route.
+     */
+    constructor();
+    /**
+     * Screenshots HTML content.
+     *
+     * @param {Object} options - Screenshot options.
+     * @param {PathLikeOrReadStream} options.html - PathLike or ReadStream of the HTML content to be screenshoted.
+     * @param {PathLikeOrReadStream} [options.header] - PathLike or ReadStream of the header HTML content.
+     * @param {PathLikeOrReadStream} [options.footer] - PathLike or ReadStream of the footer HTML content.
+     * @param {ImageProperties} [options.properties] - Image properties for the screenshot.
+     * @param {EmulatedMediaType} [options.emulatedMediaType] - Emulated media type for the screenshot.
+     * @param {string} [options.waitDelay] - Delay before the screenshot process starts.
+     * @param {string} [options.waitForExpression] - JavaScript expression to wait for before completing the screenshot.
+     * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the screenshot.
+     * @param {number []} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
+     * @param {boolean} [options.failOnConsoleExceptions] - Whether to fail on console exceptions during screenshot.
+     * @param {boolean} [options.skipNetworkIdleEvent] - Whether to skip network idle event.
+     * @param {boolean} [options.optimizeForSpeed] - Whether to optimize for speed.
+     * @returns {Promise<Buffer>} A Promise resolving to the image buffer.
+     */
+    capture({ html, assets, header, footer, properties, emulatedMediaType, waitDelay, waitForExpression, extraHttpHeaders, failOnConsoleExceptions, failOnHttpStatusCodes, skipNetworkIdleEvent, optimizeForSpeed }: {
+        html: PathLikeOrReadStream;
+        assets?: {
+            file: PathLikeOrReadStream;
+            name: string;
+        }[];
+        header?: PathLikeOrReadStream;
+        footer?: PathLikeOrReadStream;
+        properties?: ImageProperties;
+        emulatedMediaType?: EmulatedMediaType;
+        waitDelay?: string;
+        waitForExpression?: string;
+        extraHttpHeaders?: Record<string, string>;
+        failOnConsoleExceptions?: boolean;
+        failOnHttpStatusCodes?: number[];
+        skipNetworkIdleEvent?: boolean;
+        optimizeForSpeed?: boolean;
+    }): Promise<Buffer>;
+}

package/dist/chromium/screenshots/html.screenshot.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HtmlScreenshot = void 0;
+const tslib_1 = require("tslib");
+const form_data_1 = tslib_1.__importDefault(require("form-data"));
+const common_1 = require("../../common");
+const main_config_1 = require("../../main.config");
+const screenshot_utils_1 = require("../utils/screenshot.utils");
+const screenshot_1 = require("./screenshot");
+/**
+ * Class representing an HTML Screenshot that extends the base Screenshot class.
+ * This class is used to screenshot HTML content using Gotenberg service.
+ *
+ * @extends Screenshot
+ */
+class HtmlScreenshot extends screenshot_1.Screenshot {
+    /**
+     * Creates an instance of HtmlScreenshot.
+     * Initializes the Screenshot with the HTML screenshot route.
+     */
+    constructor() {
+        super(main_config_1.ChromiumRoute.HTML);
+    }
+    /**
+     * Screenshots HTML content.
+     *
+     * @param {Object} options - Screenshot options.
+     * @param {PathLikeOrReadStream} options.html - PathLike or ReadStream of the HTML content to be screenshoted.
+     * @param {PathLikeOrReadStream} [options.header] - PathLike or ReadStream of the header HTML content.
+     * @param {PathLikeOrReadStream} [options.footer] - PathLike or ReadStream of the footer HTML content.
+     * @param {ImageProperties} [options.properties] - Image properties for the screenshot.
+     * @param {EmulatedMediaType} [options.emulatedMediaType] - Emulated media type for the screenshot.
+     * @param {string} [options.waitDelay] - Delay before the screenshot process starts.
+     * @param {string} [options.waitForExpression] - JavaScript expression to wait for before completing the screenshot.
+     * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the screenshot.
+     * @param {number []} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
+     * @param {boolean} [options.failOnConsoleExceptions] - Whether to fail on console exceptions during screenshot.
+     * @param {boolean} [options.skipNetworkIdleEvent] - Whether to skip network idle event.
+     * @param {boolean} [options.optimizeForSpeed] - Whether to optimize for speed.
+     * @returns {Promise<Buffer>} A Promise resolving to the image buffer.
+     */
+    capture(_a) {
+        return tslib_1.__awaiter(this, arguments, void 0, function* ({ html, assets, header, footer, properties, emulatedMediaType, waitDelay, waitForExpression, extraHttpHeaders, failOnConsoleExceptions, failOnHttpStatusCodes, skipNetworkIdleEvent, optimizeForSpeed }) {
+            const data = new form_data_1.default();
+            yield common_1.GotenbergUtils.addFile(data, html, 'index.html');
+            if (assets === null || assets === void 0 ? void 0 : assets.length) {
+                yield Promise.all(assets.map(({ file, name }) => common_1.GotenbergUtils.addFile(data, file, name)));
+            }
+            yield screenshot_utils_1.ScreenshotUtils.customize(data, {
+                header,
+                footer,
+                properties,
+                emulatedMediaType,
+                waitDelay,
+                waitForExpression,
+                extraHttpHeaders,
+                failOnHttpStatusCodes,
+                failOnConsoleExceptions,
+                skipNetworkIdleEvent,
+                optimizeForSpeed
+            });
+            return common_1.GotenbergUtils.fetch(this.endpoint, data);
+        });
+    }
+}
+exports.HtmlScreenshot = HtmlScreenshot;
+//# sourceMappingURL=html.screenshot.js.map

package/dist/chromium/screenshots/html.screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.screenshot.js","sourceRoot":"","sources":["../../../src/chromium/screenshots/html.screenshot.ts"],"names":[],"mappings":";;;;AAAA,kEAAiC;AAEjC,yCAAoE;AACpE,mDAAkD;AAElD,gEAA4D;AAC5D,6CAA0C;AAG1C;;;;;GAKG;AACH,MAAa,cAAe,SAAQ,uBAAU;IAC1C;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO;qEAAC,EACV,IAAI,EACJ,MAAM,EACN,MAAM,EACN,MAAM,EACN,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAenB;YACG,MAAM,IAAI,GAAG,IAAI,mBAAQ,EAAE,CAAC;YAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAEvD,IAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,MAAM,EAAE,CAAC;gBACjB,MAAM,OAAO,CAAC,GAAG,CACb,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAC1B,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAC3C,CACJ,CAAC;YACN,CAAC;YAED,MAAM,kCAAe,CAAC,SAAS,CAAC,IAAI,EAAE;gBAClC,MAAM;gBACN,MAAM;gBACN,UAAU;gBACV,iBAAiB;gBACjB,SAAS;gBACT,iBAAiB;gBACjB,gBAAgB;gBAChB,qBAAqB;gBACrB,uBAAuB;gBACvB,oBAAoB;gBACpB,gBAAgB;aACnB,CAAC,CAAC;YAEH,OAAO,uBAAc,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;KAAA;CACJ;AApFD,wCAoFC"}