cassette

type Anchors struct {
	// Health is the cassette's liveness path.
	Health string

	// OpenAPI is where the cassette publishes its own document.
	OpenAPI string

	// Prefix is the normalized head the cassette mounts its API beneath,
	// empty when it mounts directly under its own name.
	Prefix string
}

type ContractVersion string

type Digest string

type GrantPlan struct {
	Role      string   `json:"role"`
	Schema    string   `json:"schema"`
	OwnSchema bool     `json:"own_schema"`
	Selects   []string `json:"selects,omitempty"`
	Tables    []string `json:"tables,omitempty"`

	// CoreSelects are the views this cassette publishes for core's read role
	// to SELECT — the reverse direction of Selects. Declaration only, exactly
	// like the rest of the plan: the deployment renders and applies the
	// grant, and tapes never verifies the view exists.
	CoreSelects []string `json:"core_selects,omitempty"`
}

type Manifest interface {
	// SchemaKind returns the manifest's kind string (i.e., "v1alpha1", "v1").
	SchemaKind() string

	// CassetteName returns the cassette's validated identity.
	CassetteName() Name

	// Anchors returns the paths the cassette serves on its own listener.
	Anchors() Anchors

	// Validate checks the manifest's intrinsic constraints, and checks its
	// declared contract dependency against the set the caller says it serves.
	// The supported set is a parameter rather than a package constant because
	// this package describes what a cassette declares about itself; which
	// contracts are actually served is a fact about a running core, and a
	// cassette must never have to know which core will mount it.
	Validate(supported []ContractVersion) error

	// MarshalCanonical returns the manifest's deterministic representation.
	MarshalCanonical() ([]byte, error)

	// Digest returns the identity of the canonical representation.
	Digest() (Digest, error)

	// GrantPlan returns the database access desired by deployment tooling.
	GrantPlan() GrantPlan
}

type Name string

type Problem struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

type ValidationError struct {
	// Subject names what failed validation. Empty means the cassette manifest,
	// so manifest validators need not set it; tapes config validation sets it
	// so one error shape can serve every document
	// without every message claiming to be about a manifest.
	Subject  string    `json:"subject,omitempty"`
	Problems []Problem `json:"problems"`
}

type Version string