cache

type Catalog struct {
	Format   int     `json:"format"`
	SchemaFP string  `json:"schema_fp"`
	Tables   []Table `json:"tables"`
}

type Column struct {
	Name       string `json:"name"`
	Att        int16  `json:"att"`
	TypeOID    uint32 `json:"type_oid"`
	TypeName   string `json:"type_name"`
	NotNull    bool   `json:"not_null"`
	HasDefault bool   `json:"has_default"`
}

type EntryColumn struct {
	Name     string `json:"name"`
	OID      uint32 `json:"oid"`
	TypeName string `json:"type_name"`
	// TypeSchema/TypeKind/TypeLabels mirror EntryType's
	// user-defined-type fields for the column's type.
	TypeSchema string   `json:"type_schema,omitempty"`
	TypeKind   string   `json:"type_kind,omitempty"`
	TypeLabels []string `json:"type_labels,omitempty"`
	SrcRel     uint32   `json:"src_rel,omitempty"`
	SrcAtt     int16    `json:"src_att,omitempty"`
}

type EntryType struct {
	OID    uint32   `json:"oid"`
	Name   string   `json:"name"`
	Schema string   `json:"schema,omitempty"`
	Kind   string   `json:"kind,omitempty"`
	Labels []string `json:"labels,omitempty"`
}

type Env struct {
	Format   int    `json:"format"`
	SchemaFP string `json:"schema_fp"`
	// Dialect and OracleBackend are recorded for forensics only. The
	// dialect is already fingerprint input, and the backend is
	// deliberately NOT compared: server and native backends are
	// required to produce byte-identical output, so a backend
	// difference is either a no-op or a sqletch bug for the corpus
	// gates to catch — never a reason to fail a user's build.
	Dialect       string `json:"dialect"`
	OracleBackend string `json:"oracle_backend"`
	// ServerVersion is the compared value: the leading dotted-numeric
	// run of what the server reported (see NumericVersionPrefix).
	ServerVersion string `json:"server_version"`
	// ServerVersionRaw is the full reported string, kept so the
	// diagnostic can name the actual builds involved.
	ServerVersionRaw string `json:"server_version_raw"`
}

type OracleEntry struct {
	Format      int           `json:"format"`
	SchemaFP    string        `json:"schema_fp"`
	RenderedSQL string        `json:"rendered_sql"`
	Params      []EntryType   `json:"params"`
	Columns     []EntryColumn `json:"columns"`
}

type OracleRef struct {
	Target string // config.ResolvedTarget.Slug(); may contain '/'
	Query  string
	Shape  string // ast.Rendering.Shape
}

type SchemaFile struct {
	Path    string
	Content []byte
}

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

type SymlinkError struct {
	Dir string // the cache directory
	Rel string // the offending component, store-relative, slash form
}

type Table struct {
	Schema string `json:"schema"`
	Name   string `json:"name"`
	OID    uint32 `json:"oid"`
	// HasChildren marks a plain-inheritance parent (PostgreSQL:
	// relhassubclass on relkind 'r'). Children may DROP an inherited
	// NOT NULL (proven on PG 16), so a parent scan can return NULL
	// where attnotnull says otherwise — the analyzer must not narrow
	// such tables unless the reference is `FROM ONLY`. Partitioned
	// parents ('p') are exempt: partitions cannot drop inherited NOT
	// NULL (42P16). omitempty keeps every inheritance-free catalog
	// byte-identical.
	HasChildren bool `json:"has_children,omitempty"`
	// IsView marks a relation that is a VIEW rather than a base table.
	// SQLite's column-origin attribution (sqlite3_column_origin_name)
	// resolves a view's result columns THROUGH to the view's base
	// tables, whose declared NOT NULL the view's (invisible, possibly
	// null-extending) body need not preserve — so a base table appearing
	// directly in FROM must not be allowed to vouch for a column that
	// actually flows through a view. The nullability analyzer treats any
	// view in play as a wholesale narrowing kill-switch. The PostgreSQL
	// (relkind v/m) and MySQL server (table_type VIEW) snapshots record it
	// too (their view-provenance fix), and design 20 relies on it on
	// every dialect: a view's column NOT NULL does not carry its base
	// column's constraint, so a write into a view never derives a
	// nullable parameter. The native MySQL catalog refuses CREATE VIEW.
	// omitempty keeps view-free catalogs byte-identical.
	IsView bool     `json:"is_view,omitempty"`
	Cols   []Column `json:"cols"`
}