fix(node-core,vercel-edge): Use HEROKU_BUILD_COMMIT env var for default release

Add HEROKU_BUILD_COMMIT as the primary env var for detecting the release
on Heroku, keeping HEROKU_SLUG_COMMIT as a fallback since it is
deprecated by Heroku.

Closes: #19615

Agent transcript: https://claudescope.sentry.dev/share/w_FBx963Azo2_3JULQsv03PCYKpkBHg3NHWZaL6HiYU

Author: andreiborza

packages/node-core/src/sdk/api.ts

@@ -66,7 +66,9 @@ export function getSentryRelease(fallback?: string): string | undefined {
     process.env['FC_GIT_COMMIT_SHA'] ||
     // Heroku #1 https://devcenter.heroku.com/articles/heroku-ci
     process.env['HEROKU_TEST_RUN_COMMIT_VERSION'] ||
-    // Heroku #2 https://docs.sentry.io/product/integrations/deployment/heroku/#configure-releases
+    // Heroku #2 https://devcenter.heroku.com/articles/dyno-metadata#dyno-metadata
+    process.env['HEROKU_BUILD_COMMIT'] ||
+    // Heroku #3 (deprecated by Heroku, kept for backward compatibility)
     process.env['HEROKU_SLUG_COMMIT'] ||
     // Railway - https://docs.railway.app/reference/variables#git-variables
     process.env['RAILWAY_GIT_COMMIT_SHA'] ||

packages/node-core/test/sdk/getSentryRelease.test.ts

@@ -0,0 +1,27 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { getSentryRelease } from '../../src/sdk/api';
+
+afterEach(() => {
+  vi.unstubAllEnvs();
+});
+
+describe('getSentryRelease', () => {
+  it('uses HEROKU_BUILD_COMMIT env var', () => {
+    vi.stubEnv('HEROKU_BUILD_COMMIT', 'heroku-build-commit-sha');
+
+    expect(getSentryRelease()).toBe('heroku-build-commit-sha');
+  });
+
+  it('falls back to HEROKU_SLUG_COMMIT if HEROKU_BUILD_COMMIT is not set', () => {
+    vi.stubEnv('HEROKU_SLUG_COMMIT', 'heroku-slug-commit-sha');
+
+    expect(getSentryRelease()).toBe('heroku-slug-commit-sha');
+  });
+
+  it('prefers HEROKU_BUILD_COMMIT over HEROKU_SLUG_COMMIT', () => {
+    vi.stubEnv('HEROKU_BUILD_COMMIT', 'heroku-build-commit-sha');
+    vi.stubEnv('HEROKU_SLUG_COMMIT', 'heroku-slug-commit-sha');
+
+    expect(getSentryRelease()).toBe('heroku-build-commit-sha');
+  });
+});

packages/vercel-edge/src/sdk.ts

@@ -265,7 +265,9 @@ export function getSentryRelease(fallback?: string): string | undefined {
     process.env['FC_GIT_COMMIT_SHA'] ||
     // Heroku #1 https://devcenter.heroku.com/articles/heroku-ci
     process.env['HEROKU_TEST_RUN_COMMIT_VERSION'] ||
-    // Heroku #2 https://docs.sentry.io/product/integrations/deployment/heroku/#configure-releases
+    // Heroku #2 https://devcenter.heroku.com/articles/dyno-metadata#dyno-metadata
+    process.env['HEROKU_BUILD_COMMIT'] ||
+    // Heroku #3 (deprecated by Heroku, kept for backward compatibility)
     process.env['HEROKU_SLUG_COMMIT'] ||
     // Railway - https://docs.railway.app/reference/variables#git-variables
     process.env['RAILWAY_GIT_COMMIT_SHA'] ||