@naturalcycles/js-lib 14.251.0 → 14.252.1

package/dist/datetime/localDate.js

@@ -246,6 +246,7 @@ class LocalDate {
         return this.plus(-num, 'year');
     }
     plus(num, unit, mutate = false) {
+        num = Math.floor(num); // if a fractional number like 0.5 is passed - it will be floored, as LocalDate only deals with "whole days" as minimal unit
         let { day, month, year } = this;
         if (unit === 'week') {
             num *= 7;

package/dist/decorators/debounce.decorator.js

@@ -5,7 +5,7 @@ exports._Throttle = _Throttle;
 const debounce_1 = require("./debounce");
 // eslint-disable-next-line @typescript-eslint/naming-convention
 function _Debounce(wait, opt = {}) {
-    return (target, key, descriptor) => {
+    return (_target, _key, descriptor) => {
         const originalFn = descriptor.value;
         descriptor.value = (0, debounce_1._debounce)(originalFn, wait, opt);
         return descriptor;
@@ -13,7 +13,7 @@ function _Debounce(wait, opt = {}) {
 }
 // eslint-disable-next-line @typescript-eslint/naming-convention
 function _Throttle(wait, opt = {}) {
-    return (target, key, descriptor) => {
+    return (_target, _key, descriptor) => {
         const originalFn = descriptor.value;
         descriptor.value = (0, debounce_1._throttle)(originalFn, wait, opt);
         return descriptor;

package/dist/decorators/retry.decorator.js

@@ -4,7 +4,7 @@ exports._Retry = _Retry;
 const __1 = require("..");
 // eslint-disable-next-line @typescript-eslint/naming-convention
 function _Retry(opt = {}) {
-    return (target, key, descriptor) => {
+    return (_target, _key, descriptor) => {
         const originalFn = descriptor.value;
         descriptor.value = (0, __1.pRetryFn)(originalFn, opt);
         return descriptor;

package/dist/define.js

@@ -97,7 +97,7 @@ function _defineProperty(obj, prop, pd) {
  * See _defineProperty for exact defaults definition.
  */
 function _defineProps(obj, props) {
-    return Object.defineProperties(obj, (0, object_util_1._mapValues)(props, (k, pd) => ({
+    return Object.defineProperties(obj, (0, object_util_1._mapValues)(props, (_k, pd) => ({
         writable: true,
         configurable: true,
         enumerable: true,

package/dist/error/assert.d.ts

@@ -1,5 +1,4 @@
-import type { ErrorData, ErrorObject } from '..';
-import { Class } from '..';
+import { BackendErrorResponseObject, Class, ErrorData, ErrorObject } from '..';
 /**
  * Evaluates the `condition` (casts it to Boolean).
  * Expects it to be truthy, otherwise throws AppError.
@@ -40,6 +39,7 @@ export declare function _assertIsError<ERR extends Error = Error>(err: any, erro
  */
 export declare function _assertErrorClassOrRethrow<ERR extends Error>(err: any, errorClass: Class<ERR>): asserts err is ERR;
 export declare function _assertIsErrorObject<DATA_TYPE extends ErrorData = ErrorData>(obj: any): asserts obj is ErrorObject<DATA_TYPE>;
+export declare function _assertIsBackendErrorResponseObject<DATA_TYPE extends ErrorData = ErrorData>(obj: any): asserts obj is BackendErrorResponseObject<DATA_TYPE>;
 export declare function _assertIsString(v: any, message?: string): asserts v is string;
 export declare function _assertIsNumber(v: any, message?: string): asserts v is number;
 export declare function _assertTypeOf<T>(v: any, expectedType: string, message?: string): asserts v is T;

package/dist/error/assert.js

@@ -6,6 +6,7 @@ exports._assertDeepEquals = _assertDeepEquals;
 exports._assertIsError = _assertIsError;
 exports._assertErrorClassOrRethrow = _assertErrorClassOrRethrow;
 exports._assertIsErrorObject = _assertIsErrorObject;
+exports._assertIsBackendErrorResponseObject = _assertIsBackendErrorResponseObject;
 exports._assertIsString = _assertIsString;
 exports._assertIsNumber = _assertIsNumber;
 exports._assertTypeOf = _assertTypeOf;
@@ -89,6 +90,11 @@ function _assertIsErrorObject(obj) {
         throw new __1.AssertionError(`Expected to be ErrorObject, actual typeof: ${typeof obj}`);
     }
 }
+function _assertIsBackendErrorResponseObject(obj) {
+    if (!(0, __1._isBackendErrorResponseObject)(obj)) {
+        throw new __1.AssertionError(`Expected to be BackendErrorResponseObject, actual typeof: ${typeof obj}`);
+    }
+}
 function _assertIsString(v, message) {
     _assertTypeOf(v, 'string', message);
 }

package/dist/error/tryCatch.js

@@ -38,7 +38,7 @@ function _tryCatch(fn, opt = {}) {
     };
 }
 // eslint-disable-next-line @typescript-eslint/naming-convention
-const _TryCatch = (opt = {}) => (target, key, descriptor) => {
+const _TryCatch = (opt = {}) => (_target, _key, descriptor) => {
     const originalFn = descriptor.value;
     descriptor.value = _tryCatch(originalFn, opt);
     return descriptor;

package/dist/http/fetcher.js

@@ -320,23 +320,32 @@ class Fetcher {
     }
     async onNotOkResponse(res) {
         let cause;
+        // Try to fetch body and attach to res.body
+        // (but don't fail if it doesn't work)
+        if (!res.body && res.fetchResponse) {
+            try {
+                res.body = (0, json_util_1._jsonParseIfPossible)(await res.fetchResponse.text());
+            }
+            catch {
+                // ignore body fetching/parsing errors at this point
+            }
+        }
         if (res.err) {
             // This is only possible on JSON.parse error, or CORS error,
             // or `unexpected redirect`
             // This check should go first, to avoid calling .text() twice (which will fail)
             cause = (0, error_util_1._errorLikeToErrorObject)(res.err);
         }
-        else if (res.fetchResponse) {
-            const body = (0, json_util_1._jsonParseIfPossible)(await res.fetchResponse.text());
-            if (body) {
-                cause = (0, error_util_1._anyToErrorObject)(body);
-            }
+        else if (res.body) {
+            cause = (0, error_util_1._anyToErrorObject)(res.body);
+        }
+        else {
+            cause = {
+                name: 'Error',
+                message: 'Fetch failed',
+                data: {},
+            };
         }
-        cause ||= {
-            name: 'Error',
-            message: 'Fetch failed',
-            data: {},
-        };
         let responseStatusCode = res.fetchResponse?.status || 0;
         if (res.statusFamily === 2) {
             // important to reset responseStatusCode to 0 in this case, as status 2xx can be misleading

package/dist/object/object.util.js

@@ -308,7 +308,6 @@ function _unset(obj, prop) {
     if (!(0, is_util_1._isObject)(obj)) {
         return;
     }
-    // eslint-disable-next-line no-prototype-builtins
     if (obj.hasOwnProperty(prop)) {
         delete obj[prop];
         return;
@@ -426,7 +425,7 @@ function _has(obj, path) {
 function _deepFreeze(o) {
     Object.freeze(o);
     Object.getOwnPropertyNames(o).forEach(prop => {
-        if (o.hasOwnProperty(prop) && // eslint-disable-line no-prototype-builtins
+        if (o.hasOwnProperty(prop) &&
             o[prop] !== null &&
             (typeof o[prop] === 'object' || typeof o[prop] === 'function') &&
             !Object.isFrozen(o[prop])) {

package/dist/promise/pFilter.js

@@ -4,5 +4,5 @@ exports.pFilter = pFilter;
 async function pFilter(iterable, filterFn) {
     const items = [...iterable];
     const predicates = await Promise.all(items.map((item, i) => filterFn(item, i)));
-    return items.filter((item, i) => predicates[i]);
+    return items.filter((_item, i) => predicates[i]);
 }

package/dist/promise/pTimeout.js

@@ -33,7 +33,7 @@ async function pTimeout(fn, opt) {
     }
     const { timeout, name = fn.name || 'pTimeout function', onTimeout } = opt;
     const fakeError = opt.fakeError || new Error('TimeoutError');
-    // eslint-disable-next-line no-async-promise-executor
+    // biome-ignore lint/suspicious/noAsyncPromiseExecutor: ok
     return await new Promise(async (resolve, reject) => {
         // Prepare the timeout timer
         const timer = setTimeout(() => {

package/dist/string/safeJsonStringify.js

@@ -20,7 +20,7 @@ function _safeJsonStringify(obj, replacer, spaces, cycleReplacer) {
 function serializer(replacer, cycleReplacer) {
     const stack = [];
     const keys = [];
-    cycleReplacer ??= (key, value) => {
+    cycleReplacer ??= (_key, value) => {
         if (stack[0] === value)
             return '[Circular ~]';
         return '[Circular ~.' + keys.slice(0, stack.indexOf(value)).join('.') + ']';

package/dist-esm/datetime/localDate.js

@@ -243,6 +243,7 @@ export class LocalDate {
         return this.plus(-num, 'year');
     }
     plus(num, unit, mutate = false) {
+        num = Math.floor(num); // if a fractional number like 0.5 is passed - it will be floored, as LocalDate only deals with "whole days" as minimal unit
         let { day, month, year } = this;
         if (unit === 'week') {
             num *= 7;

package/dist-esm/decorators/debounce.decorator.js

@@ -1,7 +1,7 @@
 import { _debounce, _throttle } from './debounce';
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _Debounce(wait, opt = {}) {
-    return (target, key, descriptor) => {
+    return (_target, _key, descriptor) => {
         const originalFn = descriptor.value;
         descriptor.value = _debounce(originalFn, wait, opt);
         return descriptor;
@@ -9,7 +9,7 @@ export function _Debounce(wait, opt = {}) {
 }
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _Throttle(wait, opt = {}) {
-    return (target, key, descriptor) => {
+    return (_target, _key, descriptor) => {
         const originalFn = descriptor.value;
         descriptor.value = _throttle(originalFn, wait, opt);
         return descriptor;

package/dist-esm/decorators/retry.decorator.js

@@ -1,7 +1,7 @@
 import { pRetryFn } from '..';
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _Retry(opt = {}) {
-    return (target, key, descriptor) => {
+    return (_target, _key, descriptor) => {
         const originalFn = descriptor.value;
         descriptor.value = pRetryFn(originalFn, opt);
         return descriptor;

package/dist-esm/define.js

@@ -89,7 +89,7 @@ export function _defineProperty(obj, prop, pd) {
  * See _defineProperty for exact defaults definition.
  */
 export function _defineProps(obj, props) {
-    return Object.defineProperties(obj, _mapValues(props, (k, pd) => ({
+    return Object.defineProperties(obj, _mapValues(props, (_k, pd) => ({
         writable: true,
         configurable: true,
         enumerable: true,

package/dist-esm/error/assert.js

@@ -1,4 +1,4 @@
-import { _deepEquals, _isErrorObject, _stringify, AssertionError } from '..';
+import { _deepEquals, _isBackendErrorResponseObject, _isErrorObject, _stringify, AssertionError, } from '..';
 /**
  * Evaluates the `condition` (casts it to Boolean).
  * Expects it to be truthy, otherwise throws AppError.
@@ -78,6 +78,11 @@ export function _assertIsErrorObject(obj) {
         throw new AssertionError(`Expected to be ErrorObject, actual typeof: ${typeof obj}`);
     }
 }
+export function _assertIsBackendErrorResponseObject(obj) {
+    if (!_isBackendErrorResponseObject(obj)) {
+        throw new AssertionError(`Expected to be BackendErrorResponseObject, actual typeof: ${typeof obj}`);
+    }
+}
 export function _assertIsString(v, message) {
     _assertTypeOf(v, 'string', message);
 }

package/dist-esm/error/tryCatch.js

@@ -34,7 +34,7 @@ export function _tryCatch(fn, opt = {}) {
     };
 }
 // eslint-disable-next-line @typescript-eslint/naming-convention
-export const _TryCatch = (opt = {}) => (target, key, descriptor) => {
+export const _TryCatch = (opt = {}) => (_target, _key, descriptor) => {
     const originalFn = descriptor.value;
     descriptor.value = _tryCatch(originalFn, opt);
     return descriptor;

package/dist-esm/http/fetcher.js

@@ -312,23 +312,32 @@ export class Fetcher {
     }
     async onNotOkResponse(res) {
         let cause;
+        // Try to fetch body and attach to res.body
+        // (but don't fail if it doesn't work)
+        if (!res.body && res.fetchResponse) {
+            try {
+                res.body = _jsonParseIfPossible(await res.fetchResponse.text());
+            }
+            catch {
+                // ignore body fetching/parsing errors at this point
+            }
+        }
         if (res.err) {
             // This is only possible on JSON.parse error, or CORS error,
             // or `unexpected redirect`
             // This check should go first, to avoid calling .text() twice (which will fail)
             cause = _errorLikeToErrorObject(res.err);
         }
-        else if (res.fetchResponse) {
-            const body = _jsonParseIfPossible(await res.fetchResponse.text());
-            if (body) {
-                cause = _anyToErrorObject(body);
-            }
+        else if (res.body) {
+            cause = _anyToErrorObject(res.body);
+        }
+        else {
+            cause = {
+                name: 'Error',
+                message: 'Fetch failed',
+                data: {},
+            };
         }
-        cause || (cause = {
-            name: 'Error',
-            message: 'Fetch failed',
-            data: {},
-        });
         let responseStatusCode = res.fetchResponse?.status || 0;
         if (res.statusFamily === 2) {
             // important to reset responseStatusCode to 0 in this case, as status 2xx can be misleading

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

@@ -279,7 +279,6 @@ export function _unset(obj, prop) {
     if (!_isObject(obj)) {
         return;
     }
-    // eslint-disable-next-line no-prototype-builtins
     if (obj.hasOwnProperty(prop)) {
         delete obj[prop];
         return;
@@ -397,7 +396,7 @@ export function _has(obj, path) {
 export function _deepFreeze(o) {
     Object.freeze(o);
     Object.getOwnPropertyNames(o).forEach(prop => {
-        if (o.hasOwnProperty(prop) && // eslint-disable-line no-prototype-builtins
+        if (o.hasOwnProperty(prop) &&
             o[prop] !== null &&
             (typeof o[prop] === 'object' || typeof o[prop] === 'function') &&
             !Object.isFrozen(o[prop])) {

package/dist-esm/promise/pFilter.js

@@ -1,5 +1,5 @@
 export async function pFilter(iterable, filterFn) {
     const items = [...iterable];
     const predicates = await Promise.all(items.map((item, i) => filterFn(item, i)));
-    return items.filter((item, i) => predicates[i]);
+    return items.filter((_item, i) => predicates[i]);
 }

package/dist-esm/promise/pTimeout.js

@@ -29,7 +29,7 @@ export async function pTimeout(fn, opt) {
     }
     const { timeout, name = fn.name || 'pTimeout function', onTimeout } = opt;
     const fakeError = opt.fakeError || new Error('TimeoutError');
-    // eslint-disable-next-line no-async-promise-executor
+    // biome-ignore lint/suspicious/noAsyncPromiseExecutor: ok
     return await new Promise(async (resolve, reject) => {
         // Prepare the timeout timer
         const timer = setTimeout(() => {

package/dist-esm/string/safeJsonStringify.js

@@ -17,7 +17,7 @@ export function _safeJsonStringify(obj, replacer, spaces, cycleReplacer) {
 function serializer(replacer, cycleReplacer) {
     const stack = [];
     const keys = [];
-    cycleReplacer ?? (cycleReplacer = (key, value) => {
+    cycleReplacer ?? (cycleReplacer = (_key, value) => {
         if (stack[0] === value)
             return '[Circular ~]';
         return '[Circular ~.' + keys.slice(0, stack.indexOf(value)).join('.') + ']';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.251.0",
+  "version": "14.252.1",
   "scripts": {
     "prepare": "husky",
     "build": "dev-lib build-esm-cjs",
@@ -46,7 +46,7 @@
   "types": "dist/index.d.ts",
   "sideEffects": false,
   "engines": {
-    "node": ">=18.12.0"
+    "node": ">=20.13.0"
   },
   "publishConfig": {
     "provenance": true,

package/src/array/range.ts

@@ -1,7 +1,7 @@
 import { AsyncIterable2 } from '../iter/asyncIterable2'
 import { Iterable2 } from '../iter/iterable2'
 
-/* eslint-disable no-redeclare, unicorn/no-new-array */
+/* eslint-disable unicorn/no-new-array */
 
 /**
  * Returns an array with ranges from `from` up to (but not including) `to`.

package/src/datetime/localDate.ts

@@ -287,6 +287,7 @@ export class LocalDate {
   }
 
   plus(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
+    num = Math.floor(num) // if a fractional number like 0.5 is passed - it will be floored, as LocalDate only deals with "whole days" as minimal unit
     let { day, month, year } = this
 
     if (unit === 'week') {

package/src/decorators/debounce.decorator.ts

@@ -3,7 +3,7 @@ import { _debounce, _throttle } from './debounce'
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _Debounce(wait: number, opt: DebounceOptions = {}): MethodDecorator {
-  return (target, key, descriptor) => {
+  return (_target, _key, descriptor) => {
     const originalFn = descriptor.value
     descriptor.value = _debounce(originalFn as any, wait, opt)
     return descriptor
@@ -12,7 +12,7 @@ export function _Debounce(wait: number, opt: DebounceOptions = {}): MethodDecora
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _Throttle(wait: number, opt: ThrottleOptions = {}): MethodDecorator {
-  return (target, key, descriptor) => {
+  return (_target, _key, descriptor) => {
     const originalFn = descriptor.value
     descriptor.value = _throttle(originalFn as any, wait, opt)
     return descriptor

package/src/decorators/retry.decorator.ts

@@ -3,7 +3,7 @@ import { pRetryFn } from '..'
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export function _Retry(opt: PRetryOptions = {}): MethodDecorator {
-  return (target, key, descriptor) => {
+  return (_target, _key, descriptor) => {
     const originalFn = descriptor.value
     descriptor.value = pRetryFn(originalFn as any, opt)
     return descriptor

package/src/define.ts

@@ -115,7 +115,7 @@ export function _defineProps<T extends AnyObject>(
 ): T {
   return Object.defineProperties(
     obj,
-    _mapValues(props, (k, pd) => ({
+    _mapValues(props, (_k, pd) => ({
       writable: true,
       configurable: true,
       enumerable: true,

package/src/error/assert.ts

@@ -1,5 +1,14 @@
-import type { ErrorData, ErrorObject } from '..'
-import { _deepEquals, _isErrorObject, _stringify, AssertionError, Class } from '..'
+import {
+  _deepEquals,
+  _isBackendErrorResponseObject,
+  _isErrorObject,
+  _stringify,
+  AssertionError,
+  BackendErrorResponseObject,
+  Class,
+  ErrorData,
+  ErrorObject,
+} from '..'
 
 /**
  * Evaluates the `condition` (casts it to Boolean).
@@ -113,6 +122,16 @@ export function _assertIsErrorObject<DATA_TYPE extends ErrorData = ErrorData>(
   }
 }
 
+export function _assertIsBackendErrorResponseObject<DATA_TYPE extends ErrorData = ErrorData>(
+  obj: any,
+): asserts obj is BackendErrorResponseObject<DATA_TYPE> {
+  if (!_isBackendErrorResponseObject(obj)) {
+    throw new AssertionError(
+      `Expected to be BackendErrorResponseObject, actual typeof: ${typeof obj}`,
+    )
+  }
+}
+
 export function _assertIsString(v: any, message?: string): asserts v is string {
   _assertTypeOf<string>(v, 'string', message)
 }

package/src/error/tryCatch.ts

@@ -67,7 +67,7 @@ export function _tryCatch<T extends AnyFunction>(fn: T, opt: TryCatchOptions = {
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export const _TryCatch =
   (opt: TryCatchOptions = {}): MethodDecorator =>
-  (target, key, descriptor) => {
+  (_target, _key, descriptor) => {
     const originalFn = descriptor.value
     descriptor.value = _tryCatch(originalFn as any, opt)
     return descriptor

package/src/http/fetcher.ts

@@ -416,24 +416,31 @@ export class Fetcher {
   private async onNotOkResponse(res: FetcherResponse): Promise<void> {
     let cause: ErrorObject
 
+    // Try to fetch body and attach to res.body
+    // (but don't fail if it doesn't work)
+    if (!res.body && res.fetchResponse) {
+      try {
+        res.body = _jsonParseIfPossible(await res.fetchResponse.text())
+      } catch {
+        // ignore body fetching/parsing errors at this point
+      }
+    }
+
     if (res.err) {
       // This is only possible on JSON.parse error, or CORS error,
       // or `unexpected redirect`
       // This check should go first, to avoid calling .text() twice (which will fail)
       cause = _errorLikeToErrorObject(res.err)
-    } else if (res.fetchResponse) {
-      const body = _jsonParseIfPossible(await res.fetchResponse.text())
-      if (body) {
-        cause = _anyToErrorObject(body)
+    } else if (res.body) {
+      cause = _anyToErrorObject(res.body)
+    } else {
+      cause = {
+        name: 'Error',
+        message: 'Fetch failed',
+        data: {},
       }
     }
 
-    cause ||= {
-      name: 'Error',
-      message: 'Fetch failed',
-      data: {},
-    }
-
     let responseStatusCode = res.fetchResponse?.status || 0
     if (res.statusFamily === 2) {
       // important to reset responseStatusCode to 0 in this case, as status 2xx can be misleading

package/src/object/object.util.ts

@@ -332,7 +332,7 @@ export function _unset<T extends AnyObject>(obj: T, prop: string): void {
   if (!_isObject(obj)) {
     return
   }
-  // eslint-disable-next-line no-prototype-builtins
+
   if (obj.hasOwnProperty(prop)) {
     delete obj[prop]
     return
@@ -470,7 +470,7 @@ export function _deepFreeze(o: any): void {
 
   Object.getOwnPropertyNames(o).forEach(prop => {
     if (
-      o.hasOwnProperty(prop) && // eslint-disable-line no-prototype-builtins
+      o.hasOwnProperty(prop) &&
       o[prop] !== null &&
       (typeof o[prop] === 'object' || typeof o[prop] === 'function') &&
       !Object.isFrozen(o[prop])

package/src/promise/pFilter.ts

@@ -3,5 +3,5 @@ import type { AsyncPredicate } from '../types'
 export async function pFilter<T>(iterable: Iterable<T>, filterFn: AsyncPredicate<T>): Promise<T[]> {
   const items = [...iterable]
   const predicates = await Promise.all(items.map((item, i) => filterFn(item, i)))
-  return items.filter((item, i) => predicates[i])
+  return items.filter((_item, i) => predicates[i])
 }

package/src/promise/pTimeout.ts

@@ -72,7 +72,7 @@ export async function pTimeout<T>(fn: AnyAsyncFunction<T>, opt: PTimeoutOptions)
   const { timeout, name = fn.name || 'pTimeout function', onTimeout } = opt
   const fakeError = opt.fakeError || new Error('TimeoutError')
 
-  // eslint-disable-next-line no-async-promise-executor
+  // biome-ignore lint/suspicious/noAsyncPromiseExecutor: ok
   return await new Promise(async (resolve, reject) => {
     // Prepare the timeout timer
     const timer = setTimeout(() => {

package/src/string/safeJsonStringify.ts

@@ -26,7 +26,7 @@ function serializer(replacer?: Reviver, cycleReplacer?: Reviver): Reviver {
   const stack: any[] = []
   const keys: string[] = []
 
-  cycleReplacer ??= (key, value) => {
+  cycleReplacer ??= (_key, value) => {
     if (stack[0] === value) return '[Circular ~]'
     return '[Circular ~.' + keys.slice(0, stack.indexOf(value)).join('.') + ']'
   }