@medyll/idae-idbql 0.178.0 → 0.185.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 medyll
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 medyll
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,205 +1,205 @@
-# @medyll/idae-idbql
-
-A powerful and flexible IndexedDB query library for TypeScript and JavaScript applications.
-
-## Features
-
-- MongoDB-like query interface for IndexedDB
-- Strong TypeScript support with full type inference
-- Reactive state management for real-time UI updates
-- Support for complex CRUD operations and advanced querying
-- Flexible data modeling with automatic schema creation
-- Built-in indexing and optimization features
-- Easy integration with front-end frameworks, especially Svelte
-- Robust error handling and logging
-- Versioning and database migration support
-- Support for svelte 5 state
-
-## Installation
-
-```bash
-npm install @medyll/idae-idbql
-```
-
-## Quick Start
-
-```typescript
-import { createIdbqDb } from '@medyll/idae-idbql';
-
-// Define your data model
-const exampleModel = {
-  messages: {
-    keyPath: "++id, chatId, created_at",
-    ts: {} as ChatMessage, // this will provide autocompletion
-  },
-  chat: {
-    keyPath: "&chatId, created_at, dateLastMessage",
-    ts: {} as Chat,
-    template: {
-      index:        string;
-      presentation: CombineElements<keyof CollectionModel<T>['ts']>;
-      fields:       {
-        [K in keyof T]: TplFieldRules;
-        field1: 'array-of-string';
-        field2: 'string (readonly private)';
-        field3: 'text-short'
-        field4: 'fks-messages.is'
-      };
-      fks:          {
-        [K in TplCollectionName]?: {
-          code:     K;
-          multiple: boolean;
-          rules:    CombinedArgs;
-        };
-      };
-    };
-  },
-};
-
-// Create a database instance
-const idbqStore = createIdbqDb(exampleModel, 1);
-const { idbql, idbqlState, idbDatabase, idbqModel } = idbqStore.create("myDatabase");
-
-// Perform database operations
-async function fetchMessages() {
-  const messages = await idbql.messages.where({ chatId: "123" }).toArray();
-  console.log(messages);
-}
-
-fetchMessages();
-```
-
-## API Reference
-
-### createIdbqDb(model, version)
-
-Creates an IndexedDB database instance with the specified model and version.
-
-### idbql
-
-The main interface for database operations. Provides methods for each collection defined in your model.
-
-### idbqlState
-
-A reactive state object that reflects the current state of your database.
-
-### idbDatabase
-
-Provides low-level access to the IndexedDB instance.
-
-### idbqModel
-
-Contains the database model definition.
-
-## Query Operations
-
-```typescript
-// Add a new item
-await idbql.messages.add({ chatId: "123", content: "Hello" });
-
-// Update an item
-await idbql.messages.put({ id: 1, content: "Updated message" });
-
-// Delete an item
-await idbql.messages.delete(1);
-
-// Query items
-const recentMessages = await idbql.messages
-  .where({ created_at: { gt: new Date(Date.now() - 86400000) } })
-  .toArray();
-```
-
-## Transactions
-
-idbql supports complex transactions across multiple object stores:
-
-```typescript
-const result = await idbql.transaction(
-  ["users", "posts"],
-  "readwrite",
-  async (tx) => {
-    const userStore = tx.objectStore("users");
-    const postStore = tx.objectStore("posts");
-
-    const userId = await userStore.add({ name: "Alice", email: "alice@example.com" });
-    const postId = await postStore.add({ userId, title: "Alice's First Post", content: "Hello, World!" });
-
-    return { userId, postId };
-  }
-);
-```
-
-
-## Svelte 5 Reactivity: Usage & Best Practices
-
-`idbqlState` expose un state réactif Svelte 5 ($state) : toute modification (add, update, delete…) se propage automatiquement à toutes les requêtes (`where`, `groupby`, `sort`, etc.) utilisées dans un `$derived` ou `$effect`.
-
-### Exemple d'usage réactif dans un composant Svelte 5
-
-```svelte
-<script lang="ts">
-  // Importez idbqlState depuis votre store
-  import { idbqlState } from './store';
-
-  // Utilisez $derived pour obtenir une liste réactive
-  // Toute modification de la base (ajout, suppression, update) mettra à jour $activeUsers automatiquement
-  const activeUsers = $derived(() => idbqlState.users.where({ isActive: true }));
-</script>
-
-<h2>Utilisateurs actifs</h2>
-{#each $activeUsers as user}
-  <p>{user.name}</p>
-{/each}
-```
-
-### Notes importantes
-- Les méthodes `where`, `groupby`, `sort`, etc. sont synchrones : elles opèrent toujours sur le snapshot courant du state.
-- Pour bénéficier de la réactivité, utilisez-les dans un `$derived` ou `$effect` Svelte 5.
-
-## Versioning and Migrations
-
-```typescript
-const idbqStore = createIdbqDb(myModel, 2);
-const { idbDatabase } = idbqStore.create("myDb", {
-  upgrade(oldVersion, newVersion, transaction) {
-    if (oldVersion < 2) {
-      const userStore = transaction.objectStore("users");
-      userStore.createIndex("emailIndex", "email", { unique: true });
-    }
-  },
-});
-```
-
-## Error Handling
-
-```typescript
-try {
-  await idbql.users.add({ username: "existing_user" });
-} catch (error) {
-  if (error instanceof UniqueConstraintError) {
-    console.error("Username already exists");
-  } else {
-    console.error("An unexpected error occurred", error);
-  }
-}
-```
-
-## Performance Tips
-
-- Use appropriate indexes
-- Limit result sets with `.limit(n)`
-- Use `.count()` instead of `.toArray().length`
-- Optimize queries to use indexes effectively
-
-## Contributing
-
-Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
-
-## License
-
-This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
-
-## Support
-
-If you encounter any issues or have questions, please file an issue on the GitHub repository.
+# @medyll/idae-idbql
+
+A powerful and flexible IndexedDB query library for TypeScript and JavaScript applications.
+
+## Features
+
+- MongoDB-like query interface for IndexedDB
+- Strong TypeScript support with full type inference
+- Reactive state management for real-time UI updates
+- Support for complex CRUD operations and advanced querying
+- Flexible data modeling with automatic schema creation
+- Built-in indexing and optimization features
+- Easy integration with front-end frameworks, especially Svelte
+- Robust error handling and logging
+- Versioning and database migration support
+- Support for svelte 5 state
+
+## Installation
+
+```bash
+npm install @medyll/idae-idbql
+```
+
+## Quick Start
+
+```typescript
+import { createIdbqDb } from '@medyll/idae-idbql';
+
+// Define your data model
+const exampleModel = {
+  messages: {
+    keyPath: "++id, chatId, created_at",
+    ts: {} as ChatMessage, // this will provide autocompletion
+  },
+  chat: {
+    keyPath: "&chatId, created_at, dateLastMessage",
+    ts: {} as Chat,
+    template: {
+      index:        string;
+      presentation: CombineElements<keyof CollectionModel<T>['ts']>;
+      fields:       {
+        [K in keyof T]: TplFieldRules;
+        field1: 'array-of-string';
+        field2: 'string (readonly private)';
+        field3: 'text-short'
+        field4: 'fks-messages.is'
+      };
+      fks:          {
+        [K in TplCollectionName]?: {
+          code:     K;
+          multiple: boolean;
+          rules:    CombinedArgs;
+        };
+      };
+    };
+  },
+};
+
+// Create a database instance
+const idbqStore = createIdbqDb(exampleModel, 1);
+const { idbql, idbqlState, idbDatabase, idbqModel } = idbqStore.create("myDatabase");
+
+// Perform database operations
+async function fetchMessages() {
+  const messages = await idbql.messages.where({ chatId: "123" }).toArray();
+  console.log(messages);
+}
+
+fetchMessages();
+```
+
+## API Reference
+
+### createIdbqDb(model, version)
+
+Creates an IndexedDB database instance with the specified model and version.
+
+### idbql
+
+The main interface for database operations. Provides methods for each collection defined in your model.
+
+### idbqlState
+
+A reactive state object that reflects the current state of your database.
+
+### idbDatabase
+
+Provides low-level access to the IndexedDB instance.
+
+### idbqModel
+
+Contains the database model definition.
+
+## Query Operations
+
+```typescript
+// Add a new item
+await idbql.messages.add({ chatId: "123", content: "Hello" });
+
+// Update an item
+await idbql.messages.put({ id: 1, content: "Updated message" });
+
+// Delete an item
+await idbql.messages.delete(1);
+
+// Query items
+const recentMessages = await idbql.messages
+  .where({ created_at: { gt: new Date(Date.now() - 86400000) } })
+  .toArray();
+```
+
+## Transactions
+
+idbql supports complex transactions across multiple object stores:
+
+```typescript
+const result = await idbql.transaction(
+  ["users", "posts"],
+  "readwrite",
+  async (tx) => {
+    const userStore = tx.objectStore("users");
+    const postStore = tx.objectStore("posts");
+
+    const userId = await userStore.add({ name: "Alice", email: "alice@example.com" });
+    const postId = await postStore.add({ userId, title: "Alice's First Post", content: "Hello, World!" });
+
+    return { userId, postId };
+  }
+);
+```
+
+
+## Svelte 5 Reactivity: Usage & Best Practices
+
+`idbqlState` expose un state réactif Svelte 5 ($state) : toute modification (add, update, delete…) se propage automatiquement à toutes les requêtes (`where`, `groupby`, `sort`, etc.) utilisées dans un `$derived` ou `$effect`.
+
+### Exemple d'usage réactif dans un composant Svelte 5
+
+```svelte
+<script lang="ts">
+  // Importez idbqlState depuis votre store
+  import { idbqlState } from './store';
+
+  // Utilisez $derived pour obtenir une liste réactive
+  // Toute modification de la base (ajout, suppression, update) mettra à jour $activeUsers automatiquement
+  const activeUsers = $derived(() => idbqlState.users.where({ isActive: true }));
+</script>
+
+<h2>Utilisateurs actifs</h2>
+{#each $activeUsers as user}
+  <p>{user.name}</p>
+{/each}
+```
+
+### Notes importantes
+- Les méthodes `where`, `groupby`, `sort`, etc. sont synchrones : elles opèrent toujours sur le snapshot courant du state.
+- Pour bénéficier de la réactivité, utilisez-les dans un `$derived` ou `$effect` Svelte 5.
+
+## Versioning and Migrations
+
+```typescript
+const idbqStore = createIdbqDb(myModel, 2);
+const { idbDatabase } = idbqStore.create("myDb", {
+  upgrade(oldVersion, newVersion, transaction) {
+    if (oldVersion < 2) {
+      const userStore = transaction.objectStore("users");
+      userStore.createIndex("emailIndex", "email", { unique: true });
+    }
+  },
+});
+```
+
+## Error Handling
+
+```typescript
+try {
+  await idbql.users.add({ username: "existing_user" });
+} catch (error) {
+  if (error instanceof UniqueConstraintError) {
+    console.error("Username already exists");
+  } else {
+    console.error("An unexpected error occurred", error);
+  }
+}
+```
+
+## Performance Tips
+
+- Use appropriate indexes
+- Limit result sets with `.limit(n)`
+- Use `.count()` instead of `.toArray().length`
+- Optimize queries to use indexes effectively
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+## Support
+
+If you encounter any issues or have questions, please file an issue on the GitHub repository.
  

