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
	// Fallback is set when the native side must answer from the legacy
	// handler (RunKernelRead, RunKernelWrite): the route cannot serve the
	// request natively, for example before the node credential split is
	// finalized.
	Fallback bool
}

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

type KernelHostRoute struct {
	Method, Pattern, RouteID string
	// Legacy is the kernel's handler, which the host relays to.
	Legacy gin.HandlerFunc
	// Native builds the package's handler with the host's KernelNodeOps
	// client.
	Native func(nodeOps kernelnodeopsv1.KernelNodeOpsClient) pluginhostsdk.NativeHandler
}

type KernelOptions struct {
	// DB is the kernel database the engine records in.
	DB        *gorm.DB
	PackageID string
	// Capabilities are the KernelNodeOps capabilities the package holds.
	Capabilities []string
	// Agents are the agent sessions the executors and session RPCs read.
	Agents kernelnodeops.SourcesFunc
	// Routes are the package's routes, each in native mode.
	Routes []KernelHostRoute
}

type KernelRoute struct {
	Route
	// PackageID is the route's package.
	PackageID string
	// Capabilities are the KernelNodeOps capabilities the package's signed
	// release declares (kernel.nodeops.<family>.v1).
	Capabilities []string
	// NativeService builds the package's native handler on the native
	// database, with the host's KernelNodeOps client.
	NativeService func(db *gorm.DB, nodeOps kernelnodeopsv1.KernelNodeOpsClient) pluginhostsdk.NativeHandler
	// Agents are the agent sessions the kernel's executors and session RPCs
	// read; nil reads none.
	Agents kernelnodeops.SourcesFunc
}

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
}