objwalk 0.1.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,21 +23,69 @@ __export(index_exports, {
   each: () => each,
   extract: () => extract,
   map: () => map,
+  merge: () => merge,
   pick: () => pick,
   set: () => set
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/each.ts
-var isWalkable = (value) => {
-  return value !== null && typeof value === "object";
+// src/helpers/getValueByPath.ts
+var arraySegmentRegex = /^(\w+)\[(\d+)\]$/;
+var getValueByPath = (obj, path) => {
+  if (!path) return obj;
+  return path.split(".").reduce((result, current) => {
+    if (result === null || result === void 0) {
+      return void 0;
+    }
+    const match = current.match(arraySegmentRegex);
+    if (match) {
+      const [, key, index] = match;
+      const array = result[key];
+      return Array.isArray(array) ? array[parseInt(index, 10)] : void 0;
+    }
+    return result[current];
+  }, obj);
+};
+
+// src/helpers/parsePathSelection.ts
+var selectionRegex = /(.*)\{([^}]+)\}$/;
+var normalizeSelectionPath = (path) => {
+  return path.endsWith(".") ? path.slice(0, -1) : path;
+};
+var parseSelectedKeys = (selection) => {
+  if (selection.trim() === "*") {
+    return "all";
+  }
+  return selection.split(",").map((key) => key.trim()).filter(Boolean);
 };
+var parsePathSelection = (path = "") => {
+  const matches = path.match(selectionRegex);
+  if (!matches) {
+    return {
+      cleanPath: path,
+      keys: []
+    };
+  }
+  return {
+    cleanPath: normalizeSelectionPath(matches[1]),
+    keys: parseSelectedKeys(matches[2])
+  };
+};
+
+// src/helpers/createPath.ts
 var createPath = (parentPath, key, parentIsArray) => {
   if (parentIsArray) {
     return parentPath + "[" + key + "]";
   }
   return parentPath ? parentPath + "." + key : String(key);
 };
+
+// src/helpers/isWalkable.ts
+var isWalkable = (value) => {
+  return value !== null && typeof value === "object";
+};
+
+// src/each.ts
 var each = (data, callback) => {
   const walk = (value, path, key, parentIsArray) => {
     const currentPath = path || createPath("", key, parentIsArray);
@@ -69,48 +117,6 @@ var each = (data, callback) => {
   });
 };
 
-// src/helpers/getValueByPath.ts
-var getValueByPath = (obj, path) => {
-  if (!path) return obj;
-  return path.split(".").reduce((result, current) => {
-    if (result !== null && result !== void 0) {
-      const match = current.match(/(w+)[(d+)]/);
-      if (match) {
-        const [, key, index] = match;
-        const array = result[key];
-        return array && Array.isArray(array) ? array[parseInt(index, 10)] : void 0;
-      }
-      return result[current];
-    }
-    return void 0;
-  }, obj);
-};
-
-// src/helpers/parsePathSelection.ts
-var selectionRegex = /(.*){([^}]+)}$/;
-var normalizeSelectionPath = (path) => {
-  return path.endsWith(".") ? path.slice(0, -1) : path;
-};
-var parseSelectedKeys = (selection) => {
-  if (selection.trim() === "*") {
-    return "all";
-  }
-  return selection.split(",").map((key) => key.trim()).filter(Boolean);
-};
-var parsePathSelection = (path = "") => {
-  const matches = path.match(selectionRegex);
-  if (!matches) {
-    return {
-      cleanPath: path,
-      keys: []
-    };
-  }
-  return {
-    cleanPath: normalizeSelectionPath(matches[1]),
-    keys: parseSelectedKeys(matches[2])
-  };
-};
-
 // src/pick.ts
 var pick = (data = {}, path = "") => {
   const { cleanPath, keys } = parsePathSelection(path);
@@ -225,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

@@ -1,4 +1,5 @@
 type WalkKey = string | number;
+
 type EachCallback = (key: WalkKey, value: any, path: string) => void;
 declare const each: (data: any, callback: EachCallback) => void;
 
@@ -11,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

@@ -1,4 +1,5 @@
 type WalkKey = string | number;
+
 type EachCallback = (key: WalkKey, value: any, path: string) => void;
 declare const each: (data: any, callback: EachCallback) => void;
 
@@ -11,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

@@ -1,13 +1,60 @@
-// src/each.ts
-var isWalkable = (value) => {
-  return value !== null && typeof value === "object";
+// src/helpers/getValueByPath.ts
+var arraySegmentRegex = /^(\w+)\[(\d+)\]$/;
+var getValueByPath = (obj, path) => {
+  if (!path) return obj;
+  return path.split(".").reduce((result, current) => {
+    if (result === null || result === void 0) {
+      return void 0;
+    }
+    const match = current.match(arraySegmentRegex);
+    if (match) {
+      const [, key, index] = match;
+      const array = result[key];
+      return Array.isArray(array) ? array[parseInt(index, 10)] : void 0;
+    }
+    return result[current];
+  }, obj);
+};
+
+// src/helpers/parsePathSelection.ts
+var selectionRegex = /(.*)\{([^}]+)\}$/;
+var normalizeSelectionPath = (path) => {
+  return path.endsWith(".") ? path.slice(0, -1) : path;
+};
+var parseSelectedKeys = (selection) => {
+  if (selection.trim() === "*") {
+    return "all";
+  }
+  return selection.split(",").map((key) => key.trim()).filter(Boolean);
 };
+var parsePathSelection = (path = "") => {
+  const matches = path.match(selectionRegex);
+  if (!matches) {
+    return {
+      cleanPath: path,
+      keys: []
+    };
+  }
+  return {
+    cleanPath: normalizeSelectionPath(matches[1]),
+    keys: parseSelectedKeys(matches[2])
+  };
+};
+
+// src/helpers/createPath.ts
 var createPath = (parentPath, key, parentIsArray) => {
   if (parentIsArray) {
     return parentPath + "[" + key + "]";
   }
   return parentPath ? parentPath + "." + key : String(key);
 };
+
+// src/helpers/isWalkable.ts
+var isWalkable = (value) => {
+  return value !== null && typeof value === "object";
+};
+
+// src/each.ts
 var each = (data, callback) => {
   const walk = (value, path, key, parentIsArray) => {
     const currentPath = path || createPath("", key, parentIsArray);
@@ -39,48 +86,6 @@ var each = (data, callback) => {
   });
 };
 
-// src/helpers/getValueByPath.ts
-var getValueByPath = (obj, path) => {
-  if (!path) return obj;
-  return path.split(".").reduce((result, current) => {
-    if (result !== null && result !== void 0) {
-      const match = current.match(/(w+)[(d+)]/);
-      if (match) {
-        const [, key, index] = match;
-        const array = result[key];
-        return array && Array.isArray(array) ? array[parseInt(index, 10)] : void 0;
-      }
-      return result[current];
-    }
-    return void 0;
-  }, obj);
-};
-
-// src/helpers/parsePathSelection.ts
-var selectionRegex = /(.*){([^}]+)}$/;
-var normalizeSelectionPath = (path) => {
-  return path.endsWith(".") ? path.slice(0, -1) : path;
-};
-var parseSelectedKeys = (selection) => {
-  if (selection.trim() === "*") {
-    return "all";
-  }
-  return selection.split(",").map((key) => key.trim()).filter(Boolean);
-};
-var parsePathSelection = (path = "") => {
-  const matches = path.match(selectionRegex);
-  if (!matches) {
-    return {
-      cleanPath: path,
-      keys: []
-    };
-  }
-  return {
-    cleanPath: normalizeSelectionPath(matches[1]),
-    keys: parseSelectedKeys(matches[2])
-  };
-};
-
 // src/pick.ts
 var pick = (data = {}, path = "") => {
   const { cleanPath, keys } = parsePathSelection(path);
@@ -195,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.1.0",
+  "version": "1.0.0",
   "description": "Small utilities for reading, writing, walking, and reshaping nested JavaScript objects.",
   "keywords": [
     "object",
@@ -18,6 +18,14 @@
   ],
   "license": "ISC",
   "author": "Sergey Khalilov <sergey.khalilov@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/khalilov/objwalk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/khalilov/objwalk/issues"
+  },
+  "homepage": "https://github.com/khalilov/objwalk#readme",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -35,11 +43,12 @@
   ],
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "vitest run",
     "pack:check": "npm pack --dry-run"
   },
   "devDependencies": {
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
   }
 }