mongolite-ts 0.2.2 → 0.2.4

package/dist/types.d.ts

@@ -3,7 +3,7 @@
  */
 export interface DocumentWithId {
     _id?: string;
-    [key: string]: any;
+    [key: string]: unknown;
 }
 /**
  * Result of insertOne operation.
@@ -52,6 +52,12 @@ export interface LogicalOperators<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.
@@ -59,8 +65,10 @@ export interface LogicalOperators<T> {
 export type Filter<T> = {
     [P in keyof T]?: T[P] | QueryOperators<T[P]>;
 } & {
-    [key: string]: any;
-} & Partial<LogicalOperators<T>>;
+    [key: string]: unknown;
+} & Partial<LogicalOperators<T>> & {
+    $text?: TextSearchOperator;
+};
 /**
  * Operators for updating documents.
  * T is the document type.
@@ -69,7 +77,7 @@ export interface UpdateOperators<T> {
     $set?: {
         [P in keyof T]?: T[P];
     } & {
-        [key: string]: any;
+        [key: string]: unknown;
     };
     $unset?: {
         [P in keyof T]?: '';
@@ -82,18 +90,18 @@ export interface UpdateOperators<T> {
         [key: string]: number;
     };
     $push?: {
-        [P in keyof T]?: any | {
-            $each: any[];
+        [P in keyof T]?: unknown | {
+            $each: unknown[];
         };
     } & {
-        [key: string]: any | {
-            $each: any[];
+        [key: string]: unknown | {
+            $each: unknown[];
         };
     };
     $pull?: {
-        [P in keyof T]?: any;
+        [P in keyof T]?: unknown;
     } & {
-        [key: string]: any;
+        [key: string]: unknown;
     };
 }
 /**
@@ -123,3 +131,78 @@ 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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mongolite-ts",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "A MongoDB-like client using SQLite as a persistent store, written in TypeScript.",
   "main": "dist/index.js",
   "type": "module",
@@ -14,7 +14,8 @@
     "lint:fix": "eslint src/**/*.ts tests/**/*.ts --fix",
     "verify-build": "node --import tsx scripts/verify-build.js",
     "test-third-party": "node scripts/test-third-party-usage.js",
