@ls-stack/utils 3.50.0 → 3.51.0

package/dist/chunk-Y76LZUOB.js

@@ -0,0 +1,151 @@
+import {
+  typedObjectEntries
+} from "./chunk-GMJTLFM6.js";
+import {
+  sortBy
+} from "./chunk-27AL66CH.js";
+
+// src/objUtils.ts
+import { Result } from "t-result";
+function objectTypedEntries(obj) {
+  return Object.entries(obj);
+}
+function pick(obj, keys) {
+  const result = {};
+  for (const key of keys) {
+    result[key] = obj[key];
+  }
+  return result;
+}
+function mapArrayToObject(array, mapper) {
+  return Object.fromEntries(array.map(mapper));
+}
+function mapObjectToObject(obj, mapper) {
+  return Object.fromEntries(
+    objectTypedEntries(obj).map(([key, value]) => mapper(key, value))
+  );
+}
+function omit(obj, keys) {
+  const result = {};
+  for (const key of Object.keys(obj)) {
+    if (!keys.includes(key)) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+function looseGetObjectProperty(obj, key) {
+  return obj[key];
+}
+function rejectObjUndefinedValues(obj) {
+  const result = {};
+  for (const key in obj) {
+    if (obj[key] !== void 0) {
+      result[key] = obj[key];
+    }
+  }
+  return result;
+}
+function filterObjectKeys(obj, predicate) {
+  return Object.fromEntries(
+    Object.entries(obj).filter(
+      ([key, value]) => predicate(key, value)
+    )
+  );
+}
+function sortObjectKeys(obj, sortByFn, options) {
+  return Object.fromEntries(
+    sortBy(typedObjectEntries(obj), sortByFn, options)
+  );
+}
+function getValueFromPath(obj, path) {
+  if (!path.trim()) {
+    return Result.err(new Error("Path cannot be empty"));
+  }
+  const segments = parsePath(path);
+  let current = obj;
+  for (let i = 0; i < segments.length; i++) {
+    const segment = segments[i];
+    if (!segment) {
+      return Result.err(new Error("Invalid empty segment in path"));
+    }
+    if (current == null) {
+      return Result.err(
+        new Error(`Cannot access property '${segment}' on null or undefined`)
+      );
+    }
+    if (isNumericString(segment)) {
+      if (!Array.isArray(current)) {
+        return Result.err(
+          new Error(
+            `Cannot access array index '${segment}' on non-array value`
+          )
+        );
+      }
+      const index = parseInt(segment, 10);
+      if (index < 0 || index >= current.length) {
+        return Result.err(new Error(`Array index '${index}' out of bounds`));
+      }
+      current = current[index];
+    } else {
+      if (typeof current !== "object" || current === null) {
+        return Result.err(
+          new Error(`Cannot access property '${segment}' on non-object value`)
+        );
+      }
+      if (!(segment in current)) {
+        return Result.err(new Error(`Property '${segment}' not found`));
+      }
+      current = current[segment];
+    }
+  }
+  return Result.ok(current);
+}
+function parsePath(path) {
+  const segments = [];
+  let current = "";
+  let inBrackets = false;
+  for (let i = 0; i < path.length; i++) {
+    const char = path[i];
+    if (char === "[") {
+      if (current) {
+        segments.push(current);
+        current = "";
+      }
+      inBrackets = true;
+    } else if (char === "]") {
+      if (inBrackets && current) {
+        segments.push(current);
+        current = "";
+      }
+      inBrackets = false;
+    } else if (char === "." && !inBrackets) {
+      if (current) {
+        segments.push(current);
+        current = "";
+      }
+    } else {
+      current += char;
+    }
+  }
+  if (current) {
+    segments.push(current);
+  }
+  return segments;
+}
+function isNumericString(str) {
+  return /^\d+$/.test(str);
+}
+
+export {
+  objectTypedEntries,
+  pick,
+  mapArrayToObject,
+  mapObjectToObject,
+  omit,
+  looseGetObjectProperty,
+  rejectObjUndefinedValues,
+  filterObjectKeys,
+  sortObjectKeys,
+  getValueFromPath
+};

package/dist/objUtils.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var objUtils_exports = {};
 __export(objUtils_exports, {
   filterObjectKeys: () => filterObjectKeys,
+  getValueFromPath: () => getValueFromPath,
   looseGetObjectProperty: () => looseGetObjectProperty,
   mapArrayToObject: () => mapArrayToObject,
   mapObjectToObject: () => mapObjectToObject,
@@ -31,6 +32,7 @@ __export(objUtils_exports, {
   sortObjectKeys: () => sortObjectKeys
 });
 module.exports = __toCommonJS(objUtils_exports);
+var import_t_result = require("t-result");
 
 // src/arrayUtils.ts
 function sortBy(arr, sortByValue, props = "asc") {
@@ -115,9 +117,88 @@ function sortObjectKeys(obj, sortByFn, options) {
     sortBy(typedObjectEntries(obj), sortByFn, options)
   );
 }
+function getValueFromPath(obj, path) {
+  if (!path.trim()) {
+    return import_t_result.Result.err(new Error("Path cannot be empty"));
+  }
+  const segments = parsePath(path);
+  let current = obj;
+  for (let i = 0; i < segments.length; i++) {
+    const segment = segments[i];
+    if (!segment) {
+      return import_t_result.Result.err(new Error("Invalid empty segment in path"));
+    }
+    if (current == null) {
+      return import_t_result.Result.err(
+        new Error(`Cannot access property '${segment}' on null or undefined`)
+      );
+    }
+    if (isNumericString(segment)) {
+      if (!Array.isArray(current)) {
+        return import_t_result.Result.err(
+          new Error(
+            `Cannot access array index '${segment}' on non-array value`
+          )
+        );
+      }
+      const index = parseInt(segment, 10);
+      if (index < 0 || index >= current.length) {
+        return import_t_result.Result.err(new Error(`Array index '${index}' out of bounds`));
+      }
+      current = current[index];
+    } else {
+      if (typeof current !== "object" || current === null) {
+        return import_t_result.Result.err(
+          new Error(`Cannot access property '${segment}' on non-object value`)
+        );
+      }
+      if (!(segment in current)) {
+        return import_t_result.Result.err(new Error(`Property '${segment}' not found`));
+      }
+      current = current[segment];
+    }
+  }
+  return import_t_result.Result.ok(current);
+}
+function parsePath(path) {
+  const segments = [];
+  let current = "";
+  let inBrackets = false;
+  for (let i = 0; i < path.length; i++) {
+    const char = path[i];
+    if (char === "[") {
+      if (current) {
+        segments.push(current);
+        current = "";
+      }
+      inBrackets = true;
+    } else if (char === "]") {
+      if (inBrackets && current) {
+        segments.push(current);
+        current = "";
+      }
+      inBrackets = false;
+    } else if (char === "." && !inBrackets) {
+      if (current) {
+        segments.push(current);
+        current = "";
+      }
+    } else {
+      current += char;
+    }
+  }
+  if (current) {
+    segments.push(current);
+  }
+  return segments;
+}
+function isNumericString(str) {
+  return /^\d+$/.test(str);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   filterObjectKeys,
+  getValueFromPath,
   looseGetObjectProperty,
   mapArrayToObject,
   mapObjectToObject,

package/dist/objUtils.d.cts

@@ -1,3 +1,4 @@
+import { Result } from 't-result';
 import { SortByValueFn, SortByProps } from './arrayUtils.cjs';
 import { MakeUndefinedKeysOptional } from './typeUtils.cjs';
 
@@ -14,5 +15,6 @@ declare function looseGetObjectProperty<T extends Record<string, unknown>>(obj:
 declare function rejectObjUndefinedValues<T extends Record<string, unknown>>(obj: T): MakeUndefinedKeysOptional<T>;
 declare function filterObjectKeys<T extends Record<string, unknown>>(obj: T, predicate: (key: keyof T, value: T[keyof T]) => boolean): Partial<T>;
 declare function sortObjectKeys<T extends Record<string, unknown>>(obj: T, sortByFn: SortByValueFn<[key: keyof T, value: T[keyof T]]>, options?: SortByProps): T;
+declare function getValueFromPath(obj: Record<string, unknown>, path: string): Result<unknown, Error>;
 
-export { filterObjectKeys, looseGetObjectProperty, mapArrayToObject, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };
+export { filterObjectKeys, getValueFromPath, looseGetObjectProperty, mapArrayToObject, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };

package/dist/objUtils.d.ts

@@ -1,3 +1,4 @@
+import { Result } from 't-result';
 import { SortByValueFn, SortByProps } from './arrayUtils.js';
 import { MakeUndefinedKeysOptional } from './typeUtils.js';
 
@@ -14,5 +15,6 @@ declare function looseGetObjectProperty<T extends Record<string, unknown>>(obj:
 declare function rejectObjUndefinedValues<T extends Record<string, unknown>>(obj: T): MakeUndefinedKeysOptional<T>;
 declare function filterObjectKeys<T extends Record<string, unknown>>(obj: T, predicate: (key: keyof T, value: T[keyof T]) => boolean): Partial<T>;
 declare function sortObjectKeys<T extends Record<string, unknown>>(obj: T, sortByFn: SortByValueFn<[key: keyof T, value: T[keyof T]]>, options?: SortByProps): T;
+declare function getValueFromPath(obj: Record<string, unknown>, path: string): Result<unknown, Error>;
 
-export { filterObjectKeys, looseGetObjectProperty, mapArrayToObject, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };
+export { filterObjectKeys, getValueFromPath, looseGetObjectProperty, mapArrayToObject, mapObjectToObject, objectTypedEntries, omit, pick, rejectObjUndefinedValues, sortObjectKeys };

package/dist/objUtils.js

@@ -1,5 +1,6 @@
 import {
   filterObjectKeys,
+  getValueFromPath,
   looseGetObjectProperty,
   mapArrayToObject,
   mapObjectToObject,
@@ -8,13 +9,14 @@ import {
   pick,
   rejectObjUndefinedValues,
   sortObjectKeys
-} from "./chunk-Y45CE75W.js";
+} from "./chunk-Y76LZUOB.js";
 import "./chunk-GMJTLFM6.js";
 import "./chunk-27AL66CH.js";
 import "./chunk-C2SVCIWE.js";
 import "./chunk-JF2MDHOJ.js";
 export {
   filterObjectKeys,
+  getValueFromPath,
   looseGetObjectProperty,
   mapArrayToObject,
   mapObjectToObject,

package/dist/testUtils.cjs

@@ -757,6 +757,7 @@ function clampMin(value, min) {
 }
 
 // src/objUtils.ts
+var import_t_result = require("t-result");
 function pick(obj, keys) {
   const result = {};
   for (const key of keys) {

package/dist/testUtils.js

@@ -4,7 +4,7 @@ import {
 import {
   omit,
   pick
-} from "./chunk-Y45CE75W.js";
+} from "./chunk-Y76LZUOB.js";
 import "./chunk-GMJTLFM6.js";
 import {
   filterObjectOrArrayKeys

package/dist/typeUtils.d.cts

@@ -56,5 +56,6 @@ type PickRequiredKeys<T> = {
     [K in keyof T]: undefined extends T[K] ? never : K;
 }[keyof T];
 type MakeUndefinedKeysOptional<T> = Prettify<Partial<Pick<T, PickUndefinedKeys<T>>> & Pick<T, PickRequiredKeys<T>>>;
+type StringWithAutoComplete<T extends string> = T | (string & {});
 
-export type { DeepPrettify, DeepReplaceValue, DefaultSkipTransverseDeepReplace, IsAny, MakeUndefinedKeysOptional, NonPartial, ObjKeysWithValuesOfType, PartialPossiblyUndefinedValues, PartialRecord, Prettify };
+export type { DeepPrettify, DeepReplaceValue, DefaultSkipTransverseDeepReplace, IsAny, MakeUndefinedKeysOptional, NonPartial, ObjKeysWithValuesOfType, PartialPossiblyUndefinedValues, PartialRecord, Prettify, StringWithAutoComplete };

package/dist/typeUtils.d.ts

@@ -56,5 +56,6 @@ type PickRequiredKeys<T> = {
     [K in keyof T]: undefined extends T[K] ? never : K;
 }[keyof T];
 type MakeUndefinedKeysOptional<T> = Prettify<Partial<Pick<T, PickUndefinedKeys<T>>> & Pick<T, PickRequiredKeys<T>>>;
+type StringWithAutoComplete<T extends string> = T | (string & {});
 
-export type { DeepPrettify, DeepReplaceValue, DefaultSkipTransverseDeepReplace, IsAny, MakeUndefinedKeysOptional, NonPartial, ObjKeysWithValuesOfType, PartialPossiblyUndefinedValues, PartialRecord, Prettify };
+export type { DeepPrettify, DeepReplaceValue, DefaultSkipTransverseDeepReplace, IsAny, MakeUndefinedKeysOptional, NonPartial, ObjKeysWithValuesOfType, PartialPossiblyUndefinedValues, PartialRecord, Prettify, StringWithAutoComplete };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Universal TypeScript utilities for browser and Node.js",
-  "version": "3.50.0",
+  "version": "3.51.0",
   "license": "MIT",
   "files": [
     "dist",

package/dist/chunk-Y45CE75W.js

@@ -1,71 +0,0 @@
-import {
-  typedObjectEntries
-} from "./chunk-GMJTLFM6.js";
-import {
-  sortBy
-} from "./chunk-27AL66CH.js";
-
-// src/objUtils.ts
-function objectTypedEntries(obj) {
-  return Object.entries(obj);
-}
-function pick(obj, keys) {
-  const result = {};
-  for (const key of keys) {
-    result[key] = obj[key];
-  }
-  return result;
-}
-function mapArrayToObject(array, mapper) {
-  return Object.fromEntries(array.map(mapper));
-}
-function mapObjectToObject(obj, mapper) {
-  return Object.fromEntries(
-    objectTypedEntries(obj).map(([key, value]) => mapper(key, value))
-  );
-}
-function omit(obj, keys) {
-  const result = {};
-  for (const key of Object.keys(obj)) {
-    if (!keys.includes(key)) {
-      result[key] = obj[key];
-    }
-  }
-  return result;
-}
-function looseGetObjectProperty(obj, key) {
-  return obj[key];
-}
-function rejectObjUndefinedValues(obj) {
-  const result = {};
-  for (const key in obj) {
-    if (obj[key] !== void 0) {
-      result[key] = obj[key];
-    }
-  }
-  return result;
-}
-function filterObjectKeys(obj, predicate) {
-  return Object.fromEntries(
-    Object.entries(obj).filter(
-      ([key, value]) => predicate(key, value)
-    )
-  );
-}
-function sortObjectKeys(obj, sortByFn, options) {
-  return Object.fromEntries(
-    sortBy(typedObjectEntries(obj), sortByFn, options)
-  );
-}
-
-export {
-  objectTypedEntries,
-  pick,
-  mapArrayToObject,
-  mapObjectToObject,
-  omit,
-  looseGetObjectProperty,
-  rejectObjUndefinedValues,
-  filterObjectKeys,
-  sortObjectKeys
-};