xlucene-parser / utils

utils

Interfaces

Interface	Description
ParsedRange	-

Variables

coerceValueFns

const coerceValueFns: CoerceValueFns

Defined in: packages/xlucene-parser/src/utils.ts:273

---

groupTypes

const groupTypes: NodeType[]

Defined in: packages/xlucene-parser/src/utils.ts:129

logical group or field group with flow

---

logger

const logger: Logger

Defined in: packages/xlucene-parser/src/utils.ts:33

---

numberDataTypes

const numberDataTypes: xLuceneFieldType[]

Defined in: packages/xlucene-parser/src/utils.ts:96

---

termTypes

const termTypes: readonly NodeType[]

Defined in: packages/xlucene-parser/src/utils.ts:115

term level queries with field (string|null)

Functions

coordinateToXlucene()

coordinateToXlucene(cord): string

Defined in: packages/xlucene-parser/src/utils.ts:267

Parameters

Parameter	Type
cord	CoordinateTuple

Returns

string

---

createIPRangeFromTerm()

createIPRangeFromTerm(node, value): Range

Defined in: packages/xlucene-parser/src/utils.ts:330

Convert an IP address or CIDR block term into a range query.

Parameters

Parameter	Type	Description
node	Term	The term node containing the IP value
value	string	The IP address or CIDR block string

Returns

Range

A range node representing the IP range

---

getField()

getField(node): undefined | string

Defined in: packages/xlucene-parser/src/utils.ts:108

Parameters

Parameter	Type
node	unknown

Returns

undefined | string

---

getFieldValue()

Call Signature

getFieldValue<T>(value, variables, allowNil): Maybe<T>

Defined in: packages/xlucene-parser/src/utils.ts:163

Resolve a field value or array of field values using the provided variables.

This function handles both literal values and variable references, resolving variables to their actual values from the variables object.

Type Parameters

Type Parameter
T

Parameters

Parameter	Type	Description
value	FieldValue<T>	The field value(s) to resolve
variables	xLuceneVariables	Object containing variable values
allowNil	true	Whether to allow undefined/null values

Returns

Maybe<T>

The resolved value(s)

Call Signature

getFieldValue<T>(value, variables, allowNil?): T

Defined in: packages/xlucene-parser/src/utils.ts:168

Resolve a field value or array of field values using the provided variables.

This function handles both literal values and variable references, resolving variables to their actual values from the variables object.

Type Parameters

Type Parameter
T

Parameters

Parameter	Type	Description
value	FieldValue<T>	The field value(s) to resolve
variables	xLuceneVariables	Object containing variable values
allowNil?	boolean	Whether to allow undefined/null values

Returns

T

The resolved value(s)

Call Signature

getFieldValue<T>(value, variables, allowNil?): T[]

Defined in: packages/xlucene-parser/src/utils.ts:173

Resolve a field value or array of field values using the provided variables.

This function handles both literal values and variable references, resolving variables to their actual values from the variables object.

Type Parameters

Type Parameter
T

Parameters

Parameter	Type	Description
value	FieldValue<T>[]	The field value(s) to resolve
variables	xLuceneVariables	Object containing variable values
allowNil?	boolean	Whether to allow undefined/null values

Returns

T[]

The resolved value(s)

---

isBooleanDataType()

isBooleanDataType(node): node is BooleanDataType

Defined in: packages/xlucene-parser/src/utils.ts:104

Parameters

Parameter	Type
node	unknown

Returns

node is BooleanDataType

---

isConjunction()

isConjunction(node): node is Conjunction

Defined in: packages/xlucene-parser/src/utils.ts:44

Parameters

Parameter	Type
node	unknown

Returns

node is Conjunction

---

isEmptyNode()

isEmptyNode(node): node is EmptyNode

Defined in: packages/xlucene-parser/src/utils.ts:88

Parameters

Parameter	Type
node	unknown

Returns

node is EmptyNode

---

isExists()

isExists(node): node is Exists

Defined in: packages/xlucene-parser/src/utils.ts:56

Parameters

Parameter	Type
node	unknown

Returns

node is Exists

---

isFieldGroup()

isFieldGroup(node): node is FieldGroup

Defined in: packages/xlucene-parser/src/utils.ts:52

Parameters

Parameter	Type
node	unknown

Returns

node is FieldGroup

---

isFunctionNode()

isFunctionNode(node): node is FunctionNode

Defined in: packages/xlucene-parser/src/utils.ts:64

