@shad0wz7/nestjs-pdf 3.1.0 → 4.0.0

package/dist/index.d.cts

@@ -1,10 +1,11 @@
+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 { MJMLParsingOptions } from "mjml-core";
-import { Browser as Browser$1, 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";
+import { LiquidOptions as LiquidOptions$1 } from "liquidjs";
 import { EscapeFunction } from "mustache";
 import { ConfigureOptions } from "nunjucks";
 import { LocalsObject, Options as Options$1 } from "pug";
@@ -17,7 +18,8 @@ export declare enum NestjsPdfErrorCode {
   BROWSER_UNAVAILABLE = "BROWSER_UNAVAILABLE",
   PDF_GENERATION_ERROR = "PDF_GENERATION_ERROR",
   SIGNATURE_DEPENDENCY_ERROR = "SIGNATURE_DEPENDENCY_ERROR",
-  SIGNATURE_PLACEMENT_ERROR = "SIGNATURE_PLACEMENT_ERROR"
+  SIGNATURE_PLACEMENT_ERROR = "SIGNATURE_PLACEMENT_ERROR",
+  WATERMARK_ERROR = "WATERMARK_ERROR"
 }
 export declare abstract class NestjsPdfException extends Error {
   abstract readonly code: NestjsPdfErrorCode;
@@ -39,7 +41,9 @@ export declare class BrowserUnavailableException extends NestjsPdfException {
 //#region src/exceptions/engine-not-available.exception.d.ts
 export declare class EngineNotAvailableException extends NestjsPdfException {
   readonly code = NestjsPdfErrorCode.ENGINE_NOT_AVAILABLE;
-  constructor(engineName: string);
+  constructor(engineName: string, packageName?: string, options?: {
+    cause?: unknown;
+  });
 }
 //#endregion
 //#region src/exceptions/pdf-generation.exception.d.ts
@@ -71,6 +75,11 @@ export declare class TemplateRenderException extends NestjsPdfException {
   });
 }
 //#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.
@@ -83,6 +92,181 @@ export declare class TemplateRenderException extends NestjsPdfException {
  */
 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 node_modules/.pnpm/@types+mjml-core@5.1.0/node_modules/@types/mjml-core/index.d.ts
+/**
+ * Options passed as an object to the mjml2html function
+ *
+ * https://documentation.mjml.io/#inside-node-js
+ */
+interface MJMLParsingOptions {
+  /**
+   * Default fonts imported in the HTML rendered by HTML
+   * ie. { 'Open Sans': 'https://fonts.googleapis.com/css?family=Open+Sans:300,400,500,700' }
+   *
+   * default: @see https://github.com/mjmlio/mjml/blob/master/packages/mjml-core/src/index.js
+   */
+  fonts?: {
+    [key: string]: string;
+  } | undefined;
+  /**
+   * Option to keep comments in the HTML output
+   * default: true
+   */
+  keepComments?: boolean | undefined;
+  /**
+   * Beautify the HTML output using prettier (parser: 'html', printWidth: 240).
+   * Mutually exclusive with minify — if minify is true, beautify is skipped.
+   * Note: the CLI defaults this to true; the programmatic API defaults to false.
+   * default: false
+   */
+  beautify?: boolean | undefined;
+  /**
+   * Minify the HTML output using htmlnano (with cssnano-preset-lite for CSS).
+   * Takes priority over beautify when both are true.
+   * default: false
+   */
+  minify?: boolean | undefined;
+  /**
+   * Options passed to htmlnano when minify is true.
+   * The minifyCss field accepts false, true, 'lite', or a cssnano options object.
+   * All htmlnano v3 options are accepted.
+   */
+  minifyOptions?: MJMLMinifyOptions | undefined;
+  /**
+   * How to validate your MJML
+   *
+   * skip: your document is rendered without going through validation
+   * soft: your document is going through validation and is rendered, even if it has errors
+   * strict: your document is going through validation and is not rendered if it has any error
+   *
+   * default: soft
+   */
+  validationLevel?: "strict" | "soft" | "skip" | undefined;
+  /**
+   * Full path of the specified file to use when resolving paths from mj-include components
+   * default: '.'
+   */
+  filePath?: string | undefined;
+  /**
+   * Directory (or directories) outside the template's own folder from which mj-include
+   * partials may be loaded. Added in mjml 5.1 as part of the include path-traversal hardening;
+   * includes resolving outside these allowed roots are denied.
+   */
+  includePath?: string | string[] | undefined;
+  /**
+   * The path or directory of the .mjmlconfig file
+   * default: process.cwd()
+   */
+  mjmlConfigPath?: string | undefined;
+  /**
+   * Use the config attribute defined in the .mjmlconfig file.
+   * The config passed into mjml2html overrides the .mjmlconfig.
+   * default: false
+   */
+  useMjmlConfigOptions?: boolean | undefined;
+  /**
+   * optional setting when inlining css, see mjml-cli documentation for more info
+   */
+  juicePreserveTags?: {
+    [index: string]: {
+      start: string;
+      end: string;
+    };
+  } | undefined;
+  juiceOptions?: any;
+  /**
+   * undocumented
+   * a function returning html skeleton
+   * default: see mjml-core/src/helpers/skeleton.js
+   */
+  skeleton?: string | (() => string) | undefined;
+  actualPath?: string | undefined;
+  /**
+   * undocumented
+   * ignore mj-include elements
+   * default: false
+   */
+  ignoreIncludes?: any;
+  /**
+   * see mjml-parser-xml
+   */
+  preprocessors?: Array<((xml: string) => string)> | undefined;
+  /**
+   * Add media queries specific to printer when converting mjml into html. When enabling this option,
+   * the html might not be compatible with all email clients anymore.
+   */
+  printerSupport?: boolean | undefined;
+}
+interface MJMLMinifyOptions {
+  collapseWhitespace?: boolean | undefined;
+  /**
+   * CSS minification options passed to cssnano-preset-lite.
+   * Accepts false (disable), true/'lite' (use lite preset), or a cssnano options object.
+   * @see https://cssnano.co/docs/presets
+   */
+  minifyCss?: boolean | "lite" | {
+    preset?: any;
+    plugins?: any[];
+    configFile?: string;
+  } | undefined;
+  /** @deprecated use minifyCss instead */
+  minifyCSS?: boolean | undefined;
+  removeEmptyAttributes?: boolean | undefined;
+  minifyJs?: boolean | undefined;
+  removeComments?: false | "safe" | "all" | undefined;
+}
+//#endregion
 //#region src/puppeteer/browser/browser.service.d.ts
 declare enum BrowserTag {
   LATEST = "latest",
@@ -100,19 +284,19 @@ declare class BrowserService implements OnModuleDestroy {
   shutdownDrainTimeoutMs: number;
   constructor(pdfParams: PuppeteerParameters);
   onModuleDestroy(): Promise<void>;
-  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>;
   install(lock?: boolean): Promise<import("@puppeteer/browsers").InstalledBrowser | null | undefined>;
-  getBrowser(): Browser;
+  getBrowser(): Browser$1;
   setBrowserTag(browserTag: BrowserTag): void;
   getBrowserTag(): BrowserTag;
   getBuildId(): string | undefined;
-  hasBrowserInstalled(browser: Browser, buildId: string): Promise<boolean>;
+  hasBrowserInstalled(browser: Browser$1, buildId: string): Promise<boolean>;
   getExecutablePath(): Promise<string>;
-  getLockedBuildId(browser: Browser): string | null;
+  getLockedBuildId(browser: Browser$1): string | null;
 }
 //#endregion
 //#region src/puppeteer/engines/ejs/ejs.service.d.ts
@@ -120,6 +304,7 @@ export interface EjsOptions extends Omit<Options, 'async'> {
   async?: boolean;
 }
 export declare class EjsService {
+  #private;
   render(template: string, data?: Data, options?: EjsOptions): Promise<string>;
   renderFile(filePath: string, data?: Data, options?: EjsOptions): Promise<string>;
 }
@@ -135,7 +320,6 @@ export interface EtaOptions extends Partial<EtaConfig> {
 }
 export declare class EtaService {
   #private;
-  constructor();
   /**
    * Render an Eta template from a string
    * @param template The template string to render
@@ -190,6 +374,37 @@ export declare class HandlebarsService {
   renderFile(file: string, parameters?: unknown, options?: HandlebarsOptions): string;
 }
 //#endregion
+//#region src/puppeteer/engines/liquid/liquid.service.d.ts
+export type LiquidOptions = LiquidOptions$1;
+export declare class LiquidService {
+  #private;
+  /**
+   * Render a Liquid template from a string
+   * @param template The template string to render
+   * @param data The data object to use for rendering
+   * @param options Optional Liquid engine options
+   * @returns The rendered HTML string
+   */
+  render(template: string, data?: Record<string, unknown>, options?: LiquidOptions): string;
+  /**
+   * Render a Liquid template from a file
+   * @param filePath The path to the template file
+   * @param data The data object to use for rendering
+   * @param options Optional Liquid engine options
+   * @returns The rendered HTML string
+   */
+  renderFile(filePath: string, data?: Record<string, unknown>, options?: LiquidOptions): string;
+  /**
+   * Clear the template cache
+   */
+  clearCache(): void;
+  /**
+   * Get the current cache size
+   * @returns The number of cached templates
+   */
+  getCacheSize(): number;
+}
+//#endregion
 //#region src/puppeteer/engines/mustache/mustache.service.d.ts
 export interface MustacheOptions {
   tags?: [string, string];
@@ -233,7 +448,7 @@ export interface NunjucksOptions extends Partial<ConfigureOptions> {
   lstripBlocks?: boolean;
 }
 export declare class NunjucksService {
-  constructor();
+  #private;
   render(template: string, data?: Record<string, unknown>, options?: NunjucksOptions): string;
   renderFile(filePath: string, data?: Record<string, unknown>, options?: NunjucksOptions): string;
 }
@@ -241,6 +456,7 @@ export declare class NunjucksService {
 //#region src/puppeteer/engines/pug/pug.service.d.ts
 export type PugOptions = Options$1;
 export declare class PugService {
+  #private;
   render(template: string, data?: LocalsObject, options?: PugOptions): string;
   renderFile(filePath: string, data?: LocalsObject, options?: PugOptions): string;
 }
@@ -248,6 +464,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;
@@ -255,10 +479,11 @@ export interface PuppeteerParameters {
   nunjucksOptions?: NunjucksOptions;
   etaOptions?: EtaOptions;
   mustacheOptions?: MustacheOptions;
+  liquidOptions?: LiquidOptions;
   chromiumRevision?: string;
   buildId?: string;
   headless?: boolean | 'shell';
-  browser?: Browser;
+  browser?: Browser$1;
   browserTag?: BrowserTag;
   useLockedBrowser?: boolean;
   browserInstallBaseUrl?: string;
@@ -279,6 +504,7 @@ export declare class NestjsPdfModule {
 //#endregion
 //#region src/puppeteer/engines/mjml/mjml.service.d.ts
 export declare class MjmlService {
+  #private;
   render(template: string, options?: MJMLParsingOptions): Promise<string>;
   renderFile(filePath: string, options?: MJMLParsingOptions): Promise<string>;
 }
@@ -286,7 +512,7 @@ export declare class MjmlService {
 //#region src/puppeteer/puppeteer.service.d.ts
 export declare class PuppeteerService {
   #private;
-  constructor(browserService: BrowserService, options: PuppeteerParameters, hbsService?: HandlebarsService, mjmlService?: MjmlService, pugService?: PugService, ejsService?: EjsService, nunjucksService?: NunjucksService, etaService?: EtaService, mustacheService?: MustacheService);
+  constructor(browserService: BrowserService, options: PuppeteerParameters, hbsService?: HandlebarsService, mjmlService?: MjmlService, pugService?: PugService, ejsService?: EjsService, nunjucksService?: NunjucksService, etaService?: EtaService, mustacheService?: MustacheService, liquidService?: LiquidService);
   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>>;
@@ -302,6 +528,8 @@ export declare class PuppeteerService {
   generatePdfFromEtaFile(file: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
   generatePdfFromMustacheString(template: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
   generatePdfFromMustacheFile(file: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+  generatePdfFromLiquidString(template: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+  generatePdfFromLiquidFile(file: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
 }
 //#endregion
 //#region src/nestjs-pdf.service.d.ts
@@ -425,6 +653,22 @@ export declare class NestjsPdfService {
    * @description This method generates a PDF from a Mustache template located at the specified file path. The file path is passed as a string in the `file` parameter. The data to inject into the template is passed in the `data` object, which is used to render the template before converting it to PDF. PDF generation options can be customized by passing a `PuppeteerParameters` object as the third argument.
    */
   generatePdfFromMustacheFile(file: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+  /**
+   * @param template Liquid template string
+   * @param data Data to inject into the template
+   * @param options PDF generation options (optional)
+   * @returns PDF generated from the provided Liquid template with data applied
+   * @description This method generates a PDF from a Liquid template provided as a string. Liquid is a safe, Shopify-compatible template language with filters, tags, partials and layouts. The data to inject into the template is passed in the `data` object, which is used to render the template before converting it to PDF. PDF generation options can be customized by passing a `PuppeteerParameters` object as the third argument.
+   */
+  generatePdfFromLiquidString(template: string, data?: Record<string, unknown>, options?: PuppeteerParameters): Promise<Uint8Array<ArrayBufferLike>>;
+  /**
+   * @param file Path to the Liquid template file
+   * @param data Data to inject into the template
+   * @param options PDF generation options (optional)
+   * @returns PDF generated from the Liquid template at the provided file path with data applied
+   * @description This method generates a PDF from a Liquid template located at the specified file path. The file path is passed as a string in the `file` parameter. The data to inject into the template is passed in the `data` object, which is used to render the template before converting it to PDF. PDF generation options can be customized by passing a `PuppeteerParameters` object as the third argument.
+   */
+  generatePdfFromLiquidFile(file: 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')
@@ -448,6 +692,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
@@ -463,4 +725,5 @@ export declare class PuppeteerModule implements OnModuleInit {
   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/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/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":["BrowserType","LiquidJsOptions","Options","Browser"],"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","../node_modules/.pnpm/@types+mjml-core@5.1.0/node_modules/@types/mjml-core/index.d.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/liquid/liquid.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"],"ignoreList":[13],"mappings":"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"}