From 2e34d4dfecfdf6de180ac78d8f921c4c464913aa Mon Sep 17 00:00:00 2001 From: Abdelrahman Awad Date: Fri, 10 Oct 2025 16:49:15 +0300 Subject: [PATCH 1/2] docs: added info on debug flag value precedence --- packages/bundler-plugin-core/src/types.ts | 4 ++++ packages/dev-utils/src/generate-documentation-table.ts | 4 ++-- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/packages/bundler-plugin-core/src/types.ts b/packages/bundler-plugin-core/src/types.ts index 064cd89b..1f8539ef 100644 --- a/packages/bundler-plugin-core/src/types.ts +++ b/packages/bundler-plugin-core/src/types.ts @@ -42,6 +42,10 @@ export interface Options { * Enable debug information logs during build-time. * Enabling this will give you, for example, logs about source maps. * + * This option also propagates the debug flag to the Sentry CLI by setting + * the `SENTRY_LOG_LEVEL` environment variable to `"debug"` if it's not already set. + * If you have explicitly set `SENTRY_LOG_LEVEL`, this option will be ignored. + * * @default false */ debug?: boolean; diff --git a/packages/dev-utils/src/generate-documentation-table.ts b/packages/dev-utils/src/generate-documentation-table.ts index 1757ffe9..ed34b51a 100644 --- a/packages/dev-utils/src/generate-documentation-table.ts +++ b/packages/dev-utils/src/generate-documentation-table.ts @@ -41,7 +41,7 @@ const options: OptionDocumentation[] = [ name: "debug", type: "boolean", fullDescription: - "Enable debug information logs during build-time. Enabling this will give you, for example, logs about source maps. Defaults to `false`.", + "Enable debug information logs during build-time. Enabling this will give you, for example, logs about source maps. This option also propagates the debug flag to the Sentry CLI by setting the `SENTRY_LOG_LEVEL` environment variable to `"debug"` if it\'s not already set. If you have explicitly set `SENTRY_LOG_LEVEL`, this option will be ignored. Defaults to `false`.", }, { name: "silent", @@ -114,7 +114,7 @@ urls and absolute/relative paths). If that path doesn't exist, it then looks for Note: This is mostly helpful for complex builds with custom source map generation. For example, if you put source maps into a separate directory and rewrite the \`//# sourceMappingURL=\` comment to something other than a relative -directory, sentry will be unable to locate the source maps for a given build artifact. This hook allows you to +directory, sentry will be unable to locate the source maps for a given build artifact. This hook allows you to implement the resolution process yourself. Use the \`debug\` option to print information about source map resolution. From ffafd9a68049cdb4701543d1d3c89ef3046ae663 Mon Sep 17 00:00:00 2001 From: Abdelrahman Awad Date: Fri, 10 Oct 2025 17:02:49 +0300 Subject: [PATCH 2/2] fix: formatting --- packages/dev-utils/src/generate-documentation-table.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/dev-utils/src/generate-documentation-table.ts b/packages/dev-utils/src/generate-documentation-table.ts index ed34b51a..073ba305 100644 --- a/packages/dev-utils/src/generate-documentation-table.ts +++ b/packages/dev-utils/src/generate-documentation-table.ts @@ -41,7 +41,7 @@ const options: OptionDocumentation[] = [ name: "debug", type: "boolean", fullDescription: - "Enable debug information logs during build-time. Enabling this will give you, for example, logs about source maps. This option also propagates the debug flag to the Sentry CLI by setting the `SENTRY_LOG_LEVEL` environment variable to `"debug"` if it\'s not already set. If you have explicitly set `SENTRY_LOG_LEVEL`, this option will be ignored. Defaults to `false`.", + 'Enable debug information logs during build-time. Enabling this will give you, for example, logs about source maps. This option also propagates the debug flag to the Sentry CLI by setting the `SENTRY_LOG_LEVEL` environment variable to `"debug"` if it\'s not already set. If you have explicitly set `SENTRY_LOG_LEVEL`, this option will be ignored. Defaults to `false`.', }, { name: "silent",