tanstack-cacher 1.5.0 → 1.6.0

package/index.d.ts

@@ -10,7 +10,7 @@ interface PaginationConfig {
     pageSizePath?: string;
 }
 interface CacheConfig<TData, TItem> {
-    queryClient: QueryClient;
+    queryClient?: QueryClient;
     queryKey: QueryKey;
     itemsPath?: string;
     pagination?: PaginationConfig;
@@ -36,6 +36,9 @@ declare class QueryCacheManager<TData, TItem> {
     update(updatedItem: Partial<TItem>, matcher?: (item: TItem) => boolean): void;
     updateWithCustomLogic(updater: (oldData: any) => any): void;
     delete(itemOrId: TItem | string | number, matcher?: (item: TItem) => boolean): void;
+    updateArrayAtPath<TItem = any>(path: string, updater: TItem | TItem[] | ((items: TItem[]) => TItem[]), options?: {
+        position?: InsertPosition;
+    }): void;
     replace(newData: TData): void;
     clear(): void;
     getItemsFromCache(): TItem[];

package/index.js

@@ -268,6 +268,28 @@ var QueryCacheManager = class {
       this.invalidate();
     }
   }
+  updateArrayAtPath(path, updater, options) {
+    try {
+      this.config.queryClient.setQueryData(this.config.queryKey, (oldData) => {
+        if (!oldData) return oldData;
+        const current = getAtPath(oldData, path, []);
+        const safeCurrent = Array.isArray(current) ? current : [];
+        let updatedItems;
+        if (typeof updater === "function") {
+          updatedItems = updater(safeCurrent);
+        } else if (Array.isArray(updater)) {
+          updatedItems = updater;
+        } else {
+          const position = options?.position ?? "start";
+          updatedItems = position === "start" ? [updater, ...safeCurrent] : [...safeCurrent, updater];
+        }
+        return setAtPath(oldData, path, updatedItems);
+      });
+    } catch (error) {
+      console.error("[QueryCacheManager] updateArrayAtPath failed:", error);
+      this.invalidate();
+    }
+  }
   /**
    * Replace full data
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tanstack-cacher",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "A lightweight cache management utility for TanStack Query that simplifies adding, updating, deleting, and synchronizing cached data",
   "license": "MIT",
   "repository": {
@@ -81,4 +81,4 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.2"
   }
-}
+}