Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

init: finish source map setup before exposing it as a feature

Abierto
#1,417 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
25/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
typescript

Línea de trabajo

Empieza revisando el manejo actual de la funcionalidad init descrito en el issue y, después, lee blocker #1110 y PR #1112 antes de proponer trabajo de implementación. Trata los criterios de aceptación como la definición de terminado: los source maps no deben anunciarse prematuramente, los secrets deben mantenerse fuera de init y de los archivos confirmados, y la verificación de la subida de los production builds debe ser explícita.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Problem

sourceMaps is currently advertised by sentry init in its --features
help and documentation, while the init service deliberately removes it from
both interactive and CLI-preselected features.

Keeping it disabled is currently the correct behavior. A valid source map setup
requires more than changing bundler configuration:

  • Production builds must emit source maps.
  • A Sentry bundler plugin or sentry sourcemap inject + upload must run in the
    build that is actually deployed.
  • Upload requires a CI-safe Organization Auth Token with the org:ci scope.
  • The token must be installed as SENTRY_AUTH_TOKEN in CI and must never pass
    through the init server, LLM context, telemetry, or committed files.
  • Browser source maps should normally be hidden and deleted after upload.

Without that flow, init can produce configuration that looks complete while no
artifacts are ever uploaded.

Source maps are also a build/deployment concern, not a runtime product feature
like tracing, replay, or profiling. They should not appear as a peer option in
the feature picker.

Existing blocker

Token management is already tracked by #1110 and PR #1112.

The current organization-token management endpoints only accept browser session
authentication and explicitly reject Bearer authentication. The CLI therefore
cannot mint an Organization Auth Token using its stored OAuth token. This needs
a supported backend flow before it can be automated safely.

This issue should depend on #1110 rather than implementing another token
creation workaround.

Proposed UX

Until end-to-end setup is possible:

  • Keep source maps out of the interactive feature list.
  • Stop advertising sourcemaps as a currently supported --features value.
  • The internal feature/schema value may remain for future planner work.

Once token provisioning is supported, offer source maps as an eligible
build-setup step for JavaScript projects rather than as a runtime feature.

Required setup flow

  1. Detect the framework, bundler, production output directory, and CI/build
    configuration.
  2. Prefer the official framework or bundler plugin.
  3. Fall back to sentry sourcemap inject followed by
    sentry sourcemap upload for custom builds.
  4. Configure SENTRY_ORG and SENTRY_PROJECT, while referencing
    SENTRY_AUTH_TOKEN only through the environment.
  5. Create an Organization Auth Token with org:ci through the future supported
    token flow, or give the user a secure browser handoff.
  6. Explain how to add the one-time token to the project's CI secret store.
  7. Use hidden source maps and delete browser maps after upload where supported.
  8. Verify using a production build and confirm that an artifact bundle reached
    Sentry.
  9. Do not require or invent a release. Modern Debug ID matching works without a
    release; preserve existing release configuration when one already exists.

Acceptance criteria

  • Source maps are not shown as supported before the complete flow exists.
  • No token value is sent to the init API, an LLM, or telemetry.
  • No token or usable placeholder secret is committed to the repository.
  • Configuration is correct for the detected bundler/framework.
  • Browser builds use hidden maps and avoid deploying .map files publicly.
  • CI-secret setup is explicit and actionable.
  • A production-build verification checks the actual upload.
  • Init does not report source maps as complete when token/CI setup remains.
  • Release configuration remains optional with Debug IDs.

References

Lenguaje dominante
TypeScript
Estrellas
121
Forks
14
Merge medio
23 h 54 min
PR fusionados (30 d)
103

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de getsentry/cli

Todos los issues de getsentry/cli

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.