@naturalcycles/js-lib 14.60.0 → 14.63.0

package/dist/array/array.util.d.ts

@@ -93,7 +93,7 @@ export declare function _groupBy<T>(items: readonly T[], mapper: Mapper<T, any>)
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-export declare function _sortBy<T>(items: T[], mapper: Mapper<T, any>, mutate?: boolean): T[];
+export declare function _sortBy<T>(items: T[], mapper: Mapper<T, any>, mutate?: boolean, descending?: boolean): T[];
 /**
  * Like items.find(), but it tries to find from the END of the array.
  */

package/dist/array/array.util.js

@@ -140,12 +140,13 @@ exports._groupBy = _groupBy;
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-function _sortBy(items, mapper, mutate = false) {
+function _sortBy(items, mapper, mutate = false, descending = false) {
+    const mod = descending ? -1 : 1;
     return (mutate ? items : [...items]).sort((_a, _b) => {
         const [a, b] = [_a, _b].map(mapper); // eslint-disable-line unicorn/no-array-callback-reference
         if (typeof a === 'number' && typeof b === 'number')
-            return a - b;
-        return String(a).localeCompare(String(b));
+            return (a - b) * mod;
+        return String(a).localeCompare(String(b)) * mod;
     });
 }
 exports._sortBy = _sortBy;

package/dist/error/error.model.d.ts

@@ -15,6 +15,11 @@ export interface ErrorData {
      * Error id in some error tracking system (e.g Sentry).
      */
     errorId?: string;
+    /**
+     * Set to true to force reporting this error (e.g to Sentry).
+     * Useful to be able to force-report e.g a 4xx error, which by default wouldn't be reported.
+     */
+    report?: boolean;
     /**
      * Sometimes error.message gets "decorated" with extra information
      * (e.g frontend-lib adds a method, url, etc for all the errors)
@@ -31,6 +36,10 @@ export interface HttpErrorData extends ErrorData {
      * @default 500
      */
     httpStatusCode: number;
+    /**
+     * Set to true when the error was thrown after response headers were sent.
+     */
+    headersSent?: boolean;
 }
 export interface Admin401ErrorData extends HttpErrorData {
     adminAuthRequired: true;

package/dist/number/number.util.d.ts

@@ -23,7 +23,7 @@ export declare function _clamp(x: number, minIncl: number, maxIncl: number): num
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export declare function _sortNumbers(numbers: number[], mutate?: boolean): number[];
+export declare function _sortNumbers(numbers: number[], mutate?: boolean, descending?: boolean): number[];
 /**
  * Same as .toFixed(), but conveniently casts the output to Number.
  *

package/dist/number/number.util.js

@@ -39,8 +39,9 @@ exports._clamp = _clamp;
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-function _sortNumbers(numbers, mutate = false) {
-    return (mutate ? numbers : [...numbers]).sort((a, b) => a - b);
+function _sortNumbers(numbers, mutate = false, descending = false) {
+    const mod = descending ? -1 : 1;
+    return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod);
 }
 exports._sortNumbers = _sortNumbers;
 /**

package/dist/string/safeJsonStringify.js

@@ -7,7 +7,14 @@ exports._safeJsonStringify = void 0;
  * Based on: https://github.com/moll/json-stringify-safe/
  */
 function _safeJsonStringify(obj, replacer, spaces, cycleReplacer) {
-    return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces);
+    try {
+        // Try native first (as it's ~3 times faster)
+        return JSON.stringify(obj, replacer, spaces);
+    }
+    catch {
+        // Native failed - resort to the "safe" serializer
+        return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces);
+    }
 }
 exports._safeJsonStringify = _safeJsonStringify;
 /* eslint-disable @typescript-eslint/no-unused-expressions, no-bitwise */

package/dist/string/stringifyAny.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._stringifyAny = void 0;
 const error_util_1 = require("../error/error.util");
 const json_util_1 = require("./json.util");
