@shad0wz7/nestjs-pdf 2.0.1 → 2.1.0

package/README.md

@@ -3,13 +3,12 @@
 A small NestJS library to generate and manipulate PDFs using Puppeteer and multiple template engines, including Handlebars, EJS, Pug, and MJML.
 
 Main features:
+
 - Generate PDFs from HTML, Handlebars, EJS, Pug or MJML templates
 - Concurrency limiting for Puppeteer jobs (p-limit)
 - Add signature fields based on a text anchor in an existing PDF
 - Simple API (module and service) to integrate easily into a Nest application
 
-> Note: this repository contains the library source. To use it in another project, you can either install it from npm or import the local package from the source.
-
 ## Installation
 
 To add the library inside your project :
@@ -29,6 +28,14 @@ pnpm add ../path/to/nestjs-pdf
 
 Import the module and configure it in your Nest application:
 
+To use a template engine, you need to install the corresponding package as a dependency in your project:
+
+- For Handlebars: `npm install @gboutte/nestjs-hbs`
+- For EJS: `npm install ejs`
+- For Pug: `npm install pug`
+- For MJML: `npm install mjml`
+- For Nunjucks: `npm install nunjucks`
+
 ```ts
 import { Module } from '@nestjs/common';
 import { NestjsPdfModule } from 'nestjs-pdf';
@@ -68,11 +75,17 @@ Use a Handlebars template (string or file):
 
 ```ts
 const template = '<h1>{{title}}</h1><p>{{content}}</p>';
-const pdf = await pdfService.generatePdfFromTemplateHbsString(template, { title: 'T', content: '...' });
+const pdf = await pdfService.generatePdfFromTemplateHbsString(template, {
+  title: 'T',
+  content: '...',
+});
 ```
 
 ```ts
