core

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

type CacheEntryOptions struct {
	// HardTTL caps the provider hard TTL. Providers must not extend their
	// configured TTL to satisfy this value.
	HardTTL time.Duration
	// FreshTTL caps the provider fresh TTL used for SWR. Providers must not
	// extend their configured fresh TTL to satisfy this value.
	FreshTTL time.Duration
	// NoStore tells providers to skip storing this entry.
	NoStore bool
}

type CacheKeyBuilder struct{}

type CatalogBuildOptions = catalog.BuildOptions

type CatalogCapability = catalog.Capability

type CatalogCard = catalog.Card

type CatalogCardDetail = catalog.CardDetail

type CatalogConfig struct {
	// Enabled controls whether GraphJin exposes catalog tables.
	// When omitted, it defaults to enabled in dev and disabled in production.
	Enabled any `` /* 156-byte string literal not displayed */

	// Database is the virtual database name. Defaults to "graphjin".
	Database string `mapstructure:"database" json:"database" yaml:"database" jsonschema:"title=Catalog Database,default=graphjin"`

	// Samples controls whether live sample/profile data is inlined or fetched on
	// demand. Default: on_demand.
	Samples string `` /* 145-byte string literal not displayed */

	// AutoCodeRelations controls automatic relationships from catalog/schema
	// tables to CodeSQL's code_db_refs. When omitted, it follows Enabled.
	AutoCodeRelations any `` /* 191-byte string literal not displayed */

	// CodeDatabases optionally pins which CodeSQL database should be linked.
	// Empty means auto-detect, but only when exactly one CodeSQL DB exists.
	CodeDatabases []string `` /* 130-byte string literal not displayed */
}

type CatalogEdge = catalog.Edge

type CatalogEntryPoint = catalog.EntryPoint

type CatalogFeature = catalog.Feature

type CatalogFeatureArg = catalog.FeatureArg

type CatalogFragment = catalog.Fragment

type CatalogMatch = catalog.Match

type CatalogNode = catalog.Node

type CatalogQuery = catalog.Query

type CatalogQueryOutput = catalog.QueryResult

type CatalogSavedQuery = catalog.SavedQuery

type CatalogSnapshot catalog.Snapshot

type CatalogSource = catalog.Source

type CatalogWorkflow = catalog.Workflow

type CatalogWorkflowVariable = catalog.WorkflowVariable

type Column struct {
	Name       string
	Type       string `jsonschema:"example=integer,example=text"`
	Primary    bool
	Array      bool
	FullText   bool   `mapstructure:"full_text" json:"full_text" yaml:"full_text" jsonschema:"title=Full Text Search"`
	ForeignKey string `` /* 138-byte string literal not displayed */
}

type ColumnInfo struct {
	Name                string `json:"name"`
	Type                string `json:"type"`
	Nullable            bool   `json:"nullable"`
	PrimaryKey          bool   `json:"primary_key"`
	ForeignKey          string `json:"foreign_key,omitempty"` // "schema.table.column" if FK
	Array               bool   `json:"array,omitempty"`
	Default             string `json:"default,omitempty"`
	UniqueKey           bool   `json:"unique_key,omitempty"`
	Index               bool   `json:"index,omitempty"`
	IndexName           string `json:"index_name,omitempty"`
	FullText            bool   `json:"full_text,omitempty"`
	ForeignKeyDatabase  string `json:"foreign_key_database,omitempty"`
	ForeignKeyRecursive bool   `json:"foreign_key_recursive,omitempty"`
}

