@naturalcycles/js-lib 14.152.0 → 14.153.1

package/dist/error/jsonParseError.js

@@ -5,7 +5,7 @@ const string_util_1 = require("../string/string.util");
 const app_error_1 = require("./app.error");
 class JsonParseError extends app_error_1.AppError {
     constructor(data, cause) {
-        super(['Failed to parse', data?.text && (0, string_util_1._truncateMiddle)(data.text, 200)].filter(Boolean).join(': '), data, cause, 'JsonParseError');
+        super(['Failed to parse', data.text && (0, string_util_1._truncateMiddle)(data.text, 200)].filter(Boolean).join(': '), data, cause, 'JsonParseError');
     }
 }
 exports.JsonParseError = JsonParseError;

package/dist/string/json.util.d.ts

@@ -4,10 +4,15 @@ import { Reviver } from '../types';
  * Returns original object if JSON parse failed (silently).
  */
 export declare function _jsonParseIfPossible(obj: any, reviver?: Reviver): any;
+/**
+ * Convenience function that does JSON.parse, but doesn't throw on error,
+ * instead - safely returns `undefined`.
+ */
+export declare function _jsonParseOrUndefined<T = unknown>(obj: any, reviver?: Reviver): T | undefined;
 /**
  * Same as JSON.parse, but throws JsonParseError:
  *
  * 1. It's message includes a piece of source text (truncated)
  * 2. It's data.text contains full source text
  */
-export declare function _jsonParse(s: string, reviver?: Reviver): unknown;
+export declare function _jsonParse<T = unknown>(s: string, reviver?: Reviver): T;

package/dist/string/json.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._jsonParse = exports._jsonParseIfPossible = void 0;
+exports._jsonParse = exports._jsonParseOrUndefined = exports._jsonParseIfPossible = void 0;
 const jsonParseError_1 = require("../error/jsonParseError");
 // const possibleJsonStartTokens = ['{', '[', '"']
 const DETECT_JSON = /^\s*[{["\-\d]/;
@@ -19,6 +19,20 @@ function _jsonParseIfPossible(obj, reviver) {
     return obj;
 }
 exports._jsonParseIfPossible = _jsonParseIfPossible;
+/**
+ * Convenience function that does JSON.parse, but doesn't throw on error,
+ * instead - safely returns `undefined`.
+ */
+function _jsonParseOrUndefined(obj, reviver) {
+    // Optimization: only try to parse if it looks like JSON: starts with a json possible character
+    if (typeof obj === 'string' && obj && DETECT_JSON.test(obj)) {
+        try {
+            return JSON.parse(obj, reviver);
+        }
+        catch { }
+    }
+}
+exports._jsonParseOrUndefined = _jsonParseOrUndefined;
 /**
  * Same as JSON.parse, but throws JsonParseError:
  *

package/dist-esm/error/jsonParseError.js

@@ -2,6 +2,6 @@ import { _truncateMiddle } from '../string/string.util';
 import { AppError } from './app.error';
 export class JsonParseError extends AppError {
     constructor(data, cause) {
-        super(['Failed to parse', (data === null || data === void 0 ? void 0 : data.text) && _truncateMiddle(data.text, 200)].filter(Boolean).join(': '), data, cause, 'JsonParseError');
+        super(['Failed to parse', data.text && _truncateMiddle(data.text, 200)].filter(Boolean).join(': '), data, cause, 'JsonParseError');
     }
 }

package/dist-esm/string/json.util.js

@@ -15,6 +15,19 @@ export function _jsonParseIfPossible(obj, reviver) {
     }
     return obj;
 }
+/**
+ * Convenience function that does JSON.parse, but doesn't throw on error,
+ * instead - safely returns `undefined`.
+ */
+export function _jsonParseOrUndefined(obj, reviver) {
+    // Optimization: only try to parse if it looks like JSON: starts with a json possible character
+    if (typeof obj === 'string' && obj && DETECT_JSON.test(obj)) {
+        try {
+            return JSON.parse(obj, reviver);
+        }
+        catch (_a) { }
+    }
+}
 /**
  * Same as JSON.parse, but throws JsonParseError:
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.152.0",
+  "version": "14.153.1",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/error/jsonParseError.ts

@@ -12,7 +12,7 @@ export interface JsonParseErrorData extends ErrorData {
 export class JsonParseError extends AppError<JsonParseErrorData> {
   constructor(data: JsonParseErrorData, cause?: ErrorObject) {
     super(
-      ['Failed to parse', data?.text && _truncateMiddle(data.text, 200)].filter(Boolean).join(': '),
+      ['Failed to parse', data.text && _truncateMiddle(data.text, 200)].filter(Boolean).join(': '),
       data,
       cause,
       'JsonParseError',

package/src/string/json.util.ts

@@ -19,13 +19,26 @@ export function _jsonParseIfPossible(obj: any, reviver?: Reviver): any {
   return obj
 }
 
+/**
+ * Convenience function that does JSON.parse, but doesn't throw on error,
+ * instead - safely returns `undefined`.
+ */
+export function _jsonParseOrUndefined<T = unknown>(obj: any, reviver?: Reviver): T | undefined {
+  // Optimization: only try to parse if it looks like JSON: starts with a json possible character
+  if (typeof obj === 'string' && obj && DETECT_JSON.test(obj)) {
+    try {
+      return JSON.parse(obj, reviver)
+    } catch {}
+  }
+}
+
 /**
  * Same as JSON.parse, but throws JsonParseError:
  *
  * 1. It's message includes a piece of source text (truncated)
  * 2. It's data.text contains full source text
  */
-export function _jsonParse(s: string, reviver?: Reviver): unknown {
+export function _jsonParse<T = unknown>(s: string, reviver?: Reviver): T {
   try {
     return JSON.parse(s, reviver)
   } catch {