-    "test:all": "npm run lint && npm run test && npm run verify-build && npm run test-third-party"
+    "test:all": "npm run lint && npm run test && npm run verify-build && npm run test-third-party",
+    "benchmark": "npx tsx scripts/benchmark.ts"
   },
   "repository": {
     "type": "git",
@@ -37,10 +38,10 @@
   "homepage": "https://github.com/semics-tech/mongolite-ts#readme",
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^20.17.57",
+    "@types/node": "^24.0.7",
     "@typescript-eslint/eslint-plugin": "^7.9.0",
     "@typescript-eslint/parser": "^7.9.0",
-    "c8": "^9.1.0",
+    "c8": "^10.1.3",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.1.3",
@@ -53,7 +54,7 @@
     "@types/uuid": "^9.0.8",
     "better-sqlite3": "^12.1.1",
     "bson": "^6.10.4",
-    "uuid": "^9.0.1"
+    "uuid": "^11.1.0"
   },
   "files": [
     "dist/**/*",

package/dist/document-utils.d.ts

@@ -1,34 +0,0 @@
-/**
- * Utility functions for working with document objects
- */
-/**
- * Sets a nested value in an object using dot notation.
- * @param obj The object to modify.
- * @param path The dot notation path (e.g., 'user.profile.name').
- * @param value The value to set.
- */
-export declare function setNestedValue(obj: any, path: string, value: any): void;
-/**
- * Removes a nested property from an object using dot notation.
- * @param obj The object to modify.
- * @param path The dot notation path (e.g., 'user.profile.name').
- */
-export declare function unsetNestedValue(obj: any, path: string): void;
-/**
- * Gets a nested value from an object using dot notation.
- * @param obj The object to query.
- * @param path The dot notation path (e.g., 'user.profile.name').
- * @returns The value at the path, or undefined if the path doesn't exist.
- */
-export declare function getNestedValue(obj: any, path: string): any;
-/**
- * Generate a retry function with exponential backoff
- * @param operation The async operation to retry
- * @param operationDescription Description for logging
- * @param maxRetries Maximum number of retries
- * @param initialDelayMs Initial delay between retries (ms)
- * @param maxDelayMs Maximum delay between retries (ms)
- * @returns The result of the operation if successful
- * @throws The original error if all retries fail
- */
-export declare function retryWithBackoff<R>(operation: () => Promise<R>, operationDescription: string, maxRetries?: number, initialDelayMs?: number, maxDelayMs?: number): Promise<R>;

package/dist/document-utils.js

@@ -1,101 +0,0 @@
-/**
- * Utility functions for working with document objects
- */
-/**
- * Sets a nested value in an object using dot notation.
- * @param obj The object to modify.
- * @param path The dot notation path (e.g., 'user.profile.name').
- * @param value The value to set.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function setNestedValue(obj, path, value) {
-    const keys = path.split('.');
-    let current = obj;
-    // Navigate to the last parent in the path
-    for (let i = 0; i < keys.length - 1; i++) {
-        const key = keys[i];
-        // Create nested objects if they don't exist
-        if (current[key] === undefined || current[key] === null) {
-            current[key] = {};
-        }
-        else if (typeof current[key] !== 'object') {
-            // If the path exists but is not an object, make it an object
-            current[key] = {};
-        }
-        current = current[key];
-    }
-    // Set the value at the final key
-    current[keys[keys.length - 1]] = value;
-}
-/**
- * Removes a nested property from an object using dot notation.
- * @param obj The object to modify.
- * @param path The dot notation path (e.g., 'user.profile.name').
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function unsetNestedValue(obj, path) {
-    const keys = path.split('.');
-    let current = obj;
-    // Navigate to the last parent in the path
-    for (let i = 0; i < keys.length - 1; i++) {
-        const key = keys[i];
-        if (current[key] === undefined || current[key] === null) {
-            // If the path doesn't exist, nothing to unset
-            return;
-        }
-        current = current[key];
-    }
-    // Delete the property at the final key
-    delete current[keys[keys.length - 1]];
-}
-/**
- * Gets a nested value from an object using dot notation.
- * @param obj The object to query.
- * @param path The dot notation path (e.g., 'user.profile.name').
- * @returns The value at the path, or undefined if the path doesn't exist.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function getNestedValue(obj, path) {
-    const keys = path.split('.');
-    let current = obj;
-    // Navigate through the path
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        if (current === undefined || current === null) {
-            return undefined;
-        }
-        current = current[key];
-    }
-    return current;
-}
-/**
- * Generate a retry function with exponential backoff
- * @param operation The async operation to retry
- * @param operationDescription Description for logging
- * @param maxRetries Maximum number of retries
- * @param initialDelayMs Initial delay between retries (ms)
- * @param maxDelayMs Maximum delay between retries (ms)
- * @returns The result of the operation if successful
- * @throws The original error if all retries fail
- */
-export async function retryWithBackoff(operation, operationDescription, maxRetries = 5, initialDelayMs = 100, maxDelayMs = 10000) {
-    let retries = 0;
-    let delayMs = initialDelayMs;
-    while (true) {
-        try {
-            return await operation();
-        }
-        catch (error) {
-            if (error.code !== 'SQLITE_BUSY' || retries >= maxRetries) {
-                throw error;
-            }
-            console.warn(`SQLITE_BUSY encountered during ${operationDescription}, retrying (${retries + 1}/${maxRetries})...`);
-            // Wait for the backoff period
-            await new Promise((resolve) => setTimeout(resolve, delayMs));
-            // Increase delay for next retry (exponential backoff)
-            delayMs = Math.min(delayMs * 2, maxDelayMs);
-            retries++;
-        }
-    }
-}
-//# sourceMappingURL=document-utils.js.map

package/dist/document-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"document-utils.js","sourceRoot":"","sources":["../src/document-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAY,EAAE,KAAU;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAG,GAAG,CAAC;IAElB,0CAA0C;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,4CAA4C;QAC5C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC;aAAM,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC5C,6DAA6D;YAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC;QAED,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,iCAAiC;IACjC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,GAAQ,EAAE,IAAY;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAG,GAAG,CAAC;IAElB,0CAA0C;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,8CAA8C;YAC9C,OAAO;QACT,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,uCAAuC;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,IAAY;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,OAAO,GAAG,GAAG,CAAC;IAElB,4BAA4B;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAA2B,EAC3B,oBAA4B,EAC5B,UAAU,GAAG,CAAC,EACd,cAAc,GAAG,GAAG,EACpB,UAAU,GAAG,KAAK;IAElB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,cAAc,CAAC;IAE7B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;gBACrF,MAAM,KAAK,CAAC;YACd,CAAC;YAED,OAAO,CAAC,IAAI,CACV,kCAAkC,oBAAoB,eAAe,OAAO,GAAG,CAAC,IAAI,UAAU,MAAM,CACrG,CAAC;YAEF,8BAA8B;YAC9B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YAE7D,sDAAsD;YACtD,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;YAC5C,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/find-cursor.d.ts

@@ -1,51 +0,0 @@
-import { DocumentWithId, Filter, SortCriteria, Projection } from './types.js';
-import { SQLiteDB } from './db.js';
-/**
- * Represents a cursor for find operations, allowing chaining of limit, skip, and sort.
- */
-export declare class FindCursor<T extends DocumentWithId> {
-    private db;
-    private collectionName;
-    private readonly options;
-    private queryParts;
-    private limitCount;
-    private skipCount;
-    private sortCriteria;
-    private projectionFields;
-    private queryBuilder;
-    constructor(db: SQLiteDB, collectionName: string, initialFilter: Filter<T>, options?: {
-        verbose?: boolean;
-    });
-    private buildSelectQuery;
-    /**
-     * Specifies the maximum number of documents the cursor will return.
-     * @param count The number of documents to limit to.
-     * @returns The `FindCursor` instance for chaining.
-     */
-    limit(count: number): this;
-    /**
-     * Specifies the number of documents to skip.
-     * @param count The number of documents to skip.
-     * @returns The `FindCursor` instance for chaining.
-     */
-    skip(count: number): this;
-    /**
-     * Specifies the sorting order for the documents.
-     * @param sortCriteria An object defining sort order (e.g., `{ age: -1, name: 1 }`).
-     * @returns The `FindCursor` instance for chaining.
-     */
-    sort(sortCriteria: SortCriteria<T>): this;
-    /**
-     * Specifies the fields to return (projection).
-     * @param projection An object where keys are field names and values are 1 (include) or 0 (exclude).
-     * `_id` is included by default unless explicitly excluded.
-     * @returns The `FindCursor` instance for chaining.
-     */
-    project(projection: Projection<T>): this;
-    private applyProjection;
-    /**
-     * Executes the query and returns all matching documents as an array.
-     * @returns A promise that resolves to an array of documents.
-     */
-    toArray(): Promise<Partial<T>[]>;
-}

package/dist/find-cursor.js

@@ -1,204 +0,0 @@
-import { QueryBuilder } from './query-builder.js';
-/**
- * Represents a cursor for find operations, allowing chaining of limit, skip, and sort.
- */
-export class FindCursor {
-    constructor(db, collectionName, initialFilter, options = {}) {
-        this.db = db;
-        this.collectionName = collectionName;
-        this.options = options;
-        this.limitCount = null;
-        this.skipCount = null;
-        this.sortCriteria = null;
-        this.projectionFields = null;
-        this.queryBuilder = new QueryBuilder(options);
-        this.queryParts = this.buildSelectQuery(initialFilter);
-    }
-    buildSelectQuery(filter) {
-        const params = [];
-        const whereClause = this.queryBuilder.buildWhereClause(filter, params);
-        const sql = `SELECT _id, data FROM "${this.collectionName}" WHERE ${whereClause}`;
-        if (this.options.verbose) {
-            console.log(`SQL Query: ${sql}`);
-            console.log(`Parameters: ${JSON.stringify(params)}`);
-        }
-        return { sql, params };
-    }
-    /**
-     * Specifies the maximum number of documents the cursor will return.
-     * @param count The number of documents to limit to.
-     * @returns The `FindCursor` instance for chaining.
-     */
-    limit(count) {
-        if (count < 0)
-            throw new Error('Limit must be a non-negative number.');
-        this.limitCount = count;
-        return this;
-    }
-    /**
-     * Specifies the number of documents to skip.
-     * @param count The number of documents to skip.
-     * @returns The `FindCursor` instance for chaining.
-     */
-    skip(count) {
-        if (count < 0)
-            throw new Error('Skip must be a non-negative number.');
-        this.skipCount = count;
-        return this;
-    }
-    /**
-     * Specifies the sorting order for the documents.
-     * @param sortCriteria An object defining sort order (e.g., `{ age: -1, name: 1 }`).
-     * @returns The `FindCursor` instance for chaining.
-     */
-    sort(sortCriteria) {
-        this.sortCriteria = sortCriteria;
-        return this;
-    }
-    /**
-     * Specifies the fields to return (projection).
-     * @param projection An object where keys are field names and values are 1 (include) or 0 (exclude).
-     * `_id` is included by default unless explicitly excluded.
-     * @returns The `FindCursor` instance for chaining.
-     */
-    project(projection) {
-        this.projectionFields = projection;
-        return this;
-    }
-    applyProjection(doc) {
-        if (!this.projectionFields)
-            return doc;
-        const projectedDoc = {};
-        let includeMode = true; // true if any field is 1, false if any field is 0 (excluding _id)
-        let hasExplicitInclusion = false;
-        // Determine if it's an inclusion or exclusion projection
-        for (const key in this.projectionFields) {
-            if (key === '_id')
-                continue;
-            if (this.projectionFields[key] === 1 ||
-                this.projectionFields[key] === true) {
-                hasExplicitInclusion = true;
-                break;
-            }
-            if (this.projectionFields[key] === 0 ||
-                this.projectionFields[key] === false) {
-                includeMode = false;
-                // No break here, need to check all for explicit inclusions if _id is also 0
-            }
-        }
-        if ((this.projectionFields._id === 0 || this.projectionFields._id === false) &&
-            !hasExplicitInclusion) {
-            // If _id is excluded and no other fields are explicitly included,
-            // it's an exclusion projection where other fields are implicitly included.
-            includeMode = false;
-        }
-        else if (hasExplicitInclusion) {
-            includeMode = true;
-        }
-        if (includeMode) {
-            // Inclusion mode
-            for (const key in this.projectionFields) {
-                if (this.projectionFields[key] === 1 ||
-                    this.projectionFields[key] === true) {
-                    if (key.includes('.')) {
-                        // Handle nested paths for inclusion (basic implementation)
-                        const path = key.split('.');
-                        let current = doc;
-                        let target = projectedDoc;
-                        // Navigate to the last parent in the path
-                        for (let i = 0; i < path.length - 1; i++) {
-                            const segment = path[i];
-                            if (current[segment] === undefined)
-                                break;
-                            if (target[segment] === undefined) {
-                                target[segment] = {};
-                            }
-                            current = current[segment];
-                            target = target[segment];
-                        }
-                        // Set the final property if we reached it
-                        const lastSegment = path[path.length - 1];
-                        if (current && current[lastSegment] !== undefined) {
-                            target[lastSegment] = current[lastSegment];
-                        }
-                    }
-                    else if (key in doc) {
-                        projectedDoc[key] = doc[key];
-                    }
-                }
-            }
-            // _id is included by default in inclusion mode, unless explicitly excluded
-            if (this.projectionFields._id !== 0 && this.projectionFields._id !== false && '_id' in doc) {
-                projectedDoc._id = doc._id;
-            }
-        }
-        else {
-            // Exclusion mode
-            Object.assign(projectedDoc, doc);
-            for (const key in this.projectionFields) {
-                if (this.projectionFields[key] === 0 ||
-                    this.projectionFields[key] === false) {
-                    if (key.includes('.')) {
-                        // Handle nested paths for exclusion (basic implementation)
-                        const path = key.split('.');
-                        let current = projectedDoc;
-                        // Navigate to the parent of the property to exclude
-                        for (let i = 0; i < path.length - 1; i++) {
-                            const segment = path[i];
-                            if (current[segment] === undefined)
-                                break;
-                            current = current[segment];
-                        }
-                        // Delete the final property if we reached its parent
-                        const lastSegment = path[path.length - 1];
-                        if (current && current[lastSegment] !== undefined) {
-                            delete current[lastSegment];
-                        }
-                    }
-                    else {
-                        delete projectedDoc[key];
-                    }
-                }
-            }
-        }
-        return projectedDoc;
-    }
-    /**
-     * Executes the query and returns all matching documents as an array.
-     * @returns A promise that resolves to an array of documents.
-     */
-    async toArray() {
-        let finalSql = this.queryParts.sql;
-        const finalParams = [...this.queryParts.params];
-        if (this.sortCriteria) {
-            const sortClauses = Object.entries(this.sortCriteria).map(([field, order]) => {
-                if (field === '_id') {
-                    return `_id ${order === 1 ? 'ASC' : 'DESC'}`;
-                }
-                return `json_extract(data, ${this.queryBuilder.parseJsonPath(field)}) ${order === 1 ? 'ASC' : 'DESC'}`;
-            });
-            if (sortClauses.length > 0) {
-                finalSql += ` ORDER BY ${sortClauses.join(', ')}`;
-            }
-        }
-        if (this.limitCount !== null) {
-            finalSql += ` LIMIT ?`;
-            finalParams.push(this.limitCount);
-        }
-        if (this.skipCount !== null) {
-            if (this.limitCount === null) {
-                // SQLite requires a LIMIT if OFFSET is used.
-                // Use a very large number if no limit is specified.
-                finalSql += ` LIMIT -1`; // Or a large number like 999999999
-            }
-            finalSql += ` OFFSET ?`;
-            finalParams.push(this.skipCount);
-        }
-        const rows = await this.db.all(finalSql, finalParams);
-        return rows.map((row) => {
-            const doc = { _id: row._id, ...JSON.parse(row.data) };
-            return this.applyProjection(doc);
-        });
-    }
-}
-//# sourceMappingURL=find-cursor.js.map

package/dist/find-cursor.js.map

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

package/dist/query-builder.d.ts

@@ -1,18 +0,0 @@
-import { Filter, DocumentWithId } from './types.js';
-export declare class QueryBuilder<T extends DocumentWithId> {
-    private readonly options;
-    constructor(options?: {
-        verbose?: boolean;
-    });
-    /**
-     * Converts a field path to a JSON path for SQLite's json_extract function.
-     */
-    parseJsonPath(path: string): string;
-    /**
-     * Builds a WHERE clause for a filter object.
-     * @param filter The filter object.
-     * @param params An array to collect query parameters.
-     * @returns A SQL WHERE clause.
-     */
-    buildWhereClause(filter: Filter<T>, params: unknown[]): string;
-}