type Config struct {
	// Is used to encrypt opaque values such as the cursor. Auto-generated when not set
	SecretKey string `` /* 140-byte string literal not displayed */

	// When set to true it disables the allow list workflow
	DisableAllowList bool `` /* 137-byte string literal not displayed */

	// When set to true a database schema file will be generated in dev mode and
	// used in production mode. Auto database discovery will be disabled
	// in production mode.
	EnableSchema bool `mapstructure:"enable_schema" json:"enable_schema" yaml:"enable_schema" jsonschema:"title=Enable Schema,default=false"`

	// When set to true an introspection json file will be generated in dev mode.
	// This file can be used with other GraphQL tooling to generate clients, enable
	// autocomplete, etc
	EnableIntrospection bool `` /* 152-byte string literal not displayed */

	// Forces the database session variable 'user.id' to be set to the user id
	SetUserID bool `mapstructure:"set_user_id" json:"set_user_id" yaml:"set_user_id" jsonschema:"title=Set User ID,default=false"`

	// This ensures that for anonymous users (role 'anon') all tables are blocked
	// from queries and mutations. To open access to tables for anonymous users
	// they have to be added to the 'anon' role config
	DefaultBlock bool `` /* 135-byte string literal not displayed */

	// This is a list of variables that can be leveraged in your queries.
	// (eg. variable admin_id will be $admin_id in the query)
	Vars map[string]string `mapstructure:"variables" json:"variables" yaml:"variables" jsonschema:"title=Variables"`

	// This is a list of variables that map to http header values
	HeaderVars map[string]string `mapstructure:"header_variables" json:"header_variables" yaml:"header_variables" jsonschema:"title=Header Variables"`

	// A list of tables and columns that should disallowed in any and all queries
	Blocklist []string `jsonschema:"title=Block List"`

	// The configs for custom resolvers. For example the `remote_api`
	// resolver would join json from a remote API into your query response
	Resolvers []ResolverConfig `jsonschema:"-"`

	// Sources is the canonical graph provider config. When present, all SQL,
	// CodeSQL, filesystem, OpenAPI, GraphJin system, and workflow providers must
	// be declared here instead of legacy top-level sections.
	Sources []SourceConfig `mapstructure:"sources" json:"sources" yaml:"sources" jsonschema:"title=Sources"`

	// OpenAPISpecsDir is the directory that GraphJin scans at startup for
	// OpenAPI 3 specification files (*.yaml / *.yml). Each spec dropped in
	// is parsed, classified, and exposed as remote-joinable fields and/or
	// top-level virtual tables. Defaults to "./config/specs" when empty.
	OpenAPISpecsDir string `` /* 148-byte string literal not displayed */

	// OpenAPI carries per-spec configuration keyed by the spec filename
	// without extension (e.g. "interaction_studio" matches
	// "config/specs/interaction_studio.yaml"). Operations classifiable from
	// the spec are auto-exposed; entries here add credentials, base URL
	// overrides, DB-to-API join wiring, and concurrency caps.
	OpenAPI map[string]openapi.SpecConfig `mapstructure:"openapi" json:"openapi" yaml:"openapi" jsonschema:"-"`

	// All table specific configuration such as aliased tables and relationships
	// between tables
	Tables []Table `jsonschema:"title=Tables"`

	// Relationships adds graph edges between typed table columns. Cardinality is
	// inferred from existing primary/unique metadata and reverse edges are still
	// generated by the schema graph.
	Relationships []RelationshipConfig `mapstructure:"relationships" json:"relationships" yaml:"relationships" jsonschema:"title=Relationships"`

	// All function specific configuration such as return types
	Functions []Function `jsonschema:"title=Functions"`

	// An SQL query if set enables attribute based access control. This query is
	// used to fetch the user attribute that then dynamically define the users role
	RolesQuery string `mapstructure:"roles_query" json:"roles_query" yaml:"roles_query" jsonschema:"title=Roles Query"`

	// Roles contains the configuration for all the roles you want to support 'user' and
	// 'anon' are two default roles. The 'user' role is used when a user ID is available
	// and 'anon' when it's not. Use the 'Roles Query' config to add more custom roles
	Roles []Role

	// Database type name Defaults to 'postgres' (options: postgres, mysql, mariadb, sqlite, oracle, mssql, nanodb)
	DBType string `` /* 185-byte string literal not displayed */

	// Log warnings and other debug information
	Debug bool `jsonschema:"title=Debug,default=false"`

	// Log SQL Query variable values
	LogVars bool `mapstructure:"log_vars" json:"log_vars" yaml:"log_vars" jsonschema:"title=Log Variables,default=false"`

	// Database polling duration (in seconds) used by subscriptions to
	// query for updates.
	SubsPollDuration time.Duration `` /* 145-byte string literal not displayed */

	// Upper bound on how many subscribers a single subscription poll cycle
	// will batch into one database query. The adaptive sizer never grows
	// past this value. When zero a sensible default is used.
	SubsMaxMembersPerWorker int `` /* 180-byte string literal not displayed */

	// Lower bound on the adaptive subscription chunk size; prevents the
	// sizer from shrinking down to per-row queries under sustained load.
	// When zero a sensible default is used.
	SubsMinMembersPerWorker int `` /* 178-byte string literal not displayed */

	// Target query latency for the adaptive subscription chunk sizer.
	// When zero it is auto-derived as one quarter of subs_poll_duration.
	SubsTargetQueryLatency time.Duration `` /* 231-byte string literal not displayed */

	// The default max limit (number of rows) when a limit is not defined in
	// the query or the table role config.
	DefaultLimit int `mapstructure:"default_limit" json:"default_limit" yaml:"default_limit" jsonschema:"title=Default Row Limit,default=20"`

	AnalyticsMode bool `` /* 190-byte string literal not displayed */

	// Disable all aggregation functions like count, sum, etc
	DisableAgg bool `` /* 148-byte string literal not displayed */

	// Disable all functions like count, length,  etc
	DisableFuncs bool `` /* 133-byte string literal not displayed */

	// When set to true, GraphJin will not connect to a database and instead
	// return mock data based on the query structure.
	MockDB bool `mapstructure:"mock_db" json:"mock_db" yaml:"mock_db" jsonschema:"title=Mock DB,default=false"`

	// Enable automatic coversion of camel case in GraphQL to snake case in SQL
	EnableCamelcase bool `` /* 130-byte string literal not displayed */

	// Legacy production switch. Prefer Mode for new configs.
	Production bool `jsonschema:"title=Production Mode,default=false"`

	// Mode selects the deployment-mode defaults. Empty derives from Production.
	Mode string `mapstructure:"mode" json:"mode" yaml:"mode" jsonschema:"title=Mode,enum=dev,enum=prod,enum=agentic"`

	// Duration for polling the database to detect schema changes
	DBSchemaPollDuration time.Duration `` /* 172-byte string literal not displayed */

	// When set to true it disables production security features like enforcing the allow list
	DisableProdSecurity bool `` /* 159-byte string literal not displayed */

	// The filesystem to use for this instance of GraphJin
	FS interface{} `mapstructure:"-" jsonschema:"-" json:"-"`

	// Multiple database configurations for multi-database support.
	// When set, allows querying across multiple databases in a single GraphQL request.
	// Each database gets its own connection pool, schema, and SQL compiler.
	Databases map[string]DatabaseConfig `mapstructure:"databases" json:"databases" yaml:"databases" jsonschema:"title=Databases"`

	// CacheTrackingEnabled enables injection of __gj_id fields for cache row tracking.
	// This is set by the service layer when Redis caching is enabled.
	CacheTrackingEnabled bool `mapstructure:"-" json:"-" yaml:"-" jsonschema:"-"`

	// Federation opts the engine into Apollo Federation v2 subgraph mode.
	// When Federation.Enabled is true, `_service { sdl }` returns a
	// federation-flavoured SDL describing the schema's tables. See
	// FederationConfig for the full surface.
	Federation FederationConfig `mapstructure:"federation" json:"federation" yaml:"federation" jsonschema:"title=Apollo Federation v2"`

	// Filesystems exposes object stores (local directories, S3, GCS) as
	// virtual tables in the GraphQL schema. Each entry materialises one
	// table with a fixed shape — key/size/content_type/etag/modified_at/url/data —
	// and routes queries through a pluggable Backend.
	Filesystems []FilesystemConfig `mapstructure:"filesystems" json:"filesystems" yaml:"filesystems" jsonschema:"title=Filesystem Tables"`

	// Metadata exposes GraphJin-discovered database metadata for legacy
	// internal helpers. Public GraphQL discovery should use gj_catalog
	// catalog items instead of separate table/column roots.
	Metadata MetadataConfig `mapstructure:"metadata" json:"metadata" yaml:"metadata" jsonschema:"title=Metadata Graph"`

	// Catalog exposes GraphJin's AI-first self-model as a managed read-only
	// database. It supersedes the older metadata-only graph.
	Catalog CatalogConfig `mapstructure:"catalog" json:"catalog" yaml:"catalog" jsonschema:"title=Catalog Graph"`
	// contains filtered or unexported fields
}

