@semics-tech/mongolite 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,318 @@
+/**
+ * Represents a document with an optional _id field.
+ */
+export interface DocumentWithId {
+    _id?: string;
+    [key: string]: unknown;
+}
+/**
+ * Result of insertOne operation.
+ */
+export interface InsertOneResult {
+    acknowledged: boolean;
+    insertedId: string;
+}
+/**
+ * Result of insertMany operation.
+ */
+export interface InsertManyResult {
+    acknowledged: boolean;
+    insertedCount: number;
+    insertedIds: Record<number, string>;
+}
+/**
+ * Result of updateOne operation.
+ */
+export interface UpdateResult {
+    acknowledged: boolean;
+    matchedCount: number;
+    modifiedCount: number;
+    upsertedId: string | null;
+}
+/**
+ * Result of findOneAndUpdate/findOneAndReplace/findOneAndDelete operations.
+ */
+export interface ModifyResult<T> {
+    value: T | null;
+    ok: 1;
+}
+/**
+ * Result of deleteOne/deleteMany operations.
+ */
+export interface DeleteResult {
+    acknowledged: boolean;
+    deletedCount: number;
+}
+/**
+ * Options for findOneAndUpdate operations.
+ */
+export interface FindOneAndUpdateOptions<TSchema = DocumentWithId> {
+    /** Whether to return the document before ('before') or after ('after') the update. Default is 'before'. */
+    returnDocument?: 'before' | 'after';
+    /** If true, insert a new document when no match is found. */
+    upsert?: boolean;
+    /** Field projection to apply. */
+    projection?: Projection<TSchema>;
+}
+/**
+ * Options for findOneAndDelete operations.
+ */
+export interface FindOneAndDeleteOptions<TSchema = DocumentWithId> {
+    /** Field projection to apply. */
+    projection?: Projection<TSchema>;
+}
+/**
+ * Options for findOneAndReplace operations.
+ */
+export interface FindOneAndReplaceOptions<TSchema = DocumentWithId> {
+    /** Whether to return the document before ('before') or after ('after') the replacement. Default is 'before'. */
+    returnDocument?: 'before' | 'after';
+    /** If true, insert a new document when no match is found. */
+    upsert?: boolean;
+    /** Field projection to apply. */
+    projection?: Projection<TSchema>;
+}
+/**
+ * Options for replaceOne operations.
+ */
+export interface ReplaceOptions {
+    /** If true, insert a new document when no match is found. */
+    upsert?: boolean;
+}
+/**
+ * Options for aggregate operations.
+ */
+export type AggregationPipeline = Record<string, unknown>[];
+/**
+ * Operators for filtering documents.
+ * T is the type of the field being queried.
+ */
+export interface QueryOperators<T> {
+    $eq?: T;
+    $ne?: T;
+    $gt?: T;
+    $gte?: T;
+    $lt?: T;
+    $lte?: T;
+    $in?: T[];
+    $nin?: T[];
+    $all?: T extends unknown[] ? T : never;
+    $exists?: boolean;
+    $not?: QueryOperators<T>;
+    /** Regular expression pattern match. Can be a string pattern or RegExp object. */
+    $regex?: string | RegExp;
+    /** Regex options (flags). Used alongside $regex. E.g. 'i' for case-insensitive. */
+    $options?: string;
+    /** Matches arrays with the specified number of elements. */
+    $size?: number;
+    /** Selects documents where the value of the field is an instance of the specified BSON type. */
+    $type?: number | string | (number | string)[];
+    /** Matches documents where a field value divided by a divisor has a specified remainder. */
+    $mod?: [number, number];
+}
+/**
+ * Logical filter operators.
+ */
+export interface LogicalOperators<T> {
+    $and?: Filter<T>[];
+    $or?: Filter<T>[];
+    $nor?: Filter<T>[];
+}
+/**
+ * Text search operator for full-text search.
+ */
+export interface TextSearchOperator {
+    $search: string;
+}
+/**
+ * Filter type for querying documents.
+ * T is the document type.
+ */
+export type Filter<T> = {
+    [P in keyof T]?: T[P] | QueryOperators<T[P]>;
+} & {
+    [key: string]: unknown;
+} & Partial<LogicalOperators<T>> & {
+    $text?: TextSearchOperator;
+};
+/**
+ * Operators for updating documents.
+ * T is the document type.
+ */
+export interface UpdateOperators<T> {
+    $set?: {
+        [P in keyof T]?: T[P];
+    } & {
+        [key: string]: unknown;
+    };
+    $unset?: {
+        [P in keyof T]?: '';
+    } & {
+        [key: string]: '';
+    };
+    $inc?: {
+        [P in keyof T]?: number;
+    } & {
+        [key: string]: number;
+    };
+    $push?: {
+        [P in keyof T]?: unknown | {
+            $each: unknown[];
+        };
+    } & {
+        [key: string]: unknown | {
+            $each: unknown[];
+        };
+    };
+    $pull?: {
+        [P in keyof T]?: unknown;
+    } & {
+        [key: string]: unknown;
+    };
+    /** Adds a value to an array field only if the value is not already present. */
+    $addToSet?: {
+        [P in keyof T]?: unknown | {
+            $each: unknown[];
+        };
+    } & {
+        [key: string]: unknown | {
+            $each: unknown[];
+        };
+    };
+    /** Removes the first or last element from an array. Use 1 for last, -1 for first. */
+    $pop?: {
+        [P in keyof T]?: 1 | -1;
+    } & {
+        [key: string]: 1 | -1;
+    };
+    /** Multiplies the current value of a field by a number. */
+    $mul?: {
+        [P in keyof T]?: number;
+    } & {
+        [key: string]: number;
+    };
+    /** Updates the field value to the minimum of the current value and the specified value. */
+    $min?: {
+        [P in keyof T]?: T[P];
+    } & {
+        [key: string]: unknown;
+    };
+    /** Updates the field value to the maximum of the current value and the specified value. */
+    $max?: {
+        [P in keyof T]?: T[P];
+    } & {
+        [key: string]: unknown;
+    };
+    /** Sets the value of a field to the current date. */
+    $currentDate?: {
+        [P in keyof T]?: true | {
+            $type: 'date' | 'timestamp';
+        };
+    } & {
+        [key: string]: true | {
+            $type: 'date' | 'timestamp';
+        };
+    };
+}
+/**
+ * UpdateFilter type for updating documents.
+ */
+export type UpdateFilter<T> = Partial<UpdateOperators<T>>;
+/**
+ * SortCriteria type for sorting documents.
+ */
+export type SortCriteria<T> = {
+    [P in keyof T]?: 1 | -1;
+} & {
+    [key: string]: 1 | -1;
+};
+/**
+ * Projection type for selecting fields.
+ */
+export type Projection<T> = {
+    [P in keyof T]?: 0 | 1 | boolean;
+} & {
+    [key: string]: 0 | 1 | boolean;
+};
+/** * Represents a row in the SQLite database.
+ * The data field is a JSON string representing the document.
+ */
+export interface SQLiteRow {
+    _id: string;
+    data: string;
+}
+/**
+ * Index specification type.
+ * Specifies fields to index and their sort order (1 for ascending, -1 for descending).
+ */
+export type IndexSpecification = {
+    [key: string]: 1 | -1 | string;
+};
+/**
+ * Options for createIndex.
+ */
+export interface CreateIndexOptions {
+    /**
+     * Unique index flag. If true, the index will enforce uniqueness of the indexed field.
+     */
+    unique?: boolean;
+    /**
+     * Name of the index. If not specified, a name will be generated.
+     */
+    name?: string;
+    /**
+     * If true, create the index in the background and don't block other operations.
+     * In SQLite this might not make a significant difference.
+     */
+    background?: boolean;
+    /**
+     * If true, MongoDB will ignore any duplicate values when creating a unique index.
+     * Not directly applicable to SQLite, but retained for API compatibility.
+     */
+    sparse?: boolean;
+}
+/**
+ * Result of createIndex operation.
+ */
+export interface CreateIndexResult {
+    /**
+     * Indicates whether the index creation operation was acknowledged.
+     */
+    acknowledged: boolean;
+    /**
+     * The name of the created index.
+     */
+    name: string;
+}
+/**
+ * Result of dropIndex operation.
+ */
+export interface DropIndexResult {
+    /**
+     * Indicates whether the index deletion operation was acknowledged.
+     */
+    acknowledged: boolean;
+    /**
+     * The name of the dropped index.
+     */
+    name: string;
+}
+/**
+ * Result of a listIndexes operation.
+ */
+export interface IndexInfo {
+    /**
+     * Name of the index.
+     */
+    name: string;
+    /**
+     * The fields this index is defined on.
+     */
+    key: {
+        [key: string]: number;
+    };
+    /**
+     * Whether this index enforces uniqueness.
+     */
+    unique?: boolean;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/indexing.d.ts

@@ -0,0 +1,4 @@
+export declare function extractRawIndexColumns(sql: any): {
+    column: string;
+    direction: string | null;
+}[];

package/dist/utils/indexing.js

@@ -0,0 +1,43 @@
+export function extractRawIndexColumns(sql) {
+    const match = sql.match(/\(([\s\S]+)\)/); // allow multiline matching
+    if (!match)
+        return [];
+    const colsPart = match[1];
+    // Split on commas not inside parentheses
+    const columns = [];
+    let current = '';
+    let parens = 0;
+    for (let i = 0; i < colsPart.length; i++) {
+        const char = colsPart[i];
+        if (char === '(')
+            parens++;
+        if (char === ')')
+            parens--;
+        if (char === ',' && parens === 0) {
+            columns.push(current.trim());
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current.trim())
+        columns.push(current.trim());
+    return columns.map((col) => {
+        // Extract direction (ASC or DESC)
+        const directionMatch = col.match(/\s+(ASC|DESC)\s*$/i);
+        const direction = directionMatch ? directionMatch[1].toUpperCase() : null;
+        // Remove direction from column string
+        const colWithoutDirection = directionMatch
+            ? col.slice(0, directionMatch.index).trim()
+            : col.trim();
+        // Check for json_extract and pull out path
+        const jsonMatch = colWithoutDirection.match(/json_extract\s*\(\s*[^,]+,\s*'([^']+)'\s*\)/i);
+        let column = jsonMatch
+            ? jsonMatch[1] // the JSON path like '$.age'
+            : colWithoutDirection; // fallback to raw column like testCol
+        column = column.replace('$.', ''); // Remove leading $ if present
+        return { column, direction };
+    });
+}
+//# sourceMappingURL=indexing.js.map

package/dist/utils/indexing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexing.js","sourceRoot":"","sources":["../../src/utils/indexing.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB,CAAC,GAAG;IACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,2BAA2B;IACrE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAE1B,yCAAyC;IACzC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,KAAK,GAAG;YAAE,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,KAAK,GAAG,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7B,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAEjD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACzB,kCAAkC;QAClC,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAE1E,sCAAsC;QACtC,MAAM,mBAAmB,GAAG,cAAc;YACxC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;YAC3C,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAEf,2CAA2C;QAC3C,MAAM,SAAS,GAAG,mBAAmB,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC5F,IAAI,MAAM,GAAG,SAAS;YACpB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,6BAA6B;YAC5C,CAAC,CAAC,mBAAmB,CAAC,CAAC,sCAAsC;QAE/D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,8BAA8B;QACjE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/projection.d.ts

@@ -0,0 +1,16 @@
+import { DocumentWithId, Projection } from '../types.js';
+export type ProjectionMode = 'include' | 'exclude';
+/**
+ * Determines whether a projection is an inclusion or exclusion projection, matching MongoDB's
+ * rule: any explicit non-`_id` inclusion (1/true) puts it in inclusion mode; otherwise any
+ * explicit non-`_id` exclusion (0/false) puts it in exclusion mode; with only `_id` specified
+ * (or nothing), `_id: 0`/`false` means exclusion, everything else defaults to inclusion.
+ */
+export declare function resolveProjectionMode<T>(projection: Projection<T>): ProjectionMode;
+/**
+ * Applies a MongoDB-style projection to a single document, matching real MongoDB find()
+ * projection semantics: an empty/missing projection means no restriction, inclusion mode
+ * copies only listed fields (plus `_id` unless explicitly excluded), and exclusion mode copies
+ * everything except the listed fields. Supports dot-notation nested paths in both modes.
+ */
+export declare function applyProjectionToDocument<T extends DocumentWithId>(doc: T, projection: Projection<T> | null | undefined): T;

package/dist/utils/projection.js

@@ -0,0 +1,98 @@
+/**
+ * Determines whether a projection is an inclusion or exclusion projection, matching MongoDB's
+ * rule: any explicit non-`_id` inclusion (1/true) puts it in inclusion mode; otherwise any
+ * explicit non-`_id` exclusion (0/false) puts it in exclusion mode; with only `_id` specified
+ * (or nothing), `_id: 0`/`false` means exclusion, everything else defaults to inclusion.
+ */
+export function resolveProjectionMode(projection) {
+    let hasExplicitInclusion = false;
+    let hasExplicitExclusion = false;
+    for (const key of Object.keys(projection)) {
+        if (key === '_id')
+            continue;
+        const value = projection[key];
+        if (value === 1 || value === true) {
+            hasExplicitInclusion = true;
+            break;
+        }
+        if (value === 0 || value === false) {
+            hasExplicitExclusion = true;
+        }
+    }
+    if (hasExplicitInclusion)
+        return 'include';
+    if (hasExplicitExclusion)
+        return 'exclude';
+    return projection._id === 0 || projection._id === false ? 'exclude' : 'include';
+}
+/**
+ * Applies a MongoDB-style projection to a single document, matching real MongoDB find()
+ * projection semantics: an empty/missing projection means no restriction, inclusion mode
+ * copies only listed fields (plus `_id` unless explicitly excluded), and exclusion mode copies
+ * everything except the listed fields. Supports dot-notation nested paths in both modes.
+ */
+export function applyProjectionToDocument(doc, projection) {
+    if (!projection || Object.keys(projection).length === 0)
+        return doc;
+    const mode = resolveProjectionMode(projection);
+    const projectedDoc = {};
+    if (mode === 'include') {
+        for (const key in projection) {
+            const value = projection[key];
+            if (value !== 1 && value !== true)
+                continue;
+            if (key.includes('.')) {
+                const path = key.split('.');
+                let current = doc;
+                let target = projectedDoc;
+                for (let i = 0; i < path.length - 1; i++) {
+                    const segment = path[i];
+                    if (current[segment] === undefined || current[segment] === null)
+                        break;
+                    if (target[segment] === undefined) {
+                        target[segment] = {};
+                    }
+                    current = current[segment];
+                    target = target[segment];
+                }
+                const lastSegment = path[path.length - 1];
+                if (current && current[lastSegment] !== undefined) {
+                    target[lastSegment] = current[lastSegment];
+                }
+            }
+            else if (key in doc) {
+                projectedDoc[key] = doc[key];
+            }
+        }
+        if (projection._id !== 0 && projection._id !== false && '_id' in doc) {
+            projectedDoc._id = doc._id;
+        }
+    }
+    else {
+        Object.assign(projectedDoc, doc);
+        for (const key in projection) {
+            const value = projection[key];
+            if (value !== 0 && value !== false)
+                continue;
+            if (key.includes('.')) {
+                const path = key.split('.');
+                let current = projectedDoc;
+                for (let i = 0; i < path.length - 1; i++) {
+                    const segment = path[i];
+                    if (current[segment] === undefined)
+                        break;
+                    current = current[segment];
+                }
+                const lastSegment = path[path.length - 1];
+                if (current && current[lastSegment] !== undefined) {
+                    delete current[lastSegment];
+                }
+            }
+            else {
+                delete projectedDoc[key];
+            }
+        }
+    }
+    return projectedDoc;
+}
+//# sourceMappingURL=projection.js.map

package/dist/utils/projection.js.map

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

package/dist/utils/queryOperators.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared query-operator registry used by in-memory ($match) filtering. Kept in sync with the
+ * operator set `buildComparisonCondition` (src/cursors/findCursor.ts) supports for SQL-generated
+ * find() filtering, so the two engines can't silently drift apart on what an operator means —
+ * see tests/operator-coverage.test.ts, which runs the same filter through both engines.
+ */
+export declare const SUPPORTED_QUERY_OPERATORS: readonly ["$eq", "$ne", "$gt", "$gte", "$lt", "$lte", "$in", "$nin", "$all", "$exists", "$not", "$regex", "$size", "$type", "$mod"];
+/**
+ * Evaluates a single query operator against a document's field value. Used for in-memory
+ * filtering (e.g. aggregation `$match`) — the SQL-generating side (`buildComparisonCondition`)
+ * emits SQL fragments instead of booleans and stays separate, but should support the same
+ * operator set.
+ */
+export declare function evaluateOperator(op: string, docValue: unknown, opValue: unknown, regexOptions?: unknown): boolean;
+/** Evaluates every operator in `ops` against `docValue`, ANDing the results together. */
+export declare function evaluateOperators(docValue: unknown, ops: Record<string, unknown>): boolean;

package/dist/utils/queryOperators.js

@@ -0,0 +1,138 @@
+/**
+ * Shared query-operator registry used by in-memory ($match) filtering. Kept in sync with the
+ * operator set `buildComparisonCondition` (src/cursors/findCursor.ts) supports for SQL-generated
+ * find() filtering, so the two engines can't silently drift apart on what an operator means —
+ * see tests/operator-coverage.test.ts, which runs the same filter through both engines.
+ */
+export const SUPPORTED_QUERY_OPERATORS = [
+    '$eq',
+    '$ne',
+    '$gt',
+    '$gte',
+    '$lt',
+    '$lte',
+    '$in',
+    '$nin',
+    '$all',
+    '$exists',
+    '$not',
+    '$regex',
+    '$size',
+    '$type',
+    '$mod',
+];
+function matchesBsonType(value, bsonType) {
+    switch (bsonType) {
+        case 1:
+        case 'double':
+        case 'number':
+            return typeof value === 'number';
+        case 2:
+        case 'string':
+            return typeof value === 'string';
+        case 3:
+        case 'object':
+            return (typeof value === 'object' &&
+                value !== null &&
+                !Array.isArray(value) &&
+                !(value instanceof Date));
+        case 4:
+        case 'array':
+            return Array.isArray(value);
+        case 8:
+        case 'bool':
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 9:
+        case 'date':
+            return value instanceof Date;
+        case 10:
+        case 'null':
+            return value === null;
+        case 16:
+        case 'int':
+        case 18:
+        case 'long':
+            return typeof value === 'number' && Number.isInteger(value);
+        default:
+            return false;
+    }
+}
+/**
+ * Evaluates a single query operator against a document's field value. Used for in-memory
+ * filtering (e.g. aggregation `$match`) — the SQL-generating side (`buildComparisonCondition`)
+ * emits SQL fragments instead of booleans and stays separate, but should support the same
+ * operator set.
+ */
+export function evaluateOperator(op, docValue, opValue, regexOptions) {
+    switch (op) {
+        case '$eq':
+            return JSON.stringify(docValue) === JSON.stringify(opValue);
+        case '$ne':
+            return JSON.stringify(docValue) !== JSON.stringify(opValue);
+        case '$gt':
+            return docValue > opValue;
+        case '$gte':
+            return docValue >= opValue;
+        case '$lt':
+            return docValue < opValue;
+        case '$lte':
+            return docValue <= opValue;
+        case '$in':
+            if (!Array.isArray(opValue))
+                return false;
+            if (Array.isArray(docValue)) {
+                return docValue.some((el) => opValue.some((v) => JSON.stringify(el) === JSON.stringify(v)));
+            }
+            return opValue.some((v) => JSON.stringify(v) === JSON.stringify(docValue));
+        case '$nin':
+            if (!Array.isArray(opValue))
+                return false;
+            if (Array.isArray(docValue)) {
+                return !docValue.some((el) => opValue.some((v) => JSON.stringify(el) === JSON.stringify(v)));
+            }
+            return !opValue.some((v) => JSON.stringify(v) === JSON.stringify(docValue));
+        case '$all':
+            if (!Array.isArray(opValue) || !Array.isArray(docValue))
+                return false;
+            return opValue.every((item) => docValue.some((el) => JSON.stringify(el) === JSON.stringify(item)));
+        case '$exists':
+            return opValue ? docValue !== undefined : docValue === undefined;
+        case '$not':
+            return !evaluateOperators(docValue, opValue);
+        case '$regex': {
+            const pattern = opValue instanceof RegExp
+                ? opValue
+                : new RegExp(opValue, typeof regexOptions === 'string' ? regexOptions : undefined);
+            return pattern.test(String(docValue));
+        }
+        case '$size':
+            return Array.isArray(docValue) && docValue.length === opValue;
+        case '$type': {
+            const types = Array.isArray(opValue) ? opValue : [opValue];
+            return types.some((t) => matchesBsonType(docValue, t));
+        }
+        case '$mod': {
+            if (!Array.isArray(opValue) || opValue.length !== 2 || typeof docValue !== 'number')
+                return false;
+            const [divisor, remainder] = opValue;
+            return Math.trunc(docValue) % divisor === remainder;
+        }
+        case '$options':
+            return true; // consumed alongside $regex, not an independent predicate
+        default:
+            return false; // unsupported operator — conservative: never matches, rather than silently no-op
+    }
+}
+/** Evaluates every operator in `ops` against `docValue`, ANDing the results together. */
+export function evaluateOperators(docValue, ops) {
+    const regexOptions = ops['$options'];
+    for (const [op, opValue] of Object.entries(ops)) {
+        if (op === '$options')
+            continue;
+        if (!evaluateOperator(op, docValue, opValue, regexOptions))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=queryOperators.js.map

package/dist/utils/queryOperators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryOperators.js","sourceRoot":"","sources":["../../src/utils/queryOperators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,SAAS;IACT,MAAM;IACN,QAAQ;IACR,OAAO;IACP,OAAO;IACP,MAAM;CACE,CAAC;AAEX,SAAS,eAAe,CAAC,KAAc,EAAE,QAAyB;IAChE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,CAAC,CAAC;QACP,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;QACnC,KAAK,CAAC,CAAC;QACP,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;QACnC,KAAK,CAAC,CAAC;QACP,KAAK,QAAQ;YACX,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;gBACzB,KAAK,KAAK,IAAI;gBACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBACrB,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,CACzB,CAAC;QACJ,KAAK,CAAC,CAAC;QACP,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,KAAK,CAAC,CAAC;QACP,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;QACpC,KAAK,CAAC,CAAC;QACP,KAAK,MAAM;YACT,OAAO,KAAK,YAAY,IAAI,CAAC;QAC/B,KAAK,EAAE,CAAC;QACR,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,IAAI,CAAC;QACxB,KAAK,EAAE,CAAC;QACR,KAAK,KAAK,CAAC;QACX,KAAK,EAAE,CAAC;QACR,KAAK,MAAM;YACT,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9D;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAU,EACV,QAAiB,EACjB,OAAgB,EAChB,YAAsB;IAEtB,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,KAAK;YACR,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC9D,KAAK,KAAK;YACR,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC9D,KAAK,KAAK;YACR,OAAQ,QAAmB,GAAI,OAAkB,CAAC;QACpD,KAAK,MAAM;YACT,OAAQ,QAAmB,IAAK,OAAkB,CAAC;QACrD,KAAK,KAAK;YACR,OAAQ,QAAmB,GAAI,OAAkB,CAAC;QACpD,KAAK,MAAM;YACT,OAAQ,QAAmB,IAAK,OAAkB,CAAC;QACrD,KAAK,KAAK;YACR,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9F,CAAC;YACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7E,KAAK,MAAM;YACT,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAC9D,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9E,KAAK,MAAM;YACT,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5B,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CACnE,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC;QACnE,KAAK,MAAM;YACT,OAAO,CAAC,iBAAiB,CAAC,QAAQ,EAAE,OAAkC,CAAC,CAAC;QAC1E,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,OAAO,GACX,OAAO,YAAY,MAAM;gBACvB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,IAAI,MAAM,CACR,OAAiB,EACjB,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAC5D,CAAC;YACR,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAM,OAAkB,CAAC;QAC5E,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAoB,CAAC,CAAC,CAAC;QAC5E,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,QAAQ,KAAK,QAAQ;gBACjF,OAAO,KAAK,CAAC;YACf,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,OAA2B,CAAC;YACzD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,KAAK,SAAS,CAAC;QACtD,CAAC;QACD,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,CAAC,0DAA0D;QACzE;YACE,OAAO,KAAK,CAAC,CAAC,iFAAiF;IACnG,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,iBAAiB,CAAC,QAAiB,EAAE,GAA4B;IAC/E,MAAM,YAAY,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,EAAE,KAAK,UAAU;YAAE,SAAS;QAChC,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC;YAAE,OAAO,KAAK,CAAC;IAC3E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}