dev

type AppStatus struct {
	Status string `json:"status"` // "running", "building", "error", "starting"
	Port   int    `json:"port,omitempty"`
	Error  string `json:"error,omitempty"`
	Phase  string `json:"phase,omitempty"` // "prebuild", "build", "runtime"
}

type Cmd struct {
	RPCDir string `help:"Directory containing generated RPC files." default:"./src/rpc" name:"rpc-dir"`
	Port   int    `help:"Port to listen on." default:"9000" short:"p"`
	Watch  bool   `help:"Watch for file changes." short:"w"`
}

type DiscoverySchema struct {
	Package  PackageInfo         `json:"Package"`
	Types    []TypeDescriptor    `json:"Types"`
	Services []ServiceDescriptor `json:"Services"`
	Warnings []Warning           `json:"Warnings,omitempty"`
}

type Documentation struct {
	Summary    string  `json:"Summary,omitempty"`
	Body       string  `json:"Body,omitempty"`
	Deprecated *string `json:"Deprecated,omitempty"`
}

type EndpointDescriptor struct {
	Name      string   `json:"name"`
	FullName  string   `json:"fullName"`
	Primitive string   `json:"primitive"` // "query", "exec", "stream", or "atom"
	Path      string   `json:"path"`
	Request   *TypeRef `json:"request,omitempty"`
	Response  *TypeRef `json:"response,omitempty"`
	Doc       string   `json:"doc,omitempty"`
}

type EnumMember struct {
	Name  string `json:"name"`
	Value any    `json:"value"` // string, int64, or float64
	Doc   string `json:"doc,omitempty"`
}

type FieldDescriptor struct {
	Name          string  `json:"name"`
	Type          TypeRef `json:"type"`
	JSONName      string  `json:"jsonName"`
	Optional      bool    `json:"optional,omitempty"`
	StringEncoded bool    `json:"stringEncoded,omitempty"`
	Skip          bool    `json:"skip,omitempty"`
	ValidateTag   string  `json:"validateTag,omitempty"`
	Doc           string  `json:"doc,omitempty"`
}

type GetDiscoveryRequest struct{}

type GetDiscoveryResponse struct {
	// Discovery is the parsed discovery schema.
	Discovery DiscoverySchema `json:"discovery"`
}

type GetSourceRequest struct {
	File    string `json:"file"`
	Line    int    `json:"line,omitempty"`
	Context int    `json:"context,omitempty"` // lines of context around Line (default 5)
}

type GetSourceResponse struct {
	File     string       `json:"file"`
	Language string       `json:"language"`
	Lines    []SourceLine `json:"lines"`
	Context  int          `json:"context"`
}

type GetStatusRequest struct{}

type GetStatusResponse struct {
	Status   string   `json:"status"`
	Port     int      `json:"port,omitempty"`
	Error    string   `json:"error,omitempty"`
	Phase    string   `json:"phase,omitempty"` // "prebuild", "build", "runtime"
	Command  *string  `json:"command"`         // null when not applicable
	Cwd      string   `json:"cwd,omitempty"`
	ExitCode *int     `json:"exitCode"`           // null when not applicable
	RawrData []string `json:"rawrData,omitempty"` // sent on initial request
}

type GoIdentifier struct {
	Name    string `json:"name"`
	Package string `json:"package,omitempty"`
}

type PackageInfo struct {
	Path string `json:"Path"`
	Name string `json:"Name"`
	Dir  string `json:"Dir"`
}

type ReloadRequest struct {
	Files  []string `json:"files,omitempty"`
	Reason string   `json:"reason,omitempty"` // "file_change", "manual"
}

type ReloadResponse struct{}

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

type ServiceDescriptor struct {
	Name      string               `json:"name"`
	Endpoints []EndpointDescriptor `json:"endpoints"`
	Doc       string               `json:"doc,omitempty"`
}

type SourceLine struct {
	Num       int    `json:"num"`
	Content   string `json:"content"`
	Highlight bool   `json:"highlight,omitempty"`
}

type SourceLocation struct {
	File   string `json:"File"`
	Line   int    `json:"Line"`
	Column int    `json:"Column"`
}

type TypeDescriptor struct {
	Kind           string            `json:"kind"` // "struct", "enum", "alias"
	Name           GoIdentifier      `json:"Name"`
	TypeParameters []TypeParameter   `json:"TypeParameters,omitempty"`
	Fields         []FieldDescriptor `json:"Fields,omitempty"`     // for struct
	Members        []EnumMember      `json:"Members,omitempty"`    // for enum
	Underlying     *TypeRef          `json:"Underlying,omitempty"` // for alias
	Extends        []GoIdentifier    `json:"Extends,omitempty"`
	Documentation  *Documentation    `json:"Documentation,omitempty"`
	Source         *SourceLocation   `json:"Source,omitempty"`
}

type TypeParameter struct {
	Kind       string   `json:"kind"` // "typeParameter"
	ParamName  string   `json:"paramName"`
	Constraint *TypeRef `json:"constraint,omitempty"`
}

type TypeRef struct {
	Kind          string    `json:"kind"`                    // "primitive", "reference", "array", "map", "ptr", "union", "typeParameter"
	PrimitiveKind string    `json:"primitiveKind,omitempty"` // for primitive
	BitSize       int       `json:"bitSize,omitempty"`       // for numeric primitives
	Name          string    `json:"name,omitempty"`          // for reference
	Package       string    `json:"package,omitempty"`       // for reference
	Element       *TypeRef  `json:"element,omitempty"`       // for array, ptr
	Length        int       `json:"length,omitempty"`        // for array (0 = slice)
	Key           *TypeRef  `json:"key,omitempty"`           // for map
	Value         *TypeRef  `json:"value,omitempty"`         // for map
	Types         []TypeRef `json:"types,omitempty"`         // for union
	ParamName     string    `json:"paramName,omitempty"`     // for typeParameter
	Constraint    *TypeRef  `json:"constraint,omitempty"`    // for typeParameter
}

type UpdateStatusRequest struct {
	App AppStatus `json:"app"`
}

type UpdateStatusResponse struct{}

type Warning struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}