@ls-stack/utils 3.60.0 → 3.61.0

package/dist/mutationUtils.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/mutationUtils.ts
 var mutationUtils_exports = {};
 __export(mutationUtils_exports, {
+  getArrayMethodsFromProduce: () => getArrayMethodsFromProduce,
   updateObject: () => updateObject
 });
 module.exports = __toCommonJS(mutationUtils_exports);
@@ -97,6 +98,11 @@ function keepPrevIfUnchanged({
   return equalityFn(prev, newValue) ? prev : newValue;
 }
 
+// src/typeGuards.ts
+function isFunction(value) {
+  return typeof value === "function";
+}
+
 // src/mutationUtils.ts
 function updateObject(object, updates) {
   if (!object || typeof object !== "object") {
@@ -112,7 +118,36 @@ function updateObject(object, updates) {
     }
   }
 }
+function getArrayMethodsFromProduce(produceFn, getItemId) {
+  return {
+    add: (item) => produceFn((draft) => {
+      draft.push(item);
+    }),
+    remove: (id) => produceFn((draft) => {
+      const index = draft.findIndex((item) => getItemId(item) === id);
+      if (index !== -1) {
+        draft.splice(index, 1);
+      }
+    }),
+    update: (id, updateItem) => produceFn((draft) => {
+      const index = draft.findIndex((item2) => getItemId(item2) === id);
+      const item = draft[index];
+      if (!item) {
+        throw new Error(`Item with id ${id} not found`);
+      }
+      if (isFunction(updateItem)) {
+        const updatedItem = updateItem(item);
+        if (updatedItem) {
+          draft[index] = updatedItem;
+        }
+      } else {
+        updateObject(item, updateItem);
+      }
+    })
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  getArrayMethodsFromProduce,
   updateObject
 });

package/dist/mutationUtils.d.cts

@@ -6,5 +6,10 @@
  * @param updates - The new values to update the object with.
  */
 declare function updateObject<T extends Record<string, unknown>>(object: T | undefined | null, updates: Partial<T>): void;
+declare function getArrayMethodsFromProduce<T extends Record<string, unknown>>(produceFn: (cb: (newVal: T[]) => void | T[]) => T[] | void, getItemId: (item: T) => string): {
+    add: (item: T) => void | T[];
+    remove: (id: string) => void | T[];
+    update: (id: string, updateItem: ((draftItem: T) => T | void) | Partial<T>) => void | T[];
+};
 
-export { updateObject };
+export { getArrayMethodsFromProduce, updateObject };

package/dist/mutationUtils.d.ts

@@ -6,5 +6,10 @@
  * @param updates - The new values to update the object with.
  */
 declare function updateObject<T extends Record<string, unknown>>(object: T | undefined | null, updates: Partial<T>): void;
+declare function getArrayMethodsFromProduce<T extends Record<string, unknown>>(produceFn: (cb: (newVal: T[]) => void | T[]) => T[] | void, getItemId: (item: T) => string): {
+    add: (item: T) => void | T[];
+    remove: (id: string) => void | T[];
+    update: (id: string, updateItem: ((draftItem: T) => T | void) | Partial<T>) => void | T[];
+};
 
-export { updateObject };
+export { getArrayMethodsFromProduce, updateObject };

package/dist/mutationUtils.js

@@ -2,6 +2,9 @@ import {
   keepPrevIfUnchanged
 } from "./chunk-QQS7I7ZL.js";
 import "./chunk-JQFUKJU5.js";
+import {
+  isFunction
+} from "./chunk-JF2MDHOJ.js";
 
 // src/mutationUtils.ts
 function updateObject(object, updates) {
@@ -18,6 +21,35 @@ function updateObject(object, updates) {
     }
   }
 }
+function getArrayMethodsFromProduce(produceFn, getItemId) {
+  return {
+    add: (item) => produceFn((draft) => {
+      draft.push(item);
+    }),
+    remove: (id) => produceFn((draft) => {
+      const index = draft.findIndex((item) => getItemId(item) === id);
+      if (index !== -1) {
+        draft.splice(index, 1);
+      }
+    }),
+    update: (id, updateItem) => produceFn((draft) => {
+      const index = draft.findIndex((item2) => getItemId(item2) === id);
+      const item = draft[index];
+      if (!item) {
+        throw new Error(`Item with id ${id} not found`);
+      }
+      if (isFunction(updateItem)) {
+        const updatedItem = updateItem(item);
+        if (updatedItem) {
+          draft[index] = updatedItem;
+        }
+      } else {
+        updateObject(item, updateItem);
+      }
+    })
+  };
+}
 export {
+  getArrayMethodsFromProduce,
   updateObject
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Universal TypeScript utilities for browser and Node.js",
-  "version": "3.60.0",
+  "version": "3.61.0",
   "license": "MIT",
   "files": [
     "dist",