objwalk 0.2.0 → 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Sergey Khalilov
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -13,7 +13,7 @@ npm install objwalk
 ## Usage
 
 ```ts
-import { each, extract, map, pick, set } from 'objwalk'
+import { each, extract, map, merge, pick, set } from 'objwalk'
 ```
 
 ## pick
@@ -81,6 +81,21 @@ set(data, 'items[0].title', 'First')
 
 `set` mutates the object passed to it and returns the same object.
 
+## merge
+
+Deeply merge plain objects into a target object.
+
+```ts
+const target = { user: { name: 'Ada', flags: { admin: false } } }
+
+merge(target, { user: { email: 'ada@example.com', flags: { admin: true } } })
+// {
+//   user: { name: 'Ada', email: 'ada@example.com', flags: { admin: true } },
+// }
+```
+
+`merge` mutates and returns `target`. Sources are applied from left to right. Arrays and non-plain objects, such as `Date`, replace the existing value rather than being merged.
+
 ## extract
 
 Create a new object by mapping destination paths to source paths.
@@ -189,4 +204,5 @@ set(data, path, value)
 extract(data, mapping)
 each(data, callback)
 map(data, callback)
+merge(target, ...sources)
 ```

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(index_exports, {
   each: () => each,
   extract: () => extract,
   map: () => map,
+  merge: () => merge,
   pick: () => pick,
   set: () => set
 });
@@ -230,11 +231,42 @@ var map = (data, callback, store = {}) => {
   });
   return store;
 };
+
+// src/merge.ts
+var unsafeKeys = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+var isPlainObject = (value) => {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+};
+var merge = (target, ...sources) => {
+  const targetRecord = target;
+  for (const source of sources) {
+    if (!isPlainObject(source)) {
+      continue;
+    }
+    for (const [key, sourceValue] of Object.entries(source)) {
+      if (unsafeKeys.has(key)) {
+        continue;
+      }
+      const targetValue = targetRecord[key];
+      if (isPlainObject(targetValue) && isPlainObject(sourceValue)) {
+        merge(targetValue, sourceValue);
+      } else {
+        targetRecord[key] = sourceValue;
+      }
+    }
+  }
+  return target;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   each,
   extract,
   map,
+  merge,
   pick,
   set
 });

package/dist/index.d.cts

@@ -12,7 +12,9 @@ declare const extract: (source: ObjwalkObject$1, mapping: ExtractMapping) => Obj
 type MapCallback<TStore extends Record<string, any> = Record<string, any>> = (key: WalkKey, value: any, store: TStore, path: string) => void;
 declare const map: <TStore extends Record<string, any> = Record<string, any>>(data: any, callback: MapCallback<TStore>, store?: TStore) => TStore;
 
+declare const merge: <T extends ObjwalkObject$1>(target: T, ...sources: unknown[]) => T;
+
 type ObjwalkObject = Record<string, any>;
 declare const set: (data: ObjwalkObject | undefined, path: string, value: any) => ObjwalkObject;
 
-export { type EachCallback, type ExtractMapping, type MapCallback, type ObjwalkObject$1 as ObjwalkObject, type WalkKey, each, extract, map, pick, set };
+export { type EachCallback, type ExtractMapping, type MapCallback, type ObjwalkObject$1 as ObjwalkObject, type WalkKey, each, extract, map, merge, pick, set };

package/dist/index.d.ts

@@ -12,7 +12,9 @@ declare const extract: (source: ObjwalkObject$1, mapping: ExtractMapping) => Obj
 type MapCallback<TStore extends Record<string, any> = Record<string, any>> = (key: WalkKey, value: any, store: TStore, path: string) => void;
 declare const map: <TStore extends Record<string, any> = Record<string, any>>(data: any, callback: MapCallback<TStore>, store?: TStore) => TStore;
 
+declare const merge: <T extends ObjwalkObject$1>(target: T, ...sources: unknown[]) => T;
+
 type ObjwalkObject = Record<string, any>;
 declare const set: (data: ObjwalkObject | undefined, path: string, value: any) => ObjwalkObject;
 
-export { type EachCallback, type ExtractMapping, type MapCallback, type ObjwalkObject$1 as ObjwalkObject, type WalkKey, each, extract, map, pick, set };
+export { type EachCallback, type ExtractMapping, type MapCallback, type ObjwalkObject$1 as ObjwalkObject, type WalkKey, each, extract, map, merge, pick, set };

package/dist/index.js

@@ -200,10 +200,41 @@ var map = (data, callback, store = {}) => {
   });
   return store;
 };
+
+// src/merge.ts
+var unsafeKeys = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+var isPlainObject = (value) => {
+  if (value === null || typeof value !== "object") {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+};
+var merge = (target, ...sources) => {
+  const targetRecord = target;
+  for (const source of sources) {
+    if (!isPlainObject(source)) {
+      continue;
+    }
+    for (const [key, sourceValue] of Object.entries(source)) {
+      if (unsafeKeys.has(key)) {
+        continue;
+      }
+      const targetValue = targetRecord[key];
+      if (isPlainObject(targetValue) && isPlainObject(sourceValue)) {
+        merge(targetValue, sourceValue);
+      } else {
+        targetRecord[key] = sourceValue;
+      }
+    }
+  }
+  return target;
+};
 export {
   each,
   extract,
   map,
+  merge,
   pick,
   set
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "objwalk",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "description": "Small utilities for reading, writing, walking, and reshaping nested JavaScript objects.",
   "keywords": [
     "object",