type DDLDialect interface {
	Name() string
	QuoteIdentifier(s string) string
	MapType(graphqlType string, notNull bool, primaryKey bool) string
	MapDefault(defaultVal string) string
	CreateTable(table sdata.DBTable) string
	AddColumn(tableName string, col sdata.DBColumn) string
	DropColumn(tableName, colName string) string
	DropTable(tableName string) string
	AddForeignKey(tableName string, col sdata.DBColumn) string
	CreateSearchIndex(tableName string, col sdata.DBColumn) string
	CreateUniqueIndex(tableName string, col sdata.DBColumn) string
	CreateIndex(tableName string, col sdata.DBColumn) string
	AlterClusteringKey(tableName string, keys []string) string
}

type DatabaseConfig struct {
	// Database type (postgres, mysql, mariadb, sqlite, oracle, mongodb, snowflake, nanodb)
	Type string `` /* 191-byte string literal not displayed */

	// ManagedType preserves the service-level logical database type after a
	// managed database has been translated to its runtime driver.
	ManagedType string `mapstructure:"-" json:"-" yaml:"-" jsonschema:"-"`

	// Connection string for the database (alternative to individual params)
	ConnString string `` /* 171-byte string literal not displayed */

	// Database host
	Host string `mapstructure:"host" json:"host" yaml:"host" jsonschema:"title=Host"`

	// Database port
	Port int `mapstructure:"port" json:"port" yaml:"port" jsonschema:"title=Port"`

	// Database name
	DBName string `mapstructure:"dbname" json:"dbname" yaml:"dbname" jsonschema:"title=Database Name"`

	// Database user
	User string `mapstructure:"user" json:"user" yaml:"user" jsonschema:"title=User"`

	// Database password
	Password string `` /* 131-byte string literal not displayed */

	// File path for SQLite databases
	Path string `mapstructure:"path" json:"path" yaml:"path" jsonschema:"title=File Path (SQLite)"`

	// Maximum number of open connections
	MaxOpenConns int `mapstructure:"max_open_conns" json:"max_open_conns" yaml:"max_open_conns" jsonschema:"title=Max Open Connections"`

	// Maximum number of idle connections
	MaxIdleConns int `mapstructure:"max_idle_conns" json:"max_idle_conns" yaml:"max_idle_conns" jsonschema:"title=Max Idle Connections"`

	// Schema name to use (for databases that support schemas)
	Schema string `mapstructure:"schema" json:"schema" yaml:"schema" jsonschema:"title=Schema"`

	// Connection pool settings
	PoolSize        int           `mapstructure:"pool_size" json:"pool_size" yaml:"pool_size" jsonschema:"title=Connection Pool Size"`
	MaxConnections  int           `mapstructure:"max_connections" json:"max_connections" yaml:"max_connections" jsonschema:"title=Maximum Connections"`
	MaxConnIdleTime time.Duration `` /* 143-byte string literal not displayed */
	MaxConnLifeTime time.Duration `` /* 143-byte string literal not displayed */

	// Health check
	PingTimeout time.Duration `mapstructure:"ping_timeout" json:"ping_timeout" yaml:"ping_timeout" jsonschema:"title=Healthcheck Ping Timeout"`

	// TLS settings
	EnableTLS  bool   `mapstructure:"enable_tls" json:"enable_tls" yaml:"enable_tls" jsonschema:"title=Enable TLS"`
	ServerName string `mapstructure:"server_name" json:"server_name" yaml:"server_name" jsonschema:"title=TLS Server Name"`
	ServerCert string `` /* 155-byte string literal not displayed */
	ClientCert string `` /* 155-byte string literal not displayed */
	ClientKey  string `` /* 145-byte string literal not displayed */

	// MSSQL-specific: disable TLS encryption (go-mssqldb defaults to encrypt=true)
	Encrypt *bool `mapstructure:"encrypt" json:"encrypt,omitempty" yaml:"encrypt,omitempty" jsonschema:"title=MSSQL Encrypt"`

	// MSSQL-specific: trust server certificate without validation
	TrustServerCertificate *bool `` /* 173-byte string literal not displayed */

	// Snowflake key pair authentication (PKCS#8 PEM format).
	// Generate key: openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8
	PrivateKeyPath string `` /* 184-byte string literal not displayed */
	PrivateKeyPEM  string `` /* 177-byte string literal not displayed */
	KeyPassphrase  string `` /* 167-byte string literal not displayed */

	// Read-only mode — blocks all mutations and DDL against this database.
	// Once set in config, cannot be changed at runtime via MCP tools.
	ReadOnly bool `mapstructure:"read_only" json:"read_only" yaml:"read_only" jsonschema:"title=Read Only"`

	AnalyticsMode *bool `` /* 145-byte string literal not displayed */

	// InferDBRefs controls CodeSQL's best-effort code-to-database reference
	// inference. It is only used for databases with type: codesql.
	InferDBRefs *bool `` /* 135-byte string literal not displayed */
}

type DatabaseStats struct {
	Name       string     `json:"name"`
	Type       string     `json:"type"`
	IsDefault  bool       `json:"isDefault"`
	ReadOnly   bool       `json:"readOnly"`
	TableCount int        `json:"tableCount"`
	Pool       *PoolStats `json:"pool,omitempty"`
}

type Delete struct {
	Filters []string
	Columns []string
	Block   bool
}

type DiffOptions struct {
	// Destructive enables DROP TABLE and DROP COLUMN operations
	Destructive bool
}

type DirectiveType struct {
	Name         string       `json:"name"`
	Description  string       `json:"description"`
	Locations    []string     `json:"locations"`
	Args         []InputValue `json:"args"`
	IsRepeatable bool         `json:"isRepeatable"`
}

type EnumValue struct {
	Name              string  `json:"name"`
	Description       string  `json:"description"`
	IsDeprecated      bool    `json:"isDeprecated"`
	DeprecationReason *string `json:"deprecationReason"`
}

type Error struct {
	Message    string         `json:"message"`
	Extensions map[string]any `json:"extensions,omitempty"`
}

type ErrorRepair struct {
	Kind          string   `json:"kind"`
	Diagnosis     string   `json:"diagnosis"`
	RepairedQuery string   `json:"repaired_query,omitempty"`
	Next          []string `json:"next,omitempty"`
}

type FS interface {
	Get(path string) (data []byte, err error)
	Put(path string, data []byte) error
	Exists(path string) (exists bool, err error)
	List(path string) (entries []string, err error)
}

