redis-vl 0.1.0 → 0.2.2

package/dist/query/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC"}

package/dist/query/index.js

@@ -2,13 +2,13 @@
  * @module Query
  * Query builders for Redis search operations.
  */
-export * from './base.js';
-export * from './vector.js';
+export * from './search/base.js';
+export * from './search/vector.js';
 export * from './filter.js';
-export * from './filter-query.js';
-export * from './count.js';
-export * from './range.js';
-export * from './text.js';
+export * from './search/filter-query.js';
+export * from './search/count.js';
+export * from './search/range.js';
+export * from './search/text.js';
 export * from './hybrid.js';
-export * from './aggregation.js';
+export * from './aggregate/aggregation.js';
 //# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC"}

package/dist/query/search/base.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @module Query
+ * Query builders for Redis search operations.
+ */
+import { VectorDataType } from '../../schema/types.js';
+import type { FilterExpression } from '../filter.js';
+/**
+ * A filter clause supplied to a query - either a pre-built {@link FilterExpression}
+ * or a raw Redis Search filter string (e.g. `'@category:{electronics}'`).
+ */
+export type FilterInput = string | FilterExpression;
+/**
+ * Render a {@link FilterInput} to its Redis Search string form, treating
+ * `undefined` and the wildcard expression as "no filter" (`*`).
+ */
+export declare function renderFilter(filter: FilterInput | undefined): string;
+/**
+ * Sort direction for Redis search results.
+ */
+export type SortDirection = 'ASC' | 'DESC';
+/**
+ * A normalized sort field specification.
+ */
+export interface SortField {
+    field: string;
+    direction: SortDirection;
+}
+/**
+ * Common query configuration shared by all FT.SEARCH query types.
+ */
+export interface BaseQueryConfig {
+    /** Filter expression used as the base Redis query string. */
+    filter?: FilterInput;
+    /** Fields to return in results. */
+    returnFields?: string[];
+    /** Offset for pagination. */
+    offset?: number;
+    /** Number of results to return. */
+    limit?: number;
+}
+/**
+ * Options for sorting query results.
+ */
+export interface SortByOptions {
+    /** Sort direction. Defaults to ASC. */
+    direction?: SortDirection;
+}
+/**
+ * Base abstract class for all FT.SEARCH query types.
+ *
+ * This class owns shared query state. Subclasses remain responsible for
+ * building the final Redis query string for their specific query mode.
+ */
+export declare abstract class BaseQuery {
+    private _filter?;
+    private _returnFields?;
+    private _offset?;
+    private _limit?;
+    private readonly _sortFields;
+    /** When true, ask Redis to return only document ids/counts (FT.SEARCH NOCONTENT). */
+    noContent?: boolean;
+    /** Optional RediSearch scorer to apply when ranking text results. */
+    textScorer?: string;
+    protected constructor(config?: BaseQueryConfig);
+    /** Fields to return in results. */
+    get returnFields(): string[] | undefined;
+    /** Sort fields collected for query execution. */
+    get sortFields(): SortField[];
+    /** Filter expression used as the base Redis query string. */
+    get filter(): FilterInput | undefined;
+    /** Offset for pagination. */
+    get offset(): number | undefined;
+    /** Number of results to return. */
+    get limit(): number | undefined;
+    /** Set or clear the query filter. */
+    setFilter(filter?: FilterInput | null): this;
+    /** Set or clear return fields. */
+    setReturnFields(fields?: string[]): this;
+    /** Set pagination values. */
+    paging(offset: number, limit: number): this;
+    /** Set the sort field, replacing any previous sort. Pass `null` to clear. */
+    sortBy(field: string | null, options?: SortByOptions): this;
+    /** Build the Redis query string. */
+    abstract buildQuery(): string;
+    /** Build the query parameters for Redis. */
+    buildParams(): Record<string, unknown>;
+    private setPagingFromConfig;
+}
+/**
+ * Common vector query configuration.
+ */
+export interface BaseVectorQueryConfig extends BaseQueryConfig {
+    /** Vector to search with. */
+    vector: number[];
+    /** Name of the vector field in the index. */
+    vectorField: string;
+    /** Vector datatype to use when serializing the query vector. */
+    datatype?: VectorDataType | string;
+    /** Whether to normalize distances during result processing. */
+    normalizeDistance?: boolean;
+}
+/**
+ * Base abstract class for vector-backed query types.
+ */
+export declare abstract class BaseVectorQuery extends BaseQuery {
+    private readonly _vector;
+    private readonly _vectorField;
+    private readonly _datatype;
+    private readonly _normalizeDistance;
+    protected constructor(config: BaseVectorQueryConfig);
+    /** Vector to search with. */
+    get vector(): number[];
+    /** Name of the vector field in the index. */
+    get vectorField(): string;
+    /** Vector datatype used when serializing the query vector. */
+    get datatype(): VectorDataType;
+    /** Whether to normalize distances during result processing. */
+    get normalizeDistance(): boolean;
+}
+/**
+ * Search result document with optional score.
+ */
+export interface SearchDocument<T = Record<string, unknown>> {
+    /** Document fields. */
+    value: T;
+    /** Relevance score (for vector search). */
+    score?: number;
+    /** Document ID. */
+    id: string;
+}
+/**
+ * Search result structure.
+ */
+export interface SearchResult<T = Record<string, unknown>> {
+    /** Total number of results. */
+    total: number;
+    /** Retrieved documents. */
+    documents: SearchDocument<T>[];
+    /**
+     * Warnings emitted by the server alongside results (e.g. partial
+     * results on query timeout, truncated KNN, missing scorer). For
+     * `FT.SEARCH` replies these are only populated on RESP3 connections.
+     */
+    warnings?: string[];
+}
+/**
+ * Result returned by {@link SearchIndex.hybridSearch}. Adds the FT.HYBRID
+ * specific field (`executionTime`) on top of the standard
+ * {@link SearchResult} shape.
+ */
+export interface HybridSearchResult<T = Record<string, unknown>> extends SearchResult<T> {
+    /** Server-reported query execution time in milliseconds. */
+    executionTime?: number;
+}
+/**
+ * Options for query execution.
+ */
+export interface QueryOptions {
+    /** Redis DIALECT version (default: 2 for KNN). */
+    dialect?: number;
+    /** Sort by field. */
+    sortBy?: string;
+    /** Sort order. */
+    sortOrder?: 'ASC' | 'DESC';
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/query/search/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/query/search/base.ts"],"names":[],"mappings":"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"}

package/dist/query/search/base.js

@@ -0,0 +1,191 @@
+/**
+ * @module Query
+ * Query builders for Redis search operations.
+ */
+import { QueryValidationError, SchemaValidationError } from '../../errors.js';
+import { normalizeVectorDataType } from '../../redis/utils.js';
+/**
+ * Render a {@link FilterInput} to its Redis Search string form, treating
+ * `undefined` and the wildcard expression as "no filter" (`*`).
+ */
+export function renderFilter(filter) {
+    if (filter === undefined)
+        return '*';
+    return typeof filter === 'string' ? filter : filter.toString();
+}
+/**
+ * Base abstract class for all FT.SEARCH query types.
+ *
+ * This class owns shared query state. Subclasses remain responsible for
+ * building the final Redis query string for their specific query mode.
+ */
+export class BaseQuery {
+    _filter;
+    _returnFields;
+    _offset;
+    _limit;
+    _sortFields = [];
+    /** When true, ask Redis to return only document ids/counts (FT.SEARCH NOCONTENT). */
+    noContent;
+    /** Optional RediSearch scorer to apply when ranking text results. */
+    textScorer;
+    constructor(config = {}) {
+        if (config.filter !== undefined) {
+            this.setFilter(config.filter);
+        }
+        if (config.returnFields !== undefined) {
+            this.setReturnFields(config.returnFields);
+        }
+        if (config.offset !== undefined || config.limit !== undefined) {
+            this.setPagingFromConfig(config.offset, config.limit);
+        }
+    }
+    /** Fields to return in results. */
+    get returnFields() {
+        return this._returnFields ? [...this._returnFields] : undefined;
+    }
+    /** Sort fields collected for query execution. */
+    get sortFields() {
+        return this._sortFields.map((field) => ({ ...field }));
+    }
+    /** Filter expression used as the base Redis query string. */
+    get filter() {
+        return this._filter;
+    }
+    /** Offset for pagination. */
+    get offset() {
+        return this._offset;
+    }
+    /** Number of results to return. */
+    get limit() {
+        return this._limit;
+    }
+    /** Set or clear the query filter. */
+    setFilter(filter) {
+        if (filter === undefined || filter === null) {
+            this._filter = undefined;
+            return this;
+        }
+        const rendered = renderFilter(filter);
+        if (rendered.trim() === '') {
+            throw new QueryValidationError('filter cannot be empty');
+        }
+        this._filter = filter;
+        return this;
+    }
+    /** Set or clear return fields. */
+    setReturnFields(fields) {
+        if (fields === undefined) {
+            this._returnFields = undefined;
+            return this;
+        }
+        this._returnFields = validateStringList(fields, 'returnFields');
+        return this;
+    }
+    /** Set pagination values. */
+    paging(offset, limit) {
+        validateOffset(offset);
+        validateLimit(limit);
+        this._offset = offset;
+        this._limit = limit;
+        return this;
+    }
+    /** Set the sort field, replacing any previous sort. Pass `null` to clear. */
+    sortBy(field, options = {}) {
+        if (field === null) {
+            this._sortFields.length = 0;
+            return this;
+        }
+        const normalizedField = validateNonEmptyString(field, 'sort field');
+        const direction = options.direction ?? 'ASC';
+        if (direction !== 'ASC' && direction !== 'DESC') {
+            throw new QueryValidationError('sort direction must be either ASC or DESC');
+        }
+        this._sortFields.length = 0;
+        this._sortFields.push({ field: normalizedField, direction });
+        return this;
+    }
+    /** Build the query parameters for Redis. */
+    buildParams() {
+        return {};
+    }
+    setPagingFromConfig(offset, limit) {
+        if (offset !== undefined) {
+            validateOffset(offset);
+            this._offset = offset;
+        }
+        if (limit !== undefined) {
+            validateLimit(limit);
+            this._limit = limit;
+        }
+    }
+}
+/**
+ * Base abstract class for vector-backed query types.
+ */
+export class BaseVectorQuery extends BaseQuery {
+    _vector;
+    _vectorField;
+    _datatype;
+    _normalizeDistance;
+    constructor(config) {
+        super(config);
+        if (!config.vector || config.vector.length === 0) {
+            throw new QueryValidationError('Vector cannot be empty');
+        }
+        const vectorField = typeof config.vectorField === 'string' ? config.vectorField.trim() : '';
+        if (!vectorField) {
+            throw new QueryValidationError('vectorField is required');
+        }
+        this._vector = [...config.vector];
+        this._vectorField = vectorField;
+        this._normalizeDistance = config.normalizeDistance ?? false;
+        try {
+            this._datatype = normalizeVectorDataType(config.datatype);
+        }
+        catch (error) {
+            if (error instanceof SchemaValidationError) {
+                throw new QueryValidationError(error.message);
+            }
+            throw error;
+        }
+    }
+    /** Vector to search with. */
+    get vector() {
+        return [...this._vector];
+    }
+    /** Name of the vector field in the index. */
+    get vectorField() {
+        return this._vectorField;
+    }
+    /** Vector datatype used when serializing the query vector. */
+    get datatype() {
+        return this._datatype;
+    }
+    /** Whether to normalize distances during result processing. */
+    get normalizeDistance() {
+        return this._normalizeDistance;
+    }
+}
+function validateStringList(values, label) {
+    return values.map((value) => {
+        return validateNonEmptyString(value, label);
+    });
+}
+function validateNonEmptyString(value, label) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new QueryValidationError(`${label} cannot be empty`);
+    }
+    return value.trim();
+}
+function validateOffset(offset) {
+    if (!Number.isInteger(offset) || offset < 0) {
+        throw new QueryValidationError('offset must be a non-negative integer');
+    }
+}
+function validateLimit(limit) {
+    if (!Number.isInteger(limit) || limit < 0) {
+        throw new QueryValidationError('limit must be a non-negative integer');
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/query/search/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/query/search/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAU/D;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA+B;IACxD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACrC,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;AACnE,CAAC;AAwCD;;;;;GAKG;AACH,MAAM,OAAgB,SAAS;IACnB,OAAO,CAAe;IACtB,aAAa,CAAY;IACzB,OAAO,CAAU;IACjB,MAAM,CAAU;IACP,WAAW,GAAgB,EAAE,CAAC;IAE/C,qFAAqF;IACrF,SAAS,CAAW;IAEpB,qEAAqE;IACrE,UAAU,CAAU;IAEpB,YAAsB,SAA0B,EAAE;QAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC5D,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC;IAED,mCAAmC;IACnC,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,CAAC;IAED,iDAAiD;IACjD,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,6DAA6D;IAC7D,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,mCAAmC;IACnC,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,qCAAqC;IACrC,SAAS,CAAC,MAA2B;QACjC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kCAAkC;IAClC,eAAe,CAAC,MAAiB;QAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,kBAAkB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,6BAA6B;IAC7B,MAAM,CAAC,MAAc,EAAE,KAAa;QAChC,cAAc,CAAC,MAAM,CAAC,CAAC;QACvB,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,KAAoB,EAAE,UAAyB,EAAE;QACpD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC7C,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YAC9C,MAAM,IAAI,oBAAoB,CAAC,2CAA2C,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IAChB,CAAC;IAKD,4CAA4C;IAC5C,WAAW;QACP,OAAO,EAAE,CAAC;IACd,CAAC;IAEO,mBAAmB,CAAC,MAAe,EAAE,KAAc;QACvD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,cAAc,CAAC,MAAM,CAAC,CAAC;YACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QAC1B,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACxB,CAAC;IACL,CAAC;CACJ;AAmBD;;GAEG;AACH,MAAM,OAAgB,eAAgB,SAAQ,SAAS;IAClC,OAAO,CAAW;IAClB,YAAY,CAAS;IACrB,SAAS,CAAiB;IAC1B,kBAAkB,CAAU;IAE7C,YAAsB,MAA6B;QAC/C,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,MAAM,IAAI,oBAAoB,CAAC,yBAAyB,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,iBAAiB,IAAI,KAAK,CAAC;QAE5D,IAAI,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;gBACzC,MAAM,IAAI,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAM;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,6CAA6C;IAC7C,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED,8DAA8D;IAC9D,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,+DAA+D;IAC/D,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACnC,CAAC;CACJ;AAED,SAAS,kBAAkB,CAAC,MAAgB,EAAE,KAAa;IACvD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACxB,OAAO,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa,EAAE,KAAa;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,oBAAoB,CAAC,GAAG,KAAK,kBAAkB,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,oBAAoB,CAAC,uCAAuC,CAAC,CAAC;IAC5E,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAChC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,oBAAoB,CAAC,sCAAsC,CAAC,CAAC;IAC3E,CAAC;AACL,CAAC"}

package/dist/query/{count.d.ts → search/count.d.ts}

@@ -1,4 +1,4 @@
-import { type BaseQuery, type FilterInput } from './base.js';
+import { BaseQuery, type FilterInput } from './base.js';
 /**
  * Configuration for {@link CountQuery}.
  */
@@ -20,13 +20,9 @@ export interface CountQueryConfig {
  * const total = (await index.search(new CountQuery({ filter: Tag('brand').eq('nike') }))).total;
  * ```
  */
-export declare class CountQuery implements BaseQuery {
-    readonly filter?: FilterInput;
-    readonly offset = 0;
-    readonly limit = 0;
+export declare class CountQuery extends BaseQuery {
     readonly noContent = true;
     constructor(config?: CountQueryConfig);
     buildQuery(): string;
-    buildParams(): Record<string, unknown>;
 }
 //# sourceMappingURL=count.d.ts.map

package/dist/query/search/count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"count.d.ts","sourceRoot":"","sources":["../../../src/query/search/count.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAW,SAAQ,SAAS;IACrC,SAAgB,SAAS,QAAQ;gBAErB,MAAM,GAAE,gBAAqB;IAIzC,UAAU,IAAI,MAAM;CAGvB"}

package/dist/query/{count.js → search/count.js}

@@ -1,4 +1,4 @@
-import { renderFilter } from './base.js';
+import { BaseQuery, renderFilter } from './base.js';
 /**
  * Counts the documents matched by a filter expression. Internally configures
  * the request as `FT.SEARCH ... LIMIT 0 0 NOCONTENT` so Redis returns only
@@ -13,19 +13,13 @@ import { renderFilter } from './base.js';
  * const total = (await index.search(new CountQuery({ filter: Tag('brand').eq('nike') }))).total;
  * ```
  */
-export class CountQuery {
-    filter;
-    offset = 0;
-    limit = 0;
+export class CountQuery extends BaseQuery {
     noContent = true;
     constructor(config = {}) {
-        this.filter = config.filter;
+        super({ filter: config.filter, offset: 0, limit: 0 });
     }
     buildQuery() {
         return renderFilter(this.filter);
     }
-    buildParams() {
-        return {};
-    }
 }
 //# sourceMappingURL=count.js.map

package/dist/query/search/count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count.js","sourceRoot":"","sources":["../../../src/query/search/count.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAoB,MAAM,WAAW,CAAC;AAUtE;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,UAAW,SAAQ,SAAS;IACrB,SAAS,GAAG,IAAI,CAAC;IAEjC,YAAY,SAA2B,EAAE;QACrC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,UAAU;QACN,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACJ"}

package/dist/query/{filter-query.d.ts → search/filter-query.d.ts}

@@ -1,4 +1,4 @@
-import { type BaseQuery, type FilterInput } from './base.js';
+import { BaseQuery, type FilterInput } from './base.js';
 /**
  * Configuration for {@link FilterQuery}.
  */
@@ -7,7 +7,7 @@ export interface FilterQueryConfig {
     filter?: FilterInput;
     /** Fields to include in each result document. */
     returnFields?: string[];
-    /** Number of results to return. Defaults to 10. */
+    /** Number of results to return. Default for `limit` (the `LIMIT` count). Defaults to 10. */
     numResults?: number;
     /** Pagination offset. */
     offset?: number;
@@ -29,14 +29,9 @@ export interface FilterQueryConfig {
  * const results = await index.search(q);
  * ```
  */
-export declare class FilterQuery implements BaseQuery {
-    readonly filter?: FilterInput;
-    readonly returnFields?: string[];
+export declare class FilterQuery extends BaseQuery {
     readonly numResults: number;
-    readonly offset?: number;
-    readonly limit?: number;
     constructor(config?: FilterQueryConfig);
     buildQuery(): string;
-    buildParams(): Record<string, unknown>;
 }
 //# sourceMappingURL=filter-query.d.ts.map

package/dist/query/search/filter-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-query.d.ts","sourceRoot":"","sources":["../../../src/query/search/filter-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,wFAAwF;IACxF,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACtC,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,MAAM,GAAE,iBAAsB;IAW1C,UAAU,IAAI,MAAM;CAGvB"}

package/dist/query/{filter-query.js → search/filter-query.js}

@@ -1,4 +1,4 @@
-import { renderFilter } from './base.js';
+import { BaseQuery, renderFilter } from './base.js';
 /**
  * Filter-only search — returns matching documents without any vector or
  * full-text scoring. Equivalent to Python `redisvl.query.FilterQuery`.
@@ -14,24 +14,20 @@ import { renderFilter } from './base.js';
  * const results = await index.search(q);
  * ```
  */
-export class FilterQuery {
-    filter;
-    returnFields;
+export class FilterQuery extends BaseQuery {
     numResults;
-    offset;
-    limit;
     constructor(config = {}) {
-        this.filter = config.filter;
-        this.returnFields = config.returnFields;
-        this.numResults = config.numResults ?? 10;
-        this.offset = config.offset;
-        this.limit = config.limit ?? this.numResults;
+        const numResults = config.numResults ?? 10;
+        super({
+            filter: config.filter,
+            returnFields: config.returnFields,
+            offset: config.offset,
+            limit: config.limit ?? numResults,
+        });
+        this.numResults = numResults;
     }
     buildQuery() {
         return renderFilter(this.filter);
     }
-    buildParams() {
-        return {};
-    }
 }
 //# sourceMappingURL=filter-query.js.map

package/dist/query/search/filter-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-query.js","sourceRoot":"","sources":["../../../src/query/search/filter-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAoB,MAAM,WAAW,CAAC;AAsBtE;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IACtB,UAAU,CAAS;IAEnC,YAAY,SAA4B,EAAE;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC3C,KAAK,CAAC;YACF,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,UAAU;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,UAAU;QACN,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACJ"}

package/dist/query/{range.d.ts → search/range.d.ts}

@@ -1,14 +1,10 @@
-import { type BaseQuery, type FilterInput } from './base.js';
-import { VectorDataType, VectorDistanceMetric } from '../schema/types.js';
+import { BaseVectorQuery, type BaseVectorQueryConfig, type FilterInput } from './base.js';
+import { VectorDataType, VectorDistanceMetric } from '../../schema/types.js';
 import type { HybridPolicy } from './vector.js';
 /**
  * Configuration for {@link VectorRangeQuery}.
  */
-export interface VectorRangeQueryConfig {
-    /** Query vector. */
-    vector: number[];
-    /** Vector field name to search against. */
-    vectorField: string;
+export interface VectorRangeQueryConfig extends BaseVectorQueryConfig {
     /**
      * Maximum allowed vector distance for results.
      *
@@ -60,20 +56,12 @@ export interface VectorRangeQueryConfig {
  * const results = await index.search(q);
  * ```
  */
-export declare class VectorRangeQuery implements BaseQuery {
-    readonly vector: number[];
-    readonly vectorField: string;
+export declare class VectorRangeQuery extends BaseVectorQuery {
     readonly distanceThreshold: number;
-    readonly filter?: FilterInput;
-    readonly returnFields?: string[];
     readonly distanceMetric: VectorDistanceMetric;
-    readonly datatype: VectorDataType;
-    readonly offset?: number;
-    readonly limit?: number;
     readonly scoreAlias: string;
     readonly hybridPolicy?: HybridPolicy;
     readonly batchSize?: number;
-    readonly normalizeDistance: boolean;
     constructor(config: VectorRangeQueryConfig);
     buildQuery(): string;
     buildParams(): Record<string, unknown>;

package/dist/query/search/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../../src/query/search/range.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,eAAe,EAEf,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACjE;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,gFAAgF;IAChF,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,uEAAuE;IACvE,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAEtC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;IAEnC,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yEAAyE;IACzE,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IACjD,SAAgB,iBAAiB,EAAE,MAAM,CAAC;IAC1C,SAAgB,cAAc,EAAE,oBAAoB,CAAC;IACrD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5C,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,MAAM,EAAE,sBAAsB;IA8B1C,UAAU,IAAI,MAAM;IAUpB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAgBzC"}