mongolite-ts 0.3.0 → 0.5.0

package/dist/document-utils.js.map

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

package/dist/find-cursor.d.ts

@@ -0,0 +1,51 @@
+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

@@ -0,0 +1,204 @@
+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

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

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { MongoLiteOptions as DBMongoLiteOptions } from './db.js';
+import { SQLiteDB, MongoLiteOptions as DBMongoLiteOptions } from './db.js';
 import { MongoLiteCollection } from './collection.js';
 import { DocumentWithId } from './types.js';
 export { MongoLiteCollection } from './collection.js';
@@ -20,10 +20,15 @@ export declare class MongoLite {
      */
     constructor(dbPathOrOptions: string | MongoLiteClientOptions, options?: MongoLiteOptions);
     /**
-     * Connects to the database.
-     * Note: Most operations will auto-connect if needed.
+     * Connects to the SQLite database.
+     * @returns {Promise<void>} A promise that resolves when connected.
      */
     connect(): Promise<void>;
+    /**
+     * Get the underlying SQLiteDB instance for advanced operations or testing.
+     * @returns {SQLiteDB} The SQLiteDB instance.
+     */
+    get database(): SQLiteDB;
     /**
      * Closes the database connection.
      */

package/dist/index.js

@@ -15,12 +15,19 @@ export class MongoLite {
         this.options = options;
     }
     /**
-     * Connects to the database.
-     * Note: Most operations will auto-connect if needed.
+     * Connects to the SQLite database.
+     * @returns {Promise<void>} A promise that resolves when connected.
      */
     async connect() {
         return this.db.connect();
     }
+    /**
+     * Get the underlying SQLiteDB instance for advanced operations or testing.
+     * @returns {SQLiteDB} The SQLiteDB instance.
+     */
+    get database() {
+        return this.db;
+    }
     /**
      * Closes the database connection.
      */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA0C,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,YAAY,CAAC;AAO3B;;GAEG;AACH,MAAM,OAAO,SAAS;IAIpB;;;OAGG;IACH,YAAY,eAAgD,EAAE,UAA4B,EAAE;QAC1F,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,eAAe,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,yDAAyD;QACzD,OAAO;YACL,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAC9B,gFAAgF,CACjF,CAAC;gBACF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,UAAU,CAA4C,IAAY;QAChE,OAAO,IAAI,mBAAmB,CAAI,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA0C,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,YAAY,CAAC;AAO3B;;GAEG;AACH,MAAM,OAAO,SAAS;IAIpB;;;OAGG;IACH,YAAY,eAAgD,EAAE,UAA4B,EAAE;QAC1F,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,eAAe,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,yDAAyD;QACzD,OAAO;YACL,OAAO,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAC9B,gFAAgF,CACjF,CAAC;gBACF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,UAAU,CAA4C,IAAY;QAChE,OAAO,IAAI,mBAAmB,CAAI,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/query-builder.d.ts

@@ -0,0 +1,18 @@
+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;
+}