@codeleap/query 5.8.9 → 5.8.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeleap/query",
-  "version": "5.8.9",
+  "version": "5.8.11",
   "main": "src/index.ts",
   "license": "UNLICENSED",
   "repository": {
@@ -9,15 +9,15 @@
     "directory": "packages/query"
   },
   "devDependencies": {
-    "@codeleap/config": "5.8.9",
-    "@codeleap/types": "5.8.9",
+    "@codeleap/config": "5.8.11",
+    "@codeleap/types": "5.8.11",
     "ts-node-dev": "1.1.8"
   },
   "scripts": {
     "build": "echo 'No build needed'"
   },
   "peerDependencies": {
-    "@codeleap/types": "5.8.9",
+    "@codeleap/types": "5.8.11",
     "typescript": "5.5.2",
     "@tanstack/react-query": "5.89.0"
   },

package/package.json.bak

@@ -1,6 +1,6 @@
 {
   "name": "@codeleap/query",
-  "version": "5.8.9",
+  "version": "5.8.11",
   "main": "src/index.ts",
   "license": "UNLICENSED",
   "repository": {

package/src/lib/Mutations.ts

@@ -116,14 +116,19 @@ export class Mutations<T extends QueryItem, F> {
   }
 
   /**
-   * Removes an item from all cached list queries and returns the positions where it was found
+   * Removes an item from all or specific cached list query and returns the positions where it was found
    * @param itemId - The ID of the item to remove
-   * @returns A RemovedItemMap containing the query keys and positions where the item was found, or null if not found
+   * @param listFilters - Optional filters to target a specific list query. If omitted, removes from all list queries
+   * @returns A RemovedItemMap containing the query keys and positions where the item was found, or null if not found in any query
    * 
    * @example
    * ```typescript
+   * // Remove from all list queries
    * const removedPositions = mutations.removeItem('user-123')
    * 
+   * // Remove from a specific filtered list
+   * const removedPositions = mutations.removeItem('user-123', { status: 'active' })
+   * 
    * // Later, restore the item to its original positions
    * if (removedPositions) {
    *   mutations.addItem(restoredUser, removedPositions)

package/src/lib/QueryKeys.ts

@@ -337,6 +337,11 @@ export class QueryKeys<T extends QueryItem, F> {
     return queries as Query<ListPaginationResponse<T>, Error, Omit<ListSelector<T>, 'allItems'>, QueryKey>[]
   }
 
+  /**
+   * Gets a specific list query from the query cache
+   * @param listFilters - Optional filters to identify a specific list query. If omitted, returns the unfiltered list query
+   * @returns The matching list query, or undefined if not found
+   */
   getListQuery(listFilters?: F) {
     const query = this.queryClient.getQueryCache().find({
       queryKey: this.listKeyWithFilters(listFilters)