Nested Object Access

TypeScript-powered util to work with nested objects using dot-separated keys.

Get it on NPM here

This package exports the following stuff:

Helper type: NestedKeys

Returns a union of all dot-separated paths to entries in a nested object.

``ts
type TestDict = {
b: string;
c: { d: number; w: string; e: { p: false } };
t: { l: boolean; e: { q: "foo" } };
i: { d: string | undefined; o: null };
};

// Default functionality
// "b" | "c" | "t" | "i" | "c.d" | "c.w" | "c.e.p" | "t.e.q" | "t.l" | "i.d" | "i.o" | "c.e" | "t.e"
type TestKeys = NestedKeys;
// Get only the paths to primitive values
// "b" | "c.d" | "c.w" | "c.e.p" | "t.e.q" | "t.l" | "i.d" | "i.o"
type TestKeysPr = NestedKeys;
// Get only the paths to nested objects
// "c" | "t" | "i" | "c.e" | "t.e"
type TestKeysObj = NestedKeys;
// Get only up to a certain depth
// "b" | "c" | "t" | "i" | "c.d" | "c.w" | "c.e" | "t.e" | "t.l" | "i.d" | "i.o"
type TestKeysWithDepth = NestedKeys;
`

Helper type: RetrieveNested

Returns the type that is at a dot-separated path in an object.

`ts
type TestDict2 = { c: { e: { p: "pp" } } }

// { e: { p: "pp"; }; }
type TestNestedPath1 = RetrieveNested;
// { p: "pp"; }
type TestNestedPath2 = RetrieveNested;
// "pp"
type TestNestedPath3 = RetrieveNested;
`

Function: getNested

Function version of RetrieveNested.

`ts
import { getNested } from "nested-object-access";
const testDict = { c: { e: { p: "pp" } } };
console.log(getNested(testDict, "c.e.p")); // "pp"
`

TODO

- You can currently only pass a type Foo = {...} into the helper functions, not interface Foo {...}` because of missing index signature...