-const pdf = await pdfService.generatePdfFromTemplateHbsFile(filePath, { title: 'T', content: '...' });
+const pdf = await pdfService.generatePdfFromTemplateHbsFile(filePath, {
+  title: 'T',
+  content: '...',
+});
 ```
 
 Add a signature field to an existing PDF (anchor-based):
@@ -94,9 +107,65 @@ If the anchor is not found, the signature field will be added at a default posit
 
 The library exposes Puppeteer options via the `PuppeteerParameters` interface (see `src/puppeteer/puppeteer-parameters.interface.ts`). You can configure:
 
-- `headless` (boolean | 'shell')
-- `pdfOptions` (native Puppeteer options for `page.pdf`)
-- `extraPuppeteerArgs` (launch arguments for Chromium)
+
+|                             | Description                                                                                                                                                                                                                                                                                    |
+|-----------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `pdfOptions`                | The pdf options can be found on: https://pptr.dev/api/puppeteer.pdfoptions. Native Puppeteer options for `page.pdf`                                                                                                                                                                            |
+| `hbsOptions`                | The handlebars can be found on [@gboutte/nestjs-hbs](https://github.com/gboutte/nestjs-hbs) as it use a peer dependency and not handlebars directly                                                                                                                                            |
+| `ejsOptions`                | The ejs options can be found on [EJS documentation](https://ejs.co/#options)                                                                                                                                                                                                                   |
+| `pugOptions`                | The pug options can be found on [Pug documentation](https://pugjs.org/api/reference.html#options)                                                                                                                                                                                              |
+| `mjmlOptions`               | The mjml options can be found on [MJML documentation](https://mjml.io/documentation/#options)                                                                                                                                                                                                  |
+| `nunjucksOptions`           | The nunjucks options can be found on [Nunjucks documentation](https://mozilla.github.io/nunjucks/api.html#configure)                                                                                                                                                                           |
+| `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`                                                                                                                |
+| `headless`                  | Define if you want to use chromium headless or not, or the old headless version (`shell`). By default it's `true`. Allowed values: `true`,`false`,`"shell"`                                                                                                                                    |
+| `useLockedBrowser`          | Define if you want to use the locked version of the browser. By default it's `false`. Allowed values: `true`,`false`                                                                                                                                                                           |
+| `buildId`                   | You can force the build id. Should be `string`                                                                                                                                                                                                                                                 |
+| `cleanupBrowserCacheOnExit` | Define if you want to clean up the browser cache folder on exit. By default it's `true`. Allowed values: `true`,`false`                                                                                                                                                                        |
+| `extraPuppeteerArgs`        | It passes some extra arguments to Puppeteer's launch method. You can check the default args at bellow. Should be `string[]`                                                                                                                                                                    |
+
+these are the default extra arguments passed to Puppeteer:
+```ts
+[
+  '--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-popup-blocking',
+  '--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',
+];
+```
 
 You can use `forRootAsync(...)` if you need to provide configuration asynchronously.
 

package/dist/index.d.mts

@@ -6,6 +6,7 @@ import { Browser, BrowserContext, PDFOptions } from 'puppeteer';
 import { MJMLParsingOptions } from 'mjml-core';
 import pug, { LocalsObject } from 'pug';
 import { Options, Data } from 'ejs';
+import { ConfigureOptions } from 'nunjucks';
 import { HandlebarsService } from '@gboutte/nestjs-hbs';
 
 declare enum BrowserTag {
@@ -67,12 +68,26 @@ declare class EjsService {
     renderFile(filePath: string, data?: Data, options?: EjsOptions): Promise<string>;
 }
 
+interface NunjucksOptions extends Partial<ConfigureOptions> {
+    noCache?: boolean;
+    watch?: boolean;
+    throwOnUndefined?: boolean;
+    trimBlocks?: boolean;
+    lstripBlocks?: boolean;
+}
+declare class NunjucksService {
+    constructor();
+    render(template: string, data?: Record<string, unknown>, options?: NunjucksOptions): string;
+    renderFile(filePath: string, data?: Record<string, unknown>, options?: NunjucksOptions): string;
+}
+
 interface PuppeteerParameters {
     pdfOptions?: PDFOptions;
     hbsOptions?: HandlebarsOptions;
     mjmlOptions?: MJMLParsingOptions;
     pugOptions?: PugOptions;
     ejsOptions?: EjsOptions;
+    nunjucksOptions?: NunjucksOptions;
     chromiumRevision?: string;
     buildId?: string;
     headless?: boolean | 'shell';
@@ -105,7 +120,8 @@ declare class PuppeteerService {
     private readonly mjmlService?;
     private readonly pugService?;
     private readonly ejsService?;
-    constructor(hbsService: HandlebarsService, browserService: BrowserService, options: PuppeteerParameters, mjmlService?: MjmlService | undefined, pugService?: PugService | undefined, ejsService?: EjsService | undefined);
+    private readonly nunjucksService?;
+    constructor(hbsService: HandlebarsService, browserService: BrowserService, options: PuppeteerParameters, mjmlService?: MjmlService | undefined, pugService?: PugService | undefined, ejsService?: EjsService | undefined, nunjucksService?: NunjucksService | undefined);
     private readonly limit;
     generatePdfFromHtml(html: string, options?: PuppeteerParameters): Promise<Uint8Array>;
     generatePdfFromTemplateHbsString(template: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
@@ -116,6 +132,8 @@ declare class PuppeteerService {
     generatePdfFromPugFile(file: string, data?: LocalsObject, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
     generatePdfFromEjsString(template: string, data?: Data, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
     generatePdfFromEjsFile(file: string, data?: Data, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+    generatePdfFromNunjucksString(template: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+    generatePdfFromNunjucksFile(file: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
 }
 
 declare class NestjsPdfService {
@@ -128,24 +146,6 @@ declare 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: string, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
-    /**
-     * @deprecated Use the new method generatePdfFromTemplateHbsString
-     * @param template Handlebars template string
-     * @param parameters Data parameters to inject into the template
-     * @param options PDF generation options (optional)
-     * @returns PDF generated from the provided Handlebars template with parameters applied
-     * @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.
-     */
-    generatePdfFromTemplateString(template: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
-    /**
-     * @deprecated Use the new method generatePdfFromTemplateHbsFile
-     * @param file Path to the Handlebars template file
-     * @param parameters Data parameters to inject into the template
-     * @param options PDF generation options (optional)
-     * @returns PDF generated from the Handlebars template at the provided file path with parameters applied
-     * @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.
-     */
-    generatePdfFromTemplateFile(file: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
     /**
      * @param template Handlebars template string
      * @param parameters Data parameters to inject into the template
@@ -208,6 +208,22 @@ declare 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: string, data?: LocalsObject, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+    /**
+     * @param template Nunjucks template string
+     * @param data Data to inject into the template
+     * @param options PDF generation options (optional)
+     * @returns PDF generated from the provided Nunjucks template with data applied
+     * @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: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+    /**
+     * @param file Path to the Nunjucks template file
+     * @param data Data to inject into the template
+     * @param options PDF generation options (optional)
+     * @returns PDF generated from the Nunjucks template at the provided file path with data applied
+     * @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: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
     /**
      * @param pdf The PDF bytes to modify
      * @param fieldName The name of the signature field to add (default: 'SignatureDebtor')
@@ -257,4 +273,4 @@ declare class PuppeteerModule implements OnModuleInit {
  */
 declare function getRelativePathToValue(moduleDir: string, relativeToModule: string): string;
 
-export { type EjsOptions, EjsService, MjmlService, NestjsPdfModule, NestjsPdfService, type PdfLibModuleAsyncOptions, type PugOptions, PugService, PuppeteerModule, type PuppeteerModuleAsyncOptions, type PuppeteerParameters, PuppeteerService, getRelativePathToValue };
+export { type EjsOptions, EjsService, MjmlService, NestjsPdfModule, NestjsPdfService, type NunjucksOptions, NunjucksService, type PdfLibModuleAsyncOptions, type PugOptions, PugService, PuppeteerModule, type PuppeteerModuleAsyncOptions, type PuppeteerParameters, PuppeteerService, getRelativePathToValue };

package/dist/index.d.ts

@@ -6,6 +6,7 @@ import { Browser, BrowserContext, PDFOptions } from 'puppeteer';
 import { MJMLParsingOptions } from 'mjml-core';
 import pug, { LocalsObject } from 'pug';
 import { Options, Data } from 'ejs';
+import { ConfigureOptions } from 'nunjucks';
 import { HandlebarsService } from '@gboutte/nestjs-hbs';
 
 declare enum BrowserTag {
@@ -67,12 +68,26 @@ declare class EjsService {
     renderFile(filePath: string, data?: Data, options?: EjsOptions): Promise<string>;
 }
 
+interface NunjucksOptions extends Partial<ConfigureOptions> {
+    noCache?: boolean;
+    watch?: boolean;
+    throwOnUndefined?: boolean;
+    trimBlocks?: boolean;
+    lstripBlocks?: boolean;
+}
+declare class NunjucksService {
+    constructor();
+    render(template: string, data?: Record<string, unknown>, options?: NunjucksOptions): string;
+    renderFile(filePath: string, data?: Record<string, unknown>, options?: NunjucksOptions): string;
+}
+
 interface PuppeteerParameters {
     pdfOptions?: PDFOptions;
     hbsOptions?: HandlebarsOptions;
     mjmlOptions?: MJMLParsingOptions;
     pugOptions?: PugOptions;
     ejsOptions?: EjsOptions;
+    nunjucksOptions?: NunjucksOptions;
     chromiumRevision?: string;
     buildId?: string;
     headless?: boolean | 'shell';
@@ -105,7 +120,8 @@ declare class PuppeteerService {
     private readonly mjmlService?;
     private readonly pugService?;
     private readonly ejsService?;
-    constructor(hbsService: HandlebarsService, browserService: BrowserService, options: PuppeteerParameters, mjmlService?: MjmlService | undefined, pugService?: PugService | undefined, ejsService?: EjsService | undefined);
+    private readonly nunjucksService?;
+    constructor(hbsService: HandlebarsService, browserService: BrowserService, options: PuppeteerParameters, mjmlService?: MjmlService | undefined, pugService?: PugService | undefined, ejsService?: EjsService | undefined, nunjucksService?: NunjucksService | undefined);
     private readonly limit;
     generatePdfFromHtml(html: string, options?: PuppeteerParameters): Promise<Uint8Array>;
     generatePdfFromTemplateHbsString(template: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
@@ -116,6 +132,8 @@ declare class PuppeteerService {
     generatePdfFromPugFile(file: string, data?: LocalsObject, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
     generatePdfFromEjsString(template: string, data?: Data, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
     generatePdfFromEjsFile(file: string, data?: Data, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+    generatePdfFromNunjucksString(template: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+    generatePdfFromNunjucksFile(file: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
 }
 
 declare class NestjsPdfService {
@@ -128,24 +146,6 @@ declare 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: string, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
-    /**
-     * @deprecated Use the new method generatePdfFromTemplateHbsString
-     * @param template Handlebars template string
-     * @param parameters Data parameters to inject into the template
-     * @param options PDF generation options (optional)
-     * @returns PDF generated from the provided Handlebars template with parameters applied
-     * @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.
-     */
-    generatePdfFromTemplateString(template: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
-    /**
-     * @deprecated Use the new method generatePdfFromTemplateHbsFile
-     * @param file Path to the Handlebars template file
-     * @param parameters Data parameters to inject into the template
-     * @param options PDF generation options (optional)
-     * @returns PDF generated from the Handlebars template at the provided file path with parameters applied
-     * @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.
-     */
-    generatePdfFromTemplateFile(file: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
     /**
      * @param template Handlebars template string
      * @param parameters Data parameters to inject into the template
@@ -208,6 +208,22 @@ declare 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: string, data?: LocalsObject, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+    /**
+     * @param template Nunjucks template string
+     * @param data Data to inject into the template
+     * @param options PDF generation options (optional)
+     * @returns PDF generated from the provided Nunjucks template with data applied
+     * @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: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+    /**
+     * @param file Path to the Nunjucks template file
+     * @param data Data to inject into the template
+     * @param options PDF generation options (optional)
+     * @returns PDF generated from the Nunjucks template at the provided file path with data applied
+     * @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: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
     /**
      * @param pdf The PDF bytes to modify
      * @param fieldName The name of the signature field to add (default: 'SignatureDebtor')
@@ -257,4 +273,4 @@ declare class PuppeteerModule implements OnModuleInit {
  */
 declare function getRelativePathToValue(moduleDir: string, relativeToModule: string): string;
 
-export { type EjsOptions, EjsService, MjmlService, NestjsPdfModule, NestjsPdfService, type PdfLibModuleAsyncOptions, type PugOptions, PugService, PuppeteerModule, type PuppeteerModuleAsyncOptions, type PuppeteerParameters, PuppeteerService, getRelativePathToValue };
+export { type EjsOptions, EjsService, MjmlService, NestjsPdfModule, NestjsPdfService, type NunjucksOptions, NunjucksService, type PdfLibModuleAsyncOptions, type PugOptions, PugService, PuppeteerModule, type PuppeteerModuleAsyncOptions, type PuppeteerParameters, PuppeteerService, getRelativePathToValue };

package/dist/index.js

@@ -2578,6 +2578,7 @@ __export(index_exports, {
   MjmlService: () => MjmlService,
   NestjsPdfModule: () => NestjsPdfModule,
   NestjsPdfService: () => NestjsPdfService,
+  NunjucksService: () => NunjucksService,
   PugService: () => PugService,
   PuppeteerModule: () => PuppeteerModule,
   PuppeteerService: () => PuppeteerService,
@@ -2586,13 +2587,13 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/nestjs-pdf.module.ts
-var import_common8 = require("@nestjs/common");
+var import_common9 = require("@nestjs/common");
 
 // src/nestjs-pdf.service.ts
-var import_common6 = require("@nestjs/common");
+var import_common7 = require("@nestjs/common");
 
 // src/puppeteer/puppeteer.service.ts
-var import_common5 = require("@nestjs/common");
+var import_common6 = require("@nestjs/common");
 
 // src/puppeteer/helpers/tokens.ts
 var PDF_PARAMETERS = "PDF_PARAMETERS";
@@ -3065,7 +3066,9 @@ EjsService = _ts_decorate4([
   (0, import_common4.Injectable)()
 ], EjsService);
 
-// src/puppeteer/puppeteer.service.ts
+// src/puppeteer/services/nunjucks.service.ts
+var import_common5 = require("@nestjs/common");
+var nunjucks = __toESM(require("nunjucks"));
 function _ts_decorate5(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);
@@ -3077,6 +3080,74 @@ function _ts_metadata2(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 __name(_ts_metadata2, "_ts_metadata");
+var NunjucksService = class {
+  static {
+    __name(this, "NunjucksService");
+  }
+  constructor() {
+    nunjucks.configure({
+      noCache: true,
+      trimBlocks: true,
+      lstripBlocks: true
+    });
+  }
+  render(template, data = {}, options) {
+    try {
+      if (options) {
+        const configOptions = {
+          noCache: options.noCache ?? true,
+          watch: options.watch ?? false,
+          throwOnUndefined: options.throwOnUndefined ?? false,
+          trimBlocks: options.trimBlocks ?? true,
+          lstripBlocks: options.lstripBlocks ?? true
+        };
+        nunjucks.configure(configOptions);
+      }
+      return nunjucks.renderString(template, data);
+    } catch (error) {
+      throw new Error(`Nunjucks rendering failed: ${String(error)}`, {
+        cause: error
+      });
+    }
+  }
+  renderFile(filePath, data = {}, options) {
+    try {
+      if (options) {
+        const configOptions = {
+          noCache: options.noCache ?? true,
+          watch: options.watch ?? false,
+          throwOnUndefined: options.throwOnUndefined ?? false,
+          trimBlocks: options.trimBlocks ?? true,
+          lstripBlocks: options.lstripBlocks ?? true
+        };
+        nunjucks.configure(configOptions);
+      }
+      return nunjucks.render(filePath, data);
+    } catch (error) {
+      throw new Error(`Nunjucks file rendering failed: ${String(error)}`, {
+        cause: error
+      });
+    }
+  }
+};
+NunjucksService = _ts_decorate5([
+  (0, import_common5.Injectable)(),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [])
+], NunjucksService);
+
+// src/puppeteer/puppeteer.service.ts
+function _ts_decorate6(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;
+}
+__name(_ts_decorate6, "_ts_decorate");
+function _ts_metadata3(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata3, "_ts_metadata");
 function _ts_param2(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
@@ -3093,20 +3164,22 @@ var PuppeteerService = class {
   mjmlService;
   pugService;
   ejsService;
-  constructor(hbsService, browserService, options, mjmlService, pugService, ejsService) {
+  nunjucksService;
+  constructor(hbsService, browserService, options, mjmlService, pugService, ejsService, nunjucksService) {
     this.hbsService = hbsService;
     this.browserService = browserService;
     this.options = options;
     this.mjmlService = mjmlService;
     this.pugService = pugService;
     this.ejsService = ejsService;
+    this.nunjucksService = nunjucksService;
   }
   limit = (0, import_p_limit.default)(3);
   async generatePdfFromHtml(html, options) {
     return this.limit(async () => {
       const mergePuppeteerOptions = mergePuppeteerParameters(this.options, options);
       if (mergePuppeteerOptions.chromiumRevision !== void 0) {
-        import_common5.Logger.warn("Using `chromiumRevision` is no longer supported since the puppeteer update.");
+        import_common6.Logger.warn("Using `chromiumRevision` is no longer supported since the puppeteer update.");
       }
       const headless = mergePuppeteerOptions.headless ?? true;
       const args = mergePuppeteerOptions.extraPuppeteerArgs || [
@@ -3166,14 +3239,14 @@ var PuppeteerService = class {
         await page.evaluate(() => document.fonts.ready);
         return await page.pdf(pdfOptions);
       } catch (e) {
-        import_common5.Logger.error(e);
+        import_common6.Logger.error(e);
         throw e;
       } finally {
         if (context) {
           try {
             await context.close();
           } catch (error) {
-            import_common5.Logger.error(error);
+            import_common6.Logger.error(error);
           }
         }
         await this.browserService.markJobFinished();
@@ -3230,21 +3303,37 @@ var PuppeteerService = class {
     const html = await this.ejsService.renderFile(file, data, options?.ejsOptions ?? this.options.ejsOptions);
     return this.generatePdfFromHtml(html, options);
   }
+  async generatePdfFromNunjucksString(template, data = {}, options) {
+    if (!this.nunjucksService) {
+      throw new Error("Nunjucks service is not available. If the problem persists, open an issue in the repo.");
+    }
+    const html = this.nunjucksService.render(template, data, options?.nunjucksOptions ?? this.options.nunjucksOptions);
+    return this.generatePdfFromHtml(html, options);
+  }
+  async generatePdfFromNunjucksFile(file, data = {}, options) {
+    if (!this.nunjucksService) {
+      throw new Error("Nunjucks service is not available. If the problem persists, open an issue in the repo.");
+    }
+    const html = this.nunjucksService.renderFile(file, data, options?.nunjucksOptions ?? this.options.nunjucksOptions);
+    return this.generatePdfFromHtml(html, options);
+  }
 };
-PuppeteerService = _ts_decorate5([
-  (0, import_common5.Injectable)(),
-  _ts_param2(2, (0, import_common5.Inject)(PDF_PARAMETERS)),
-  _ts_param2(3, (0, import_common5.Optional)()),
-  _ts_param2(4, (0, import_common5.Optional)()),
-  _ts_param2(5, (0, import_common5.Optional)()),
-  _ts_metadata2("design:type", Function),
-  _ts_metadata2("design:paramtypes", [
+PuppeteerService = _ts_decorate6([
+  (0, import_common6.Injectable)(),
+  _ts_param2(2, (0, import_common6.Inject)(PDF_PARAMETERS)),
+  _ts_param2(3, (0, import_common6.Optional)()),
+  _ts_param2(4, (0, import_common6.Optional)()),
+  _ts_param2(5, (0, import_common6.Optional)()),
+  _ts_param2(6, (0, import_common6.Optional)()),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
     typeof import_nestjs_hbs.HandlebarsService === "undefined" ? Object : import_nestjs_hbs.HandlebarsService,
     typeof BrowserService === "undefined" ? Object : BrowserService,
     typeof PuppeteerParameters === "undefined" ? Object : PuppeteerParameters,
     typeof MjmlService === "undefined" ? Object : MjmlService,
     typeof PugService === "undefined" ? Object : PugService,
-    typeof EjsService === "undefined" ? Object : EjsService
+    typeof EjsService === "undefined" ? Object : EjsService,
+    typeof NunjucksService === "undefined" ? Object : NunjucksService
   ])
 ], PuppeteerService);
 
@@ -3402,17 +3491,17 @@ async function addSignatureFieldUsingAnchor(pdf, fieldName = "SignatureDebtor",
 __name(addSignatureFieldUsingAnchor, "addSignatureFieldUsingAnchor");
 
 // src/nestjs-pdf.service.ts
-function _ts_decorate6(decorators, target, key, desc) {
+function _ts_decorate7(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;
 }
-__name(_ts_decorate6, "_ts_decorate");
-function _ts_metadata3(k, v) {
+__name(_ts_decorate7, "_ts_decorate");
+function _ts_metadata4(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata3, "_ts_metadata");
+__name(_ts_metadata4, "_ts_metadata");
 var NestjsPdfService = class {
   static {
     __name(this, "NestjsPdfService");
@@ -3431,28 +3520,6 @@ var NestjsPdfService = class {
     return this.puppeteerService.generatePdfFromHtml(html, options);
   }
   /**
-  * @deprecated Use the new method generatePdfFromTemplateHbsString
-  * @param template Handlebars template string
-  * @param parameters Data parameters to inject into the template
-  * @param options PDF generation options (optional)
-  * @returns PDF generated from the provided Handlebars template with parameters applied
-  * @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.
-  */
-  generatePdfFromTemplateString(template, parameters = {}, options) {
-    return this.generatePdfFromTemplateHbsString(template, parameters, options);
-  }
-  /**
-  * @deprecated Use the new method generatePdfFromTemplateHbsFile
-  * @param file Path to the Handlebars template file
-  * @param parameters Data parameters to inject into the template
-  * @param options PDF generation options (optional)
-  * @returns PDF generated from the Handlebars template at the provided file path with parameters applied
-  * @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.
-  */
-  generatePdfFromTemplateFile(file, parameters = {}, options) {
-    return this.generatePdfFromTemplateHbsFile(file, parameters, options);
-  }
-  /**
   * @param template Handlebars template string
   * @param parameters Data parameters to inject into the template
   * @param options PDF generation options (optional)
@@ -3531,6 +3598,26 @@ var NestjsPdfService = class {
     return this.puppeteerService.generatePdfFromPugFile(file, data, options);
   }
   /**
+  * @param template Nunjucks template string
+  * @param data Data to inject into the template
+  * @param options PDF generation options (optional)
+  * @returns PDF generated from the provided Nunjucks template with data applied
+  * @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);
+  }
+  /**
+  * @param file Path to the Nunjucks template file
+  * @param data Data to inject into the template
+  * @param options PDF generation options (optional)
+  * @returns PDF generated from the Nunjucks template at the provided file path with data applied
+  * @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);
+  }
+  /**
   * @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__')
@@ -3556,29 +3643,29 @@ var NestjsPdfService = class {
     return await addSignatureFieldUsingAnchor(pdf, fieldName, anchorText);
   }
 };
-NestjsPdfService = _ts_decorate6([
-  (0, import_common6.Injectable)(),
-  _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", [
+NestjsPdfService = _ts_decorate7([
+  (0, import_common7.Injectable)(),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
     typeof PuppeteerService === "undefined" ? Object : PuppeteerService
   ])
 ], NestjsPdfService);
 
 // src/puppeteer/puppeteer.module.ts
-var import_common7 = require("@nestjs/common");
+var import_common8 = require("@nestjs/common");
 var import_config = __toESM(require_config());
 var import_nestjs_hbs2 = require("@gboutte/nestjs-hbs");
-function _ts_decorate7(decorators, target, key, desc) {
+function _ts_decorate8(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;
 }
-__name(_ts_decorate7, "_ts_decorate");
-function _ts_metadata4(k, v) {
+__name(_ts_decorate8, "_ts_decorate");
+function _ts_metadata5(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata4, "_ts_metadata");
+__name(_ts_metadata5, "_ts_metadata");
 function _ts_param3(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
@@ -3611,7 +3698,8 @@ var PuppeteerModule = class _PuppeteerModule {
       import_nestjs_hbs2.HandlebarsService,
       MjmlService,
       PugService,
-      EjsService
+      EjsService,
+      NunjucksService
     ];
     return {
       module: _PuppeteerModule,
@@ -3623,7 +3711,8 @@ var PuppeteerModule = class _PuppeteerModule {
         PuppeteerService,
         MjmlService,
         PugService,
-        EjsService
+        EjsService,
+        NunjucksService
       ]
     };
   }
@@ -3654,49 +3743,53 @@ var PuppeteerModule = class _PuppeteerModule {
         import_nestjs_hbs2.HandlebarsService,
         MjmlService,
         PugService,
-        EjsService
+        EjsService,
+        NunjucksService
       ],
       exports: [
         PuppeteerService,
         MjmlService,
         PugService,
-        EjsService
+        EjsService,
+        NunjucksService
       ]
     };
   }
 };
-PuppeteerModule = _ts_decorate7([
-  (0, import_common7.Module)({
+PuppeteerModule = _ts_decorate8([
+  (0, import_common8.Module)({
     providers: [
       PuppeteerService,
       BrowserService,
       MjmlService,
       PugService,
-      EjsService
+      EjsService,
+      NunjucksService
     ],
     exports: [
       PuppeteerService,
       MjmlService,
       PugService,
-      EjsService
+      EjsService,
+      NunjucksService
     ]
   }),
-  _ts_param3(1, (0, import_common7.Inject)(PDF_PARAMETERS)),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+  _ts_param3(1, (0, import_common8.Inject)(PDF_PARAMETERS)),
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     typeof BrowserService === "undefined" ? Object : BrowserService,
     typeof PuppeteerParameters === "undefined" ? Object : PuppeteerParameters
   ])
 ], PuppeteerModule);
 
 // src/nestjs-pdf.module.ts
-function _ts_decorate8(decorators, target, key, desc) {
+function _ts_decorate9(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;
 }
-__name(_ts_decorate8, "_ts_decorate");
+__name(_ts_decorate9, "_ts_decorate");
 var NestjsPdfModule = class _NestjsPdfModule {
   static {
     __name(this, "NestjsPdfModule");
@@ -3730,8 +3823,8 @@ var NestjsPdfModule = class _NestjsPdfModule {
     };
   }
 };
-NestjsPdfModule = _ts_decorate8([
-  (0, import_common8.Module)({})
+NestjsPdfModule = _ts_decorate9([
+  (0, import_common9.Module)({})
 ], NestjsPdfModule);
 
 // src/helpers/getRelativePath.helper.ts
@@ -3747,6 +3840,7 @@ __name(getRelativePathToValue, "getRelativePathToValue");
   MjmlService,
   NestjsPdfModule,
   NestjsPdfService,
+  NunjucksService,
   PugService,
   PuppeteerModule,
   PuppeteerService,

package/dist/index.mjs

@@ -2575,10 +2575,10 @@ var require_config = __commonJS({
 import { Module as Module2 } from "@nestjs/common";
 
 // src/nestjs-pdf.service.ts
-import { Injectable as Injectable6 } from "@nestjs/common";
+import { Injectable as Injectable7 } from "@nestjs/common";
 
 // src/puppeteer/puppeteer.service.ts
-import { Inject as Inject2, Injectable as Injectable5, Logger as Logger2, Optional } from "@nestjs/common";
+import { Inject as Inject2, Injectable as Injectable6, Logger as Logger2, Optional } from "@nestjs/common";
 
 // src/puppeteer/helpers/tokens.ts
 var PDF_PARAMETERS = "PDF_PARAMETERS";
@@ -3051,7 +3051,9 @@ EjsService = _ts_decorate4([
   Injectable4()
 ], EjsService);
 
-// src/puppeteer/puppeteer.service.ts
+// src/puppeteer/services/nunjucks.service.ts
+import { Injectable as Injectable5 } from "@nestjs/common";
+import * as nunjucks from "nunjucks";
 function _ts_decorate5(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);
@@ -3063,6 +3065,74 @@ function _ts_metadata2(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 __name(_ts_metadata2, "_ts_metadata");
+var NunjucksService = class {
+  static {
+    __name(this, "NunjucksService");
+  }
+  constructor() {
+    nunjucks.configure({
+      noCache: true,
+      trimBlocks: true,
+      lstripBlocks: true
+    });
+  }
+  render(template, data = {}, options) {
+    try {
+      if (options) {
+        const configOptions = {
+          noCache: options.noCache ?? true,
+          watch: options.watch ?? false,
+          throwOnUndefined: options.throwOnUndefined ?? false,
+          trimBlocks: options.trimBlocks ?? true,
+          lstripBlocks: options.lstripBlocks ?? true
+        };
+        nunjucks.configure(configOptions);
+      }
+      return nunjucks.renderString(template, data);
+    } catch (error) {
+      throw new Error(`Nunjucks rendering failed: ${String(error)}`, {
+        cause: error
+      });
+    }
+  }
+  renderFile(filePath, data = {}, options) {
+    try {
+      if (options) {
+        const configOptions = {
+          noCache: options.noCache ?? true,
+          watch: options.watch ?? false,
+          throwOnUndefined: options.throwOnUndefined ?? false,
+          trimBlocks: options.trimBlocks ?? true,
+          lstripBlocks: options.lstripBlocks ?? true
+        };
+        nunjucks.configure(configOptions);
+      }
+      return nunjucks.render(filePath, data);
+    } catch (error) {
+      throw new Error(`Nunjucks file rendering failed: ${String(error)}`, {
+        cause: error
+      });
+    }
+  }
+};
+NunjucksService = _ts_decorate5([
+  Injectable5(),
+  _ts_metadata2("design:type", Function),
+  _ts_metadata2("design:paramtypes", [])
+], NunjucksService);
+
+// src/puppeteer/puppeteer.service.ts
+function _ts_decorate6(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;
+}
+__name(_ts_decorate6, "_ts_decorate");
+function _ts_metadata3(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata3, "_ts_metadata");
 function _ts_param2(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
@@ -3079,13 +3149,15 @@ var PuppeteerService = class {
   mjmlService;
   pugService;
   ejsService;
-  constructor(hbsService, browserService, options, mjmlService, pugService, ejsService) {
+  nunjucksService;
+  constructor(hbsService, browserService, options, mjmlService, pugService, ejsService, nunjucksService) {
     this.hbsService = hbsService;
     this.browserService = browserService;
     this.options = options;
     this.mjmlService = mjmlService;
     this.pugService = pugService;
     this.ejsService = ejsService;
+    this.nunjucksService = nunjucksService;
   }
   limit = pLimit(3);
   async generatePdfFromHtml(html, options) {
@@ -3216,21 +3288,37 @@ var PuppeteerService = class {
     const html = await this.ejsService.renderFile(file, data, options?.ejsOptions ?? this.options.ejsOptions);
     return this.generatePdfFromHtml(html, options);
   }
+  async generatePdfFromNunjucksString(template, data = {}, options) {
+    if (!this.nunjucksService) {
+      throw new Error("Nunjucks service is not available. If the problem persists, open an issue in the repo.");
+    }
+    const html = this.nunjucksService.render(template, data, options?.nunjucksOptions ?? this.options.nunjucksOptions);
+    return this.generatePdfFromHtml(html, options);
+  }
+  async generatePdfFromNunjucksFile(file, data = {}, options) {
+    if (!this.nunjucksService) {
+      throw new Error("Nunjucks service is not available. If the problem persists, open an issue in the repo.");
+    }
+    const html = this.nunjucksService.renderFile(file, data, options?.nunjucksOptions ?? this.options.nunjucksOptions);
+    return this.generatePdfFromHtml(html, options);
+  }
 };
-PuppeteerService = _ts_decorate5([
-  Injectable5(),
+PuppeteerService = _ts_decorate6([
+  Injectable6(),
   _ts_param2(2, Inject2(PDF_PARAMETERS)),
   _ts_param2(3, Optional()),
   _ts_param2(4, Optional()),
   _ts_param2(5, Optional()),
-  _ts_metadata2("design:type", Function),
-  _ts_metadata2("design:paramtypes", [
+  _ts_param2(6, Optional()),
+  _ts_metadata3("design:type", Function),
+  _ts_metadata3("design:paramtypes", [
     typeof HandlebarsService === "undefined" ? Object : HandlebarsService,
     typeof BrowserService === "undefined" ? Object : BrowserService,
     typeof PuppeteerParameters === "undefined" ? Object : PuppeteerParameters,
     typeof MjmlService === "undefined" ? Object : MjmlService,
     typeof PugService === "undefined" ? Object : PugService,
-    typeof EjsService === "undefined" ? Object : EjsService
+    typeof EjsService === "undefined" ? Object : EjsService,
+    typeof NunjucksService === "undefined" ? Object : NunjucksService
   ])
 ], PuppeteerService);
 
@@ -3388,17 +3476,17 @@ async function addSignatureFieldUsingAnchor(pdf, fieldName = "SignatureDebtor",
 __name(addSignatureFieldUsingAnchor, "addSignatureFieldUsingAnchor");
 
 // src/nestjs-pdf.service.ts
-function _ts_decorate6(decorators, target, key, desc) {
+function _ts_decorate7(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;
 }
-__name(_ts_decorate6, "_ts_decorate");
-function _ts_metadata3(k, v) {
+__name(_ts_decorate7, "_ts_decorate");
+function _ts_metadata4(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata3, "_ts_metadata");
+__name(_ts_metadata4, "_ts_metadata");
 var NestjsPdfService = class {
   static {
     __name(this, "NestjsPdfService");
@@ -3417,28 +3505,6 @@ var NestjsPdfService = class {
     return this.puppeteerService.generatePdfFromHtml(html, options);
   }
   /**
-  * @deprecated Use the new method generatePdfFromTemplateHbsString
-  * @param template Handlebars template string
-  * @param parameters Data parameters to inject into the template
-  * @param options PDF generation options (optional)
-  * @returns PDF generated from the provided Handlebars template with parameters applied
-  * @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.
-  */
-  generatePdfFromTemplateString(template, parameters = {}, options) {
-    return this.generatePdfFromTemplateHbsString(template, parameters, options);
-  }
-  /**
-  * @deprecated Use the new method generatePdfFromTemplateHbsFile
-  * @param file Path to the Handlebars template file
-  * @param parameters Data parameters to inject into the template
-  * @param options PDF generation options (optional)
-  * @returns PDF generated from the Handlebars template at the provided file path with parameters applied
-  * @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.
-  */
-  generatePdfFromTemplateFile(file, parameters = {}, options) {
-    return this.generatePdfFromTemplateHbsFile(file, parameters, options);
-  }
-  /**
   * @param template Handlebars template string
   * @param parameters Data parameters to inject into the template
   * @param options PDF generation options (optional)
@@ -3517,6 +3583,26 @@ var NestjsPdfService = class {
     return this.puppeteerService.generatePdfFromPugFile(file, data, options);
   }
   /**
+  * @param template Nunjucks template string
+  * @param data Data to inject into the template
+  * @param options PDF generation options (optional)
+  * @returns PDF generated from the provided Nunjucks template with data applied
+  * @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);
+  }
+  /**
+  * @param file Path to the Nunjucks template file
+  * @param data Data to inject into the template
+  * @param options PDF generation options (optional)
+  * @returns PDF generated from the Nunjucks template at the provided file path with data applied
+  * @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);
+  }
+  /**
   * @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__')
@@ -3542,10 +3628,10 @@ var NestjsPdfService = class {
     return await addSignatureFieldUsingAnchor(pdf, fieldName, anchorText);
   }
 };
-NestjsPdfService = _ts_decorate6([
-  Injectable6(),
-  _ts_metadata3("design:type", Function),
-  _ts_metadata3("design:paramtypes", [
+NestjsPdfService = _ts_decorate7([
+  Injectable7(),
+  _ts_metadata4("design:type", Function),
+  _ts_metadata4("design:paramtypes", [
     typeof PuppeteerService === "undefined" ? Object : PuppeteerService
   ])
 ], NestjsPdfService);
@@ -3554,17 +3640,17 @@ NestjsPdfService = _ts_decorate6([
 import { Inject as Inject3, Module } from "@nestjs/common";
 var import_config = __toESM(require_config());
 import { HandlebarsService as HandlebarsService2 } from "@gboutte/nestjs-hbs";
-function _ts_decorate7(decorators, target, key, desc) {
+function _ts_decorate8(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;
 }
-__name(_ts_decorate7, "_ts_decorate");
-function _ts_metadata4(k, v) {
+__name(_ts_decorate8, "_ts_decorate");
+function _ts_metadata5(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-__name(_ts_metadata4, "_ts_metadata");
+__name(_ts_metadata5, "_ts_metadata");
 function _ts_param3(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
@@ -3597,7 +3683,8 @@ var PuppeteerModule = class _PuppeteerModule {
       HandlebarsService2,
       MjmlService,
       PugService,
-      EjsService
+      EjsService,
+      NunjucksService
     ];
     return {
       module: _PuppeteerModule,
@@ -3609,7 +3696,8 @@ var PuppeteerModule = class _PuppeteerModule {
         PuppeteerService,
         MjmlService,
         PugService,
-        EjsService
+        EjsService,
+        NunjucksService
       ]
     };
   }
@@ -3640,49 +3728,53 @@ var PuppeteerModule = class _PuppeteerModule {
         HandlebarsService2,
         MjmlService,
         PugService,
-        EjsService
+        EjsService,
+        NunjucksService
       ],
       exports: [
         PuppeteerService,
         MjmlService,
         PugService,
-        EjsService
+        EjsService,
+        NunjucksService
       ]
     };
   }
 };
-PuppeteerModule = _ts_decorate7([
+PuppeteerModule = _ts_decorate8([
   Module({
     providers: [
       PuppeteerService,
       BrowserService,
       MjmlService,
       PugService,
-      EjsService
+      EjsService,
+      NunjucksService
     ],
     exports: [
       PuppeteerService,
       MjmlService,
       PugService,
-      EjsService
+      EjsService,
+      NunjucksService
     ]
   }),
   _ts_param3(1, Inject3(PDF_PARAMETERS)),
-  _ts_metadata4("design:type", Function),
-  _ts_metadata4("design:paramtypes", [
+  _ts_metadata5("design:type", Function),
+  _ts_metadata5("design:paramtypes", [
     typeof BrowserService === "undefined" ? Object : BrowserService,
     typeof PuppeteerParameters === "undefined" ? Object : PuppeteerParameters
   ])
 ], PuppeteerModule);
 
 // src/nestjs-pdf.module.ts
-function _ts_decorate8(decorators, target, key, desc) {
+function _ts_decorate9(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;
 }
-__name(_ts_decorate8, "_ts_decorate");
+__name(_ts_decorate9, "_ts_decorate");
 var NestjsPdfModule = class _NestjsPdfModule {
   static {
     __name(this, "NestjsPdfModule");
@@ -3716,7 +3808,7 @@ var NestjsPdfModule = class _NestjsPdfModule {
     };
   }
 };
-NestjsPdfModule = _ts_decorate8([
+NestjsPdfModule = _ts_decorate9([
   Module2({})
 ], NestjsPdfModule);
 
@@ -3732,6 +3824,7 @@ export {
   MjmlService,
   NestjsPdfModule,
   NestjsPdfService,
+  NunjucksService,
   PugService,
   PuppeteerModule,
   PuppeteerService,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shad0wz7/nestjs-pdf",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "A NestJS library for generating PDFs with Puppeteer and Handlebars.",
   "author": "Emmanuel Boisset",
   "license": "MIT",
@@ -21,7 +21,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external pdfjs-dist --external pdf-lib --external @napi-rs/canvas",
+    "build": "tsup",
     "prepublishOnly": "pnpm lint && pnpm test && pnpm build",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
     "lint": "eslint \"{src,test}/**/*.ts\" --fix",
@@ -36,6 +36,7 @@
     "puppeteer",
     "handlebars",
     "hbs",
+    "nunjucks",
     "ejs",
     "mjml",
     "pug",
@@ -48,24 +49,18 @@
     "rxjs": "^7.8.0"
   },
   "dependencies": {
-    "@gboutte/nestjs-hbs": "^0.2.0",
     "@puppeteer/browsers": "^2.13.2",
     "deepmerge-ts": "^7.1.5",
-    "ejs": "^5.0.2",
-    "mjml": "^5.2.1",
     "p-limit": "^7.3.0",
     "pdf-lib": "^1.17.1",
     "pdfjs-dist": "^5.7.284",
-    "pug": "^3.0.3",
     "puppeteer": "^24.43.1"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.5",
     "@eslint/js": "^10.0.1",
     "@nestjs/cli": "^11.0.21",
-    "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
-    "@nestjs/core": "^11.1.19",
     "@nestjs/platform-express": "^11.1.19",
     "@nestjs/schematics": "^11.1.0",
     "@nestjs/testing": "^11.1.19",
@@ -76,6 +71,7 @@
     "@types/mjml": "^5.0.0",
     "@types/mjml-core": "^5.0.0",
     "@types/node": "^25.6.2",
+    "@types/nunjucks": "^3.2.6",
     "@types/pug": "^2.0.10",
     "@types/supertest": "^7.2.0",
     "eslint": "^10.3.0",
@@ -83,7 +79,6 @@
     "eslint-plugin-prettier": "^5.5.5",
     "globals": "^17.6.0",
     "jest": "^30.4.2",
-    "mjml-core": "^5.2.0",
     "prettier": "^3.8.3",
     "reflect-metadata": "^0.2.2",
     "source-map-support": "^0.5.21",
@@ -97,10 +92,15 @@
     "typescript-eslint": "^8.59.3"
   },
   "optionalDependencies": {
-    "@napi-rs/canvas": "^1.0.0"
+    "@gboutte/nestjs-hbs": "^0.2.0",
+    "@napi-rs/canvas": "^1.0.0",
+    "ejs": "^5.0.2",
+    "mjml": "^5.2.1",
+    "nunjucks": "^3.2.4",
+    "pug": "^3.0.3"
   },
   "repository": {
-    "url": "https://github.com/ShadowZ11/nestjs-pdf"
+    "url": "git+https://github.com/ShadowZ11/nestjs-pdf.git"
   },
   "publishConfig": {
     "access": "public",