@shad0wz7/nestjs-pdf 3.0.1 → 3.2.0

package/dist/index.d.cts

@@ -1,13 +1,83 @@
+import { Browser, BrowserContext, PDFOptions } from "puppeteer";
+import { StandardFonts } from "pdf-lib";
 import { DynamicModule, InjectionToken, ModuleMetadata, OnModuleDestroy, OnModuleInit, OptionalFactoryDependency } from "@nestjs/common";
-import { Browser } from "@puppeteer/browsers";
+import { Browser as Browser$1 } from "@puppeteer/browsers";
 import { MJMLParsingOptions } from "mjml-core";
-import { Browser as Browser$1, BrowserContext, PDFOptions } from "puppeteer";
 import { Data, Options } from "ejs";
 import { EtaConfig } from "eta";
 import Handlebars from "handlebars";
 import { EscapeFunction } from "mustache";
 import { ConfigureOptions } from "nunjucks";
 import { LocalsObject, Options as Options$1 } from "pug";
+//#region src/exceptions/nestjs-pdf.exception.d.ts
+export declare enum NestjsPdfErrorCode {
+  ENGINE_NOT_AVAILABLE = "ENGINE_NOT_AVAILABLE",
+  TEMPLATE_CONFIGURATION_ERROR = "TEMPLATE_CONFIGURATION_ERROR",
+  TEMPLATE_RENDER_ERROR = "TEMPLATE_RENDER_ERROR",
+  BROWSER_INSTALLATION_ERROR = "BROWSER_INSTALLATION_ERROR",
+  BROWSER_UNAVAILABLE = "BROWSER_UNAVAILABLE",
+  PDF_GENERATION_ERROR = "PDF_GENERATION_ERROR",
+  SIGNATURE_DEPENDENCY_ERROR = "SIGNATURE_DEPENDENCY_ERROR",
+  SIGNATURE_PLACEMENT_ERROR = "SIGNATURE_PLACEMENT_ERROR",
+  WATERMARK_ERROR = "WATERMARK_ERROR"
+}
+export declare abstract class NestjsPdfException extends Error {
+  abstract readonly code: NestjsPdfErrorCode;
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+//#endregion
+//#region src/exceptions/browser-installation.exception.d.ts
+export declare class BrowserInstallationException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.BROWSER_INSTALLATION_ERROR;
+}
+//#endregion
+//#region src/exceptions/browser-unavailable.exception.d.ts
+export declare class BrowserUnavailableException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.BROWSER_UNAVAILABLE;
+}
+//#endregion
+//#region src/exceptions/engine-not-available.exception.d.ts
+export declare class EngineNotAvailableException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.ENGINE_NOT_AVAILABLE;
+  constructor(engineName: string);
+}
+//#endregion
+//#region src/exceptions/pdf-generation.exception.d.ts
+export declare class PdfGenerationException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.PDF_GENERATION_ERROR;
+}
+//#endregion
+//#region src/exceptions/signature-dependency.exception.d.ts
+export declare class SignatureDependencyException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.SIGNATURE_DEPENDENCY_ERROR;
+}
+//#endregion
+//#region src/exceptions/signature-placement.exception.d.ts
+export declare class SignaturePlacementException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.SIGNATURE_PLACEMENT_ERROR;
+}
+//#endregion
+//#region src/exceptions/template-configuration.exception.d.ts
+export declare class TemplateConfigurationException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.TEMPLATE_CONFIGURATION_ERROR;
+}
+//#endregion
+//#region src/exceptions/template-render.exception.d.ts
+export declare class TemplateRenderException extends NestjsPdfException {
+  readonly engine: string;
+  readonly code = NestjsPdfErrorCode.TEMPLATE_RENDER_ERROR;
+  constructor(engine: string, message: string, options?: {
+    cause?: unknown;
+  });
+}
+//#endregion
+//#region src/exceptions/watermark.exception.d.ts
+export declare class WatermarkException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.WATERMARK_ERROR;
+}
+//#endregion
 //#region src/helpers/getRelativePath.helper.d.ts
 /**
  * Get the relative path to a value from the module directory.
@@ -20,6 +90,57 @@ import { LocalsObject, Options as Options$1 } from "pug";
  */
 export declare function getRelativePathToValue(moduleDir: string, relativeToModule: string): string;
 //#endregion
