nhb-toolbox 4.1.3 → 4.1.4

package/dist/cjs/object/objectify.js

@@ -216,12 +216,20 @@ const extractUpdatedAndNewFields = (baseObject, updatedObject) => {
 exports.extractUpdatedAndNewFields = extractUpdatedAndNewFields;
 /**
  * * Safely parses a JSON string into an object.
- *
- * *Optionally converts stringified primitive values inside the object (e.g., `"0"` → `0`, `"true"` → `true`, `"null"` → `null`).*
+ * * Optionally converts stringified primitive values inside the object (e.g., `"0"` → `0`, `"true"` → `true`, `"null"` → `null`).
  *
  * @param value - The JSON string to parse.
  * @param parsePrimitives - Whether to convert stringified primitives into real values (default: `true`).
  * @returns A parsed object with primitive conversions, or an empty object on failure or if the root is not a valid object.
+ * - Returns `{}` if parsing fails, such as when the input is malformed or invalid JSON or passing single quoted string.
+ *
+ * - **N.B.** This function will return an empty object if the JSON string is invalid or if the root element is not an object.
+ *
+ * - *Unlike `parseJSON`, which returns any valid JSON structure (including arrays, strings, numbers, etc.),
+ * this function strictly ensures that the result is an object and optionally transforms stringified primitives.*
+ *
+ * @see parseJSON - For parsing generic JSON values (arrays, numbers, etc.) with optional primitive transformation.
+ *
  */
 const parseJsonToObject = (value, parsePrimitives = true) => {
     try {

package/dist/cjs/utils/index.js

@@ -176,16 +176,25 @@ function getClassDetails(cls) {
     };
 }
 /**
- * * Parses a JSON string and optionally converts stringified primitives inside objects or arrays.
+ * * Parses any valid JSON string, optionally converting stringified primitives inside (nested) arrays or objects.
  *
+ * @template T - Expected return type (default is unknown).
  * @param value - The JSON string to parse.
  * @param parsePrimitives - Whether to convert stringified primitives (default: `true`).
- * @returns The parsed JSON value with optional primitive parsing.
+ * @returns The parsed JSON value typed as `T`, or the original parsed value with optional primitive conversion.
+ * - Returns `{}` if parsing fails, such as when the input is malformed or invalid JSON or passing single quoted string.
+ *
+ * - *Unlike `parseJsonToObject`, which ensures the root value is an object,
+ * this function returns any valid JSON structure such as arrays, strings, numbers, or objects.*
+ *
+ * This is useful when you're not sure of the root structure of the JSON, or when you expect something other than an object.
+ *
+ * @see `parseJsonToObject` for strict object-only parsing.
  */
 const parseJSON = (value, parsePrimitives = true) => {
     try {
         const parsed = JSON.parse(value);
-        return parsePrimitives ? deepParsePrimitives(parsed) : parsed;
+        return (parsePrimitives ? deepParsePrimitives(parsed) : parsed);
     }
     catch {
         return {};
@@ -193,10 +202,11 @@ const parseJSON = (value, parsePrimitives = true) => {
 };
 exports.parseJSON = parseJSON;
 /**
- * Recursively parses primitive values inside objects and arrays.
+ * * Recursively parses primitive values inside objects and arrays.
  *
+ * @template T - Expected return type after parsing (default is unknown).
  * @param input - Any input value to parse recursively.
- * @returns Input with primitives (strings like "true", "123") converted.
+ * @returns Input with primitives (strings like "true", "123") converted, typed as `T`.
  */
 function deepParsePrimitives(input) {
     if (Array.isArray(input)) {
@@ -211,7 +221,7 @@ function deepParsePrimitives(input) {
     }
     if ((0, primitives_1.isString)(input)) {
         if (/^(true|false)$/i.test(input)) {
-            return input.toLowerCase() === 'true';
+            return (input.toLowerCase() === 'true');
         }
         if ((0, specials_1.isNumericString)(input)) {
             return Number(input);
@@ -222,6 +232,7 @@ function deepParsePrimitives(input) {
         if (input === 'undefined') {
             return undefined;
         }
+        return input;
     }
     return input;
 }

package/dist/dts/object/objectify.d.ts

@@ -56,12 +56,20 @@ export declare const extractNewFields: <T extends GenericObject, U extends Gener
 export declare const extractUpdatedAndNewFields: <T extends GenericObject, U extends GenericObject>(baseObject: T, updatedObject: FlattenPartial<T> & FlattenPartial<U>) => FlattenPartial<T> & FlattenPartial<U>;
 /**
  * * Safely parses a JSON string into an object.
- *
- * *Optionally converts stringified primitive values inside the object (e.g., `"0"` → `0`, `"true"` → `true`, `"null"` → `null`).*
+ * * Optionally converts stringified primitive values inside the object (e.g., `"0"` → `0`, `"true"` → `true`, `"null"` → `null`).
  *
  * @param value - The JSON string to parse.
  * @param parsePrimitives - Whether to convert stringified primitives into real values (default: `true`).
  * @returns A parsed object with primitive conversions, or an empty object on failure or if the root is not a valid object.
+ * - Returns `{}` if parsing fails, such as when the input is malformed or invalid JSON or passing single quoted string.
+ *
+ * - **N.B.** This function will return an empty object if the JSON string is invalid or if the root element is not an object.
+ *
+ * - *Unlike `parseJSON`, which returns any valid JSON structure (including arrays, strings, numbers, etc.),
+ * this function strictly ensures that the result is an object and optionally transforms stringified primitives.*
+ *
+ * @see parseJSON - For parsing generic JSON values (arrays, numbers, etc.) with optional primitive transformation.
+ *
  */
-export declare const parseJsonToObject: (value: string, parsePrimitives?: boolean) => import("./types").StrictObject;
+export declare const parseJsonToObject: <T = GenericObject>(value: string, parsePrimitives?: boolean) => T;
 //# sourceMappingURL=objectify.d.ts.map

package/dist/dts/object/objectify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objectify.d.ts","sourceRoot":"","sources":["../../../src/object/objectify.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAO,cAAc,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,aAAa,cAAc,CAAC,EAAE,KAAG,CAuCvE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,aAAa,cACjD,CAAC,EAAE,KACb,aAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,aAAa,UACpD,CAAC,KACP,CAmBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,UACvD,CAAC,KACP,aAkCF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,cAC/C,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,KAC9B,cAAc,CAAC,CAAC,CAwBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAyBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACtC,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAwBtC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,UAAW,MAAM,8DAY9C,CAAC"}
+{"version":3,"file":"objectify.d.ts","sourceRoot":"","sources":["../../../src/object/objectify.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAO,cAAc,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,aAAa,cAAc,CAAC,EAAE,KAAG,CAuCvE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,aAAa,cACjD,CAAC,EAAE,KACb,aAyBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,aAAa,UACpD,CAAC,KACP,CAmBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,aAAa,UACvD,CAAC,KACP,aAkCF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,aAAa,cAC/C,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,KAC9B,cAAc,CAAC,CAAC,CAwBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAyBlB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACtC,CAAC,SAAS,aAAa,EACvB,CAAC,SAAS,aAAa,cAEX,CAAC,iBACE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,KAClD,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAwBtC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,yBAC3B,MAAM,gCAEX,CAYF,CAAC"}

package/dist/dts/object/sanitize.d.ts

@@ -1,5 +1,5 @@
 import type { FlattenPartial } from '../types';
-import type { GenericObject, SanitizeOptions, StrictObject } from './types';
+import type { GenericObject, SanitizeOptions } from './types';
 /**
  * * Trims all the words in a string.
  *
@@ -41,5 +41,5 @@ export declare function sanitizeData<T>(array: T[], options?: SanitizeOptions<T>
  * @param object - The object with potentially stringified primitive values.
  * @returns A new object with parsed values converted to their original types.
  */
-export declare function parseObjectValues(object: GenericObject): StrictObject;
+export declare function parseObjectValues<T = GenericObject>(object: GenericObject): T;
 //# sourceMappingURL=sanitize.d.ts.map

package/dist/dts/object/sanitize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../src/object/sanitize.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAEX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EACnD,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,CAAC,CAAC;AAErB;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;AA8KvB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAgCrE"}
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../src/object/sanitize.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAkB,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EACnD,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,CAAC,CAAC;AAErB;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;AA8KvB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,CAAC,CAgC7E"}

package/dist/dts/utils/index.d.ts

@@ -81,18 +81,28 @@ export declare function countStaticMethods(cls: Constructor): number;
  */
 export declare function getClassDetails(cls: Constructor): ClassDetails;
 /**
- * * Parses a JSON string and optionally converts stringified primitives inside objects or arrays.
+ * * Parses any valid JSON string, optionally converting stringified primitives inside (nested) arrays or objects.
  *
+ * @template T - Expected return type (default is unknown).
  * @param value - The JSON string to parse.
  * @param parsePrimitives - Whether to convert stringified primitives (default: `true`).
- * @returns The parsed JSON value with optional primitive parsing.
+ * @returns The parsed JSON value typed as `T`, or the original parsed value with optional primitive conversion.
+ * - Returns `{}` if parsing fails, such as when the input is malformed or invalid JSON or passing single quoted string.
+ *
+ * - *Unlike `parseJsonToObject`, which ensures the root value is an object,
+ * this function returns any valid JSON structure such as arrays, strings, numbers, or objects.*
+ *
+ * This is useful when you're not sure of the root structure of the JSON, or when you expect something other than an object.
+ *
+ * @see `parseJsonToObject` for strict object-only parsing.
  */
-export declare const parseJSON: (value: string, parsePrimitives?: boolean) => unknown;
+export declare const parseJSON: <T = unknown>(value: string, parsePrimitives?: boolean) => T;
 /**
- * Recursively parses primitive values inside objects and arrays.
+ * * Recursively parses primitive values inside objects and arrays.
  *
+ * @template T - Expected return type after parsing (default is unknown).
  * @param input - Any input value to parse recursively.
- * @returns Input with primitives (strings like "true", "123") converted.
+ * @returns Input with primitives (strings like "true", "123") converted, typed as `T`.
  */
-export declare function deepParsePrimitives(input: unknown): unknown;
+export declare function deepParsePrimitives<T = unknown>(input: unknown): T;
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,YAAY,EACZ,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,MAAM,UAAU,CAAC;AAElB;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OA6B3C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAC9B,CAAC,EAAE,cACC,MAAM,KACf,MAKF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,YAAY,YAC1C,CAAC,qBAET,SAAS,CAAC,CAAC,CAYb,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,YAAY,YAC1C,CAAC,qBAET,WAAW,CAAC,CAAC,CAWf,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAcjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAQ/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAW9D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,UAAW,MAAM,gCAA2B,OAQjE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkC3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACX,YAAY,EACZ,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,MAAM,UAAU,CAAC;AAElB;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,OA6B3C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAC9B,CAAC,EAAE,cACC,MAAM,KACf,MAKF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,YAAY,YAC1C,CAAC,qBAET,SAAS,CAAC,CAAC,CAYb,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,YAAY,YAC1C,CAAC,qBAET,WAAW,CAAC,CAAC,CAWf,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAcjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAQ/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAW9D;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,mBACnB,MAAM,gCAEX,CAOF,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAoClE"}

package/dist/esm/object/objectify.js

@@ -206,12 +206,20 @@ export const extractUpdatedAndNewFields = (baseObject, updatedObject) => {
 };
 /**
  * * Safely parses a JSON string into an object.
- *
- * *Optionally converts stringified primitive values inside the object (e.g., `"0"` → `0`, `"true"` → `true`, `"null"` → `null`).*
+ * * Optionally converts stringified primitive values inside the object (e.g., `"0"` → `0`, `"true"` → `true`, `"null"` → `null`).
  *
  * @param value - The JSON string to parse.
  * @param parsePrimitives - Whether to convert stringified primitives into real values (default: `true`).
  * @returns A parsed object with primitive conversions, or an empty object on failure or if the root is not a valid object.
+ * - Returns `{}` if parsing fails, such as when the input is malformed or invalid JSON or passing single quoted string.
+ *
+ * - **N.B.** This function will return an empty object if the JSON string is invalid or if the root element is not an object.
+ *
+ * - *Unlike `parseJSON`, which returns any valid JSON structure (including arrays, strings, numbers, etc.),
+ * this function strictly ensures that the result is an object and optionally transforms stringified primitives.*
+ *
+ * @see parseJSON - For parsing generic JSON values (arrays, numbers, etc.) with optional primitive transformation.
+ *
  */
 export const parseJsonToObject = (value, parsePrimitives = true) => {
     try {

package/dist/esm/utils/index.js

@@ -163,26 +163,36 @@ export function getClassDetails(cls) {
     };
 }
 /**
- * * Parses a JSON string and optionally converts stringified primitives inside objects or arrays.
+ * * Parses any valid JSON string, optionally converting stringified primitives inside (nested) arrays or objects.
  *
+ * @template T - Expected return type (default is unknown).
  * @param value - The JSON string to parse.
  * @param parsePrimitives - Whether to convert stringified primitives (default: `true`).
- * @returns The parsed JSON value with optional primitive parsing.
+ * @returns The parsed JSON value typed as `T`, or the original parsed value with optional primitive conversion.
+ * - Returns `{}` if parsing fails, such as when the input is malformed or invalid JSON or passing single quoted string.
+ *
+ * - *Unlike `parseJsonToObject`, which ensures the root value is an object,
+ * this function returns any valid JSON structure such as arrays, strings, numbers, or objects.*
+ *
+ * This is useful when you're not sure of the root structure of the JSON, or when you expect something other than an object.
+ *
+ * @see `parseJsonToObject` for strict object-only parsing.
  */
 export const parseJSON = (value, parsePrimitives = true) => {
     try {
         const parsed = JSON.parse(value);
-        return parsePrimitives ? deepParsePrimitives(parsed) : parsed;
+        return (parsePrimitives ? deepParsePrimitives(parsed) : parsed);
     }
     catch {
         return {};
     }
 };
 /**
- * Recursively parses primitive values inside objects and arrays.
+ * * Recursively parses primitive values inside objects and arrays.
  *
+ * @template T - Expected return type after parsing (default is unknown).
  * @param input - Any input value to parse recursively.
- * @returns Input with primitives (strings like "true", "123") converted.
+ * @returns Input with primitives (strings like "true", "123") converted, typed as `T`.
  */
 export function deepParsePrimitives(input) {
     if (Array.isArray(input)) {
@@ -197,7 +207,7 @@ export function deepParsePrimitives(input) {
     }
     if (isString(input)) {
         if (/^(true|false)$/i.test(input)) {
-            return input.toLowerCase() === 'true';
+            return (input.toLowerCase() === 'true');
         }
         if (isNumericString(input)) {
             return Number(input);
@@ -208,6 +218,7 @@ export function deepParsePrimitives(input) {
         if (input === 'undefined') {
             return undefined;
         }
+        return input;
     }
     return input;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.1.3",
+  "version": "4.1.4",
   "description": "A versatile collection of smart, efficient, and reusable utility functions and classes for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",