@liorandb/core 1.0.13 → 1.0.15

package/dist/index.d.ts

@@ -1,6 +1,26 @@
 import { ClassicLevel } from 'classic-level';
 import { ZodSchema } from 'zod';
 
+interface IndexOptions {
+    unique?: boolean;
+}
+declare class Index {
+    readonly field: string;
+    readonly unique: boolean;
+    readonly dir: string;
+    readonly db: ClassicLevel<string, string>;
+    constructor(baseDir: string, field: string, options?: IndexOptions);
+    private normalizeKey;
+    private getRaw;
+    private setRaw;
+    private delRaw;
+    insert(doc: any): Promise<void>;
+    delete(doc: any): Promise<void>;
+    update(oldDoc: any, newDoc: any): Promise<void>;
+    find(value: any): Promise<string[]>;
+    close(): Promise<void>;
+}
+
 interface UpdateOptions$1 {
     upsert?: boolean;
 }
@@ -9,34 +29,36 @@ declare class Collection<T = any> {
     db: ClassicLevel<string, string>;
     private queue;
     private schema?;
+    private indexes;
     constructor(dir: string, schema?: ZodSchema<T>);
+    registerIndex(index: Index): void;
+    getIndex(field: string): Index | undefined;
     setSchema(schema: ZodSchema<T>): void;
     private validate;
     private _enqueue;
     close(): Promise<void>;
+    compact(): Promise<void>;
     _exec(op: string, args: any[]): Promise<any>;
-    insertOne(doc: T & {
-        _id?: string;
-    }): Promise<any>;
-    insertMany(docs?: (T & {
-        _id?: string;
-    })[]): Promise<any>;
-    find(query?: any): Promise<any>;
-    findOne(query?: any): Promise<any>;
-    updateOne(filter: any, update: any, options?: UpdateOptions$1): Promise<any>;
-    updateMany(filter: any, update: any): Promise<any>;
-    deleteOne(filter: any): Promise<any>;
-    deleteMany(filter: any): Promise<any>;
-    countDocuments(filter?: any): Promise<any>;
+    private _updateIndexes;
     private _insertOne;
     private _insertMany;
+    private _getCandidateIds;
+    private _find;
     private _findOne;
+    private _countDocuments;
     private _updateOne;
     private _updateMany;
-    private _find;
     private _deleteOne;
     private _deleteMany;
-    private _countDocuments;
+    insertOne(doc: any): Promise<any>;
+    insertMany(docs: any[]): Promise<any>;
+    find(query?: any): Promise<any>;
+    findOne(query?: any): Promise<any>;
+    updateOne(filter: any, update: any, options?: UpdateOptions$1): Promise<any>;
+    updateMany(filter: any, update: any): Promise<any>;
+    deleteOne(filter: any): Promise<any>;
+    deleteMany(filter: any): Promise<any>;
+    countDocuments(filter?: any): Promise<any>;
 }
 
 type TXOp = {
@@ -68,13 +90,26 @@ declare class LioranDB {
     manager: LioranManager;
     collections: Map<string, Collection>;
     private walPath;
+    private metaPath;
+    private meta;
     private static TX_SEQ;
     constructor(basePath: string, dbName: string, manager: LioranManager);
+    private loadMeta;
+    private saveMeta;
     writeWAL(entries: WALEntry[]): Promise<void>;
     clearWAL(): Promise<void>;
     private recoverFromWAL;
     applyTransaction(ops: TXOp[]): Promise<void>;
     collection<T = any>(name: string, schema?: ZodSchema<T>): Collection<T>;
+    createIndex(collection: string, field: string, options?: IndexOptions): Promise<void>;
+    /**
+     * Compact single collection safely (WAL + TX safe)
+     */
+    compactCollection(name: string): Promise<void>;
+    /**
+     * Compact entire database safely
+     */
+    compactAll(): Promise<void>;
     transaction<T>(fn: (tx: DBTransactionContext) => Promise<T>): Promise<T>;
     close(): Promise<void>;
 }
@@ -114,5 +149,35 @@ interface UpdateOptions {
 type Query<T = any> = Partial<T> & {
     [key: string]: any;
 };
+type IndexType = "hash" | "btree";
+interface IndexDefinition<T = any> {
+    field: keyof T | string;
+    unique?: boolean;
+    sparse?: boolean;
+    type?: IndexType;
+}
+interface IndexMetadata {
+    field: string;
+    unique: boolean;
+    sparse: boolean;
+    type: IndexType;
+    createdAt: number;
+}
+interface QueryExplainPlan {
+    indexUsed?: string;
+    indexType?: IndexType;
+    scannedDocuments: number;
+    returnedDocuments: number;
+    executionTimeMs: number;
+}
+interface CollectionIndexAPI<T = any> {
+    createIndex(def: IndexDefinition<T>): Promise<void>;
+    dropIndex(field: keyof T | string): Promise<void>;
+    listIndexes(): Promise<IndexMetadata[]>;
+    rebuildIndexes(): Promise<void>;
+}
+interface DatabaseIndexAPI {
+    rebuildAllIndexes(): Promise<void>;
+}
 
-export { LioranDB, LioranManager, type LioranManagerOptions, type Query, type UpdateOptions, getBaseDBFolder };
+export { type CollectionIndexAPI, type DatabaseIndexAPI, type IndexDefinition, type IndexMetadata, type IndexType, LioranDB, LioranManager, type LioranManagerOptions, type Query, type QueryExplainPlan, type UpdateOptions, getBaseDBFolder };