feat(create-sanity): bundle init logic into single file

[rexxars]

Description

Note

Part 3/4 of the ongoing work to make create-sanity faster by bundling the init logic

This mostly completes the work - the remaining part is the telemetry integration and an optional but wanted step at reducing the amount of dependencies we rely on for the init step.

The bundling script has a few hacks that would be nice to get rid of over time, but not the end of the world.

What to review

Testing

[claude]

Claude finished @mttdnt's task in 7m 12s —— View job

---

Review

• Gather context (CLAUDE.md, diff)
• Review changed files
• Check changeset
• Post findings

---

Issues

1. util.deprecate() breaks instanceof checks (high severity)

The barrel exports in packages/@sanity/cli-core/src/_exports/index.ts wrap the error classes with util.deprecate(), but this breaks instanceof checks across the codebase.

util.deprecate(Cls, msg) returns a wrapper function whose .prototype is a different object from Cls.prototype. When the wrapper is invoked with new, Node.js uses Reflect.construct(Cls, args, wrapper), so the created instance inherits from wrapper.prototype, not Cls.prototype. This means:

const instance = new RealClass()
instance instanceof DeprecatedWrapper // FALSE — prototype chains don't overlap

The real classes are thrown internally by findProjectRoot.ts (L36) and SanityCommand.ts (L170, L181) using the direct imports. But the catch sites in @sanity/cli hold the deprecated wrapper from the barrel:

• packages/@sanity/cli/src/commands/debug.ts — if (!(err instanceof ProjectRootNotFoundError)) throw err → will always re-throw, breaking sanity debug in non-project directories
• packages/@sanity/cli/src/commands/media/deploy-aspect.ts — same issue
• packages/@sanity/cli/src/commands/documents/validate.ts — same issue
• packages/@sanity/cli/src/prompts/promptForProject.ts — NonInteractiveError catch in SanityCommand.ts will fail for errors thrown by this file

Fix: Use a plain re-export with a JSDoc deprecation tag instead of wrapping with util.deprecate:

/** @deprecated Import from `@sanity/cli-core/errors` */
export {NonInteractiveError} from '../errors/NonInteractiveError.js'

This preserves the prototype chain for instanceof while signalling the new import path to consumers.

---

2. Bundle import failure in CI

The bundle stats comment shows:

Import time: ❌ TypeError: Cannot add property upath, object is not extensible

A CJS module in the bundle is trying to mutate its exports at runtime after the rollup commonjs() plugin converted it to ESM (where the namespace object is sealed). The upath module or a dependency using it is the offender. This needs to be resolved before the bundle is usable — consider adding an alias or namedExports entry in the commonjs() plugin config, or replacing the offending dep with an ESM alternative.

---

3. Swallowed error context in dataset import (initStudio.ts:L149)

} catch {
  output.warn(
    'Sample dataset import failed. Your studio will work fine without it.\n' + ...
  )
}

Using a bare catch discards the actual error. If the sanity binary isn't found after install or the subprocess fails with a non-zero exit for a non-obvious reason, there's no diagnostic. Consider at least:

} catch (err) {
  output.warn(...)
  // log raw error in debug mode or append to message
}

---

Changeset

The changeset is present (pr-759.md) and the bump type (minor) is appropriate for new exports and the bundled CLI entry. The summary "bundle init logic into single file" is accurate but omits the addition of CLIError/CLIWarning to @sanity/cli-core and the removal of fromCreate. Those are API surface changes worth calling out for library consumers.

---

Minor observations (no action required)

