kqlfilter

type AndNode struct {
	NodeType
	Pos

	Nodes []Node // The clauses nodes in lexical order.
	// contains filtered or unexported fields
}

type Clause struct {
	Field string
	// One of the following: `=`, `<`, `<=`, `>`, `>=`, `IN`
	Operator string
	// List of values for the clause.
	// For `IN` operator, this is a list of values to match against.
	// For other operators, this is a list of one string.
	Values []string
}

type Filter struct {
	Clauses []Clause
}

type FilterToSpannerFieldColumnType int

type FilterToSpannerFieldConfig struct {
	// SQL table column name. Can be omitted if the column name is equal to the key in the fieldConfigs map.
	ColumnName string
	// SQL column type. Defaults to FilterToSpannerFieldColumnTypeString.
	ColumnType FilterToSpannerFieldColumnType
	// Allow prefix matching when a wildcard (`*`) is present at the end of a string.
	// Only applicable for FilterToSpannerFieldColumnTypeString. Defaults to false.
	AllowPrefixMatch bool
	// Allow multiple values for this field. Defaults to false.
	AllowMultipleValues bool
	// A function that takes a string value as provided by the user and converts it to `any` result that matches how it is
	// stored in the database. This should return an error when the user is providing a value that is illegal for this
	// particular field. Defaults to using the provided value as-is.
	MapValue func(string) (any, error)
}

type FilterToSquirrelSqlFieldColumnType int

type FilterToSquirrelSqlFieldConfig struct {
	// SQL table column name. Can be omitted if the column name is equal to the key in the fieldConfigs map.
	ColumnName string
	// SQL column type. Defaults to FilterToSquirrelSqlFieldColumnTypeString.
	ColumnType FilterToSquirrelSqlFieldColumnType
	// Allow prefix matching when a wildcard (`*`) is present at the end of a string.
	// Only applicable for FilterToSpannerFieldColumnTypeString. Defaults to false.
	AllowPrefixMatch bool
	// Allow multiple values for this field. Defaults to false.
	AllowMultipleValues bool
	// A function that takes a string value as provided by the user and converts it to string result that matches how it
	// should be as users' input. This should return an error when the user is providing a value that is illegal or unexpected
	// for this particular field. Defaults to using the provided value as-is.
	MapValue func(string) (any, error)
	// A function that handle parsing the sql statement by itself.
	// If set, all other fields in the config will be ignored
	CustomBuilder func(stmt sq.SelectBuilder, operator string, values []string) (sq.SelectBuilder, error)
}

type IsNode struct {
	NodeType
	Pos

	Identifier string
	Value      Node // The clauses nodes in lexical order.
	// contains filtered or unexported fields
}

type LiteralNode struct {
	NodeType
	Pos

	Value string
	// contains filtered or unexported fields
}

type NestedNode struct {
	NodeType
	Pos

	Expr Node // The clauses nodes in lexical order.
	// contains filtered or unexported fields
}

type Node interface {
	Type() NodeType
	String() string
	Position() Pos // byte position of start of node in full original input string
	// contains filtered or unexported methods
}

type NodeMapper struct {
	TransformIdentifierFunc func(string) string
	TransformValueFunc      func(string) string
}

type NodeType int

type NotNode struct {
	NodeType
	Pos

	Expr Node // Negated node.
	// contains filtered or unexported fields
}

type OrNode struct {
	NodeType
	Pos

	Nodes []Node // The clauses nodes in lexical order.
	// contains filtered or unexported fields
}

type ParserOption func(*parser)

type Pos int

type RangeNode struct {
	NodeType
	Pos

	Identifier string
	Operator   RangeOperator
	Value      Node // The clauses nodes in lexical order.
	// contains filtered or unexported fields
}

type RangeOperator int