Documentation
¶
Overview ¶
Package column refines canonical view columns during explicit transcription. It delegates database metadata detection to SQLX and query rewriting to SQLParser; it owns no runtime scanner, cache, connector registry, or row map.
Index ¶
- func ApplyWriterMetadata(component *spec.Component) error
- func ValidateProjectionAnnotations(view *spec.View, projected []string) error
- type Compilation
- type Connections
- type DBResolver
- type Refiner
- func (r *Refiner) BeginCompilation() *Compilation
- func (r *Refiner) Refine(ctx context.Context, component *spec.Component, resources fs.FS, ...) error
- func (r *Refiner) RefineRoot(ctx context.Context, component *spec.Component, resources fs.FS, ...) error
- func (r *Refiner) RefineViews(ctx context.Context, component *spec.Component, resources fs.FS, ...) error
- func (r *Refiner) ValidateSourceProjections(component *spec.Component, resources fs.FS) error
- type TemplateInput
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ApplyWriterMetadata ¶
ApplyWriterMetadata promotes explicitly authored SQLX field metadata into the canonical facts required by mutation planning. It is intentionally called only by writer generation; readers neither require nor infer identity from author tags.
Types ¶
type Compilation ¶ added in v1.1.0
type Compilation struct {
// contains filtered or unexported fields
}
Compilation owns metadata for one compilation's root and independent views. Catalog/schema configuration must remain stable for each *sql.DB pool during compilation. View graphs are mutated by discovery and must not be shared by concurrent compilations. A Refiner may be shared if its resolver is safe for concurrent use.
func (*Compilation) RefineRoot ¶ added in v1.1.0
func (r *Compilation) RefineRoot(ctx context.Context, component *spec.Component, resources fs.FS, input *TemplateInput) error
RefineRoot discovers the root relation tree before generated input contracts are rebuilt for parameterized independent views.
func (*Compilation) RefineViews ¶ added in v1.1.0
func (r *Compilation) RefineViews(ctx context.Context, component *spec.Component, resources fs.FS, input *TemplateInput) error
RefineViews discovers independent view trees against the rebuilt typed input.
type Connections ¶
Connections is a static connector set suitable for command composition and tests. Production composition may supply its own DBResolver.
type DBResolver ¶
DBResolver resolves one configured connector for compile-time discovery.
type Refiner ¶
type Refiner struct {
// contains filtered or unexported fields
}
Refiner enriches canonical views with SQLX-discovered scalar columns.
func New ¶
func New(resolver DBResolver) *Refiner
func (*Refiner) BeginCompilation ¶ added in v1.1.0
func (r *Refiner) BeginCompilation() *Compilation
BeginCompilation starts isolated metadata reuse without retaining state on r. Discard the returned object when the compilation finishes, including failures.
func (*Refiner) RefineRoot ¶
func (r *Refiner) RefineRoot(ctx context.Context, component *spec.Component, resources fs.FS, input *TemplateInput) error
RefineRoot discovers a root relation tree with fresh metadata state. Use BeginCompilation to share metadata with a subsequent RefineViews call.
type TemplateInput ¶
type TemplateInput struct {
Const *constant.Values
Value reflect.Value
Variables []sqltemplate.Variable
ParameterResolver sqlx.ParameterResolver
Predicate exec.PredicateEvaluator
}
TemplateInput is the compile-time contract used to evaluate parameterized SQL before SQLX column discovery. It contains no request or runtime session.
Source Files