@ls-stack/utils 3.59.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/dist/objUtils.d.cts

@@ -1,6 +1,7 @@
 import { Result } from 't-result';
 import { SortByValueFn, SortByProps } from './arrayUtils.cjs';
 import { MakeUndefinedKeysOptional } from './typeUtils.cjs';
+import { AddPrefixToObjKeys, AddSuffixToObjKeys } from './typingUtils.cjs';
 
 /**
  * @deprecated Use typedObjectEntries from @ls-stack/utils/typingFnUtils instead
@@ -21,11 +22,7 @@ declare function filterObjectKeys<T extends Record<string, unknown>>(obj: T, pre
 declare function sortObjectKeys<T extends Record<string, unknown>>(obj: T, sortByFn: SortByValueFn<[key: keyof T, value: T[keyof T]]>, options?: SortByProps): T;
 declare function getValueFromPath(obj: Record<string, unknown>, path: string): Result<unknown, Error>;
 declare function getObjPropertyOrInsert<T extends Record<string, any>, K extends keyof T>(obj: T, prop: K, insertValue: () => Exclude<T[K], undefined>): Exclude<T[K], undefined>;
-declare function addPrefixToObjKeys<T extends Record<string, unknown>, P extends string>(obj: T, prefix: P): {
-    [K in keyof T & string as `${P}${K}`]: T[K];
-};
-declare function addSuffixToObjKeys<T extends Record<string, unknown>, S extends string>(obj: T, suffix: S): {
-    [K in keyof T & string as `${K}${S}`]: T[K];
-};
+declare function addPrefixToObjKeys<T extends Record<string, unknown>, P extends string>(obj: T, prefix: P): AddPrefixToObjKeys<T, P>;
+declare function addSuffixToObjKeys<T extends Record<string, unknown>, S extends string>(obj: T, suffix: S): AddSuffixToObjKeys<T, S>;
 
 export { addPrefixToObjKeys, addSuffixToObjKeys, filterObjectKeys, getObjPropertyOrInsert, getValueFromPath, looseGetObjectProperty, mapArrToObj, mapArrayToObject, mapObjToObj, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };

package/dist/objUtils.d.ts

@@ -1,6 +1,7 @@
 import { Result } from 't-result';
 import { SortByValueFn, SortByProps } from './arrayUtils.js';
 import { MakeUndefinedKeysOptional } from './typeUtils.js';
+import { AddPrefixToObjKeys, AddSuffixToObjKeys } from './typingUtils.js';
 
 /**
  * @deprecated Use typedObjectEntries from @ls-stack/utils/typingFnUtils instead
@@ -21,11 +22,7 @@ declare function filterObjectKeys<T extends Record<string, unknown>>(obj: T, pre
 declare function sortObjectKeys<T extends Record<string, unknown>>(obj: T, sortByFn: SortByValueFn<[key: keyof T, value: T[keyof T]]>, options?: SortByProps): T;
 declare function getValueFromPath(obj: Record<string, unknown>, path: string): Result<unknown, Error>;
 declare function getObjPropertyOrInsert<T extends Record<string, any>, K extends keyof T>(obj: T, prop: K, insertValue: () => Exclude<T[K], undefined>): Exclude<T[K], undefined>;
-declare function addPrefixToObjKeys<T extends Record<string, unknown>, P extends string>(obj: T, prefix: P): {
-    [K in keyof T & string as `${P}${K}`]: T[K];
-};
-declare function addSuffixToObjKeys<T extends Record<string, unknown>, S extends string>(obj: T, suffix: S): {
-    [K in keyof T & string as `${K}${S}`]: T[K];
-};
+declare function addPrefixToObjKeys<T extends Record<string, unknown>, P extends string>(obj: T, prefix: P): AddPrefixToObjKeys<T, P>;
+declare function addSuffixToObjKeys<T extends Record<string, unknown>, S extends string>(obj: T, suffix: S): AddSuffixToObjKeys<T, S>;
 
 export { addPrefixToObjKeys, addSuffixToObjKeys, filterObjectKeys, getObjPropertyOrInsert, getValueFromPath, looseGetObjectProperty, mapArrToObj, mapArrayToObject, mapObjToObj, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };

package/dist/typingUtils.d.cts

@@ -25,5 +25,11 @@ type Prettify<T extends Record<string, unknown>> = {
 type DeepPrettify<T> = {
     [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K];
 } & {};
+type AddPrefixToObjKeys<T extends Record<string, unknown>, Prefix extends string> = {
+    [K in keyof T & string as `${Prefix}${K}`]: T[K];
+};
+type AddSuffixToObjKeys<T extends Record<string, unknown>, Suffix extends string> = {
+    [K in keyof T & string as `${K}${Suffix}`]: T[K];
+};
 
-export type { DeepPrettify, IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord, Prettify };
+export type { AddPrefixToObjKeys, AddSuffixToObjKeys, DeepPrettify, IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord, Prettify };

package/dist/typingUtils.d.ts

@@ -25,5 +25,11 @@ type Prettify<T extends Record<string, unknown>> = {
 type DeepPrettify<T> = {
     [K in keyof T]: T[K] extends Record<string, unknown> ? DeepPrettify<T[K]> : T[K];
 } & {};
+type AddPrefixToObjKeys<T extends Record<string, unknown>, Prefix extends string> = {
+    [K in keyof T & string as `${Prefix}${K}`]: T[K];
+};
+type AddSuffixToObjKeys<T extends Record<string, unknown>, Suffix extends string> = {
+    [K in keyof T & string as `${K}${Suffix}`]: T[K];
+};
 
-export type { DeepPrettify, IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord, Prettify };
+export type { AddPrefixToObjKeys, AddSuffixToObjKeys, DeepPrettify, IsAny, NonPartial, ObjKeysWithValuesOfType, PartialRecord, Prettify };

package/package.json

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