¿Usas Bun? Dependabot no ve la mayoría de tus dependencias (y cómo solucionarlo) ✅ yoDEV Tested

Si tu proyecto usa Bun, Dependabot probablemente solo revisa lo que declaras en package.json: el grafo de dependencias de GitHub no lee bun.lock, así que todo el árbol transitivo (los paquetes que traen tus paquetes) queda fuera. En nuestro repositorio de prueba, GitHub vio 1 paquete de 50 y levantó 2 alertas de 16. Una nueva GitHub Action open source, bun-lock-submission, cierra esa brecha en unos dos minutos.

:white_check_mark: yoDEV Tested · 4 de noviembre de 2026
Probamos bun-lock-submission v1 (npm 1.0.0) con Bun 1.4.4 en un repositorio público de GitHub creado para la prueba, con express 4.17.1 como única dependencia directa. Los resultados que reportamos como nuestros salen de esa prueba.

Nicolas Charpentier, autor de la Action, documentó el problema en su blog el 28 de octubre de 2026: en su repositorio de demostración, GitHub veía 3 de 12 paquetes instalados. Nosotros lo reprodujimos en un repositorio propio, con números todavía más grandes.

¿Qué es Dependabot y de dónde salen sus alertas?

Dependabot es la herramienta de GitHub que te avisa cuando una de tus dependencias tiene una vulnerabilidad conocida. Sus alertas (Dependabot alerts) no escanean tu proyecto por su cuenta: salen del dependency graph, el grafo de dependencias que GitHub construye leyendo tus manifiestos y lockfiles. Si un paquete no está en ese grafo, Dependabot no puede alertarte sobre él.

Conviene distinguir tres funciones que comparten nombre:

  • Dependabot alerts: avisos de vulnerabilidades, basados en el grafo de dependencias.
  • Dependabot version updates: pull requests para mantener tus dependencias al día. Soportan Bun desde principios de 2025 y sí actualizan bun.lock.
  • Dependabot security updates: pull requests automáticos que corrigen vulnerabilidades. No se abren para proyectos con Bun.

¿Por qué Dependabot no detecta las dependencias de bun.lock?

Porque el grafo de dependencias de GitHub no interpreta bun.lock. En un proyecto con Bun, el grafo solo conoce lo que declara package.json: las dependencias transitivas y las versiones resueltas mediante catalog: le resultan invisibles, y Dependabot no puede levantar alertas sobre ellas.

Al momento de publicar esta nota (noviembre de 2026), GitHub no había anunciado soporte nativo para bun.lock en el grafo de dependencias, y el artículo original no cita ningún issue, entrada de roadmap ni fecha.

¿Cómo saber si tu repositorio está afectado?

Compara lo que ve GitHub con lo que ve Bun; te lleva dos minutos.

  1. En local: ejecuta bun audit (el equivalente de npm audit). Lee tu lockfile real y lista cada paquete vulnerable, directo o transitivo.
  2. En GitHub: abre Insights → Dependency graph y Security → Dependabot.

Si la lista local es más larga que la de GitHub, estás afectado. Si en el grafo solo aparecen paquetes marcados con package.json y ninguno con bun.lock, lo estás seguro.

Algo que nos encontramos primero: en nuestro repositorio público recién creado, tanto Dependency graph como Dependabot alerts estaban desactivados en Settings → Advanced Security, aunque en los repositorios públicos el grafo suele venir activado. Revisa que ambos estén encendidos antes de nada: sin grafo no hay adónde enviar las dependencias.

¿Qué es bun-lock-submission?

bun-lock-submission es una GitHub Action y una CLI que leen tu bun.lock y envían el árbol completo de dependencias resueltas a la dependency graph submission API de GitHub, la vía oficial para registrar dependencias que GitHub no detecta por sí mismo. Una vez enviado el árbol, Dependabot levanta alertas sobre él como con cualquier otra dependencia.

  • Licencia MIT, versión 1.0.0 publicada en npm el 27 de octubre de 2026, un único mantenedor.
  • Probada por su autor con Bun 1.1.43, 1.2.23, 1.3.14 y 1.4.4, lo que cubre las versiones de lockfile 0 a 3.
  • Solo admite el bun.lock de texto. Si todavía tienes el antiguo bun.lockb binario, conviértelo con bun install --save-text-lockfile.

¿Cómo se instala bun-lock-submission?

Agrega este workflow en .github/workflows/dependency-submission.yml. Es el del README sin cambios, y es exactamente el que ejecutamos:

# .github/workflows/dependency-submission.yml
name: Dependency submission

on:
  push:
    branches: [main]
    paths:
      - '**/bun.lock'
      # Editing this workflow, such as its inputs or the action version, changes
      # what gets submitted too.
      - .github/workflows/dependency-submission.yml
  workflow_dispatch:

permissions: {}

jobs:
  submit:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v7
      - uses: charpeni/bun-lock-submission@v1

