rest

type AddDescriptorsResponse struct {
	Message string `json:"message"`

	// ServiceIDs Service IDs (e.g. helloworld.Greeter) registered. Use DELETE /services/{serviceID} to remove.
	ServiceIDs []string  `json:"serviceIDs"`
	Time       time.Time `json:"time"`
}

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

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

type AddStubJSONRequestBody AddStubJSONBody

type BatchStubsDeleteJSONRequestBody = ListID

type CallRecord struct {
	// Code gRPC status code (e.g., 0 for OK, 5 for NotFound)
	Code *int `json:"code,omitempty"`

	// ElapsedMs Handler duration in milliseconds
	ElapsedMs *int64  `json:"elapsedMs,omitempty"`
	Error     *string `json:"error,omitempty"`
	Method    *string `json:"method,omitempty"`

	// Request Deprecated: use requests for streaming calls
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	Request *map[string]any `json:"request,omitempty"`

	// Requests Request messages for streaming calls (client stream, bidi stream)
	Requests *[]map[string]any `json:"requests,omitempty"`

	// Response Deprecated: use responses for streaming calls
	// Deprecated: this property has been marked as deprecated upstream, but no `x-deprecated-reason` was set
	Response *map[string]any `json:"response,omitempty"`

	// Responses Response messages for streaming calls (server stream, bidi stream)
	Responses *[]map[string]any `json:"responses,omitempty"`
	Service   *string           `json:"service,omitempty"`

	// Session Session ID (empty = global)
	Session *string `json:"session,omitempty"`

	// StubId Stub identifier
	StubId    *uuid.UUID `json:"stubId,omitempty"`
	Timestamp *time.Time `json:"timestamp,omitempty"`
}

type Dashboard struct {
	AppName  string `json:"appName"`
	Compiler string `json:"compiler"`

	// CoveredMethods Number of gRPC methods that have at least one stub
	CoveredMethods int `json:"coveredMethods,omitempty"`

	// GatewayAddr ConnectRPC + gRPC-web listen address
	GatewayAddr string `json:"gatewayAddr,omitempty"`
	GoVersion   string `json:"goVersion"`
	Goarch      string `json:"goarch"`
	Goos        string `json:"goos"`

	// GrpcAddr Native gRPC listen address
	GrpcAddr       string `json:"grpcAddr,omitempty"`
	HistoryEnabled bool   `json:"historyEnabled"`
	HistoryErrors  int    `json:"historyErrors"`

	// HttpAddr Admin REST API + UI listen address
	HttpAddr           string    `json:"httpAddr,omitempty"`
	NumCPU             int       `json:"numCPU"`
	Ready              bool      `json:"ready"`
	RuntimeDescriptors int       `json:"runtimeDescriptors"`
	StartedAt          time.Time `json:"startedAt"`
	TotalHistory       int       `json:"totalHistory"`

	// TotalMethods Total number of gRPC methods across all services
	TotalMethods  int    `json:"totalMethods,omitempty"`
	TotalServices int    `json:"totalServices"`
	TotalSessions int    `json:"totalSessions"`
	TotalStubs    int    `json:"totalStubs"`
	UnusedStubs   int    `json:"unusedStubs"`
	UptimeSeconds int    `json:"uptimeSeconds"`
	UsedStubs     int    `json:"usedStubs"`
	Version       string `json:"version"`
}

type DashboardInfo struct {
	AppName            string    `json:"appName"`
	Compiler           string    `json:"compiler"`
	GoVersion          string    `json:"goVersion"`
	Goarch             string    `json:"goarch"`
	Goos               string    `json:"goos"`
	HistoryEnabled     bool      `json:"historyEnabled"`
	NumCPU             int       `json:"numCPU"`
	Ready              bool      `json:"ready"`
	RuntimeDescriptors int       `json:"runtimeDescriptors"`
	StartedAt          time.Time `json:"startedAt"`
	TotalServices      int       `json:"totalServices"`
	TotalSessions      int       `json:"totalSessions"`
	TotalStubs         int       `json:"totalStubs"`
	UptimeSeconds      int       `json:"uptimeSeconds"`
	Version            string    `json:"version"`
}