-const jsonStringifyFn = (obj, reviver, space) => JSON.stringify(obj, reviver, space);
+const safeJsonStringify_1 = require("./safeJsonStringify");
 /**
  * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
  * Potentially can do this (with extra 2Kb gz size): https://github.com/deecewan/browser-util-inspect
@@ -83,7 +83,7 @@ function _stringifyAny(obj, opt = {}) {
         // Other
         //
         try {
-            const { stringifyFn = jsonStringifyFn } = opt;
+            const { stringifyFn = safeJsonStringify_1._safeJsonStringify } = opt;
             s = stringifyFn(obj, undefined, 2);
         }
         catch {

package/dist-esm/array/array.util.js

@@ -130,12 +130,13 @@ export function _groupBy(items, mapper) {
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-export function _sortBy(items, mapper, mutate = false) {
+export function _sortBy(items, mapper, mutate = false, descending = false) {
+    const mod = descending ? -1 : 1;
     return (mutate ? items : [...items]).sort((_a, _b) => {
         const [a, b] = [_a, _b].map(mapper); // eslint-disable-line unicorn/no-array-callback-reference
         if (typeof a === 'number' && typeof b === 'number')
-            return a - b;
-        return String(a).localeCompare(String(b));
+            return (a - b) * mod;
+        return String(a).localeCompare(String(b)) * mod;
     });
 }
 /**

package/dist-esm/number/number.util.js

@@ -32,8 +32,9 @@ export function _clamp(x, minIncl, maxIncl) {
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export function _sortNumbers(numbers, mutate = false) {
-    return (mutate ? numbers : [...numbers]).sort((a, b) => a - b);
+export function _sortNumbers(numbers, mutate = false, descending = false) {
+    const mod = descending ? -1 : 1;
+    return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod);
 }
 /**
  * Same as .toFixed(), but conveniently casts the output to Number.

package/dist-esm/string/safeJsonStringify.js

@@ -4,7 +4,14 @@
  * Based on: https://github.com/moll/json-stringify-safe/
  */
 export function _safeJsonStringify(obj, replacer, spaces, cycleReplacer) {
-    return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces);
+    try {
+        // Try native first (as it's ~3 times faster)
+        return JSON.stringify(obj, replacer, spaces);
+    }
+    catch (_a) {
+        // Native failed - resort to the "safe" serializer
+        return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces);
+    }
 }
 /* eslint-disable @typescript-eslint/no-unused-expressions, no-bitwise */
 function serializer(replacer, cycleReplacer) {

package/dist-esm/string/stringifyAny.js

@@ -1,6 +1,6 @@
 import { _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse } from '../error/error.util';
 import { _jsonParseIfPossible } from './json.util';
-const jsonStringifyFn = (obj, reviver, space) => JSON.stringify(obj, reviver, space);
+import { _safeJsonStringify } from './safeJsonStringify';
 /**
  * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
  * Potentially can do this (with extra 2Kb gz size): https://github.com/deecewan/browser-util-inspect
@@ -80,7 +80,7 @@ export function _stringifyAny(obj, opt = {}) {
         // Other
         //
         try {
-            const { stringifyFn = jsonStringifyFn } = opt;
+            const { stringifyFn = _safeJsonStringify } = opt;
             s = stringifyFn(obj, undefined, 2);
         }
         catch (_a) {

package/package.json

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

package/src/array/array.util.ts

@@ -140,11 +140,17 @@ export function _groupBy<T>(items: readonly T[], mapper: Mapper<T, any>): String
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-export function _sortBy<T>(items: T[], mapper: Mapper<T, any>, mutate = false): T[] {
+export function _sortBy<T>(
+  items: T[],
+  mapper: Mapper<T, any>,
+  mutate = false,
+  descending = false,
+): T[] {
+  const mod = descending ? -1 : 1
   return (mutate ? items : [...items]).sort((_a, _b) => {
     const [a, b] = [_a, _b].map(mapper) // eslint-disable-line unicorn/no-array-callback-reference
-    if (typeof a === 'number' && typeof b === 'number') return a - b
-    return String(a).localeCompare(String(b))
+    if (typeof a === 'number' && typeof b === 'number') return (a - b) * mod
+    return String(a).localeCompare(String(b)) * mod
   })
 }
 

package/src/error/error.model.ts

@@ -18,6 +18,12 @@ export interface ErrorData {
    */
   errorId?: string
 
+  /**
+   * Set to true to force reporting this error (e.g to Sentry).
+   * Useful to be able to force-report e.g a 4xx error, which by default wouldn't be reported.
+   */
+  report?: boolean
+
   /**
    * Sometimes error.message gets "decorated" with extra information
    * (e.g frontend-lib adds a method, url, etc for all the errors)
@@ -36,6 +42,11 @@ export interface HttpErrorData extends ErrorData {
    * @default 500
    */
   httpStatusCode: number
+
+  /**
+   * Set to true when the error was thrown after response headers were sent.
+   */
+  headersSent?: boolean
 }
 
 export interface Admin401ErrorData extends HttpErrorData {

package/src/number/number.util.ts

@@ -37,8 +37,9 @@ export function _clamp(x: number, minIncl: number, maxIncl: number): number {
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export function _sortNumbers(numbers: number[], mutate = false): number[] {
-  return (mutate ? numbers : [...numbers]).sort((a, b) => a - b)
+export function _sortNumbers(numbers: number[], mutate = false, descending = false): number[] {
+  const mod = descending ? -1 : 1
+  return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod)
 }
 
 /**

package/src/string/safeJsonStringify.ts

@@ -11,7 +11,13 @@ export function _safeJsonStringify(
   spaces?: number,
   cycleReplacer?: Reviver,
 ): string {
-  return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces)
+  try {
+    // Try native first (as it's ~3 times faster)
+    return JSON.stringify(obj, replacer, spaces)
+  } catch {
+    // Native failed - resort to the "safe" serializer
+    return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces)
+  }
 }
 
 /* eslint-disable @typescript-eslint/no-unused-expressions, no-bitwise */

package/src/string/stringifyAny.ts

@@ -1,12 +1,10 @@
 import { _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse } from '../error/error.util'
 import { Reviver } from '../types'
 import { _jsonParseIfPossible } from './json.util'
+import { _safeJsonStringify } from './safeJsonStringify'
 
 export type JsonStringifyFunction = (obj: any, reviver?: Reviver, space?: number) => string
 
-const jsonStringifyFn: JsonStringifyFunction = (obj, reviver, space) =>
-  JSON.stringify(obj, reviver, space)
-
 export interface StringifyAnyOptions {
   /**
    * @default 10_000
@@ -116,7 +114,7 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
     // Other
     //
     try {
-      const { stringifyFn = jsonStringifyFn } = opt
+      const { stringifyFn = _safeJsonStringify } = opt
 
       s = stringifyFn(obj, undefined, 2)
     } catch {