type FederationConfig struct {
	Enabled bool `mapstructure:"enabled" json:"enabled" yaml:"enabled" jsonschema:"title=Enable Apollo Federation v2,default=false"`

	// Version is the Federation spec version surfaced via @link.
	// Defaults to "v2.5" when empty.
	Version string `mapstructure:"version" json:"version" yaml:"version" jsonschema:"title=Federation Version,default=v2.5"`

	// Keys overrides the auto-derived @key for the named table. Each
	// entry is a list of column names that compose the key.
	Keys map[string][]string `mapstructure:"keys" json:"keys" yaml:"keys" jsonschema:"title=Federation Keys"`

	// Shareable, Inaccessible and Tags accept "Type.field" identifiers.
	Shareable    []string            `mapstructure:"shareable" json:"shareable" yaml:"shareable" jsonschema:"title=Shareable Fields"`
	Inaccessible []string            `mapstructure:"inaccessible" json:"inaccessible" yaml:"inaccessible" jsonschema:"title=Inaccessible Fields"`
	Tags         map[string][]string `mapstructure:"tags" json:"tags" yaml:"tags" jsonschema:"title=@tag Annotations"`
}

type FieldObject struct {
	Name              string       `json:"name"`
	Description       string       `json:"description"`
	Args              []InputValue `json:"args"`
	Type              *TypeRef     `json:"type"`
	IsDeprecated      bool         `json:"isDeprecated"`
	DeprecationReason *string      `json:"deprecationReason"`
}

type FilesystemBackendFactory func(conf FilesystemConfig) (fstable.Backend, error)

type FilesystemConfig struct {
	// Name is the table name surfaced in GraphQL (e.g. "avatars").
	Name string `mapstructure:"name" json:"name" yaml:"name" jsonschema:"title=Table Name"`

	// Backend selects the implementation: "local", "s3", or "gcs".
	// S3 and GCS are gated by build tags; on a slim build, configuring
	// them produces a clear error.
	Backend string `mapstructure:"backend" json:"backend" yaml:"backend" jsonschema:"title=Backend,enum=local,enum=s3,enum=gcs"`

	// Bucket is the S3 bucket / GCS bucket name. Ignored for local.
	Bucket string `mapstructure:"bucket" json:"bucket" yaml:"bucket" jsonschema:"title=Bucket"`

	// Region is the S3 region (e.g. "us-east-1"). Ignored for local/gcs.
	Region string `mapstructure:"region" json:"region" yaml:"region" jsonschema:"title=Region"`

	// Endpoint, when non-empty, overrides the S3 endpoint URL — useful
	// for MinIO, localstack, or non-AWS S3-compatible services.
	Endpoint string `mapstructure:"endpoint" json:"endpoint" yaml:"endpoint" jsonschema:"title=Endpoint Override"`

	// Prefix is prepended to every key. Effective root for the table.
	Prefix string `mapstructure:"prefix" json:"prefix" yaml:"prefix" jsonschema:"title=Key Prefix"`

	// Root is the local filesystem root directory. Required for the
	// local backend; ignored otherwise.
	Root string `mapstructure:"root" json:"root" yaml:"root" jsonschema:"title=Local Root Directory"`

	// PresignTTL bounds how long generated presigned URLs are valid.
	// Defaults to 15 minutes when zero. Local backend ignores this.
	PresignTTL time.Duration `mapstructure:"presign_ttl" json:"presign_ttl" yaml:"presign_ttl" jsonschema:"title=Presigned URL TTL,default=15m"`

	// PublicBaseURL, when set, replaces the presigned-URL host. Useful
	// when objects are fronted by a CDN. The path is appended unchanged.
	PublicBaseURL string `mapstructure:"public_base_url" json:"public_base_url" yaml:"public_base_url" jsonschema:"title=Public Base URL"`

	// ReadOnly disables GraphJin-managed writes and local filesystem watch
	// invalidation for this filesystem table.
	ReadOnly bool `mapstructure:"read_only" json:"read_only" yaml:"read_only" jsonschema:"title=Read Only"`

	// MaxListPageSize caps the number of entries returned per list call.
	// Defaults to 1000 when zero.
	MaxListPageSize int `` /* 136-byte string literal not displayed */
}

type FragmentDetails struct {
	Name       string `json:"name"`
	Namespace  string `json:"namespace,omitempty"`
	Definition string `json:"definition"`
	On         string `json:"on,omitempty"` // The type the fragment is defined on
}

type FragmentInfo struct {
	Name      string `json:"name"`
	Namespace string `json:"namespace,omitempty"`
}

type FullType struct {
	Kind          string        `json:"kind"`
	Name          string        `json:"name"`
	Description   string        `json:"description"`
	Fields        []FieldObject `json:"fields"`
	InputFields   []InputValue  `json:"inputFields"`
	EnumValues    []EnumValue   `json:"enumValues"`
	Interfaces    []TypeRef     `json:"interfaces"`
	PossibleTypes []TypeRef     `json:"possibleTypes"`
}

type Function struct {
	Name       string
	Schema     string
	ReturnType string `` /* 126-byte string literal not displayed */
}

type FunctionInfo struct {
	Name      string          `json:"name"`
	Schema    string          `json:"schema,omitempty"`
	Type      string          `json:"type"`
	Comment   string          `json:"comment,omitempty"`
	Aggregate bool            `json:"aggregate,omitempty"`
	Inputs    []FunctionParam `json:"inputs,omitempty"`
	Outputs   []FunctionParam `json:"outputs,omitempty"`
}

type FunctionParam struct {
	Name  string `json:"name"`
	Type  string `json:"type"`
	Array bool   `json:"array,omitempty"`
}

type GraphEdge struct {
	From      string `json:"from"`
	To        string `json:"to"`
	Type      string `json:"type"`
	Weight    int    `json:"weight"`
	ViaColumn string `json:"via_column,omitempty"`
}

type GraphJin struct {
	atomic.Value
	// contains filtered or unexported fields
}

type GraphNode struct {
	Name        string `json:"name"`
	Schema      string `json:"schema,omitempty"`
	Database    string `json:"database,omitempty"`
	Type        string `json:"type"`
	ColumnCount int    `json:"column_count"`
}

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

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

type Header struct {
	Type OpType
	Name string
}

type InputValue struct {
	Name         string   `json:"name"`
	Description  string   `json:"description"`
	Type         *TypeRef `json:"type"`
	DefaultValue *string  `json:"defaultValue"`
}

type Insert struct {
	Filters []string
	Columns []string
	Presets map[string]string
	Block   bool
}

type IntroResult struct {
	Schema IntrospectionSchema `json:"__schema"`
}

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

