@naturalcycles/js-lib 14.60.1 → 14.64.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,16 @@ export interface HttpErrorData extends ErrorData {
      * @default 500
      */
     httpStatusCode: number;
+    /**
+     * @example
+     *
+     * GET /api/some-endpoint
+     */
+    endpoint?: string;
+    /**
+     * 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-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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.60.1",
+  "version": "14.64.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,18 @@ export interface HttpErrorData extends ErrorData {
    * @default 500
    */
   httpStatusCode: number
+
+  /**
+   * @example
+   *
+   * GET /api/some-endpoint
+   */
+  endpoint?: string
+
+  /**
+   * 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)
 }
 
 /**