@shad0wz7/nestjs-pdf 3.2.0 → 4.0.0

package/README.md

@@ -1,18 +1,5 @@
 # nestjs-pdf
 
-> **v3 — ESM-first, NestJS 10, 11 & 12.** This is the active `main` line: authored
-> in ESM, published as a dual CJS/ESM package, and supports **NestJS 10, 11 and 12**.
->
-> Need a pure CommonJS package or a Node.js version older than `20.19`? Use the
-> maintenance `v2` branch instead:
->
-> ```bash
-> npm install @shad0wz7/nestjs-pdf@^2
-> ```
->
-> See the [`v2` branch README](https://github.com/ShadowZ11/nestjs-pdf/blob/v2/README.md)
-> for details. It receives maintenance/security fixes only — new features land on v3.
-
 [![npm version](https://img.shields.io/npm/v/%40shad0wz7%2Fnestjs-pdf?label=npm%20version)](https://www.npmjs.com/package/%40shad0wz7%2Fnestjs-pdf)
 [![NPM License](https://img.shields.io/npm/l/%40shad0wz7%2Fnestjs-pdf)](https://github.com/ShadowZ11/nestjs-pdf?tab=MIT-1-ov-file)
 [![npm downloads](https://img.shields.io/npm/dm/%40shad0wz7%2Fnestjs-pdf?label=npm%20downloads)](https://www.npmjs.com/package/%40shad0wz7%2Fnestjs-pdf)
@@ -20,11 +7,11 @@
 [![codecov](https://codecov.io/github/ShadowZ11/nestjs-pdf/graph/badge.svg?token=K0MNB1ZKYK)](https://codecov.io/github/ShadowZ11/nestjs-pdf)
 [![TypeScript](https://img.shields.io/badge/TypeScript-6.0.3-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 
-A NestJS library to generate and manipulate PDFs using Puppeteer and multiple template engines, including Handlebars, EJS, Pug, MJML, Nunjucks, Eta and Mustache.
+A NestJS library to generate and manipulate PDFs using Puppeteer and multiple template engines, including Handlebars, EJS, Pug, MJML, Nunjucks, Eta, Mustache and Liquid.
 
 Main features:
 
-- Generate PDFs from HTML, Handlebars, EJS, Pug, MJML, Nunjucks, Eta or Mustache templates
+- Generate PDFs from HTML, Handlebars, EJS, Pug, MJML, Nunjucks, Eta, Mustache or Liquid templates
 - Concurrency limiting for Puppeteer jobs (p-limit)
 - Add signature fields based on a text anchor in an existing PDF
 - Text or image watermarks (centered or tiled) on generated or existing PDFs
@@ -50,19 +37,39 @@ yarn add @shad0wz7/nestjs-pdf
 pnpm add ../path/to/nestjs-pdf
 ```
 
-## Quick start
+### Template engines
 
-Import the module and configure it in your Nest application:
+Template engines are **optional peer dependencies**: none of them is installed with the library. Install only the ones you use, as dependencies of your own project:
+
+| Engine     | Package to install |
+| ---------- | ------------------ |
+| Handlebars | `handlebars`       |
+| EJS        | `ejs`              |
+| Pug        | `pug`              |
+| MJML       | `mjml`             |
+| Nunjucks   | `nunjucks`         |
+| Eta        | `eta`              |
+| Mustache   | `mustache`         |
+| Liquid     | `liquidjs`         |
+
+```bash
+# e.g. to render Handlebars templates
+npm install handlebars
+```
+
+Engines are loaded lazily, the first time you render a template with them: your application starts fine with any subset of engines installed. Rendering with an engine whose package is missing throws an `EngineNotAvailableException` (code `ENGINE_NOT_AVAILABLE`) telling you what to install:
+
+```text
+Pug engine is not available: the 'pug' package is not installed. Run `npm install pug` to use it.
+```
 
-To use a template engine, you need to install the corresponding package as a dependency in your project:
+Anchor-based signature placement also relies on `pdfjs-dist`, which needs `@napi-rs/canvas` to be installed in your project (see the signature example in [Quick start](#quick-start)).
 
-- For Handlebars: `npm install handlebars`
-- For EJS: `npm install ejs`
-- For Pug: `npm install pug`
-- For MJML: `npm install mjml`
-- For Nunjucks: `npm install nunjucks`
-- For Eta: `npm install eta`
-- For Mustache: `npm install mustache`
+> **Upgrading from v3:** engines used to be installed automatically. If you relied on that, add the engines you use to your project's dependencies.
+
+## Quick start
+
+Import the module and configure it in your Nest application:
 
 ```ts
 import { Module } from '@nestjs/common';
@@ -244,6 +251,7 @@ The library exposes Puppeteer options via the `PuppeteerParameters` interface (s
 | `nunjucksOptions`           | The nunjucks options can be found on [Nunjucks documentation](https://mozilla.github.io/nunjucks/api.html#configure)                                                                                                                                                                                                                                                                                                 |
 | `etaOptions`                | The eta options can be found on [Eta documentation](https://eta.js.org/docs/4.x.x/api/configuration)                                                                                                                                                                                                                                                                                                                 |
 | `mustacheOptions`           | The mustache options can be found on [Mustache documentation](https://mustache.github.io/mustache.5.html)                                                                                                                                                                                                                                                                                                            |
+| `liquidOptions`             | The liquid options can be found on [LiquidJS documentation](https://liquidjs.com/tutorials/options.html)                                                                                                                                                                                                                                                                                                             |
 | `browser`                   | The browser to use for the PDF generation. By default: `Browser.CHROMIUM`. Allowed values `Browser.CHROMIUM`, `Browser.CHROMEHEADLESSSHELL`, `Browser.CHROME`, `Browser.FIREFOX`, `Browser.CHROMEDRIVER` ([Official documentation of Browser](https://pptr.dev/browsers-api/browsers.browser))                                                                                                                       |
 | `browserTag`                | The version of the browser to use for the PDF generation. By default: `BrowserTag.LATEST` if Browser is **CHROMIUM** else `BrowserTag.STABLE`. Allowed values `BrowserTag.STABLE`, `BrowserTag.LATEST`, `BrowserTag.BETA`, `BrowserTag.DEV`, `BrowserTag.CANARY`                                                                                                                                                     |
 | `browserInstallBaseUrl`     | The baseUrl used for the installation of the browser. This baseUrl is passed to the [`install`](https://pptr.dev/browsers-api/browsers.install) method of `@puppeteer/browsers`                                                                                                                                                                                                                                      |
@@ -300,7 +308,7 @@ You can use `forRootAsync(...)` if you need to provide configuration asynchronou
 
 ## Error handling
 
-All errors thrown by the library (missing template engine, template rendering failures, browser installation issues, PDF generation failures, signature placement issues, ...) are typed exceptions extending the abstract `NestjsPdfException` class, exported from the package root alongside a stable `NestjsPdfErrorCode` enum:
+All errors thrown by the library (missing template engine, template rendering failures, browser installation issues, PDF generation failures, signature placement issues, invalid watermarks, ...) are typed exceptions extending the abstract `NestjsPdfException` class, exported from the package root alongside a stable `NestjsPdfErrorCode` enum:
 
 ```typescript
 import {

package/dist/index.cjs

@@ -1,26 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
 let node_path = require("node:path");
 let _nestjs_common = require("@nestjs/common");
 let pdf_lib = require("pdf-lib");
@@ -31,19 +9,7 @@ let node_net = require("node:net");
 let node_url = require("node:url");
 let puppeteer = require("puppeteer");
 let _puppeteer_browsers = require("@puppeteer/browsers");
-let ejs = require("ejs");
-ejs = __toESM(ejs, 1);
-let eta = require("eta");
-let handlebars = require("handlebars");
-handlebars = __toESM(handlebars, 1);
-let mjml = require("mjml");
-mjml = __toESM(mjml, 1);
-let mustache = require("mustache");
-mustache = __toESM(mustache, 1);
-let nunjucks = require("nunjucks");
-nunjucks = __toESM(nunjucks, 1);
-let pug = require("pug");
-pug = __toESM(pug, 1);
+let node_module = require("node:module");
 //#region src/exceptions/nestjs-pdf.exception.ts
 let NestjsPdfErrorCode = /* @__PURE__ */ function(NestjsPdfErrorCode) {
 	NestjsPdfErrorCode["ENGINE_NOT_AVAILABLE"] = "ENGINE_NOT_AVAILABLE";
@@ -77,8 +43,8 @@ var BrowserUnavailableException = class extends NestjsPdfException {
 //#region 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
@@ -478,7 +444,7 @@ var Queue = class {
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/p-limit@7.3.2/node_modules/p-limit/index.js
+//#region 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);
@@ -537,7 +503,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);
 		} }
 	});
@@ -704,19 +680,19 @@ async function installRequestGuard(context, page, options) {
 //#region src/helpers/tokens.ts
 const PDF_PARAMETERS = "PDF_PARAMETERS";
 //#endregion
-//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.153.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
+//#region \0@oxc-project+runtime@0.153.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
+//#region \0@oxc-project+runtime@0.153.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);
@@ -991,11 +967,34 @@ BrowserService = __decorate([
 	__decorateMetadata("design:paramtypes", [Object])
 ], BrowserService);
 //#endregion
+//#region src/puppeteer/libs/loadEngine.utils.ts
+const requireEngine = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+/**
+* 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;
+}
+//#endregion
 //#region 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.default.render(template, data, {
+			return await engine.render(template, data, {
 				async: true,
 				...options
 			});
@@ -1004,8 +1003,9 @@ let EjsService = class EjsService {
 		}
 	}
 	async renderFile(filePath, data = {}, options) {
+		const engine = this.#engine;
 		try {
-			return await ejs.default.renderFile(filePath, data, {
+			return await engine.renderFile(filePath, data, {
 				async: true,
 				...options
 			});
@@ -1018,15 +1018,12 @@ EjsService = __decorate([(0, _nestjs_common.Injectable)()], EjsService);
 //#endregion
 //#region src/puppeteer/engines/eta/eta.service.ts
 let EtaService = class EtaService {
+	#etaModule;
 	#eta;
 	#templateCache = /* @__PURE__ */ new Map();
 	#maxCacheSize = 100;
-	constructor() {
-		this.#eta = new eta.Eta({
-			cache: true,
-			autoEscape: true,
-			useWith: true
-		});
+	get #engine() {
+		return this.#etaModule ??= loadEngine("eta", "Eta");
 	}
 	/**
 	* Render an Eta template from a string
@@ -1036,14 +1033,19 @@ 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.Eta({
+			return (options && Object.keys(options).length > 0 ? new Eta({
 				cache: true,
 				autoEscape: true,
 				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 });
 		}
@@ -1066,6 +1068,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 });
 		}
 	}
@@ -1083,12 +1086,16 @@ let EtaService = class EtaService {
 		return this.#templateCache.size;
 	}
 };
-EtaService = __decorate([(0, _nestjs_common.Injectable)(), __decorateMetadata("design:paramtypes", [])], EtaService);
+EtaService = __decorate([(0, _nestjs_common.Injectable)()], EtaService);
 //#endregion
 //#region 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);
@@ -1117,7 +1124,7 @@ let HandlebarsService = class HandlebarsService {
 	*/
 	#getEnv(options) {
 		if (this.#cachedEnv && this.#cachedOptions === options) return this.#cachedEnv;
-		const env = handlebars.default.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;
@@ -1137,11 +1144,78 @@ let HandlebarsService = class HandlebarsService {
 };
 HandlebarsService = __decorate([(0, _nestjs_common.Injectable)()], HandlebarsService);
 //#endregion
+//#region 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 = (0, node_path.resolve)(filePath);
+			const useCache = options?.cache !== false;
+			let template = useCache ? this.#templateCache.get(resolvedPath) : void 0;
+			if (!template) {
+				template = (0, node_fs.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([(0, _nestjs_common.Injectable)()], LiquidService);
+//#endregion
 //#region 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 (0, mjml.default)(template, options);
+			const { html } = await engine(template, options);
 			return html;
 		} catch (error) {
 			throw new TemplateRenderException("MJML", `MJML rendering failed: ${String(error)}`, { cause: error });
@@ -1161,8 +1235,12 @@ MjmlService = __decorate([(0, _nestjs_common.Injectable)()], MjmlService);
 //#endregion
 //#region 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
@@ -1171,9 +1249,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.default.render(template, data, void 0, {
+			return engine.render(template, data, void 0, {
 				tags,
 				escape: options?.escape
 			});
@@ -1198,6 +1277,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 });
 		}
 	}
@@ -1219,14 +1299,20 @@ MustacheService = __decorate([(0, _nestjs_common.Injectable)()], MustacheService
 //#endregion
 //#region src/puppeteer/engines/nunjucks/nunjucks.service.ts
 let NunjucksService = class NunjucksService {
-	constructor() {
-		nunjucks.default.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 = {
@@ -1236,14 +1322,15 @@ let NunjucksService = class NunjucksService {
 					trimBlocks: options.trimBlocks ?? true,
 					lstripBlocks: options.lstripBlocks ?? true
 				};
-				nunjucks.default.configure(configOptions);
+				nunjucks.configure(configOptions);
 			}
-			return nunjucks.default.renderString(template, data);
+			return nunjucks.renderString(template, data);
 		} catch (error) {
 			throw new TemplateRenderException("Nunjucks", `Nunjucks rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 	renderFile(filePath, data = {}, options) {
+		const nunjucks = this.#engine;
 		try {
 			if (options) {
 				const configOptions = {
@@ -1253,21 +1340,26 @@ let NunjucksService = class NunjucksService {
 					trimBlocks: options.trimBlocks ?? true,
 					lstripBlocks: options.lstripBlocks ?? true
 				};
-				nunjucks.default.configure(configOptions);
+				nunjucks.configure(configOptions);
 			}
-			return nunjucks.default.render(filePath, data);
+			return nunjucks.render(filePath, data);
 		} catch (error) {
 			throw new TemplateRenderException("Nunjucks", `Nunjucks file rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 };
-NunjucksService = __decorate([(0, _nestjs_common.Injectable)(), __decorateMetadata("design:paramtypes", [])], NunjucksService);
+NunjucksService = __decorate([(0, _nestjs_common.Injectable)()], NunjucksService);
 //#endregion
 //#region 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.default.compile(template, { ...options })(data);
+			return engine.compile(template, { ...options })(data);
 		} catch (error) {
 			throw new TemplateRenderException("Pug", `Pug rendering failed: ${String(error)}`, { cause: error });
 		}
@@ -1277,6 +1369,7 @@ let PugService = class PugService {
 			const template = (0, node_fs.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 });
 		}
 	}
@@ -1300,7 +1393,8 @@ let PuppeteerService = class PuppeteerService {
 	#nunjucksService;
 	#etaService;
 	#mustacheService;
-	constructor(browserService, options, hbsService, mjmlService, pugService, ejsService, nunjucksService, etaService, mustacheService) {
+	#liquidService;
+	constructor(browserService, options, hbsService, mjmlService, pugService, ejsService, nunjucksService, etaService, mustacheService, liquidService) {
 		this.#browserService = browserService;
 		this.#options = options;
 		this.#hbsService = hbsService;
@@ -1310,6 +1404,7 @@ let PuppeteerService = class PuppeteerService {
 		this.#nunjucksService = nunjucksService;
 		this.#etaService = etaService;
 		this.#mustacheService = mustacheService;
+		this.#liquidService = liquidService;
 	}
 	#limit = pLimit(3);
 	async generatePdfFromHtml(html, options) {
@@ -1472,6 +1567,14 @@ 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([
 	(0, _nestjs_common.Injectable)(),
@@ -1483,6 +1586,7 @@ PuppeteerService = __decorate([
 	__decorateParam(6, (0, _nestjs_common.Optional)()),
 	__decorateParam(7, (0, _nestjs_common.Optional)()),
 	__decorateParam(8, (0, _nestjs_common.Optional)()),
+	__decorateParam(9, (0, _nestjs_common.Optional)()),
 	__decorateMetadata("design:paramtypes", [
 		typeof BrowserService === "undefined" ? Object : BrowserService,
 		Object,
@@ -1492,7 +1596,8 @@ 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
@@ -1650,6 +1755,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__')
@@ -1723,7 +1848,8 @@ let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 				EjsService,
 				NunjucksService,
 				EtaService,
-				MustacheService
+				MustacheService,
+				LiquidService
 			],
 			exports: [
 				PuppeteerService,
@@ -1732,7 +1858,8 @@ let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 				EjsService,
 				NunjucksService,
 				EtaService,
-				MustacheService
+				MustacheService,
+				LiquidService
 			]
 		};
 	}
@@ -1755,7 +1882,8 @@ let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 				EjsService,
 				NunjucksService,
 				EtaService,
-				MustacheService
+				MustacheService,
+				LiquidService
 			],
 			exports: [
 				PuppeteerService,
@@ -1764,7 +1892,8 @@ let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
 				EjsService,
 				NunjucksService,
 				EtaService,
-				MustacheService
+				MustacheService,
+				LiquidService
 			]
 		};
 	}
@@ -1779,7 +1908,8 @@ PuppeteerModule = _PuppeteerModule = __decorate([
 			EjsService,
 			NunjucksService,
 			EtaService,
-			MustacheService
+			MustacheService,
+			LiquidService
 		],
 		exports: [
 			PuppeteerService,
@@ -1788,7 +1918,8 @@ PuppeteerModule = _PuppeteerModule = __decorate([
 			EjsService,
 			NunjucksService,
 			EtaService,
-			MustacheService
+			MustacheService,
+			LiquidService
 		]
 	}),
 	__decorateParam(1, (0, _nestjs_common.Inject)(PDF_PARAMETERS)),
@@ -1838,6 +1969,12 @@ Object.defineProperty(exports, "HandlebarsService", {
 		return HandlebarsService;
 	}
 });
+Object.defineProperty(exports, "LiquidService", {
+	enumerable: true,
+	get: function() {
+		return LiquidService;
+	}
+});
 Object.defineProperty(exports, "MjmlService", {
 	enumerable: true,
 	get: function() {