Depurador de Integraciones de Terceros

El Problema

Las integraciones de terceros son cajas negras que se rompen de formas que no puedes controlar. El SDK de pagos lanza errores no documentados, la libreria de analytics choca con tu bundler, el proveedor OAuth cambio su formato de token. No puedes leer el codigo fuente, la documentacion esta desactualizada y el equipo de soporte responde en 48 horas. Estas por tu cuenta.

El Prompt

Eres un depurador de integraciones de terceros. Ayudame a diagnosticar por que esta libreria/API/SDK externa no funciona:

INTEGRACION: [nombre + version, ej. Stripe SDK 14.2, Auth0 SPA SDK 2.1]
TU STACK: [tu framework, runtime, bundler]
QUE FUNCIONABA ANTES: [ultimo estado funcional conocido]
QUE CAMBIO: [que actualizaste, si algo]
ERROR/SINTOMA: [error exacto o comportamiento inesperado]

Diagnostica el problema de integracion:
1. **Escaneo de Changelog**: Que cambio entre tu version funcional anterior y la actual? Lista cada breaking change y deprecation.
2. **Matriz de Compatibilidad**: Esta version del SDK es compatible con tu runtime, framework y bundler?
3. **Diff de Configuracion**: Compara tu configuracion contra la documentacion actual. Marca claves deprecadas u opciones renombradas.
4. **Busqueda de Issues Conocidos**: Basado en el error, identifica el issue conocido mas probable de GitHub Issues o guia de migracion.
5. **Test de Aislamiento**: Proporciona una reproduccion minima que pruebe SOLO la integracion de terceros sin otro codigo.
6. **Workaround + Fix**: Si es un bug conocido de la libreria, proporciona el workaround. Si es configuracion, proporciona la config actualizada.

Ejemplo de Salida

Changelog: Stripe SDK v14.0 → v14.2 cambio verificacion de firma de webhook — ahora requiere raw body
Compatibilidad: SDK v14.2 requiere Node 18+ — tu Lambda corre Node 16
Config diff: `apiVersion` default cambio — afecta el shape de respuesta de PaymentIntent
Issue conocido: GitHub #2847 — verificacion de webhook falla con middleware body-parser de Express
Fix: Cambiar a app.post('/webhook', express.raw({type: 'application/json'}), handler) en vez de express.json() global

Cuando Usar

Usa este skill cuando una libreria o API de terceros deja de funcionar despues de una actualizacion, cuando codigo de integracion que funcionaba se rompe sin cambios en tu codigo, o cuando el error apunta a internos de la libreria.

Tips Pro

• Fija tus dependencias — usa versiones exactas ("stripe": "14.1.0", no "^14.1.0") para integraciones criticas de terceros.
• Lee la guia de migracion antes de actualizar — la mayoria de bugs de integracion vienen de actualizar sin leer el changelog.
• Revisa los GitHub Issues de la libreria — busca con tu mensaje de error exacto. El fix o workaround usualmente esta en los comentarios.
• Usa el modo debug de la libreria — la mayoria de SDKs tienen logging verbose (DEBUG=stripe:*, SENTRY_DEBUG=true).