@shad0wz7/nestjs-pdf 3.2.0 → 5.0.0

package/dist/index.mjs

@@ -1,21 +1,13 @@
+import { createRequire } from "node:module";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { Inject, Injectable, Logger, Module, Optional } from "@nestjs/common";
 import { PDFArray, PDFDict, PDFDocument, PDFName, PDFNumber, PDFString, StandardFonts, degrees, rgb } from "pdf-lib";
 import { deepmerge } from "deepmerge-ts";
-import { lookup } from "node:dns/promises";
 import { existsSync, promises, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { lookup } from "node:dns/promises";
 import { BlockList, isIP } from "node:net";
 import { fileURLToPath } from "node:url";
-import { TargetType, launch } from "puppeteer";
-import { Browser as Browser$1, BrowserPlatform, canDownload, detectBrowserPlatform, getInstalledBrowsers, install, resolveBuildId } from "@puppeteer/browsers";
-import ejs from "ejs";
-import { Eta } from "eta";
-import Handlebars from "handlebars";
-import mjml from "mjml";
-import mustache from "mustache";
-import nunjucks from "nunjucks";
-import pug from "pug";
-//#region src/exceptions/nestjs-pdf.exception.ts
+// src/exceptions/nestjs-pdf.exception.ts
 let NestjsPdfErrorCode = /* @__PURE__ */ function(NestjsPdfErrorCode) {
 	NestjsPdfErrorCode["ENGINE_NOT_AVAILABLE"] = "ENGINE_NOT_AVAILABLE";
 	NestjsPdfErrorCode["TEMPLATE_CONFIGURATION_ERROR"] = "TEMPLATE_CONFIGURATION_ERROR";
@@ -26,6 +18,7 @@ let NestjsPdfErrorCode = /* @__PURE__ */ function(NestjsPdfErrorCode) {
 	NestjsPdfErrorCode["SIGNATURE_DEPENDENCY_ERROR"] = "SIGNATURE_DEPENDENCY_ERROR";
 	NestjsPdfErrorCode["SIGNATURE_PLACEMENT_ERROR"] = "SIGNATURE_PLACEMENT_ERROR";
 	NestjsPdfErrorCode["WATERMARK_ERROR"] = "WATERMARK_ERROR";
+	NestjsPdfErrorCode["RENDERER_CONFIGURATION_ERROR"] = "RENDERER_CONFIGURATION_ERROR";
 	return NestjsPdfErrorCode;
 }({});
 var NestjsPdfException = class extends Error {
@@ -34,46 +27,43 @@ var NestjsPdfException = class extends Error {
 		this.name = this.constructor.name;
 	}
 };
-//#endregion
-//#region src/exceptions/browser-installation.exception.ts
+// src/exceptions/browser-installation.exception.ts
 var BrowserInstallationException = class extends NestjsPdfException {
 	code = "BROWSER_INSTALLATION_ERROR";
 };
-//#endregion
-//#region src/exceptions/browser-unavailable.exception.ts
+// src/exceptions/browser-unavailable.exception.ts
 var BrowserUnavailableException = class extends NestjsPdfException {
 	code = "BROWSER_UNAVAILABLE";
 };
-//#endregion
-//#region src/exceptions/engine-not-available.exception.ts
+// src/exceptions/engine-not-available.exception.ts
 var EngineNotAvailableException = class extends NestjsPdfException {
 	code = "ENGINE_NOT_AVAILABLE";
-	constructor(engineName) {
-		super(`${engineName} service is not available. If the problem persists, open an issue in the repo.`);
+	constructor(engineName, packageName, options) {
+		super(packageName ? `${engineName} engine is not available: the '${packageName}' package is not installed. Run \`npm install ${packageName}\` to use it.` : `${engineName} service is not available. If the problem persists, open an issue in the repo.`, options);
 	}
 };
-//#endregion
-//#region src/exceptions/pdf-generation.exception.ts
+// src/exceptions/pdf-generation.exception.ts
 var PdfGenerationException = class extends NestjsPdfException {
 	code = "PDF_GENERATION_ERROR";
 };
-//#endregion
-//#region src/exceptions/signature-dependency.exception.ts
+// src/exceptions/renderer-configuration.exception.ts
+/** The PDF provider is misconfigured, or asked for an option it does not support. */
+var RendererConfigurationException = class extends NestjsPdfException {
+	code = "RENDERER_CONFIGURATION_ERROR";
+};
+// src/exceptions/signature-dependency.exception.ts
 var SignatureDependencyException = class extends NestjsPdfException {
 	code = "SIGNATURE_DEPENDENCY_ERROR";
 };
-//#endregion
-//#region src/exceptions/signature-placement.exception.ts
+// src/exceptions/signature-placement.exception.ts
 var SignaturePlacementException = class extends NestjsPdfException {
 	code = "SIGNATURE_PLACEMENT_ERROR";
 };
-//#endregion
-//#region src/exceptions/template-configuration.exception.ts
+// src/exceptions/template-configuration.exception.ts
 var TemplateConfigurationException = class extends NestjsPdfException {
 	code = "TEMPLATE_CONFIGURATION_ERROR";
 };
-//#endregion
-//#region src/exceptions/template-render.exception.ts
+// src/exceptions/template-render.exception.ts
 var TemplateRenderException = class extends NestjsPdfException {
 	engine;
 	code = "TEMPLATE_RENDER_ERROR";
@@ -82,13 +72,11 @@ var TemplateRenderException = class extends NestjsPdfException {
 		this.engine = engine;
 	}
 };
-//#endregion
-//#region src/exceptions/watermark.exception.ts
+// src/exceptions/watermark.exception.ts
 var WatermarkException = class extends NestjsPdfException {
 	code = "WATERMARK_ERROR";
 };
-//#endregion
-//#region src/helpers/getRelativePath.helper.ts
+// src/helpers/getRelativePath.helper.ts
 /**
 * Get the relative path to a value from the module directory.
 * @param moduleDir the path of the module, typically __dirname
@@ -102,8 +90,7 @@ function getRelativePathToValue(moduleDir, relativeToModule) {
 	const fullTemplatePath = resolve(moduleDir, relativeToModule);
 	return relative(process.cwd(), fullTemplatePath);
 }
-//#endregion
-//#region src/helpers/signature.helper.ts
+// src/helpers/signature.helper.ts
 let pdfjsPromise;
 async function loadPdfjs() {
 	if (!pdfjsPromise) try {
@@ -246,8 +233,7 @@ async function addSignatureFieldUsingAnchor(pdf, fieldName = "SignatureDebtor",
 	}
 	return await pdfDoc.save();
 }
-//#endregion
-//#region src/helpers/watermark.helper.ts
+// src/helpers/watermark.helper.ts
 const DEFAULT_OPACITY = .15;
 const DEFAULT_ROTATION = 45;
 const DEFAULT_FONT_SIZE = 60;
@@ -390,8 +376,7 @@ async function addWatermark(pdf, options) {
 		throw new WatermarkException(`Failed to add watermark: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
 	}
 }
-//#endregion
-//#region node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js
+// node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js
 var Node = class {
 	value;
 	next;
@@ -448,8 +433,7 @@ var Queue = class {
 		while (this.#head) yield this.dequeue();
 	}
 };
-//#endregion
-//#region node_modules/.pnpm/p-limit@7.3.2/node_modules/p-limit/index.js
+// node_modules/.pnpm/p-limit@7.3.3/node_modules/p-limit/index.js
 function pLimit(concurrency) {
 	let rejectOnClear = false;
 	if (typeof concurrency === "object") ({concurrency, rejectOnClear = false} = concurrency);
@@ -508,7 +492,17 @@ function pLimit(concurrency) {
 			}
 		},
 		map: { async value(iterable, function_) {
-			const promises = Array.from(iterable, (value, index) => generator(function_, value, index));
+			const promises = [];
+			try {
+				Array.from(iterable, (value, index) => {
+					const promise = generator(function_, value, index);
+					promises.push(promise);
+					return promise;
+				});
+			} catch (error) {
+				for (const promise of promises) promise.catch(() => {});
+				throw error;
+			}
 			return Promise.all(promises);
 		} }
 	});
@@ -517,14 +511,296 @@ function pLimit(concurrency) {
 function validateConcurrency(concurrency) {
 	if (!((Number.isInteger(concurrency) || concurrency === Number.POSITIVE_INFINITY) && concurrency > 0)) throw new TypeError("Expected `concurrency` to be a number from 1 and up");
 }
-//#endregion
-//#region src/helpers/deepMergePdfparams.ts
+// src/helpers/deepMergePdfparams.ts
 function mergePuppeteerParameters(defaults, overrides) {
 	if (!overrides) return { ...defaults };
 	return deepmerge(defaults, overrides);
 }
-//#endregion
-//#region src/helpers/request-guard.helper.ts
+// src/helpers/tokens.ts
+const PDF_PARAMETERS = "PDF_PARAMETERS";
+// src/renderers/pdf-renderer.interface.ts
+const PDF_RENDERER = "PDF_RENDERER";
+// src/renderers/http.utils.ts
+const MAX_ERROR_BODY_LENGTH = 500;
+/** Builds a `PdfGenerationException` from a failed HTTP response, body included. */
+async function httpError(provider, response) {
+	let body = "";
+	try {
+		body = (await response.text()).trim().slice(0, MAX_ERROR_BODY_LENGTH);
+	} catch {}
+	return new PdfGenerationException(`${provider} responded with HTTP ${response.status}${body ? `: ${body}` : ""}`);
+}
+/** Remote providers render on another machine: the local request guard cannot run there. */
+function assertNoRequestGuard(provider, options, hint) {
+	if (options.security) throw new RendererConfigurationException(`The 'security' option is only supported by the puppeteer provider, not by ${provider}. ${hint}`);
+}
+function requireNonEmpty(value, name, provider) {
+	if (!value?.trim()) throw new RendererConfigurationException(`The ${provider} provider requires a non-empty '${name}'`);
+	return value;
+}
+// src/renderers/pdf-options.mapper.ts
+/** Paper sizes in inches, as Puppeteer defines them. */
+const PAPER_FORMATS = {
+	letter: {
+		width: 8.5,
+		height: 11
+	},
+	legal: {
+		width: 8.5,
+		height: 14
+	},
+	tabloid: {
+		width: 11,
+		height: 17
+	},
+	ledger: {
+		width: 17,
+		height: 11
+	},
+	a0: {
+		width: 33.1102,
+		height: 46.811
+	},
+	a1: {
+		width: 23.3858,
+		height: 33.1102
+	},
+	a2: {
+		width: 16.5354,
+		height: 23.3858
+	},
+	a3: {
+		width: 11.6929,
+		height: 16.5354
+	},
+	a4: {
+		width: 8.2677,
+		height: 11.6929
+	},
+	a5: {
+		width: 5.8268,
+		height: 8.2677
+	},
+	a6: {
+		width: 4.1339,
+		height: 5.8268
+	}
+};
+const INCHES_PER_UNIT = {
+	px: 1 / 96,
+	in: 1,
+	cm: 1 / 2.54,
+	mm: 1 / 25.4
+};
+/**
+* Converts a Puppeteer length (a number of pixels, or a string with a
+* `px`/`in`/`cm`/`mm` unit) to inches.
+*/
+function toInches(value) {
+	if (typeof value === "number") return value * INCHES_PER_UNIT.px;
+	const match = /^\s*(-?\d*\.?\d+)\s*(px|in|cm|mm)?\s*$/i.exec(value);
+	if (!match) throw new RendererConfigurationException(`Invalid length '${value}': expected a number of pixels or a value in px, in, cm or mm`);
+	const unit = (match[2] ?? "px").toLowerCase();
+	return Number(match[1]) * INCHES_PER_UNIT[unit];
+}
+function formatInches(inches) {
+	return String(Math.round(inches * 1e4) / 1e4);
+}
+function resolvePrintLayout(pdfOptions) {
+	let width;
+	let height;
+	if (pdfOptions.width !== void 0 || pdfOptions.height !== void 0) {
+		const fallback = PAPER_FORMATS.letter;
+		width = pdfOptions.width === void 0 ? fallback.width : toInches(pdfOptions.width);
+		height = pdfOptions.height === void 0 ? fallback.height : toInches(pdfOptions.height);
+	} else {
+		const formatName = (pdfOptions.format ?? "letter").toLowerCase();
+		const format = PAPER_FORMATS[formatName];
+		if (!format) throw new RendererConfigurationException(`Unknown paper format '${pdfOptions.format}'`);
+		({width, height} = format);
+	}
+	const margin = {};
+	for (const side of [
+		"top",
+		"right",
+		"bottom",
+		"left"
+	]) {
+		const value = pdfOptions.margin?.[side];
+		if (value !== void 0) margin[side] = toInches(value);
+	}
+	return {
+		width,
+		height,
+		margin
+	};
+}
+function toHtmlDocument(template) {
+	return /<html[\s>]/i.test(template) ? template : `<!DOCTYPE html><html><head></head><body>${template}</body></html>`;
+}
+function toGotenbergForm(pdfOptions) {
+	const { width, height, margin } = resolvePrintLayout(pdfOptions);
+	const fields = {
+		paperWidth: formatInches(width),
+		paperHeight: formatInches(height),
+		marginTop: formatInches(margin.top ?? 0),
+		marginRight: formatInches(margin.right ?? 0),
+		marginBottom: formatInches(margin.bottom ?? 0),
+		marginLeft: formatInches(margin.left ?? 0),
+		emulatedMediaType: "screen",
+		skipNetworkIdleEvent: "false"
+	};
+	if (pdfOptions.landscape !== void 0) fields.landscape = String(pdfOptions.landscape);
+	if (pdfOptions.printBackground !== void 0) fields.printBackground = String(pdfOptions.printBackground);
+	if (pdfOptions.omitBackground !== void 0) fields.omitBackground = String(pdfOptions.omitBackground);
+	if (pdfOptions.scale !== void 0) fields.scale = String(pdfOptions.scale);
+	if (pdfOptions.pageRanges) fields.nativePageRanges = pdfOptions.pageRanges;
+	if (pdfOptions.preferCSSPageSize !== void 0) fields.preferCssPageSize = String(pdfOptions.preferCSSPageSize);
+	if (pdfOptions.tagged !== void 0) fields.generateTaggedPdf = String(pdfOptions.tagged);
+	if (pdfOptions.outline !== void 0) fields.generateDocumentOutline = String(pdfOptions.outline);
+	const files = {};
+	if (pdfOptions.displayHeaderFooter) {
+		if (pdfOptions.headerTemplate) files["header.html"] = toHtmlDocument(pdfOptions.headerTemplate);
+		if (pdfOptions.footerTemplate) files["footer.html"] = toHtmlDocument(pdfOptions.footerTemplate);
+	}
+	return {
+		fields,
+		files
+	};
+}
+function toApi2PdfOptions(pdfOptions) {
+	const { width, height, margin } = resolvePrintLayout(pdfOptions);
+	const options = {
+		width: `${formatInches(width)}in`,
+		height: `${formatInches(height)}in`,
+		marginTop: `${formatInches(margin.top ?? 0)}in`,
+		marginRight: `${formatInches(margin.right ?? 0)}in`,
+		marginBottom: `${formatInches(margin.bottom ?? 0)}in`,
+		marginLeft: `${formatInches(margin.left ?? 0)}in`,
+		usePrintCss: false
+	};
+	for (const key of [
+		"landscape",
+		"printBackground",
+		"omitBackground",
+		"scale",
+		"pageRanges",
+		"displayHeaderFooter",
+		"headerTemplate",
+		"footerTemplate"
+	]) if (pdfOptions[key] !== void 0) options[key] = pdfOptions[key];
+	return options;
+}
+// src/renderers/api2pdf.renderer.ts
+const PROVIDER$1 = "Api2Pdf";
+const DEFAULT_BASE_URL = "https://v2.api2pdf.com";
+const ROUTE$1 = "/chrome/pdf/html";
+function isApi2Pdf(data) {
+	return typeof data === "object" && data !== null && ("Success" in data || "Error" in data || "FileUrl" in data);
+}
+var Api2PdfRenderer = class {
+	#endpoint;
+	#headers;
+	constructor(provider) {
+		const apiKey = requireNonEmpty(provider.apiKey, "apiKey", PROVIDER$1);
+		const baseUrl = requireNonEmpty(provider.baseUrl ?? DEFAULT_BASE_URL, "baseUrl", PROVIDER$1).replace(/\/+$/, "");
+		this.#endpoint = `${baseUrl}${ROUTE$1}?outputBinary=true`;
+		this.#headers = {
+			...provider.headers,
+			Authorization: apiKey,
+			"Content-Type": "application/json",
+			Accept: "application/pdf, application/json"
+		};
+	}
+	async render(html, options, signal) {
+		assertNoRequestGuard(PROVIDER$1, options, "Only render trusted HTML with a remote provider.");
+		const body = {
+			html,
+			inline: false,
+			options: {
+				...toApi2PdfOptions(options.pdfOptions ?? { format: "A4" }),
+				...options.api2pdfOptions?.options
+			}
+		};
+		if (options.api2pdfOptions?.fileName) body.fileName = options.api2pdfOptions.fileName;
+		const response = await fetch(this.#endpoint, {
+			method: "POST",
+			headers: this.#headers,
+			body: JSON.stringify(body),
+			signal
+		});
+		if (!response.ok) throw await httpError(PROVIDER$1, response);
+		if (!response.headers.get("content-type")?.includes("application/json")) return new Uint8Array(await response.arrayBuffer());
+		const result = await response.json();
+		if (!isApi2Pdf(result)) throw new PdfGenerationException(`${PROVIDER$1} returned an unexpected response: ${JSON.stringify(result)}`);
+		if (result.Success === false || !result.FileUrl) throw new PdfGenerationException(`${PROVIDER$1} could not generate the PDF: ${result.Error ?? "no file returned"}`);
+		const file = await fetch(result.FileUrl, { signal });
+		if (!file.ok) throw await httpError(PROVIDER$1, file);
+		return new Uint8Array(await file.arrayBuffer());
+	}
+};
+// src/renderers/gotenberg.renderer.ts
+const PROVIDER = "Gotenberg";
+const ROUTE = "/forms/chromium/convert/html";
+var GotenbergRenderer = class {
+	#endpoint;
+	#headers;
+	constructor(provider) {
+		const url = requireNonEmpty(provider.url, "url", PROVIDER);
+		this.#endpoint = `${url.replace(/\/+$/, "")}${ROUTE}`;
+		this.#headers = { ...provider.headers };
+		if (provider.basicAuth) {
+			const { username, password } = provider.basicAuth;
+			this.#headers.Authorization = `Basic ${Buffer.from(`${username}:${password}`).toString("base64")}`;
+		}
+	}
+	async render(html, options, signal) {
+		assertNoRequestGuard(PROVIDER, options, "Restrict outbound requests on the Gotenberg server instead, with '--chromium-allow-list' / '--chromium-deny-list'.");
+		const { fields, files } = toGotenbergForm(options.pdfOptions ?? { format: "A4" });
+		const form = new FormData();
+		form.append("files", new Blob([html], { type: "text/html" }), "index.html");
+		for (const [name, content] of Object.entries(files)) form.append("files", new Blob([content], { type: "text/html" }), name);
+		for (const asset of options.gotenbergOptions?.assets ?? []) form.append("files", new Blob([asset.content], { type: asset.contentType ?? "application/octet-stream" }), asset.filename);
+		const allFields = {
+			...fields,
+			...options.gotenbergOptions?.formFields
+		};
+		for (const [name, value] of Object.entries(allFields)) form.append(name, value);
+		const response = await fetch(this.#endpoint, {
+			method: "POST",
+			headers: this.#headers,
+			body: form,
+			signal
+		});
+		if (!response.ok) throw await httpError(PROVIDER, response);
+		return new Uint8Array(await response.arrayBuffer());
+	}
+};
+// src/puppeteer/libs/loadPuppeteer.utils.ts
+function isMissingPackage(error, packageName) {
+	const { code, message } = error;
+	return (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") && typeof message === "string" && message.includes(`'${packageName}'`);
+}
+/** Imports an optional peer dependency, turning "not installed" into a clear exception. */
+async function loadOptional(packageName, importer) {
+	try {
+		return await importer();
+	} catch (error) {
+		if (isMissingPackage(error, packageName)) throw new EngineNotAvailableException("Puppeteer", packageName, { cause: error });
+		throw error;
+	}
+}
+/**
+* Puppeteer is an optional peer dependency, only needed by the `puppeteer`
+* provider: it is imported on first use, never when the library loads.
+*/
+function loadPuppeteer() {
+	return loadOptional("puppeteer", () => import("puppeteer"));
+}
+function loadPuppeteerBrowsers() {
+	return loadOptional("@puppeteer/browsers", () => import("@puppeteer/browsers"));
+}
+// src/helpers/request-guard.helper.ts
 const blockedRanges = new BlockList();
 for (const [address, prefix] of [
 	["0.0.0.0", 8],
@@ -652,6 +928,7 @@ function describe(rawUrl) {
 * and closes the pop-ups a script could open to escape the filter.
 */
 async function installRequestGuard(context, page, options) {
+	const { TargetType } = await loadPuppeteer();
 	context.on("targetcreated", (target) => {
 		if (target.type() === TargetType.PAGE && target.opener()) target.page().then((popup) => popup?.close()).catch(() => void 0);
 	});
@@ -671,31 +948,162 @@ async function installRequestGuard(context, page, options) {
 		})().catch(() => void 0);
 	});
 }
-//#endregion
-//#region src/helpers/tokens.ts
-const PDF_PARAMETERS = "PDF_PARAMETERS";
-//#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateMetadata.js
+// src/renderers/puppeteer.renderer.ts
+const DEFAULT_ARGS = [
+	"--autoplay-policy=user-gesture-required",
+	"--disable-background-networking",
+	"--disable-background-timer-throttling",
+	"--disable-backgrounding-occluded-windows",
+	"--disable-breakpad",
+	"--disable-client-side-phishing-detection",
+	"--disable-component-update",
+	"--disable-default-apps",
+	"--disable-dev-shm-usage",
+	"--disable-domain-reliability",
+	"--disable-extensions",
+	"--disable-features=AudioServiceOutOfProcess",
+	"--disable-hang-monitor",
+	"--disable-ipc-flooding-protection",
+	"--disable-notifications",
+	"--disable-offer-store-unmasked-wallet-cards",
+	"--disable-print-preview",
+	"--disable-prompt-on-repost",
+	"--disable-renderer-backgrounding",
+	"--disable-setuid-sandbox",
+	"--disable-speech-api",
+	"--disable-sync",
+	"--hide-scrollbars",
+	"--ignore-gpu-blacklist",
+	"--metrics-recording-only",
+	"--mute-audio",
+	"--no-default-browser-check",
+	"--no-first-run",
+	"--no-pings",
+	"--password-store=basic",
+	"--use-gl=swiftshader",
+	"--use-mock-keychain",
+	"--disable-accelerated-2d-canvas",
+	"--no-zygote",
+	"--disable-gpu"
+];
+const PDF_OPTION_KEYS = {
+	scale: true,
+	displayHeaderFooter: true,
+	headerTemplate: true,
+	footerTemplate: true,
+	printBackground: true,
+	landscape: true,
+	pageRanges: true,
+	format: true,
+	width: true,
+	height: true,
+	preferCSSPageSize: true,
+	margin: true,
+	path: true,
+	omitBackground: true,
+	tagged: true,
+	outline: true,
+	timeout: true,
+	waitForFonts: true
+};
+function toPuppeteerPdfOptions(options) {
+	if (!options) return { format: "A4" };
+	const invalidKeys = Object.keys(options).filter((key) => !Object.hasOwn(PDF_OPTION_KEYS, key));
+	if (invalidKeys.length > 0) throw new RendererConfigurationException(`Invalid PDF options: ${invalidKeys.join(", ")}. Please check the documentation for valid options.`);
+	return options;
+}
+var PuppeteerRenderer = class {
+	#browserService;
+	constructor(browserService) {
+		this.#browserService = browserService;
+	}
+	async render(html, options, signal) {
+		if (options.chromiumRevision !== void 0) Logger.warn("Using `chromiumRevision` is no longer supported since the puppeteer update.");
+		const pdfOptions = toPuppeteerPdfOptions(options.pdfOptions);
+		const headless = options.headless ?? true;
+		const executablePath = options.executablePath || void 0;
+		const args = options.extraPuppeteerArgs || DEFAULT_ARGS;
+		let context = null;
+		let closing;
+		const onAbort = () => {
+			if (!context) return;
+			closing = context.close();
+			closing.catch(() => void 0);
+		};
+		signal?.addEventListener("abort", onAbort, { once: true });
+		try {
+			context = await this.#browserService.createContext(args, headless, executablePath);
+			signal?.throwIfAborted();
+			const page = await context.newPage();
+			if (options.security) await installRequestGuard(context, page, options.security);
+			await page.setContent(html, { waitUntil: "domcontentloaded" });
+			await page.emulateMediaType("screen");
+			await page.waitForNetworkIdle({
+				idleTime: 500,
+				timeout: 3e4
+			});
+			/* v8 ignore next */
+			await page.evaluate(() => document.fonts.ready);
+			return await page.pdf(pdfOptions);
+		} finally {
+			signal?.removeEventListener("abort", onAbort);
+			if (context) try {
+				if (closing) await closing;
+				else await context.close();
+			} catch (error) {
+				Logger.error(error);
+			}
+		}
+	}
+};
+// src/renderers/create-renderer.ts
+/** True when the PDFs are printed by the local Chromium (the default). */
+function usesPuppeteer(params) {
+	return (params.provider?.type ?? "puppeteer") === "puppeteer";
+}
+function createPdfRenderer(params, browserService) {
+	const provider = params.provider ?? { type: "puppeteer" };
+	switch (provider.type) {
+		case "puppeteer": return new PuppeteerRenderer(browserService);
+		case "gotenberg": return new GotenbergRenderer(provider);
+		case "api2pdf": return new Api2PdfRenderer(provider);
+		default: throw new RendererConfigurationException(`Unknown PDF provider '${String(provider.type)}': expected 'puppeteer', 'gotenberg' or 'api2pdf'`);
+	}
+}
+// src/puppeteer/libs/enum.utils.ts
+/**
+* Converts a string value to an enum member, throwing a RendererConfigurationException if the value is not a valid member of the enum.
+* @param enumObject
+* @param value
+* @param label
+* @throws RendererConfigurationException
+*/
+function toEnumMember(enumObject, value, label) {
+	const members = Object.values(enumObject);
+	const isMember = (candidate) => candidate === value;
+	const member = members.find(isMember);
+	if (member === void 0) throw new RendererConfigurationException(`Unsupported ${label} '${value}': expected one of ${members.map((m) => `'${m}'`).join(", ")}`);
+	return member;
+}
+// \0@oxc-project+runtime@0.156.0/helpers/esm/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-//#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateParam.js
+// \0@oxc-project+runtime@0.156.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
 	};
 }
