buildflow

type Opts struct {
	// ProjectDir is the working directory containing package.json and
	// next.config.*. Defaults to "." when empty.
	ProjectDir string

	// Cfg drives target-aware behavior. Required.
	Cfg *config.NextDeployConfig

	// Force bypasses the incremental skip (git-commit unchanged → no
	// rebuild). Wired to `nextdeploy build --force`. Ship always passes
	// false because shipping with an unverified-stale build is a footgun.
	Force bool

	// Log receives lifecycle messages. Required.
	Log *shared.Logger
}

type Result struct {
	Payload nextcore.NextCorePayload

	// EffectiveTarget is the target this build was prepared for —
	// "serverless" or "vps". Resolved from Cfg + payload.
	EffectiveTarget string

	// StandaloneDir is the path to .next/standalone. Populated when
	// OutputMode is standalone (required for serverless, common for VPS).
	StandaloneDir string

	// ReleaseDir / TarballPath are populated only on the VPS path —
	// the artifact `nextdeploy ship` uploads to the remote daemon.
	ReleaseDir  string
	TarballPath string

	// Skipped is true when the incremental check matched and no rebuild
	// was attempted. `nextdeploy build` treats this as "exit success";
	// ship treats it as "use the existing artifacts".
	Skipped bool
}