@salespark/toolkit 2.1.9 → 2.1.10

package/README.md

@@ -28,7 +28,7 @@ npm i @salespark/toolkit
 - **Object utilities**: pick, omit, clean objects, deep merge, etc.
 - **String utilities**: slugify, template fill, deburr, sanitize, capitalize words/sentences.
 - **Number utilities**: clamp, round, safe arithmetic/comparisons, safe parse (locale-aware), random digits, etc.
-- **Function utilities**: debounce, throttle, formatCurrency, parseName, currency conversions, etc.
+- **Function utilities**: debounce, throttle, safeJSONParse, formatCurrency, parseName, currency conversions, etc.
 - **Boolean utilities**: safe boolean conversion with common representations
 - **Validation utilities**: IBAN validator (ISO 13616), Portuguese tax ID validator
 - **Security utilities**: Markdown XSS protection, content sanitization, risk assessment
@@ -607,6 +607,19 @@ addThousandsSpace(1234567);
 // Result: "1 234 567"
 ```
 
+**`safeJSONParse<T>(input: unknown, defaultValue: T): T`** — Safely parses a JSON string or returns the object if already parsed. Falls back to default value on failure.
+
+```javascript
+safeJSONParse('{"key": "value"}', {});
+// Result: { key: "value" }
+
+safeJSONParse({ already: "object" }, {});
+// Result: { already: "object" }
+
+safeJSONParse("{invalid}", { fallback: true });
+// Result: { fallback: true }
+```
+
 **`formatCurrency(value: number | string | null | undefined, withoutCurrencySymbol?: boolean, currency?: string, locale?: string): string`** — Formats currency values with configurable currency and locale. Uses modern Intl.NumberFormat with automatic thousands separators, proper decimal handling, and graceful fallback for errors.
 
 ```javascript
@@ -895,5 +908,5 @@ MIT © [SalesPark](https://salespark.io)
 
 ---
 
-_Document version: 11_  
-_Last update: 19-12-2025_
+_Document version: 12_  
+_Last update: 21-12-2025_

package/dist/index.cjs

@@ -450,6 +450,20 @@ var formatDecimalNumber = (value, decimals = 2) => {
 };
 
 // src/utils/func.ts
+function safeJSONParse(input, defaultValue) {
+  if (typeof input === "object" && input !== null) {
+    return input;
+  }
+  if (typeof input === "string") {
+    try {
+      const parsed = JSON.parse(input);
+      return parsed;
+    } catch {
+      return defaultValue;
+    }
+  }
+  return defaultValue;
+}
 function debounce(fn, wait = 250) {
   let t;
   return function(...args) {
@@ -1803,6 +1817,7 @@ exports.removeDiacritics = removeDiacritics;
 exports.round = round;
 exports.safeAdd = safeAdd;
 exports.safeDivide = safeDivide;
+exports.safeJSONParse = safeJSONParse;
 exports.safeMultiply = safeMultiply;
 exports.safeParseFloat = safeParseFloat;
 exports.safeParseInt = safeParseInt;