type IntrospectionSchema struct {
	Types            []FullType      `json:"types"`
	QueryType        *ShortFullType  `json:"queryType"`
	MutationType     *ShortFullType  `json:"mutationType"`
	SubscriptionType *ShortFullType  `json:"subscriptionType"`
	Directives       []DirectiveType `json:"directives"`
}

type ManagedColumn struct {
	Name       string
	Type       string
	PrimaryKey bool
	FullText   bool
}

type ManagedMutationField struct {
	Name   string
	Column string
}

type ManagedMutationHandler interface {
	ManagedMutationTables() []string
	ExecuteManagedMutation(context.Context, ManagedMutationRequest) (json.RawMessage, error)
}

type ManagedMutationRequest struct {
	Database  string
	Operation string
	Roots     []ManagedMutationRoot
}

type ManagedMutationRoot struct {
	FieldName string
	Table     string
	Operation string
	Input     map[string]interface{}
	Where     map[string]interface{}
	Fields    []ManagedMutationField
}

type ManagedOrderBy struct {
	Column string
	Order  string
}

type ManagedQueryHandler interface {
	ManagedQueryTables() []ManagedTable
	ExecuteManagedQuery(context.Context, ManagedQueryRequest) (json.RawMessage, error)
}

type ManagedQueryRequest struct {
	Database string
	Roots    []ManagedQueryRoot
}

type ManagedQueryRoot struct {
	FieldName string
	Table     string
	Fields    []ManagedMutationField
	Where     map[string]interface{}
	OrderBy   []ManagedOrderBy
	Limit     int
	Offset    int
}

type ManagedTable struct {
	Name    string
	Columns []ManagedColumn
}

type MediaType struct {
	Schema Schema `json:"schema"`
}

type Member struct {
	Result chan *Result
	// contains filtered or unexported fields
}

type MetadataColumn struct {
	ID           string
	TableID      string
	DatabaseName string
	SchemaName   string
	TableName    string
	ColumnName   string
	Type         string
	Array        bool
	NotNull      bool
	PrimaryKey   bool
	UniqueKey    bool
	Indexed      bool
	IndexName    string
	DefaultValue string
	Comment      string
	Ordinal      int
	TableKey     string
	ColumnKey    string
}

type MetadataConfig struct {
	// Enabled controls whether GraphJin exposes discovered metadata tables.
	// When omitted, it defaults to enabled in dev and disabled in production.
	Enabled *bool `mapstructure:"enabled" json:"enabled,omitempty" yaml:"enabled,omitempty" jsonschema:"title=Enable Metadata Graph"`

	// Database is the virtual database name. Defaults to "graphjin".
	Database string `mapstructure:"database" json:"database" yaml:"database" jsonschema:"title=Metadata Database,default=graphjin"`

	// AutoCodeRelations controls automatic relationships from catalog items
	// to CodeSQL's public gj_code projection. When omitted, it follows Enabled.
	AutoCodeRelations *bool `` /* 147-byte string literal not displayed */

	// CodeDatabases optionally pins which CodeSQL database should be linked.
	// Empty means auto-detect, but only when exactly one CodeSQL DB exists.
	CodeDatabases []string `` /* 130-byte string literal not displayed */
}

type MetadataDatabase struct {
	ID        string
	Name      string
	Type      string
	IsDefault bool
	ReadOnly  bool
}

type MetadataFunction struct {
	ID           string
	DatabaseName string
	SchemaName   string
	Name         string
	ReturnType   string
	Aggregate    bool
	Comment      string
}

type MetadataIndex struct {
	ID           string
	DatabaseName string
	SchemaName   string
	TableName    string
	ColumnName   string
	Name         string
	Unique       bool
}

type MetadataRelationship struct {
	ID               string
	FromDatabaseName string
	FromSchemaName   string
	FromTableName    string
	FromColumnName   string
	FromColumnID     string
	ToDatabaseName   string
	ToSchemaName     string
	ToTableName      string
	ToColumnName     string
	ToColumnID       string
	RelType          string
	IsCrossDatabase  bool
	Source           string
}

type MetadataSnapshot struct {
	Databases     []MetadataDatabase
	Tables        []MetadataTable
	Columns       []MetadataColumn
	Relationships []MetadataRelationship
	Functions     []MetadataFunction
	Indexes       []MetadataIndex
}

type MetadataTable struct {
	ID           string
	DatabaseName string
	SchemaName   string
	TableName    string
	Type         string
	Comment      string
	PrimaryKey   string
	ColumnCount  int
	TableKey     string
}

type NanoColumn = nanodb.Column

type NanoDB = nanodb.DB

type NanoRow = nanodb.Row

type NanoSnapshot = nanodb.Snapshot

type NanoTable = nanodb.Table

type OpType int

type OpenAPIComponents struct {
	Schemas map[string]Schema `json:"schemas,omitempty"`
}

type OpenAPIDocument struct {
	OpenAPI    string                `json:"openapi"`
	Info       OpenAPIInfo           `json:"info"`
	Servers    []OpenAPIServer       `json:"servers,omitempty"`
	Paths      map[string]PathItem   `json:"paths"`
	Components *OpenAPIComponents    `json:"components,omitempty"`
	Security   []map[string][]string `json:"security,omitempty"`
}

type OpenAPIInfo struct {
	Title       string `json:"title"`
	Description string `json:"description,omitempty"`
	Version     string `json:"version"`
}

type OpenAPIOperation struct {
	Summary     string              `json:"summary,omitempty"`
	Description string              `json:"description,omitempty"`
	OperationID string              `json:"operationId,omitempty"`
	Parameters  []Parameter         `json:"parameters,omitempty"`
	RequestBody *RequestBody        `json:"requestBody,omitempty"`
	Responses   map[string]Response `json:"responses"`
	Tags        []string            `json:"tags,omitempty"`
}

type OpenAPIServer struct {
	URL         string `json:"url"`
	Description string `json:"description,omitempty"`
}

type OperationPermission struct {
	Allowed          bool              `json:"allowed"`
	Blocked          bool              `json:"blocked,omitempty"`
	Limit            int               `json:"limit,omitempty"`
	Filters          []string          `json:"filters,omitempty"`
	Columns          []string          `json:"columns,omitempty"`
	Presets          map[string]string `json:"presets,omitempty"`
	DisableFunctions bool              `json:"disable_functions,omitempty"`
}

type Option func(*graphjinEngine) error

