@sohanemon/utils 5.2.7 → 5.2.8

package/dist/functions/hydrate.d.ts

@@ -1,3 +1,4 @@
+import { DeepNullToUndefined } from '../types/utilities';
 /**
  * Deeply cleans any value by converting all `null` values to `undefined`,
  * and merges in a fallback object for default values.
@@ -38,7 +39,7 @@ export declare function hydrate<T>(data: T, fallback?: Partial<T>, options?: {
     maxDepth?: number;
     throwOnCircular?: boolean;
     convertNullToUndefined?: boolean;
-}): T;
+}): DeepNullToUndefined<T>;
 /**
  * Type guard utility for checking if a value is an object with a specific shape
  */

package/dist/functions/hydrate.js

@@ -45,14 +45,14 @@ export function hydrate(data, fallback, options) {
         // Check recursion depth
         if (depth > maxDepth) {
             console.warn(`[hydrate] Maximum recursion depth (${maxDepth}) exceeded. Returning value as-is.`);
-            return value ?? fallbackValue;
+            return (value ?? fallbackValue);
         }
         if (value === null) {
-            return convertNullToUndefined ? undefined : (fallbackValue ?? null);
+            return (convertNullToUndefined ? undefined : (fallbackValue ?? null));
         }
         // Handle undefined - use fallback or return undefined
         if (value === undefined) {
-            return fallbackValue ?? undefined;
+            return (fallbackValue ?? undefined);
         }
         // Handle primitives: string, number, boolean, symbol, bigint
         const type = typeof value;
@@ -97,7 +97,7 @@ export function hydrate(data, fallback, options) {
             return result;
         }
         // For other objects, return as-is (instances, etc.)
-        return value ?? fallbackValue;
+        return (value ?? fallbackValue);
     }
 }
 /**

package/dist/types/utilities.d.ts

@@ -7,6 +7,10 @@ export type SelectivePartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T
 export type DeepRequired<T> = T extends Function ? T : T extends Array<infer U> ? Array<DeepRequired<U>> : T extends object ? {
     [K in keyof T]-?: DeepRequired<T[K]>;
 } : T;
+export type NullToUndefined<T> = T extends null ? undefined : T;
+export type DeepNullToUndefined<T> = T extends Function ? T : T extends Array<infer U> ? Array<DeepNullToUndefined<U>> : T extends object ? {
+    [K in keyof T]: DeepNullToUndefined<NullToUndefined<T[K]>>;
+} : NullToUndefined<T>;
 export type Never<T> = {
     [K in keyof T]: never;
 };

package/package.json

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