@naturalcycles/js-lib 14.227.0 → 14.229.0

package/dist/datetime/localDate.d.ts

@@ -145,3 +145,7 @@ export declare function localDateOrUndefined(d?: LocalDateInput | null): LocalDa
  * Creates a LocalDate from the input, unless it's falsy - then returns LocalDate.today.
  */
 export declare function localDateOrToday(d?: LocalDateInput | null): LocalDate;
+/**
+ Convenience function to return current today's IsoDateString representation, e.g `2024-06-21`
+ */
+export declare function todayIsoDateString(): IsoDateString;

package/dist/datetime/localDate.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localDateOrToday = exports.localDateOrUndefined = exports.localDateToday = exports.localDate = exports.localDateRangeIterable = exports.localDateRange = exports.LocalDate = void 0;
+exports.todayIsoDateString = exports.localDateOrToday = exports.localDateOrUndefined = exports.localDateToday = exports.localDate = exports.localDateRangeIterable = exports.localDateRange = exports.LocalDate = void 0;
 const assert_1 = require("../error/assert");
 const iterable2_1 = require("../iter/iterable2");
 const localTime_1 = require("./localTime");
@@ -496,3 +496,11 @@ function localDateOrToday(d) {
     return d ? LocalDate.of(d) : LocalDate.today();
 }
 exports.localDateOrToday = localDateOrToday;
+/**
+ Convenience function to return current today's IsoDateString representation, e.g `2024-06-21`
+ */
+function todayIsoDateString() {
+    // It was benchmarked to be faster than by concatenating individual Date components
+    return new Date().toISOString().slice(0, 10);
+}
+exports.todayIsoDateString = todayIsoDateString;

package/dist/datetime/localTime.js

@@ -443,25 +443,8 @@ class LocalTime {
         return localDate_1.LocalDate.fromDate(this.$date);
     }
     toPretty(seconds = true) {
-        const { year, month, day, hour, minute, second } = this.components();
-        return ([
-            String(year).padStart(4, '0'),
-            String(month).padStart(2, '0'),
-            String(day).padStart(2, '0'),
-        ].join('-') +
-            ' ' +
-            [
-                String(hour).padStart(2, '0'),
-                String(minute).padStart(2, '0'),
-                seconds && String(second).padStart(2, '0'),
-            ]
-                .filter(Boolean)
-                .join(':'));
-        // return this.$date
-        //   .toISOString()
-        //   .slice(0, seconds ? 19 : 16)
-        //   .split('T')
-        //   .join(' ')
+        const s = this.$date.toISOString();
+        return s.slice(0, 10) + ' ' + s.slice(11, seconds ? 19 : 16);
     }
     /**
      * Returns e.g: `1984-06-21T17:56:21`
@@ -473,27 +456,13 @@ class LocalTime {
      * Returns e.g: `1984-06-21`, only the date part of DateTime
      */
     toISODate() {
-        const { year, month, day } = this.components();
-        return [
-            String(year).padStart(4, '0'),
-            String(month).padStart(2, '0'),
-            String(day).padStart(2, '0'),
-        ].join('-');
-        // return this.$date.toISOString().slice(0, 10)
+        return this.$date.toISOString().slice(0, 10);
     }
     /**
      * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
      */
     toISOTime(seconds = true) {
-        // return this.$date.toISOString().slice(11, seconds ? 19 : 16)
-        const { hour, minute, second } = this.components();
-        return [
-            String(hour).padStart(2, '0'),
-            String(minute).padStart(2, '0'),
-            seconds && String(second).padStart(2, '0'),
-        ]
-            .filter(Boolean)
-            .join(':');
+        return this.$date.toISOString().slice(11, seconds ? 19 : 16);
     }
     /**
      * Returns e.g: `19840621_1705`

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/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-esm/datetime/localDate.js

@@ -486,3 +486,10 @@ export function localDateOrUndefined(d) {
 export function localDateOrToday(d) {
     return d ? LocalDate.of(d) : LocalDate.today();
 }
+/**
+ Convenience function to return current today's IsoDateString representation, e.g `2024-06-21`
+ */
+export function todayIsoDateString() {
+    // It was benchmarked to be faster than by concatenating individual Date components
+    return new Date().toISOString().slice(0, 10);
+}

package/dist-esm/datetime/localTime.js