Lo importante:

  • contents: write es obligatorio para la submission API. Los permisos quedan vacíos a nivel global y solo se conceden a este job.
  • Se ejecuta en cada push a main que modifique algún bun.lock o el propio workflow, y también a mano con workflow_dispatch.
  • En nuestra prueba, el push del archivo del workflow disparó la primera ejecución por sí solo, porque el archivo está dentro del filtro paths. El README advierte que el primer push a un repositorio nuevo no dispara una ejecución filtrada por paths, así que si no ves nada, lánzala una vez desde la pestaña Actions.
  • ¿Tu rama por defecto no se llama main? Cambia branches:. Los snapshots de otras ramas se guardan, pero no generan alertas.
  • Si tu organización lo exige, fija la Action a un commit SHA en lugar de @v1.

Inputs opcionales, según el README: layout: workspaces (reporta contra el package.json de cada workspace en un monorepo), exclude (paquetes que no se deben enviar), include-exact-pins (envía también las dependencias directas fijadas a una versión exacta) y dry-run.

¿Se puede probar sin GitHub Actions?

Sí. La misma herramienta viene como CLI:

bunx bun-lock-submission snapshot   # print the snapshot as JSON
bunx bun-lock-submission submit     # submit it to GitHub
bunx bun-lock-submission clear      # remove what was submitted

snapshot es una vista previa segura: muestra lo que se enviaría sin enviar nada. Para submit, el token se toma de GITHUB_TOKEN, GH_TOKEN o gh auth token, en ese orden. También funciona con npx bun-lock-submission.

¿Cuántas alertas faltaban? Lo que vimos en nuestra prueba

Faltaban 14 de 16. Creamos un repositorio público desechable con una sola dependencia directa, express fijado en 4.17.1, una versión antigua con vulnerabilidades conocidas en su árbol transitivo. bun install resolvió 50 paquetes y bun audit reportó 16 vulnerabilidades en 7 paquetes: 2 en el propio express y 14 en paquetes transitivos (body-parser, qs, path-to-regexp, cookie, send, serve-static).

Dependency graph Dependabot alerts
Antes (solo GitHub) 1 paquete 2
Después de bun-lock-submission 52 paquetes 16
bun audit (local) 50 instalados 16
  • Antes: el grafo solo mostraba express, marcado con package.json. Dependabot levantó 2 alertas, ambas sobre express. Las 14 vulnerabilidades transitivas eran invisibles.
  • Después: una ejecución del workflow, 9 segundos. El grafo pasó a 52 entradas, con las nuevas etiquetadas Transitive · bun.lock · Detected by bun-lock-submission. Dependabot mostró 16 alertas abiertas, exactamente las 16 que encontró bun audit.
  • express siguió marcado con package.json: por defecto, las versiones exactas se dejan a package.json (include-exact-pins: false), así que nada se cuenta dos veces.

Las cifras del autor salen de su propio repositorio de demostración (3 de 12 paquetes visibles; 1 alerta antes y 3 después). Las nuestras salen de un repositorio distinto y apuntan en la misma dirección.

¿bun-lock-submission corrige las vulnerabilidades?

No. La Action hace visibles las vulnerabilidades, pero Dependabot sigue sin abrir pull requests de seguridad para proyectos con Bun, así que la corrección queda en tus manos:

  • bun audit fix actualiza los paquetes vulnerables dentro de sus rangos permitidos.
  • bun audit fix --latest también cruza versiones mayores.

Una sola pasada puede no bastar. En una copia de nuestra prueba, bun audit fix subió express a 4.20.0 y corrigió 6 vulnerabilidades, pero quedaron 11, en parte porque las versiones transitivas más nuevas tienen avisos propios. Eliminar el resto implicaba pasar a Express 5, que es una migración real y no un comando. Mantén también bun audit en tu CI: el autor lo recomienda como complemento de Dependabot, no como sustituto.

¿Qué precauciones hay que tener?

  • Paquetes privados con nombre público. Los avisos se asocian por nombre de paquete, así que un paquete privado que se llame igual que uno público recibe las alertas de ese paquete. Agrégalo a exclude.
  • Lockfiles que desaparecen. Si un lockfile deja de aparecer en un envío posterior, sus alertas se cierran como corregidas. Si vuelve, se reabren, pero se pierden los descartes (dismissals) que hubieras hecho.
  • Monorepos. layout: workspaces falla si un workspace tiene su propio bun.lock desactualizado. En ese caso, indica los lockfiles explícitamente con el input lockfiles.
  • Madurez. Es una 1.0.0 con un único mantenedor, publicada una semana antes de esta nota. Usa la API oficial de GitHub y su alcance es acotado, pero trátala como cualquier dependencia nueva en tu pipeline.

¿Cuándo conviene quitarlo?

En cuanto GitHub lea bun.lock de forma nativa. El autor indica dos pasos para salir:

  1. Elimina el workflow de dependency submission.
  2. Ejecuta bunx bun-lock-submission clear desde tu rama por defecto para borrar lo que envió la Action.

¿Y tú? ¿Qué encontraste al comparar bun audit con las alertas de Dependabot en tu repositorio?

¿Cómo auditas hoy las dependencias de tus proyectos con Bun?
  • Solo con Dependabot
  • Con bun audit en CI
  • Todavía no las audito
  • Con otra herramienta (cuéntanos cuál)
0 votantes

Comenta abajo o, si este artículo te llegó por correo, responde directamente al email: tu respuesta se publica aquí.

Relacionado: Bun check vs tsc: probamos el nuevo type checker de Bun en zod, Playwright y Hono :white_check_mark: yoDEV Tested