nextcompile

type Action struct {
	ID      string        `json:"-"`
	Module  string        `json:"module"`
	Export  string        `json:"export"`
	Runtime ActionRuntime `json:"runtime"`
}

type ActionManifest struct {
	SchemaVersion string            `json:"schemaVersion"`
	Actions       map[string]Action `json:"actions"`
}

type ActionRuntime string

type BindingHint struct {
	Kind    string   // "secret" | "kv" | "r2" | "d1" | "service" | "queue"
	Name    string   // env var name or logical binding name
	Reason  string   // human-readable justification
	Sources []string // ModuleRef.CompiledPath list where the hint was derived
}

type CompileOpts struct {
	// StandaloneDir is the path to .next/standalone (or its extracted tarball).
	StandaloneDir string

	// Payload is the nextcore extraction. Routes, middleware, image config,
	// and ISR tag data all flow from here into the emitted manifest.
	Payload Payload

	// OutDir is where _nextdeploy/{manifest.json,dispatch.mjs,...} land.
	// Defaults to <StandaloneDir>/.nextdeploy-build when empty.
	OutDir string

	// Target picks the emit strategy. Defaults to TargetCloudflareWorker.
	Target Target

	// Verbose toggles per-step timing logs.
	Verbose bool

	// Log sinks diagnostics. Compile tolerates a nil logger (no output).
	Log Logger
}

type CompileStats struct {
	RouteCount       int
	ActionCount      int
	DeadRoutesElided int
	BundleBytes      int64
	Duration         time.Duration
	ContentHash      string
}

type CompiledBundle struct {
	BundleDir         string
	EntryPath         string
	ManifestPath      string
	DispatchPath      string
	ActionManifest    string
	DetectedVersion   NextVersion
	DetectedReact     ReactVersion
	SuggestedBindings []BindingHint
	// VendoredRSC is populated when the target requires vendoring and the
	// react-server-dom-webpack package was located in node_modules. Nil
	// when the app does not use RSC, or when vendoring was not applicable
	// for the target. Checked by adapter logs and bundle reports.
	VendoredRSC *VendoredPackage
	Stats       CompileStats
}

type I18nConfig struct {
	Locales         []string
	DefaultLocale   string
	LocaleDetection bool
}

type ISRRoute struct {
	Path       string
	Tags       []string
	Revalidate int
}

type ImageConfig struct {
	RemotePatterns []ImageRemotePattern
	Domains        []string
	Formats        []string
	Unoptimized    bool
}

type ImageRemotePattern struct {
	Protocol string
	Hostname string
	Port     string
	Pathname string
}

type Logger interface {
	Info(format string, args ...any)
	Warn(format string, args ...any)
	Debug(format string, args ...any)
}

type Manifest struct {
	SchemaVersion string          `json:"schemaVersion"`
	GeneratedAt   string          `json:"generatedAt"`
	AppName       string          `json:"appName"`
	BasePath      string          `json:"basePath,omitempty"`
	NextVersion   string          `json:"nextVersion"`
	ReactVersion  string          `json:"reactVersion,omitempty"`
	BuildID       string          `json:"buildId,omitempty"`
	GitCommit     string          `json:"gitCommit,omitempty"`
	Routes        ManifestRoutes  `json:"routes"`
	ISR           ManifestISR     `json:"isr"`
	Middleware    *ManifestMiddle `json:"middleware,omitempty"`
	Images        *ManifestImages `json:"images,omitempty"`
	I18n          *ManifestI18n   `json:"i18n,omitempty"`
	HasAppRouter  bool            `json:"hasAppRouter"`
	OutputMode    string          `json:"outputMode,omitempty"`
	// Features is the app's detected capability surface. Runtime consults
	// this to decide which handlers to wire; operators can eyeball it to
	// confirm the deployed bundle actually supports what they expect.
	Features ManifestFeatures `json:"features"`
}

type ManifestFeatures struct {
	RSC           bool `json:"rsc"`               // any page or layout uses Server Components
	ServerActions bool `json:"serverActions"`     // any module carries action markers
	Middleware    bool `json:"middleware"`        // Edge-runtime middleware.ts present
	Proxy         bool `json:"proxy"`             // Node-runtime proxy.ts present (Next 15+)
	ISR           bool `json:"isr"`               // any route has ISR revalidation
	ImageOptimize bool `json:"imageOptimization"` // /_next/image is expected to work
	I18n          bool `json:"i18n"`              // locales declared
	PPR           bool `json:"ppr"`               // any page opts into Partial Prerendering
	After         bool `json:"after"`             // any module uses the after() API
}