@@ -441,25 +441,8 @@ export class LocalTime {
         return LocalDate.fromDate(this.$date);
     }
     toPretty(seconds = true) {
-        const { year, month, day, hour, minute, second } = this.components();
-        return ([
-            String(year).padStart(4, '0'),
-            String(month).padStart(2, '0'),
-            String(day).padStart(2, '0'),
-        ].join('-') +
-            ' ' +
-            [
-                String(hour).padStart(2, '0'),
-                String(minute).padStart(2, '0'),
-                seconds && String(second).padStart(2, '0'),
-            ]
-                .filter(Boolean)
-                .join(':'));
-        // return this.$date
-        //   .toISOString()
-        //   .slice(0, seconds ? 19 : 16)
-        //   .split('T')
-        //   .join(' ')
+        const s = this.$date.toISOString();
+        return s.slice(0, 10) + ' ' + s.slice(11, seconds ? 19 : 16);
     }
     /**
      * Returns e.g: `1984-06-21T17:56:21`
@@ -471,27 +454,13 @@ export class LocalTime {
      * Returns e.g: `1984-06-21`, only the date part of DateTime
      */
     toISODate() {
-        const { year, month, day } = this.components();
-        return [
-            String(year).padStart(4, '0'),
-            String(month).padStart(2, '0'),
-            String(day).padStart(2, '0'),
-        ].join('-');
-        // return this.$date.toISOString().slice(0, 10)
+        return this.$date.toISOString().slice(0, 10);
     }
     /**
      * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
      */
     toISOTime(seconds = true) {
-        // return this.$date.toISOString().slice(11, seconds ? 19 : 16)
-        const { hour, minute, second } = this.components();
-        return [
-            String(hour).padStart(2, '0'),
-            String(minute).padStart(2, '0'),
-            seconds && String(second).padStart(2, '0'),
-        ]
-            .filter(Boolean)
-            .join(':');
+        return this.$date.toISOString().slice(11, seconds ? 19 : 16);
     }
     /**
      * Returns e.g: `19840621_1705`

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/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/package.json

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

package/src/datetime/localDate.ts

@@ -602,3 +602,11 @@ export function localDateOrUndefined(d?: LocalDateInput | null): LocalDate | und
 export function localDateOrToday(d?: LocalDateInput | null): LocalDate {
   return d ? LocalDate.of(d) : LocalDate.today()
 }
+
+/**
+ Convenience function to return current today's IsoDateString representation, e.g `2024-06-21`
+ */
+export function todayIsoDateString(): IsoDateString {
+  // It was benchmarked to be faster than by concatenating individual Date components
+  return new Date().toISOString().slice(0, 10)
+}

package/src/datetime/localTime.ts

@@ -541,29 +541,8 @@ export class LocalTime {
   }
 
   toPretty(seconds = true): IsoDateTimeString {
-    const { year, month, day, hour, minute, second } = this.components()
-
-    return (
-      [
-        String(year).padStart(4, '0'),
-        String(month).padStart(2, '0'),
-        String(day).padStart(2, '0'),
-      ].join('-') +
-      ' ' +
-      [
-        String(hour).padStart(2, '0'),
-        String(minute).padStart(2, '0'),
-        seconds && String(second).padStart(2, '0'),
-      ]
-        .filter(Boolean)
-        .join(':')
-    )
-
-    // return this.$date
-    //   .toISOString()
-    //   .slice(0, seconds ? 19 : 16)
-    //   .split('T')
-    //   .join(' ')
+    const s = this.$date.toISOString()
+    return s.slice(0, 10) + ' ' + s.slice(11, seconds ? 19 : 16)
   }
 
   /**
@@ -577,31 +556,14 @@ export class LocalTime {
    * Returns e.g: `1984-06-21`, only the date part of DateTime
    */
   toISODate(): IsoDateString {
-    const { year, month, day } = this.components()
-
-    return [
-      String(year).padStart(4, '0'),
-      String(month).padStart(2, '0'),
-      String(day).padStart(2, '0'),
-    ].join('-')
-
-    // return this.$date.toISOString().slice(0, 10)
+    return this.$date.toISOString().slice(0, 10)
   }
 
   /**
    * Returns e.g: `17:03:15` (or `17:03` with seconds=false)
    */
   toISOTime(seconds = true): string {
-    // return this.$date.toISOString().slice(11, seconds ? 19 : 16)
-    const { hour, minute, second } = this.components()
-
-    return [
-      String(hour).padStart(2, '0'),
-      String(minute).padStart(2, '0'),
-      seconds && String(second).padStart(2, '0'),
-    ]
-      .filter(Boolean)
-      .join(':')
+    return this.$date.toISOString().slice(11, seconds ? 19 : 16)
   }
 
   /**

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/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')