conformance

type Backend interface {
	// Name identifies the backend in subtest names and skip reasons, e.g.
	// "fake", "postgres", "falkordb", "elasticsearch".
	Name() string

	// Capabilities are the behaviors this backend supports exactly.
	Capabilities() CapabilitySet

	// Setup returns a fresh, isolated environment for ONE case. The backend
	// registers its own t.Cleanup. Isolation is by unique tenant; no
	// truncation is required.
	Setup(t *testing.T) *Env
}

type BlobCase struct {
	Name     string
	Requires []Capability
	Run      func(t *testing.T, env *Env)
}

type Capability string

type CapabilitySet map[Capability]bool

type Degradation struct {
	// ExpectErrIs requires errors.Is(err, ExpectErrIs).
	ExpectErrIs error
	// ExpectErrContains requires the error message to contain this substring.
	ExpectErrContains string
}

type Env struct {
	Ctx         context.Context         // unique primary tenant for this case
	ForeignCtx  context.Context         // a second, distinct tenant over the same store
	Registry    *registry.Registry      // domain.RegisterAll(reg)
	Exec        *command.Executor       // write path; nil → command/store suite skips
	Relational  query.RelationalQuerier // nil → relational suite skips
	Graph       query.GraphQuerier
	Search      query.SearchQuerier
	Vector      query.VectorQuerier
	Spatial     query.SpatialQuerier
	TS          query.TSQuerier
	Projection  projection.StateReader
	Blob        blob.Store // nil → blob suite skips
	GraphTarget string     // fresh graph/projection target for this case
	// EmbeddingDim is the dimension required by the vector store.
	// 0 means "no fixed dimension" (the fake accepts any size; RunVector uses
	// 3-dimensional test vectors). Set to 768 for the postgres backend, which
	// enforces the schema-declared vector(768) column.
	EmbeddingDim int
}

type RelationalCase struct {
	Name     string
	Requires []Capability // capabilities the happy path needs
	Degrade  *Degradation // when a Required capability is absent, assert this instead of skipping
	Seed     []SeedAsset
	// Run executes the read under test. ids maps SeedAsset.Name -> minted id.
	Run       func(env *Env, ids map[string]string) ([]*domain.Asset, error)
	WantNames []string // expected asset Names, in order
}

type SeedAsset struct {
	Name, Kind, Serial, SiteID string
}