Referencia de APIs y límites
Resumen operativo de los contratos verificados. Los límites no representan un SLA ni una capacidad comercial.
En esta página
SDK frontend 0.4.0
| API | Contrato |
|---|---|
| installBugSDK(config) | Handle activo/inactivo; importar durante SSR es seguro. No introduce secretos de servidor. |
| enabled / reason / version | Estado de instalación, no prueba de recepción remota. |
| captureException(error) | Ocurrencia técnica de navegador sin texto/stack arbitrario. |
| logger.debug/info/warn/error/fatal | Código estático y atributos aprobados por structuredLogs. |
| startTrace(code, attributes?, parent?) | Operación técnica con logger, fetch y end; plantilla/origen/propagación revisados. |
| recordNavigation() | Conectar navegación de plantilla permitida del router. |
| flush() | Un intento: empty/sent/failed/closed; no drenaje ilimitado. |
| snapshot / diagnostics | Contadores locales; no salud ni cobertura remota. |
| applyCaptureConfig(input) | Configuración versionada reduce-only por canal confiable del host. |
| stop() | Detiene, descarta cola y restaura sólo hooks todavía propios. |
Cola 100 eventos/ 128.000 bytes; lote 48.000 bytes; edad 60 s por defecto y 1 s–5 min permitidos. La política enriquecida requiere aprobación y scripts JS públicos mapeados: hasta 8 frames sourceId/línea/columna, sin leer stacks accessors o rejection reason. Una instalación básica no habilita diagnóstico enriquecido por inferencia.
SDK backend 0.2.0
| API | Contrato |
|---|---|
| createNodeSDK / installNodeSDK | Constructor estricto / entrada fail-open con handle inactivo. |
| run / bindRequest | Contexto técnico por plantilla; conserva el resultado y errores del host. |
| operation | Span técnico hijo con duración/outcome acotados, no ejecución de un job remoto. |
| logger / captureException / requestSummary | Sólo eventos permitidos y metadatos seguros. |
| context / traceparent() | Contexto/propagación técnica, sin autoridad para leer otros recursos. |
| flush() / shutdown(ms) | Intento acotado / drenaje hasta fallo o deadline y descarte. |
| instrumentFastify | Hooks una vez antes de registrar rutas; no Express/global OTel. |
Cola por defecto 100 eventos/256 KB, batch 20/64 KB; techos 1.000 eventos/4 MB y 100 eventos/256 KB por batch. Memoria volátil, edad 60 s (máximo 5 min), timeout 1.500 ms y 5 intentos por defecto. No hay spool ni captura global de stdout/console.
Lecturas de evidencia
| Contrato | Límite |
|---|---|
| GET evidence/logs, js-errors, js-error-groups | Dentro de /v1/projects/:projectId y grants de org/proyecto/entorno. |
| GET evidence/events/:eventId | Detalle bajo demanda y entorno seleccionado autorizado. |
| GET evidence/relations | Requiere eventId, anchorEventId o submissionId; sin escaneo abierto. |
| from / to | UTC obligatorios; [from,to) por receivedAt de DB, máximo 31 días. |
| limit / cursor | 1–100, default 50; cursor firmado ligado a scope/filtros/stream/página, expiración 1 h. |
| Consistencia | No snapshot entre peticiones; no OFFSET ni total exacto. |
| Agrupación | Muestra de hasta 10.000 ocurrencias agrupadas recientes; countSemantics=lower_bound, coverage=partial. |
| Concurrencia local | 2 consultas/proyecto, 4/organización, 8/proceso; pool 2, statement 2 s, lock 500 ms, connect 3 s. |
No se ofrece búsqueda libre, filtros JSON arbitrarios ni facetas completas. Esos presupuestos son locales: no prueban cuotas distribuidas, cancelación por desconexión HTTP o rendimiento en un corpus de cualquier tamaño.
Estados y errores HTTP
| Estado | Interpretación |
|---|---|
| available / empty | Resultados o ventana sin resultados autorizados; cobertura unknown/partial. |
| missing / expired | Detalle no observable o tombstone revelable según el scope. |
| pending_or_partial | Correlación no exhaustiva, no causalidad. |
| 400 | Filtros, ventana o cursor inválidos; inicia consulta nueva. |
| 401 / 403 | Autenticación / scope insuficiente o revocado. |
| 404 | Stream no soportado o recurso no revelable según contrato. |
| 429 | Presupuesto local agotado; espera y consulta de forma acotada. |
| 501 | Capacidad no habilitada; autenticación se comprueba antes de revelar ese estado. |
| 503 | Indisponibilidad o timeout; no concluir salud ni ausencia de captura. |
Las lecturas usan no-store. Ningún resultado de capacidad equivale a permiso de ejecución, merge, migración o despliegue.