@salespark/toolkit 2.1.2 → 2.1.4

package/dist/index.d.cts

@@ -306,39 +306,39 @@ declare function round(n: number, decimals?: number): number;
  * Safely converts a value to an integer. Returns defaultValue if parsing fails or results in NaN.
  *
  * Notes:
- * Examples: toInteger("42") -> 42, toInteger("abc", 10) -> 10, toInteger(undefined) -> 0, toInteger(3.9) -> 3
+ * Examples: safeParseInt("42") -> 42, safeParseInt("abc", 10) -> 10, safeParseInt(undefined) -> 0, safeParseInt(3.9) -> 3
  * @param {unknown} value - Value to convert
  * @param {Number} defaultValue - Default value if parsing fails
  * History:
  * 21-08-2025: Created
+ * 29-10-2025: Renamed from toInteger to safeParseInt
  ****************************************************/
-declare function toInteger(value: unknown, defaultValue?: number): number;
-/******************************************************
- * ##: Safe Parse Int (Alias)
- * Alias for safe integer conversion (for discoverability/backward naming)
- * @param {unknown} value - Value to convert
- * @param {Number} defaultValue - Default value if parsing fails
- * History:
- * 21-08-2025: Created
- ****************************************************/
-declare const safeParseInt: typeof toInteger;
+declare function safeParseInt(value: unknown, defaultValue?: number): number;
+/**
+ * @deprecated Use `safeParseFloat` instead.
+ */
+declare const toInteger: typeof safeParseInt;
 /******************************************************
  * ##: Safe Number Conversion
  * Safely parses a value into a number with optional decimal precision
  *
  * Notes:
  * Handles commas as decimal/thousands separators. Returns 0 for null/undefined/empty string or invalid parsing.
- * Examples: toNumber("123.45") -> 123.45, toNumber("123,45") -> 123.45, toNumber("1,234.56") -> 1234.56, toNumber("abc", 2) -> 0, toNumber(42) -> 42
- * @param {unknown} value - Value to convert
+ * Examples: safeParseFloat("123.45") -> 123.45, safeParseFloat("123,45") -> 123.45, safeParseFloat("1,234.56") -> 1234.56, safeParseFloat("abc", 2) -> 0, safeParseFloat(42) -> 42 * @param {unknown} value - Value to convert
  * @param {Number} decimals - Number of decimal places
  * History:
  * 21-08-2025: Created
+ * * 29-10-2025: Renamed from toNumber to safeParseFloat
  ****************************************************/
-declare function toNumber(value: unknown, decimals?: number): number;
+declare function safeParseFloat(value: unknown, decimals?: number): number;
+/**
+ * @deprecated Use `safeParseFloat` instead.
+ */
+declare const toNumber: typeof safeParseFloat;
 /**
- * @deprecated Use `toNumber` instead.
+ * @deprecated Use `safeParseFloat` instead.
  */
-declare const parseToNumber: typeof toNumber;
+declare const parseToNumber: typeof safeParseFloat;
 /******************************************************
  * ##: Random Digits Generator
  * Generates a random string of digits with secure randomness when available
@@ -412,6 +412,7 @@ declare const isNilText: (value: unknown) => boolean;
  * @param {unknown} value - Value to check
  * History:
  * 21-08-2025: Created
+ * 18-10-2025: Trim before checking empty
  ****************************************************/
 declare const isNilOrEmpty: (value: unknown) => boolean;
 /******************************************************
@@ -428,7 +429,14 @@ declare const hasNilOrEmpty: (array: unknown) => boolean;
  * @param {unknown} value - Value to check
  * History:
  * 21-08-2025: Created
+ * 08-11-2025: Fixed type-safety and logic - added proper 'length' property check using 'in' operator,
+ *             changed catch block to return false (don't assume error means empty), added explicit
+ *             false return for values without length property
  ****************************************************/
+declare const isNilEmptyOrZeroLength: (value: unknown) => boolean;
+/**
+ * @deprecated Use `isNilEmptyOrZeroLength` instead.
+ */
 declare const isNilEmptyOrZeroLen: (value: unknown) => boolean;
 /******************************************************
  * ##: Nil or Zero Length Check
@@ -436,7 +444,14 @@ declare const isNilEmptyOrZeroLen: (value: unknown) => boolean;
  * @param {unknown} value - Value to check
  * History:
  * 21-08-2025: Created
+ * 08-11-2025: Fixed type-safety and logic - added proper 'length' property check using 'in' operator,
+ *             changed catch block to return false (don't assume error means empty), added explicit
+ *             false return for values without length property
  ****************************************************/
