@medyll/idae-idbql 0.65.0 → 0.67.0

package/dist/idbqlCore/idbqlCore.d.ts

@@ -1,76 +1,11 @@
-import { CollectionCore } from "../collection/collection.svelte.js";
-import { type StateCollectionDyn } from "../state/idbstate.svelte.js";
-export declare enum enumPrimitive {
-    id = "id",
-    any = "any",
-    date = "date",
-    text = "text",
-    number = "number",// IdbqModelCollectionTemplate
-    boolean = "boolean",
-    datetime = "datetime",
-    url = "url",
-    email = "email",
-    phone = "phone",
-    time = "time",
-    password = "password"
-}
-export declare enum TplProperties {
-    private = "private",
-    readonly = "readonly",
-    required = "required"
-}
-type CombineElements<T extends string, U extends string = T> = T extends any ? T | `${T} ${CombineElements<Exclude<U, T>>}` : never;
-type CombinedArgs = CombineElements<TplProperties>;
-type IdbObjectify<T extends string> = `array-of-${T}` | `object-${T}`;
-export type TplCollectionFields = Record<string, string>;
-export type TplFieldPrimitive<T = {}> = keyof typeof enumPrimitive | `text-${"tiny" | "short" | "medium" | "long" | "area"}` | `${string}.${string}` | `fk-${string}.${string}`;
-export type TplObjectFieldPrimitive = IdbObjectify<TplFieldPrimitive>;
-export type TplFieldFk = `fk-${string}.${string}`;
-export type TplFkObject = IdbObjectify<TplFieldFk>;
-export type TplTypes = TplFieldPrimitive | TplObjectFieldPrimitive | TplFieldFk | TplFkObject;
-export type TplFieldArgs = `${TplTypes} (${CombinedArgs})`;
-/** rules */
-export type TplFieldRules = TplFieldArgs | TplTypes;
-export type TplFieldType = TplFieldArgs | TplTypes;
-export type IDbForge = {
-    collection?: TplCollectionName;
-    fieldName?: keyof TplFields;
-    fieldType?: TplFieldType;
-    fieldRule?: TplFieldRules;
-    fieldArgs?: [keyof typeof TplProperties] | undefined;
-    is: any;
-};
-export type IdbqModel<T = Record<string, Record<string, any>>> = {
-    readonly [K in keyof T]: CollectionModel<T[K]>;
-};
-export type TplCollectionName<T = TplCollectionFields> = keyof IdbqModel<T>;
-export type Tpl<T = TplCollectionFields> = CollectionModel<T>["template"];
-export type TplFields<T = TplCollectionFields> = CollectionModel<T>["template"]["fields"];
-export type CollectionModel<T = TplCollectionFields> = {
-    keyPath: string | any;
-    /** @deprecated use ts instead */
-    model: any;
-    ts: any;
-    template: {
-        index: string;
-        presentation: CombineElements<keyof CollectionModel<T>["ts"]>;
-        fields: {
-            [K in keyof T]: TplFieldRules;
-        };
-        fks: {
-            [K in TplCollectionName]?: {
-                code: K;
-                multiple: boolean;
-                rules: CombinedArgs;
-            };
-        };
-    };
-};
-type ReadonlyCollections<T extends IdbqModel> = {
-    [K in keyof T]: CollectionCore<T[K]["ts"]>;
+import { CollectionCore } from '../collection/collection.svelte.js';
+import { CollectionState } from '../state/idbstate.svelte.js';
+import type { IdbqModel } from './types.js';
+export type ReadonlyCollections<T extends IdbqModel> = {
+    [K in keyof T]: CollectionCore<T[K]['ts']>;
 };
-type StateCollections<T extends IdbqModel> = {
-    [K in keyof T]: StateCollectionDyn<T[K]["ts"]>;
+export type StateCollections<T extends IdbqModel> = {
+    [K in keyof T]: CollectionState<T[K]['ts']>;
 };
 /**
  * Represents the IndexedDB wrapper for managing database operations.
@@ -89,7 +24,7 @@ export declare class IdbqlIndexedCore<T = any> {
     get schema(): Record<string, any>;
     get idbqModel(): IdbqModel<Record<string, Record<string, any>>>;
     /**
-     * Sets the version of the database.
+     * return a database, with the version is provided
      * @param {number} version - The version number of the database.
      * @returns {object} - An object with a `stores` method to define the object stores.
      */
@@ -98,6 +33,7 @@ export declare class IdbqlIndexedCore<T = any> {
     private createCollections;
 }
 /**
+ * Main entrance function to create an IndexedDB database store schema.
  * Creates an IndexedDB database store schema for the given model and version.
  *
  * @param model - The IdbqModel representing the structure of the store.
@@ -112,6 +48,7 @@ export declare const createIdbqDb: <T extends IdbqModel>(model: T, version: numb
         idbDatabase: IdbqlIndexedCore<T>;
         idbql: ReadonlyCollections<T>;
         idbqlState: StateCollections<T>;
+        qolie: any;
         idbqModel: T;
     };
 };
@@ -120,7 +57,7 @@ export declare const idbqBase: <T extends IdbqModel>(model: T, version: number)
         idbDatabase: IdbqlIndexedCore<T>;
         idbql: ReadonlyCollections<T>;
         idbqlState: StateCollections<T>;
+        qolie: any;
         idbqModel: T;
     };
 };
-export {};

package/dist/idbqlCore/idbqlCore.js

@@ -1,29 +1,7 @@
 /* src\lib\scripts\idbqlCore\idbqlCore.ts */
-import { Collection, CollectionCore } from "../collection/collection.svelte.js";
-import { createIdbqlState, } from "../state/idbstate.svelte.js";
-import { Schema } from "./idbqlSchema.js";
-export var enumPrimitive;
-(function (enumPrimitive) {
-    enumPrimitive["id"] = "id";
-    enumPrimitive["any"] = "any";
-    enumPrimitive["date"] = "date";
-    enumPrimitive["text"] = "text";
-    enumPrimitive["number"] = "number";
-    enumPrimitive["boolean"] = "boolean";
-    enumPrimitive["datetime"] = "datetime";
-    enumPrimitive["url"] = "url";
-    enumPrimitive["email"] = "email";
-    enumPrimitive["phone"] = "phone";
-    enumPrimitive["time"] = "time";
-    enumPrimitive["password"] = "password";
-})(enumPrimitive || (enumPrimitive = {}));
-export var TplProperties;
-(function (TplProperties) {
-    TplProperties["private"] = "private";
-    TplProperties["readonly"] = "readonly";
-    TplProperties["required"] = "required";
-})(TplProperties || (TplProperties = {}));
-const a = "object-any (readonly private)";
+import { Collection, CollectionCore } from '../collection/collection.svelte.js';
+import { CollectionState, createIdbqlState } from '../state/idbstate.svelte.js';
+import { Schema } from './idbqlSchema.js';
 /**
  * Represents the IndexedDB wrapper for managing database operations.
  * @template T - The type of data stored in the IndexedDB.
@@ -45,13 +23,13 @@ export class IdbqlIndexedCore {
         const stores = {};
         Object.keys(idbqModel).forEach((modelName) => {
             const modelInfo = idbqModel[modelName];
-            stores[modelName] = modelInfo.keyPath || "";
+            stores[modelName] = modelInfo.keyPath || '';
             Object.defineProperty(this, modelName, {
                 // @ts-ignore
                 value: undefined,
                 writable: true,
                 enumerable: true,
-                configurable: true,
+                configurable: true
             });
         });
         this.stores(stores);
@@ -63,12 +41,12 @@ export class IdbqlIndexedCore {
         return this.#idbqModel;
     }
     /**
-     * Sets the version of the database.
+     * return a database, with the version is provided
      * @param {number} version - The version number of the database.
      * @returns {object} - An object with a `stores` method to define the object stores.
      */
     async stores(args) {
-        if (typeof indexedDB !== "undefined") {
+        if (typeof indexedDB !== 'undefined') {
             return new Promise((resolve, reject) => {
                 this.#schema = args;
                 const dbConnection = indexedDB.open(this.databaseName, this.dbVersion);
@@ -80,11 +58,14 @@ export class IdbqlIndexedCore {
                     };
                     dbConnection.onupgradeneeded = async (event) => {
                         const db = event.target.result;
+                        console.log('upgrading db', db);
                         if (db) {
                             const m = new Schema();
-                            m.createSchema(db, args);
+                            console.log('schema', m);
+                            await m.createSchema(db, args);
                         }
                         else {
+                            console.log('no db');
                             reject(true);
                         }
                     };
@@ -98,7 +79,7 @@ export class IdbqlIndexedCore {
     }
     async transaction(storeNames, mode, callback) {
         if (!this.idbDatabase) {
-            throw new Error("Database not initialized");
+            throw new Error('Database not initialized');
         }
         return new Promise((resolve, reject) => {
             const tx = this.idbDatabase.transaction(storeNames, mode);
@@ -120,16 +101,17 @@ export class IdbqlIndexedCore {
                 // @ts-ignore
                 value: new Collection(storeName, this.#schema[storeName], {
                     dbName: this.databaseName,
-                    version, // @ts-ignore
+                    version // @ts-ignore
                 }),
                 writable: true,
                 enumerable: true,
-                configurable: true,
+                configurable: true
             });
         });
     }
 }
 /**
+ * Main entrance function to create an IndexedDB database store schema.
  * Creates an IndexedDB database store schema for the given model and version.
  *
  * @param model - The IdbqModel representing the structure of the store.
@@ -143,13 +125,15 @@ export const createIdbqDb = (model, version) => {
     return {
         create: (name) => {
             const idb_ = new IdbqlIndexedCore(name, model, version);
+            const idbqlState = createIdbqlState(idb_);
             return {
                 idbDatabase: idb_,
                 idbql: idb_,
-                idbqlState: createIdbqlState(idb_).state,
-                idbqModel: model,
+                idbqlState: idbqlState.collectionState,
+                qolie: idbqlState.qolie,
+                idbqModel: model
             };
-        },
+        }
     };
 };
 // main export is here ?

package/dist/idbqlCore/idbqlSchema.js

@@ -15,6 +15,10 @@ export class Schema {
      * @returns The created object store or null if creation fails.
      */
     createStore(db, storeName, keyPath, autoIncrement = false) {
+        if (db.objectStoreNames.contains(storeName)) {
+            console.warn(`Store ${storeName} already exists, skipping creation.`);
+            return db.transaction(storeName, 'readwrite').objectStore(storeName);
+        }
         try {
             return db.createObjectStore(storeName, { keyPath, autoIncrement });
         }
@@ -37,7 +41,14 @@ export class Schema {
             const declaredIndex = fields.find((field) => field.startsWith('&'))?.replace('&', '');
             const keyPath = incrementField || declaredIndex || fields[0];
             const increment = Boolean(incrementField);
-            const store = this.createStore(db, storeName, keyPath, increment);
+            let store;
+            if (db.objectStoreNames.contains(storeName)) {
+                console.warn(`Store ${storeName} already exists, skipping creation.`);
+                store = db.transaction(storeName, 'readwrite').objectStore(storeName);
+            }
+            else {
+                store = this.createStore(db, storeName, keyPath, increment);
+            }
             if (store) {
                 for (const field of fields) {
                     await this.createIndexes(store, field, field);

package/dist/idbqlCore/types.d.ts

@@ -0,0 +1,69 @@
+export type ExpandProps<T> = T extends infer O ? {
+    [K in keyof O]: O[K];
+} : never;
+export declare enum enumPrimitive {
+    id = "id",
+    any = "any",
+    date = "date",
+    text = "text",
+    number = "number",// IdbqModelCollectionTemplate
+    boolean = "boolean",
+    datetime = "datetime",
+    url = "url",
+    email = "email",
+    phone = "phone",
+    time = "time",
+    password = "password"
+}
+export declare enum TplProperties {
+    private = "private",
+    readonly = "readonly",
+    required = "required"
+}
+export type CombineElements<T extends string, U extends string = T> = T extends any ? T | `${T} ${CombineElements<Exclude<U, T>>}` : never;
+export type CombinedArgs = CombineElements<TplProperties>;
+export type IdbObjectify<T extends string> = `array-of-${T}` | `object-${T}`;
+export type TplCollectionFields = Record<string, string>;
+export type TplFieldPrimitive<T = {}> = keyof typeof enumPrimitive | `text-${'tiny' | 'short' | 'medium' | 'long' | 'area'}` | `${string}.${string}` | `fk-${string}.${string}`;
+export type TplObjectFieldPrimitive = IdbObjectify<TplFieldPrimitive>;
+export type TplFieldFk = `fk-${string}.${string}`;
+export type TplFkObject = IdbObjectify;
+export type TplTypes = TplFieldPrimitive | TplObjectFieldPrimitive | TplFieldFk | TplFkObject;
+export type TplFieldArgs = `${TplTypes} (${CombinedArgs})`;
+/** rules */
+export type TplFieldRules = TplFieldArgs | TplTypes;
+export type TplFieldType = TplFieldArgs | TplTypes;
+export type IDbForge = {
+    collection?: TplCollectionName;
+    fieldName?: keyof TplFields;
+    fieldType?: TplFieldType;
+    fieldRule?: TplFieldRules;
+    fieldArgs?: [keyof typeof TplProperties] | undefined;
+    is: any;
+};
+export type IdbqModel<T = Record<string, Record<string, any>>> = {
+    readonly [K in keyof T]: CollectionModel<T[K]>;
+};
+export type TplCollectionName<T = TplCollectionFields> = keyof IdbqModel<T>;
+export type Tpl<T = TplCollectionFields> = CollectionModel<T>['template'];
+export type TplFields<T = TplCollectionFields> = CollectionModel<T>['template']['fields'];
+export type CollectionModel<T = TplCollectionFields> = {
+    keyPath: string | any;
+    /** @deprecated use ts instead */
+    model: any;
+    ts: any;
+    template: {
+        index: string;
+        presentation: CombineElements<keyof CollectionModel<T>['ts']>;
+        fields: {
+            [K in keyof T]: TplFieldRules;
+        };
+        fks: {
+            [K in TplCollectionName]?: {
+                code: K;
+                multiple: boolean;
+                rules: CombinedArgs;
+            };
+        };
+    };
+};

package/dist/idbqlCore/types.js

@@ -0,0 +1,23 @@
+export var enumPrimitive;
+(function (enumPrimitive) {
+    enumPrimitive["id"] = "id";
+    enumPrimitive["any"] = "any";
+    enumPrimitive["date"] = "date";
+    enumPrimitive["text"] = "text";
+    enumPrimitive["number"] = "number";
+    enumPrimitive["boolean"] = "boolean";
+    enumPrimitive["datetime"] = "datetime";
+    enumPrimitive["url"] = "url";
+    enumPrimitive["email"] = "email";
+    enumPrimitive["phone"] = "phone";
+    enumPrimitive["time"] = "time";
+    enumPrimitive["password"] = "password";
+})(enumPrimitive || (enumPrimitive = {}));
+export var TplProperties;
+(function (TplProperties) {
+    TplProperties["private"] = "private";
+    TplProperties["readonly"] = "readonly";
+    TplProperties["required"] = "required";
+})(TplProperties || (TplProperties = {}));
+(TplFieldFk);
+const a = 'object-any (readonly private)';

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './state/idbstate.svelte.js';
 export * from './state/idbqlEvent.svelte.js';
 export * from './scripts/types.js';
 export * from './path/pathResolver.js';
+export * from './idbqlCore/types.js';
 export * from './idbqlCore/idbqlSchema.js';
 export * from './idbqlCore/idbqlCore.js';
 export * from './collection/collection.svelte.js';

package/dist/index.js

@@ -3,6 +3,7 @@ export * from './state/idbstate.svelte.js';
 export * from './state/idbqlEvent.svelte.js';
 export * from './scripts/types.js';
 export * from './path/pathResolver.js';
+export * from './idbqlCore/types.js';
 export * from './idbqlCore/idbqlSchema.js';
 export * from './idbqlCore/idbqlCore.js';
 export * from './collection/collection.svelte.js';

package/dist/state/idbqlEvent.svelte.js

@@ -77,6 +77,7 @@ class IdbqlStateEvent {
                         }
                     });
                     for (let i = indicesToRemove.length - 1; i >= 0; i--) {
+                        this.dataState[collection][indicesToRemove[i]] = undefined;
                         this.dataState[collection].splice(indicesToRemove[i], 1);
                     }
                 }

package/dist/state/idbstate.svelte.d.ts

@@ -11,36 +11,135 @@ import { type Where, type ResultSet, type ResultsetOptions } from "@medyll/idae-
  * @returns {object} - The state object.
  */
 export declare const createIdbqlState: (idbBase: IdbqlIndexedCore) => {
-    readonly state: Record<string, any>;
-    onCollection: <T>(collectionName: string) => StateCollectionDyn<T>;
-    addCollection: <T>(collectionName: string) => StateCollectionDyn<T>;
+    readonly collectionState: Record<string, CollectionState<any>>;
+    readonly qolie: (collection: string) => {
+        get: (value: any, pathKey?: string) => ResultSet<any>;
+        getBy: (value: any, pathKey?: string) => ResultSet<any>;
+        getOne: (value: any, pathKey?: string) => any;
+        getAll: () => ResultSet<any>;
+        create: (value: Partial<any>) => Promise<any>;
+        delete: (keyPathValue: string | number) => Promise<boolean | undefined>;
+        deleteWhere: (where: Where<any>) => Promise<boolean | undefined>;
+        update: (keyPathValue: string | number, data: Partial<any>) => Promise<boolean | undefined>;
+        where: (qy: Where<any>, options?: ResultsetOptions) => ResultSet<any>;
+        updateWhere: (where: Where<any>, data: Partial<any>) => Promise<boolean | undefined>;
+    };
+    onCollection: <T>(collectionName: string) => CollectionState<T>;
+    addCollection: <T>(collectionName: string) => CollectionState<T>;
 };
 /**
- * Adds a collection to the svelte 5 state and synchronize with indexedDB if it exists.
- * @template T - The type of data in the collection.
- * @param {string} collectionName - The name of the collection.
- * @param {string} [keyPath="id"] - The key path for the collection.
- * @returns {Proxy} - A proxy object with methods to interact with the collection.
+ * Represents a dynamic state collection that interacts with an IndexedDB base.
+ * Provides methods for performing CRUD operations and querying the collection.
+ *
+ * @template T - The type of items in the collection.
  */
-export declare class StateCollectionDyn<T> {
+export declare class CollectionState<T> {
     private collectionName;
     private idbBase;
+    /**
+     * Creates an instance of StateCollectionDyn.
+     * @param {string} collectionName - The name of the collection.
+     * @param {IdbqlIndexedCore} idbBase - The instance of the IndexedDB base.
+     */
     constructor(collectionName: string, idbBase: IdbqlIndexedCore);
+    /**
+     * Gets the current state of the collection.
+     * @returns {ResultSet<T>} The state of the collection.
+     */
     get collectionState(): ResultSet<T>;
+    /**
+     * Tests if the collection exists in the IndexedDB base.
+     * @param {string} collection - The name of the collection.
+     * @returns {boolean} True if the collection exists, otherwise false.
+     */
     private testIdbql;
+    /**
+     * Feeds the collection with data from the IndexedDB base.
+     */
     private feed;
+    /**
+     * Performs a "where" query on the collection.
+     * @param {Where<T>} qy - The "where" query.
+     * @param {ResultsetOptions} [options] - Optional result set options.
+     * @returns {ResultSet<T>} The result set of the query.
+     */
     _where(qy: Where<T>, options?: ResultsetOptions): ResultSet<T>;
+    /**
+     * Gets a function to perform a "where" query on the collection.
+     * @returns {(qy: Where<T>, options?: ResultsetOptions) => ResultSet<T>} The function to perform the query.
+     */
     get where(): (qy: Where<T>, options?: ResultsetOptions) => ResultSet<T>;
+    /**
+     * Gets items from the collection by a specific value and key.
+     * @param {any} value - The value to search for.
+     * @param {string} [pathKey="id"] - The key to search by.
+     * @returns {ResultSet<T>} The result set of the query.
+     */
     get(value: any, pathKey?: string): ResultSet<T>;
-    getOne(value: any, pathKey?: string): T;
+    /**
+     * Gets items from the collection by a specific value and key using a "where" query.
+     * @param {any} value - The value to search for.
+     * @param {string} [pathKey="id"] - The key to search by.
+     * @returns {ResultSet<T>} The result set of the query.
+     */
+    getBy(value: any, pathKey?: string): ResultSet<T>;
+    /**
+     * Gets a single item from the collection by a specific value and key.
+     * @deprecated Use getBy instead.
+     * @param {any} value - The value to search for.
+     * @param {string} [pathKey="id"] - The key to search by.
+     * @returns {T | undefined} The item found, or undefined if not found.
+     */
+    getOne(value: any, pathKey?: string): T | undefined;
+    /**
+     * Gets all items from the collection.
+     * @returns {ResultSet<T>} The result set of all items.
+     */
     getAll: () => ResultSet<T>;
+    /**
+     * Updates an item in the collection by a specific key path value.
+     * @param {string | number} keyPathValue - The key path value of the item to update.
+     * @param {Partial<T>} data - The data to update.
+     * @returns {Promise<boolean | undefined>} True if the update was successful, otherwise undefined.
+     */
     update(keyPathValue: string | number, data: Partial<T>): Promise<boolean | undefined>;
+    /**
+     * Updates items in the collection that match a "where" query.
+     * @param {Where<T>} where - The "where" query to match items.
+     * @param {Partial<T>} data - The data to update.
+     * @returns {Promise<boolean | undefined>} True if the update was successful, otherwise undefined.
+     */
     updateWhere(where: Where<T>, data: Partial<T>): Promise<boolean | undefined>;
+    /**
+     * Puts an item into the collection.
+     * @param {Partial<T>} value - The item to put.
+     * @returns {Promise<T | undefined>} The item put, or undefined if the operation failed.
+     */
     put(value: Partial<T>): Promise<T | undefined>;
+    /**
+     * Adds an item to the collection.
+     * @param {T} data - The item to add.
+     * @returns {Promise<T | undefined>} The item added, or undefined if the operation failed.
+     */
     add(data: T): Promise<T | undefined>;
+    /**
+     * Deletes an item from the collection by a specific key path value.
+     * @param {string | number} keyPathValue - The key path value of the item to delete.
+     * @returns {Promise<boolean | undefined>} True if the deletion was successful, otherwise undefined.
+     */
     delete(keyPathValue: string | number): Promise<boolean | undefined>;
-    /** @deprecated */
+    /**
+     * Deletes an item from the collection by a specific key path value.
+     * @deprecated Use delete instead.
+     * @param {string | number} keyPathValue - The key path value of the item to delete.
+     * @returns {Promise<boolean | undefined>} True if the deletion was successful, otherwise undefined.
+     */
     del(keyPathValue: string | number): Promise<boolean | undefined>;
+    /**
+     * Deletes items from the collection that match a "where" query.
+     * @param {Where<T>} where - The "where" query to match items.
+     * @returns {Promise<boolean | undefined>} True if the deletion was successful, otherwise undefined.
+     */
     deleteWhere(where: Where<T>): Promise<boolean | undefined>;
 }
 export {};

package/dist/state/idbstate.svelte.js

@@ -1,7 +1,6 @@
 import { idbqlEvent } from "./idbqlEvent.svelte.js";
 //
 import { Operators, getResultset, } from "@medyll/idae-query";
-//
 /**
  * Main entry point.
  * Creates a state object with indexedDB synchronization.
@@ -13,15 +12,24 @@ export const createIdbqlState = (idbBase) => {
     if (idbBase.schema) {
         addCollections(idbBase.schema);
     }
-    /**
-     * Adds a collection to the svelte 5 state and synchronize with indexedDB if it exists.
-     * @template T - The type of data in the collection.
-     * @param {string} collectionName - The name of the collection.
-     * @param {string} [keyPath="id"] - The key path for the collection.
-     * @returns {Proxy} - A proxy object with methods to interact with the collection.
-     */
+    let qolie = function dbQuery(collection) {
+        if (!collections[collection])
+            throw new Error(`Collection ${collection} not found`);
+        return {
+            get: collections[collection].get,
+            getBy: collections[collection].getBy,
+            getOne: collections[collection].getOne,
+            getAll: collections[collection].getAll,
+            create: collections[collection].put,
+            delete: collections[collection].delete,
+            deleteWhere: collections[collection].deleteWhere,
+            update: collections[collection].update,
+            where: collections[collection].where,
+            updateWhere: collections[collection].updateWhere,
+        };
+    };
     function addCollection(collectionName) {
-        return new StateCollectionDyn(collectionName, idbBase);
+        return new CollectionState(collectionName, idbBase);
     }
     function addCollections(args) {
         Object.keys(args).map((collection) => {
@@ -30,23 +38,30 @@ export const createIdbqlState = (idbBase) => {
         });
     }
     return {
-        get state() {
+        get collectionState() {
             return collections;
         },
+        get qolie() {
+            return qolie;
+        },
         onCollection: addCollection,
         addCollection: addCollection,
     };
 };
 /**
- * Adds a collection to the svelte 5 state and synchronize with indexedDB if it exists.
- * @template T - The type of data in the collection.
- * @param {string} collectionName - The name of the collection.
- * @param {string} [keyPath="id"] - The key path for the collection.
- * @returns {Proxy} - A proxy object with methods to interact with the collection.
+ * Represents a dynamic state collection that interacts with an IndexedDB base.
+ * Provides methods for performing CRUD operations and querying the collection.
+ *
+ * @template T - The type of items in the collection.
  */
-export class StateCollectionDyn {
+export class CollectionState {
     collectionName;
     idbBase;
+    /**
+     * Creates an instance of StateCollectionDyn.
+     * @param {string} collectionName - The name of the collection.
+     * @param {IdbqlIndexedCore} idbBase - The instance of the IndexedDB base.
+     */
     constructor(collectionName, idbBase) {
         if (!idbqlEvent.dataState?.[collectionName]) {
             idbqlEvent.dataState[collectionName] = [];
@@ -56,24 +71,38 @@ export class StateCollectionDyn {
         this.feed();
         return this;
     }
+    /**
+     * Gets the current state of the collection.
+     * @returns {ResultSet<T>} The state of the collection.
+     */
     get collectionState() {
         return idbqlEvent?.dataState?.[this.collectionName];
     }
+    /**
+     * Tests if the collection exists in the IndexedDB base.
+     * @param {string} collection - The name of the collection.
+     * @returns {boolean} True if the collection exists, otherwise false.
+     */
     testIdbql(collection) {
         return this.idbBase && Boolean(this.idbBase?.[collection]);
     }
+    /**
+     * Feeds the collection with data from the IndexedDB base.
+     */
     feed() {
         if (this.idbBase && this.testIdbql(this.collectionName)) {
             this.idbBase[this.collectionName].getAll().then((data) => {
                 idbqlEvent.dataState[this.collectionName] = getResultset(data);
-                /* idbqlEvent.dataState = {
-                  ...idbqlEvent.dataState,
-                  [this.collectionName]: getResultset(data),
-                }; */
             });
         }
     }
-    /* READ OP */
+    /* READ OPERATIONS */
+    /**
+     * Performs a "where" query on the collection.
+     * @param {Where<T>} qy - The "where" query.
+     * @param {ResultsetOptions} [options] - Optional result set options.
+     * @returns {ResultSet<T>} The result set of the query.
+     */
     _where(qy, options) {
         let dts = this.collectionState;
         let c = Operators.parse(dts ?? getResultset([]), qy);
@@ -82,31 +111,78 @@ export class StateCollectionDyn {
             r.setOptions(options);
         return r;
     }
+    /**
+     * Gets a function to perform a "where" query on the collection.
+     * @returns {(qy: Where<T>, options?: ResultsetOptions) => ResultSet<T>} The function to perform the query.
+     */
     get where() {
         return (qy, options) => this._where(qy, options);
     }
+    /**
+     * Gets items from the collection by a specific value and key.
+     * @param {any} value - The value to search for.
+     * @param {string} [pathKey="id"] - The key to search by.
+     * @returns {ResultSet<T>} The result set of the query.
+     */
     get(value, pathKey = "id") {
-        return this.collectionState.filter((d) => d[pathKey] === value);
+        return this.collectionState?.filter((d) => d[pathKey] === value);
     }
+    /**
+     * Gets items from the collection by a specific value and key using a "where" query.
+     * @param {any} value - The value to search for.
+     * @param {string} [pathKey="id"] - The key to search by.
+     * @returns {ResultSet<T>} The result set of the query.
+     */
+    getBy(value, pathKey = "id") {
+        return this.where({ [pathKey]: value });
+    }
+    /**
+     * Gets a single item from the collection by a specific value and key.
+     * @deprecated Use getBy instead.
+     * @param {any} value - The value to search for.
+     * @param {string} [pathKey="id"] - The key to search by.
+     * @returns {T | undefined} The item found, or undefined if not found.
+     */
     getOne(value, pathKey = "id") {
-        return this.collectionState.filter((d) => d?.[pathKey] === value)?.[0];
+        return this.where({ [pathKey]: value })?.[0];
     }
+    /**
+     * Gets all items from the collection.
+     * @returns {ResultSet<T>} The result set of all items.
+     */
     getAll = () => {
         return this.collectionState;
     };
-    /* WRITE OP */
+    /* WRITE OPERATIONS */
+    /**
+     * Updates an item in the collection by a specific key path value.
+     * @param {string | number} keyPathValue - The key path value of the item to update.
+     * @param {Partial<T>} data - The data to update.
+     * @returns {Promise<boolean | undefined>} True if the update was successful, otherwise undefined.
+     */
     async update(keyPathValue, data) {
         if (this.idbBase && this.testIdbql(this.collectionName)) {
             return (await this.idbBase[this.collectionName].update(keyPathValue, data));
         }
         return undefined;
     }
+    /**
+     * Updates items in the collection that match a "where" query.
+     * @param {Where<T>} where - The "where" query to match items.
+     * @param {Partial<T>} data - The data to update.
+     * @returns {Promise<boolean | undefined>} True if the update was successful, otherwise undefined.
+     */
     async updateWhere(where, data) {
         if (this.idbBase && this.testIdbql(this.collectionName)) {
             return (await this.idbBase[this.collectionName].updateWhere(where, data));
         }
         return undefined;
     }
+    /**
+     * Puts an item into the collection.
+     * @param {Partial<T>} value - The item to put.
+     * @returns {Promise<T | undefined>} The item put, or undefined if the operation failed.
+     */
     async put(value) {
         if (this.idbBase && this.testIdbql(this.collectionName)) {
             return this.idbBase[this.collectionName].put(value).then((data) => {
@@ -115,24 +191,44 @@ export class StateCollectionDyn {
         }
         return undefined;
     }
+    /**
+     * Adds an item to the collection.
+     * @param {T} data - The item to add.
+     * @returns {Promise<T | undefined>} The item added, or undefined if the operation failed.
+     */
     async add(data) {
         if (this.idbBase && this.testIdbql(this.collectionName)) {
             return (await this.idbBase[this.collectionName].add(data));
         }
         return undefined;
     }
+    /**
+     * Deletes an item from the collection by a specific key path value.
+     * @param {string | number} keyPathValue - The key path value of the item to delete.
+     * @returns {Promise<boolean | undefined>} True if the deletion was successful, otherwise undefined.
+     */
     async delete(keyPathValue) {
         if (this.idbBase && this.testIdbql(this.collectionName)) {
             return await this.idbBase[this.collectionName].delete(keyPathValue);
         }
         return undefined;
     }
-    /** @deprecated */
+    /**
+     * Deletes an item from the collection by a specific key path value.
+     * @deprecated Use delete instead.
+     * @param {string | number} keyPathValue - The key path value of the item to delete.
+     * @returns {Promise<boolean | undefined>} True if the deletion was successful, otherwise undefined.
+     */
     async del(keyPathValue) {
         if (this.idbBase && this.testIdbql(this.collectionName)) {
             return await this.idbBase[this.collectionName].delete(keyPathValue);
         }
     }
+    /**
+     * Deletes items from the collection that match a "where" query.
+     * @param {Where<T>} where - The "where" query to match items.
+     * @returns {Promise<boolean | undefined>} True if the deletion was successful, otherwise undefined.
+     */
     async deleteWhere(where) {
         if (this.idbBase && this.testIdbql(this.collectionName)) {
             return await this.idbBase[this.collectionName].deleteWhere(where);

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@medyll/idae-idbql",
 	"scope": "@medyll",
-	"version": "0.65.0",
+	"version": "0.67.0",
 	"description": "A powerful and flexible IndexedDB query library for TypeScript and JavaScript applications, offering a MongoDB-like query interface, strong TypeScript support, reactive state management, and easy integration with front-end frameworks like Svelte.",
 	"scripts": {
 		"dev": "vite dev",
@@ -32,10 +32,9 @@
 	"devDependencies": {
 		"@medyll/idae-prettier-config": "^1.1.0",
 		"@sveltejs/adapter-auto": "^4.0.0",
-		"@sveltejs/kit": "^2.17.3",
-		"@sveltejs/package": "^2.3.10",
-		"@sveltejs/vite-plugin-svelte": "^5.0.3",
-		"svelte": "^5.20.5",
+		"@sveltejs/kit": "^2.18.0",
+		"@sveltejs/package": "^2.0.0",
+		"svelte": "^5.22.4",
 		"svelte-check": "^4.1.4",
 		"tslib": "^2.8.1",
 		"typescript": "^5.8.2",
@@ -45,6 +44,6 @@
 	"types": "./dist/index.d.ts",
 	"type": "module",
 	"dependencies": {
-		"@medyll/idae-query": "^0.66.0"
+		"@medyll/idae-query": "^0.68.0"
 	}
 }