inspect

type App struct {
	Name     string `json:"name"`
	Module   string `json:"module"`
	Template string `json:"template"`
	// Dir is the absolute project root.
	Dir string `json:"dir"`
}

type Context struct {
	Generated time.Time `json:"generated"`
	// Lidza is the framework version that produced the dump.
	Lidza string `json:"lidza"`
	App   App    `json:"app"`
	// Routes lists every registration found in the source, typed or not.
	Routes []Route `json:"routes"`
	// Operations are the typed routes with their schemas; Schemas holds the
	// JSON Schema components they reference.
	Operations []Operation    `json:"operations"`
	Schemas    map[string]any `json:"schemas"`
	Rust       *Rust          `json:"rust,omitempty"`
	// Warnings are type-check errors: the operations may be incomplete
	// until they are fixed.
	Warnings []string `json:"warnings,omitempty"`
}

type Export struct {
	Name      string `json:"name"`
	File      string `json:"file"`
	Line      int    `json:"line"`
	Signature string `json:"signature"`
}

type Handler struct {
	// Name is the function name, "pkg.Func" for one from another package,
	// or "func literal" for an inline handler.
	Name string `json:"name"`
	// File and Line point at the registration for literals and at the
	// declaration for named functions. File is relative to the project root.
	File      string `json:"file,omitempty"`
	Line      int    `json:"line,omitempty"`
	Signature string `json:"signature,omitempty"`
}

type Operation struct {
	// ID is the operationId and the client method name: the handler's name
	// in lowerCamel, or method plus path for a func literal.
	ID     string `json:"id"`
	Method string `json:"method"`
	Path   string `json:"path"`
	// Params are the path parameters, in order.
	Params []string `json:"params"`
	// Input and Output name the component schema (empty for router.None).
	// For a stream, Output is the schema of one event.
	Input  string `json:"input,omitempty"`
	Output string `json:"output,omitempty"`
	// Stream marks a router.Stream operation: the reply is server-sent
	// events, each one Output as JSON.
	Stream bool `json:"stream,omitempty"`
	// Upload marks a router.Route whose In is router.File: the request
	// body is a file sent raw, not JSON, and Input is empty.
	Upload  bool    `json:"upload,omitempty"`
	Handler Handler `json:"handler"`
	// Builtin marks operations the framework registers in every app.
	Builtin bool `json:"builtin,omitempty"`
	// Pack names the framework pack whose Mount registered the operation
	// (auth for the sign-in routes); empty for the app's own.
	Pack string `json:"pack,omitempty"`
}

type Route struct {
	// Method is empty when the pattern matches every method.
	Method string `json:"method,omitempty"`
	Path   string `json:"path"`
	// Pattern is the net/http ServeMux pattern as written.
	Pattern string  `json:"pattern"`
	Handler Handler `json:"handler"`
	// Builtin marks routes the framework registers in every app.
	Builtin bool `json:"builtin,omitempty"`
	// Typed marks routes registered with router.Route or router.Stream;
	// their schemas are in Context.Operations.
	Typed bool `json:"typed,omitempty"`
	// Pack names the framework pack whose Mount registered the route.
	Pack string `json:"pack,omitempty"`
}

type Rust struct {
	Crate string `json:"crate"`
	// Dir is the crate directory relative to the project root.
	Dir     string   `json:"dir"`
	Exports []Export `json:"exports"`
}