-//#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
+// \0@oxc-project+runtime@0.156.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
 	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
 	return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-//#endregion
-//#region src/puppeteer/browser/browser.service.ts
+// src/puppeteer/browser/browser.service.ts
+const DEFAULT_BROWSER = "chromium";
 async function sleep(ms) {
 	await new Promise((r) => setTimeout(r, ms));
 }
@@ -747,7 +1155,7 @@ let BrowserService = class BrowserService {
 		} catch (error) {
 			Logger.warn(`Failed to close browser on module destroy: ${error instanceof Error ? error.message : String(error)}`);
 		}
-		if (this.#options?.cleanupBrowserCacheOnExit !== false) await this.#cleanupCacheBestEffort();
+		if (this.#options !== void 0 && usesPuppeteer(this.#options) && this.#options.cleanupBrowserCacheOnExit !== false) await this.#cleanupCacheBestEffort();
 	}
 	/** Wait until no PDF job is in flight, or until the timeout elapses. */
 	async #waitForIdle(timeoutMs) {
@@ -829,7 +1237,8 @@ let BrowserService = class BrowserService {
 		}
 	}
 	async #doInstall(lock) {
-		const browser = this.#browser;
+		const { Browser: BrowserEnum, BrowserPlatform, canDownload, detectBrowserPlatform, install, resolveBuildId } = await loadPuppeteerBrowsers();
+		const browser = toEnumMember(BrowserEnum, this.#browser, "browser");
 		const versionTag = this.#browserTag;
 		const browserPlatform = detectBrowserPlatform() ?? BrowserPlatform.LINUX;
 		let buildId;
@@ -861,10 +1270,7 @@ let BrowserService = class BrowserService {
 		return null;
 	}
 	#loadBrowser() {
-		let browser;
-		if (this.#options?.browser === void 0) browser = Browser$1.CHROMIUM;
-		else browser = this.#options.browser;
-		this.#browser = browser;
+		this.#browser = this.#options?.browser ?? DEFAULT_BROWSER;
 	}
 	getBrowser() {
 		return this.#browser;
@@ -872,7 +1278,7 @@ let BrowserService = class BrowserService {
 	#loadBrowserTag() {
 		let versionTag;
 		if (this.#options?.browserTag === void 0) {
-			if (this.#browser === Browser$1.CHROMIUM) versionTag = "latest";
+			if (this.#browser === DEFAULT_BROWSER) versionTag = "latest";
 			else versionTag = "stable";
 		} else versionTag = this.#options.browserTag;
 		this.#browserTag = versionTag;
@@ -899,12 +1305,15 @@ let BrowserService = class BrowserService {
 		this.#useLockedBrowser = useLockedBrowser;
 	}
 	async hasBrowserInstalled(browser, buildId) {
+		const { Browser: BrowserEnum, getInstalledBrowsers } = await loadPuppeteerBrowsers();
+		const expected = toEnumMember(BrowserEnum, browser, "browser");
 		return (await getInstalledBrowsers({ cacheDir: this.#cacheDir })).find((insBrowser) => {
-			return insBrowser.browser === browser && insBrowser.buildId === buildId;
+			return insBrowser.browser === expected && insBrowser.buildId === buildId;
 		}) !== void 0;
 	}
 	async getExecutablePath() {
-		const browser = this.#browser;
+		const { Browser: BrowserEnum, BrowserPlatform, detectBrowserPlatform, getInstalledBrowsers, resolveBuildId } = await loadPuppeteerBrowsers();
+		const browser = toEnumMember(BrowserEnum, this.#browser, "browser");
 		const versionTag = this.#browserTag;
 		const browserPlatform = detectBrowserPlatform() ?? BrowserPlatform.LINUX;
 		let buildId = null;
@@ -925,6 +1334,7 @@ let BrowserService = class BrowserService {
 	}
 	async #launchBrowser(args, headless, executablePathBin) {
 		const executablePath = executablePathBin ?? await this.getExecutablePath();
+		const { launch } = await loadPuppeteer();
 		const browser = await launch({
 			executablePath,
 			headless,
@@ -961,12 +1371,33 @@ BrowserService = __decorate([
 	__decorateParam(0, Inject("PDF_PARAMETERS")),
 	__decorateMetadata("design:paramtypes", [Object])
 ], BrowserService);
-//#endregion
-//#region src/puppeteer/engines/ejs/ejs.service.ts
+// src/puppeteer/libs/loadEngine.utils.ts
+const requireEngine = createRequire(import.meta.url);
+/**
+* Load an optional template engine on first use, so the library can be imported
+* without every engine installed. `require` (not `import()`) is used on purpose:
+* most engines expose a synchronous render API.
+*/
+function loadEngine(packageName, engineName) {
+	let mod;
+	try {
+		mod = requireEngine(packageName);
+	} catch (error) {
+		if (error.code === "MODULE_NOT_FOUND") throw new EngineNotAvailableException(engineName, packageName, { cause: error });
+		throw error;
+	}
+	return mod.__esModule && "default" in mod ? mod.default : mod;
+}
+// src/puppeteer/engines/ejs/ejs.service.ts
 let EjsService = class EjsService {
+	#ejs;
+	get #engine() {
+		return this.#ejs ??= loadEngine("ejs", "EJS");
+	}
 	async render(template, data = {}, options) {
+		const engine = this.#engine;
 		try {
-			return await ejs.render(template, data, {
+			return await engine.render(template, data, {
 				async: true,
 				...options
 			});
@@ -975,8 +1406,9 @@ let EjsService = class EjsService {
 		}
 	}
 	async renderFile(filePath, data = {}, options) {
+		const engine = this.#engine;
 		try {
-			return await ejs.renderFile(filePath, data, {
+			return await engine.renderFile(filePath, data, {
 				async: true,
 				...options
 			});
@@ -986,18 +1418,14 @@ let EjsService = class EjsService {
 	}
 };
 EjsService = __decorate([Injectable()], EjsService);
-//#endregion
-//#region src/puppeteer/engines/eta/eta.service.ts
+// src/puppeteer/engines/eta/eta.service.ts
 let EtaService = class EtaService {
+	#etaModule;
 	#eta;
 	#templateCache = /* @__PURE__ */ new Map();
 	#maxCacheSize = 100;
-	constructor() {
-		this.#eta = new Eta({
-			cache: true,
-			autoEscape: true,
-			useWith: true
-		});
+	get #engine() {
+		return this.#etaModule ??= loadEngine("eta", "Eta");
 	}
 	/**
 	* Render an Eta template from a string
@@ -1007,6 +1435,7 @@ let EtaService = class EtaService {
 	* @returns The rendered HTML string
 	*/
 	render(template, data = {}, options) {
+		const { Eta } = this.#engine;
 		try {
 			return (options && Object.keys(options).length > 0 ? new Eta({
 				cache: true,
@@ -1014,7 +1443,11 @@ let EtaService = class EtaService {
 				useWith: true,
 				...options,
 				varName: options.varName ?? "it"
-			}) : this.#eta).renderString(template, data);
+			}) : this.#eta ??= new Eta({
+				cache: true,
+				autoEscape: true,
+				useWith: true
+			})).renderString(template, data);
 		} catch (error) {
 			throw new TemplateRenderException("Eta", `Eta rendering failed: ${String(error)}`, { cause: error });
 		}
@@ -1037,6 +1470,7 @@ let EtaService = class EtaService {
 			}
 			return this.render(template, data, options);
 		} catch (error) {
+			if (error instanceof EngineNotAvailableException) throw error;
 			throw new TemplateRenderException("Eta", `Eta file rendering failed for ${filePath}: ${String(error)}`, { cause: error });
 		}
 	}
@@ -1054,12 +1488,15 @@ let EtaService = class EtaService {
 		return this.#templateCache.size;
 	}
 };
-EtaService = __decorate([Injectable(), __decorateMetadata("design:paramtypes", [])], EtaService);
-//#endregion
-//#region src/puppeteer/engines/handlebars/handlebars.service.ts
+EtaService = __decorate([Injectable()], EtaService);
+// src/puppeteer/engines/handlebars/handlebars.service.ts
 let HandlebarsService = class HandlebarsService {
+	#handlebars;
 	#cachedOptions;
 	#cachedEnv;
+	get #engine() {
+		return this.#handlebars ??= loadEngine("handlebars", "Handlebars");
+	}
 	render(template, parameters = {}, options = {}) {
 		try {
 			return this.#getEnv(options).compile(template, options.compileOptions)(parameters, options.templateOptions);
@@ -1088,7 +1525,7 @@ let HandlebarsService = class HandlebarsService {
 	*/
 	#getEnv(options) {
 		if (this.#cachedEnv && this.#cachedOptions === options) return this.#cachedEnv;
-		const env = Handlebars.create();
+		const env = this.#engine.create();
 		for (const helper of options.helpers ?? []) env.registerHelper(helper.name, helper.fn);
 		this.#registerPartials(env, options.partialDirectory);
 		this.#cachedOptions = options;
@@ -1107,12 +1544,77 @@ let HandlebarsService = class HandlebarsService {
 	}
 };
 HandlebarsService = __decorate([Injectable()], HandlebarsService);
-//#endregion
-//#region src/puppeteer/engines/mjml/mjml.service.ts
+// src/puppeteer/engines/liquid/liquid.service.ts
+let LiquidService = class LiquidService {
+	#liquidModule;
+	#liquid;
+	#templateCache = /* @__PURE__ */ new Map();
+	#maxCacheSize = 100;
+	get #engine() {
+		return this.#liquidModule ??= loadEngine("liquidjs", "Liquid");
+	}
+	/**
+	* Render a Liquid template from a string
+	* @param template The template string to render
+	* @param data The data object to use for rendering
+	* @param options Optional Liquid engine options
+	* @returns The rendered HTML string
+	*/
+	render(template, data = {}, options) {
+		const { Liquid } = this.#engine;
+		try {
+			return (options && Object.keys(options).length > 0 ? new Liquid(options) : this.#liquid ??= new Liquid()).parseAndRenderSync(template, data);
+		} catch (error) {
+			throw new TemplateRenderException("Liquid", `Liquid rendering failed: ${String(error)}`, { cause: error });
+		}
+	}
+	/**
+	* Render a Liquid template from a file
+	* @param filePath The path to the template file
+	* @param data The data object to use for rendering
+	* @param options Optional Liquid engine options
+	* @returns The rendered HTML string
+	*/
+	renderFile(filePath, data = {}, options) {
+		try {
+			const resolvedPath = resolve(filePath);
+			const useCache = options?.cache !== false;
+			let template = useCache ? this.#templateCache.get(resolvedPath) : void 0;
+			if (!template) {
+				template = readFileSync(resolvedPath, "utf-8");
+				if (useCache && this.#templateCache.size < this.#maxCacheSize) this.#templateCache.set(resolvedPath, template);
+			}
+			return this.render(template, data, options);
+		} catch (error) {
+			if (error instanceof EngineNotAvailableException) throw error;
+			throw new TemplateRenderException("Liquid", `Liquid file rendering failed for ${filePath}: ${String(error)}`, { cause: error });
+		}
+	}
+	/**
+	* Clear the template cache
+	*/
+	clearCache() {
+		this.#templateCache.clear();
+	}
+	/**
+	* Get the current cache size
+	* @returns The number of cached templates
+	*/
+	getCacheSize() {
+		return this.#templateCache.size;
+	}
+};
+LiquidService = __decorate([Injectable()], LiquidService);
+// src/puppeteer/engines/mjml/mjml.service.ts
 let MjmlService = class MjmlService {
+	#mjml;
+	get #engine() {
+		return this.#mjml ??= loadEngine("mjml", "MJML");
+	}
 	async render(template, options) {
+		const engine = this.#engine;
 		try {
-			const { html } = await mjml(template, options);
+			const { html } = await engine(template, options);
 			return html;
 		} catch (error) {
 			throw new TemplateRenderException("MJML", `MJML rendering failed: ${String(error)}`, { cause: error });
@@ -1129,11 +1631,14 @@ let MjmlService = class MjmlService {
 	}
 };
 MjmlService = __decorate([Injectable()], MjmlService);
-//#endregion
-//#region src/puppeteer/engines/mustache/mustache.service.ts
+// src/puppeteer/engines/mustache/mustache.service.ts
 let MustacheService = class MustacheService {
+	#mustache;
 	#templateCache = /* @__PURE__ */ new Map();
 	#maxCacheSize = 100;
+	get #engine() {
+		return this.#mustache ??= loadEngine("mustache", "Mustache");
+	}
 	/**
 	* Render a Mustache template from a string
 	* @param template The template string to render
@@ -1142,9 +1647,10 @@ let MustacheService = class MustacheService {
 	* @returns The rendered HTML string
 	*/
 	render(template, data = {}, options) {
+		const engine = this.#engine;
 		try {
 			const tags = options?.tags ?? ["{{", "}}"];
-			return mustache.render(template, data, void 0, {
+			return engine.render(template, data, void 0, {
 				tags,
 				escape: options?.escape
 			});
@@ -1169,6 +1675,7 @@ let MustacheService = class MustacheService {
 			}
 			return this.render(template, data, options);
 		} catch (error) {
+			if (error instanceof EngineNotAvailableException) throw error;
 			throw new TemplateRenderException("Mustache", `Mustache file rendering failed for ${filePath}: ${String(error)}`, { cause: error });
 		}
 	}
@@ -1187,17 +1694,22 @@ let MustacheService = class MustacheService {
 	}
 };
 MustacheService = __decorate([Injectable()], MustacheService);
-//#endregion
-//#region src/puppeteer/engines/nunjucks/nunjucks.service.ts
+// src/puppeteer/engines/nunjucks/nunjucks.service.ts
 let NunjucksService = class NunjucksService {
-	constructor() {
-		nunjucks.configure({
-			noCache: true,
-			trimBlocks: true,
-			lstripBlocks: true
-		});
+	#nunjucks;
+	get #engine() {
+		if (!this.#nunjucks) {
+			this.#nunjucks = loadEngine("nunjucks", "Nunjucks");
+			this.#nunjucks.configure({
+				noCache: true,
+				trimBlocks: true,
+				lstripBlocks: true
+			});
+		}
+		return this.#nunjucks;
 	}
 	render(template, data = {}, options) {
+		const nunjucks = this.#engine;
 		try {
 			if (options) {
 				const configOptions = {
@@ -1215,6 +1727,7 @@ let NunjucksService = class NunjucksService {
 		}
 	}
 	renderFile(filePath, data = {}, options) {
+		const nunjucks = this.#engine;
 		try {
 			if (options) {
 				const configOptions = {
@@ -1232,13 +1745,17 @@ let NunjucksService = class NunjucksService {
 		}
 	}
 };
-NunjucksService = __decorate([Injectable(), __decorateMetadata("design:paramtypes", [])], NunjucksService);
-//#endregion
-//#region src/puppeteer/engines/pug/pug.service.ts
+NunjucksService = __decorate([Injectable()], NunjucksService);
+// src/puppeteer/engines/pug/pug.service.ts
 let PugService = class PugService {
+	#pug;
+	get #engine() {
+		return this.#pug ??= loadEngine("pug", "Pug");
+	}
 	render(template, data = {}, options) {
+		const engine = this.#engine;
 		try {
-			return pug.compile(template, { ...options })(data);
+			return engine.compile(template, { ...options })(data);
 		} catch (error) {
 			throw new TemplateRenderException("Pug", `Pug rendering failed: ${String(error)}`, { cause: error });
 		}
@@ -1248,21 +1765,21 @@ let PugService = class PugService {
 			const template = readFileSync(filePath, "utf-8");
 			return this.render(template, data, options);
 		} catch (error) {
+			if (error instanceof EngineNotAvailableException) throw error;
 			throw new TemplateRenderException("Pug", `Pug file rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 };
 PugService = __decorate([Injectable()], PugService);
-//#endregion
-//#region src/puppeteer/libs/requireService.utils.ts
+// src/puppeteer/libs/requireService.utils.ts
 function requireService(service, name) {
 	if (!service) throw new EngineNotAvailableException(name);
 	return service;
 }
-//#endregion
-//#region src/puppeteer/puppeteer.service.ts
+// src/puppeteer/puppeteer.service.ts
 let PuppeteerService = class PuppeteerService {
-	#browserService;
+	#renderer;
+	#jobs;
 	#options;
 	#hbsService;
 	#mjmlService;
@@ -1271,8 +1788,10 @@ let PuppeteerService = class PuppeteerService {
 	#nunjucksService;
 	#etaService;
 	#mustacheService;
-	constructor(browserService, options, hbsService, mjmlService, pugService, ejsService, nunjucksService, etaService, mustacheService) {
-		this.#browserService = browserService;
+	#liquidService;
+	constructor(renderer, jobs, options, hbsService, mjmlService, pugService, ejsService, nunjucksService, etaService, mustacheService, liquidService) {
+		this.#renderer = renderer;
+		this.#jobs = jobs;
 		this.#options = options;
 		this.#hbsService = hbsService;
 		this.#mjmlService = mjmlService;
@@ -1281,6 +1800,7 @@ let PuppeteerService = class PuppeteerService {
 		this.#nunjucksService = nunjucksService;
 		this.#etaService = etaService;
 		this.#mustacheService = mustacheService;
+		this.#liquidService = liquidService;
 	}
 	#limit = pLimit(3);
 	async generatePdfFromHtml(html, options) {
@@ -1290,87 +1810,19 @@ let PuppeteerService = class PuppeteerService {
 		const job = this.#limit(async () => {
 			signal?.throwIfAborted();
 			started = true;
-			const mergePuppeteerOptions = mergePuppeteerParameters(this.#options, options);
-			if (mergePuppeteerOptions.chromiumRevision !== void 0) Logger.warn("Using `chromiumRevision` is no longer supported since the puppeteer update.");
-			const headless = mergePuppeteerOptions.headless ?? true;
-			const executablePath = mergePuppeteerOptions.executablePath || void 0;
-			const args = mergePuppeteerOptions.extraPuppeteerArgs || [
-				"--autoplay-policy=user-gesture-required",
-				"--disable-background-networking",
-				"--disable-background-timer-throttling",
-				"--disable-backgrounding-occluded-windows",
-				"--disable-breakpad",
-				"--disable-client-side-phishing-detection",
-				"--disable-component-update",
-				"--disable-default-apps",
-				"--disable-dev-shm-usage",
-				"--disable-domain-reliability",
-				"--disable-extensions",
-				"--disable-features=AudioServiceOutOfProcess",
-				"--disable-hang-monitor",
-				"--disable-ipc-flooding-protection",
-				"--disable-notifications",
-				"--disable-offer-store-unmasked-wallet-cards",
-				"--disable-print-preview",
-				"--disable-prompt-on-repost",
-				"--disable-renderer-backgrounding",
-				"--disable-setuid-sandbox",
-				"--disable-speech-api",
-				"--disable-sync",
-				"--hide-scrollbars",
-				"--ignore-gpu-blacklist",
-				"--metrics-recording-only",
-				"--mute-audio",
-				"--no-default-browser-check",
-				"--no-first-run",
-				"--no-pings",
-				"--password-store=basic",
-				"--use-gl=swiftshader",
-				"--use-mock-keychain",
-				"--disable-accelerated-2d-canvas",
-				"--no-zygote",
-				"--disable-gpu"
-			];
-			this.#browserService.markJobStarted();
-			let context = null;
-			let closing;
-			const onAbort = () => {
-				if (!context) return;
-				closing = context.close();
-				closing.catch(() => void 0);
-			};
-			signal?.addEventListener("abort", onAbort, { once: true });
+			const mergedOptions = mergePuppeteerParameters(this.#options, options);
+			this.#jobs.markJobStarted();
 			try {
-				context = await this.#browserService.createContext(args, headless, executablePath);
+				const pdf = await this.#renderer.render(html, mergedOptions, signal);
 				signal?.throwIfAborted();
-				const page = await context.newPage();
-				if (mergePuppeteerOptions.security) await installRequestGuard(context, page, mergePuppeteerOptions.security);
-				const pdfOptions = mergePuppeteerOptions.pdfOptions ?? { format: "A4" };
-				await page.setContent(html, { waitUntil: "domcontentloaded" });
-				await page.emulateMediaType("screen");
-				await page.waitForNetworkIdle({
-					idleTime: 500,
-					timeout: 3e4
-				});
-				/* v8 ignore next */
-				await page.evaluate(() => document.fonts.ready);
-				const pdf = await page.pdf(pdfOptions);
-				signal?.throwIfAborted();
-				return mergePuppeteerOptions.watermark ? await addWatermark(pdf, mergePuppeteerOptions.watermark) : pdf;
+				return mergedOptions.watermark ? await addWatermark(pdf, mergedOptions.watermark) : pdf;
 			} catch (e) {
 				if (signal?.aborted) throw signal.reason;
 				Logger.error(e);
 				if (e instanceof NestjsPdfException) throw e;
 				throw new PdfGenerationException(`PDF generation failed: ${String(e)}`, { cause: e });
 			} finally {
-				signal?.removeEventListener("abort", onAbort);
-				if (context) try {
-					if (closing) await closing;
-					else await context.close();
-				} catch (error) {
-					Logger.error(error);
-				}
-				await this.#browserService.markJobFinished();
+				await this.#jobs.markJobFinished();
 			}
 		});
 		if (!signal) return job;
@@ -1443,19 +1895,31 @@ let PuppeteerService = class PuppeteerService {
 		const html = requireService(this.#mustacheService, "Mustache").renderFile(file, data, options?.mustacheOptions ?? this.#options.mustacheOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
+	async generatePdfFromLiquidString(template, data = {}, options) {
+		const html = requireService(this.#liquidService, "Liquid").render(template, data, options?.liquidOptions ?? this.#options.liquidOptions);
+		return this.generatePdfFromHtml(html, options);
+	}
+	async generatePdfFromLiquidFile(file, data = {}, options) {
+		const html = requireService(this.#liquidService, "Liquid").renderFile(file, data, options?.liquidOptions ?? this.#options.liquidOptions);
+		return this.generatePdfFromHtml(html, options);
+	}
 };
 PuppeteerService = __decorate([
 	Injectable(),
-	__decorateParam(1, Inject(PDF_PARAMETERS)),
-	__decorateParam(2, Optional()),
+	__decorateParam(0, Inject(PDF_RENDERER)),
+	__decorateParam(1, Inject(BrowserService)),
+	__decorateParam(2, Inject(PDF_PARAMETERS)),
 	__decorateParam(3, Optional()),
 	__decorateParam(4, Optional()),
 	__decorateParam(5, Optional()),
 	__decorateParam(6, Optional()),
 	__decorateParam(7, Optional()),
 	__decorateParam(8, Optional()),
+	__decorateParam(9, Optional()),
+	__decorateParam(10, Optional()),
 	__decorateMetadata("design:paramtypes", [
-		typeof BrowserService === "undefined" ? Object : BrowserService,
+		Object,
+		Object,
 		Object,
 		typeof HandlebarsService === "undefined" ? Object : HandlebarsService,
 		typeof MjmlService === "undefined" ? Object : MjmlService,
@@ -1463,11 +1927,11 @@ PuppeteerService = __decorate([
 		typeof EjsService === "undefined" ? Object : EjsService,
 		typeof NunjucksService === "undefined" ? Object : NunjucksService,
 		typeof EtaService === "undefined" ? Object : EtaService,
-		typeof MustacheService === "undefined" ? Object : MustacheService
+		typeof MustacheService === "undefined" ? Object : MustacheService,
+		typeof LiquidService === "undefined" ? Object : LiquidService
 	])
 ], PuppeteerService);
-//#endregion
-//#region src/nestjs-pdf.service.ts
+// src/nestjs-pdf.service.ts
 let NestjsPdfService = class NestjsPdfService {
 	#puppeteerService;
 	constructor(puppeteerService) {
@@ -1621,6 +2085,26 @@ let NestjsPdfService = class NestjsPdfService {
 		return this.#puppeteerService.generatePdfFromMustacheFile(file, data, options);
 	}
 	/**
+	* @param template Liquid template string
+	* @param data Data to inject into the template
+	* @param options PDF generation options (optional)
+	* @returns PDF generated from the provided Liquid template with data applied
+	* @description This method generates a PDF from a Liquid template provided as a string. Liquid is a safe, Shopify-compatible template language with filters, tags, partials and layouts. The data to inject into the template is passed in the `data` object, which is used to render the template before converting it to PDF. PDF generation options can be customized by passing a `PuppeteerParameters` object as the third argument.
+	*/
+	generatePdfFromLiquidString(template, data = {}, options) {
+		return this.#puppeteerService.generatePdfFromLiquidString(template, data, options);
+	}
+	/**
+	* @param file Path to the Liquid template file
+	* @param data Data to inject into the template
+	* @param options PDF generation options (optional)
+	* @returns PDF generated from the Liquid template at the provided file path with data applied
+	* @description This method generates a PDF from a Liquid template located at the specified file path. The file path is passed as a string in the `file` parameter. The data to inject into the template is passed in the `data` object, which is used to render the template before converting it to PDF. PDF generation options can be customized by passing a `PuppeteerParameters` object as the third argument.
+	*/
+	generatePdfFromLiquidFile(file, data = {}, options) {
+		return this.#puppeteerService.generatePdfFromLiquidFile(file, data, options);
+	}
+	/**
 	* @param pdf The PDF bytes to modify
 	* @param fieldName The name of the signature field to add (default: 'SignatureDebtor')
 	* @param anchorText The text anchor to locate the signature field position (default: '__SIG_DEBTOR_ANCHOR__')
@@ -1667,9 +2151,14 @@ let NestjsPdfService = class NestjsPdfService {
 	}
 };
 NestjsPdfService = __decorate([Injectable(), __decorateMetadata("design:paramtypes", [typeof PuppeteerService === "undefined" ? Object : PuppeteerService])], NestjsPdfService);
-//#endregion
-//#region src/puppeteer/puppeteer.module.ts
+// src/puppeteer/puppeteer.module.ts
 var _PuppeteerModule;
+/** Builds the renderer of the configured provider, once the parameters are known. */
+const pdfRendererProvider = {
+	provide: PDF_RENDERER,
+	inject: [PDF_PARAMETERS, BrowserService],
+	useFactory: createPdfRenderer
+};
 let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 	#browserService;
 	#pdfParams;
@@ -1678,7 +2167,12 @@ let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 		this.#pdfParams = pdfParams;
 	}
 	async onModuleInit() {
-		if (!this.#pdfParams.executablePath) await this.#browserService.install(this.#pdfParams.useLockedBrowser ?? false);
+		if (!usesPuppeteer(this.#pdfParams)) return;
+		await loadPuppeteer();
+		if (!this.#pdfParams.executablePath) {
+			await loadPuppeteerBrowsers();
+			await this.#browserService.install(this.#pdfParams.useLockedBrowser ?? false);
+		}
 	}
 	static forRoot(pdfParameters) {
 		return {
@@ -1694,7 +2188,8 @@ let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 				EjsService,
 				NunjucksService,
 				EtaService,
-				MustacheService
+				MustacheService,
+				LiquidService
 			],
 			exports: [
 				PuppeteerService,
@@ -1703,7 +2198,8 @@ let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 				EjsService,
 				NunjucksService,
 				EtaService,
-				MustacheService
+				MustacheService,
+				LiquidService
 			]
 		};
 	}
@@ -1720,13 +2216,15 @@ let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 				pdfParamsProvider,
 				PuppeteerService,
 				BrowserService,
+				pdfRendererProvider,
 				HandlebarsService,
 				MjmlService,
 				PugService,
 				EjsService,
 				NunjucksService,
 				EtaService,
-				MustacheService
+				MustacheService,
+				LiquidService
 			],
 			exports: [
 				PuppeteerService,
@@ -1735,7 +2233,8 @@ let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 				EjsService,
 				NunjucksService,
 				EtaService,
-				MustacheService
+				MustacheService,
+				LiquidService
 			]
 		};
 	}
@@ -1745,12 +2244,14 @@ PuppeteerModule = _PuppeteerModule = __decorate([
 		providers: [
 			PuppeteerService,
 			BrowserService,
+			pdfRendererProvider,
 			MjmlService,
 			PugService,
 			EjsService,
 			NunjucksService,
 			EtaService,
-			MustacheService
+			MustacheService,
+			LiquidService
 		],
 		exports: [
 			PuppeteerService,
@@ -1759,14 +2260,15 @@ PuppeteerModule = _PuppeteerModule = __decorate([
 			EjsService,
 			NunjucksService,
 			EtaService,
-			MustacheService
+			MustacheService,
+			LiquidService
 		]
 	}),
+	__decorateParam(0, Inject(BrowserService)),
 	__decorateParam(1, Inject(PDF_PARAMETERS)),
-	__decorateMetadata("design:paramtypes", [typeof BrowserService === "undefined" ? Object : BrowserService, Object])
+	__decorateMetadata("design:paramtypes", [Object, Object])
 ], PuppeteerModule);
-//#endregion
-//#region src/nestjs-pdf.module.ts
+// src/nestjs-pdf.module.ts
 var _NestjsPdfModule;
 let NestjsPdfModule = _NestjsPdfModule = class NestjsPdfModule {
 	static forRoot(options) {
@@ -1787,7 +2289,6 @@ let NestjsPdfModule = _NestjsPdfModule = class NestjsPdfModule {
 	}
 };
 NestjsPdfModule = _NestjsPdfModule = __decorate([Module({})], NestjsPdfModule);
-//#endregion
-export { BrowserInstallationException, BrowserUnavailableException, EjsService, EngineNotAvailableException, EtaService, HandlebarsService, MjmlService, MustacheService, NestjsPdfErrorCode, NestjsPdfException, NestjsPdfModule, NestjsPdfService, NunjucksService, PdfGenerationException, PugService, PuppeteerModule, PuppeteerService, SignatureDependencyException, SignaturePlacementException, TemplateConfigurationException, TemplateRenderException, WatermarkException, getRelativePathToValue };
+export { BrowserInstallationException, BrowserUnavailableException, EjsService, EngineNotAvailableException, EtaService, HandlebarsService, LiquidService, MjmlService, MustacheService, NestjsPdfErrorCode, NestjsPdfException, NestjsPdfModule, NestjsPdfService, NunjucksService, PdfGenerationException, PugService, PuppeteerModule, PuppeteerService, RendererConfigurationException, SignatureDependencyException, SignaturePlacementException, TemplateConfigurationException, TemplateRenderException, WatermarkException, getRelativePathToValue };
 
 //# sourceMappingURL=index.mjs.map