Nested-object-to-key-value NPM

🦤 Nested objects to key value

A lightweight utility to flatten nested JavaScript objects into dot-notation key-value pairs and unflatten them back. Perfect for handling complex configurations, form data, or API transformations.

Features

🎯 Zero dependencies
📦 Lightweight (~XKB gzipped)
💪 Fully typed (TypeScript)
🔍 Preserves type information
⚡ Tree-shakeable
🧪 Well tested

📦 Installation

npm install nested-object-to-key-value

📚 Usage

import { flattenJson, unflattenJson } from "nested-object-to-key-value";
// Flatten a nested object
const nested = {
user: {
		name: "John",
		address: {
			city: "New York",
			country: "USA",
		},
	},
};
const flattened = flattenJson(nested);
// Result:
// [
//   { key: "user.name", value: "John" },
//   { key: "user.address.city", value: "New York" },
//   { key: "user.address.country", value: "USA" }
// ]

// Unflatten back to nested object
const flat = {
	"user.name": "John",
	"user.address.city": "New York",
	"user.address.country": "USA",
};
const unflattened = unflattenJson(flat);
// Result:
// {
//   user: {
//   name: "John",
//   address: {
//   city: "New York",
//   country: "USA"
// }
// }
// }