@naturalcycles/js-lib 14.140.0 → 14.142.0

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

@@ -159,3 +159,7 @@ export declare function _maxOrUndefined<T>(array: T[]): NonNullable<T> | undefin
  * Filters out nullish values (undefined and null).
  */
 export declare function _max<T>(array: T[]): NonNullable<T>;
+export declare function _maxBy<T>(array: T[], mapper: Mapper<T, number | undefined>): T;
+export declare function _minBy<T>(array: T[], mapper: Mapper<T, number | undefined>): T;
+export declare function _maxByOrUndefined<T>(array: T[], mapper: Mapper<T, number | undefined>): T | undefined;
+export declare function _minByOrUndefined<T>(array: T[], mapper: Mapper<T, number | undefined>): T | undefined;

package/dist/array/array.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortBy = exports._groupBy = exports._by = exports._uniqBy = exports._uniq = exports._flattenDeep = exports._flatten = exports._chunk = void 0;
+exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortBy = exports._groupBy = exports._by = exports._uniqBy = exports._uniq = exports._flattenDeep = exports._flatten = exports._chunk = void 0;
 const is_util_1 = require("../is.util");
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
@@ -314,3 +314,48 @@ function _max(array) {
     return a.reduce((max, item) => (max >= item ? max : item));
 }
 exports._max = _max;
+function _maxBy(array, mapper) {
+    const max = _maxByOrUndefined(array, mapper);
+    if (max === undefined)
+        throw new Error(`_maxBy returned undefined`);
+    return max;
+}
+exports._maxBy = _maxBy;
+function _minBy(array, mapper) {
+    const min = _minByOrUndefined(array, mapper);
+    if (min === undefined)
+        throw new Error(`_minBy returned undefined`);
+    return min;
+}
+exports._minBy = _minBy;
+// todo: looks like it _maxByOrUndefined/_minByOrUndefined can be DRYer
+function _maxByOrUndefined(array, mapper) {
+    if (!array.length)
+        return;
+    let maxItem;
+    let max;
+    array.forEach((item, i) => {
+        const v = mapper(item, i);
+        if (v !== undefined && (max === undefined || v > max)) {
+            maxItem = item;
+            max = v;
+        }
+    });
+    return maxItem;
+}
+exports._maxByOrUndefined = _maxByOrUndefined;
+function _minByOrUndefined(array, mapper) {
+    if (!array.length)
+        return;
+    let minItem;
+    let min;
+    array.forEach((item, i) => {
+        const v = mapper(item, i);
+        if (v !== undefined && (min === undefined || v < min)) {
+            minItem = item;
+            min = v;
+        }
+    });
+    return minItem;
+}
+exports._minByOrUndefined = _minByOrUndefined;

package/dist/http/fetcher.d.ts

