[@sentry/nextjs]: `project` option in `withSentryConfig` typed as `string` but bundler plugin accepts `string | string[]

[delorge]

Is there an existing issue for this?

• I have checked for existing issues https://github.com/getsentry/sentry-javascript/issues
• I have reviewed the documentation https://docs.sentry.io/
• I am using the latest SDK release https://github.com/getsentry/sentry-javascript/releases

How do you use Sentry?

Sentry Saas (sentry.io)

Which SDK are you using?

@sentry/nextjs

SDK Version

10.53.1

Framework Version

No response

Link to Sentry event

No response

Reproduction Example/SDK Setup

Config's type definition declares project?: string, but the underlying @sentry/bundler-plugin-core types project as string | string[]
(source).

Build plugin option forwards the value verbatim to the bundler plugin - meaning the runtime already accepts arrays, but the TypeScript type rejects them at compile time. And it also breaks discoverability for agents.

Steps to Reproduce

withSentryConfig(nextConfig, {
  project: ['proj-a', 'proj-b'],
})

Expected Result

No TypeScript error — project accepts string | string[].

Actual Result

Type 'string[]' is not assignable to type 'string | undefined'.

Additional Context

No response

Priority

_{React with 👍 to help prioritize this issue. Please use comments to provide useful context, avoiding +1 or me too, to help us triage it.}

[linear-code]

JS-2569