type ManifestI18n struct {
	Locales         []string `json:"locales"`
	DefaultLocale   string   `json:"defaultLocale"`
	LocaleDetection bool     `json:"localeDetection"`
}

type ManifestISR struct {
	Tags      map[string][]string `json:"tags"`
	Intervals map[string]int      `json:"intervals"`
}

type ManifestImagePat struct {
	Protocol string `json:"protocol,omitempty"`
	Hostname string `json:"hostname,omitempty"`
	Port     string `json:"port,omitempty"`
	Pathname string `json:"pathname,omitempty"`
}

type ManifestImages struct {
	RemotePatterns []ManifestImagePat `json:"remotePatterns"`
	Domains        []string           `json:"domains,omitempty"`
	Formats        []string           `json:"formats,omitempty"`
	Unoptimized    bool               `json:"unoptimized,omitempty"`
}

type ManifestMiddle struct {
	Path     string              `json:"path"`
	Matchers []ManifestMiddleMat `json:"matchers"`
	Runtime  string              `json:"runtime,omitempty"`
}

type ManifestMiddleMat struct {
	Pathname string `json:"pathname,omitempty"`
	Pattern  string `json:"pattern,omitempty"`
}

type ManifestRoutes struct {
	Static     []string          `json:"static"`
	SSG        map[string]string `json:"ssg"` // route -> HTML path
	SSR        []string          `json:"ssr"`
	ISR        map[string]string `json:"isr"`
	API        []string          `json:"api"`
	Dynamic    []string          `json:"dynamic"`
	Fallback   map[string]string `json:"fallback"`
	Middleware []string          `json:"middleware"`
}

type MiddlewareConfig struct {
	Path     string
	Matchers []MiddlewareMatcher
	Runtime  string
}

type MiddlewareMatcher struct {
	Pathname string
	Pattern  string
}

type ModuleRef struct {
	// RoutePath is the user-facing URL (e.g. "/api/users" or "/dashboard/[id]").
	RoutePath string

	// Kind is what the dispatcher should do with this module.
	Kind RouteKind

	// CompiledPath is relative to StandaloneDir (e.g. "server/app/api/users/route.js").
	CompiledPath string

	// HasActions is true when Next's server-reference-manifest lists an
	// action ID rooted in this module.
	HasActions bool

	// UsesRSC is true when the compiled source contains Server Component
	// markers ("use client" boundaries or Flight-payload imports).
	UsesRSC bool

	// ClientManifestPath points at the Next-emitted
	// page_client-reference-manifest.json sibling, when present.
	// Relative to StandaloneDir. Used by rsc.mjs as Flight bundlerConfig.
	ClientManifestPath string

	// LayoutChain is the ordered list of compiled layout.js paths that
	// wrap this page, from root to nearest. Empty for non-page kinds.
	LayoutChain []string

	// EnvRefs are the unique process.env.X identifiers the compiler
	// found via lexical scan. Used by DeriveBindings to suggest secrets.
	EnvRefs []string

	// FetchTargets are literal fetch() URL prefixes extracted from the
	// module. Used to suggest KV/R2/D1/service bindings.
	FetchTargets []string

	// ByteSize is the raw size of the compiled source on disk.
	ByteSize int64

	// PPREnabled is true when Next compiled this page with Partial
	// Prerendering. The runtime dispatcher returns a clear 501 for now
	// since our renderer doesn't implement the static-shell / dynamic-
	// holes protocol yet.
	PPREnabled bool
}

type NextVersion struct {
	Major int
	Minor int
	Patch int
	Raw   string
}

type Payload struct {
	AppName      string
	DistDir      string
	OutputMode   string
	BasePath     string
	HasAppRouter bool
	Routes       RouteInfo
	Middleware   *MiddlewareConfig
	ImageConfig  *ImageConfig
	I18n         *I18nConfig
	BuildID      string
	GitCommit    string
}

type ReactVersion struct {
	Major int
	Minor int
	Patch int
	Raw   string
}

type RouteInfo struct {
	StaticRoutes     []string
	DynamicRoutes    []string
	SSGRoutes        map[string]string // route -> HTML path
	SSRRoutes        []string
	ISRRoutes        map[string]string
	ISRDetail        []ISRRoute
	APIRoutes        []string
	FallbackRoutes   map[string]string
	MiddlewareRoutes []string
}

type RouteKind string

type Target string

type VendoredPackage struct {
	Name       string
	Version    string
	SourcePath string
	TargetPath string
	Bytes      int64
	BuildKind  string // "production" | "development" | "legacy"
}