pathtrace 1.0.0-beta.1 → 1.0.0-beta.2

package/README.md

@@ -1,15 +1,15 @@
 # pathtrace 🔍
 
+[![npm version](https://badge.fury.io/js/pathtrace.svg)](https://badge.fury.io/js/pathtrace)
 [![main](https://github.com/tada5hi/pathtrace/actions/workflows/main.yml/badge.svg)](https://github.com/tada5hi/pathtrace/actions/workflows/main.yml)
-[![CodeQL](https://github.com/tada5hi/pathtrace/actions/workflows/codeql.yml/badge.svg)](https://github.com/tada5hi/pathtrace/actions/workflows/codeql.yml)
 [![Known Vulnerabilities](https://snyk.io/test/github/tada5hi/pathtrace/badge.svg)](https://snyk.io/test/github/tada5hi/pathtrace)
 [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white)](https://conventionalcommits.org)
 
 **Pathtrace** is a library for managing nested objects and arrays. 
-It offers straightforward methods for 
-retrieving ([getPathValue](#getPathValue)) and
-setting ([setPathValue](#setPathValue)) values at any path.
-Additionally, [getPathInfo](#getPathInfo) provides detailed path information, 
+It offers straightforward methods for retrieving ([getPathValue](#getpathvalue)) and
+setting ([setPathValue](#setpathvalue)) values at any path. 
+Additionally, [getPathInfo](#getpathinfo) provides detailed path information, 
+and the [expandPath](#expandpath) helper allows for querying and expanding paths with wildcards and globstars,
 making it ideal for handling complex data structures efficiently.
 
 **Table of Contents**
@@ -18,6 +18,7 @@ making it ideal for handling complex data structures efficiently.
 - [Usage](#usage)
     - [getPathValue](#getpathvalue)
     - [setPathValue](#setpathvalue)
+    - [expandPath](#expandpath)
     - [getPathInfo](#getpathinfo)
 - [License](#license)
 
@@ -213,6 +214,52 @@ var modifiedObj = setPathValue(obj, 'user.contact.phone', '987-654-3210');
 console.log(modifiedObj === obj); // true
 ```
 
+### expandPath
+
+The expandPath function takes an object and a string representing a path, 
+potentially containing wildcards (`*`) and globstars (`**`),
+and returns an array of all possible matching paths within the object.
+
+**Example: Wildcard (`*`) - Select all shallow paths of an array**
+```ts
+import { expandPath } from 'pathtrace';
+
+const obj = {
+    foo: ['bar', 'baz'],
+};
+const paths = expandPath(obj, 'foo.*');
+console.log(paths); // ['foo[0]', 'foo[1]']
+```
+
+**Example: Wildcard (`*`) - Select matching paths under a wildcard branch**
+
+```ts
+import { expandPath } from 'pathtrace';
+
+const obj = { foo: { bar: { a: true }, baz: { a: false, b: 1 } } };
+const paths = expandPath(obj, 'foo.*.a');
+console.log(paths); // ['foo.bar.a', 'foo.baz.a']
+```
+
+**Example: Globstar (`**`) - Select all leaves that match a leaf globstar**
+
+```ts
+import { expandPath } from 'pathtrace';
+
+const obj = { foo: { a: { b: { c: 1 } }, d: { e: 2 } } };
+const paths = expandPath(obj, 'foo.**');
+console.log(paths); // ['foo.a.b.c', 'foo.d.e']
+```
+
+**Example: Globstar (`**`) - Select deeply nested matching paths under a globstar branch**
+
+```ts
+import { expandPath } from 'pathtrace';
+
+const obj = { foo: { a: { b: { bar: 1 } }, c: { bar: 2 } } };
+const paths = expandPath(obj, 'foo.**.bar');
+console.log(paths); // ['foo.a.b.bar', 'foo.c.bar']
+```
 
 ### getPathInfo
 

package/dist/constants.d.ts

@@ -0,0 +1,4 @@
+export declare enum Character {
+    WILDCARD = "*",
+    GLOBSTAR = "**"
+}

package/dist/expand-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Expand wildcard and glob patterns to paths.
+ *
+ * @param data
+ * @param path
+ */
+export declare function expandPath(data: Record<string, any>, path: string | string[]): string[];

package/dist/get-path-info.d.ts

@@ -1,2 +1,2 @@
 import { PathInfo } from './path-info';
-export declare function getPathInfo(data: Record<string, any>, path?: string): PathInfo;
+export declare function getPathInfo(data: Record<string, any>, path: string | string[]): PathInfo;

package/dist/index.cjs

@@ -11,7 +11,6 @@
  */ function arrayToPath(parts) {
     return parts.reduce((prev, segment)=>{
         let part = '';
-        segment = segment === '\\*' ? '*' : segment;
         segment = segment.replace(/^\[(\d+)]$/g, '\\[$1]');
         segment = segment.replace(/\./g, '\\.');
         if (/^\d+$/.test(segment)) {
@@ -62,6 +61,89 @@
     return result;
 }
 
+/*
+ * Copyright (c) 2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ var Character;
+(function(Character) {
+    Character["WILDCARD"] = "*";
+    Character["GLOBSTAR"] = "**";
+})(Character || (Character = {}));
+
+/*
+ * Copyright (c) 2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ function isObject(input) {
+    return !!input && typeof input === 'object' && !Array.isArray(input);
+}
+
+function expandPathInternal(data, path, currPath = []) {
+    const segments = Array.isArray(path) ? path : pathToArray(path);
+    if (!segments.length) {
+        // no more paths to traverse
+        return [
+            arrayToPath(currPath)
+        ];
+    }
+    const key = segments[0];
+    const rest = segments.slice(1);
+    if (typeof data !== 'undefined' && data !== null && !isObject(data) && !Array.isArray(data)) {
+        if (key === Character.GLOBSTAR) {
+            if (!rest.length) {
+                // globstar leaves are always selected
+                return [
+                    arrayToPath(currPath)
+                ];
+            }
+            return [];
+        }
+        if (key === Character.WILDCARD) {
+            return [];
+        }
+        // value is a primitive, paths being traversed from here might be in their prototype,
+        // return the entire path
+        return [
+            arrayToPath([
+                ...currPath,
+                ...segments
+            ])
+        ];
+    }
+    // Use a non-null value so that non-existing fields are still selected
+    data = data || {};
+    if (key === Character.WILDCARD) {
+        return Object.keys(data).flatMap((key)=>expandPathInternal(data[key], arrayToPath(rest), currPath.concat(key)));
+    }
+    if (key === Character.GLOBSTAR) {
+        return Object.keys(data).flatMap((key)=>{
+            const nextPath = currPath.concat(key);
+            const value = data[key];
+            const set = new Set([
+                // recursively find matching sub-paths
+                ...expandPathInternal(value, arrayToPath(segments), nextPath),
+                // skip the first remaining segment, if it matches the current key
+                ...rest[0] === key ? expandPathInternal(value, arrayToPath(rest.slice(1)), nextPath) : []
+            ]);
+            return [
+                ...set
+            ];
+        });
+    }
+    return expandPathInternal(data[key], rest, currPath.concat(key));
+}
+/**
+ * Expand wildcard and glob patterns to paths.
+ *
+ * @param data
+ * @param path
+ */ function expandPath(data, path) {
+    return expandPathInternal(data, path);
+}
+
 function getPathValue(data, path) {
     const parts = Array.isArray(path) ? path : pathToArray(path);
     let res;
@@ -113,10 +195,9 @@ class PathInfo {
             return this._parent;
         }
         if (this.pathParts.length > 1) {
-            const parentPathParts = this.pathParts.slice(0, this.pathParts.length - 1);
-            this._parent = new PathInfo(this.data, arrayToPath(parentPathParts));
+            this._parent = new PathInfo(this.data, this.pathParts.slice(0, this.pathParts.length - 1));
         } else {
-            this._parent = new PathInfo(this.data);
+            this._parent = new PathInfo(this.data, []);
         }
         return this._parent;
     }
@@ -137,8 +218,11 @@ class PathInfo {
     }
     constructor(data, path){
         this.data = data;
-        this.path = path;
-        this.pathParts = this.path ? pathToArray(this.path) : [];
+        if (Array.isArray(path)) {
+            this.pathParts = path;
+        } else {
+            this.pathParts = pathToArray(path);
+        }
     }
 }
 
@@ -146,15 +230,6 @@ function getPathInfo(data, path) {
     return new PathInfo(data, path);
 }
 
-/*
- * Copyright (c) 2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function isObject(input) {
-    return !!input && typeof input === 'object' && !Array.isArray(input);
-}
-
 const NUMBER_REGEX = /^\d+$/;
 function setPathValue(data, path, value) {
     const parts = Array.isArray(path) ? path : pathToArray(path);
@@ -186,6 +261,7 @@ function setPathValue(data, path, value) {
 
 exports.BRACKET_NUMBER_REGEX = BRACKET_NUMBER_REGEX;
 exports.arrayToPath = arrayToPath;
+exports.expandPath = expandPath;
 exports.getPathInfo = getPathInfo;
 exports.getPathValue = getPathValue;
 exports.pathToArray = pathToArray;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/helpers/array-to-path.ts","../src/helpers/path-to-array.ts","../src/get-path-value.ts","../src/path-info.ts","../src/get-path-info.ts","../src/utils/is-object.ts","../src/set-path-value.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\n/**\n * @see https://github.com/express-validator/express-validator/blob/bec1dcbaa29002dcd21093ec84818c4671063b5d/src/field-selection.ts#L214\n * @param parts\n */\nexport function arrayToPath(parts: readonly string[]) : string {\n    return parts.reduce((prev, segment) => {\n        let part = '';\n        segment = segment === '\\\\*' ? '*' : segment;\n\n        segment = segment.replace(/^\\[(\\d+)]$/g, '\\\\[$1]');\n        segment = segment.replace(/\\./g, '\\\\.');\n\n        if (/^\\d+$/.test(segment)) {\n            // Index access\n            part = `[${segment}]`;\n        } else if (prev) {\n            // Object key access\n            part = `.${segment}`;\n        } else {\n            // Top level key\n            part = segment;\n        }\n\n        return prev + part;\n    }, '');\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport const BRACKET_NUMBER_REGEX = /(?<!\\\\)\\[(\\d+)]$/;\n\n/**\n * Convert string to property path array.\n *\n * @see https://github.com/lodash/lodash/blob/main/src/.internal/stringToPath.ts\n * @see https://github.com/chaijs/pathval\n *\n * @param segment\n */\nexport function pathToArray(segment: string) : string[] {\n    const str = segment.replace(/([^\\\\])\\[/g, '$1.[');\n    const parts = str.match(/(\\\\\\.|[^.]+?)+/g);\n    if (!parts) {\n        return [];\n    }\n\n    const result : string[] = [];\n\n    for (let i = 0; i < parts.length; i++) {\n        if (\n            parts[i] === 'constructor' ||\n            parts[i] === '__proto__' ||\n            parts[i] === 'prototype'\n        ) {\n            continue;\n        }\n\n        const regex = BRACKET_NUMBER_REGEX.exec(parts[i]);\n        if (regex) {\n            result.push(regex[1]);\n        } else {\n            result.push(parts[i].replace(/\\\\([.[\\]])/g, '$1'));\n        }\n    }\n\n    return result;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\n\nexport function getPathValue(\n    data: unknown,\n    path: string | string[],\n): unknown {\n    const parts = Array.isArray(path) ? path : pathToArray(path);\n\n    let res : unknown | undefined;\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        if (temp === null || typeof temp === 'undefined') {\n            break;\n        }\n\n        if (parts[index] in Object(temp)) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            // @ts-expect-error\n            temp = temp[parts[index]];\n        } else {\n            break;\n        }\n\n        if (index === parts.length - 1) {\n            res = temp;\n        }\n\n        index++;\n    }\n\n    return res;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { getPathValue } from './get-path-value';\nimport { arrayToPath, pathToArray } from './helpers';\n\nexport class PathInfo {\n    protected data: unknown;\n\n    protected path : string | undefined;\n\n    protected pathParts: string[];\n\n    protected _value: unknown;\n\n    protected _parent: PathInfo | null | undefined;\n\n    protected _exists: boolean | undefined;\n\n    constructor(data: unknown, path?: string) {\n        this.data = data;\n        this.path = path;\n        this.pathParts = this.path ?\n            pathToArray(this.path) :\n            [];\n    }\n\n    get value() {\n        if (typeof this._value !== 'undefined') {\n            return this._value;\n        }\n\n        if (this.pathParts.length > 0) {\n            this._value = getPathValue(this.data, this.pathParts);\n        } else {\n            this._value = this.data;\n        }\n\n        return this._value;\n    }\n\n    get name() : string | null {\n        if (this.pathParts.length > 0) {\n            return this.pathParts[this.pathParts.length - 1];\n        }\n\n        return null;\n    }\n\n    get parent() : PathInfo | null {\n        if (typeof this._parent !== 'undefined') {\n            return this._parent;\n        }\n\n        if (this.pathParts.length === 0) {\n            this._parent = null;\n            return this._parent;\n        }\n\n        if (this.pathParts.length > 1) {\n            const parentPathParts = this.pathParts.slice(0, this.pathParts.length - 1);\n            this._parent = new PathInfo(\n                this.data,\n                arrayToPath(parentPathParts),\n            );\n        } else {\n            this._parent = new PathInfo(this.data);\n        }\n\n        return this._parent;\n    }\n\n    get exists() : boolean {\n        if (typeof this._exists !== 'undefined') {\n            return this._exists;\n        }\n\n        if (!this.name || !this.parent) {\n            this._exists = true;\n            return this._exists;\n        }\n\n        if (\n            this.parent.value !== null &&\n            typeof this.parent.value !== 'undefined'\n        ) {\n            this._exists = this.name in Object(this.parent.value);\n        } else {\n            this._exists = false;\n        }\n\n        return this._exists;\n    }\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { PathInfo } from './path-info';\n\nexport function getPathInfo(\n    data: Record<string, any>,\n    path?: string,\n) : PathInfo {\n    return new PathInfo(data, path);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport function isObject(input: unknown) : input is Record<string, any> {\n    return !!input &&\n        typeof input === 'object' &&\n        !Array.isArray(input);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\nimport { isObject } from './utils';\n\nconst NUMBER_REGEX = /^\\d+$/;\n\nexport function setPathValue(\n    data: Record<string, any> | Record<string, any>[],\n    path: string | string[],\n    value: unknown,\n) {\n    const parts = Array.isArray(path) ? path : pathToArray(path);\n\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        /* istanbul ignore next */\n        if (!Array.isArray(temp) && !isObject(temp)) {\n            break;\n        }\n\n        const key = parts[index] as keyof typeof temp;\n\n        // [foo, '0']\n        if (typeof temp[key] === 'undefined') {\n            const match = NUMBER_REGEX.test(key);\n            if (match) {\n                (temp as Record<string, any>)[key] = [];\n            } else {\n                temp[key] = {};\n            }\n        }\n\n        if (index === parts.length - 1) {\n            temp[key] = value;\n            break;\n        }\n\n        index++;\n        temp = temp[key];\n    }\n\n    return data;\n}\n"],"names":["arrayToPath","parts","reduce","prev","segment","part","replace","test","BRACKET_NUMBER_REGEX","pathToArray","str","match","result","i","length","regex","exec","push","getPathValue","data","path","Array","isArray","res","temp","index","Object","PathInfo","value","_value","pathParts","name","parent","_parent","parentPathParts","slice","exists","_exists","constructor","getPathInfo","isObject","input","NUMBER_REGEX","setPathValue","key"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/helpers/array-to-path.ts","../src/helpers/path-to-array.ts","../src/constants.ts","../src/utils/is-object.ts","../src/expand-path.ts","../src/get-path-value.ts","../src/path-info.ts","../src/get-path-info.ts","../src/set-path-value.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\n/**\n * @see https://github.com/express-validator/express-validator/blob/bec1dcbaa29002dcd21093ec84818c4671063b5d/src/field-selection.ts#L214\n * @param parts\n */\nexport function arrayToPath(parts: readonly string[]) : string {\n    return parts.reduce((prev, segment) => {\n        let part = '';\n\n        segment = segment.replace(/^\\[(\\d+)]$/g, '\\\\[$1]');\n        segment = segment.replace(/\\./g, '\\\\.');\n\n        if (/^\\d+$/.test(segment)) {\n            // Index access\n            part = `[${segment}]`;\n        } else if (prev) {\n            // Object key access\n            part = `.${segment}`;\n        } else {\n            // Top level key\n            part = segment;\n        }\n\n        return prev + part;\n    }, '');\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport const BRACKET_NUMBER_REGEX = /(?<!\\\\)\\[(\\d+)]$/;\n\n/**\n * Convert string to property path array.\n *\n * @see https://github.com/lodash/lodash/blob/main/src/.internal/stringToPath.ts\n * @see https://github.com/chaijs/pathval\n *\n * @param segment\n */\nexport function pathToArray(segment: string) : string[] {\n    const str = segment.replace(/([^\\\\])\\[/g, '$1.[');\n    const parts = str.match(/(\\\\\\.|[^.]+?)+/g);\n    if (!parts) {\n        return [];\n    }\n\n    const result : string[] = [];\n\n    for (let i = 0; i < parts.length; i++) {\n        if (\n            parts[i] === 'constructor' ||\n            parts[i] === '__proto__' ||\n            parts[i] === 'prototype'\n        ) {\n            continue;\n        }\n\n        const regex = BRACKET_NUMBER_REGEX.exec(parts[i]);\n        if (regex) {\n            result.push(regex[1]);\n        } else {\n            result.push(parts[i].replace(/\\\\([.[\\]])/g, '$1'));\n        }\n    }\n\n    return result;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum Character {\n    WILDCARD = '*',\n    GLOBSTAR = '**',\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport function isObject(input: unknown) : input is Record<string, any> {\n    return !!input &&\n        typeof input === 'object' &&\n        !Array.isArray(input);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { Character } from './constants';\nimport { isObject } from './utils';\nimport { arrayToPath, pathToArray } from './helpers';\n\nfunction expandPathInternal(\n    data: Record<string, any>,\n    path: string | string[],\n    currPath: readonly string[] = [],\n): string[] {\n    const segments = Array.isArray(path) ? path : pathToArray(path);\n    if (!segments.length) {\n        // no more paths to traverse\n        return [arrayToPath(currPath)];\n    }\n\n    const key = segments[0];\n    const rest = segments.slice(1);\n\n    if (\n        typeof data !== 'undefined' &&\n        data !== null &&\n        !isObject(data) &&\n        !Array.isArray(data)\n    ) {\n        if (key === Character.GLOBSTAR) {\n            if (!rest.length) {\n                // globstar leaves are always selected\n                return [arrayToPath(currPath)];\n            }\n\n            return [];\n        }\n\n        if (key === Character.WILDCARD) {\n            return [];\n        }\n\n        // value is a primitive, paths being traversed from here might be in their prototype,\n        // return the entire path\n        return [arrayToPath([...currPath, ...segments])];\n    }\n\n    // Use a non-null value so that non-existing fields are still selected\n    data = data || {};\n\n    if (key === Character.WILDCARD) {\n        return Object.keys(data)\n            .flatMap((key) => expandPathInternal(data[key], arrayToPath(rest), currPath.concat(key)));\n    }\n\n    if (key === Character.GLOBSTAR) {\n        return Object.keys(data)\n            .flatMap((key) => {\n                const nextPath = currPath.concat(key);\n                const value = data[key];\n                const set = new Set([\n                    // recursively find matching sub-paths\n                    ...expandPathInternal(value, arrayToPath(segments), nextPath),\n                    // skip the first remaining segment, if it matches the current key\n                    ...(rest[0] === key ? expandPathInternal(value, arrayToPath(rest.slice(1)), nextPath) : []),\n                ]);\n\n                return [...set];\n            });\n    }\n\n    return expandPathInternal(data[key], rest, currPath.concat(key));\n}\n\n/**\n * Expand wildcard and glob patterns to paths.\n *\n * @param data\n * @param path\n */\nexport function expandPath(\n    data: Record<string, any>,\n    path: string | string[],\n): string[] {\n    return expandPathInternal(data, path);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\n\nexport function getPathValue(\n    data: unknown,\n    path: string | string[],\n): unknown {\n    const parts = Array.isArray(path) ?\n        path :\n        pathToArray(path);\n\n    let res : unknown | undefined;\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        if (temp === null || typeof temp === 'undefined') {\n            break;\n        }\n\n        if (parts[index] in Object(temp)) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            // @ts-expect-error\n            temp = temp[parts[index]];\n        } else {\n            break;\n        }\n\n        if (index === parts.length - 1) {\n            res = temp;\n        }\n\n        index++;\n    }\n\n    return res;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { getPathValue } from './get-path-value';\nimport { pathToArray } from './helpers';\n\nexport class PathInfo {\n    protected data: unknown;\n\n    protected pathParts: string[];\n\n    protected _value: unknown;\n\n    protected _parent: PathInfo | null | undefined;\n\n    protected _exists: boolean | undefined;\n\n    constructor(data: unknown, path: string | string[]) {\n        this.data = data;\n\n        if (Array.isArray(path)) {\n            this.pathParts = path;\n        } else {\n            this.pathParts = pathToArray(path);\n        }\n    }\n\n    get value() {\n        if (typeof this._value !== 'undefined') {\n            return this._value;\n        }\n\n        if (this.pathParts.length > 0) {\n            this._value = getPathValue(this.data, this.pathParts);\n        } else {\n            this._value = this.data;\n        }\n\n        return this._value;\n    }\n\n    get name() : string | null {\n        if (this.pathParts.length > 0) {\n            return this.pathParts[this.pathParts.length - 1];\n        }\n\n        return null;\n    }\n\n    get parent() : PathInfo | null {\n        if (typeof this._parent !== 'undefined') {\n            return this._parent;\n        }\n\n        if (this.pathParts.length === 0) {\n            this._parent = null;\n            return this._parent;\n        }\n\n        if (this.pathParts.length > 1) {\n            this._parent = new PathInfo(\n                this.data,\n                this.pathParts.slice(0, this.pathParts.length - 1),\n            );\n        } else {\n            this._parent = new PathInfo(this.data, []);\n        }\n\n        return this._parent;\n    }\n\n    get exists() : boolean {\n        if (typeof this._exists !== 'undefined') {\n            return this._exists;\n        }\n\n        if (!this.name || !this.parent) {\n            this._exists = true;\n            return this._exists;\n        }\n\n        if (\n            this.parent.value !== null &&\n            typeof this.parent.value !== 'undefined'\n        ) {\n            this._exists = this.name in Object(this.parent.value);\n        } else {\n            this._exists = false;\n        }\n\n        return this._exists;\n    }\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { PathInfo } from './path-info';\n\nexport function getPathInfo(\n    data: Record<string, any>,\n    path: string | string[],\n) : PathInfo {\n    return new PathInfo(data, path);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\nimport { isObject } from './utils';\n\nconst NUMBER_REGEX = /^\\d+$/;\n\nexport function setPathValue(\n    data: Record<string, any> | Record<string, any>[],\n    path: string | string[],\n    value: unknown,\n) {\n    const parts = Array.isArray(path) ?\n        path :\n        pathToArray(path);\n\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        /* istanbul ignore next */\n        if (!Array.isArray(temp) && !isObject(temp)) {\n            break;\n        }\n\n        const key = parts[index] as keyof typeof temp;\n\n        // [foo, '0']\n        if (typeof temp[key] === 'undefined') {\n            const match = NUMBER_REGEX.test(key);\n            if (match) {\n                (temp as Record<string, any>)[key] = [];\n            } else {\n                temp[key] = {};\n            }\n        }\n\n        if (index === parts.length - 1) {\n            temp[key] = value;\n            break;\n        }\n\n        index++;\n        temp = temp[key];\n    }\n\n    return data;\n}\n"],"names":["arrayToPath","parts","reduce","prev","segment","part","replace","test","BRACKET_NUMBER_REGEX","pathToArray","str","match","result","i","length","regex","exec","push","Character","isObject","input","Array","isArray","expandPathInternal","data","path","currPath","segments","key","rest","slice","GLOBSTAR","WILDCARD","Object","keys","flatMap","concat","nextPath","value","set","Set","expandPath","getPathValue","res","temp","index","PathInfo","_value","pathParts","name","parent","_parent","exists","_exists","constructor","getPathInfo","NUMBER_REGEX","setPathValue"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './helpers';
+export * from './expand-path';
 export * from './get-path-value';
 export * from './get-path-info';
 export * from './set-path-value';

package/dist/index.mjs

@@ -9,7 +9,6 @@
  */ function arrayToPath(parts) {
     return parts.reduce((prev, segment)=>{
         let part = '';
-        segment = segment === '\\*' ? '*' : segment;
         segment = segment.replace(/^\[(\d+)]$/g, '\\[$1]');
         segment = segment.replace(/\./g, '\\.');
         if (/^\d+$/.test(segment)) {
@@ -60,6 +59,89 @@
     return result;
 }
 
+/*
+ * Copyright (c) 2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ var Character;
+(function(Character) {
+    Character["WILDCARD"] = "*";
+    Character["GLOBSTAR"] = "**";
+})(Character || (Character = {}));
+
+/*
+ * Copyright (c) 2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ function isObject(input) {
+    return !!input && typeof input === 'object' && !Array.isArray(input);
+}
+
+function expandPathInternal(data, path, currPath = []) {
+    const segments = Array.isArray(path) ? path : pathToArray(path);
+    if (!segments.length) {
+        // no more paths to traverse
+        return [
+            arrayToPath(currPath)
+        ];
+    }
+    const key = segments[0];
+    const rest = segments.slice(1);
+    if (typeof data !== 'undefined' && data !== null && !isObject(data) && !Array.isArray(data)) {
+        if (key === Character.GLOBSTAR) {
+            if (!rest.length) {
+                // globstar leaves are always selected
+                return [
+                    arrayToPath(currPath)
+                ];
+            }
+            return [];
+        }
+        if (key === Character.WILDCARD) {
+            return [];
+        }
+        // value is a primitive, paths being traversed from here might be in their prototype,
+        // return the entire path
+        return [
+            arrayToPath([
+                ...currPath,
+                ...segments
+            ])
+        ];
+    }
+    // Use a non-null value so that non-existing fields are still selected
+    data = data || {};
+    if (key === Character.WILDCARD) {
+        return Object.keys(data).flatMap((key)=>expandPathInternal(data[key], arrayToPath(rest), currPath.concat(key)));
+    }
+    if (key === Character.GLOBSTAR) {
+        return Object.keys(data).flatMap((key)=>{
+            const nextPath = currPath.concat(key);
+            const value = data[key];
+            const set = new Set([
+                // recursively find matching sub-paths
+                ...expandPathInternal(value, arrayToPath(segments), nextPath),
+                // skip the first remaining segment, if it matches the current key
+                ...rest[0] === key ? expandPathInternal(value, arrayToPath(rest.slice(1)), nextPath) : []
+            ]);
+            return [
+                ...set
+            ];
+        });
+    }
+    return expandPathInternal(data[key], rest, currPath.concat(key));
+}
+/**
+ * Expand wildcard and glob patterns to paths.
+ *
+ * @param data
+ * @param path
+ */ function expandPath(data, path) {
+    return expandPathInternal(data, path);
+}
+
 function getPathValue(data, path) {
     const parts = Array.isArray(path) ? path : pathToArray(path);
     let res;
@@ -111,10 +193,9 @@ class PathInfo {
             return this._parent;
         }
         if (this.pathParts.length > 1) {
-            const parentPathParts = this.pathParts.slice(0, this.pathParts.length - 1);
-            this._parent = new PathInfo(this.data, arrayToPath(parentPathParts));
+            this._parent = new PathInfo(this.data, this.pathParts.slice(0, this.pathParts.length - 1));
         } else {
-            this._parent = new PathInfo(this.data);
+            this._parent = new PathInfo(this.data, []);
         }
         return this._parent;
     }
@@ -135,8 +216,11 @@ class PathInfo {
     }
     constructor(data, path){
         this.data = data;
-        this.path = path;
-        this.pathParts = this.path ? pathToArray(this.path) : [];
+        if (Array.isArray(path)) {
+            this.pathParts = path;
+        } else {
+            this.pathParts = pathToArray(path);
+        }
     }
 }
 
@@ -144,15 +228,6 @@ function getPathInfo(data, path) {
     return new PathInfo(data, path);
 }
 
-/*
- * Copyright (c) 2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function isObject(input) {
-    return !!input && typeof input === 'object' && !Array.isArray(input);
-}
-
 const NUMBER_REGEX = /^\d+$/;
 function setPathValue(data, path, value) {
     const parts = Array.isArray(path) ? path : pathToArray(path);
@@ -182,5 +257,5 @@ function setPathValue(data, path, value) {
     return data;
 }
 
-export { BRACKET_NUMBER_REGEX, arrayToPath, getPathInfo, getPathValue, pathToArray, setPathValue };
+export { BRACKET_NUMBER_REGEX, arrayToPath, expandPath, getPathInfo, getPathValue, pathToArray, setPathValue };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/helpers/array-to-path.ts","../src/helpers/path-to-array.ts","../src/get-path-value.ts","../src/path-info.ts","../src/get-path-info.ts","../src/utils/is-object.ts","../src/set-path-value.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\n/**\n * @see https://github.com/express-validator/express-validator/blob/bec1dcbaa29002dcd21093ec84818c4671063b5d/src/field-selection.ts#L214\n * @param parts\n */\nexport function arrayToPath(parts: readonly string[]) : string {\n    return parts.reduce((prev, segment) => {\n        let part = '';\n        segment = segment === '\\\\*' ? '*' : segment;\n\n        segment = segment.replace(/^\\[(\\d+)]$/g, '\\\\[$1]');\n        segment = segment.replace(/\\./g, '\\\\.');\n\n        if (/^\\d+$/.test(segment)) {\n            // Index access\n            part = `[${segment}]`;\n        } else if (prev) {\n            // Object key access\n            part = `.${segment}`;\n        } else {\n            // Top level key\n            part = segment;\n        }\n\n        return prev + part;\n    }, '');\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport const BRACKET_NUMBER_REGEX = /(?<!\\\\)\\[(\\d+)]$/;\n\n/**\n * Convert string to property path array.\n *\n * @see https://github.com/lodash/lodash/blob/main/src/.internal/stringToPath.ts\n * @see https://github.com/chaijs/pathval\n *\n * @param segment\n */\nexport function pathToArray(segment: string) : string[] {\n    const str = segment.replace(/([^\\\\])\\[/g, '$1.[');\n    const parts = str.match(/(\\\\\\.|[^.]+?)+/g);\n    if (!parts) {\n        return [];\n    }\n\n    const result : string[] = [];\n\n    for (let i = 0; i < parts.length; i++) {\n        if (\n            parts[i] === 'constructor' ||\n            parts[i] === '__proto__' ||\n            parts[i] === 'prototype'\n        ) {\n            continue;\n        }\n\n        const regex = BRACKET_NUMBER_REGEX.exec(parts[i]);\n        if (regex) {\n            result.push(regex[1]);\n        } else {\n            result.push(parts[i].replace(/\\\\([.[\\]])/g, '$1'));\n        }\n    }\n\n    return result;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\n\nexport function getPathValue(\n    data: unknown,\n    path: string | string[],\n): unknown {\n    const parts = Array.isArray(path) ? path : pathToArray(path);\n\n    let res : unknown | undefined;\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        if (temp === null || typeof temp === 'undefined') {\n            break;\n        }\n\n        if (parts[index] in Object(temp)) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            // @ts-expect-error\n            temp = temp[parts[index]];\n        } else {\n            break;\n        }\n\n        if (index === parts.length - 1) {\n            res = temp;\n        }\n\n        index++;\n    }\n\n    return res;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { getPathValue } from './get-path-value';\nimport { arrayToPath, pathToArray } from './helpers';\n\nexport class PathInfo {\n    protected data: unknown;\n\n    protected path : string | undefined;\n\n    protected pathParts: string[];\n\n    protected _value: unknown;\n\n    protected _parent: PathInfo | null | undefined;\n\n    protected _exists: boolean | undefined;\n\n    constructor(data: unknown, path?: string) {\n        this.data = data;\n        this.path = path;\n        this.pathParts = this.path ?\n            pathToArray(this.path) :\n            [];\n    }\n\n    get value() {\n        if (typeof this._value !== 'undefined') {\n            return this._value;\n        }\n\n        if (this.pathParts.length > 0) {\n            this._value = getPathValue(this.data, this.pathParts);\n        } else {\n            this._value = this.data;\n        }\n\n        return this._value;\n    }\n\n    get name() : string | null {\n        if (this.pathParts.length > 0) {\n            return this.pathParts[this.pathParts.length - 1];\n        }\n\n        return null;\n    }\n\n    get parent() : PathInfo | null {\n        if (typeof this._parent !== 'undefined') {\n            return this._parent;\n        }\n\n        if (this.pathParts.length === 0) {\n            this._parent = null;\n            return this._parent;\n        }\n\n        if (this.pathParts.length > 1) {\n            const parentPathParts = this.pathParts.slice(0, this.pathParts.length - 1);\n            this._parent = new PathInfo(\n                this.data,\n                arrayToPath(parentPathParts),\n            );\n        } else {\n            this._parent = new PathInfo(this.data);\n        }\n\n        return this._parent;\n    }\n\n    get exists() : boolean {\n        if (typeof this._exists !== 'undefined') {\n            return this._exists;\n        }\n\n        if (!this.name || !this.parent) {\n            this._exists = true;\n            return this._exists;\n        }\n\n        if (\n            this.parent.value !== null &&\n            typeof this.parent.value !== 'undefined'\n        ) {\n            this._exists = this.name in Object(this.parent.value);\n        } else {\n            this._exists = false;\n        }\n\n        return this._exists;\n    }\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { PathInfo } from './path-info';\n\nexport function getPathInfo(\n    data: Record<string, any>,\n    path?: string,\n) : PathInfo {\n    return new PathInfo(data, path);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport function isObject(input: unknown) : input is Record<string, any> {\n    return !!input &&\n        typeof input === 'object' &&\n        !Array.isArray(input);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\nimport { isObject } from './utils';\n\nconst NUMBER_REGEX = /^\\d+$/;\n\nexport function setPathValue(\n    data: Record<string, any> | Record<string, any>[],\n    path: string | string[],\n    value: unknown,\n) {\n    const parts = Array.isArray(path) ? path : pathToArray(path);\n\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        /* istanbul ignore next */\n        if (!Array.isArray(temp) && !isObject(temp)) {\n            break;\n        }\n\n        const key = parts[index] as keyof typeof temp;\n\n        // [foo, '0']\n        if (typeof temp[key] === 'undefined') {\n            const match = NUMBER_REGEX.test(key);\n            if (match) {\n                (temp as Record<string, any>)[key] = [];\n            } else {\n                temp[key] = {};\n            }\n        }\n\n        if (index === parts.length - 1) {\n            temp[key] = value;\n            break;\n        }\n\n        index++;\n        temp = temp[key];\n    }\n\n    return data;\n}\n"],"names":["arrayToPath","parts","reduce","prev","segment","part","replace","test","BRACKET_NUMBER_REGEX","pathToArray","str","match","result","i","length","regex","exec","push","getPathValue","data","path","Array","isArray","res","temp","index","Object","PathInfo","value","_value","pathParts","name","parent","_parent","parentPathParts","slice","exists","_exists","constructor","getPathInfo","isObject","input","NUMBER_REGEX","setPathValue","key"],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/helpers/array-to-path.ts","../src/helpers/path-to-array.ts","../src/constants.ts","../src/utils/is-object.ts","../src/expand-path.ts","../src/get-path-value.ts","../src/path-info.ts","../src/get-path-info.ts","../src/set-path-value.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\n/**\n * @see https://github.com/express-validator/express-validator/blob/bec1dcbaa29002dcd21093ec84818c4671063b5d/src/field-selection.ts#L214\n * @param parts\n */\nexport function arrayToPath(parts: readonly string[]) : string {\n    return parts.reduce((prev, segment) => {\n        let part = '';\n\n        segment = segment.replace(/^\\[(\\d+)]$/g, '\\\\[$1]');\n        segment = segment.replace(/\\./g, '\\\\.');\n\n        if (/^\\d+$/.test(segment)) {\n            // Index access\n            part = `[${segment}]`;\n        } else if (prev) {\n            // Object key access\n            part = `.${segment}`;\n        } else {\n            // Top level key\n            part = segment;\n        }\n\n        return prev + part;\n    }, '');\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport const BRACKET_NUMBER_REGEX = /(?<!\\\\)\\[(\\d+)]$/;\n\n/**\n * Convert string to property path array.\n *\n * @see https://github.com/lodash/lodash/blob/main/src/.internal/stringToPath.ts\n * @see https://github.com/chaijs/pathval\n *\n * @param segment\n */\nexport function pathToArray(segment: string) : string[] {\n    const str = segment.replace(/([^\\\\])\\[/g, '$1.[');\n    const parts = str.match(/(\\\\\\.|[^.]+?)+/g);\n    if (!parts) {\n        return [];\n    }\n\n    const result : string[] = [];\n\n    for (let i = 0; i < parts.length; i++) {\n        if (\n            parts[i] === 'constructor' ||\n            parts[i] === '__proto__' ||\n            parts[i] === 'prototype'\n        ) {\n            continue;\n        }\n\n        const regex = BRACKET_NUMBER_REGEX.exec(parts[i]);\n        if (regex) {\n            result.push(regex[1]);\n        } else {\n            result.push(parts[i].replace(/\\\\([.[\\]])/g, '$1'));\n        }\n    }\n\n    return result;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum Character {\n    WILDCARD = '*',\n    GLOBSTAR = '**',\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport function isObject(input: unknown) : input is Record<string, any> {\n    return !!input &&\n        typeof input === 'object' &&\n        !Array.isArray(input);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { Character } from './constants';\nimport { isObject } from './utils';\nimport { arrayToPath, pathToArray } from './helpers';\n\nfunction expandPathInternal(\n    data: Record<string, any>,\n    path: string | string[],\n    currPath: readonly string[] = [],\n): string[] {\n    const segments = Array.isArray(path) ? path : pathToArray(path);\n    if (!segments.length) {\n        // no more paths to traverse\n        return [arrayToPath(currPath)];\n    }\n\n    const key = segments[0];\n    const rest = segments.slice(1);\n\n    if (\n        typeof data !== 'undefined' &&\n        data !== null &&\n        !isObject(data) &&\n        !Array.isArray(data)\n    ) {\n        if (key === Character.GLOBSTAR) {\n            if (!rest.length) {\n                // globstar leaves are always selected\n                return [arrayToPath(currPath)];\n            }\n\n            return [];\n        }\n\n        if (key === Character.WILDCARD) {\n            return [];\n        }\n\n        // value is a primitive, paths being traversed from here might be in their prototype,\n        // return the entire path\n        return [arrayToPath([...currPath, ...segments])];\n    }\n\n    // Use a non-null value so that non-existing fields are still selected\n    data = data || {};\n\n    if (key === Character.WILDCARD) {\n        return Object.keys(data)\n            .flatMap((key) => expandPathInternal(data[key], arrayToPath(rest), currPath.concat(key)));\n    }\n\n    if (key === Character.GLOBSTAR) {\n        return Object.keys(data)\n            .flatMap((key) => {\n                const nextPath = currPath.concat(key);\n                const value = data[key];\n                const set = new Set([\n                    // recursively find matching sub-paths\n                    ...expandPathInternal(value, arrayToPath(segments), nextPath),\n                    // skip the first remaining segment, if it matches the current key\n                    ...(rest[0] === key ? expandPathInternal(value, arrayToPath(rest.slice(1)), nextPath) : []),\n                ]);\n\n                return [...set];\n            });\n    }\n\n    return expandPathInternal(data[key], rest, currPath.concat(key));\n}\n\n/**\n * Expand wildcard and glob patterns to paths.\n *\n * @param data\n * @param path\n */\nexport function expandPath(\n    data: Record<string, any>,\n    path: string | string[],\n): string[] {\n    return expandPathInternal(data, path);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\n\nexport function getPathValue(\n    data: unknown,\n    path: string | string[],\n): unknown {\n    const parts = Array.isArray(path) ?\n        path :\n        pathToArray(path);\n\n    let res : unknown | undefined;\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        if (temp === null || typeof temp === 'undefined') {\n            break;\n        }\n\n        if (parts[index] in Object(temp)) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            // @ts-expect-error\n            temp = temp[parts[index]];\n        } else {\n            break;\n        }\n\n        if (index === parts.length - 1) {\n            res = temp;\n        }\n\n        index++;\n    }\n\n    return res;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { getPathValue } from './get-path-value';\nimport { pathToArray } from './helpers';\n\nexport class PathInfo {\n    protected data: unknown;\n\n    protected pathParts: string[];\n\n    protected _value: unknown;\n\n    protected _parent: PathInfo | null | undefined;\n\n    protected _exists: boolean | undefined;\n\n    constructor(data: unknown, path: string | string[]) {\n        this.data = data;\n\n        if (Array.isArray(path)) {\n            this.pathParts = path;\n        } else {\n            this.pathParts = pathToArray(path);\n        }\n    }\n\n    get value() {\n        if (typeof this._value !== 'undefined') {\n            return this._value;\n        }\n\n        if (this.pathParts.length > 0) {\n            this._value = getPathValue(this.data, this.pathParts);\n        } else {\n            this._value = this.data;\n        }\n\n        return this._value;\n    }\n\n    get name() : string | null {\n        if (this.pathParts.length > 0) {\n            return this.pathParts[this.pathParts.length - 1];\n        }\n\n        return null;\n    }\n\n    get parent() : PathInfo | null {\n        if (typeof this._parent !== 'undefined') {\n            return this._parent;\n        }\n\n        if (this.pathParts.length === 0) {\n            this._parent = null;\n            return this._parent;\n        }\n\n        if (this.pathParts.length > 1) {\n            this._parent = new PathInfo(\n                this.data,\n                this.pathParts.slice(0, this.pathParts.length - 1),\n            );\n        } else {\n            this._parent = new PathInfo(this.data, []);\n        }\n\n        return this._parent;\n    }\n\n    get exists() : boolean {\n        if (typeof this._exists !== 'undefined') {\n            return this._exists;\n        }\n\n        if (!this.name || !this.parent) {\n            this._exists = true;\n            return this._exists;\n        }\n\n        if (\n            this.parent.value !== null &&\n            typeof this.parent.value !== 'undefined'\n        ) {\n            this._exists = this.name in Object(this.parent.value);\n        } else {\n            this._exists = false;\n        }\n\n        return this._exists;\n    }\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { PathInfo } from './path-info';\n\nexport function getPathInfo(\n    data: Record<string, any>,\n    path: string | string[],\n) : PathInfo {\n    return new PathInfo(data, path);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\nimport { isObject } from './utils';\n\nconst NUMBER_REGEX = /^\\d+$/;\n\nexport function setPathValue(\n    data: Record<string, any> | Record<string, any>[],\n    path: string | string[],\n    value: unknown,\n) {\n    const parts = Array.isArray(path) ?\n        path :\n        pathToArray(path);\n\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        /* istanbul ignore next */\n        if (!Array.isArray(temp) && !isObject(temp)) {\n            break;\n        }\n\n        const key = parts[index] as keyof typeof temp;\n\n        // [foo, '0']\n        if (typeof temp[key] === 'undefined') {\n            const match = NUMBER_REGEX.test(key);\n            if (match) {\n                (temp as Record<string, any>)[key] = [];\n            } else {\n                temp[key] = {};\n            }\n        }\n\n        if (index === parts.length - 1) {\n            temp[key] = value;\n            break;\n        }\n\n        index++;\n        temp = temp[key];\n    }\n\n    return data;\n}\n"],"names":["arrayToPath","parts","reduce","prev","segment","part","replace","test","BRACKET_NUMBER_REGEX","pathToArray","str","match","result","i","length","regex","exec","push","Character","isObject","input","Array","isArray","expandPathInternal","data","path","currPath","segments","key","rest","slice","GLOBSTAR","WILDCARD","Object","keys","flatMap","concat","nextPath","value","set","Set","expandPath","getPathValue","res","temp","index","PathInfo","_value","pathParts","name","parent","_parent","exists","_exists","constructor","getPathInfo","NUMBER_REGEX","setPathValue"],"mappings":"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"}

package/dist/path-info.d.ts

@@ -1,11 +1,10 @@
 export declare class PathInfo {
     protected data: unknown;
-    protected path: string | undefined;
     protected pathParts: string[];
     protected _value: unknown;
     protected _parent: PathInfo | null | undefined;
     protected _exists: boolean | undefined;
-    constructor(data: unknown, path?: string);
+    constructor(data: unknown, path: string | string[]);
     get value(): unknown;
     get name(): string | null;
     get parent(): PathInfo | null;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pathtrace",
-    "version": "1.0.0-beta.1",
+    "version": "1.0.0-beta.2",
     "description": "Simplifies working with nested objects and arrays by providing easy methods to retrieve, set, and check values at any path.",
     "exports": {
         "./package.json": "./package.json",
@@ -25,9 +25,6 @@
         "lint": "eslint --ext .js,.vue,.ts ./src ./test",
         "lint:fix": "npm run lint -- --fix"
     },
-    "bin": {
-        "authup": "dist/index.cjs"
-    },
     "keywords": [
         "nested-objects",
         "path",
@@ -41,7 +38,7 @@
         "email": "contact@tada5hi.net",
         "url": "https://github.com/tada5hi"
     },
-    "license": "Apache-2.0",
+    "license": "MIT",
     "repository": {
         "type": "git",
         "url": "git+https://github.com/tada5hi/pathtrace.git"