@sohanemon/utils 4.1.2 → 4.1.3

package/dist/functions/index.d.ts

@@ -7,6 +7,7 @@
 import { type ClassValue } from 'clsx';
 import type * as React from 'react';
 export * from './cookie';
+export * from './object';
 export declare function cn(...inputs: ClassValue[]): string;
 /**
  * @deprecated Use isLinkActive instead.

package/dist/functions/index.js

@@ -8,6 +8,7 @@ import { clsx } from 'clsx';
 import { extendTailwindMerge } from 'tailwind-merge';
 import { withFluid } from '@fluid-tailwind/tailwind-merge';
 export * from './cookie';
+export * from './object';
 export function cn(...inputs) {
     const twMerge = extendTailwindMerge(withFluid);
     return twMerge(clsx(inputs));

package/dist/functions/object.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Type representing a path split into segments
+ * @template S - The original path string type
+ */
+type SplitPath<S extends string> = S extends `${infer First}.${infer Rest}` ? [First, ...SplitPath<Rest>] : [S];
+/**
+ * Recursive type to resolve nested object types based on path
+ * @template T - Current object type
+ * @template K - Array of path segments
+ */
+type GetValue<T, K extends Array<string | number>> = K extends [
+    infer First,
+    ...infer Rest
+] ? First extends keyof T ? GetValue<T[First], Rest extends Array<string | number> ? Rest : []> : First extends `${number}` ? T extends any[] ? GetValue<T[number], Rest extends Array<string | number> ? Rest : []> : undefined : undefined : T;
+/**
+ * Get a nested value from an object using array path segments
+ * @template T - Object type
+ * @template K - Path segments array type
+ * @template D - Default value type
+ * @param obj - Source object
+ * @param path - Array of path segments
+ * @param defaultValue - Fallback value if path not found
+ * @returns Value at path or default value
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, ['a', 0, 'b']) // 1
+ */
+export declare function getObjectValue<T, K extends Array<string | number>, D>(obj: T, path: K, defaultValue: D): Exclude<GetValue<T, K>, undefined> | D;
+/**
+ * Get a nested value from an object using array path segments
+ * @template T - Object type
+ * @template K - Path segments array type
+ * @param obj - Source object
+ * @param path - Array of path segments
+ * @returns Value at path or undefined
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, ['a', 0, 'b']) // 1
+ */
+export declare function getObjectValue<T, K extends Array<string | number>>(obj: T, path: K): GetValue<T, K> | undefined;
+/**
+ * Get a nested value from an object using dot notation path
+ * @template T - Object type
+ * @template S - Path string literal type
+ * @template D - Default value type
+ * @param obj - Source object
+ * @param path - Dot-separated path string
+ * @param defaultValue - Fallback value if path not found
+ * @returns Value at path or default value
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, 'a.0.b', 2) // 1
+ */
+export declare function getObjectValue<T, S extends string, D>(obj: T, path: S, defaultValue: D): Exclude<GetValue<T, SplitPath<S>>, undefined> | D;
+/**
+ * Get a nested value from an object using dot notation path
+ * @template T - Object type
+ * @template S - Path string literal type
+ * @param obj - Source object
+ * @param path - Dot-separated path string
+ * @returns Value at path or undefined
+ *
+ * @example
+ * getObjectValue({a: [{b: 1}]}, 'a.0.b') // 1
+ */
+export declare function getObjectValue<T, S extends string>(obj: T, path: S): GetValue<T, SplitPath<S>> | undefined;
+export {};

package/dist/functions/object.js

@@ -0,0 +1,39 @@
+/**
+ * Implementation of deep object value retrieval with type safety
+ * @param obj - Source object
+ * @param path - Path specification (string or array)
+ * @param defaultValue - Optional fallback value
+ * @returns Value at path or default/undefined
+ */
+export function getObjectValue(obj, path, defaultValue) {
+    // Validate path type and handle edge cases
+    if (typeof path !== 'string' && !Array.isArray(path)) {
+        return defaultValue;
+    }
+    // Ensure pathArray is always an array
+    const pathArray = (() => {
+        if (Array.isArray(path))
+            return path;
+        if (path === '')
+            return [];
+        return String(path)
+            .split('.')
+            .filter((segment) => segment !== '');
+    })();
+    // Final safety check for array type
+    if (!Array.isArray(pathArray)) {
+        return defaultValue;
+    }
+    let current = obj;
+    for (const key of pathArray) {
+        if (current === null || current === undefined) {
+            return defaultValue;
+        }
+        // Convert numeric strings to numbers for arrays
+        const actualKey = typeof key === 'string' && Array.isArray(current) && /^\d+$/.test(key)
+            ? Number.parseInt(key, 10)
+            : key;
+        current = current[actualKey];
+    }
+    return current !== undefined ? current : defaultValue;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sohanemon/utils",
-  "version": "4.1.2",
+  "version": "4.1.3",
   "author": "Sohan Emon <sohanemon@outlook.com>",
   "description": "",
   "type": "module",