typebootstrap

type Config struct {
	// Resources lists every watched-resource entry to type-resolve.
	// Order doesn't matter; results are keyed by [Resource.Name].
	Resources []Resource

	// GlobalIgnoreFields is the cluster-wide ignore list (from
	// HAProxyTemplateConfig.spec.watchedResourcesIgnoreFields).
	// Each per-resource Bootstrap call merges this with the
	// resource's own [Resource.IgnoreFields] before invoking
	// typegen.
	GlobalIgnoreFields []string

	// Fetcher is the schema-acquisition strategy. Production wires
	// this to [schemafetcher.NewClusterFetcher]; tests use a
	// [schemafetcher.MapFetcher] with pre-baked schemas.
	Fetcher schemafetcher.Fetcher

	// Logger receives the structured error log for the resource
	// whose schema acquisition failed. Required — bootstrap is the
	// only surface that observes per-resource schema problems
	// before they abort iteration startup, so operators need
	// visibility into which resource (and why) caused the failure.
	Logger *slog.Logger
}

type OfflineGVKResolver struct {
	// contains filtered or unexported fields
}

type Resource struct {
	// Name is the user-defined identifier templates use to reach
	// this resource — the same key that appears as
	// `resources.<Name>` in chart templates.
	Name string

	// GVK is the fully-resolved (Group, Version, Kind) triple. The
	// caller is responsible for translating the CRD-side
	// (apiVersion, resources-plural) form into Kind via a
	// RESTMapper before handing the resource to typebootstrap;
	// this keeps the package free of REST-mapping deps.
	GVK schema.GroupVersionKind

	// IgnoreFields is the per-resource ignore list. Merged with
	// [Config.GlobalIgnoreFields] before being passed to typegen,
	// matching the merge the resourcewatcher does for its runtime
	// FieldFilter (pkg/controller/resourcewatcher/watcher.go
	// `mergeIgnoreFields`). Order of the inputs doesn't matter —
	// typegen deduplicates effectively by storing patterns in a
	// set.
	IgnoreFields []string
}

type Result struct {
	// Types maps the resource's user-defined name to its generated
	// Go type. Pass these to [BuildEngineDeclarations] to produce
	// the engine's additionalDeclarations map.
	Types map[string]reflect.Type

	// Kinds maps the resource's user-defined name to the GVK.Kind
	// string captured from cfg.Resources. Used by
	// [BuildEngineDeclarations] to name the per-resource type
	// declarations (one per watched Kind — e.g. for a CRD named
	// `Widget` the declaration is `Widget`) at engine-declaration
	// time so chart authors can write typed macro signatures
	// (`(w *Widget)`, `(items []*Widget)`) instead of `any`/`[]any`.
	//
	// The Kind is the canonical singular noun for the resource —
	// K8s naming preserves acronyms (HTTPRoute, BackendTLSPolicy)
	// which reads more naturally in chart macros than the
	// PascalCase-of-resource-key form (Httproutes,
	// Backendtlspolicies). Multiple watched resources sharing a
	// Kind (e.g. `services` and `controller_services` both → Kind
	// "Service") deduplicate to a single type declaration; the
	// chart picks up the shared declaration regardless of which
	// watched-resource key carries the schema.
	Kinds map[string]string

	// Errors records why a resource didn't get a typed view.
	// Bootstrap is fail-closed (see Bootstrap doc): the first
	// per-resource failure aborts the run, so Errors typically
	// has at most one entry — but defensively it's a map so
	// downstream code that wants to enumerate is uniform with
	// successful runs.
	Errors map[string]error
}