+declare const isNilOrZeroLength: (value: unknown) => boolean;
+/**
+ * @deprecated Use `isNilOrZeroLength` instead.
+ */
 declare const isNilOrZeroLen: (value: unknown) => boolean;
 /******************************************************
  * ##: Nil or NaN Check
@@ -694,4 +709,4 @@ declare const assessSecurityRisks: (risks: SecurityRisk[]) => {
 declare const isBrowser: boolean;
 declare const isNode: boolean;
 
-export { type SecurityCheckResult, type SecurityRisk, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
+export { type SecurityCheckResult, type SecurityRisk, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilEmptyOrZeroLength, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilOrZeroLength, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseFloat, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };

package/dist/index.d.ts

@@ -306,39 +306,39 @@ declare function round(n: number, decimals?: number): number;
  * Safely converts a value to an integer. Returns defaultValue if parsing fails or results in NaN.
  *
  * Notes:
- * Examples: toInteger("42") -> 42, toInteger("abc", 10) -> 10, toInteger(undefined) -> 0, toInteger(3.9) -> 3
+ * Examples: safeParseInt("42") -> 42, safeParseInt("abc", 10) -> 10, safeParseInt(undefined) -> 0, safeParseInt(3.9) -> 3
  * @param {unknown} value - Value to convert
  * @param {Number} defaultValue - Default value if parsing fails
  * History:
  * 21-08-2025: Created
+ * 29-10-2025: Renamed from toInteger to safeParseInt
  ****************************************************/
-declare function toInteger(value: unknown, defaultValue?: number): number;
-/******************************************************
- * ##: Safe Parse Int (Alias)
- * Alias for safe integer conversion (for discoverability/backward naming)
- * @param {unknown} value - Value to convert
- * @param {Number} defaultValue - Default value if parsing fails
- * History:
- * 21-08-2025: Created
- ****************************************************/
-declare const safeParseInt: typeof toInteger;
+declare function safeParseInt(value: unknown, defaultValue?: number): number;
+/**
+ * @deprecated Use `safeParseFloat` instead.
+ */
+declare const toInteger: typeof safeParseInt;
 /******************************************************
  * ##: Safe Number Conversion
  * Safely parses a value into a number with optional decimal precision
  *
  * Notes:
  * Handles commas as decimal/thousands separators. Returns 0 for null/undefined/empty string or invalid parsing.
- * Examples: toNumber("123.45") -> 123.45, toNumber("123,45") -> 123.45, toNumber("1,234.56") -> 1234.56, toNumber("abc", 2) -> 0, toNumber(42) -> 42
- * @param {unknown} value - Value to convert
+ * Examples: safeParseFloat("123.45") -> 123.45, safeParseFloat("123,45") -> 123.45, safeParseFloat("1,234.56") -> 1234.56, safeParseFloat("abc", 2) -> 0, safeParseFloat(42) -> 42 * @param {unknown} value - Value to convert
  * @param {Number} decimals - Number of decimal places
  * History:
  * 21-08-2025: Created
+ * * 29-10-2025: Renamed from toNumber to safeParseFloat
  ****************************************************/
-declare function toNumber(value: unknown, decimals?: number): number;
+declare function safeParseFloat(value: unknown, decimals?: number): number;
+/**
+ * @deprecated Use `safeParseFloat` instead.
+ */
+declare const toNumber: typeof safeParseFloat;
 /**
- * @deprecated Use `toNumber` instead.
+ * @deprecated Use `safeParseFloat` instead.
  */
-declare const parseToNumber: typeof toNumber;
+declare const parseToNumber: typeof safeParseFloat;
 /******************************************************
  * ##: Random Digits Generator
  * Generates a random string of digits with secure randomness when available
@@ -412,6 +412,7 @@ declare const isNilText: (value: unknown) => boolean;
  * @param {unknown} value - Value to check
  * History:
  * 21-08-2025: Created
+ * 18-10-2025: Trim before checking empty
  ****************************************************/
 declare const isNilOrEmpty: (value: unknown) => boolean;
 /******************************************************
@@ -428,7 +429,14 @@ declare const hasNilOrEmpty: (array: unknown) => boolean;
  * @param {unknown} value - Value to check
  * History:
  * 21-08-2025: Created
+ * 08-11-2025: Fixed type-safety and logic - added proper 'length' property check using 'in' operator,
+ *             changed catch block to return false (don't assume error means empty), added explicit
+ *             false return for values without length property
  ****************************************************/
+declare const isNilEmptyOrZeroLength: (value: unknown) => boolean;
+/**
+ * @deprecated Use `isNilEmptyOrZeroLength` instead.
+ */
 declare const isNilEmptyOrZeroLen: (value: unknown) => boolean;
 /******************************************************
  * ##: Nil or Zero Length Check
@@ -436,7 +444,14 @@ declare const isNilEmptyOrZeroLen: (value: unknown) => boolean;
  * @param {unknown} value - Value to check
  * History:
  * 21-08-2025: Created
+ * 08-11-2025: Fixed type-safety and logic - added proper 'length' property check using 'in' operator,
+ *             changed catch block to return false (don't assume error means empty), added explicit
+ *             false return for values without length property
  ****************************************************/
