packagecompat

type Case struct {
	Name string
	// Path is the concrete request path, with query string if any.
	Path      string
	Body      []byte
	Principal pluginhostsdk.Principal
	// Seed writes the same data into each database.
	Seed func(t testing.TB, db *gorm.DB)
	// Snapshot returns the database state RunWrite compares after the
	// request; any JSON-encodable value.
	Snapshot func(t testing.TB, db *gorm.DB) any
	// Mask lists dotted JSON paths (for example "data.token") whose values
	// differ by design, such as tokens and secrets: they must exist on both
	// sides and are replaced before comparing.
	Mask []string
	// Headers lists response headers both sides must send.
	Headers []string
	// RequestHeaders are sent with the request: the legacy handler reads
	// them from it, the native one from the metadata the kernel forwards.
	RequestHeaders map[string]string
	// Host is the request's Host (default example.com) and TLS whether it
	// arrived over TLS: the legacy handler reads them from the request, the
	// native one from the request scheme and host the kernel sends.
	Host string
	TLS  bool
	// Warmup bodies are sent, in order, before the compared request.
	Warmup [][]byte
}

type Result struct {
	StatusCode int
	Body       []byte
	Header     http.Header
	State      any
}

type Route struct {
	// Method and Pattern are the gin registration, for example GET and
	// "/api/v2/user/knowledge/:id".
	Method  string
	Pattern string
	RouteID string
	// Legacy is the kernel's gin handler. It reads database.GetDB().
	Legacy gin.HandlerFunc
	// Native builds the package implementation on a database connection.
	Native func(db *gorm.DB) pluginhostsdk.NativeHandler
	// Models are migrated into both databases before Seed runs.
	Models []any
}

type SettingsGrants struct {
	Host         packagebridge.HostIdentity
	Capabilities []string
}