• The double-parse in parseArgs.ts (lenient for --help, strict for validation) is slightly wasteful but harmless since printHelp() exits before the strict parse on --help.
• --env validation moved from oclif's parse callback (exit 2) to flagsToInitOptions (exit 3 via InitError). This is a minor exit-code change for invalid --env values on the oclif path but is intentional given the shared validation.
• toOclifFlags in flagAdapter.ts silently drops the env parse callback (the flag's oclif-only validation hook). The validation is correctly replicated in flagsToInitOptions, so this is fine.

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​esbuild@​0.25.12
	npm/​clean-stack@​6.0.0
	npm/​wrap-ansi@​10.0.0
	npm/​rollup-plugin-visualizer@​7.0.1

View full report

[github-actions]

Coverage Delta

File	Statements
packages/@sanity/cli-core/src/_exports/index.ts	100.0% (new)
packages/@sanity/cli-core/src/errors/CLIError.ts	72.7% (new)
packages/@sanity/cli-core/src/errors/CLIWarning.ts	100.0% (new)
packages/@sanity/cli-core/src/errors/NonInteractiveError.ts	100.0% (±0%)
packages/@sanity/cli-core/src/errors/ProjectRootNotFoundError.ts	100.0% (±0%)
packages/@sanity/cli-core/src/services/apiClient.ts	100.0% (±0%)
packages/@sanity/cli-core/src/util/getCliTelemetry.ts	100.0% (±0%)
packages/@sanity/cli-core/src/ux/errors.ts	65.1% (new)
packages/@sanity/cli-core/src/ux/output.ts	50.0% (new)
packages/@sanity/cli/src/SanityHelp.ts	60.0% (- 10.4%)
packages/@sanity/cli/src/actions/init/bootstrapTemplate.ts	0.0% (±0%)
packages/@sanity/cli/src/actions/init/env/createOrAppendEnvVars.ts	0.0% (±0%)
packages/@sanity/cli/src/actions/init/flags.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/flagsToInitOptions.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/initAction.ts	94.8% (new)
packages/@sanity/cli/src/actions/init/initApp.ts	96.0% (new)
packages/@sanity/cli/src/actions/init/initError.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/initHelpers.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/initNextJs.ts	86.7% (new)
packages/@sanity/cli/src/actions/init/initStudio.ts	85.1% (new)
packages/@sanity/cli/src/actions/init/scaffoldTemplate.ts	88.0% (new)
packages/@sanity/cli/src/actions/mcp/setupMCP.ts	100.0% (±0%)
packages/@sanity/cli/src/commands/init.ts	100.0% (+ 7.4%)
packages/@sanity/cli/src/prompts/promptForDefaultConfig.ts	100.0% (±0%)
packages/@sanity/cli/src/telemetry/init.telemetry.ts	100.0% (±0%)
packages/@sanity/cli/src/util/flagAdapter.ts	91.7% (new)
packages/create-sanity/rollup.config.ts	0.0% (new)
packages/create-sanity/src/createCommand.ts	0.0% (new)
packages/create-sanity/src/help.ts	0.0% (new)
packages/create-sanity/src/index.ts	0.0% (new)
packages/create-sanity/src/noopTelemetry.ts	0.0% (new)
packages/create-sanity/src/parseArgs.ts	0.0% (new)

Comparing 32 changed files against main @ 56f2c0ad9debf4324b7f736ba2f19a2421f4eb7a

Overall Coverage

Metric	Coverage
Statements	81.6% (- 1.4%)
Branches	71.1% (- 1.6%)
Functions	82.0% (- 1.2%)
Lines	82.1% (- 1.3%)

[github-actions]

❌ Bundle Stats — An error occurred while calculating bundle sizes.

Error details

From https://github.com/sanity-io/cli
 * branch            a2692060a2d77701523f03cd6c4e3c743702dd7b -> FETCH_HEAD
Building baseline...

Attention:
Turborepo now collects completely anonymous telemetry regarding usage.
This information is used to shape the Turborepo roadmap and prioritize features.
You can learn more, including how to opt-out if you'd not like to participate in this anonymous program, by visiting the following URL:
https://turborepo.dev/docs/telemetry

Measuring baseline for packages/@sanity/cli
Found 1 exports and 1 bin entries
Measuring internal sizes...
Bundling @sanity/cli...
"fsevents" is imported by "node_modules/.pnpm/rollup@4.59.0/node_modules/rollup/dist/es/shared/node-entry.js", but could not be resolved – treating it as an external dependency.
Bundling bin:sanity...
Benchmarking import @sanity/cli (1/2)...
Benchmarking import bin:sanity (2/2)...
Measuring baseline for packages/@sanity/cli-core
Found 1 exports and 0 bin entries
Measuring internal sizes...
Bundling @sanity/cli-core...
Benchmarking import @sanity/cli-core (1/1)...
From https://github.com/sanity-io/cli
 * branch            2c0b60471cb9f92bf842453b79c8dc109bd4db54 -> FETCH_HEAD
Building head...
Measuring current for packages/@sanity/cli
Found 1 exports and 1 bin entries
Measuring internal sizes...
Bundling @sanity/cli...
"fsevents" is imported by "node_modules/.pnpm/rollup@4.59.0/node_modules/rollup/dist/es/shared/node-entry.js", but could not be resolved – treating it as an external dependency.
Bundling bin:sanity...
Benchmarking import @sanity/cli (1/2)...
Benchmarking import bin:sanity (2/2)...
Measuring current for packages/@sanity/cli-core
Found 1 exports and 0 bin entries
Measuring internal sizes...
Bundling @sanity/cli-core...
Benchmarking import @sanity/cli-core (1/1)...
Found 1 exports and 1 bin entries
Measuring internal sizes...
Bundling @sanity/cli...
"fsevents" is imported by "node_modules/.pnpm/rollup@4.59.0/node_modules/rollup/dist/es/shared/node-entry.js", but could not be resolved – treating it as an external dependency.
Bundling bin:sanity...
Benchmarking import @sanity/cli (1/2)...
Benchmarking import bin:sanity (2/2)...
Reading baseline from stdin...
Comparing against npm @sanity/cli@6.3.0...
Installing @sanity/cli@6.3.0 into temp directory...
Error: Failed to install @sanity/cli@6.3.0 from npm: spawnSync npm ETIMEDOUT

[binoy14]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• feat(telemetry): add standalone telemetry for create-sanity #892
• feat(create-sanity): bundle init logic into single file #759 👈 (View in Graphite)
• refactor(init): move init logic to action pattern #845
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

📦 Bundle Stats — @sanity/cli

Compared against bundled-create (d82d20e5)

@sanity/cli

Metric	Value	vs bundled-create (d82d20e)
Internal (raw)	2.1 KB	-
Internal (gzip)	799 B	-
Bundled (raw)	1.54 MB	-9.40 MB, -86.0%
Bundled (gzip)	394.7 KB	-1.67 MB, -81.2%
Import time	856ms	+44ms, +5.4%

bin:sanity

Metric	Value	vs bundled-create (d82d20e)
Internal (raw)	975 B	-
Internal (gzip)	460 B	-
Bundled (raw)	9.84 MB	-
Bundled (gzip)	1.77 MB	-
Import time	1.97s	+32ms, +1.6%

🗺️ View treemap · Artifacts

Details

• Import time regressions over 10% are flagged with ⚠️
• Sizes shown as raw / gzip 🗜️. Internal bytes = own code only. Total bytes = with all dependencies. Import time = Node.js cold-start median.

📦 Bundle Stats — @sanity/cli-core

Compared against bundled-create (d82d20e5)

Metric	Value	vs bundled-create (d82d20e)
Internal (raw)	98.0 KB	+4.9 KB, +5.3%
Internal (gzip)	23.3 KB	+1.4 KB, +6.4%
Bundled (raw)	21.65 MB	+35.6 KB, +0.2%
Bundled (gzip)	3.43 MB	+8.5 KB, +0.2%
Import time	808ms	+27ms, +3.4%

🗺️ View treemap · Artifacts

Details

• Import time regressions over 10% are flagged with ⚠️
• Sizes shown as raw / gzip 🗜️. Internal bytes = own code only. Total bytes = with all dependencies. Import time = Node.js cold-start median.

📦 Bundle Stats — create-sanity

Compared against bundled-create (d82d20e5)

Metric	Value	vs bundled-create (d82d20e)
Internal (raw)	2.37 MB	+2.37 MB, +254497.4%
Internal (gzip)	555.3 KB	+554.8 KB, +112049.7%
Bundled (raw)	2.37 MB	+2.37 MB, +248141.6%
Bundled (gzip)	555.3 KB	+554.8 KB, +110520.0%
Import time	❌ TypeError: Cannot add property upath, object is not extensible	-

Details

• Import time regressions over 10% are flagged with ⚠️
• Sizes shown as raw / gzip 🗜️. Internal bytes = own code only. Total bytes = with all dependencies. Import time = Node.js cold-start median.

[github-actions]

Coverage Delta

File	Statements
packages/@sanity/cli-core/src/_exports/index.ts	100.0% (new)
packages/@sanity/cli-core/src/errors/CLIError.ts	72.7% (new)
packages/@sanity/cli-core/src/errors/CLIWarning.ts	100.0% (new)
packages/@sanity/cli-core/src/errors/NonInteractiveError.ts	100.0% (±0%)
packages/@sanity/cli-core/src/errors/ProjectRootNotFoundError.ts	100.0% (±0%)
packages/@sanity/cli-core/src/services/apiClient.ts	100.0% (±0%)
packages/@sanity/cli-core/src/telemetry/getCliTelemetry.ts	100.0% (±0%)
packages/@sanity/cli-core/src/ux/errors.ts	65.1% (new)
packages/@sanity/cli-core/src/ux/output.ts	50.0% (new)
packages/@sanity/cli/src/SanityHelp.ts	88.1% (+ 7.7%)
packages/@sanity/cli/src/actions/init/bootstrapTemplate.ts	0.0% (±0%)
packages/@sanity/cli/src/actions/init/env/createOrAppendEnvVars.ts	0.0% (±0%)
packages/@sanity/cli/src/actions/init/flags.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/flagsToInitOptions.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/initAction.ts	94.8% (new)
packages/@sanity/cli/src/actions/init/initApp.ts	96.0% (new)
packages/@sanity/cli/src/actions/init/initError.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/initHelpers.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/initNextJs.ts	86.7% (new)
packages/@sanity/cli/src/actions/init/initStudio.ts	85.1% (new)
packages/@sanity/cli/src/actions/init/scaffoldTemplate.ts	88.0% (new)
packages/@sanity/cli/src/actions/mcp/setupMCP.ts	100.0% (±0%)
packages/@sanity/cli/src/commands/init.ts	100.0% (+ 7.4%)
packages/@sanity/cli/src/prompts/promptForDefaultConfig.ts	100.0% (±0%)
packages/@sanity/cli/src/telemetry/init.telemetry.ts	100.0% (±0%)
packages/@sanity/cli/src/util/flagAdapter.ts	91.7% (new)
packages/create-sanity/rollup.config.ts	0.0% (new)
packages/create-sanity/src/createCommand.ts	0.0% (new)
packages/create-sanity/src/help.ts	0.0% (new)
packages/create-sanity/src/index.ts	0.0% (new)
packages/create-sanity/src/noopTelemetry.ts	0.0% (new)
packages/create-sanity/src/parseArgs.ts	0.0% (new)

Comparing 32 changed files against main @ 7af1594d79003801d6daeadeeb20508d184adb25

Overall Coverage

Metric	Coverage
Statements	81.7% (- 1.4%)
Branches	71.4% (- 1.5%)
Functions	82.2% (- 1.1%)
Lines	82.2% (- 1.3%)

[github-actions]

Coverage Delta

File	Statements
packages/@sanity/cli-core/src/_exports/index.ts	100.0% (new)
packages/@sanity/cli-core/src/errors/CLIError.ts	72.7% (new)
packages/@sanity/cli-core/src/errors/CLIWarning.ts	100.0% (new)
packages/@sanity/cli-core/src/errors/NonInteractiveError.ts	100.0% (±0%)
packages/@sanity/cli-core/src/errors/ProjectRootNotFoundError.ts	100.0% (±0%)
packages/@sanity/cli-core/src/telemetry/getCliTelemetry.ts	100.0% (±0%)
packages/@sanity/cli-core/src/ux/errors.ts	65.1% (new)
packages/@sanity/cli-core/src/ux/output.ts	50.0% (new)
packages/@sanity/cli/src/SanityHelp.ts	88.1% (+ 7.7%)
packages/@sanity/cli/src/actions/init/bootstrapTemplate.ts	0.0% (±0%)
packages/@sanity/cli/src/actions/init/env/createOrAppendEnvVars.ts	0.0% (±0%)
packages/@sanity/cli/src/actions/init/flags.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/flagsToInitOptions.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/initAction.ts	94.8% (new)
packages/@sanity/cli/src/actions/init/initApp.ts	96.0% (new)
packages/@sanity/cli/src/actions/init/initError.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/initHelpers.ts	100.0% (new)
packages/@sanity/cli/src/actions/init/initNextJs.ts	86.7% (new)
packages/@sanity/cli/src/actions/init/initStudio.ts	85.1% (new)
packages/@sanity/cli/src/actions/init/scaffoldTemplate.ts	88.0% (new)
packages/@sanity/cli/src/actions/mcp/setupMCP.ts	100.0% (±0%)
packages/@sanity/cli/src/commands/init.ts	100.0% (+ 7.4%)
packages/@sanity/cli/src/prompts/promptForDefaultConfig.ts	100.0% (±0%)
packages/@sanity/cli/src/telemetry/init.telemetry.ts	100.0% (±0%)
packages/@sanity/cli/src/util/flagAdapter.ts	91.7% (new)
packages/create-sanity/rollup.config.ts	0.0% (new)
packages/create-sanity/src/createCommand.ts	0.0% (new)
packages/create-sanity/src/help.ts	0.0% (new)
packages/create-sanity/src/index.ts	0.0% (new)
packages/create-sanity/src/noopTelemetry.ts	0.0% (new)
packages/create-sanity/src/parseArgs.ts	0.0% (new)

Comparing 31 changed files against main @ ef5ed4565d33b83d67cd66c6b3c335516e5b1132

Overall Coverage

Metric	Coverage
Statements	81.7% (- 1.4%)
Branches	71.3% (- 1.6%)
Functions	82.2% (- 1.1%)
Lines	82.2% (- 1.3%)