type DashboardOverview struct {
	// CoveredMethods Number of gRPC methods that have at least one stub
	CoveredMethods int `json:"coveredMethods,omitempty"`

	// GatewayAddr ConnectRPC + gRPC-web listen address
	GatewayAddr string `json:"gatewayAddr,omitempty"`

	// GrpcAddr Native gRPC listen address
	GrpcAddr      string `json:"grpcAddr,omitempty"`
	HistoryErrors int    `json:"historyErrors"`

	// HttpAddr Admin REST API + UI listen address
	HttpAddr           string `json:"httpAddr,omitempty"`
	RuntimeDescriptors int    `json:"runtimeDescriptors"`
	TotalHistory       int    `json:"totalHistory"`

	// TotalMethods Total number of gRPC methods across all services
	TotalMethods  int `json:"totalMethods,omitempty"`
	TotalServices int `json:"totalServices"`
	TotalSessions int `json:"totalSessions"`
	TotalStubs    int `json:"totalStubs"`
	UnusedStubs   int `json:"unusedStubs"`
	UsedStubs     int `json:"usedStubs"`
}

type DescriptorServiceIDs struct {
	// ServiceIDs Service IDs added via POST /descriptors
	ServiceIDs []string `json:"serviceIDs"`
}

type GorillaServerOptions struct {
	BaseURL          string
	BaseRouter       *mux.Router
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type HistoryList = []CallRecord

type ID = uuid.UUID

type InspectCandidate struct {
	Events           []InspectCandidateEvent `json:"events"`
	ExcludedBy       []string                `json:"excludedBy"`
	HeadersMatched   bool                    `json:"headersMatched"`
	Id               string                  `json:"id"`
	InputMatched     bool                    `json:"inputMatched"`
	Matched          bool                    `json:"matched"`
	Method           string                  `json:"method"`
	Priority         int                     `json:"priority"`
	Score            float64                 `json:"score"`
	Service          string                  `json:"service"`
	Session          string                  `json:"session"`
	Specificity      int                     `json:"specificity"`
	Times            int                     `json:"times"`
	Used             int                     `json:"used"`
	VisibleBySession bool                    `json:"visibleBySession"`
	WithinTimes      bool                    `json:"withinTimes"`
}

type InspectCandidateEvent struct {
	Reason *string `json:"reason,omitempty"`
	Result string  `json:"result"`
	Stage  string  `json:"stage"`
}

type InspectReport struct {
	Candidates       []InspectCandidate `json:"candidates"`
	Error            string             `json:"error"`
	FallbackToMethod bool               `json:"fallbackToMethod"`
	MatchedStubId    string             `json:"matchedStubId"`
	Method           string             `json:"method"`
	Service          string             `json:"service"`
	Session          string             `json:"session"`
	SimilarStubId    string             `json:"similarStubId"`
	Stages           []InspectStage     `json:"stages"`
}

type InspectRequest struct {
	Headers map[string]any `json:"headers,omitempty"`

	// Id Example: 51c50050-ec27-4dae-a583-a32ca71a1dd5
	Id      *ID              `json:"id,omitempty"`
	Input   []map[string]any `json:"input,omitempty"`
	Method  string           `json:"method"`
	Service string           `json:"service"`
	Session *string          `json:"session,omitempty"`
}

type InspectStage struct {
	After   int    `json:"after"`
	Before  int    `json:"before"`
	Name    string `json:"name"`
	Removed int    `json:"removed"`
}

type InspectStubsJSONRequestBody = InspectRequest

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type ListHistoryParams struct {
	// Limit Return at most N most-recent records
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Skip the N newest records (page backward through older calls)
	Offset  *int    `form:"offset,omitempty" json:"offset,omitempty"`
	Service *string `form:"service,omitempty" json:"service,omitempty"`
	Method  *string `form:"method,omitempty" json:"method,omitempty"`

	// Error When true, return only calls that ended with a gRPC error
	Error *bool `form:"error,omitempty" json:"error,omitempty"`
}

type ListID = []ID

type ListStubsParams struct {
	// Source Filter by source (file, rest, mcp, proxy)
	Source *string `form:"source,omitempty" json:"source,omitempty"`

	// Service Filter by service name (exact match)
	Service *string `form:"service,omitempty" json:"service,omitempty"`

	// Method Filter by method name (exact match)
	Method *string `form:"method,omitempty" json:"method,omitempty"`

	// Session Filter by session ID (empty means global stubs)
	Session *string `form:"session,omitempty" json:"session,omitempty"`

	// Q Case-insensitive substring search over service, method and stub ID
	Q *string `form:"q,omitempty" json:"q,omitempty"`

	// Matcher Filter by matcher kind(s) present on the stub input. Comma-separated for OR semantics (e.g. "glob,anyOf"). Valid kinds: equals, contains, matches, glob, anyOf.
	Matcher *string `form:"matcher,omitempty" json:"matcher,omitempty"`

	// Limit Maximum number of returned stubs
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Offset Number of stubs to skip before returning results
	Offset *int `form:"offset,omitempty" json:"offset,omitempty"`

	// Sort Sort order for result list
	Sort *string `form:"sort,omitempty" json:"sort,omitempty"`
}

type MessageOK struct {
	Message string    `json:"message"`
	Time    time.Time `json:"time"`
}

type Method struct {
	// ClientStreaming Indicates client-side streaming method
	ClientStreaming bool   `json:"clientStreaming,omitempty"`
	Id              string `json:"id"`

	// MethodType gRPC method interaction type
	MethodType    MethodMethodType    `json:"methodType"`
	Name          string              `json:"name"`
	RequestSchema *ProtoMessageSchema `json:"requestSchema,omitempty"`

	// RequestType Fully-qualified protobuf request message type
	RequestType    *string             `json:"requestType,omitempty"`
	ResponseSchema *ProtoMessageSchema `json:"responseSchema,omitempty"`

	// ResponseType Fully-qualified protobuf response message type
	ResponseType *string `json:"responseType,omitempty"`

	// ServerStreaming Indicates server-side streaming method
	ServerStreaming bool `json:"serverStreaming,omitempty"`
}

type MethodMethodType string

type MiddlewareFunc func(http.Handler) http.Handler

type ProtoFieldSchema struct {
	Cardinality      ProtoFieldSchemaCardinality `json:"cardinality"`
	EnumValues       *[]string                   `json:"enumValues,omitempty"`
	JsonName         string                      `json:"jsonName"`
	Kind             string                      `json:"kind"`
	Map              bool                        `json:"map,omitempty"`
	MapKeyKind       *string                     `json:"mapKeyKind,omitempty"`
	MapValueKind     *string                     `json:"mapValueKind,omitempty"`
	MapValueMessage  *ProtoMessageSchema         `json:"mapValueMessage,omitempty"`
	MapValueTypeName *string                     `json:"mapValueTypeName,omitempty"`
	Message          *ProtoMessageSchema         `json:"message,omitempty"`
	Name             string                      `json:"name"`
	Number           int                         `json:"number"`

	// Oneof Oneof group name if field belongs to oneof
	Oneof *string `json:"oneof,omitempty"`

	// TypeName Referenced protobuf type for message/enum fields
	TypeName *string `json:"typeName,omitempty"`
}

type ProtoFieldSchemaCardinality string

type ProtoMessageSchema struct {
	Fields []ProtoFieldSchema `json:"fields"`

	// RecursiveRef True when schema expansion stopped due to recursive reference
	RecursiveRef bool `json:"recursiveRef,omitempty"`

	// TypeName Fully-qualified protobuf message type name
	TypeName string `json:"typeName"`
}

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type SearchRequest struct {
	Data    any               `json:"data"`
	Headers map[string]string `json:"headers,omitempty"`

	// Id Example: 51c50050-ec27-4dae-a583-a32ca71a1dd5
	Id *ID `json:"id,omitempty"`

	// Method Example: SayHello
	Method string `json:"method"`

	// Service Example: Gripmock
	Service string `json:"service"`
}

type SearchResponse struct {
	// Code Example: 3
	Code codes.Code `json:"code,omitempty"`
	Data any        `json:"data"`

	// Error Example: Message not found
	Error   string            `json:"error"`
	Headers map[string]string `json:"headers,omitempty"`
}

type SearchStubsJSONRequestBody = SearchRequest

type ServerInterface interface {
	// Dashboard Dashboard aggregate payload
	// (GET /dashboard)
	Dashboard(w http.ResponseWriter, r *http.Request)
	// DashboardInfo Dashboard runtime and build info
	// (GET /dashboard/info)
	DashboardInfo(w http.ResponseWriter, r *http.Request)
	// DashboardOverview Dashboard overview metrics
	// (GET /dashboard/overview)
	DashboardOverview(w http.ResponseWriter, r *http.Request)
	// ListDescriptors List service IDs from REST-added descriptors
	// (GET /descriptors)
	ListDescriptors(w http.ResponseWriter, r *http.Request)
	// AddDescriptors Upload FileDescriptorSet
	// (POST /descriptors)
	AddDescriptors(w http.ResponseWriter, r *http.Request)
	// Liveness Liveness check
	// (GET /health/liveness)
	Liveness(w http.ResponseWriter, r *http.Request)
	// Readiness Readiness check
	// (GET /health/readiness)
	Readiness(w http.ResponseWriter, r *http.Request)
	// ListHistory Get call history
	// (GET /history)
	ListHistory(w http.ResponseWriter, r *http.Request, params ListHistoryParams)
	// ServicesList Services
	// (GET /services)
	ServicesList(w http.ResponseWriter, r *http.Request)
	// DeleteService Remove service
	// (DELETE /services/{serviceID})
	DeleteService(w http.ResponseWriter, r *http.Request, serviceID string)
	// ServiceGet Service details
	// (GET /services/{serviceID})
	ServiceGet(w http.ResponseWriter, r *http.Request, serviceID string)
	// ServiceMethodsList Service methods
	// (GET /services/{serviceID}/methods)
	ServiceMethodsList(w http.ResponseWriter, r *http.Request, serviceID string)
	// ServiceMethodGet Service method details
	// (GET /services/{serviceID}/methods/{methodID})
	ServiceMethodGet(w http.ResponseWriter, r *http.Request, serviceID string, methodID string)
	// SessionsList Session options
	// (GET /sessions)
	SessionsList(w http.ResponseWriter, r *http.Request)
	// PurgeStubs Remove all stubs
	// (DELETE /stubs)
	PurgeStubs(w http.ResponseWriter, r *http.Request)
	// ListStubs Getting a list of stubs
	// (GET /stubs)
	ListStubs(w http.ResponseWriter, r *http.Request, params ListStubsParams)
	// AddStub Add a new stub to the store
	// (POST /stubs)
	AddStub(w http.ResponseWriter, r *http.Request)
	// BatchStubsDelete Deletes a batch of stubs by IDs
	// (POST /stubs/batchDelete)
	BatchStubsDelete(w http.ResponseWriter, r *http.Request)
	// InspectStubs Inspect stub matching decision path
	// (POST /stubs/inspect)
	InspectStubs(w http.ResponseWriter, r *http.Request)
	// SearchStubs Stub storage search
	// (POST /stubs/search)
	SearchStubs(w http.ResponseWriter, r *http.Request)
	// ListUnusedStubs Getting a list of unused stubs
	// (GET /stubs/unused)
	ListUnusedStubs(w http.ResponseWriter, r *http.Request)
	// ListUsedStubs Getting a list of used stubs
	// (GET /stubs/used)
	ListUsedStubs(w http.ResponseWriter, r *http.Request)
	// ValidateStub Validate a stub payload without persisting
	// (POST /stubs/validate)
	ValidateStub(w http.ResponseWriter, r *http.Request)
	// DeleteStubByID Deletes stub by ID
	// (DELETE /stubs/{uuid})
	DeleteStubByID(w http.ResponseWriter, r *http.Request, uuid ID)
	// FindByID Get Stub by ID
	// (GET /stubs/{uuid})
	FindByID(w http.ResponseWriter, r *http.Request, uuid ID)
	// VerifyCalls Verify call counts
	// (POST /verify)
	VerifyCalls(w http.ResponseWriter, r *http.Request)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type Service struct {
	Id      string   `json:"id"`
	Methods []Method `json:"methods"`
	Name    string   `json:"name"`
	Package string   `json:"package"`
}

type Sessions struct {
	Sessions []string `json:"sessions"`
}

type Stub struct {
	// Effects Side effects applied after successful stub match
	Effects []StubEffect `json:"effects,omitempty"`
	Headers StubHeaders  `json:"headers,omitempty"`

	// Id Example: 51c50050-ec27-4dae-a583-a32ca71a1dd5
	Id    *ID       `json:"id,omitempty"`
	Input StubInput `json:"input"`

	// Inputs Inputs to match against. If multiple inputs are provided, the stub will be matched if any of the inputs match.
	Inputs []StubInput `json:"inputs,omitempty"`

	// Method Example: SayHello
	Method string `json:"method"`

	// Options Optional behavior settings for a stub
	Options *StubOptions `json:"options,omitempty,omitzero"`
	Output  StubOutput   `json:"output"`

	// Priority Priority of the stub. Higher priority stubs are matched first.
	Priority int `json:"priority,omitempty"`

	// Service Example: Gripmock
	Service string `json:"service"`

	// Source Source of the stub (file, rest, mcp, proxy)
	Source *string `json:"source,omitempty,omitzero"`

	// Used Response-only — whether the stub has matched at least once. Ignored on input.
	Used bool `json:"used,omitempty"`
}

type StubEffect struct {
	Action StubEffectAction `json:"action"`

	// Id Stub UUID for delete action
	Id string `json:"id,omitempty"`

	// Stub Stub payload for upsert action
	Stub map[string]any `json:"stub,omitempty"`
}

type StubEffectAction string

type StubHeaders struct {
	// AnyOf Alternative header matchers (OR logic)
	AnyOf    []StubHeadersAnyOfElement `json:"anyOf,omitempty"`
	Contains map[string]string         `json:"contains,omitempty"`
	Equals   map[string]string         `json:"equals,omitempty"`
	Matches  map[string]string         `json:"matches,omitempty"`
}

type StubHeadersAnyOfElement struct {
	Contains map[string]string `json:"contains,omitempty"`
	Equals   map[string]string `json:"equals,omitempty"`
	Matches  map[string]string `json:"matches,omitempty"`
}

type StubInput struct {
	// AnyOf Alternative input matchers (OR logic)
	AnyOf            []StubInputAnyOfElement `json:"anyOf,omitempty"`
	Contains         map[string]any          `json:"contains,omitempty"`
	Equals           map[string]any          `json:"equals,omitempty"`
	IgnoreArrayOrder bool                    `json:"ignoreArrayOrder,omitempty"`
	Matches          map[string]any          `json:"matches,omitempty"`
}

type StubInputAnyOfElement struct {
	Contains         map[string]any `json:"contains,omitempty"`
	Equals           map[string]any `json:"equals,omitempty"`
	IgnoreArrayOrder bool           `json:"ignoreArrayOrder,omitempty"`
	Matches          map[string]any `json:"matches,omitempty"`
}

type StubList = []Stub

type StubOptions struct {
	// Times Max number of matches; 0 = unlimited
	Times int `json:"times,omitempty"`
}

type StubOutput struct {
	// Code Example: 3
	Code codes.Code `json:"code,omitempty"`
	Data any        `json:"data,omitempty"`

	// Delay Delay before sending the response
	//
	// Example: 1s
	Delay gptypes.Duration `json:"delay,omitempty,omitzero"`

	// Details gRPC status details packed into google.protobuf.Any (each item must contain type URL in `type`)
	Details []StubOutput_Details_Item `json:"details,omitempty"`

	// Error Example: Message not found
	Error   string            `json:"error,omitempty"`
	Headers map[string]string `json:"headers,omitempty"`
	Stream  []any             `json:"stream,omitempty"`
}

type StubOutput_Details_Item struct {
	// Type Full Any type URL (for example, type.googleapis.com/google.rpc.ErrorInfo)
	Type                 string         `json:"type"`
	AdditionalProperties map[string]any `json:"-"`
}

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

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

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

type ValidateStubJSONRequestBody ValidateStubJSONBody

type VerifyCallsJSONRequestBody = VerifyRequest

type VerifyError struct {
	Actual   *int    `json:"actual,omitempty"`
	Expected *int    `json:"expected,omitempty"`
	Message  *string `json:"message,omitempty"`
}

type VerifyRequest struct {
	ExpectedCount int    `json:"expectedCount"`
	Method        string `json:"method"`
	Service       string `json:"service"`
}