Recetario de Connect
Recetario de Connect
Sección titulada «Recetario de Connect»NextPDF Connect expone el motor de NextPDF a clientes remotos y sistemas de IA mediante el Model Context Protocol, una API REST y un servicio gRPC. El recetario de Connect reúne recetas orientadas a tareas para esa superficie, y esta página es su índice. Registra el slug asignado a cada receta, junto con el nivel y el límite de transporte desde los que debe leerse. Al ser un índice, no afirma nada sobre el comportamiento de ninguna receta. Cada página de receta se redacta en el repositorio nextpdf/server, dentro de docs/public/, es responsable de sus propias afirmaciones y se incorpora a este sitio mediante el agregador con su procedencia original intacta.
Para ver el contrato que sigue cada receta de Connect, leer Convenciones de las recetas. Para obtener una visión de las integraciones de todo el ecosistema, leer el Recetario de integraciones.
Cómo afecta el nivel a lo que se puede ejecutar
Sección titulada «Cómo afecta el nivel a lo que se puede ejecutar»El conjunto de herramientas de un despliegue de Connect se determina al arrancar; no se fija de antemano. El registro de herramientas del servidor registra las herramientas del núcleo de forma incondicional. Después comprueba los proveedores Pro y Enterprise con class_exists(), y registra sus herramientas solo cuando nextpdf/premium está instalado junto al servidor. Así, una receta que depende de una herramienta Pro o Enterprise solo se ejecuta en un despliegue donde esa herramienta se haya resuelto. En una instalación únicamente de código abierto, la herramienta está ausente y la llamada devuelve un error de herramienta desconocida en lugar de degradarse silenciosamente. Cada receta indica su nivel, y este índice agrupa las recetas por nivel para saber de un vistazo qué admite un despliegue determinado.
El número total de herramientas es una propiedad de tiempo de ejecución del despliegue. Ninguna receta ni ninguna fila de este índice afirma un número fijo. La referencia canónica es el propio catálogo de herramientas del servidor, al que enlaza cada receta.
Transporte y modelo de errores
Sección titulada «Transporte y modelo de errores»Invocar cada receta de la misma manera a través de los tres transportes —un tools/call de MCP, el endpoint REST de herramientas o el servicio gRPC— porque comparten un mismo ejecutor de herramientas. Las recetas que acceden a un servicio remoto por HTTP tratan un fallo de transporte y un estado HTTP no satisfactorio como dos casos distintos. Un cliente PSR-18 lanza una excepción de cliente tipada solo cuando no puede enviar la petición en absoluto — PSR-18 §4. En cambio, una respuesta 4xx o 5xx es un valor de retorno normal que el invocador inspecciona, no una excepción — PSR-18 §4.
El mapa de slugs de las recetas
Sección titulada «El mapa de slugs de las recetas»Cada receta reside en /cookbook/connect/<recipe>/. La tabla registra el slug, el nivel desde el que debe leerse la receta y un alcance de una línea. Las páginas de las recetas se redactan en nextpdf/serverdocs/public/ y se agregan aquí. Hasta que una página llegue, su enlace es una referencia anticipada.
| Receta | Nivel | Alcance |
|---|---|---|
hello-world (previsto en upstream) | Core | Primera llamada a Connect: crear, añadir contenido, generar la salida |
multi-page (previsto en upstream) | Core | Documento de varias páginas mediante Connect |
image-embedding (previsto en upstream) | Core | Insertar una imagen mediante Connect |
html-table (previsto en upstream) | Core | Representar una tabla HTML mediante Connect |
font-typography (previsto en upstream) | Core | Fuentes y tipografía mediante Connect |
exception-aware (previsto en upstream) | Core | Llamadas a herramientas con gestión de excepciones |
environment-diagnostics (previsto en upstream) | Core | Herramientas de diagnóstico del entorno |
layout-inspection (previsto en upstream) | Core | Inspeccionar el diseño sin representar |
worker-safe (previsto en upstream) | Core | Uso por lotes seguro para workers |
output-approval (previsto en upstream) | Core | Compuerta de salida con intervención humana |
event-hooks (previsto en upstream) | Core | Hooks de eventos del ciclo de vida |
fill-pdf-form (previsto en upstream) | Pro | Rellenar un formulario PDF mediante Connect |
extract-text-content (previsto en upstream) | Pro | Extraer contenido de texto mediante Connect |
digital-signature (previsto en upstream) | Pro | Firmar un PDF (PAdES B-B y B-T) mediante Connect |
accessibility-check (previsto en upstream) | Pro | Comprobación de accesibilidad PDF/UA |
pii-redaction (previsto en upstream) | Enterprise | Eliminar de la capa de texto los datos personales detectados (destructivo) |
aria-tagged-pdf (previsto en upstream) | Pro | Asignar roles de referencia ARIA a la estructura etiquetada |
figure-caption (previsto en upstream) | Pro | Figure accesible con Caption anidado |
aria-noteref-pattern (previsto en upstream) | Pro | Patrón de referencia y cuerpo de nota al pie |
compliance-check (previsto en upstream) | Enterprise | Ejecutar una comprobación de un estándar con nombre |
forensic-analysis (previsto en upstream) | Enterprise | Análisis forense de un PDF firmado |
ltv-health-check (previsto en upstream) | Enterprise | Comprobación de salud LTV (B-LT/B-LTA, solo Enterprise) |
batch-compliance (previsto en upstream) | Enterprise | Comprobación de estándares por lotes |
ai-ready-certification (previsto en upstream) | Enterprise | Comprobación de preparación para IA (no es una certificación) |
page-artifacts (previsto en upstream) | Enterprise | Marcar los elementos de paginación como artefactos |
conformance-mode (previsto en upstream) | Enterprise | Seleccionar un modo de conformidad (con la intención de cumplir; lo decide un validador) |
cjk-vertical-writing (previsto en upstream) | Enterprise | Métricas de escritura vertical CJK |
opentelemetry (previsto en upstream) | Core | Observar Connect con OpenTelemetry |
tagged-pdf-tutorial (previsto en upstream) | Core | Tutorial de PDF etiquetado (con la intención de cumplir; lo decide veraPDF) |
El slug representa la intención de la receta en kebab-case con una sola barra al final: sin prefijo numérico, sin número de versión, sin extensión de archivo. Una vez publicado, un slug de receta no cambia; si se mueve, lleva una redirección.
Límite de conformidad y certificación
Sección titulada «Límite de conformidad y certificación»Varias recetas abordan estándares (PDF/UA-2, PDF/A-4, PAdES). El recetario de Connect interpreta la compatibilidad con un estándar como compatibilidad, nunca como conformidad ni certificación. El motor produce una salida con la intención de cumplir, y un validador independiente (por ejemplo, veraPDF) determina la conformidad. La receta de preparación para IA es una comprobación de preparación, no una certificación. El material de validación a largo plazo de la receta de LTV es una capacidad exclusiva de Enterprise. Que esté presente en un documento significa que el documento incorpora esa capacidad, no que la firma tenga una validez indefinida garantizada. Cada receta afectada vuelve a exponer estos límites en su totalidad. Este índice solo deja constancia de que existen y señala de dónde se derivan, en lugar de volver a derivarlos aquí.
Véase también
Sección titulada «Véase también»- Convenciones de las recetas — el contrato que sigue cada receta de Connect.
- Recetario de integraciones — la referencia de paquetes e integraciones de todo el ecosistema, del que Connect es el servicio de red.