@@ -34,9 +34,14 @@ export declare class Fetcher {
     /**
      * Returns FetcherResponse.
      * Never throws, returns `err` property in the response instead.
+     * Use this method instead of `throwHttpErrors: false` or try-catching.
      */
-    rawFetch<T = unknown>(url: string, rawOpt?: FetcherOptions): Promise<FetcherResponse<T>>;
+    doFetch<T = unknown>(url: string, rawOpt?: FetcherOptions): Promise<FetcherResponse<T>>;
     private onOkResponse;
+    /**
+     * This method exists to be able to easily mock it.
+     */
+    callNativeFetch(url: string, init: RequestInit): Promise<Response>;
     private onNotOkResponse;
     private processRetry;
     /**

package/dist/http/fetcher.js

@@ -78,7 +78,7 @@ class Fetcher {
         return new Fetcher(cfg);
     }
     async fetch(url, opt) {
-        const res = await this.rawFetch(url, opt);
+        const res = await this.doFetch(url, opt);
         if (res.err) {
             if (res.req.throwHttpErrors)
                 throw res.err;
@@ -89,8 +89,9 @@ class Fetcher {
     /**
      * Returns FetcherResponse.
      * Never throws, returns `err` property in the response instead.
+     * Use this method instead of `throwHttpErrors: false` or try-catching.
      */
-    async rawFetch(url, rawOpt = {}) {
+    async doFetch(url, rawOpt = {}) {
         const { logger } = this.cfg;
         const req = this.normalizeOptions(url, rawOpt);
         const { timeoutSeconds, init: { method }, } = req;
@@ -131,7 +132,7 @@ class Fetcher {
                 }
             }
             try {
-                res.fetchResponse = await globalThis.fetch(req.url, req.init);
+                res.fetchResponse = await this.callNativeFetch(req.url, req.init);
                 res.ok = res.fetchResponse.ok;
             }
             catch (err) {
@@ -215,6 +216,12 @@ class Fetcher {
             }
         }
     }
+    /**
+     * This method exists to be able to easily mock it.
+     */
+    async callNativeFetch(url, init) {
+        return await globalThis.fetch(url, init);
+    }
     async onNotOkResponse(res, timeout) {
         clearTimeout(timeout);
         let errObj;

package/dist/string/stringifyAny.js

@@ -69,7 +69,15 @@ function _stringifyAny(obj, opt = {}) {
         // if (obj?.name === 'Error') {
         //   s = obj.message
         // }
-        s = [obj.name, obj.message].filter(Boolean).join(': ');
+        if ((0, error_util_1._isErrorObject)(obj) && (0, error_util_1._isHttpErrorObject)(obj)) {
+            // Printing (0) to avoid ambiguity
+            s = `${obj.name}(${obj.data.httpStatusCode}): ${obj.message}`;
+        }
+        s ||= [obj.name, obj.message].filter(Boolean).join(': ');
+        if (typeof obj.code === 'string') {
+            // Error that has no `data`, but has `code` property
+            s += `\ncode: ${obj.code}`;
+        }
         if (opt.includeErrorStack && obj.stack) {
             // Here we're using the previously-generated "title line" (e.g "Error: some_message"),
             // concatenating it with the Stack (but without the title line of the Stack)
@@ -79,18 +87,6 @@ function _stringifyAny(obj, opt = {}) {
             const sLines = s.split('\n').length;
             s = [s, ...obj.stack.split('\n').slice(sLines)].join('\n');
         }
-        if ((0, error_util_1._isErrorObject)(obj)) {
-            if ((0, error_util_1._isHttpErrorObject)(obj)) {
-                // Only include (statusCode) if it's non-zero
-                // No: print (0), as it removes ambiguity
-                // `replace` here works ONCE, exactly as we need it
-                s = s.replace('HttpError', `HttpError(${obj.data.httpStatusCode})`);
-            }
-        }
-        else if (typeof obj.code === 'string') {
-            // Error that has no `data`, but has `code` property
-            s = [s, `code: ${obj.code}`].join('\n');
-        }
         if (supportsAggregateError && obj instanceof AggregateError && obj.errors.length) {
             s = [
                 s,
@@ -99,7 +95,7 @@ function _stringifyAny(obj, opt = {}) {
             ].join('\n');
         }
         if (obj.cause && includeErrorCause) {
-            s = s + '\ncaused by: ' + _stringifyAny(obj.cause, opt);
+            s = s + '\nCaused by: ' + _stringifyAny(obj.cause, opt);
         }
     }
     else if (typeof obj === 'string') {

package/dist/types.d.ts

@@ -163,13 +163,21 @@ export type UnixTimestampMillisNumber = number;
  * @deprecated use UnixTimestampNumber
  */
 export type UnixTimestamp = number;
+export type NumberOfSeconds = number;
+export type NumberOfMilliseconds = number;
 /**
  * Same as `number`, but with semantic meaning that it's an Integer.
  */
 export type Integer = number;
+/**
+ * Used as a compact representation of truthy value.
+ * undefined ('' or other short falsy value) should be used as falsy value.
+ */
+export type ShortBoolean = '1';
 export type Base64String = string;
 export type Base64UrlString = string;
 export type JWTString = string;
+export type SemVerString = string;
 /**
  * Named type for JSON.parse / JSON.stringify second argument
  */

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

@@ -285,3 +285,44 @@ export function _max(array) {
         throw new Error('_max called on empty array');
     return a.reduce((max, item) => (max >= item ? max : item));
 }
+export function _maxBy(array, mapper) {
+    const max = _maxByOrUndefined(array, mapper);
+    if (max === undefined)
+        throw new Error(`_maxBy returned undefined`);
+    return max;
+}
+export function _minBy(array, mapper) {
+    const min = _minByOrUndefined(array, mapper);
+    if (min === undefined)
+        throw new Error(`_minBy returned undefined`);
+    return min;
+}
+// todo: looks like it _maxByOrUndefined/_minByOrUndefined can be DRYer
+export function _maxByOrUndefined(array, mapper) {
+    if (!array.length)
+        return;
+    let maxItem;
+    let max;
+    array.forEach((item, i) => {
+        const v = mapper(item, i);
+        if (v !== undefined && (max === undefined || v > max)) {
+            maxItem = item;
+            max = v;
+        }
+    });
+    return maxItem;
+}
+export function _minByOrUndefined(array, mapper) {
+    if (!array.length)
+        return;
+    let minItem;
+    let min;
+    array.forEach((item, i) => {
+        const v = mapper(item, i);
+        if (v !== undefined && (min === undefined || v < min)) {
+            minItem = item;
+            min = v;
+        }
+    });
+    return minItem;
+}

package/dist-esm/http/fetcher.js

@@ -67,7 +67,7 @@ export class Fetcher {
         return new Fetcher(cfg);
     }
     async fetch(url, opt) {
-        const res = await this.rawFetch(url, opt);
+        const res = await this.doFetch(url, opt);
         if (res.err) {
             if (res.req.throwHttpErrors)
                 throw res.err;
@@ -78,8 +78,9 @@ export class Fetcher {
     /**
      * Returns FetcherResponse.
      * Never throws, returns `err` property in the response instead.
+     * Use this method instead of `throwHttpErrors: false` or try-catching.
      */
-    async rawFetch(url, rawOpt = {}) {
+    async doFetch(url, rawOpt = {}) {
         var _a, e_1, _b, _c, _d, e_2, _e, _f;
         var _g;
         const { logger } = this.cfg;
@@ -139,7 +140,7 @@ export class Fetcher {
                 }
             }
             try {
-                res.fetchResponse = await globalThis.fetch(req.url, req.init);
+                res.fetchResponse = await this.callNativeFetch(req.url, req.init);
                 res.ok = res.fetchResponse.ok;
             }
             catch (err) {
@@ -240,6 +241,12 @@ export class Fetcher {
             }
         }
     }
+    /**
+     * This method exists to be able to easily mock it.
+     */
+    async callNativeFetch(url, init) {
+        return await globalThis.fetch(url, init);
+    }
     async onNotOkResponse(res, timeout) {
         var _a, _b;
         clearTimeout(timeout);

package/dist-esm/string/stringifyAny.js

@@ -65,7 +65,15 @@ export function _stringifyAny(obj, opt = {}) {
         // if (obj?.name === 'Error') {
         //   s = obj.message
         // }
-        s = [obj.name, obj.message].filter(Boolean).join(': ');
+        if (_isErrorObject(obj) && _isHttpErrorObject(obj)) {
+            // Printing (0) to avoid ambiguity
+            s = `${obj.name}(${obj.data.httpStatusCode}): ${obj.message}`;
+        }
+        s || (s = [obj.name, obj.message].filter(Boolean).join(': '));
+        if (typeof obj.code === 'string') {
+            // Error that has no `data`, but has `code` property
+            s += `\ncode: ${obj.code}`;
+        }
         if (opt.includeErrorStack && obj.stack) {
             // Here we're using the previously-generated "title line" (e.g "Error: some_message"),
             // concatenating it with the Stack (but without the title line of the Stack)
@@ -75,18 +83,6 @@ export function _stringifyAny(obj, opt = {}) {
             const sLines = s.split('\n').length;
             s = [s, ...obj.stack.split('\n').slice(sLines)].join('\n');
         }
-        if (_isErrorObject(obj)) {
-            if (_isHttpErrorObject(obj)) {
-                // Only include (statusCode) if it's non-zero
-                // No: print (0), as it removes ambiguity
-                // `replace` here works ONCE, exactly as we need it
-                s = s.replace('HttpError', `HttpError(${obj.data.httpStatusCode})`);
-            }
-        }
-        else if (typeof obj.code === 'string') {
-            // Error that has no `data`, but has `code` property
-            s = [s, `code: ${obj.code}`].join('\n');
-        }
         if (supportsAggregateError && obj instanceof AggregateError && obj.errors.length) {
             s = [
                 s,
@@ -95,7 +91,7 @@ export function _stringifyAny(obj, opt = {}) {
             ].join('\n');
         }
         if (obj.cause && includeErrorCause) {
-            s = s + '\ncaused by: ' + _stringifyAny(obj.cause, opt);
+            s = s + '\nCaused by: ' + _stringifyAny(obj.cause, opt);
         }
     }
     else if (typeof obj === 'string') {

package/package.json

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

package/src/array/array.util.ts

@@ -321,3 +321,53 @@ export function _max<T>(array: T[]): NonNullable<T> {
   if (!a.length) throw new Error('_max called on empty array')
   return a.reduce((max, item) => (max >= item ? max : item))
 }
+
+export function _maxBy<T>(array: T[], mapper: Mapper<T, number | undefined>): T {
+  const max = _maxByOrUndefined(array, mapper)
+  if (max === undefined) throw new Error(`_maxBy returned undefined`)
+  return max
+}
+
+export function _minBy<T>(array: T[], mapper: Mapper<T, number | undefined>): T {
+  const min = _minByOrUndefined(array, mapper)
+  if (min === undefined) throw new Error(`_minBy returned undefined`)
+  return min
+}
+
+// todo: looks like it _maxByOrUndefined/_minByOrUndefined can be DRYer
+
+export function _maxByOrUndefined<T>(
+  array: T[],
+  mapper: Mapper<T, number | undefined>,
+): T | undefined {
+  if (!array.length) return
+  let maxItem: T | undefined
+  let max: number | undefined
+  array.forEach((item, i) => {
+    const v = mapper(item, i)
+    if (v !== undefined && (max === undefined || v > max)) {
+      maxItem = item
+      max = v
+    }
+  })
+
+  return maxItem
+}
+
+export function _minByOrUndefined<T>(
+  array: T[],
+  mapper: Mapper<T, number | undefined>,
+): T | undefined {
+  if (!array.length) return
+  let minItem: T | undefined
+  let min: number | undefined
+  array.forEach((item, i) => {
+    const v = mapper(item, i)
+    if (v !== undefined && (min === undefined || v < min)) {
+      minItem = item
+      min = v
+    }
+  })
+
+  return minItem
+}

package/src/http/fetcher.ts

@@ -129,7 +129,7 @@ export class Fetcher {
   headVoid!: (url: string, opt?: FetcherOptions) => Promise<void>
 
   async fetch<T = unknown>(url: string, opt?: FetcherOptions): Promise<T> {
-    const res = await this.rawFetch<T>(url, opt)
+    const res = await this.doFetch<T>(url, opt)
     if (res.err) {
       if (res.req.throwHttpErrors) throw res.err
       return res as any
@@ -140,8 +140,9 @@ export class Fetcher {
   /**
    * Returns FetcherResponse.
    * Never throws, returns `err` property in the response instead.
+   * Use this method instead of `throwHttpErrors: false` or try-catching.
    */
-  async rawFetch<T = unknown>(
+  async doFetch<T = unknown>(
     url: string,
     rawOpt: FetcherOptions = {},
   ): Promise<FetcherResponse<T>> {
@@ -198,7 +199,7 @@ export class Fetcher {
       }
 
       try {
-        res.fetchResponse = await globalThis.fetch(req.url, req.init)
+        res.fetchResponse = await this.callNativeFetch(req.url, req.init)
         res.ok = res.fetchResponse.ok
       } catch (err) {
         // For example, CORS error would result in "TypeError: failed to fetch" here
@@ -294,6 +295,13 @@ export class Fetcher {
     }
   }
 
+  /**
+   * This method exists to be able to easily mock it.
+   */
+  async callNativeFetch(url: string, init: RequestInit): Promise<Response> {
+    return await globalThis.fetch(url, init)
+  }
+
   private async onNotOkResponse(res: FetcherResponse, timeout?: number): Promise<void> {
     clearTimeout(timeout)
 

package/src/string/stringifyAny.ts

@@ -103,7 +103,17 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
     // if (obj?.name === 'Error') {
     //   s = obj.message
     // }
-    s = [obj.name, obj.message].filter(Boolean).join(': ')
+    if (_isErrorObject(obj) && _isHttpErrorObject(obj)) {
+      // Printing (0) to avoid ambiguity
+      s = `${obj.name}(${obj.data.httpStatusCode}): ${obj.message}`
+    }
+
+    s ||= [obj.name, obj.message].filter(Boolean).join(': ')
+
+    if (typeof (obj as any).code === 'string') {
+      // Error that has no `data`, but has `code` property
+      s += `\ncode: ${(obj as any).code}`
+    }
 
     if (opt.includeErrorStack && obj.stack) {
       // Here we're using the previously-generated "title line" (e.g "Error: some_message"),
@@ -116,18 +126,6 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
       s = [s, ...obj.stack.split('\n').slice(sLines)].join('\n')
     }
 
-    if (_isErrorObject(obj)) {
-      if (_isHttpErrorObject(obj)) {
-        // Only include (statusCode) if it's non-zero
-        // No: print (0), as it removes ambiguity
-        // `replace` here works ONCE, exactly as we need it
-        s = s.replace('HttpError', `HttpError(${obj.data.httpStatusCode})`)
-      }
-    } else if (typeof (obj as any).code === 'string') {
-      // Error that has no `data`, but has `code` property
-      s = [s, `code: ${(obj as any).code}`].join('\n')
-    }
-
     if (supportsAggregateError && obj instanceof AggregateError && obj.errors.length) {
       s = [
         s,
@@ -137,7 +135,7 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
     }
 
     if (obj.cause && includeErrorCause) {
-      s = s + '\ncaused by: ' + _stringifyAny(obj.cause, opt)
+      s = s + '\nCaused by: ' + _stringifyAny(obj.cause, opt)
     }
   } else if (typeof obj === 'string') {
     //

package/src/types.ts

@@ -222,15 +222,26 @@ export type UnixTimestampMillisNumber = number
  */
 export type UnixTimestamp = number
 
+export type NumberOfSeconds = number
+export type NumberOfMilliseconds = number
+
 /**
  * Same as `number`, but with semantic meaning that it's an Integer.
  */
 export type Integer = number
 
+/**
+ * Used as a compact representation of truthy value.
+ * undefined ('' or other short falsy value) should be used as falsy value.
+ */
+export type ShortBoolean = '1'
+
 export type Base64String = string
 export type Base64UrlString = string
 export type JWTString = string
 
+export type SemVerString = string
+
 /**
  * Named type for JSON.parse / JSON.stringify second argument
  */