+declare const isNilOrZeroLength: (value: unknown) => boolean;
+/**
+ * @deprecated Use `isNilOrZeroLength` instead.
+ */
 declare const isNilOrZeroLen: (value: unknown) => boolean;
 /******************************************************
  * ##: Nil or NaN Check
@@ -694,4 +709,4 @@ declare const assessSecurityRisks: (risks: SecurityRisk[]) => {
 declare const isBrowser: boolean;
 declare const isNode: boolean;
 
-export { type SecurityCheckResult, type SecurityRisk, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
+export { type SecurityCheckResult, type SecurityRisk, addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilEmptyOrZeroLength, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilOrZeroLength, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseFloat, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };

package/dist/index.js

@@ -251,7 +251,7 @@ function round(n, decimals = 0) {
   const f = Math.pow(10, decimals);
   return Math.round((n + Number.EPSILON) * f) / f;
 }
-function toInteger(value, defaultValue = 0) {
+function safeParseInt(value, defaultValue = 0) {
   try {
     const safeValue = parseInt(String(value), 10);
     return isNaN(safeValue) ? defaultValue : safeValue;
@@ -259,8 +259,8 @@ function toInteger(value, defaultValue = 0) {
     return defaultValue;
   }
 }
-var safeParseInt = toInteger;
-function toNumber(value, decimals = 6) {
+var toInteger = safeParseInt;
+function safeParseFloat(value, decimals = 6) {
   try {
     if (value === void 0 || value === null || value === "") return 0;
     let str = String(value);
@@ -276,7 +276,8 @@ function toNumber(value, decimals = 6) {
     return 0;
   }
 }
-var parseToNumber = toNumber;
+var toNumber = safeParseFloat;
+var parseToNumber = safeParseFloat;
 function secureRandomIndex(max) {
   if (max <= 0) return 0;
   const g = globalThis;
@@ -370,7 +371,7 @@ var isNilText = (value) => {
 };
 var isNilOrEmpty = (value) => {
   try {
-    return isNil(value) || value === "";
+    return isNil(value) || typeof value === "string" && value?.trim() === "";
   } catch {
     return true;
   }
@@ -386,24 +387,32 @@ var hasNilOrEmpty = (array) => {
     return true;
   }
 };
-var isNilEmptyOrZeroLen = (value) => {
+var isNilEmptyOrZeroLength = (value) => {
   try {
     if (isNil(value) || value === "") return true;
-    const maybeLen = value?.length;
-    return typeof maybeLen === "number" && maybeLen === 0;
+    if (typeof value === "object" && value !== null && "length" in value) {
+      const length = value.length;
+      return typeof length === "number" && length === 0;
+    }
+    return false;
   } catch {
     return true;
   }
 };
-var isNilOrZeroLen = (value) => {
+var isNilEmptyOrZeroLen = isNilEmptyOrZeroLength;
+var isNilOrZeroLength = (value) => {
   try {
     if (isNil(value)) return true;
-    const maybeLen = value?.length;
-    return typeof maybeLen === "number" && maybeLen === 0;
+    if (typeof value === "object" && value !== null && "length" in value) {
+      const length = value.length;
+      return typeof length === "number" && length === 0;
+    }
+    return false;
   } catch {
     return true;
   }
 };
+var isNilOrZeroLen = isNilOrZeroLength;
 var isNilOrNaN = (value) => {
   try {
     return isNil(value) || isNaN(value);
@@ -1614,6 +1623,6 @@ var assessSecurityRisks = (risks) => {
 var isBrowser = typeof globalThis !== "undefined" && typeof globalThis.document !== "undefined";
 var isNode = typeof process !== "undefined" && !!process.versions?.node;
 
-export { addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
+export { addSpaceBetweenNumbers, addThousandsSpace, areArraysDeepEqualUnordered, areArraysEqual, assessSecurityRisks, basicSanitize, checkMarkdownSecurity, chunk, clamp, cleanObject, compact, currencyToSymbol, debounce, deburr, delay, difference, fill, flatten, flattenDepth, flattenDepthBase, flattenOnce, formatBytes, formatCurrency, formatDecimalNumber, getStringSimilarity, groupBy, hasNilOrEmpty, humanFileSize, intersection, isBrowser, isFlattenable, isNil, isNilEmptyOrZeroLen, isNilEmptyOrZeroLength, isNilOrEmpty, isNilOrNaN, isNilOrZeroLen, isNilOrZeroLength, isNilText, isNilTextOrEmpty, isNode, isNullOrUndefined, isNullOrUndefinedEmptyOrZero, isNullOrUndefinedInArray, isNullOrUndefinedOrNaN, isNullOrUndefinedTextInc, isNullUndefinedOrEmpty, isNullUndefinedOrEmptyEnforced, isNullUndefinedOrZero, isPTTaxId, isValidIBAN, isValidPTTaxId, objectToString, omit, otp, parseName, parseToBool, parseToNumber, pick, pluck, pushAll, randomDigits, removeDiacritics, round, safeParseFloat, safeParseInt, sanitize, sanitizeMarkdown, shuffle, slugify, sortBy, stringSimilarity, symbolToCurrency, throttle, toBool, toInteger, toNumber, uniq, uniqBy };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map