type ParamInfo struct {
	Name    string `json:"name"`
	Type    string `json:"type"`
	IsArray bool   `json:"is_array,omitempty"`
}

type Parameter struct {
	Name        string `json:"name"`
	In          string `json:"in"` // "query", "header", "path", "cookie"
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required,omitempty"`
	Schema      Schema `json:"schema"`
}

type PartitionConfig struct {
	// Column is the partition key column name (e.g., "created_at").
	Column string `mapstructure:"column" json:"column" yaml:"column" jsonschema:"title=Partition Column,example=created_at"`
	// DefaultRangeDays is the number of days to auto-filter when no partition filter
	// is present in the query. Set to 0 to only warn without injecting a filter.
	DefaultRangeDays int  `` /* 154-byte string literal not displayed */
	None             bool `mapstructure:"none" json:"none,omitempty" yaml:"none,omitempty" jsonschema:"title=Disable Partition Check"`
}

type PathItem struct {
	Get    *OpenAPIOperation `json:"get,omitempty"`
	Post   *OpenAPIOperation `json:"post,omitempty"`
	Put    *OpenAPIOperation `json:"put,omitempty"`
	Delete *OpenAPIOperation `json:"delete,omitempty"`
}

type PathStep struct {
	From     string `json:"from"`
	To       string `json:"to"`
	Via      string `json:"via,omitempty"` // Column or join table
	Relation string `json:"relation"`      // Relationship type
}

type PoolStats struct {
	MaxOpen           int    `json:"maxOpen"`
	Open              int    `json:"open"`
	InUse             int    `json:"inUse"`
	Idle              int    `json:"idle"`
	WaitCount         int64  `json:"waitCount"`
	WaitDuration      string `json:"waitDuration"`
	MaxIdleClosed     int64  `json:"maxIdleClosed"`
	MaxLifetimeClosed int64  `json:"maxLifetimeClosed"`
}

type Query struct {
	Limit int
	// Use filters to enforce table wide things like { disabled: false } where you never want disabled users to be shown.
	Filters          []string
	Columns          []string
	DisableFunctions bool `mapstructure:"disable_functions" json:"disable_functions" yaml:"disable_functions"`
	Block            bool
}

type QueryAnalysis struct {
	Item           allow.Item
	Operation      graph.Operation
	QCode          *qcode.QCode
	HTTPMethods    []string
	Parameters     []Parameter
	ResponseSchema Schema
}

type QueryExplanation struct {
	CompiledQuery string             `json:"compiled_query"`
	Params        []ParamInfo        `json:"params"`
	Operation     string             `json:"operation"`
	Name          string             `json:"name,omitempty"`
	Role          string             `json:"role"`
	Database      string             `json:"database,omitempty"`
	Tables        []SelectInfo       `json:"tables"`
	JoinDepth     int                `json:"join_depth"`
	CacheHeader   string             `json:"cache_header,omitempty"`
	Errors        []string           `json:"errors,omitempty"`
	MultiDatabase bool               `json:"multi_database,omitempty"`
	Queries       []QueryExplanation `json:"queries,omitempty"`
}

type RefreshFn func() (data []byte, refs []RowRef, err error)

type RefreshFnWithOptions func() (data []byte, refs []RowRef, opts CacheEntryOptions, err error)

type RelationInfo struct {
	Name       string `json:"name"`              // Field name to use in queries
	Table      string `json:"table"`             // Related table name
	Type       string `json:"type"`              // one_to_one, one_to_many, many_to_many
	ForeignKey string `json:"foreign_key"`       // The FK column
	Through    string `json:"through,omitempty"` // Join table for many-to-many
}

type RelationshipConfig struct {
	From string `mapstructure:"from" json:"from" yaml:"from" jsonschema:"title=From"`
	To   string `mapstructure:"to" json:"to" yaml:"to" jsonschema:"title=To"`
	As   string `mapstructure:"as" json:"as,omitempty" yaml:"as,omitempty" jsonschema:"title=Alias"`
}

type RelationshipGraph struct {
	CenterTable string      `json:"center_table"`
	Depth       int         `json:"depth"`
	Nodes       []GraphNode `json:"nodes"`
	Edges       []GraphEdge `json:"edges"`
}

type RequestBody struct {
	Description string               `json:"description,omitempty"`
	Content     map[string]MediaType `json:"content"`
	Required    bool                 `json:"required,omitempty"`
}

type RequestConfig struct {

	// APQKey is set when using GraphJin with automatic persisted queries
	APQKey string

	// Pass additional variables complex variables such as functions that return string values.
	Vars map[string]interface{}

	// Execute this query as part of a transaction
	Tx *sql.Tx
	// contains filtered or unexported fields
}

type Resolver interface {
	Resolve(context.Context, ResolverReq) ([]byte, error)
}

type ResolverConfig struct {
	Name      string
	Type      string
	Schema    string
	Table     string
	Column    string
	StripPath string        `mapstructure:"strip_path" json:"strip_path" yaml:"strip_path"`
	Props     ResolverProps `mapstructure:",remain"`
}

type ResolverFn func(v ResolverProps) (Resolver, error)

type ResolverProps map[string]interface{}

type ResolverReq struct {
	ID   string
	Sel  *qcode.Select
	Log  *log.Logger
	Vars map[string]json.RawMessage
	*RequestConfig
}

type Response struct {
	Description string               `json:"description"`
	Content     map[string]MediaType `json:"content,omitempty"`
}

type ResponseCacheProvider interface {
	// Get retrieves a cached response by key.
	// Returns (data, isStale, found). isStale is true if the entry is past soft TTL (SWR).
	Get(ctx context.Context, key string) (data []byte, isStale bool, found bool)

	// Set stores a response with dependency refs for invalidation.
	// refs may represent DB rows/tables, filesystem keys/prefixes, or resolver outputs.
	// queryStartTime is used for race condition detection.
	Set(ctx context.Context, key string, data []byte, refs []RowRef, queryStartTime time.Time) error

	// InvalidateRows invalidates cache entries for dependency refs.
	InvalidateRows(ctx context.Context, refs []RowRef) error
}

type ResponseCacheProviderWithOptions interface {
	SetWithOptions(
		ctx context.Context,
		key string,
		data []byte,
		refs []RowRef,
		queryStartTime time.Time,
		opts CacheEntryOptions,
	) error
}

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

