@shad0wz7/nestjs-pdf 3.0.0 → 3.1.0

package/dist/index.cjs

@@ -48,6 +48,73 @@ fs = __toESM(fs, 1);
 let path = require("path");
 let rxjs = require("rxjs");
 let crypto = require("crypto");
+//#region 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";
+	NestjsPdfErrorCode["TEMPLATE_RENDER_ERROR"] = "TEMPLATE_RENDER_ERROR";
+	NestjsPdfErrorCode["BROWSER_INSTALLATION_ERROR"] = "BROWSER_INSTALLATION_ERROR";
+	NestjsPdfErrorCode["BROWSER_UNAVAILABLE"] = "BROWSER_UNAVAILABLE";
+	NestjsPdfErrorCode["PDF_GENERATION_ERROR"] = "PDF_GENERATION_ERROR";
+	NestjsPdfErrorCode["SIGNATURE_DEPENDENCY_ERROR"] = "SIGNATURE_DEPENDENCY_ERROR";
+	NestjsPdfErrorCode["SIGNATURE_PLACEMENT_ERROR"] = "SIGNATURE_PLACEMENT_ERROR";
+	return NestjsPdfErrorCode;
+}({});
+var NestjsPdfException = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = this.constructor.name;
+	}
+};
+//#endregion
+//#region src/exceptions/browser-installation.exception.ts
+var BrowserInstallationException = class extends NestjsPdfException {
+	code = "BROWSER_INSTALLATION_ERROR";
+};
+//#endregion
+//#region src/exceptions/browser-unavailable.exception.ts
+var BrowserUnavailableException = class extends NestjsPdfException {
+	code = "BROWSER_UNAVAILABLE";
+};
+//#endregion
+//#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.`);
+	}
+};
+//#endregion
+//#region src/exceptions/pdf-generation.exception.ts
+var PdfGenerationException = class extends NestjsPdfException {
+	code = "PDF_GENERATION_ERROR";
+};
+//#endregion
+//#region src/exceptions/signature-dependency.exception.ts
+var SignatureDependencyException = class extends NestjsPdfException {
+	code = "SIGNATURE_DEPENDENCY_ERROR";
+};
+//#endregion
+//#region src/exceptions/signature-placement.exception.ts
+var SignaturePlacementException = class extends NestjsPdfException {
+	code = "SIGNATURE_PLACEMENT_ERROR";
+};
+//#endregion
+//#region src/exceptions/template-configuration.exception.ts
+var TemplateConfigurationException = class extends NestjsPdfException {
+	code = "TEMPLATE_CONFIGURATION_ERROR";
+};
+//#endregion
+//#region src/exceptions/template-render.exception.ts
+var TemplateRenderException = class extends NestjsPdfException {
+	engine;
+	code = "TEMPLATE_RENDER_ERROR";
+	constructor(engine, message, options) {
+		super(message, options);
+		this.engine = engine;
+	}
+};
+//#endregion
 //#region src/helpers/getRelativePath.helper.ts
 /**
 * Get the relative path to a value from the module directory.
@@ -70,7 +137,7 @@ async function loadPdfjs() {
 		pdfjsPromise = await import("pdfjs-dist/legacy/build/pdf.mjs");
 	} catch (error) {
 		pdfjsPromise = void 0;
-		throw new Error([
+		throw new SignatureDependencyException([
 			"Failed to load pdfjs-dist.",
 			"If you use anchor-based signature placement in Node.js, make sure @napi-rs/canvas is installed.",
 			"Try: npm install @napi-rs/canvas",
@@ -116,7 +183,6 @@ function addSignatureFieldAt(pdfDoc, pageIndex, opts) {
 	const { fieldName, x, y, width, height } = opts;
 	const context = pdfDoc.context;
 	const page = pdfDoc.getPages()[pageIndex];
-	if (!page) throw new Error(`Page ${pageIndex} not found`);
 	const rectArray = context.obj([
 		pdf_lib.PDFNumber.of(x),
 		pdf_lib.PDFNumber.of(y),
@@ -173,7 +239,9 @@ async function addSignatureFieldUsingAnchor(pdf, fieldName = "SignatureDebtor",
 	const sigHeight = 50;
 	if (anchor) {
 		const pageIndex = anchor.pageIndex;
-		const { width: pw, height: ph } = pdfDoc.getPages()[pageIndex].getSize();
+		const page = pdfDoc.getPages()[pageIndex];
+		if (!page) throw new SignaturePlacementException(`Page ${pageIndex} not found`);
+		const { width: pw, height: ph } = page.getSize();
 		const padX = 40;
 		const padY = 7;
 		let x = anchor.x - sigWidth / 2 + padX;
@@ -191,7 +259,10 @@ async function addSignatureFieldUsingAnchor(pdf, fieldName = "SignatureDebtor",
 	} else {
 		const pages = pdfDoc.getPages();
 		const pageIndex = pages.length - 1;
-		const { width: pageWidth } = pages[pageIndex].getSize();
+		const page = pages.at(-1);
+		/* v8 ignore next -- pdf-lib always produces at least one page on save/load; only a hand-crafted, malformed PDF could hit this */
+		if (!page) throw new SignaturePlacementException(`Page ${pageIndex} not found`);
+		const { width: pageWidth } = page.getSize();
 		addSignatureFieldAt(pdfDoc, pageIndex, {
 			fieldName,
 			x: (pageWidth - sigWidth) / 2,
@@ -339,19 +410,19 @@ function mergePuppeteerParameters(defaults, overrides) {
 //#region src/helpers/tokens.ts
 const PDF_PARAMETERS = "PDF_PARAMETERS";
 //#endregion
-//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.149.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.142.0/helpers/esm/decorateParam.js
+//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateParam.js
 function __decorateParam(paramIndex, decorator) {
 	return function(target, key) {
 		decorator(target, key, paramIndex);
 	};
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.142.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
 function __decorate$3(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);
@@ -381,47 +452,47 @@ function isTargetClosedError(error) {
 	return error.name === "TargetCloseError" || error.message.includes("Target closed") || error.message.includes("Target.createTarget");
 }
 let BrowserService = class BrowserService {
-	cacheDir;
-	options;
-	_browserInstance = null;
-	browser;
+	#cacheDir;
+	#options;
+	#browserInstance = null;
+	#browser;
 	activeJobs = 0;
 	totalJobs = 0;
-	recycleRequested = false;
-	recycling = false;
-	shuttingDown = false;
+	#recycleRequested = false;
+	#recycling = false;
+	#shuttingDown = false;
 	/** Max time to wait for in-flight PDF jobs to finish before closing the browser on shutdown. */
 	shutdownDrainTimeoutMs = 15e3;
-	browserTag;
-	useLockedBrowser;
-	buildId;
+	#browserTag;
+	#useLockedBrowser;
+	#buildId;
 	constructor(pdfParams) {
-		this.cacheDir = (0, node_path.resolve)(".cache/puppeteer-browser");
-		this.options = pdfParams;
-		this.loadBuildId();
-		this.loadBrowser();
-		this.loadBrowserTag();
-		this.loadUseLockedBrowser();
+		this.#cacheDir = (0, node_path.resolve)(".cache/puppeteer-browser");
+		this.#options = pdfParams;
+		this.#loadBuildId();
+		this.#loadBrowser();
+		this.#loadBrowserTag();
+		this.#loadUseLockedBrowser();
 	}
 	async onModuleDestroy() {
-		this.shuttingDown = true;
-		await this.waitForIdle(this.shutdownDrainTimeoutMs);
-		if (this._browserInstance?.connected) try {
-			await this._browserInstance.close();
+		this.#shuttingDown = true;
+		await this.#waitForIdle(this.shutdownDrainTimeoutMs);
+		if (this.#browserInstance?.connected) try {
+			await this.#browserInstance.close();
 		} catch (error) {
 			_nestjs_common.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?.cleanupBrowserCacheOnExit !== false) await this.#cleanupCacheBestEffort();
 	}
 	/** Wait until no PDF job is in flight, or until the timeout elapses. */
-	async waitForIdle(timeoutMs) {
+	async #waitForIdle(timeoutMs) {
 		const start = Date.now();
 		while (this.activeJobs > 0 && Date.now() - start < timeoutMs) await sleep(50);
 		if (this.activeJobs > 0) _nestjs_common.Logger.warn(`Shutdown: ${this.activeJobs} PDF job(s) still running after ${timeoutMs}ms, closing the browser anyway`);
 	}
 	async getBrowserInstance(args, headless, executablePathBin) {
-		if (!this._browserInstance?.connected) this._browserInstance = await this.launchBrowser(args, headless, executablePathBin);
-		return this._browserInstance;
+		if (!this.#browserInstance?.connected) this.#browserInstance = await this.#launchBrowser(args, headless, executablePathBin);
+		return this.#browserInstance;
 	}
 	async createContext(args, headless, executablePath) {
 		const browser = await this.getBrowserInstance(args, headless, executablePath);
@@ -430,41 +501,41 @@ let BrowserService = class BrowserService {
 		} catch (error) {
 			if (!isTargetClosedError(error)) throw error;
 			_nestjs_common.Logger.warn("Puppeteer browser closed while creating a context, retrying once");
-			this._browserInstance = null;
+			this.#browserInstance = null;
 			return await (await this.getBrowserInstance(args, headless, executablePath)).createBrowserContext();
 		}
 	}
 	markJobStarted() {
-		if (this.shuttingDown) throw new Error("nestjs-pdf is shutting down, refusing new PDF jobs");
+		if (this.#shuttingDown) throw new BrowserUnavailableException("nestjs-pdf is shutting down, refusing new PDF jobs");
 		this.activeJobs += 1;
 		this.totalJobs += 1;
-		if (this.totalJobs >= 200) this.recycleRequested = true;
+		if (this.totalJobs >= 200) this.#recycleRequested = true;
 	}
 	async markJobFinished() {
 		this.activeJobs = Math.max(0, this.activeJobs - 1);
 		await this.recycleBrowserIfNeeded();
 	}
 	async recycleBrowserIfNeeded() {
-		if (!this.recycleRequested) return;
-		if (this.recycling) return;
+		if (!this.#recycleRequested) return;
+		if (this.#recycling) return;
 		if (this.activeJobs > 0) return;
-		if (!this._browserInstance) return;
-		this.recycling = true;
+		if (!this.#browserInstance) return;
+		this.#recycling = true;
 		try {
-			if (this._browserInstance.connected) await this._browserInstance.close();
-			this._browserInstance = null;
+			if (this.#browserInstance.connected) await this.#browserInstance.close();
+			this.#browserInstance = null;
 			this.totalJobs = 0;
-			this.recycleRequested = false;
+			this.#recycleRequested = false;
 			_nestjs_common.Logger.log("Puppeteer browser recycled successfully");
 		} catch (error) {
 			_nestjs_common.Logger.warn(`Failed to recycle browser: ${error instanceof Error ? error.message : String(error)}`);
 		} finally {
-			this.recycling = false;
+			this.#recycling = false;
 		}
 	}
-	async cleanupCacheBestEffort() {
+	async #cleanupCacheBestEffort() {
 		const logger = new _nestjs_common.Logger("NestJsPdf");
-		const dir = this.cacheDir;
+		const dir = this.#cacheDir;
 		try {
 			if (!(0, node_fs.existsSync)(dir)) return;
 			logger.log(`Cleanup puppeteer cache: ${dir}`);
@@ -485,100 +556,109 @@ let BrowserService = class BrowserService {
 		}
 	}
 	async install(lock = false) {
-		const browser = this.browser;
-		const versionTag = this.browserTag;
+		try {
+			return await this.#doInstall(lock);
+		} catch (error) {
+			if (error instanceof NestjsPdfException) throw error;
+			throw new BrowserInstallationException(`Could not install browser: ${String(error)}`, { cause: error });
+		}
+	}
+	async #doInstall(lock) {
+		const browser = this.#browser;
+		const versionTag = this.#browserTag;
 		const browserPlatform = (0, _puppeteer_browsers.detectBrowserPlatform)() ?? _puppeteer_browsers.BrowserPlatform.LINUX;
 		let buildId;
-		if (this.buildId === void 0) buildId = await (0, _puppeteer_browsers.resolveBuildId)(browser, browserPlatform, versionTag);
-		else buildId = this.buildId;
+		if (this.#buildId === void 0) buildId = await (0, _puppeteer_browsers.resolveBuildId)(browser, browserPlatform, versionTag);
+		else buildId = this.#buildId;
 		_nestjs_common.Logger.log(`Browser ${browser} ${versionTag} build id: ${buildId}`, "NestJsPdf");
 		if (await this.hasBrowserInstalled(browser, buildId)) {
 			_nestjs_common.Logger.log("Browser already installed", "NestJsPdf");
-			if (lock) this.writeLockFile(browser, buildId);
+			if (lock) this.#writeLockFile(browser, buildId);
 			return;
 		} else {
 			_nestjs_common.Logger.log("Starting browser installation", "NestJsPdf");
 			const installOption = {
-				cacheDir: this.cacheDir,
+				cacheDir: this.#cacheDir,
 				browser,
 				buildId,
-				baseUrl: this.options?.browserInstallBaseUrl ?? void 0
+				baseUrl: this.#options?.browserInstallBaseUrl ?? void 0
 			};
 			if (await (0, _puppeteer_browsers.canDownload)(installOption)) {
 				_nestjs_common.Logger.log(`Installing ${installOption.browser} ${installOption.buildId}`, "NestJsPdf");
 				const installedBrowser = await (0, _puppeteer_browsers.install)(installOption);
 				if (await this.hasBrowserInstalled(browser, buildId)) {
 					_nestjs_common.Logger.log("Browser installed successfully", "NestJsPdf");
-					if (lock) this.writeLockFile(browser, buildId);
+					if (lock) this.#writeLockFile(browser, buildId);
 					return installedBrowser;
 				} else _nestjs_common.Logger.error("Browser installation failed", "NestJsPdf");
 			} else _nestjs_common.Logger.error(`Error, can't install ${installOption.browser} ${installOption.buildId}`, "NestJsPdf");
 		}
 		return null;
 	}
-	loadBrowser() {
+	#loadBrowser() {
 		let browser;
-		if (this.options?.browser === void 0) browser = _puppeteer_browsers.Browser.CHROMIUM;
-		else browser = this.options.browser;
-		this.browser = browser;
+		if (this.#options?.browser === void 0) browser = _puppeteer_browsers.Browser.CHROMIUM;
+		else browser = this.#options.browser;
+		this.#browser = browser;
 	}
 	getBrowser() {
-		return this.browser;
+		return this.#browser;
 	}
-	loadBrowserTag() {
+	#loadBrowserTag() {
 		let versionTag;
-		if (this.options?.browserTag === void 0) if (this.browser === _puppeteer_browsers.Browser.CHROMIUM) versionTag = "latest";
-		else versionTag = "stable";
-		else versionTag = this.options.browserTag;
-		this.browserTag = versionTag;
+		if (this.#options?.browserTag === void 0) {
+			if (this.#browser === _puppeteer_browsers.Browser.CHROMIUM) versionTag = "latest";
+			else versionTag = "stable";
+		} else versionTag = this.#options.browserTag;
+		this.#browserTag = versionTag;
 	}
-	loadBuildId() {
+	#loadBuildId() {
 		let buildId;
-		if (this.options?.buildId === void 0) buildId = void 0;
-		else buildId = this.options.buildId;
-		this.buildId = buildId;
+		if (this.#options?.buildId === void 0) buildId = void 0;
+		else buildId = this.#options.buildId;
+		this.#buildId = buildId;
 	}
 	setBrowserTag(browserTag) {
-		this.browserTag = browserTag;
+		this.#browserTag = browserTag;
 	}
 	getBrowserTag() {
-		return this.browserTag;
+		return this.#browserTag;
 	}
 	getBuildId() {
-		return this.buildId;
+		return this.#buildId;
 	}
-	loadUseLockedBrowser() {
+	#loadUseLockedBrowser() {
 		let useLockedBrowser;
-		if (this.options?.useLockedBrowser === void 0) useLockedBrowser = false;
-		else useLockedBrowser = this.options.useLockedBrowser;
-		this.useLockedBrowser = useLockedBrowser;
+		if (this.#options?.useLockedBrowser === void 0) useLockedBrowser = false;
+		else useLockedBrowser = this.#options.useLockedBrowser;
+		this.#useLockedBrowser = useLockedBrowser;
 	}
 	async hasBrowserInstalled(browser, buildId) {
-		return (await (0, _puppeteer_browsers.getInstalledBrowsers)({ cacheDir: this.cacheDir })).find((insBrowser) => {
+		return (await (0, _puppeteer_browsers.getInstalledBrowsers)({ cacheDir: this.#cacheDir })).find((insBrowser) => {
 			return insBrowser.browser === browser && insBrowser.buildId === buildId;
 		}) !== void 0;
 	}
 	async getExecutablePath() {
-		const browser = this.browser;
-		const versionTag = this.browserTag;
+		const browser = this.#browser;
+		const versionTag = this.#browserTag;
 		const browserPlatform = (0, _puppeteer_browsers.detectBrowserPlatform)() ?? _puppeteer_browsers.BrowserPlatform.LINUX;
 		let buildId = null;
-		if (this.useLockedBrowser) {
+		if (this.#useLockedBrowser) {
 			buildId = this.getLockedBuildId(browser);
 			_nestjs_common.Logger.log(`Using locked browser ${buildId}`, "NestJsPdf");
 		}
 		buildId ??= await (0, _puppeteer_browsers.resolveBuildId)(browser, browserPlatform, versionTag);
-		const installedBrowser = (await (0, _puppeteer_browsers.getInstalledBrowsers)({ cacheDir: this.cacheDir })).find((insBrowser) => {
+		const installedBrowser = (await (0, _puppeteer_browsers.getInstalledBrowsers)({ cacheDir: this.#cacheDir })).find((insBrowser) => {
 			return insBrowser.browser === browser && insBrowser.buildId === buildId;
 		});
 		if (installedBrowser === void 0) {
 			const newinstalledBrowser = await this.install();
-			if (newinstalledBrowser === null || newinstalledBrowser === void 0) throw new Error("Could not install browser");
+			if (newinstalledBrowser === null || newinstalledBrowser === void 0) throw new BrowserInstallationException("Could not install browser");
 			else return newinstalledBrowser.executablePath;
 		}
 		return installedBrowser.executablePath;
 	}
-	async launchBrowser(args, headless, executablePathBin) {
+	async #launchBrowser(args, headless, executablePathBin) {
 		const executablePath = executablePathBin ?? await this.getExecutablePath();
 		const browser = await (0, puppeteer.launch)({
 			executablePath,
@@ -587,12 +667,12 @@ let BrowserService = class BrowserService {
 		});
 		browser.on("disconnected", () => {
 			_nestjs_common.Logger.warn("Puppeteer browser disconnected");
-			if (this._browserInstance === browser) this._browserInstance = null;
+			if (this.#browserInstance === browser) this.#browserInstance = null;
 		});
 		return browser;
 	}
-	writeLockFile(browser, buildId) {
-		const lockFile = (0, node_path.resolve)(this.cacheDir, `${browser}.lock`);
+	#writeLockFile(browser, buildId) {
+		const lockFile = (0, node_path.resolve)(this.#cacheDir, `${browser}.lock`);
 		const data = JSON.stringify({
 			browser,
 			buildId,
@@ -602,7 +682,7 @@ let BrowserService = class BrowserService {
 		_nestjs_common.Logger.log(`Browser ${browser} locked to build ${buildId}`, "NestJsPdf");
 	}
 	getLockedBuildId(browser) {
-		const lockFile = (0, node_path.resolve)(this.cacheDir, `${browser}.lock`);
+		const lockFile = (0, node_path.resolve)(this.#cacheDir, `${browser}.lock`);
 		if ((0, node_fs.existsSync)(lockFile)) {
 			const data = (0, node_fs.readFileSync)(lockFile);
 			return JSON.parse(data.toString()).buildId;
@@ -625,7 +705,7 @@ let EjsService = class EjsService {
 				...options
 			});
 		} catch (error) {
-			throw new Error(`EJS rendering failed: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("EJS", `EJS rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 	async renderFile(filePath, data = {}, options) {
@@ -635,7 +715,7 @@ let EjsService = class EjsService {
 				...options
 			});
 		} catch (error) {
-			throw new Error(`EJS file rendering failed: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("EJS", `EJS file rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 };
@@ -643,11 +723,11 @@ EjsService = __decorate$3([(0, _nestjs_common.Injectable)()], EjsService);
 //#endregion
 //#region src/puppeteer/engines/eta/eta.service.ts
 let EtaService = class EtaService {
-	eta;
-	templateCache = /* @__PURE__ */ new Map();
-	maxCacheSize = 100;
+	#eta;
+	#templateCache = /* @__PURE__ */ new Map();
+	#maxCacheSize = 100;
 	constructor() {
-		this.eta = new eta.Eta({
+		this.#eta = new eta.Eta({
 			cache: true,
 			autoEscape: true,
 			useWith: true
@@ -668,9 +748,9 @@ let EtaService = class EtaService {
 				useWith: true,
 				...options,
 				varName: options.varName ?? "it"
-			}) : this.eta).renderString(template, data);
+			}) : this.#eta).renderString(template, data);
 		} catch (error) {
-			throw new Error(`Eta rendering failed: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("Eta", `Eta rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 	/**
@@ -684,53 +764,54 @@ let EtaService = class EtaService {
 		try {
 			const resolvedPath = (0, node_path.resolve)(filePath);
 			const useCache = options?.cache ?? true;
-			let template = useCache ? this.templateCache.get(resolvedPath) : void 0;
+			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);
+				if (useCache && this.#templateCache.size < this.#maxCacheSize) this.#templateCache.set(resolvedPath, template);
 			}
 			return this.render(template, data, options);
 		} catch (error) {
-			throw new Error(`Eta file rendering failed for ${filePath}: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("Eta", `Eta file rendering failed for ${filePath}: ${String(error)}`, { cause: error });
 		}
 	}
 	/**
 	* Clear the template cache
 	*/
 	clearCache() {
-		this.templateCache.clear();
+		this.#templateCache.clear();
 	}
 	/**
 	* Get the current cache size
 	* @returns The number of cached templates
 	*/
 	getCacheSize() {
-		return this.templateCache.size;
+		return this.#templateCache.size;
 	}
 };
 EtaService = __decorate$3([(0, _nestjs_common.Injectable)(), __decorateMetadata("design:paramtypes", [])], EtaService);
 //#endregion
 //#region src/puppeteer/engines/handlebars/handlebars.service.ts
 let HandlebarsService = class HandlebarsService {
-	cachedOptions;
-	cachedEnv;
+	#cachedOptions;
+	#cachedEnv;
 	render(template, parameters = {}, options = {}) {
 		try {
-			return this.getEnv(options).compile(template, options.compileOptions)(parameters, options.templateOptions);
+			return this.#getEnv(options).compile(template, options.compileOptions)(parameters, options.templateOptions);
 		} catch (error) {
-			throw new Error(`Handlebars rendering failed: ${String(error)}`, { cause: error });
+			if (error instanceof NestjsPdfException) throw error;
+			throw new TemplateRenderException("Handlebars", `Handlebars rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 	renderFile(file, parameters = {}, options = {}) {
-		if (options.templateDirectory === void 0) throw new Error("Handlebars file rendering failed: option `templateDirectory` is not set");
+		if (options.templateDirectory === void 0) throw new TemplateConfigurationException("Handlebars file rendering failed: option `templateDirectory` is not set");
 		const baseDir = (0, node_path.resolve)(process.cwd(), options.templateDirectory);
 		const templatePath = (0, node_path.resolve)(baseDir, file);
-		if (templatePath !== baseDir && !templatePath.startsWith(baseDir + node_path.sep)) throw new Error(`Handlebars file rendering failed: ’${file}’ resolves outside \`templateDirectory\``);
+		if (templatePath !== baseDir && !templatePath.startsWith(baseDir + node_path.sep)) throw new TemplateConfigurationException(`Handlebars file rendering failed: ’${file}’ resolves outside \`templateDirectory\``);
 		let template;
 		try {
 			template = (0, node_fs.readFileSync)(templatePath, "utf8");
 		} catch (error) {
-			throw new Error(`Handlebars file rendering failed: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("Handlebars", `Handlebars file rendering failed: ${String(error)}`, { cause: error });
 		}
 		return this.render(template, parameters, options);
 	}
@@ -739,19 +820,19 @@ let HandlebarsService = class HandlebarsService {
 	* nothing leaks into the global Handlebars. Memoised for the common case where
 	* the same options object is reused across calls (e.g. the module `hbsOptions`).
 	*/
-	getEnv(options) {
-		if (this.cachedEnv && this.cachedOptions === options) return this.cachedEnv;
+	#getEnv(options) {
+		if (this.#cachedEnv && this.#cachedOptions === options) return this.#cachedEnv;
 		const env = handlebars.default.create();
 		for (const helper of options.helpers ?? []) env.registerHelper(helper.name, helper.fn);
-		this.registerPartials(env, options.partialDirectory);
-		this.cachedOptions = options;
-		this.cachedEnv = env;
+		this.#registerPartials(env, options.partialDirectory);
+		this.#cachedOptions = options;
+		this.#cachedEnv = env;
 		return env;
 	}
-	registerPartials(env, partialDirectory) {
+	#registerPartials(env, partialDirectory) {
 		if (partialDirectory === void 0) return;
 		const partialPath = (0, node_path.join)(process.cwd(), partialDirectory);
-		if (!(0, node_fs.existsSync)(partialPath)) throw new Error(`Handlebars partial directory does not exist: ${partialPath}`);
+		if (!(0, node_fs.existsSync)(partialPath)) throw new TemplateConfigurationException(`Handlebars partial directory does not exist: ${partialPath}`);
 		for (const entry of (0, node_fs.readdirSync)(partialPath)) {
 			const filePath = (0, node_path.join)(partialPath, entry);
 			if (!(0, node_fs.statSync)(filePath).isFile()) continue;
@@ -764,11 +845,20 @@ HandlebarsService = __decorate$3([(0, _nestjs_common.Injectable)()], HandlebarsS
 //#region src/puppeteer/engines/mjml/mjml.service.ts
 let MjmlService = class MjmlService {
 	async render(template, options) {
-		const { html } = await (0, mjml.default)(template, options);
-		return html;
+		try {
+			const { html } = await (0, mjml.default)(template, options);
+			return html;
+		} catch (error) {
+			throw new TemplateRenderException("MJML", `MJML rendering failed: ${String(error)}`, { cause: error });
+		}
 	}
 	async renderFile(filePath, options) {
-		const template = (0, node_fs.readFileSync)(filePath, "utf-8");
+		let template;
+		try {
+			template = (0, node_fs.readFileSync)(filePath, "utf-8");
+		} catch (error) {
+			throw new TemplateRenderException("MJML", `MJML file rendering failed: ${String(error)}`, { cause: error });
+		}
 		return await this.render(template, options);
 	}
 };
@@ -776,8 +866,8 @@ MjmlService = __decorate$3([(0, _nestjs_common.Injectable)()], MjmlService);
 //#endregion
 //#region src/puppeteer/engines/mustache/mustache.service.ts
 let MustacheService = class MustacheService {
-	templateCache = /* @__PURE__ */ new Map();
-	maxCacheSize = 100;
+	#templateCache = /* @__PURE__ */ new Map();
+	#maxCacheSize = 100;
 	/**
 	* Render a Mustache template from a string
 	* @param template The template string to render
@@ -793,7 +883,7 @@ let MustacheService = class MustacheService {
 				escape: options?.escape
 			});
 		} catch (error) {
-			throw new Error(`Mustache rendering failed: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("Mustache", `Mustache rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 	/**
@@ -806,28 +896,28 @@ let MustacheService = class MustacheService {
 	renderFile(filePath, data = {}, options) {
 		try {
 			const resolvedPath = (0, node_path.resolve)(filePath);
-			let template = this.templateCache.get(resolvedPath);
+			let template = this.#templateCache.get(resolvedPath);
 			if (!template) {
 				template = (0, node_fs.readFileSync)(resolvedPath, "utf-8");
-				if (this.templateCache.size < this.maxCacheSize) this.templateCache.set(resolvedPath, template);
+				if (this.#templateCache.size < this.#maxCacheSize) this.#templateCache.set(resolvedPath, template);
 			}
 			return this.render(template, data, options);
 		} catch (error) {
-			throw new Error(`Mustache file rendering failed for ${filePath}: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("Mustache", `Mustache file rendering failed for ${filePath}: ${String(error)}`, { cause: error });
 		}
 	}
 	/**
 	* Clear the template cache
 	*/
 	clearCache() {
-		this.templateCache.clear();
+		this.#templateCache.clear();
 	}
 	/**
 	* Get the current cache size
 	* @returns The number of cached templates
 	*/
 	getCacheSize() {
-		return this.templateCache.size;
+		return this.#templateCache.size;
 	}
 };
 MustacheService = __decorate$3([(0, _nestjs_common.Injectable)()], MustacheService);
@@ -855,7 +945,7 @@ let NunjucksService = class NunjucksService {
 			}
 			return nunjucks.default.renderString(template, data);
 		} catch (error) {
-			throw new Error(`Nunjucks rendering failed: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("Nunjucks", `Nunjucks rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 	renderFile(filePath, data = {}, options) {
@@ -872,7 +962,7 @@ let NunjucksService = class NunjucksService {
 			}
 			return nunjucks.default.render(filePath, data);
 		} catch (error) {
-			throw new Error(`Nunjucks file rendering failed: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("Nunjucks", `Nunjucks file rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 };
@@ -884,7 +974,7 @@ let PugService = class PugService {
 		try {
 			return pug.default.compile(template, { ...options })(data);
 		} catch (error) {
-			throw new Error(`Pug rendering failed: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("Pug", `Pug rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 	renderFile(filePath, data = {}, options) {
@@ -892,7 +982,7 @@ let PugService = class PugService {
 			const template = (0, node_fs.readFileSync)(filePath, "utf-8");
 			return this.render(template, data, options);
 		} catch (error) {
-			throw new Error(`Pug file rendering failed: ${String(error)}`, { cause: error });
+			throw new TemplateRenderException("Pug", `Pug file rendering failed: ${String(error)}`, { cause: error });
 		}
 	}
 };
@@ -900,36 +990,36 @@ PugService = __decorate$3([(0, _nestjs_common.Injectable)()], PugService);
 //#endregion
 //#region src/puppeteer/libs/requireService.utils.ts
 function requireService(service, name) {
-	if (!service) throw new Error(`${name} service is not available. If the problem persists, open an issue in the repo.`);
+	if (!service) throw new EngineNotAvailableException(name);
 	return service;
 }
 //#endregion
 //#region src/puppeteer/puppeteer.service.ts
 let PuppeteerService = class PuppeteerService {
-	browserService;
-	options;
-	hbsService;
-	mjmlService;
-	pugService;
-	ejsService;
-	nunjucksService;
-	etaService;
-	mustacheService;
+	#browserService;
+	#options;
+	#hbsService;
+	#mjmlService;
+	#pugService;
+	#ejsService;
+	#nunjucksService;
+	#etaService;
+	#mustacheService;
 	constructor(browserService, options, hbsService, mjmlService, pugService, ejsService, nunjucksService, etaService, mustacheService) {
-		this.browserService = browserService;
-		this.options = options;
-		this.hbsService = hbsService;
-		this.mjmlService = mjmlService;
-		this.pugService = pugService;
-		this.ejsService = ejsService;
-		this.nunjucksService = nunjucksService;
-		this.etaService = etaService;
-		this.mustacheService = mustacheService;
-	}
-	limit = pLimit(3);
+		this.#browserService = browserService;
+		this.#options = options;
+		this.#hbsService = hbsService;
+		this.#mjmlService = mjmlService;
+		this.#pugService = pugService;
+		this.#ejsService = ejsService;
+		this.#nunjucksService = nunjucksService;
+		this.#etaService = etaService;
+		this.#mustacheService = mustacheService;
+	}
+	#limit = pLimit(3);
 	async generatePdfFromHtml(html, options) {
-		return this.limit(async () => {
-			const mergePuppeteerOptions = mergePuppeteerParameters(this.options, options);
+		return this.#limit(async () => {
+			const mergePuppeteerOptions = mergePuppeteerParameters(this.#options, options);
 			if (mergePuppeteerOptions.chromiumRevision !== void 0) _nestjs_common.Logger.warn("Using `chromiumRevision` is no longer supported since the puppeteer update.");
 			const headless = mergePuppeteerOptions.headless ?? true;
 			const executablePath = mergePuppeteerOptions.executablePath || void 0;
@@ -971,10 +1061,10 @@ let PuppeteerService = class PuppeteerService {
 				"--no-zygote",
 				"--disable-gpu"
 			];
-			this.browserService.markJobStarted();
+			this.#browserService.markJobStarted();
 			let context = null;
 			try {
-				context = await this.browserService.createContext(args, headless, executablePath);
+				context = await this.#browserService.createContext(args, headless, executablePath);
 				const page = await context.newPage();
 				const pdfOptions = mergePuppeteerOptions.pdfOptions ?? { format: "A4" };
 				await page.setContent(html, { waitUntil: "domcontentloaded" });
@@ -983,75 +1073,77 @@ let PuppeteerService = class PuppeteerService {
 					idleTime: 500,
 					timeout: 3e4
 				});
+				/* v8 ignore next */
 				await page.evaluate(() => document.fonts.ready);
 				return await page.pdf(pdfOptions);
 			} catch (e) {
 				_nestjs_common.Logger.error(e);
-				throw e;
+				if (e instanceof NestjsPdfException) throw e;
+				throw new PdfGenerationException(`PDF generation failed: ${String(e)}`, { cause: e });
 			} finally {
 				if (context) try {
 					await context.close();
 				} catch (error) {
 					_nestjs_common.Logger.error(error);
 				}
-				await this.browserService.markJobFinished();
+				await this.#browserService.markJobFinished();
 			}
 		});
 	}
 	async generatePdfFromTemplateHbsString(template, parameters = {}, options) {
-		const html = requireService(this.hbsService, "Handlebars").render(template, parameters, options?.hbsOptions ?? this.options.hbsOptions);
+		const html = requireService(this.#hbsService, "Handlebars").render(template, parameters, options?.hbsOptions ?? this.#options.hbsOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromTemplateHbsFile(file, parameters = {}, options) {
-		const html = requireService(this.hbsService, "Handlebars").renderFile(file, parameters, options?.hbsOptions ?? this.options.hbsOptions);
+		const html = requireService(this.#hbsService, "Handlebars").renderFile(file, parameters, options?.hbsOptions ?? this.#options.hbsOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromMjmlString(template, options) {
-		const html = await requireService(this.mjmlService, "MJML").render(template, options?.mjmlOptions ?? this.options.mjmlOptions);
+		const html = await requireService(this.#mjmlService, "MJML").render(template, options?.mjmlOptions ?? this.#options.mjmlOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromMjmlFile(file, options) {
-		const html = await requireService(this.mjmlService, "MJML").renderFile(file, options?.mjmlOptions ?? this.options.mjmlOptions);
+		const html = await requireService(this.#mjmlService, "MJML").renderFile(file, options?.mjmlOptions ?? this.#options.mjmlOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromPugString(template, data = {}, options) {
-		const html = requireService(this.pugService, "Pug").render(template, data, options?.pugOptions ?? this.options.pugOptions);
+		const html = requireService(this.#pugService, "Pug").render(template, data, options?.pugOptions ?? this.#options.pugOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromPugFile(file, data = {}, options) {
-		const html = requireService(this.pugService, "Pug").renderFile(file, data, options?.pugOptions ?? this.options.pugOptions);
+		const html = requireService(this.#pugService, "Pug").renderFile(file, data, options?.pugOptions ?? this.#options.pugOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromEjsString(template, data = {}, options) {
-		const html = await requireService(this.ejsService, "EJS").render(template, data, options?.ejsOptions ?? this.options.ejsOptions);
+		const html = await requireService(this.#ejsService, "EJS").render(template, data, options?.ejsOptions ?? this.#options.ejsOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromEjsFile(file, data = {}, options) {
-		const html = await requireService(this.ejsService, "EJS").renderFile(file, data, options?.ejsOptions ?? this.options.ejsOptions);
+		const html = await requireService(this.#ejsService, "EJS").renderFile(file, data, options?.ejsOptions ?? this.#options.ejsOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromNunjucksString(template, data = {}, options) {
-		const html = requireService(this.nunjucksService, "Nunjucks").render(template, data, options?.nunjucksOptions ?? this.options.nunjucksOptions);
+		const html = requireService(this.#nunjucksService, "Nunjucks").render(template, data, options?.nunjucksOptions ?? this.#options.nunjucksOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromNunjucksFile(file, data = {}, options) {
-		const html = requireService(this.nunjucksService, "Nunjucks").renderFile(file, data, options?.nunjucksOptions ?? this.options.nunjucksOptions);
+		const html = requireService(this.#nunjucksService, "Nunjucks").renderFile(file, data, options?.nunjucksOptions ?? this.#options.nunjucksOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromEtaString(template, data = {}, options) {
-		const html = requireService(this.etaService, "Eta").render(template, data, options?.etaOptions ?? this.options.etaOptions);
+		const html = requireService(this.#etaService, "Eta").render(template, data, options?.etaOptions ?? this.#options.etaOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromEtaFile(file, data = {}, options) {
-		const html = requireService(this.etaService, "Eta").renderFile(file, data, options?.etaOptions ?? this.options.etaOptions);
+		const html = requireService(this.#etaService, "Eta").renderFile(file, data, options?.etaOptions ?? this.#options.etaOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromMustacheString(template, data = {}, options) {
-		const html = requireService(this.mustacheService, "Mustache").render(template, data, options?.mustacheOptions ?? this.options.mustacheOptions);
+		const html = requireService(this.#mustacheService, "Mustache").render(template, data, options?.mustacheOptions ?? this.#options.mustacheOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 	async generatePdfFromMustacheFile(file, data = {}, options) {
-		const html = requireService(this.mustacheService, "Mustache").renderFile(file, data, options?.mustacheOptions ?? this.options.mustacheOptions);
+		const html = requireService(this.#mustacheService, "Mustache").renderFile(file, data, options?.mustacheOptions ?? this.#options.mustacheOptions);
 		return this.generatePdfFromHtml(html, options);
 	}
 };
@@ -1080,9 +1172,9 @@ PuppeteerService = __decorate$3([
 //#endregion
 //#region src/nestjs-pdf.service.ts
 let NestjsPdfService = class NestjsPdfService {
-	puppeteerService;
+	#puppeteerService;
 	constructor(puppeteerService) {
-		this.puppeteerService = puppeteerService;
+		this.#puppeteerService = puppeteerService;
 	}
 	/**
 	* @param html HTML string to convert to PDF
@@ -1091,7 +1183,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method uses the Puppeteer service to generate a PDF from an HTML string. Generation options can be customized by passing a `PuppeteerParameters` object as the second argument. This allows you to control various aspects of PDF rendering, such as page size, margins, background display, etc. If no options are provided, the default parameters defined in the Puppeteer service will be used.
 	*/
 	generatePdfFromHtml(html, options) {
-		return this.puppeteerService.generatePdfFromHtml(html, options);
+		return this.#puppeteerService.generatePdfFromHtml(html, options);
 	}
 	/**
 	* @param template Handlebars template string
@@ -1101,7 +1193,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from a Handlebars template provided as a string. The parameters to inject into the template are passed in the `parameters` object, which is used to render the template before converting it to PDF. PDF generation options can also be customized by passing a `PuppeteerParameters` object as the third argument. This allows you to control various aspects of PDF rendering, such as page size, margins, background display, etc. If no options are provided, the default parameters defined in the Puppeteer service will be used.
 	*/
 	generatePdfFromTemplateHbsString(template, parameters = {}, options) {
-		return this.puppeteerService.generatePdfFromTemplateHbsString(template, parameters, options);
+		return this.#puppeteerService.generatePdfFromTemplateHbsString(template, parameters, options);
 	}
 	/**
 	* @param file Path to the Handlebars template file
@@ -1111,7 +1203,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from a Handlebars template located at the specified file path. The file path is passed as a string in the `file` parameter. The parameters to inject into the template are passed in the `parameters` object, which is used to render the template before converting it to PDF. PDF generation options can also be customized by passing a `PuppeteerParameters` object as the third argument. This allows you to control various aspects of PDF rendering, such as page size, margins, background display, etc. If no options are provided, the default parameters defined in the Puppeteer service will be used.
 	*/
 	generatePdfFromTemplateHbsFile(file, parameters = {}, options) {
-		return this.puppeteerService.generatePdfFromTemplateHbsFile(file, parameters, options);
+		return this.#puppeteerService.generatePdfFromTemplateHbsFile(file, parameters, options);
 	}
 	/**
 	* @param template MJML template string
@@ -1120,7 +1212,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from an MJML template provided as a string. MJML (MJML Markup Language) is a markup language designed to reduce the pain of coding a responsive email. The template is first rendered to HTML using the MJML renderer, then converted to PDF. PDF generation options can be customized by passing a `PuppeteerParameters` object as the second argument.
 	*/
 	generatePdfFromMjmlString(template, options) {
-		return this.puppeteerService.generatePdfFromMjmlString(template, options);
+		return this.#puppeteerService.generatePdfFromMjmlString(template, options);
 	}
 	/**
 	* @param file Path to the MJML template file
@@ -1129,7 +1221,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from an MJML template located at the specified file path. The file path is passed as a string in the `file` parameter. The template is first rendered to HTML using the MJML renderer, then converted to PDF. PDF generation options can be customized by passing a `PuppeteerParameters` object as the second argument.
 	*/
 	generatePdfFromMjmlFile(file, options) {
-		return this.puppeteerService.generatePdfFromMjmlFile(file, options);
+		return this.#puppeteerService.generatePdfFromMjmlFile(file, options);
 	}
 	/**
 	* @param template EJS template string
@@ -1139,7 +1231,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from an EJS (Embedded JavaScript) template provided as a string. EJS is a templating language with a simple, straightforward syntax. 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.
 	*/
 	generatePdfFromEjsString(template, data = {}, options) {
-		return this.puppeteerService.generatePdfFromEjsString(template, data, options);
+		return this.#puppeteerService.generatePdfFromEjsString(template, data, options);
 	}
 	/**
 	* @param file Path to the EJS template file
@@ -1149,7 +1241,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from an EJS 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.
 	*/
 	generatePdfFromEjsFile(file, data = {}, options) {
-		return this.puppeteerService.generatePdfFromEjsFile(file, data, options);
+		return this.#puppeteerService.generatePdfFromEjsFile(file, data, options);
 	}
 	/**
 	* @param template Pug template string
@@ -1159,7 +1251,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from a Pug template provided as a string. Pug is a clean, whitespace-sensitive syntax for writing HTML. 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.
 	*/
 	generatePdfFromPugString(template, data = {}, options) {
-		return this.puppeteerService.generatePdfFromPugString(template, data, options);
+		return this.#puppeteerService.generatePdfFromPugString(template, data, options);
 	}
 	/**
 	* @param file Path to the Pug template file
@@ -1169,7 +1261,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from a Pug 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.
 	*/
 	generatePdfFromPugFile(file, data = {}, options) {
-		return this.puppeteerService.generatePdfFromPugFile(file, data, options);
+		return this.#puppeteerService.generatePdfFromPugFile(file, data, options);
 	}
 	/**
 	* @param template Nunjucks template string
@@ -1179,7 +1271,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from a Nunjucks template provided as a string. Nunjucks is a powerful templating language with support for inheritance, macros, and filters. 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.
 	*/
 	generatePdfFromNunjucksString(template, data = {}, options) {
-		return this.puppeteerService.generatePdfFromNunjucksString(template, data, options);
+		return this.#puppeteerService.generatePdfFromNunjucksString(template, data, options);
 	}
 	/**
 	* @param file Path to the Nunjucks template file
@@ -1189,7 +1281,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from a Nunjucks 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.
 	*/
 	generatePdfFromNunjucksFile(file, data = {}, options) {
-		return this.puppeteerService.generatePdfFromNunjucksFile(file, data, options);
+		return this.#puppeteerService.generatePdfFromNunjucksFile(file, data, options);
 	}
 	/**
 	* @param template Eta template string
@@ -1199,7 +1291,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from an Eta template provided as a string. Eta is a fast and lightweight embedded templating language with a syntax similar to EJS but with better performance. 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.
 	*/
 	generatePdfFromEtaString(template, data = {}, options) {
-		return this.puppeteerService.generatePdfFromEtaString(template, data, options);
+		return this.#puppeteerService.generatePdfFromEtaString(template, data, options);
 	}
 	/**
 	* @param file Path to the Eta template file
@@ -1209,7 +1301,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from an Eta 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.
 	*/
 	generatePdfFromEtaFile(file, data = {}, options) {
-		return this.puppeteerService.generatePdfFromEtaFile(file, data, options);
+		return this.#puppeteerService.generatePdfFromEtaFile(file, data, options);
 	}
 	/**
 	* @param template Mustache template string
@@ -1219,7 +1311,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from a Mustache template provided as a string. Mustache is a logic-less template language that emphasizes readable and simple templates. 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.
 	*/
 	generatePdfFromMustacheString(template, data = {}, options) {
-		return this.puppeteerService.generatePdfFromMustacheString(template, data, options);
+		return this.#puppeteerService.generatePdfFromMustacheString(template, data, options);
 	}
 	/**
 	* @param file Path to the Mustache template file
@@ -1229,7 +1321,7 @@ let NestjsPdfService = class NestjsPdfService {
 	* @description This method generates a PDF from a Mustache 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.
 	*/
 	generatePdfFromMustacheFile(file, data = {}, options) {
-		return this.puppeteerService.generatePdfFromMustacheFile(file, data, options);
+		return this.#puppeteerService.generatePdfFromMustacheFile(file, data, options);
 	}
 	/**
 	* @param pdf The PDF bytes to modify
@@ -1290,9 +1382,10 @@ var import_main = (/* @__PURE__ */ __commonJSMin(((exports, module) => {
 				defaultValue = r.join(splitter);
 				value = env[key];
 			}
-			if (value) if (seen.has(value)) result = result.replace(template, defaultValue);
-			else result = result.replace(template, value);
-			else result = result.replace(template, defaultValue);
+			if (value) {
+				if (seen.has(value)) result = result.replace(template, defaultValue);
+				else result = result.replace(template, value);
+			} else result = result.replace(template, defaultValue);
 			if (result === runningParsed[key]) break;
 			regex.lastIndex = 0;
 		}
@@ -1977,10 +2070,11 @@ var import_main$1 = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exp
 	}
 	function _vaultPath(options) {
 		let possibleVaultPath = null;
-		if (options && options.path && options.path.length > 0) if (Array.isArray(options.path)) {
-			for (const filepath of options.path) if (fs$2.existsSync(filepath)) possibleVaultPath = filepath.endsWith(".vault") ? filepath : `${filepath}.vault`;
-		} else possibleVaultPath = options.path.endsWith(".vault") ? options.path : `${options.path}.vault`;
-		else possibleVaultPath = path$1.resolve(process.cwd(), ".env.vault");
+		if (options && options.path && options.path.length > 0) {
+			if (Array.isArray(options.path)) {
+				for (const filepath of options.path) if (fs$2.existsSync(filepath)) possibleVaultPath = filepath.endsWith(".vault") ? filepath : `${filepath}.vault`;
+			} else possibleVaultPath = options.path.endsWith(".vault") ? options.path : `${options.path}.vault`;
+		} else possibleVaultPath = path$1.resolve(process.cwd(), ".env.vault");
 		if (fs$2.existsSync(possibleVaultPath)) return possibleVaultPath;
 		return null;
 	}
@@ -2007,10 +2101,12 @@ var import_main$1 = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exp
 		if (options && options.encoding) encoding = options.encoding;
 		else if (debug) _debug("no encoding is specified (UTF-8 is used by default)");
 		let optionPaths = [dotenvPath];
-		if (options && options.path) if (!Array.isArray(options.path)) optionPaths = [_resolveHome(options.path)];
-		else {
-			optionPaths = [];
-			for (const filepath of options.path) optionPaths.push(_resolveHome(filepath));
+		if (options && options.path) {
+			if (!Array.isArray(options.path)) optionPaths = [_resolveHome(options.path)];
+			else {
+				optionPaths = [];
+				for (const filepath of options.path) optionPaths.push(_resolveHome(filepath));
+			}
 		}
 		let lastError;
 		const parsedAll = {};
@@ -2090,8 +2186,10 @@ var import_main$1 = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exp
 				processEnv[key] = parsed[key];
 				populated[key] = parsed[key];
 			}
-			if (debug) if (override === true) _debug(`"${key}" is already defined and WAS overwritten`);
-			else _debug(`"${key}" is already defined and was NOT overwritten`);
+			if (debug) {
+				if (override === true) _debug(`"${key}" is already defined and WAS overwritten`);
+				else _debug(`"${key}" is already defined and was NOT overwritten`);
+			}
 		} else {
 			processEnv[key] = parsed[key];
 			populated[key] = parsed[key];
@@ -2524,14 +2622,14 @@ ConfigModule = ConfigModule_1 = __decorate([(0, _nestjs_common.Module)({
 //#region src/puppeteer/puppeteer.module.ts
 var _PuppeteerModule;
 let PuppeteerModule = _PuppeteerModule = class PuppeteerModule {
-	browserService;
-	pdfParams;
+	#browserService;
+	#pdfParams;
 	constructor(browserService, pdfParams) {
-		this.browserService = browserService;
-		this.pdfParams = pdfParams;
+		this.#browserService = browserService;
+		this.#pdfParams = pdfParams;
 	}
 	async onModuleInit() {
-		if (!this.pdfParams.executablePath) await this.browserService.install(this.pdfParams.useLockedBrowser ?? false);
+		if (!this.#pdfParams.executablePath) await this.#browserService.install(this.#pdfParams.useLockedBrowser ?? false);
 	}
 	static forRoot(pdfParameters) {
 		const providers = [
@@ -2643,12 +2741,15 @@ let NestjsPdfModule = _NestjsPdfModule = class NestjsPdfModule {
 };
 NestjsPdfModule = _NestjsPdfModule = __decorate$3([(0, _nestjs_common.Module)({})], NestjsPdfModule);
 //#endregion
+exports.BrowserInstallationException = BrowserInstallationException;
+exports.BrowserUnavailableException = BrowserUnavailableException;
 Object.defineProperty(exports, "EjsService", {
 	enumerable: true,
 	get: function() {
 		return EjsService;
 	}
 });
+exports.EngineNotAvailableException = EngineNotAvailableException;
 Object.defineProperty(exports, "EtaService", {
 	enumerable: true,
 	get: function() {
@@ -2673,6 +2774,8 @@ Object.defineProperty(exports, "MustacheService", {
 		return MustacheService;
 	}
 });
+exports.NestjsPdfErrorCode = NestjsPdfErrorCode;
+exports.NestjsPdfException = NestjsPdfException;
 Object.defineProperty(exports, "NestjsPdfModule", {
 	enumerable: true,
 	get: function() {
@@ -2691,6 +2794,7 @@ Object.defineProperty(exports, "NunjucksService", {
 		return NunjucksService;
 	}
 });
+exports.PdfGenerationException = PdfGenerationException;
 Object.defineProperty(exports, "PugService", {
 	enumerable: true,
 	get: function() {
@@ -2709,4 +2813,8 @@ Object.defineProperty(exports, "PuppeteerService", {
 		return PuppeteerService;
 	}
 });
+exports.SignatureDependencyException = SignatureDependencyException;
+exports.SignaturePlacementException = SignaturePlacementException;
+exports.TemplateConfigurationException = TemplateConfigurationException;
+exports.TemplateRenderException = TemplateRenderException;
 exports.getRelativePathToValue = getRelativePathToValue;