graphql

type Error struct {
	Message    string `json:"message"`
	Path       []any  `json:"path,omitempty"`
	Locations  []any  `json:"locations,omitempty"`
	Extensions any    `json:"extensions,omitempty"`
}

type ErrorGroup struct {
	EntryID       string  `json:"entry_id"`
	OperationName string  `json:"operation_name,omitempty"`
	Errors        []Error `json:"errors,omitzero"`
	IsPartial     bool    `json:"is_partial"`      // data != null && errors present
	IsFullFailure bool    `json:"is_full_failure"` // data == null && errors present
}

type ErrorSummary struct {
	EntriesChecked    int `json:"entries_checked"`
	EntriesWithErrors int `json:"entries_with_errors"`
	TotalErrors       int `json:"total_errors"`
	PartialFailures   int `json:"partial_failures"`
	FullFailures      int `json:"full_failures"`
}

type FragmentCoverage struct {
	Fragments       []FragmentInfo  `json:"fragments,omitzero"`
	TypenamesSeen   []TypenameSeen  `json:"typenames_seen,omitzero"`
	UnmatchedTypes  []UnmatchedType `json:"unmatched_types,omitzero"`
	UnusedFragments []string        `json:"unused_fragments,omitzero"`
}

type FragmentInfo struct {
	Name     string   `json:"name,omitempty"` // Fragment name (empty for inline fragments)
	OnType   string   `json:"on_type"`        // Type condition (e.g., "Human")
	Fields   []string `json:"fields,omitempty"`
	IsInline bool     `json:"is_inline"` // True for ... on Type { } fragments
}

type FragmentWarning struct {
	Path     string `json:"path"`     // JSON path to the object (e.g., "data.nav.items[0]")
	Typename string `json:"typename"` // The __typename value
	Message  string `json:"message"`  // Actionable guidance
}

type InspectedOperation struct {
	ParsedOperation
	VariablesSchema *jsonschema.Schema `json:"variables_schema,omitempty"`
	ResponseSchema  *jsonschema.Schema `json:"response_schema,omitempty"`
	FieldStats      []js.FieldStat     `json:"field_stats,omitempty"`
}

type OperationCluster struct {
	Name            string                          `json:"name"`                       // Operation name
	Type            string                          `json:"type"`                       // query, mutation, or subscription
	Count           int                             `json:"count"`                      // Total requests
	ErrorCount      int                             `json:"error_count"`                // Requests with GraphQL errors
	Fields          []string                        `json:"fields,omitempty"`           // Union of top-level fields across samples
	HasVariables    bool                            `json:"has_variables"`              // Any sample used variables
	VariableSummary map[string]VariableDistribution `json:"variable_summary,omitempty"` // Per-variable value distribution
	EntryIDs        []string                        `json:"example_entry_ids,omitzero"` // Example entry IDs (up to 5)
}

type ParseError struct {
	// Sentinel is the category (ErrEmpty, ErrNotGraphQL, or nil for JSON errors).
	Sentinel error
	// Cause is the underlying error (e.g., json.SyntaxError).
	Cause error
	// Message provides human-readable context.
	Message string
}

type ParseResult struct {
	Operations []ParsedOperation `json:"operations"`
	IsBatched  bool              `json:"is_batched"` // True if the body was a JSON array
}

type ParsedOperation struct {
	Name          string   `json:"name"`                     // Operation name ("anonymous" if unnamed)
	Type          string   `json:"type"`                     // query, mutation, or subscription
	Fields        []string `json:"fields,omitempty"`         // Top-level field selections
	RawQuery      string   `json:"raw_query,omitempty"`      // Raw query string (if include_query)
	Variables     any      `json:"variables,omitempty"`      // Variables object (raw)
	HasVariables  bool     `json:"has_variables"`            // Whether variables were present
	BatchIndex    int      `json:"batch_index,omitempty"`    // Index in batched request (0 for non-batched)
	ParseFailed   bool     `json:"parse_failed,omitempty"`   // True if query string could not be parsed
	OperationName string   `json:"operation_name,omitempty"` // Raw operationName from JSON body
}

type ResponseVariants struct {
	DiscriminatingVariable string    `json:"discriminating_variable,omitempty"` // Variable that best separates shapes
	Variants               []Variant `json:"variants,omitzero"`
}

type TrafficSummary struct {
	TotalRequests     int      `json:"total_requests"`
	QueryCount        int      `json:"query_count"`
	MutationCount     int      `json:"mutation_count"`
	SubscriptionCount int      `json:"subscription_count"`
	BatchedCount      int      `json:"batched_count"`   // Entries that contained batched ops
	AnonymousCount    int      `json:"anonymous_count"` // Operations without a name
	UniqueOps         int      `json:"unique_operations"`
	Hosts             []string `json:"hosts,omitzero"`
}

type TypenameSeen struct {
	Typename    string   `json:"typename"`
	Paths       []string `json:"paths,omitzero"` // Example paths where it appeared
	Count       int      `json:"count"`          // Total occurrences across entries
	HasFragment bool     `json:"has_fragment"`   // Whether a fragment covers this type
}

type UnmatchedType struct {
	Typename     string   `json:"typename"`
	ExamplePaths []string `json:"example_paths,omitzero"` // Example paths where it appeared
	Message      string   `json:"message"`                // Actionable guidance
}

type ValueCount struct {
	Value any `json:"value"`
	Count int `json:"count"`
}

type VariableDistribution struct {
	Type        string       `json:"type"`                 // Inferred JSON type (string, number, boolean, object, array, null)
	TopValues   []ValueCount `json:"top_values,omitzero"`  // Most frequent values (scalars only, capped)
	UniqueCount int          `json:"unique_count"`         // Total distinct non-null values seen
	NullCount   int          `json:"null_count,omitempty"` // Entries where this variable was null
}

type Variant struct {
	VariableValues map[string]any `json:"variable_values,omitempty"` // Common variable values for this group
	EntryCount     int            `json:"entry_count"`
	ShapeKeys      []string       `json:"shape_keys,omitzero"`        // Top-level keys in .data for this shape
	ExampleEntryID string         `json:"example_entry_id,omitempty"` // Representative entry
}