Parameters

Parameter	Type
node	unknown

Returns

node is FunctionNode

---

isGroupLike()

isGroupLike(node): node is GroupLikeNode

Defined in: packages/xlucene-parser/src/utils.ts:131

Parameters

Parameter	Type
node	unknown

Returns

node is GroupLikeNode

---

isInfiniteMax()

isInfiniteMax(max?): boolean

Defined in: packages/xlucene-parser/src/utils.ts:228

Parameters

Parameter	Type
max?	string | number

Returns

boolean

---

isInfiniteMin()

isInfiniteMin(min?): boolean

Defined in: packages/xlucene-parser/src/utils.ts:223

Parameters

Parameter	Type
min?	string | number

Returns

boolean

---

isInfiniteValue()

isInfiniteValue(input?): boolean

Defined in: packages/xlucene-parser/src/utils.ts:219

Parameters

Parameter	Type
input?	string | number

Returns

boolean

---

isLogicalGroup()

isLogicalGroup(node): node is LogicalGroup

Defined in: packages/xlucene-parser/src/utils.ts:40

Parameters

Parameter	Type
node	unknown

Returns

node is LogicalGroup

---

isNegation()

isNegation(node): node is Negation

Defined in: packages/xlucene-parser/src/utils.ts:48

Parameters

Parameter	Type
node	unknown

Returns

node is Negation

---

isNumberDataType()

isNumberDataType(node): node is NumberDataType

Defined in: packages/xlucene-parser/src/utils.ts:100

Parameters

Parameter	Type
node	unknown

Returns

node is NumberDataType

---

isRange()

isRange(node): node is Range

Defined in: packages/xlucene-parser/src/utils.ts:60

Parameters

Parameter	Type
node	unknown

Returns

node is Range

---

isRegexp()

isRegexp(node): node is Regexp

Defined in: packages/xlucene-parser/src/utils.ts:68

Parameters

Parameter	Type
node	unknown

Returns

node is Regexp

---

isStringDataType()

isStringDataType(node): node is StringDataType

Defined in: packages/xlucene-parser/src/utils.ts:92

Parameters

Parameter	Type
node	unknown

Returns

node is StringDataType

---

isTerm()

isTerm(node): node is Term

Defined in: packages/xlucene-parser/src/utils.ts:80

Parameters

Parameter	Type
node	unknown

Returns

node is Term

---

isTermList()

isTermList(node): node is TermList

Defined in: packages/xlucene-parser/src/utils.ts:84

Parameters

Parameter	Type
node	unknown

Returns

node is TermList

---

isTermType()

isTermType(node): node is TermLikeNode

Defined in: packages/xlucene-parser/src/utils.ts:124

Parameters

Parameter	Type
node	unknown

Returns

node is TermLikeNode

---

isWildcard()

isWildcard(node): node is Wildcard

Defined in: packages/xlucene-parser/src/utils.ts:72

Parameters

Parameter	Type
node	unknown

Returns

node is Wildcard

---

isWildcardField()

isWildcardField(node): boolean

Defined in: packages/xlucene-parser/src/utils.ts:76

Parameters

Parameter	Type
node	unknown

Returns

boolean

---

makeCoerceFn()

makeCoerceFn(fieldType): (v) => any

Defined in: packages/xlucene-parser/src/utils.ts:317

Create a coercion function for the specified field type.

Parameters

Parameter	Type	Description
fieldType	undefined | xLuceneFieldType	The xLucene field type

Returns

A function that coerces values to the specified type

(v): any

Parameters

Parameter	Type
v	any

Returns

any

---

parseRange()

parseRange(node, variables, excludeInfinite): ParsedRange

Defined in: packages/xlucene-parser/src/utils.ts:248

Parse a range node into a simple object with comparison operators.

Parameters

Parameter	Type	Default value	Description
node	Range	undefined	The range node to parse
variables	xLuceneVariables	undefined	Variables for resolving variable references
excludeInfinite	boolean	false	Whether to exclude infinite values (* or ±Infinity)

Returns

ParsedRange

Object with comparison operators and their values

---

validateVariables()

validateVariables(obj): xLuceneVariables

Defined in: packages/xlucene-parser/src/utils.ts:142

Validate and normalize a variables object.

Parameters

Parameter	Type	Description
obj	xLuceneVariables	The variables object to validate

Returns

xLuceneVariables

A normalized copy of the variables object

Throws

If the variables object is invalid