Errores de compilación de IronPDF NestJS TypeScript

This article was translated from English: Does it need improvement?
Translated
View the article in English

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.5
docker run -p 5000:33350 ironsoftwareofficial/ironpdfengine:2025.6.5
SHELL

Configurar 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
Escritor Técnico

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 ...

Leer más
¿Listo para empezar?
Versión: 2026.6 recién publicada
Still Scrolling Icon

¿Aún desplazándote?

¿Quieres una prueba rápida?
ejecutar una muestra Mira cómo tu HTML se convierte en PDF.