chromiumly 4.1.6 → 4.2.2

package/README.md

@@ -35,6 +35,9 @@ a variety of document formats to PDF files.
      - [Metadata Management](#metadata-management)
      - [File Generation](#file-generation)
    - [PDF Splitting](#pdf-splitting)
+   - [PDF Flattening](#pdf-flattening)
+   - [PDF Encryption](#pdf-encryption)
+   - [Embedding Files](#embedding-files)
 4. [Usage Example](#snippet)
 
 ## Getting Started
@@ -278,6 +281,7 @@ type ConversionOptions = {
   emulatedMediaType?: EmulatedMediaType; // Specify the emulated media type for conversion
   waitDelay?: string; // Duration (e.g., '5s') to wait when loading an HTML document before conversion
   waitForExpression?: string; // JavaScript expression to wait before converting an HTML document into PDF
+  waitForSelector?: string; // CSS selector to wait for before converting an HTML document into PDF until it matches a node
   extraHttpHeaders?: Record<string, string>; // Include additional HTTP headers in the request
   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)
@@ -286,6 +290,9 @@ type ConversionOptions = {
   cookies?: Cookie[]; // Cookies to be written.
   downloadFrom?: DownloadFrom; //Download a file from a URL. It must return a Content-Disposition header with a filename parameter.
   split?: SplitOptions; // Split the PDF file into multiple files.
+  userPassword?: string; // Password for opening the resulting PDF(s).
+  ownerPassword?: string; // Password for full access on the resulting PDF(s).
+  embeds?: PathLikeOrReadStream[]; // Files to embed in the generated PDF.
 };
 ```
 
@@ -314,6 +321,7 @@ type ScreenshotOptions = {
   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.
+  waitForSelector?: string; // CSS selector to wait for before converting an HTML document into PDF until it matches a node.
   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)
@@ -321,6 +329,9 @@ type ScreenshotOptions = {
   optimizeForSpeed?: boolean; // Define whether to optimize image encoding for speed, not for resulting size.
   cookies?: Cookie[]; // Cookies to be written.
   downloadFrom?: DownloadFrom; // Download the file from a specific URL. It must return a Content-Disposition header with a filename parameter.
+  userPassword?: string; // Password for opening the resulting PDF(s).
+  ownerPassword?: string; // Password for full access on the resulting PDF(s).
+  embeds?: PathLikeOrReadStream[]; // Files to embed in the generated PDF.
 };
 ```
 
@@ -353,6 +364,9 @@ Similarly to Chromium's route `convert` method, this method takes the following
 - `quality`: specifies the quality of the JPG export. The value ranges from 1 to 100, with higher values producing higher-quality images and larger file sizes.
 - `maxImageResolution`: specifies if all images will be reduced to the specified DPI value. Possible values are: `75`, `150`, `300`, `600`, and `1200`.
 - `flatten`: a boolean that, when set to true, flattens the split PDF files, making form fields and annotations uneditable.
+- `userPassword`: password for opening the resulting PDF(s).
+- `ownerPassword`: password for full access on the resulting PDF(s).
+- `embeds`: files to embed in the generated PDF (repeatable). This feature enables the creation of PDFs compatible with standards like [ZUGFeRD / Factur-X](https://fnfe-mpe.org/factur-x/), which require embedding XML invoices and other files within the PDF.
 
 ### PDF Engines
 
@@ -483,6 +497,42 @@ const buffer = await PDFEngines.flatten({
 });
 ```
 
+### PDF Encryption
+
+Each [Chromium](#chromium) and [LibreOffice](#libreoffice) route supports PDF encryption through the `userPassword` and `ownerPassword` parameters. The `userPassword` is required to open the PDF, while the `ownerPassword` provides full access permissions.
+
+```typescript
+import { UrlConverter } from "chromiumly";
+
+const buffer = await UrlConverter.convert({
+  url: "https://www.example.com/",
+  userPassword: "my_user_password",
+  ownerPassword: "my_owner_password",
+});
+```
+
+### Embedding Files
+
+Each [Chromium](#chromium) and [LibreOffice](#libreoffice) route supports embedding files into the generated PDF through the `embeds` parameter. This feature enables the creation of PDFs compatible with standards like [ZUGFeRD / Factur-X](https://fnfe-mpe.org/factur-x/), which require embedding XML invoices and other files within the PDF.
+
+You can embed multiple files by passing an array of file paths, buffers, or read streams:
+
+```typescript
+import { HtmlConverter } from "chromiumly";
+
+const htmlConverter = new HtmlConverter();
+const buffer = await htmlConverter.convert({
+  html: "path/to/index.html",
+  embeds: [
+    "path/to/invoice.xml",
+    "path/to/logo.png",
+    Buffer.from("additional data"),
+  ],
+});
+```
+
+All embedded files will be attached to the generated PDF and can be extracted using PDF readers that support file attachments.
+
 ## Snippet
 
 The following is a short snippet of how to use the library.

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

@@ -25,6 +25,7 @@ export declare class HtmlConverter extends Converter {
      * @param {EmulatedMediaType} [options.emulatedMediaType] - Emulated media type for the conversion.
      * @param {string} [options.waitDelay] - Delay before the conversion process starts.
      * @param {string} [options.waitForExpression] - JavaScript expression to wait for before completing the conversion.
+     * @param {string} [options.waitForSelector] - CSS selector to wait for before completing the conversion.
      * @param {string} [options.userAgent] - User agent string to use during the conversion.
      * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the conversion.
      * @param {number[]} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
@@ -39,5 +40,5 @@ export declare class HtmlConverter extends Converter {
      * @param {Split} [options.split] - Split the PDF into multiple files.
      * @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, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, generateDocumentOutline, metadata, cookies, downloadFrom, split }: HtmlConversionOptions): Promise<Buffer>;
+    convert({ html, assets, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, generateDocumentOutline, metadata, cookies, downloadFrom, split, userPassword, ownerPassword, embeds }: HtmlConversionOptions): Promise<Buffer>;
 }

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

@@ -32,6 +32,7 @@ class HtmlConverter extends converter_1.Converter {
      * @param {EmulatedMediaType} [options.emulatedMediaType] - Emulated media type for the conversion.
      * @param {string} [options.waitDelay] - Delay before the conversion process starts.
      * @param {string} [options.waitForExpression] - JavaScript expression to wait for before completing the conversion.
+     * @param {string} [options.waitForSelector] - CSS selector to wait for before completing the conversion.
      * @param {string} [options.userAgent] - User agent string to use during the conversion.
      * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the conversion.
      * @param {number[]} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
@@ -46,7 +47,7 @@ class HtmlConverter extends converter_1.Converter {
      * @param {Split} [options.split] - Split the PDF into multiple files.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a buffer
      */
-    async convert({ html, assets, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, generateDocumentOutline, metadata, cookies, downloadFrom, split }) {
+    async convert({ html, assets, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, generateDocumentOutline, metadata, cookies, downloadFrom, split, userPassword, ownerPassword, embeds }) {
         const data = new FormData();
         await common_1.GotenbergUtils.addFile(data, html, 'index.html');
         if (assets?.length) {
@@ -61,6 +62,7 @@ class HtmlConverter extends converter_1.Converter {
             emulatedMediaType,
             waitDelay,
             waitForExpression,
+            waitForSelector,
             userAgent,
             extraHttpHeaders,
             failOnHttpStatusCodes,
@@ -72,7 +74,10 @@ class HtmlConverter extends converter_1.Converter {
             metadata,
             cookies,
             downloadFrom,
-            split
+            split,
+            userPassword,
+            ownerPassword,
+            embeds
         });
         return common_1.GotenbergUtils.fetch(this.endpoint, data, main_config_1.Chromiumly.getGotenbergApiBasicAuthUsername(), main_config_1.Chromiumly.getGotenbergApiBasicAuthPassword(), main_config_1.Chromiumly.getCustomHttpHeaders());
     }

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,yCAA8C;AAE9C,8DAA0D;AAC1D,2CAAwC;AACxC,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,aAAc,SAAQ,qBAAS;IACxC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,KAAK,CAAC,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,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,KAAK,EACe;QACpB,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAEvD,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,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;QACN,CAAC;QAED,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;YACjC,MAAM;YACN,MAAM;YACN,UAAU;YACV,SAAS;YACT,KAAK;YACL,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,SAAS;YACT,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,6BAA6B;YAC7B,2BAA2B;YAC3B,oBAAoB;YACpB,uBAAuB;YACvB,QAAQ;YACR,OAAO;YACP,YAAY;YACZ,KAAK;SACR,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AAvGD,sCAuGC"}
+{"version":3,"file":"html.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/html.converter.ts"],"names":[],"mappings":";;;AAAA,yCAA8C;AAE9C,8DAA0D;AAC1D,2CAAwC;AACxC,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,aAAc,SAAQ,qBAAS;IACxC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,OAAO,CAAC,EACV,IAAI,EACJ,MAAM,EACN,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,aAAa,EACb,MAAM,EACc;QACpB,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAEvD,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACjB,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;QACN,CAAC;QAED,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;YACjC,MAAM;YACN,MAAM;YACN,UAAU;YACV,SAAS;YACT,KAAK;YACL,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,eAAe;YACf,SAAS;YACT,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,6BAA6B;YAC7B,2BAA2B;YAC3B,oBAAoB;YACpB,uBAAuB;YACvB,QAAQ;YACR,OAAO;YACP,YAAY;YACZ,KAAK;YACL,YAAY;YACZ,aAAa;YACb,MAAM;SACT,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AAhHD,sCAgHC"}

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

@@ -26,6 +26,7 @@ export declare class MarkdownConverter extends Converter {
      * @param {EmulatedMediaType} [options.emulatedMediaType] - Emulated media type for the conversion.
      * @param {string} [options.waitDelay] - Delay before the conversion process starts.
      * @param {string} [options.waitForExpression] - JavaScript expression to wait for before completing the conversion.
+     * @param {string} [options.waitForSelector] - CSS selector to wait for before completing the conversion.
      * @param {string} [options.userAgent] - User agent string to use during the conversion.
      * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the conversion.
      * @param {number []} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
@@ -40,5 +41,5 @@ export declare class MarkdownConverter extends Converter {
      * @param {Split} [options.split] - Split the PDF into multiple files.
      * @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, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, generateDocumentOutline, metadata, cookies, downloadFrom, split }: MarkdownConversionOptions): Promise<Buffer>;
+    convert({ html, markdown, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, generateDocumentOutline, metadata, cookies, downloadFrom, split, userPassword, ownerPassword, embeds }: MarkdownConversionOptions): Promise<Buffer>;
 }

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

@@ -33,6 +33,7 @@ class MarkdownConverter extends converter_1.Converter {
      * @param {EmulatedMediaType} [options.emulatedMediaType] - Emulated media type for the conversion.
      * @param {string} [options.waitDelay] - Delay before the conversion process starts.
      * @param {string} [options.waitForExpression] - JavaScript expression to wait for before completing the conversion.
+     * @param {string} [options.waitForSelector] - CSS selector to wait for before completing the conversion.
      * @param {string} [options.userAgent] - User agent string to use during the conversion.
      * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the conversion.
      * @param {number []} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
@@ -47,7 +48,7 @@ class MarkdownConverter extends converter_1.Converter {
      * @param {Split} [options.split] - Split the PDF into multiple files.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a buffer
      */
-    async convert({ html, markdown, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, generateDocumentOutline, metadata, cookies, downloadFrom, split }) {
+    async convert({ html, markdown, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, generateDocumentOutline, metadata, cookies, downloadFrom, split, userPassword, ownerPassword, embeds }) {
         const data = new FormData();
         await common_1.GotenbergUtils.addFile(data, html, 'index.html');
         await common_1.GotenbergUtils.addFile(data, markdown, 'file.md');
@@ -60,6 +61,7 @@ class MarkdownConverter extends converter_1.Converter {
             emulatedMediaType,
             waitDelay,
             waitForExpression,
+            waitForSelector,
             userAgent,
             extraHttpHeaders,
             failOnHttpStatusCodes,
@@ -71,7 +73,10 @@ class MarkdownConverter extends converter_1.Converter {
             split,
             failOnResourceHttpStatusCodes,
             failOnResourceLoadingFailed,
-            generateDocumentOutline
+            generateDocumentOutline,
+            userPassword,
+            ownerPassword,
+            embeds
         });
         return common_1.GotenbergUtils.fetch(this.endpoint, data, main_config_1.Chromiumly.getGotenbergApiBasicAuthUsername(), main_config_1.Chromiumly.getGotenbergApiBasicAuthPassword(), main_config_1.Chromiumly.getCustomHttpHeaders());
     }

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,yCAA8C;AAE9C,8DAA0D;AAC1D,2CAAwC;AACxC,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,iBAAkB,SAAQ,qBAAS;IAC5C;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,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,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,KAAK,EACmB;QACxB,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAEvD,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAExD,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;YACjC,MAAM;YACN,MAAM;YACN,UAAU;YACV,SAAS;YACT,KAAK;YACL,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,SAAS;YACT,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,oBAAoB;YACpB,QAAQ;YACR,OAAO;YACP,YAAY;YACZ,KAAK;YACL,6BAA6B;YAC7B,2BAA2B;YAC3B,uBAAuB;SAC1B,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AAlGD,8CAkGC"}
+{"version":3,"file":"markdown.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/markdown.converter.ts"],"names":[],"mappings":";;;AAAA,yCAA8C;AAE9C,8DAA0D;AAC1D,2CAAwC;AACxC,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,iBAAkB,SAAQ,qBAAS;IAC5C;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,OAAO,CAAC,EACV,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,EACvB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,aAAa,EACb,MAAM,EACkB;QACxB,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAEvD,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAExD,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;YACjC,MAAM;YACN,MAAM;YACN,UAAU;YACV,SAAS;YACT,KAAK;YACL,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,eAAe;YACf,SAAS;YACT,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,oBAAoB;YACpB,QAAQ;YACR,OAAO;YACP,YAAY;YACZ,KAAK;YACL,6BAA6B;YAC7B,2BAA2B;YAC3B,uBAAuB;YACvB,YAAY;YACZ,aAAa;YACb,MAAM;SACT,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AA3GD,8CA2GC"}

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

@@ -25,6 +25,7 @@ export declare class UrlConverter extends Converter {
      * @param {EmulatedMediaType} [options.emulatedMediaType] - Emulated media type for the conversion.
      * @param {string} [options.waitDelay] - Delay before the conversion process starts.
      * @param {string} [options.waitForExpression] - JavaScript expression to wait for before completing the conversion.
+     * @param {string} [options.waitForSelector] - CSS selector to wait for before completing the conversion.
      * @param {string} [options.userAgent] - User agent string to use during the conversion.
      * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the conversion.
      * @param {number[]} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
@@ -39,5 +40,5 @@ export declare class UrlConverter extends Converter {
      * @param {Split} [options.split] - Split the PDF into multiple files.
      * @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, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, failOnConsoleExceptions, skipNetworkIdleEvent, metadata, cookies, downloadFrom, generateDocumentOutline, split }: UrlConversionOptions): Promise<Buffer>;
+    convert({ url, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, failOnConsoleExceptions, skipNetworkIdleEvent, metadata, cookies, downloadFrom, generateDocumentOutline, split, userPassword, ownerPassword, embeds }: UrlConversionOptions): Promise<Buffer>;
 }

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

@@ -33,6 +33,7 @@ class UrlConverter extends converter_1.Converter {
      * @param {EmulatedMediaType} [options.emulatedMediaType] - Emulated media type for the conversion.
      * @param {string} [options.waitDelay] - Delay before the conversion process starts.
      * @param {string} [options.waitForExpression] - JavaScript expression to wait for before completing the conversion.
+     * @param {string} [options.waitForSelector] - CSS selector to wait for before completing the conversion.
      * @param {string} [options.userAgent] - User agent string to use during the conversion.
      * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the conversion.
      * @param {number[]} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
@@ -47,7 +48,7 @@ class UrlConverter extends converter_1.Converter {
      * @param {Split} [options.split] - Split the PDF into multiple files.
      * @returns {Promise<Buffer>} A Promise resolving to the converted PDF content as a buffer
      */
-    async convert({ url, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, failOnConsoleExceptions, skipNetworkIdleEvent, metadata, cookies, downloadFrom, generateDocumentOutline, split }) {
+    async convert({ url, header, footer, properties, pdfFormat, pdfUA, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, userAgent, extraHttpHeaders, failOnHttpStatusCodes, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, failOnConsoleExceptions, skipNetworkIdleEvent, metadata, cookies, downloadFrom, generateDocumentOutline, split, userPassword, ownerPassword, embeds }) {
         const _url = new url_1.URL(url);
         const data = new FormData();
         data.append('url', _url.href);
@@ -60,6 +61,7 @@ class UrlConverter extends converter_1.Converter {
             emulatedMediaType,
             waitDelay,
             waitForExpression,
+            waitForSelector,
             userAgent,
             extraHttpHeaders,
             failOnHttpStatusCodes,
@@ -71,7 +73,10 @@ class UrlConverter extends converter_1.Converter {
             failOnResourceHttpStatusCodes,
             failOnResourceLoadingFailed,
             generateDocumentOutline,
-            split
+            split,
+            userPassword,
+            ownerPassword,
+            embeds
         });
         return common_1.GotenbergUtils.fetch(this.endpoint, data, main_config_1.Chromiumly.getGotenbergApiBasicAuthUsername(), main_config_1.Chromiumly.getGotenbergApiBasicAuthPassword(), main_config_1.Chromiumly.getCustomHttpHeaders());
     }

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

@@ -1 +1 @@
-{"version":3,"file":"url.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/url.converter.ts"],"names":[],"mappings":";;;AAAA,6BAA0B;AAE1B,yCAA8C;AAE9C,8DAA0D;AAC1D,2CAAwC;AACxC,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,YAAa,SAAQ,qBAAS;IACvC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,KAAK,CAAC,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,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,uBAAuB,EACvB,KAAK,EACc;QACnB,MAAM,IAAI,GAAG,IAAI,SAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;YACjC,MAAM;YACN,MAAM;YACN,UAAU;YACV,SAAS;YACT,KAAK;YACL,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,SAAS;YACT,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,oBAAoB;YACpB,QAAQ;YACR,OAAO;YACP,YAAY;YACZ,6BAA6B;YAC7B,2BAA2B;YAC3B,uBAAuB;YACvB,KAAK;SACR,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AA/FD,oCA+FC"}
+{"version":3,"file":"url.converter.js","sourceRoot":"","sources":["../../../src/chromium/converters/url.converter.ts"],"names":[],"mappings":";;;AAAA,6BAA0B;AAE1B,yCAA8C;AAE9C,8DAA0D;AAC1D,2CAAwC;AACxC,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,YAAa,SAAQ,qBAAS;IACvC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,OAAO,CAAC,EACV,GAAG,EACH,MAAM,EACN,MAAM,EACN,UAAU,EACV,SAAS,EACT,KAAK,EACL,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,qBAAqB,EACrB,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EACvB,oBAAoB,EACpB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,uBAAuB,EACvB,KAAK,EACL,YAAY,EACZ,aAAa,EACb,MAAM,EACa;QACnB,MAAM,IAAI,GAAG,IAAI,SAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,gCAAc,CAAC,SAAS,CAAC,IAAI,EAAE;YACjC,MAAM;YACN,MAAM;YACN,UAAU;YACV,SAAS;YACT,KAAK;YACL,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,eAAe;YACf,SAAS;YACT,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,oBAAoB;YACpB,QAAQ;YACR,OAAO;YACP,YAAY;YACZ,6BAA6B;YAC7B,2BAA2B;YAC3B,uBAAuB;YACvB,KAAK;YACL,YAAY;YACZ,aAAa;YACb,MAAM;SACT,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AAxGD,oCAwGC"}

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

@@ -16,6 +16,7 @@ export type ChromiumOptions = {
     emulatedMediaType?: EmulatedMediaType;
     waitDelay?: string;
     waitForExpression?: string;
+    waitForSelector?: string;
     extraHttpHeaders?: Record<string, string>;
     failOnHttpStatusCodes?: number[];
     failOnConsoleExceptions?: boolean;

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

@@ -41,6 +41,9 @@ export type ConversionOptions = ChromiumOptions & {
     metadata?: Metadata;
     cookies?: Cookie[];
     split?: Split;
+    userPassword?: string;
+    ownerPassword?: string;
+    embeds?: PathLikeOrReadStream[];
 };
 export type HtmlConversionOptions = ConversionOptions & {
     html: PathLikeOrReadStream;

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

@@ -11,6 +11,9 @@ export type ImageProperties = {
 export type ScreenshotOptions = Omit<ChromiumOptions, 'assets' | 'header' | 'footer'> & {
     properties?: ImageProperties;
     optimizeForSpeed?: boolean;
+    userPassword?: string;
+    ownerPassword?: string;
+    embeds?: PathLikeOrReadStream[];
 };
 export type HtmlScreenshotOptions = ScreenshotOptions & {
     html: PathLikeOrReadStream;

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

@@ -21,6 +21,7 @@ export declare class HtmlScreenshot extends 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 {string} [options.waitForSelector] - CSS selector to wait for before completing the screenshot.
      * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the screenshot.
      * @param {boolean} [options.failOnConsoleExceptions] - Whether to fail on console exceptions during screenshot.
      * @param {number []} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
@@ -32,5 +33,5 @@ export declare class HtmlScreenshot extends Screenshot {
      * @param {boolean} [options.generateDocumentOutline] - Whether to generate document outline.
      * @returns {Promise<Buffer>} A Promise resolving to the image buffer.
      */
-    capture({ html, properties, emulatedMediaType, waitDelay, waitForExpression, extraHttpHeaders, failOnConsoleExceptions, failOnHttpStatusCodes, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, optimizeForSpeed, downloadFrom, generateDocumentOutline }: HtmlScreenshotOptions): Promise<Buffer>;
+    capture({ html, properties, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, extraHttpHeaders, failOnConsoleExceptions, failOnHttpStatusCodes, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, optimizeForSpeed, downloadFrom, generateDocumentOutline, userPassword, ownerPassword, embeds }: HtmlScreenshotOptions): Promise<Buffer>;
 }

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

@@ -28,6 +28,7 @@ class HtmlScreenshot extends screenshot_1.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 {string} [options.waitForSelector] - CSS selector to wait for before completing the screenshot.
      * @param {Record<string, string>} [options.extraHttpHeaders] - Additional HTTP headers for the screenshot.
      * @param {boolean} [options.failOnConsoleExceptions] - Whether to fail on console exceptions during screenshot.
      * @param {number []} [options.failOnHttpStatusCodes] - Whether to fail on HTTP status code.
@@ -39,7 +40,7 @@ class HtmlScreenshot extends screenshot_1.Screenshot {
      * @param {boolean} [options.generateDocumentOutline] - Whether to generate document outline.
      * @returns {Promise<Buffer>} A Promise resolving to the image buffer.
      */
-    async capture({ html, properties, emulatedMediaType, waitDelay, waitForExpression, extraHttpHeaders, failOnConsoleExceptions, failOnHttpStatusCodes, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, optimizeForSpeed, downloadFrom, generateDocumentOutline }) {
+    async capture({ html, properties, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, extraHttpHeaders, failOnConsoleExceptions, failOnHttpStatusCodes, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, optimizeForSpeed, downloadFrom, generateDocumentOutline, userPassword, ownerPassword, embeds }) {
         const data = new FormData();
         await common_1.GotenbergUtils.addFile(data, html, 'index.html');
         await screenshot_utils_1.ScreenshotUtils.customize(data, {
@@ -47,6 +48,7 @@ class HtmlScreenshot extends screenshot_1.Screenshot {
             emulatedMediaType,
             waitDelay,
             waitForExpression,
+            waitForSelector,
             extraHttpHeaders,
             failOnHttpStatusCodes,
             failOnConsoleExceptions,
@@ -55,7 +57,10 @@ class HtmlScreenshot extends screenshot_1.Screenshot {
             skipNetworkIdleEvent,
             optimizeForSpeed,
             downloadFrom,
-            generateDocumentOutline
+            generateDocumentOutline,
+            userPassword,
+            ownerPassword,
+            embeds
         });
         return common_1.GotenbergUtils.fetch(this.endpoint, data, main_config_1.Chromiumly.getGotenbergApiBasicAuthUsername(), main_config_1.Chromiumly.getGotenbergApiBasicAuthPassword(), main_config_1.Chromiumly.getCustomHttpHeaders());
     }

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

@@ -1 +1 @@
-{"version":3,"file":"html.screenshot.js","sourceRoot":"","sources":["../../../src/chromium/screenshots/html.screenshot.ts"],"names":[],"mappings":";;;AAAA,yCAA8C;AAC9C,mDAA8D;AAC9D,gEAA4D;AAC5D,6CAA0C;AAG1C;;;;;GAKG;AACH,MAAa,cAAe,SAAQ,uBAAU;IAC1C;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,OAAO,CAAC,EACV,IAAI,EACJ,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACH;QACpB,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAEvD,MAAM,kCAAe,CAAC,SAAS,CAAC,IAAI,EAAE;YAClC,UAAU;YACV,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,6BAA6B;YAC7B,2BAA2B;YAC3B,oBAAoB;YACpB,gBAAgB;YAChB,YAAY;YACZ,uBAAuB;SAC1B,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AAzED,wCAyEC"}
+{"version":3,"file":"html.screenshot.js","sourceRoot":"","sources":["../../../src/chromium/screenshots/html.screenshot.ts"],"names":[],"mappings":";;;AAAA,yCAA8C;AAC9C,mDAA8D;AAC9D,gEAA4D;AAC5D,6CAA0C;AAG1C;;;;;GAKG;AACH,MAAa,cAAe,SAAQ,uBAAU;IAC1C;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,OAAO,CAAC,EACV,IAAI,EACJ,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,MAAM,EACc;QACpB,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAEvD,MAAM,kCAAe,CAAC,SAAS,CAAC,IAAI,EAAE;YAClC,UAAU;YACV,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,eAAe;YACf,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,6BAA6B;YAC7B,2BAA2B;YAC3B,oBAAoB;YACpB,gBAAgB;YAChB,YAAY;YACZ,uBAAuB;YACvB,YAAY;YACZ,aAAa;YACb,MAAM;SACT,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AAlFD,wCAkFC"}

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

@@ -22,6 +22,7 @@ export declare class MarkdownScreenshot extends 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 {string} [options.waitForSelector] - CSS selector 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.
@@ -33,5 +34,5 @@ export declare class MarkdownScreenshot extends Screenshot {
      * @param {boolean} [options.generateDocumentOutline] - Whether to generate document outline.
      * @returns {Promise<Buffer>} A Promise resolving to the image buffer.
      */
-    capture({ html, markdown, properties, emulatedMediaType, waitDelay, waitForExpression, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, optimizeForSpeed, downloadFrom, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, generateDocumentOutline }: MarkdownScreenshotOptions): Promise<Buffer>;
+    capture({ html, markdown, properties, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, optimizeForSpeed, downloadFrom, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, generateDocumentOutline, userPassword, ownerPassword, embeds }: MarkdownScreenshotOptions): Promise<Buffer>;
 }

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

@@ -29,6 +29,7 @@ class MarkdownScreenshot extends screenshot_1.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 {string} [options.waitForSelector] - CSS selector 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.
@@ -40,7 +41,7 @@ class MarkdownScreenshot extends screenshot_1.Screenshot {
      * @param {boolean} [options.generateDocumentOutline] - Whether to generate document outline.
      * @returns {Promise<Buffer>} A Promise resolving to the image buffer.
      */
-    async capture({ html, markdown, properties, emulatedMediaType, waitDelay, waitForExpression, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, optimizeForSpeed, downloadFrom, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, generateDocumentOutline }) {
+    async capture({ html, markdown, properties, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, skipNetworkIdleEvent, optimizeForSpeed, downloadFrom, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, generateDocumentOutline, userPassword, ownerPassword, embeds }) {
         const data = new FormData();
         await common_1.GotenbergUtils.addFile(data, html, 'index.html');
         await common_1.GotenbergUtils.addFile(data, markdown, 'file.md');
@@ -49,6 +50,7 @@ class MarkdownScreenshot extends screenshot_1.Screenshot {
             emulatedMediaType,
             waitDelay,
             waitForExpression,
+            waitForSelector,
             extraHttpHeaders,
             failOnHttpStatusCodes,
             failOnConsoleExceptions,
@@ -57,7 +59,10 @@ class MarkdownScreenshot extends screenshot_1.Screenshot {
             skipNetworkIdleEvent,
             optimizeForSpeed,
             downloadFrom,
-            generateDocumentOutline
+            generateDocumentOutline,
+            userPassword,
+            ownerPassword,
+            embeds
         });
         return common_1.GotenbergUtils.fetch(this.endpoint, data, main_config_1.Chromiumly.getGotenbergApiBasicAuthUsername(), main_config_1.Chromiumly.getGotenbergApiBasicAuthPassword(), main_config_1.Chromiumly.getCustomHttpHeaders());
     }

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

@@ -1 +1 @@
-{"version":3,"file":"markdown.screenshot.js","sourceRoot":"","sources":["../../../src/chromium/screenshots/markdown.screenshot.ts"],"names":[],"mappings":";;;AAAA,yCAA8C;AAE9C,gEAA4D;AAC5D,6CAA0C;AAC1C,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,kBAAmB,SAAQ,uBAAU;IAC9C;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,OAAO,CAAC,EACV,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EACC;QACxB,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAEvD,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAExD,MAAM,kCAAe,CAAC,SAAS,CAAC,IAAI,EAAE;YAClC,UAAU;YACV,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,6BAA6B;YAC7B,2BAA2B;YAC3B,oBAAoB;YACpB,gBAAgB;YAChB,YAAY;YACZ,uBAAuB;SAC1B,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AA7ED,gDA6EC"}
+{"version":3,"file":"markdown.screenshot.js","sourceRoot":"","sources":["../../../src/chromium/screenshots/markdown.screenshot.ts"],"names":[],"mappings":";;;AAAA,yCAA8C;AAE9C,gEAA4D;AAC5D,6CAA0C;AAC1C,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,kBAAmB,SAAQ,uBAAU;IAC9C;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,OAAO,CAAC,EACV,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,6BAA6B,EAC7B,2BAA2B,EAC3B,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,MAAM,EACkB;QACxB,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAEvD,MAAM,uBAAc,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAExD,MAAM,kCAAe,CAAC,SAAS,CAAC,IAAI,EAAE;YAClC,UAAU;YACV,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,eAAe;YACf,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,6BAA6B;YAC7B,2BAA2B;YAC3B,oBAAoB;YACpB,gBAAgB;YAChB,YAAY;YACZ,uBAAuB;YACvB,YAAY;YACZ,aAAa;YACb,MAAM;SACT,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AAtFD,gDAsFC"}

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

@@ -21,6 +21,7 @@ export declare class UrlScreenshot extends 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 {string} [options.waitForSelector] - CSS selector 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.
@@ -32,5 +33,5 @@ export declare class UrlScreenshot extends Screenshot {
      * @param {boolean} [options.generateDocumentOutline] - Whether to generate document outline.
      * @returns {Promise<Buffer>} A Promise resolving to the image buffer.
      */
-    capture({ url, properties, emulatedMediaType, waitDelay, waitForExpression, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, optimizeForSpeed, cookies, generateDocumentOutline }: UrlScreenshotOptions): Promise<Buffer>;
+    capture({ url, properties, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, optimizeForSpeed, cookies, generateDocumentOutline, userPassword, ownerPassword, embeds }: UrlScreenshotOptions): Promise<Buffer>;
 }

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

@@ -29,6 +29,7 @@ class UrlScreenshot extends screenshot_1.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 {string} [options.waitForSelector] - CSS selector 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.
@@ -40,7 +41,7 @@ class UrlScreenshot extends screenshot_1.Screenshot {
      * @param {boolean} [options.generateDocumentOutline] - Whether to generate document outline.
      * @returns {Promise<Buffer>} A Promise resolving to the image buffer.
      */
-    async capture({ url, properties, emulatedMediaType, waitDelay, waitForExpression, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, optimizeForSpeed, cookies, generateDocumentOutline }) {
+    async capture({ url, properties, emulatedMediaType, waitDelay, waitForExpression, waitForSelector, extraHttpHeaders, failOnHttpStatusCodes, failOnConsoleExceptions, failOnResourceHttpStatusCodes, failOnResourceLoadingFailed, skipNetworkIdleEvent, optimizeForSpeed, cookies, generateDocumentOutline, userPassword, ownerPassword, embeds }) {
         const _url = new url_1.URL(url);
         const data = new FormData();
         data.append('url', _url.href);
@@ -49,6 +50,7 @@ class UrlScreenshot extends screenshot_1.Screenshot {
             emulatedMediaType,
             waitDelay,
             waitForExpression,
+            waitForSelector,
             extraHttpHeaders,
             failOnHttpStatusCodes,
             failOnConsoleExceptions,
@@ -57,7 +59,10 @@ class UrlScreenshot extends screenshot_1.Screenshot {
             skipNetworkIdleEvent,
             optimizeForSpeed,
             cookies,
-            generateDocumentOutline
+            generateDocumentOutline,
+            userPassword,
+            ownerPassword,
+            embeds
         });
         return common_1.GotenbergUtils.fetch(this.endpoint, data, main_config_1.Chromiumly.getGotenbergApiBasicAuthUsername(), main_config_1.Chromiumly.getGotenbergApiBasicAuthPassword(), main_config_1.Chromiumly.getCustomHttpHeaders());
     }

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

@@ -1 +1 @@
-{"version":3,"file":"url.screenshot.js","sourceRoot":"","sources":["../../../src/chromium/screenshots/url.screenshot.ts"],"names":[],"mappings":";;;AAAA,6BAA0B;AAE1B,yCAA8C;AAE9C,gEAA4D;AAC5D,6CAA0C;AAC1C,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,aAAc,SAAQ,uBAAU;IACzC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,OAAO,CAAC,EACV,GAAG,EACH,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,gBAAgB,EAChB,OAAO,EACP,uBAAuB,EACJ;QACnB,MAAM,IAAI,GAAG,IAAI,SAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,kCAAe,CAAC,SAAS,CAAC,IAAI,EAAE;YAClC,UAAU;YACV,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,6BAA6B;YAC7B,2BAA2B;YAC3B,oBAAoB;YACpB,gBAAgB;YAChB,OAAO;YACP,uBAAuB;SAC1B,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AA1ED,sCA0EC"}
+{"version":3,"file":"url.screenshot.js","sourceRoot":"","sources":["../../../src/chromium/screenshots/url.screenshot.ts"],"names":[],"mappings":";;;AAAA,6BAA0B;AAE1B,yCAA8C;AAE9C,gEAA4D;AAC5D,6CAA0C;AAC1C,mDAA8D;AAE9D;;;;;GAKG;AACH,MAAa,aAAc,SAAQ,uBAAU;IACzC;;;OAGG;IACH;QACI,KAAK,CAAC,2BAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,OAAO,CAAC,EACV,GAAG,EACH,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,oBAAoB,EACpB,gBAAgB,EAChB,OAAO,EACP,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,MAAM,EACa;QACnB,MAAM,IAAI,GAAG,IAAI,SAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE5B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,kCAAe,CAAC,SAAS,CAAC,IAAI,EAAE;YAClC,UAAU;YACV,iBAAiB;YACjB,SAAS;YACT,iBAAiB;YACjB,eAAe;YACf,gBAAgB;YAChB,qBAAqB;YACrB,uBAAuB;YACvB,6BAA6B;YAC7B,2BAA2B;YAC3B,oBAAoB;YACpB,gBAAgB;YAChB,OAAO;YACP,uBAAuB;YACvB,YAAY;YACZ,aAAa;YACb,MAAM;SACT,CAAC,CAAC;QAEH,OAAO,uBAAc,CAAC,KAAK,CACvB,IAAI,CAAC,QAAQ,EACb,IAAI,EACJ,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,gCAAgC,EAAE,EAC7C,wBAAU,CAAC,oBAAoB,EAAE,CACpC,CAAC;IACN,CAAC;CACJ;AAnFD,sCAmFC"}

package/dist/chromium/utils/converter.utils.d.ts

@@ -1,4 +1,5 @@
 import { ConversionOptions, PageProperties } from '../interfaces/converter.types';
+import { PathLikeOrReadStream } from '../../common';
 /**
  * Utility class for handling common tasks related to conversion.
  */
@@ -10,6 +11,15 @@ export declare class ConverterUtils {
      * @param {PageProperties} pageProperties - The page properties to be added to the FormData.
      */
     static addPageProperties(data: FormData, pageProperties: PageProperties): void;
+    /**
+     * Adds files to the FormData object with a custom field name.
+     *
+     * @param {PathLikeOrReadStream[]} files - An array of files to be added to the FormData.
+     * @param {FormData} data - The FormData object to which files will be added.
+     * @param {string} fieldName - The field name to use when appending files (e.g., 'files', 'embeds').
+     * @returns {Promise<void>} A Promise that resolves once the files have been added.
+     */
+    static addFilesWithFieldName(files: PathLikeOrReadStream[], data: FormData, fieldName: string): Promise<void>;
     /**
      * Customizes the FormData object based on the provided conversion options.
      *

package/dist/chromium/utils/converter.utils.js

@@ -1,6 +1,12 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConverterUtils = void 0;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const consumers_1 = require("node:stream/consumers");
 const common_1 = require("../../common");
 /**
  * Utility class for handling common tasks related to conversion.
@@ -56,6 +62,32 @@ class ConverterUtils {
             data.append('nativePageRanges', `${pageProperties.nativePageRanges.from}-${pageProperties.nativePageRanges.to}`);
         }
     }
+    /**
+     * Adds files to the FormData object with a custom field name.
+     *
+     * @param {PathLikeOrReadStream[]} files - An array of files to be added to the FormData.
+     * @param {FormData} data - The FormData object to which files will be added.
+     * @param {string} fieldName - The field name to use when appending files (e.g., 'files', 'embeds').
+     * @returns {Promise<void>} A Promise that resolves once the files have been added.
+     */
+    static async addFilesWithFieldName(files, data, fieldName) {
+        await Promise.all(files.map(async (file, index) => {
+            const filename = path_1.default.basename(typeof file === 'string' ? file : `file${index + 1}`);
+            if (Buffer.isBuffer(file)) {
+                data.append(fieldName, new Blob([file]), filename);
+            }
+            else if (file instanceof fs_1.ReadStream) {
+                const content = await (0, consumers_1.blob)(file);
+                data.append(fieldName, content, filename);
+            }
+            else {
+                await fs_1.promises.access(file, fs_1.constants.R_OK);
+                const _filename = path_1.default.basename(file.toString());
+                const content = await (0, fs_1.openAsBlob)(file);
+                data.append(fieldName, content, _filename);
+            }
+        }));
+    }
     /**
      * Customizes the FormData object based on the provided conversion options.
      *
@@ -90,6 +122,9 @@ class ConverterUtils {
         if (options.waitForExpression) {
             data.append('waitForExpression', options.waitForExpression);
         }
+        if (options.waitForSelector) {
+            data.append('waitForSelector', options.waitForSelector);
+        }
         if (options.userAgent) {
             data.append('userAgent', options.userAgent);
         }
@@ -131,6 +166,15 @@ class ConverterUtils {
                 data.append('splitUnify', String(options.split.unify));
             }
         }
+        if (options.userPassword) {
+            data.append('userPassword', options.userPassword);
+        }
+        if (options.ownerPassword) {
+            data.append('ownerPassword', options.ownerPassword);
+        }
+        if (options.embeds && options.embeds.length > 0) {
+            await ConverterUtils.addFilesWithFieldName(options.embeds, data, 'embeds');
+        }
     }
 }
 exports.ConverterUtils = ConverterUtils;