type Result struct {
	Vars       json.RawMessage   `json:"-"`
	Data       json.RawMessage   `json:"data,omitempty"`
	Hash       [sha256.Size]byte `json:"-"`
	Errors     []Error           `json:"errors,omitempty"`
	Validation []qcode.ValidErr  `json:"validation,omitempty"`
	// contains filtered or unexported fields
}

type Role struct {
	Name    string
	Comment string
	Match   string      `jsonschema:"title=Related To,example=other_table.id_column,example=users.id"`
	Tables  []RoleTable `jsonschema:"title=Table Configuration for Role"`
	// contains filtered or unexported fields
}

type RoleAudit struct {
	Name     string             `json:"name"`
	Match    string             `json:"match,omitempty"`
	Tables   []TablePermissions `json:"tables"`
	FixGuide string             `json:"fix_guide"`
}

type RoleTable struct {
	Name     string
	Schema   string
	Database string `mapstructure:"database" json:"database" yaml:"database" jsonschema:"title=Database"`
	ReadOnly bool   `mapstructure:"read_only" json:"read_only" yaml:"read_only" jsonschema:"title=Read Only"`

	Query  *Query
	Insert *Insert
	Update *Update
	Upsert *Upsert
	Delete *Delete
}

type RowRef struct {
	Source string
	Scope  string
	Kind   string
	Table  string
	ID     string
}

type SWRRefresher interface {
	SubmitRefresh(key string, fn RefreshFn) bool
}

type SWRRefresherWithOptions interface {
	SubmitRefreshWithOptions(key string, fn RefreshFnWithOptions) bool
}

type SavedQueryDetails struct {
	Name      string                 `json:"name"`
	Namespace string                 `json:"namespace,omitempty"`
	Operation string                 `json:"operation"`
	Query     string                 `json:"query"`
	Variables map[string]interface{} `json:"variables,omitempty"`
}

type SavedQueryInfo struct {
	Name      string `json:"name"`
	Namespace string `json:"namespace,omitempty"`
	Operation string `json:"operation"` // query or mutation
}

type Schema struct {
	Type                 string            `json:"type,omitempty"`
	Format               string            `json:"format,omitempty"`
	Properties           map[string]Schema `json:"properties,omitempty"`
	Items                *Schema           `json:"items,omitempty"`
	Required             []string          `json:"required,omitempty"`
	AdditionalProperties interface{}       `json:"additionalProperties,omitempty"`
	OneOf                []Schema          `json:"oneOf,omitempty"`
	Description          string            `json:"description,omitempty"`
	Example              interface{}       `json:"example,omitempty"`
	Ref                  string            `json:"$ref,omitempty"`
}

type SchemaOperation struct {
	Type   string // "create_table", "add_column", "drop_table", "drop_column", "add_index", "add_constraint"
	Table  string
	Column string
	SQL    string
	Danger bool // true if this is a destructive operation
}

type SelectInfo struct {
	Table    string `json:"table"`
	Schema   string `json:"schema,omitempty"`
	Database string `json:"database,omitempty"`
	Singular bool   `json:"singular,omitempty"`
	Children int    `json:"children,omitempty"`
}

type ShortFullType struct {
	Name string `json:"name"`
}

type SnowflakeKeyPairConfig interface {
	GetAccount() string
	GetUser() string
	GetPrivateKeyPEM() []byte
	GetKeyPassphrase() string
	GetWarehouse() string
	GetDatabase() string
	GetSchema() string
}

type SourceConfig struct {
	Name    string `mapstructure:"name" json:"name" yaml:"name" jsonschema:"title=Name"`
	Kind    string `` /* 138-byte string literal not displayed */
	Default bool   `mapstructure:"default" json:"default" yaml:"default" jsonschema:"title=Default Source"`

	Type                   string                        `mapstructure:"type" json:"type" yaml:"type" jsonschema:"title=Database Type"`
	ConnString             string                        `` /* 171-byte string literal not displayed */
	Host                   string                        `mapstructure:"host" json:"host" yaml:"host" jsonschema:"title=Host"`
	Port                   int                           `mapstructure:"port" json:"port" yaml:"port" jsonschema:"title=Port"`
	DBName                 string                        `mapstructure:"dbname" json:"dbname" yaml:"dbname" jsonschema:"title=Database Name"`
	User                   string                        `mapstructure:"user" json:"user" yaml:"user" jsonschema:"title=User"`
	Password               string                        `` /* 131-byte string literal not displayed */
	Path                   string                        `mapstructure:"path" json:"path" yaml:"path" jsonschema:"title=Path"`
	MaxOpenConns           int                           `mapstructure:"max_open_conns" json:"max_open_conns" yaml:"max_open_conns" jsonschema:"title=Max Open Connections"`
	MaxIdleConns           int                           `mapstructure:"max_idle_conns" json:"max_idle_conns" yaml:"max_idle_conns" jsonschema:"title=Max Idle Connections"`
	Schema                 string                        `mapstructure:"schema" json:"schema" yaml:"schema" jsonschema:"title=Schema"`
	PoolSize               int                           `mapstructure:"pool_size" json:"pool_size" yaml:"pool_size" jsonschema:"title=Connection Pool Size"`
	MaxConnections         int                           `mapstructure:"max_connections" json:"max_connections" yaml:"max_connections" jsonschema:"title=Maximum Connections"`
	MaxConnIdleTime        time.Duration                 `` /* 143-byte string literal not displayed */
	MaxConnLifeTime        time.Duration                 `` /* 143-byte string literal not displayed */
	PingTimeout            time.Duration                 `mapstructure:"ping_timeout" json:"ping_timeout" yaml:"ping_timeout" jsonschema:"title=Healthcheck Ping Timeout"`
	EnableTLS              bool                          `mapstructure:"enable_tls" json:"enable_tls" yaml:"enable_tls" jsonschema:"title=Enable TLS"`
	ServerName             string                        `mapstructure:"server_name" json:"server_name" yaml:"server_name" jsonschema:"title=TLS Server Name"`
	ServerCert             string                        `` /* 155-byte string literal not displayed */
	ClientCert             string                        `` /* 155-byte string literal not displayed */
	ClientKey              string                        `` /* 145-byte string literal not displayed */
	Encrypt                *bool                         `mapstructure:"encrypt" json:"encrypt,omitempty" yaml:"encrypt,omitempty" jsonschema:"title=MSSQL Encrypt"`
	TrustServerCertificate *bool                         `` /* 173-byte string literal not displayed */
	PrivateKeyPath         string                        `` /* 184-byte string literal not displayed */
	PrivateKeyPEM          string                        `` /* 177-byte string literal not displayed */
	KeyPassphrase          string                        `` /* 167-byte string literal not displayed */
	ReadOnly               bool                          `mapstructure:"read_only" json:"read_only" yaml:"read_only" jsonschema:"title=Read Only"`
	AnalyticsMode          *bool                         `` /* 127-byte string literal not displayed */
	InferDBRefs            *bool                         `` /* 135-byte string literal not displayed */
	Backend                string                        `mapstructure:"backend" json:"backend" yaml:"backend" jsonschema:"title=Filesystem Backend"`
	Bucket                 string                        `mapstructure:"bucket" json:"bucket" yaml:"bucket" jsonschema:"title=Bucket"`
	Region                 string                        `mapstructure:"region" json:"region" yaml:"region" jsonschema:"title=Region"`
	Endpoint               string                        `mapstructure:"endpoint" json:"endpoint" yaml:"endpoint" jsonschema:"title=Endpoint"`
	Prefix                 string                        `mapstructure:"prefix" json:"prefix" yaml:"prefix" jsonschema:"title=Prefix"`
	Root                   string                        `mapstructure:"root" json:"root" yaml:"root" jsonschema:"title=Root"`
	PresignTTL             time.Duration                 `mapstructure:"presign_ttl" json:"presign_ttl" yaml:"presign_ttl" jsonschema:"title=Presigned URL TTL"`
	PublicBaseURL          string                        `mapstructure:"public_base_url" json:"public_base_url" yaml:"public_base_url" jsonschema:"title=Public Base URL"`
	MaxListPageSize        int                           `mapstructure:"max_list_page_size" json:"max_list_page_size" yaml:"max_list_page_size" jsonschema:"title=Max List Page Size"`
	SpecsDir               string                        `mapstructure:"specs_dir" json:"specs_dir" yaml:"specs_dir" jsonschema:"title=OpenAPI Specs Directory"`
	Specs                  map[string]openapi.SpecConfig `mapstructure:"specs" json:"specs" yaml:"specs" jsonschema:"-"`
	Catalog                *bool                         `mapstructure:"catalog" json:"catalog,omitempty" yaml:"catalog,omitempty" jsonschema:"title=Catalog"`
	Metadata               *bool                         `mapstructure:"metadata" json:"metadata,omitempty" yaml:"metadata,omitempty" jsonschema:"title=Metadata"`
	ControlPlane           *bool                         `mapstructure:"control_plane" json:"control_plane,omitempty" yaml:"control_plane,omitempty" jsonschema:"title=Control Plane"`
	Runtime                string                        `mapstructure:"runtime" json:"runtime" yaml:"runtime" jsonschema:"title=Workflow Runtime"`
	Capabilities           map[string]bool               `mapstructure:"capabilities" json:"capabilities,omitempty" yaml:"capabilities,omitempty" jsonschema:"title=Capabilities"`
}