+//#region src/helpers/request-guard.helper.d.ts
+/**
+ * Filters what the rendered HTML may load (SSRF protection). Disabled unless set:
+ * pass `{}` for the defaults (private networks and `file:` blocked).
+ */
+interface PdfSecurityOptions {
+  /**
+   * Refuse http(s) requests that resolve to a loopback, private, link-local
+   * (cloud metadata included) or otherwise non-public address. Default: true
+   */
+  blockPrivateNetworks?: boolean;
+  /**
+   * When set, http(s) requests are only allowed to these hosts (`example.com`
+   * or `*.example.com`). Listed hosts are trusted, even on a private address.
+   */
+  allowedHosts?: Array<string>;
+  /**
+   * `file:` requests are refused unless the file is inside one of these
+   * directories (symbolic links are resolved).
+   */
+  allowedFileRoots?: Array<string>;
+  /** Set to false to disable JavaScript in the rendered page. Default: true */
+  javascriptEnabled?: boolean;
+}
+//#endregion
+//#region src/helpers/watermark.helper.d.ts
+interface WatermarkOptions {
+  /** Text to stamp. At least one of `text` or `image` is required. */
+  text?: string;
+  /** PNG or JPEG bytes to stamp. At least one of `text` or `image` is required. */
+  image?: Uint8Array | Buffer;
+  /** Opacity between 0 (invisible) and 1 (opaque). Default: 0.15 */
+  opacity?: number;
+  /** Counter-clockwise rotation in degrees. Default: 45 */
+  rotation?: number;
+  /** Text font size in points. Default: 60 */
+  fontSize?: number;
+  /** One of the PDF standard fonts (WinAnsi characters only). Default: 'HelveticaBold' */
+  font?: keyof typeof StandardFonts;
+  /** Text color as `#rgb` or `#rrggbb`. Default: '#808080' */
+  color?: string;
+  /** Rendered image width in points (aspect ratio preserved). Default: 50% of the page width */
+  imageWidth?: number;
+  /** `center` stamps once per page, `tile` repeats the mark across the page. Default: 'center' */
+  position?: 'center' | 'tile';
+  /** Gap in points between two marks when `position` is `tile`. Default: 100 */
+  tileSpacing?: number;
+  /** 1-based page numbers to watermark. Default: all pages */
+  pages?: Array<number>;
+}
+//#endregion
 //#region src/puppeteer/browser/browser.service.d.ts
 declare enum BrowserTag {
   LATEST = "latest",
@@ -30,44 +151,26 @@ declare enum BrowserTag {
 }
 type Headless = boolean | 'shell' | undefined;
 declare class BrowserService implements OnModuleDestroy {
-  private readonly cacheDir;
-  private readonly options?;
-  private _browserInstance;
-  private browser;
+  #private;
   activeJobs: number;
   totalJobs: number;
-  private recycleRequested;
-  private recycling;
-  private shuttingDown;
   /** Max time to wait for in-flight PDF jobs to finish before closing the browser on shutdown. */
   shutdownDrainTimeoutMs: number;
-  private browserTag;
-  private useLockedBrowser;
-  private buildId;
   constructor(pdfParams: PuppeteerParameters);
   onModuleDestroy(): Promise<void>;
-  /** Wait until no PDF job is in flight, or until the timeout elapses. */
-  private waitForIdle;
-  getBrowserInstance(args: Array<string>, headless: boolean | 'shell' | undefined, executablePathBin: string | undefined): Promise<Browser$1>;
+  getBrowserInstance(args: Array<string>, headless: boolean | 'shell' | undefined, executablePathBin: string | undefined): Promise<Browser>;
   createContext(args: Array<string>, headless: Headless, executablePath?: string): Promise<BrowserContext>;
   markJobStarted(): void;
   markJobFinished(): Promise<void>;
   recycleBrowserIfNeeded(): Promise<void>;
-  private cleanupCacheBestEffort;
   install(lock?: boolean): Promise<import("@puppeteer/browsers").InstalledBrowser | null | undefined>;
-  private loadBrowser;
-  getBrowser(): Browser;
-  private loadBrowserTag;
-  private loadBuildId;
+  getBrowser(): Browser$1;
   setBrowserTag(browserTag: BrowserTag): void;
   getBrowserTag(): BrowserTag;
   getBuildId(): string | undefined;
-  private loadUseLockedBrowser;
-  hasBrowserInstalled(browser: Browser, buildId: string): Promise<boolean>;
+  hasBrowserInstalled(browser: Browser$1, buildId: string): Promise<boolean>;
   getExecutablePath(): Promise<string>;
-  private launchBrowser;
-  private writeLockFile;
-  getLockedBuildId(browser: Browser): string | null;
+  getLockedBuildId(browser: Browser$1): string | null;
 }
 //#endregion
 //#region src/puppeteer/engines/ejs/ejs.service.d.ts
@@ -89,9 +192,7 @@ export interface EtaOptions extends Partial<EtaConfig> {
   plugins?: Array<any>;
 }
 export declare class EtaService {
-  private readonly eta;
-  private readonly templateCache;
-  private readonly maxCacheSize;
+  #private;
   constructor();
   /**
    * Render an Eta template from a string
@@ -142,17 +243,9 @@ export interface HandlebarsOptions {
   helpers?: Array<HandlebarsHelper>;
 }
 export declare class HandlebarsService {
-  private cachedOptions?;
-  private cachedEnv?;
+  #private;
   render(template: string, parameters?: unknown, options?: HandlebarsOptions): string;
   renderFile(file: string, parameters?: unknown, options?: HandlebarsOptions): string;
-  /**
-   * Build an isolated Handlebars environment with the given helpers/partials so
-   * 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`).
-   */
-  private getEnv;
-  private registerPartials;
 }
 //#endregion
 //#region src/puppeteer/engines/mustache/mustache.service.d.ts
@@ -161,8 +254,7 @@ export interface MustacheOptions {
   escape?: EscapeFunction;
 }
 export declare class MustacheService {
-  private readonly templateCache;
-  private readonly maxCacheSize;
+  #private;
   /**
    * Render a Mustache template from a string
    * @param template The template string to render
@@ -214,6 +306,14 @@ export declare class PugService {
 //#region src/puppeteer/puppeteer-parameters.interface.d.ts
 export interface PuppeteerParameters {
   pdfOptions?: PDFOptions;
+  /**
+   * Cancels the generation when aborted, including while it waits for a free slot.
+   * The promise rejects with `signal.reason`; use `AbortSignal.timeout(ms)` for a timeout.
+   */
+  signal?: AbortSignal;
+  /** Watermark stamped on the generated PDF. */
+  watermark?: WatermarkOptions;
+  security?: PdfSecurityOptions;
   hbsOptions?: HandlebarsOptions;
   mjmlOptions?: MJMLParsingOptions;
   pugOptions?: PugOptions;
@@ -224,7 +324,7 @@ export interface PuppeteerParameters {
   chromiumRevision?: string;
   buildId?: string;
   headless?: boolean | 'shell';
-  browser?: Browser;
+  browser?: Browser$1;
   browserTag?: BrowserTag;
   useLockedBrowser?: boolean;
   browserInstallBaseUrl?: string;
@@ -251,17 +351,8 @@ export declare class MjmlService {
 //#endregion
 //#region src/puppeteer/puppeteer.service.d.ts
 export declare class PuppeteerService {
-  private readonly browserService;
-  private readonly options;
-  private readonly hbsService?;
-  private readonly mjmlService?;
-  private readonly pugService?;
-  private readonly ejsService?;
-  private readonly nunjucksService?;
-  private readonly etaService?;
-  private readonly mustacheService?;
-  constructor(browserService: BrowserService, options: PuppeteerParameters, hbsService?: HandlebarsService | undefined, mjmlService?: MjmlService | undefined, pugService?: PugService | undefined, ejsService?: EjsService | undefined, nunjucksService?: NunjucksService | undefined, etaService?: EtaService | undefined, mustacheService?: MustacheService | undefined);
-  private readonly limit;
+  #private;
+  constructor(browserService: BrowserService, options: PuppeteerParameters, hbsService?: HandlebarsService, mjmlService?: MjmlService, pugService?: PugService, ejsService?: EjsService, nunjucksService?: NunjucksService, etaService?: EtaService, mustacheService?: MustacheService);
   generatePdfFromHtml(html: string, options?: PuppeteerParameters): Promise<Uint8Array>;
   generatePdfFromTemplateHbsString(template: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
   generatePdfFromTemplateHbsFile(file: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
@@ -281,7 +372,7 @@ export declare class PuppeteerService {
 //#endregion
 //#region src/nestjs-pdf.service.d.ts
 export declare class NestjsPdfService {
-  private readonly puppeteerService;
+  #private;
   constructor(puppeteerService: PuppeteerService);
   /**
    * @param html HTML string to convert to PDF
@@ -423,6 +514,24 @@ export declare class NestjsPdfService {
    * Note: Ensure that the input PDF contains the anchor defined by `anchorText` for the signature field to be positioned correctly. Otherwise, it will be added at a default position.
    */
   addSignatureFieldSignatureDebtorRaw(pdf: Uint8Array | Buffer, fieldName?: string, anchorText?: string): Promise<Uint8Array<ArrayBufferLike>>;
+  /**
+   * @param pdf The PDF bytes to modify
+   * @param options Watermark options (`text` or `image` is required)
+   * @returns Modified PDF with the watermark stamped on the selected pages
+   * @description Stamps a text or image watermark on an existing PDF. By default the mark is centered, rotated by 45° at 15% opacity on every page. Use `position: 'tile'` to repeat it across the page and `pages` to target specific pages (1-based). To watermark a PDF while generating it, pass the same options as `watermark` in the `PuppeteerParameters`.
+   *
+   * ```typescript
+   * const watermarked = await pdfService.addWatermark(pdf, {
+   *   text: 'CONFIDENTIAL',
+   *   color: '#ff0000',
+   *   opacity: 0.2,
+   * });
+   * ```
+   *
+   * Text uses the PDF standard fonts, which only support WinAnsi characters; use an `image` for anything else.
+   * @throws WatermarkException when the options are invalid or the PDF cannot be processed
+   */
+  addWatermark(pdf: Uint8Array | Buffer, options: WatermarkOptions): Promise<Uint8Array<ArrayBufferLike>>;
 }
 //#endregion
 //#region src/puppeteer/puppeteer.module.d.ts
@@ -431,12 +540,12 @@ export interface PuppeteerModuleAsyncOptions extends Pick<ModuleMetadata, 'impor
   useFactory: (...args: Array<any>) => Promise<PuppeteerParameters> | PuppeteerParameters;
 }
 export declare class PuppeteerModule implements OnModuleInit {
-  private readonly browserService;
-  private readonly pdfParams;
+  #private;
   constructor(browserService: BrowserService, pdfParams: PuppeteerParameters);
   onModuleInit(): Promise<void>;
   static forRoot(pdfParameters: PuppeteerParameters): DynamicModule;
   static forRootAsync(options: PuppeteerModuleAsyncOptions): DynamicModule;
 }
 //#endregion
+export type { PdfSecurityOptions, WatermarkOptions };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/helpers/getRelativePath.helper.ts","../src/puppeteer/browser/browser.service.ts","../src/puppeteer/engines/ejs/ejs.service.ts","../src/puppeteer/engines/eta/eta.service.ts","../src/puppeteer/engines/handlebars/handlebars.service.ts","../src/puppeteer/engines/mustache/mustache.service.ts","../src/puppeteer/engines/nunjucks/nunjucks.service.ts","../src/puppeteer/engines/pug/pug.service.ts","../src/puppeteer/puppeteer-parameters.interface.ts","../src/nestjs-pdf.module.ts","../src/puppeteer/engines/mjml/mjml.service.ts","../src/puppeteer/puppeteer.service.ts","../src/nestjs-pdf.service.ts","../src/puppeteer/puppeteer.module.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/exceptions/nestjs-pdf.exception.ts","../src/exceptions/browser-installation.exception.ts","../src/exceptions/browser-unavailable.exception.ts","../src/exceptions/engine-not-available.exception.ts","../src/exceptions/pdf-generation.exception.ts","../src/exceptions/signature-dependency.exception.ts","../src/exceptions/signature-placement.exception.ts","../src/exceptions/template-configuration.exception.ts","../src/exceptions/template-render.exception.ts","../src/exceptions/watermark.exception.ts","../src/helpers/getRelativePath.helper.ts","../src/helpers/request-guard.helper.ts","../src/helpers/watermark.helper.ts","../src/puppeteer/browser/browser.service.ts","../src/puppeteer/engines/ejs/ejs.service.ts","../src/puppeteer/engines/eta/eta.service.ts","../src/puppeteer/engines/handlebars/handlebars.service.ts","../src/puppeteer/engines/mustache/mustache.service.ts","../src/puppeteer/engines/nunjucks/nunjucks.service.ts","../src/puppeteer/engines/pug/pug.service.ts","../src/puppeteer/puppeteer-parameters.interface.ts","../src/nestjs-pdf.module.ts","../src/puppeteer/engines/mjml/mjml.service.ts","../src/puppeteer/puppeteer.service.ts","../src/nestjs-pdf.service.ts","../src/puppeteer/puppeteer.module.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,6 +1,7 @@
 import { DynamicModule, InjectionToken, ModuleMetadata, OnModuleDestroy, OnModuleInit, OptionalFactoryDependency } from "@nestjs/common";
-import { Browser } from "@puppeteer/browsers";
-import { Browser as Browser$1, BrowserContext, PDFOptions } from "puppeteer";
+import { StandardFonts } from "pdf-lib";
+import { Browser, BrowserContext, PDFOptions } from "puppeteer";
+import { Browser as Browser$1 } from "@puppeteer/browsers";
 import { Data, Options } from "ejs";
 import { EtaConfig } from "eta";
 import Handlebars from "handlebars";
@@ -8,6 +9,75 @@ import { EscapeFunction } from "mustache";
 import { ConfigureOptions } from "nunjucks";
 import { LocalsObject, Options as Options$1 } from "pug";
 import { MJMLParsingOptions } from "mjml-core";
+//#region src/exceptions/nestjs-pdf.exception.d.ts
+export declare enum NestjsPdfErrorCode {
+  ENGINE_NOT_AVAILABLE = "ENGINE_NOT_AVAILABLE",
+  TEMPLATE_CONFIGURATION_ERROR = "TEMPLATE_CONFIGURATION_ERROR",
+  TEMPLATE_RENDER_ERROR = "TEMPLATE_RENDER_ERROR",
+  BROWSER_INSTALLATION_ERROR = "BROWSER_INSTALLATION_ERROR",
+  BROWSER_UNAVAILABLE = "BROWSER_UNAVAILABLE",
+  PDF_GENERATION_ERROR = "PDF_GENERATION_ERROR",
+  SIGNATURE_DEPENDENCY_ERROR = "SIGNATURE_DEPENDENCY_ERROR",
+  SIGNATURE_PLACEMENT_ERROR = "SIGNATURE_PLACEMENT_ERROR",
+  WATERMARK_ERROR = "WATERMARK_ERROR"
+}
+export declare abstract class NestjsPdfException extends Error {
+  abstract readonly code: NestjsPdfErrorCode;
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+//#endregion
+//#region src/exceptions/browser-installation.exception.d.ts
+export declare class BrowserInstallationException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.BROWSER_INSTALLATION_ERROR;
+}
+//#endregion
+//#region src/exceptions/browser-unavailable.exception.d.ts
+export declare class BrowserUnavailableException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.BROWSER_UNAVAILABLE;
+}
+//#endregion
+//#region src/exceptions/engine-not-available.exception.d.ts
+export declare class EngineNotAvailableException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.ENGINE_NOT_AVAILABLE;
+  constructor(engineName: string);
+}
+//#endregion
+//#region src/exceptions/pdf-generation.exception.d.ts
+export declare class PdfGenerationException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.PDF_GENERATION_ERROR;
+}
+//#endregion
+//#region src/exceptions/signature-dependency.exception.d.ts
+export declare class SignatureDependencyException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.SIGNATURE_DEPENDENCY_ERROR;
+}
+//#endregion
+//#region src/exceptions/signature-placement.exception.d.ts
+export declare class SignaturePlacementException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.SIGNATURE_PLACEMENT_ERROR;
+}
+//#endregion
+//#region src/exceptions/template-configuration.exception.d.ts
+export declare class TemplateConfigurationException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.TEMPLATE_CONFIGURATION_ERROR;
+}
+//#endregion
+//#region src/exceptions/template-render.exception.d.ts
+export declare class TemplateRenderException extends NestjsPdfException {
+  readonly engine: string;
+  readonly code = NestjsPdfErrorCode.TEMPLATE_RENDER_ERROR;
+  constructor(engine: string, message: string, options?: {
+    cause?: unknown;
+  });
+}
+//#endregion
+//#region src/exceptions/watermark.exception.d.ts
+export declare class WatermarkException extends NestjsPdfException {
+  readonly code = NestjsPdfErrorCode.WATERMARK_ERROR;
+}
+//#endregion
 //#region src/helpers/getRelativePath.helper.d.ts
 /**
  * Get the relative path to a value from the module directory.
@@ -20,6 +90,57 @@ import { MJMLParsingOptions } from "mjml-core";
  */
 export declare function getRelativePathToValue(moduleDir: string, relativeToModule: string): string;
 //#endregion
+//#region src/helpers/request-guard.helper.d.ts
+/**
+ * Filters what the rendered HTML may load (SSRF protection). Disabled unless set:
+ * pass `{}` for the defaults (private networks and `file:` blocked).
+ */
+interface PdfSecurityOptions {
+  /**
+   * Refuse http(s) requests that resolve to a loopback, private, link-local
+   * (cloud metadata included) or otherwise non-public address. Default: true
+   */
+  blockPrivateNetworks?: boolean;
+  /**
+   * When set, http(s) requests are only allowed to these hosts (`example.com`
+   * or `*.example.com`). Listed hosts are trusted, even on a private address.
+   */
+  allowedHosts?: Array<string>;
+  /**
+   * `file:` requests are refused unless the file is inside one of these
+   * directories (symbolic links are resolved).
+   */
+  allowedFileRoots?: Array<string>;
+  /** Set to false to disable JavaScript in the rendered page. Default: true */
+  javascriptEnabled?: boolean;
+}
+//#endregion
+//#region src/helpers/watermark.helper.d.ts
+interface WatermarkOptions {
+  /** Text to stamp. At least one of `text` or `image` is required. */
+  text?: string;
+  /** PNG or JPEG bytes to stamp. At least one of `text` or `image` is required. */
+  image?: Uint8Array | Buffer;
+  /** Opacity between 0 (invisible) and 1 (opaque). Default: 0.15 */
+  opacity?: number;
+  /** Counter-clockwise rotation in degrees. Default: 45 */
+  rotation?: number;
+  /** Text font size in points. Default: 60 */
+  fontSize?: number;
+  /** One of the PDF standard fonts (WinAnsi characters only). Default: 'HelveticaBold' */
+  font?: keyof typeof StandardFonts;
+  /** Text color as `#rgb` or `#rrggbb`. Default: '#808080' */
+  color?: string;
+  /** Rendered image width in points (aspect ratio preserved). Default: 50% of the page width */
+  imageWidth?: number;
+  /** `center` stamps once per page, `tile` repeats the mark across the page. Default: 'center' */
+  position?: 'center' | 'tile';
+  /** Gap in points between two marks when `position` is `tile`. Default: 100 */
+  tileSpacing?: number;
+  /** 1-based page numbers to watermark. Default: all pages */
+  pages?: Array<number>;
+}
+//#endregion
 //#region src/puppeteer/browser/browser.service.d.ts
 declare enum BrowserTag {
   LATEST = "latest",
@@ -30,44 +151,26 @@ declare enum BrowserTag {
 }
 type Headless = boolean | 'shell' | undefined;
 declare class BrowserService implements OnModuleDestroy {
-  private readonly cacheDir;
-  private readonly options?;
-  private _browserInstance;
-  private browser;
+  #private;
   activeJobs: number;
   totalJobs: number;
-  private recycleRequested;
-  private recycling;
-  private shuttingDown;
   /** Max time to wait for in-flight PDF jobs to finish before closing the browser on shutdown. */
   shutdownDrainTimeoutMs: number;
-  private browserTag;
-  private useLockedBrowser;
-  private buildId;
   constructor(pdfParams: PuppeteerParameters);
   onModuleDestroy(): Promise<void>;
-  /** Wait until no PDF job is in flight, or until the timeout elapses. */
-  private waitForIdle;
-  getBrowserInstance(args: Array<string>, headless: boolean | 'shell' | undefined, executablePathBin: string | undefined): Promise<Browser$1>;
+  getBrowserInstance(args: Array<string>, headless: boolean | 'shell' | undefined, executablePathBin: string | undefined): Promise<Browser>;
   createContext(args: Array<string>, headless: Headless, executablePath?: string): Promise<BrowserContext>;
   markJobStarted(): void;
   markJobFinished(): Promise<void>;
   recycleBrowserIfNeeded(): Promise<void>;
-  private cleanupCacheBestEffort;
   install(lock?: boolean): Promise<import("@puppeteer/browsers").InstalledBrowser | null | undefined>;
-  private loadBrowser;
-  getBrowser(): Browser;
-  private loadBrowserTag;
-  private loadBuildId;
+  getBrowser(): Browser$1;
   setBrowserTag(browserTag: BrowserTag): void;
   getBrowserTag(): BrowserTag;
   getBuildId(): string | undefined;
-  private loadUseLockedBrowser;
-  hasBrowserInstalled(browser: Browser, buildId: string): Promise<boolean>;
+  hasBrowserInstalled(browser: Browser$1, buildId: string): Promise<boolean>;
   getExecutablePath(): Promise<string>;
-  private launchBrowser;
-  private writeLockFile;
-  getLockedBuildId(browser: Browser): string | null;
+  getLockedBuildId(browser: Browser$1): string | null;
 }
 //#endregion
 //#region src/puppeteer/engines/ejs/ejs.service.d.ts
@@ -89,9 +192,7 @@ export interface EtaOptions extends Partial<EtaConfig> {
   plugins?: Array<any>;
 }
 export declare class EtaService {
-  private readonly eta;
-  private readonly templateCache;
-  private readonly maxCacheSize;
+  #private;
   constructor();
   /**
    * Render an Eta template from a string
@@ -142,17 +243,9 @@ export interface HandlebarsOptions {
   helpers?: Array<HandlebarsHelper>;
 }
 export declare class HandlebarsService {
-  private cachedOptions?;
-  private cachedEnv?;
+  #private;
   render(template: string, parameters?: unknown, options?: HandlebarsOptions): string;
   renderFile(file: string, parameters?: unknown, options?: HandlebarsOptions): string;
-  /**
-   * Build an isolated Handlebars environment with the given helpers/partials so
-   * 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`).
-   */
-  private getEnv;
-  private registerPartials;
 }
 //#endregion
 //#region src/puppeteer/engines/mustache/mustache.service.d.ts
@@ -161,8 +254,7 @@ export interface MustacheOptions {
   escape?: EscapeFunction;
 }
 export declare class MustacheService {
-  private readonly templateCache;
-  private readonly maxCacheSize;
+  #private;
   /**
    * Render a Mustache template from a string
    * @param template The template string to render
@@ -214,6 +306,14 @@ export declare class PugService {
 //#region src/puppeteer/puppeteer-parameters.interface.d.ts
 export interface PuppeteerParameters {
   pdfOptions?: PDFOptions;
+  /**
+   * Cancels the generation when aborted, including while it waits for a free slot.
+   * The promise rejects with `signal.reason`; use `AbortSignal.timeout(ms)` for a timeout.
+   */
+  signal?: AbortSignal;
+  /** Watermark stamped on the generated PDF. */
+  watermark?: WatermarkOptions;
+  security?: PdfSecurityOptions;
   hbsOptions?: HandlebarsOptions;
   mjmlOptions?: MJMLParsingOptions;
   pugOptions?: PugOptions;
@@ -224,7 +324,7 @@ export interface PuppeteerParameters {
   chromiumRevision?: string;
   buildId?: string;
   headless?: boolean | 'shell';
-  browser?: Browser;
+  browser?: Browser$1;
   browserTag?: BrowserTag;
   useLockedBrowser?: boolean;
   browserInstallBaseUrl?: string;
@@ -251,17 +351,8 @@ export declare class MjmlService {
 //#endregion
 //#region src/puppeteer/puppeteer.service.d.ts
 export declare class PuppeteerService {
-  private readonly browserService;
-  private readonly options;
-  private readonly hbsService?;
-  private readonly mjmlService?;
-  private readonly pugService?;
-  private readonly ejsService?;
-  private readonly nunjucksService?;
-  private readonly etaService?;
-  private readonly mustacheService?;
-  constructor(browserService: BrowserService, options: PuppeteerParameters, hbsService?: HandlebarsService | undefined, mjmlService?: MjmlService | undefined, pugService?: PugService | undefined, ejsService?: EjsService | undefined, nunjucksService?: NunjucksService | undefined, etaService?: EtaService | undefined, mustacheService?: MustacheService | undefined);
-  private readonly limit;
+  #private;
+  constructor(browserService: BrowserService, options: PuppeteerParameters, hbsService?: HandlebarsService, mjmlService?: MjmlService, pugService?: PugService, ejsService?: EjsService, nunjucksService?: NunjucksService, etaService?: EtaService, mustacheService?: MustacheService);
   generatePdfFromHtml(html: string, options?: PuppeteerParameters): Promise<Uint8Array>;
   generatePdfFromTemplateHbsString(template: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
   generatePdfFromTemplateHbsFile(file: string, parameters?: any, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
@@ -281,7 +372,7 @@ export declare class PuppeteerService {
 //#endregion
 //#region src/nestjs-pdf.service.d.ts
 export declare class NestjsPdfService {
-  private readonly puppeteerService;
+  #private;
   constructor(puppeteerService: PuppeteerService);
   /**
    * @param html HTML string to convert to PDF
@@ -423,6 +514,24 @@ export declare class NestjsPdfService {
    * Note: Ensure that the input PDF contains the anchor defined by `anchorText` for the signature field to be positioned correctly. Otherwise, it will be added at a default position.
    */
   addSignatureFieldSignatureDebtorRaw(pdf: Uint8Array | Buffer, fieldName?: string, anchorText?: string): Promise<Uint8Array<ArrayBufferLike>>;
+  /**
+   * @param pdf The PDF bytes to modify
+   * @param options Watermark options (`text` or `image` is required)
+   * @returns Modified PDF with the watermark stamped on the selected pages
+   * @description Stamps a text or image watermark on an existing PDF. By default the mark is centered, rotated by 45° at 15% opacity on every page. Use `position: 'tile'` to repeat it across the page and `pages` to target specific pages (1-based). To watermark a PDF while generating it, pass the same options as `watermark` in the `PuppeteerParameters`.
+   *
+   * ```typescript
+   * const watermarked = await pdfService.addWatermark(pdf, {
+   *   text: 'CONFIDENTIAL',
+   *   color: '#ff0000',
+   *   opacity: 0.2,
+   * });
+   * ```
+   *
+   * Text uses the PDF standard fonts, which only support WinAnsi characters; use an `image` for anything else.
+   * @throws WatermarkException when the options are invalid or the PDF cannot be processed
+   */
+  addWatermark(pdf: Uint8Array | Buffer, options: WatermarkOptions): Promise<Uint8Array<ArrayBufferLike>>;
 }
 //#endregion
 //#region src/puppeteer/puppeteer.module.d.ts
@@ -431,12 +540,12 @@ export interface PuppeteerModuleAsyncOptions extends Pick<ModuleMetadata, 'impor
   useFactory: (...args: Array<any>) => Promise<PuppeteerParameters> | PuppeteerParameters;
 }
 export declare class PuppeteerModule implements OnModuleInit {
-  private readonly browserService;
-  private readonly pdfParams;
+  #private;
   constructor(browserService: BrowserService, pdfParams: PuppeteerParameters);
   onModuleInit(): Promise<void>;
   static forRoot(pdfParameters: PuppeteerParameters): DynamicModule;
   static forRootAsync(options: PuppeteerModuleAsyncOptions): DynamicModule;
 }
 //#endregion
+export type { PdfSecurityOptions, WatermarkOptions };
 //# sourceMappingURL=index.d.mts.map