@naturalcycles/js-lib 14.226.0 → 14.228.0

package/dist/datetime/localDate.d.ts

@@ -94,15 +94,7 @@ export declare class LocalDate {
      */
     diff(d: LocalDateInput, unit: LocalDateUnit): number;
     plus(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
-    /**
-     * @deprecated use `minus` instead
-     */
-    subtract(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     minus(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
-    /**
-     * @deprecated use `plus` instead
-     */
-    add(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     startOf(unit: LocalDateUnitStrict): LocalDate;
     endOf(unit: LocalDateUnitStrict): LocalDate;
     static getYearLength(year: number): number;

package/dist/datetime/localDate.js

@@ -342,21 +342,9 @@ class LocalDate {
         }
         return new LocalDate($year, $month, $day);
     }
-    /**
-     * @deprecated use `minus` instead
-     */
-    subtract(num, unit, mutate = false) {
-        return this.plus(-num, unit, mutate);
-    }
     minus(num, unit, mutate = false) {
         return this.plus(-num, unit, mutate);
     }
-    /**
-     * @deprecated use `plus` instead
-     */
-    add(num, unit, mutate = false) {
-        return this.plus(num, unit, mutate);
-    }
     startOf(unit) {
         if (unit === 'day')
             return this;

package/dist/datetime/localTime.d.ts

@@ -70,15 +70,7 @@ export declare class LocalTime {
     second(v: number): LocalTime;
     setComponents(c: Partial<LocalTimeComponents>, mutate?: boolean): LocalTime;
     plus(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
-    /**
-     * @deprecated use `minus` instead
-     */
-    subtract(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     minus(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
-    /**
-     * @deprecated use `plus` instead
-     */
-    add(num: number, unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     absDiff(other: LocalTimeInput, unit: LocalTimeUnit): number;
     diff(other: LocalTimeInput, unit: LocalTimeUnit): number;
     startOf(unit: LocalTimeUnit, mutate?: boolean): LocalTime;

package/dist/datetime/localTime.js

@@ -211,21 +211,9 @@ class LocalTime {
         }
         return this.set(unit, this.get(unit) + num, mutate);
     }
-    /**
-     * @deprecated use `minus` instead
-     */
-    subtract(num, unit, mutate = false) {
-        return this.plus(num * -1, unit, mutate);
-    }
     minus(num, unit, mutate = false) {
         return this.plus(num * -1, unit, mutate);
     }
-    /**
-     * @deprecated use `plus` instead
-     */
-    add(num, unit, mutate = false) {
-        return this.plus(num, unit, mutate);
-    }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
     }

package/dist/decorators/timeout.decorator.js

@@ -8,6 +8,8 @@ const decorator_util_1 = require("./decorator.util");
 function _Timeout(opt) {
     return (target, key, descriptor) => {
         (0, assert_1._assert)(typeof descriptor.value === 'function', '@_Timeout can be applied only to methods');
+        if (!opt.timeout)
+            return descriptor;
         const originalFn = descriptor.value;
         const keyStr = String(key);
         descriptor.value = async function (...args) {

package/dist/promise/pRetry.js

@@ -25,7 +25,6 @@ async function pRetry(fn, opt = {}) {
     const fname = name || fn.name || 'pRetry function';
     let delay = initialDelay;
     let attempt = 0;
-    /* eslint-disable no-constant-condition */
     while (true) {
         const started = Date.now();
         try {

package/dist/promise/pTimeout.d.ts

@@ -4,6 +4,8 @@ import type { AnyAsyncFunction, NumberOfMilliseconds } from '../types';
 export interface PTimeoutOptions {
     /**
      * Timeout in milliseconds.
+     *
+     * If 0 is passed - the function would be executed right away, with no timeout.
      */
     timeout: NumberOfMilliseconds;
     /**

package/dist/promise/pTimeout.js

@@ -11,6 +11,9 @@ const error_util_1 = require("../error/error.util");
  */
 function pTimeoutFn(fn, opt) {
     opt.name ||= fn.name;
+    if (!opt.timeout) {
+        return fn;
+    }
     return async function pTimeoutInternalFn(...args) {
         return await pTimeout(() => fn.apply(this, args), opt);
     };
@@ -23,6 +26,10 @@ exports.pTimeoutFn = pTimeoutFn;
  * If the Function rejects - passes this rejection further.
  */
 async function pTimeout(fn, opt) {
+    if (!opt.timeout) {
+        // short-circuit to direct execution if 0 timeout is passed
+        return await fn();
+    }
     const { timeout, name = fn.name || 'pTimeout function', onTimeout } = opt;
     const fakeError = opt.fakeError || new Error('TimeoutError');
     // eslint-disable-next-line no-async-promise-executor

package/dist/string/stringify.d.ts

@@ -65,7 +65,3 @@ export interface StringifyOptions {
  * Returns 'undefined' if undefined is passed (default util.inspect behavior).
  */
 export declare function _stringify(obj: any, opt?: StringifyOptions): string;
-/**
- * @deprecated renamed to _stringify
- */
-export declare const _stringifyAny: typeof _stringify;

package/dist/string/stringify.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._stringifyAny = exports._stringify = exports.setGlobalStringifyFunction = void 0;
+exports._stringify = exports.setGlobalStringifyFunction = void 0;
 const error_util_1 = require("../error/error.util");
 const json_util_1 = require("./json.util");
 const safeJsonStringify_1 = require("./safeJsonStringify");
@@ -136,7 +136,3 @@ function _stringify(obj, opt = {}) {
     return s;
 }
 exports._stringify = _stringify;
-/**
- * @deprecated renamed to _stringify
- */
-exports._stringifyAny = _stringify;

package/dist-esm/datetime/localDate.js

@@ -339,21 +339,9 @@ export class LocalDate {
         }
         return new LocalDate($year, $month, $day);
     }
-    /**
-     * @deprecated use `minus` instead
-     */
-    subtract(num, unit, mutate = false) {
-        return this.plus(-num, unit, mutate);
-    }
     minus(num, unit, mutate = false) {
         return this.plus(-num, unit, mutate);
     }
-    /**
-     * @deprecated use `plus` instead
-     */
-    add(num, unit, mutate = false) {
-        return this.plus(num, unit, mutate);
-    }
     startOf(unit) {
         if (unit === 'day')
             return this;

package/dist-esm/datetime/localTime.js

@@ -209,21 +209,9 @@ export class LocalTime {
         }
         return this.set(unit, this.get(unit) + num, mutate);
     }
-    /**
-     * @deprecated use `minus` instead
-     */
-    subtract(num, unit, mutate = false) {
-        return this.plus(num * -1, unit, mutate);
-    }
     minus(num, unit, mutate = false) {
         return this.plus(num * -1, unit, mutate);
     }
-    /**
-     * @deprecated use `plus` instead
-     */
-    add(num, unit, mutate = false) {
-        return this.plus(num, unit, mutate);
-    }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
     }

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

@@ -5,6 +5,8 @@ import { _getMethodSignature } from './decorator.util';
 export function _Timeout(opt) {
     return (target, key, descriptor) => {
         _assert(typeof descriptor.value === 'function', '@_Timeout can be applied only to methods');
+        if (!opt.timeout)
+            return descriptor;
         const originalFn = descriptor.value;
         const keyStr = String(key);
         descriptor.value = async function (...args) {

package/dist-esm/promise/pRetry.js

@@ -21,7 +21,6 @@ export async function pRetry(fn, opt = {}) {
     const fname = name || fn.name || 'pRetry function';
     let delay = initialDelay;
     let attempt = 0;
-    /* eslint-disable no-constant-condition */
     while (true) {
         const started = Date.now();
         try {

package/dist-esm/promise/pTimeout.js

@@ -8,6 +8,9 @@ import { _errorDataAppend, TimeoutError } from '../error/error.util';
  */
 export function pTimeoutFn(fn, opt) {
     opt.name || (opt.name = fn.name);
+    if (!opt.timeout) {
+        return fn;
+    }
     return async function pTimeoutInternalFn(...args) {
         return await pTimeout(() => fn.apply(this, args), opt);
     };
@@ -19,6 +22,10 @@ export function pTimeoutFn(fn, opt) {
  * If the Function rejects - passes this rejection further.
  */
 export async function pTimeout(fn, opt) {
+    if (!opt.timeout) {
+        // short-circuit to direct execution if 0 timeout is passed
+        return await fn();
+    }
     const { timeout, name = fn.name || 'pTimeout function', onTimeout } = opt;
     const fakeError = opt.fakeError || new Error('TimeoutError');
     // eslint-disable-next-line no-async-promise-executor

package/dist-esm/string/stringify.js

@@ -131,7 +131,3 @@ export function _stringify(obj, opt = {}) {
     }
     return s;
 }
-/**
- * @deprecated renamed to _stringify
- */
-export const _stringifyAny = _stringify;

package/package.json

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

package/src/datetime/localDate.ts

@@ -415,24 +415,10 @@ export class LocalDate {
     return new LocalDate($year, $month, $day)
   }
 
-  /**
-   * @deprecated use `minus` instead
-   */
-  subtract(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
-    return this.plus(-num, unit, mutate)
-  }
-
   minus(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
     return this.plus(-num, unit, mutate)
   }
 
-  /**
-   * @deprecated use `plus` instead
-   */
-  add(num: number, unit: LocalDateUnit, mutate = false): LocalDate {
-    return this.plus(num, unit, mutate)
-  }
-
   startOf(unit: LocalDateUnitStrict): LocalDate {
     if (unit === 'day') return this
     if (unit === 'month') return LocalDate.create(this.$year, this.$month, 1)

package/src/datetime/localTime.ts

@@ -281,24 +281,10 @@ export class LocalTime {
     return this.set(unit, this.get(unit) + num, mutate)
   }
 
-  /**
-   * @deprecated use `minus` instead
-   */
-  subtract(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
-    return this.plus(num * -1, unit, mutate)
-  }
-
   minus(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
     return this.plus(num * -1, unit, mutate)
   }
 
-  /**
-   * @deprecated use `plus` instead
-   */
-  add(num: number, unit: LocalTimeUnit, mutate = false): LocalTime {
-    return this.plus(num, unit, mutate)
-  }
-
   absDiff(other: LocalTimeInput, unit: LocalTimeUnit): number {
     return Math.abs(this.diff(other, unit))
   }

package/src/decorators/timeout.decorator.ts

@@ -8,6 +8,8 @@ export function _Timeout(opt: PTimeoutOptions): MethodDecorator {
   return (target, key, descriptor) => {
     _assert(typeof descriptor.value === 'function', '@_Timeout can be applied only to methods')
 
+    if (!opt.timeout) return descriptor
+
     const originalFn = descriptor.value
     const keyStr = String(key)
 

package/src/promise/pRetry.ts

@@ -128,7 +128,6 @@ export async function pRetry<T>(
   let delay = initialDelay
   let attempt = 0
 
-  /* eslint-disable no-constant-condition */
   while (true) {
     const started = Date.now()
 

package/src/promise/pTimeout.ts

@@ -5,6 +5,8 @@ import type { AnyAsyncFunction, NumberOfMilliseconds } from '../types'
 export interface PTimeoutOptions {
   /**
    * Timeout in milliseconds.
+   *
+   * If 0 is passed - the function would be executed right away, with no timeout.
    */
   timeout: NumberOfMilliseconds
 
@@ -46,6 +48,10 @@ export interface PTimeoutOptions {
 export function pTimeoutFn<T extends AnyAsyncFunction>(fn: T, opt: PTimeoutOptions): T {
   opt.name ||= fn.name
 
+  if (!opt.timeout) {
+    return fn
+  }
+
   return async function pTimeoutInternalFn(this: any, ...args: any[]) {
     return await pTimeout(() => fn.apply(this, args), opt)
   } as T
@@ -58,6 +64,11 @@ export function pTimeoutFn<T extends AnyAsyncFunction>(fn: T, opt: PTimeoutOptio
  * If the Function rejects - passes this rejection further.
  */
 export async function pTimeout<T>(fn: AnyAsyncFunction<T>, opt: PTimeoutOptions): Promise<T> {
+  if (!opt.timeout) {
+    // short-circuit to direct execution if 0 timeout is passed
+    return await fn()
+  }
+
   const { timeout, name = fn.name || 'pTimeout function', onTimeout } = opt
   const fakeError = opt.fakeError || new Error('TimeoutError')
 

package/src/string/stringify.ts

@@ -184,8 +184,3 @@ export function _stringify(obj: any, opt: StringifyOptions = {}): string {
 
   return s
 }
-
-/**
- * @deprecated renamed to _stringify
- */
-export const _stringifyAny = _stringify