Errores de compilación de IronPDF NestJS TypeScript
Agregar el SDK de IronPDF Node.js a un proyecto de NestJS hace que TypeScript falle en tiempo de compilación:
Type '{ maxHeight?: number; htmlFragment?: string; ... }' is not assignable to type 'HtmlAffix'.Las declaraciones de esquema Zod dentro del SDK de IronPDF (affixSchema.ts, imageSchema.ts, pageSchema.ts) definen tipos que no coinciden con las formas de objetos esperadas en las compilaciones de NestJS TypeScript. NestJS impone una resolución de módulo más estricta que un proyecto de Node.js simple, lo que hace visibles estos desajustes internos en tiempo de compilación.
Solución
Ejecuta IronPdfEngine como un contenedor de Docker y configura el SDK para conectarse a él a través de HTTP. Esto elimina los tipos Zod del SDK de IronPDF de la resolución de módulos de NestJS, deteniendo los errores de compilación.
Iniciar el contenedor de IronPdfEngine:
docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5Configurar IronPDF para usar el contenedor:
import { IronPdfGlobalConfig } from "@ironsoftware/ironpdf";
IronPdfGlobalConfig.getConfig().ironPdfEngineDockerAddress = "http://localhost:5000";Utilizar IronPDF normalmente desde un servicio de NestJS:
import { PdfDocument } from "@ironsoftware/ironpdf";
const pdf = await PdfDocument.fromHtml("<h1>Hello PDF</h1>");
await pdf.saveAs("output.pdf");Con el motor ejecutándose en Docker, la aplicación NestJS llama a IronPdfEngine a través de HTTP. Las declaraciones de tipo Zod internas del SDK ya no participan en la compilación de TypeScript.
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
