wardenseed

type ApplyOptions struct {
	// SharedOverride, when set, replaces the embedded shared source.
	// Used by extension config (cfg.WardenDir) to let operators ship
	// custom .warden files without rebuilding the binary. Applies to
	// every app (platform + non-platform).
	SharedOverride *Source

	// PlatformOverride, when set, replaces the embedded platform
	// source. Only consulted when ApplyForApp is called with
	// isPlatform=true.
	PlatformOverride *Source

	// DryRun forwards to dsl.ApplyOptions.DryRun. When true, no writes
	// hit the warden store; the result still reports what *would* have
	// changed.
	DryRun bool
}

type LoadOptions struct {
	// AppID is substituted for ${APP_ID} placeholders in source files.
	// Required when sources contain `tenant ${APP_ID}` headers.
	AppID string

	// ExtraVars is merged into the variable map after AppID. Lets
	// callers add additional substitutions without losing AppID.
	ExtraVars map[string]string
}

type Source struct {
	// EmbedRoot uses the package-embedded FS at the given subpath
	// (e.g. embedSharedRoot or embedPlatformRoot). Most callers use
	// the convenience constructors SharedSource / PlatformSource.
	EmbedRoot string

	// FS + Root override the embedded FS with a caller-supplied one.
	// Useful for tests and custom deployments.
	FS   fs.FS
	Root string

	// Dir loads from the local filesystem. Takes precedence over the
	// embed FS when set. Used for the operator override path
	// (cfg.WardenDir).
	Dir string
}