package/cli.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+
+const pkgJson = require(path.join(__dirname, 'package.json'));
+const packageName = pkgJson.name.replace(/^@[^/]+\//, '');
+const cmd = process.argv[2];
+
+
+if (cmd === 'get-readme') {
+  const readmePath = path.join(__dirname, 'README.md');
+  if (fs.existsSync(readmePath)) {
+    const content = fs.readFileSync(readmePath, 'utf8');
+    console.log(content);
+  } else {
+    console.error('README.md not found in this package.');
+    process.exit(1);
+  }
+} else if (cmd === 'install-skill') {
+  const readline = require('readline');
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const skillSrc = path.join(__dirname, 'SKILL.md');
+  const skillDest = path.resolve(__dirname, `../../../.github/skills/${packageName}/SKILL.md`);
+  if (!fs.existsSync(skillSrc)) {
+    console.error('SKILL.md not found in this package.');
+    process.exit(1);
+  }
+  rl.question(`This will copy SKILL.md to .github/skills/${packageName}/SKILL.md. Continue? (y/n): `, (answer) => {
+    if (answer.trim().toLowerCase() === 'y' || answer.trim().toLowerCase() === 'yes') {
+      fs.mkdirSync(path.dirname(skillDest), { recursive: true });
+      fs.copyFileSync(skillSrc, skillDest);
+      console.log(`SKILL.md installed to .github/skills/${packageName}/SKILL.md`);
+    } else {
+      console.log('Operation cancelled.');
+    }
+    rl.close();
+  });
+} else {
+  console.log('Usage: <cli> get-readme | install-skill');
+  process.exit(1);
+}

package/dist/idbqlCore/types.d.ts

@@ -1,20 +1,12 @@
-/**
- * Utility type to expand a type's properties for better type inference and hover display.
- * @template T - The type to expand.
- */
 export type ExpandProps<T> = T extends infer O ? {
     [K in keyof O]: O[K];
 } : never;
-/**
- * Enumeration of primitive field types supported by the schema system.
- * Used for type-safe field declarations in collection templates.
- */
 export declare enum enumPrimitive {
     id = "id",
     any = "any",
     date = "date",
     text = "text",
-    number = "number",
+    number = "number",// IdbqModelCollectionTemplate
     boolean = "boolean",
     datetime = "datetime",
     url = "url",
@@ -23,84 +15,24 @@ export declare enum enumPrimitive {
     time = "time",
     password = "password"
 }
-/**
- * Enumeration of special field properties for schema fields.
- * - private: Field is internal and not exposed externally.
- * - readonly: Field cannot be modified after creation.
- * - required: Field must be present in the data model.
- */
 export declare enum TplProperties {
     private = "private",
     readonly = "readonly",
     required = "required"
 }
-/**
- * Recursively generates all possible space-separated combinations of a set of string literals.
- * Used to create all valid combinations of field properties (e.g., 'private readonly', etc).
- * @template T - The set of string literals to combine.
- * @template U - The set of remaining string literals (for recursion).
- */
 export type CombineElements<T extends string, U extends string = T> = T | (T extends any ? `${T} ${CombineElements<Exclude<U, T>>}` : never);
-/**
- * Utility type to force TypeScript to expand a union or intersection for better hover display.
- * @template T - The type to expand.
- */
-type Expand<T> = T extends infer O ? {
-    [K in keyof O]: O[K];
-} : never;
-/**
- * All valid combinations of TplProperties, including single and multi-property combinations.
- * Used for field argument validation and schema typing.
- */
-export type CombinedArgs = Expand<keyof typeof TplProperties | CombineElements<keyof typeof TplProperties>>;
-/**
- * Utility type to represent array or object wrappers for a given primitive type string.
- * E.g., 'array-of-text', 'object-number'.
- * @template T - The base type string.
- */
+export type CombinedArgs = CombineElements<TplProperties>;
 export type IdbObjectify<T extends string> = `array-of-${T}` | `object-${T}`;
-/**
- * Represents the fields of a collection template as a mapping from field name to type string.
- */
 export type TplCollectionFields = Record<string, string>;
-/**
- * Represents all valid primitive field type strings for a collection field.
- * Includes enumPrimitive keys, text variants, dot-paths, and foreign key references.
- * @template T - (Unused, for future extension)
- */
 export type TplFieldPrimitive<T = {}> = keyof typeof enumPrimitive | `text-${'tiny' | 'short' | 'medium' | 'long' | 'area'}` | `${string}.${string}` | `fk-${string}.${string}`;
-/**
- * Represents object or array wrappers for primitive field types.
- */
 export type TplObjectFieldPrimitive = IdbObjectify<TplFieldPrimitive>;
-/**
- * Represents a foreign key field type string (e.g., 'fk-users.id').
- */
 export type TplFieldFk = `fk-${string}.${string}`;
-/**
- * Represents object or array wrappers for foreign key field types.
- */
 export type TplFkObject = IdbObjectify<TplFieldFk>;
-/**
- * Union of all valid field type strings for a collection field, including primitives, objects, and foreign keys.
- */
 export type TplTypes = TplFieldPrimitive | TplObjectFieldPrimitive | TplFieldFk | TplFkObject;
-/**
- * Represents a field type string with property arguments, e.g., 'text (readonly required)'.
- */
 export type TplFieldArgs = `${TplTypes} (${CombinedArgs})`;
-/**
- * Represents the allowed rules for a field: either a type string or a type string with arguments.
- */
+/** rules */
 export type TplFieldRules = TplFieldArgs | TplTypes;
-/**
- * Alias for TplFieldRules, used for clarity in some contexts.
- */
 export type TplFieldType = TplFieldArgs | TplTypes;
-/**
- * Helper type for schema/field construction utilities.
- * Used internally for dynamic schema building and validation.
- */
 export type IDbForge = {
     collection?: TplCollectionName;
     fieldName?: keyof TplFields;
@@ -109,65 +41,23 @@ export type IDbForge = {
     fieldArgs?: [keyof typeof TplProperties] | undefined;
     is: any;
 };
-/**
- * Main model type for describing the schema of an IndexedDB database.
- * Maps collection names to their CollectionModel definitions.
- * @template T - The shape of the collections in the database.
- */
 export type IdbqModel<T = Record<string, Record<string, any>>> = {
     readonly [K in keyof T]: CollectionModel<T[K]>;
 };
-/**
- * Type alias for a collection name in the schema model.
- */
 export type TplCollectionName<T = TplCollectionFields> = keyof IdbqModel<T>;
-/**
- * Type alias for the template property of a CollectionModel.
- */
 export type Tpl<T = TplCollectionFields> = CollectionModel<T>['template'];
-/**
- * Type alias for the fields property of a CollectionModel's template.
- */
 export type TplFields<T = TplCollectionFields> = CollectionModel<T>['template']['fields'];
-/**
- * Describes the structure and metadata for a single collection in the database schema.
- * Includes keyPath, TypeScript type, and template (fields, indexes, FKs, etc).
- * @template T - The shape of the collection's fields.
- */
 export type CollectionModel<T = TplCollectionFields> = {
-    /**
-     * The key path (primary key) for the collection in IndexedDB.
-     */
     keyPath: string | any;
-    /**
-     * @deprecated Use 'ts' instead for type safety.
-     */
+    /** @deprecated use ts instead */
     model: any;
-    /**
-     * The TypeScript type representing the collection's data shape.
-     */
     ts: any;
-    /**
-     * Template metadata for the collection: fields, indexes, presentation, and foreign keys.
-     */
     template: {
-        /**
-         * The main index field for the collection.
-         */
         index: string;
-        /**
-         * Presentation string for UI or display purposes (combination of field names).
-         */
         presentation: CombineElements<Extract<keyof CollectionModel<T>['ts'], string>>;
-        /**
-         * Field definitions for the collection.
-         */
         fields: {
             [K in keyof T]: TplFieldRules;
         };
-        /**
-         * Foreign key definitions for the collection.
-         */
         fks: {
             [K in TplCollectionName]?: {
                 code: K;
@@ -177,4 +67,3 @@ export type CollectionModel<T = TplCollectionFields> = {
         };
     };
 };
-export {};

package/dist/idbqlCore/types.js

@@ -1,7 +1,3 @@
-/**
- * Enumeration of primitive field types supported by the schema system.
- * Used for type-safe field declarations in collection templates.
- */
 export var enumPrimitive;
 (function (enumPrimitive) {
     enumPrimitive["id"] = "id";
@@ -17,12 +13,6 @@ export var enumPrimitive;
     enumPrimitive["time"] = "time";
     enumPrimitive["password"] = "password";
 })(enumPrimitive || (enumPrimitive = {}));
-/**
- * Enumeration of special field properties for schema fields.
- * - private: Field is internal and not exposed externally.
- * - readonly: Field cannot be modified after creation.
- * - required: Field must be present in the data model.
- */
 export var TplProperties;
 (function (TplProperties) {
     TplProperties["private"] = "private";

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 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 './path/pathResolver.js';
 export * from './collection/collection.svelte.js';

package/dist/index.js

@@ -2,8 +2,8 @@
 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 './path/pathResolver.js';
 export * from './collection/collection.svelte.js';

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

@@ -1,9 +1,9 @@
-import type { IdbqlIndexedCore } from '../idbqlCore/idbqlCore.js';
+import type { IdbqlIndexedCore } from "../idbqlCore/idbqlCore.js";
 interface IdbqlIndexedCore {
     [key: string]: CollectionCore<any>;
 }
-import type { CollectionCore } from '../collection/collection.svelte.js';
-import { type Where, type ResultSet, type ResultsetOptions } from '@medyll/idae-query';
+import type { CollectionCore } from "../collection/collection.svelte.js";
+import { type Where, type ResultSet, type ResultsetOptions } from "@medyll/idae-query";
 /**
  * Main entry point.
  * Creates a state object with indexedDB synchronization.
@@ -13,6 +13,7 @@ import { type Where, type ResultSet, type ResultsetOptions } from '@medyll/idae-
 export declare const createIdbqlState: (idbBase: IdbqlIndexedCore) => {
     collectionState: Record<string, CollectionState<any>>;
     qolie: (collection: string) => {
+        put: (value: Partial<any>) => Promise<any>;
         get: any;
         getBy: (value: any, pathKey?: string) => ResultSet<any>;
         getOne: any;
@@ -24,8 +25,6 @@ export declare const createIdbqlState: (idbBase: IdbqlIndexedCore) => {
         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>;
 };
 /**
  * Represents a dynamic state collection that interacts with an IndexedDB base.

package/dist/state/idbstate.svelte.js

@@ -1,6 +1,6 @@
-import { idbqlEvent } from './idbqlEvent.svelte.js';
+import { idbqlEvent } from "./idbqlEvent.svelte.js";
 //
-import { Operators, getResultset } from '@medyll/idae-query';
+import { Operators, getResultset, } from "@medyll/idae-query";
 /**
  * Main entry point.
  * Creates a state object with indexedDB synchronization.
@@ -16,6 +16,7 @@ export const createIdbqlState = (idbBase) => {
         if (!collections[collection])
             throw new Error(`Collection ${collection} not found`);
         return {
+            put: collections[collection].put,
             get: collections[collection].get,
             getBy: collections[collection].getBy,
             getOne: collections[collection].getOne,
@@ -25,7 +26,7 @@ export const createIdbqlState = (idbBase) => {
             deleteWhere: collections[collection].deleteWhere,
             update: collections[collection].update,
             where: collections[collection].where,
-            updateWhere: collections[collection].updateWhere
+            updateWhere: collections[collection].updateWhere,
         };
     };
     function addCollection(collectionName) {
@@ -40,8 +41,6 @@ export const createIdbqlState = (idbBase) => {
     return {
         collectionState: collections,
         qolie: qolie,
-        onCollection: addCollection,
-        addCollection: addCollection
     };
 };
 /**
@@ -121,7 +120,7 @@ export class CollectionState {
      * @returns {T | undefined} The item found, or undefined if not found.
      */
     get get() {
-        return (value, pathKey = 'id') => {
+        return (value, pathKey = "id") => {
             return this.where({ [pathKey]: value })?.[0];
         };
     }
@@ -131,7 +130,7 @@ export class CollectionState {
      * @param {string} [pathKey="id"] - The key to search by.
      * @returns {ResultSet<T>} The result set of the query.
      */
-    getBy(value, pathKey = 'id') {
+    getBy(value, pathKey = "id") {
         return this.where({ [pathKey]: value });
     }
     /**
@@ -142,7 +141,7 @@ export class CollectionState {
      * @returns {T | undefined} The item found, or undefined if not found.
      */
     get getOne() {
-        return (value, pathKey = 'id') => {
+        return (value, pathKey = "id") => {
             return this.where({ [pathKey]: value })?.[0];
         };
     }

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@medyll/idae-idbql",
+  "bin": {
+    "idae-idbql": "./cli.js"
+  },
   "scope": "@medyll",
-  "version": "0.178.0",
+  "author": "Lebrun Meddy",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/medyll/idae.git"
+  },
+  "version": "0.185.2",
   "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.",
   "exports": {
     ".": {
@@ -20,7 +28,12 @@
   "peerDependencies": {
     "svelte": "^5.0.0-next"
   },
+  "publishConfig": {
+    "access": "public",
+    "directory": "."
+  },
   "devDependencies": {
+    "@semantic-release/github": "^10.3.5",
     "@sveltejs/adapter-auto": "^6.0.0",
     "@sveltejs/kit": "^2.20.7",
     "@sveltejs/package": "^2.3.11",
@@ -30,8 +43,8 @@
     "tslib": "^2.8.1",
     "typescript": "^5.8.3",
     "vite": "^6.3.2",
-    "@medyll/idae-prettier-config": "1.2.1",
-    "@medyll/idae-query": "0.179.0"
+    "@medyll/idae-eslint-config": "0.1.5",
+    "@medyll/idae-query": "0.186.2"
   },
   "svelte": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -45,6 +58,6 @@
     "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
     "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
     "test": "vitest",
-    "package:pre": "node scripts/package-pre.js"
+    "prepackage": "node scripts/package-pre.js"
   }
 }