type Spaner interface {
	SetAttributesString(attrs ...StringAttr)
	IsRecording() bool
	Error(err error)
	End()
}

type StringAttr struct {
	Name  string
	Value string
}

type Table struct {
	Name   string
	Schema string
	Table  string // Inherits Table
	Type   string
	// Source is required in sources used and points at one sources[].name.
	Source string `mapstructure:"source" json:"source" yaml:"source" jsonschema:"title=Source"`
	// Database name for multi-database support. References a key in Config.Databases.
	// If empty, uses the default database.
	Database  string `mapstructure:"database" json:"database" yaml:"database" jsonschema:"title=Database"`
	ReadOnly  bool   `mapstructure:"read_only" json:"read_only" yaml:"read_only" jsonschema:"title=Read Only"`
	Blocklist []string
	Columns   []Column
	// Permitted order by options
	OrderBy map[string][]string `mapstructure:"order_by" json:"order_by" yaml:"order_by" jsonschema:"title=Order By Options,example=created_at desc"`
	// Partition configuration for warehouse-optimized queries (Snowflake, BigQuery).
	// When set, queries without a filter on the partition column will either get a
	// default time-range filter injected or produce a warning.
	Partition *PartitionConfig `mapstructure:"partition" json:"partition,omitempty" yaml:"partition,omitempty" jsonschema:"title=Partition Configuration"`
}

type TableInfo struct {
	Name        string `json:"name"`
	Schema      string `json:"schema,omitempty"`
	Database    string `json:"database,omitempty"`
	Type        string `json:"type"` // table, view, etc.
	Comment     string `json:"comment,omitempty"`
	ColumnCount int    `json:"column_count"`
}

type TablePermissions struct {
	TableName string               `json:"table_name"`
	Schema    string               `json:"schema,omitempty"`
	ReadOnly  bool                 `json:"read_only,omitempty"`
	Query     *OperationPermission `json:"query"`
	Insert    *OperationPermission `json:"insert"`
	Update    *OperationPermission `json:"update"`
	Upsert    *OperationPermission `json:"upsert"`
	Delete    *OperationPermission `json:"delete"`
}

type TableSchema struct {
	Name                 string       `json:"name"`
	Schema               string       `json:"schema,omitempty"`
	Database             string       `json:"database,omitempty"`
	Type                 string       `json:"type"`
	Comment              string       `json:"comment,omitempty"`
	Blocked              bool         `json:"blocked,omitempty"`
	PrimaryKey           string       `json:"primary_key,omitempty"`
	PrimaryKeys          []string     `json:"primary_keys,omitempty"`
	FullTextColumns      []string     `json:"full_text_columns,omitempty"`
	PartitionKey         string       `json:"partition_key,omitempty"`
	ImplicitPartitionKey string       `json:"implicit_partition_key,omitempty"`
	Columns              []ColumnInfo `json:"columns"`
	Relationships        struct {
		Outgoing []RelationInfo `json:"outgoing"` // Tables this table references
		Incoming []RelationInfo `json:"incoming"` // Tables that reference this table
	} `json:"relationships"`
}

type Tracer interface {
	Start(c context.Context, name string) (context.Context, Spaner)
	NewHTTPClient() *http.Client
}

type TypeRef struct {
	Kind   string   `json:"kind"`
	Name   *string  `json:"name"`
	OfType *TypeRef `json:"ofType"`
}

type Update struct {
	Filters []string
	Columns []string
	Presets map[string]string
	Block   bool
}

type Upsert struct {
	Filters []string
	Columns []string
	Presets map[string]string
	Block   bool
}