@naturalcycles/js-lib 15.99.0 → 15.101.0

package/dist/array/array.util.js

@@ -369,8 +369,7 @@ export function _shuffle(array, opt = {}) {
     return a;
 }
 export function _firstLast(array) {
-    if (!array.length)
-        throw new Error('_firstLast called on empty array');
+    _assert(array.length, '_firstLast called on empty array');
     return [array[0], array[array.length - 1]];
 }
 export function _firstLastOrUndefined(array) {
@@ -383,8 +382,7 @@ export function _firstLastOrUndefined(array) {
  * Throws if array is empty.
  */
 export function _last(array) {
-    if (!array.length)
-        throw new Error('_last called on empty array');
+    _assert(array.length, '_last called on empty array');
     return array[array.length - 1];
 }
 /**
@@ -398,8 +396,7 @@ export function _lastOrUndefined(array) {
  * Throws if array is empty.
  */
 export function _first(array) {
-    if (!array.length)
-        throw new Error('_first called on empty array');
+    _assert(array.length, '_first called on empty array');
     return array[0];
 }
 /**
@@ -482,8 +479,7 @@ export function _minBy(array, mapper) {
     return min;
 }
 export function _minMax(array) {
-    if (!array.length)
-        throw new Error('_minMax called on empty array');
+    _assert(array.length, '_minMax called on empty array');
     const result = _minMaxOrUndefined(array);
     _assert(result !== undefined, '_minBy returned undefined');
     return result;
@@ -510,8 +506,7 @@ export function _minMaxOrUndefined(array) {
     return [min, max];
 }
 export function _minMaxBy(array, mapper) {
-    if (!array.length)
-        throw new Error('_minMaxBy called on empty array');
+    _assert(array.length, '_minMaxBy called on empty array');
     const result = _minMaxByOrUndefined(array, mapper);
     _assert(result !== undefined, '_minMaxBy returned undefined');
     return result;

package/dist/array/array2.js

@@ -1,3 +1,4 @@
+import { _assert } from '../error/assert.js';
 import { _shuffle } from './array.util.js';
 /**
  * Better Array.
@@ -16,8 +17,7 @@ export class Array2 extends Array {
         return this[0];
     }
     first() {
-        if (!this.length)
-            throw new Error('Array.first called on empty array');
+        _assert(this.length, 'Array.first called on empty array');
         return this[0];
     }
     lastOrUndefined() {
@@ -25,8 +25,7 @@ export class Array2 extends Array {
     }
     last() {
         const { length } = this;
-        if (!length)
-            throw new Error('Array.last called on empty array');
+        _assert(length, 'Array.last called on empty array');
         return this[length - 1];
     }
     uniq() {

package/dist/asyncManager.js

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from './datetime/localTime.js';
 import { consoleLogger } from './log/commonLogger.js';
 class AsyncManagerImpl {
     logger = consoleLogger;
@@ -24,7 +25,7 @@ class AsyncManagerImpl {
         if (!size)
             return;
         const { logger } = this;
-        const started = Date.now();
+        const started = nowUnixMillis();
         if (timeout) {
             const result = await Promise.race([
                 Promise.allSettled(this.pendingOps),
@@ -38,7 +39,7 @@ class AsyncManagerImpl {
         else {
             await Promise.allSettled(this.pendingOps);
         }
-        logger.log(`AsyncManager.allDone for ${size} op(s) in ${Date.now() - started} ms`);
+        logger.log(`AsyncManager.allDone for ${size} op(s) in ${nowUnixMillis() - started} ms`);
     }
     reset() {
         this.pendingOps.clear();

package/dist/browser/analytics.util.js

@@ -1,3 +1,4 @@
+import { newDate, nowUnixMillis } from '../datetime/localTime.js';
 import { isServerSide } from '../env.js';
 import { loadScript } from './script.util.js';
 /**
@@ -10,7 +11,7 @@ export async function loadGTag(gtagId, enabled = true) {
     globalThis.gtag ||= function gtag() {
         globalThis.dataLayer.push(arguments);
     };
-    globalThis.gtag('js', new Date());
+    globalThis.gtag('js', newDate());
     globalThis.gtag('config', gtagId);
     if (!enabled)
         return;
@@ -21,7 +22,7 @@ export async function loadGTM(gtmId, enabled = true) {
         return;
     globalThis.dataLayer ||= [];
     globalThis.dataLayer.push({
-        'gtm.start': Date.now(),
+        'gtm.start': nowUnixMillis(),
         event: 'gtm.js',
     });
     if (!enabled)

package/dist/datetime/localTime.d.ts

@@ -257,10 +257,14 @@ declare class LocalTimeFactory {
     /**
      Convenience function to return current Unix timestamp in seconds.
      Like Date.now(), but in seconds.
+  
+     Import nowUnix function individually in places where importing localTime is too heavy.
      */
     nowUnix(): UnixTimestamp;
     /**
      Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
+  
+     Import nowUnixMillis function individually in places where importing localTime is too heavy.
      */
     nowUnixMillis(): UnixTimestampMillis;
     /**
@@ -331,4 +335,21 @@ interface LocalTimeFn extends LocalTimeFactory {
     (d: LocalTimeInput): LocalTime;
 }
 export declare const localTime: LocalTimeFn;
+/**
+ * Can be used instead of `oxlint-disable ...` in places where Date is intentionally needed
+ */
+export declare function newDate(): Date;
+/**
+ Convenience function to return current Unix timestamp in seconds.
+ Like Date.now(), but in seconds.
+
+ Import nowUnix function individually in places where importing localTime is too heavy.
+ */
+export declare function nowUnix(): UnixTimestamp;
+/**
+ Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
+
+ Import nowUnixMillis function individually in places where importing localTime is too heavy.
+ */
+export declare function nowUnixMillis(): UnixTimestampMillis;
 export {};

package/dist/datetime/localTime.js

@@ -676,15 +676,19 @@ class LocalTimeFactory {
     /**
      Convenience function to return current Unix timestamp in seconds.
      Like Date.now(), but in seconds.
+  
+     Import nowUnix function individually in places where importing localTime is too heavy.
      */
     nowUnix() {
-        return Math.floor(Date.now() / 1000);
+        return nowUnix();
     }
     /**
      Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
+  
+     Import nowUnixMillis function individually in places where importing localTime is too heavy.
      */
     nowUnixMillis() {
-        return Date.now();
+        return nowUnixMillis();
     }
     /**
      * Create LocalTime from LocalTimeInput.
@@ -1032,3 +1036,26 @@ export const localTime = localTimeFactory.fromInput.bind(localTimeFactory);
 // The line below is the blackest of black magic I have ever written in 2024.
 // And probably 2023 as well.
 Object.setPrototypeOf(localTime, localTimeFactory);
+/**
+ * Can be used instead of `oxlint-disable ...` in places where Date is intentionally needed
+ */
+export function newDate() {
+    return new Date();
+}
+/**
+ Convenience function to return current Unix timestamp in seconds.
+ Like Date.now(), but in seconds.
+
+ Import nowUnix function individually in places where importing localTime is too heavy.
+ */
+export function nowUnix() {
+    return Math.floor(Date.now() / 1000);
+}
+/**
+ Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
+
+ Import nowUnixMillis function individually in places where importing localTime is too heavy.
+ */
+export function nowUnixMillis() {
+    return Date.now();
+}

package/dist/datetime/time.util.js

@@ -8,6 +8,7 @@
  * @experimental
  */
 export function _blockTimer(name) {
+    // oxlint-disable-next-line no-restricted-globals -- localTime imports this module, so it can't import localTime back
     const started = Date.now();
     return {
         [Symbol.dispose]() {
@@ -18,7 +19,9 @@ export function _blockTimer(name) {
 /**
  * Returns time passed since `from` until `until` (default to Date.now())
  */
-export function _since(from, until = Date.now()) {
+export function _since(from, 
+// oxlint-disable-next-line no-restricted-globals -- localTime imports this module, so it can't import localTime back
+until = Date.now()) {
     return _ms(until - from);
 }
 /**

package/dist/decorators/createPromiseDecorator.js

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js';
 import { _getTargetMethodSignature } from './decorator.util.js';
 /**
  * @example
@@ -19,7 +20,7 @@ export function _createPromiseDecorator(cfg, decoratorParams = {}) {
         const methodSignature = _getTargetMethodSignature(target, key);
         pd.value = async function (...args) {
             // console.log(`@${cfg.decoratorName} called inside function`)
-            const started = Date.now();
+            const started = nowUnixMillis();
             try {
                 // Before function
                 // console.log(`@${cfg.decoratorName} Before`)

package/dist/decorators/debounce.js

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js';
 import { _anyToError } from '../error/error.util.js';
 import { pDefer } from '../promise/pDefer.js';
 export function _debounce(func, wait, opt = {}) {
@@ -31,7 +32,7 @@ export function _debounce(func, wait, opt = {}) {
         return leading ? invokeFunc(time) : result;
     }
     function timerExpired() {
-        const time = Date.now();
+        const time = nowUnixMillis();
         if (shouldInvoke(time, state)) {
             trailingEdge(time);
             return;
@@ -58,13 +59,13 @@ export function _debounce(func, wait, opt = {}) {
         lastArgs = lastThis = timerId = undefined;
     }
     function flush() {
-        return timerId === undefined ? result : trailingEdge(Date.now());
+        return timerId === undefined ? result : trailingEdge(nowUnixMillis());
     }
     function pending() {
         return timerId !== undefined;
     }
     function debounced(...args) {
-        const time = Date.now();
+        const time = nowUnixMillis();
         const isInvoking = shouldInvoke(time, state);
         lastArgs = args;
         lastThis = this;
@@ -151,7 +152,7 @@ export function _asyncDebounce(func, wait, opt = {}) {
         return d;
     }
     function timerExpired() {
-        const time = Date.now();
+        const time = nowUnixMillis();
         if (shouldInvoke(time, state)) {
             void trailingEdge(time);
             return;
@@ -195,14 +196,14 @@ export function _asyncDebounce(func, wait, opt = {}) {
         }
         const d = deferred;
         cancelTimer(timerId);
-        await trailingEdge(Date.now());
+        await trailingEdge(nowUnixMillis());
         return d;
     }
     function pending() {
         return timerId !== undefined;
     }
     async function debounced(...args) {
-        const time = Date.now();
+        const time = nowUnixMillis();
         const isInvoking = shouldInvoke(time, state);
         lastArgs = args;
         lastThis = this;

package/dist/decorators/logMethod.decorator.js

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js';
 import { _ms } from '../datetime/time.util.js';
 import { _assert } from '../error/assert.js';
 import { consoleLogger } from '../log/commonLogger.js';
@@ -35,7 +36,7 @@ export function _LogMethod(opt = {}) {
         const sma = avg ? new SimpleMovingAverage(avg) : undefined;
         let count = 0;
         descriptor.value = function (...args) {
-            const started = Date.now();
+            const started = nowUnixMillis();
             const ctx = this;
             // e.g `NameOfYourClass.methodName`
             // or `NameOfYourClass(instanceId).methodName`
@@ -72,7 +73,7 @@ export function _LogMethod(opt = {}) {
 }
 // oxlint-disable-next-line max-params
 function logFinished(logger, callSignature, started, sma, logResultFn, res, err) {
-    const millis = Date.now() - started;
+    const millis = nowUnixMillis() - started;
     const t = ['<<', callSignature, 'took', _ms(millis)];
     if (sma) {
         t.push(`(avg ${_ms(sma.pushGetAvg(millis))})`);

package/dist/enum.util.js

@@ -234,6 +234,7 @@ export function _numberEnumKeyOrUndefined(en, v) {
 export function _numberEnumKey(en, v) {
     const key = en[v];
     // This prevents passing a Key (not a Value) of enum here, which returns unexpected result (number, not string)
+    // oxlint-disable-next-line unicorn/prefer-type-error
     if (typeof key !== 'string')
         throw new Error(`_numberEnumKey not found for: ${v}`);
     return key;

package/dist/error/assert.js

@@ -1,3 +1,5 @@
+// `_assert` and friends are implemented by throwing in an if
+// oxlint-disable nc/prefer-assert
 import { _deepEquals } from '../object/deepEquals.js';
 import { _stringify } from '../string/stringify.js';
 import { _isBackendErrorResponseObject, _isErrorObject, AssertionError } from './error.util.js';

package/dist/error/tryCatch.js

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js';
 import { _since } from '../datetime/time.util.js';
 import { consoleLogger } from '../log/commonLogger.js';
 import { _anyToError } from './error.util.js';
@@ -13,7 +14,7 @@ export function _tryCatch(fn, opt = {}) {
     const { onError, logError = true, logSuccess = false, logger = consoleLogger } = opt;
     const fname = fn.name || 'anonymous';
     return async function (...args) {
-        const started = Date.now();
+        const started = nowUnixMillis();
         try {
             const r = await fn.apply(this, args);
             if (logSuccess) {

package/dist/http/fetcher.js

@@ -2,9 +2,10 @@
 /// <reference lib="dom" preserve="true" />
 /// <reference lib="dom.iterable" preserve="true" />
 import { abortSignalAnyOrUndefined, abortSignalTimeoutOrUndefined } from '../abort.js';
+import { nowUnixMillis } from '../datetime/localTime.js';
 import { _ms, _since } from '../datetime/time.util.js';
 import { isServerSide } from '../env.js';
-import { _assertErrorClassOrRethrow, _assertIsError } from '../error/assert.js';
+import { _assert, _assertErrorClassOrRethrow, _assertIsError } from '../error/assert.js';
 import { _anyToError, _anyToErrorObject, _errorDataAppend, _errorLikeToErrorObject, HttpRequestError, UnexpectedPassError, } from '../error/error.util.js';
 import { consoleLogger } from '../log/commonLogger.js';
 import { _clamp } from '../number/number.util.js';
@@ -184,7 +185,7 @@ export class Fetcher {
                 requestSignature: res.signature,
                 requestName: res.req.requestName,
                 fetcherName: this.cfg.name,
-                requestDuration: Date.now() - res.req.started,
+                requestDuration: nowUnixMillis() - res.req.started,
             });
         }
         const { data } = res.body;
@@ -314,7 +315,7 @@ export class Fetcher {
             signature,
         };
         while (!res.retryStatus.retryStopped) {
-            req.started = Date.now();
+            req.started = nowUnixMillis();
             res.body = undefined;
             req.init.signal = abortSignalAnyOrUndefined([
                 abortSignalTimeoutOrUndefined(timeoutMillis),
@@ -454,10 +455,8 @@ export class Fetcher {
         }
         else if (responseType === 'readableStream') {
             res.body = res.fetchResponse.body;
-            if (res.body === null) {
-                // Error is to be handled upstream
-                throw new Error('fetchResponse.body is null');
-            }
+            // Error is to be handled upstream
+            _assert(res.body !== null, 'fetchResponse.body is null');
         }
         res.retryStatus.retryStopped = true;
         if (req.logResponse) {
@@ -534,7 +533,7 @@ export class Fetcher {
             requestSignature: res.signature,
             requestName: res.req.requestName,
             fetcherName: this.cfg.name,
-            requestDuration: Date.now() - res.req.started,
+            requestDuration: nowUnixMillis() - res.req.started,
         }), {
             cause,
         });
@@ -611,16 +610,17 @@ export class Fetcher {
                     if (retryAfterNumber > 10 ** 9) {
                         // Value is too large to be a "seconds from now" delay,
                         // treat it as a UnixTimestamp instead (e.g GitHub sends `x-ratelimit-reset` like that)
-                        timeout = retryAfterNumber * 1000 - Date.now();
+                        timeout = retryAfterNumber * 1000 - nowUnixMillis();
                     }
                     else {
                         timeout = retryAfterNumber * 1000;
                     }
                 }
                 else {
+                    // oxlint-disable-next-line no-restricted-globals -- parses an HTTP-date, which localTime doesn't support
                     const date = new Date(retryAfterStr);
                     if (!Number.isNaN(date.getTime())) {
-                        timeout = date.getTime() - Date.now();
+                        timeout = date.getTime() - nowUnixMillis();
                     }
                 }
                 this.cfg.logger.log(`retry-after: ${retryAfterStr}`);
@@ -780,7 +780,7 @@ export class Fetcher {
                 'fetchFn',
                 'overrideFetchFn',
             ]),
-            started: Date.now(),
+            started: nowUnixMillis(),
             ..._omit(opt, ['method', 'headers', 'credentials']),
             inputUrl: opt.url || '',
             fullUrl: opt.url || '',

package/dist/object/deepEquals.js

@@ -115,6 +115,7 @@ export function _deepJsonEquals(a, b) {
         a = undefined;
     }
     else if (a && typeof a === 'object') {
+        // oxlint-disable-next-line no-restricted-globals -- Date instances are compared by value
         if (a instanceof Date) {
             ;
             a = a.valueOf();
@@ -132,6 +133,7 @@ export function _deepJsonEquals(a, b) {
         b = undefined;
     }
     else if (b && typeof b === 'object') {
+        // oxlint-disable-next-line no-restricted-globals -- Date instances are compared by value
         if (b instanceof Date) {
             ;
             b = b.valueOf();

package/dist/object/set2.js

@@ -1,3 +1,4 @@
+import { _assert } from '../error/assert.js';
 /**
  * Like Set, but serializes to JSON as an array.
  *
@@ -20,8 +21,7 @@ export class Set2 extends Set {
         return this;
     }
     first() {
-        if (!this.size)
-            throw new Error('Set.first called on empty set');
+        _assert(this.size, 'Set.first called on empty set');
         return this.firstOrUndefined();
     }
     firstOrUndefined() {

package/dist/promise/pGradualQueue.js

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js';
 import { ErrorMode } from '../error/errorMode.js';
 import { createCommonLoggerAtLevel } from '../log/commonLogger.js';
 import { pDefer } from './pDefer.js';
@@ -34,7 +35,7 @@ export class PGradualQueue {
         // Fast-path: warmup complete
         if (this.warmupComplete)
             return this.cfg.concurrency;
-        const elapsed = Date.now() - this.startTime;
+        const elapsed = nowUnixMillis() - this.startTime;
         if (elapsed >= this.warmupMs) {
             this.warmupComplete = true;
             this.logger.debug('warmup complete');
@@ -51,7 +52,7 @@ export class PGradualQueue {
     async push(fn) {
         // Initialize start time on first push
         if (this.startTime === 0) {
-            this.startTime = Date.now();
+            this.startTime = nowUnixMillis();
         }
         const job = { fn, defer: pDefer() };
         const concurrency = this.getCurrentConcurrency();

package/dist/promise/pRetry.js

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js';
 import { _since } from '../datetime/time.util.js';
 import { _errorDataAppend } from '../error/error.util.js';
 import { consoleLogger } from '../log/commonLogger.js';
@@ -26,7 +27,7 @@ export async function pRetry(fn, opt = {}) {
     let delay = initialDelay;
     let attempt = 0;
     while (true) {
-        const started = Date.now();
+        const started = nowUnixMillis();
         try {
             attempt++;
             if ((attempt === 1 && logFirstAttempt) || (attempt > 1 && logRetries)) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.99.0",
+  "version": "15.101.0",
   "dependencies": {
     "tslib": "^2"
   },
@@ -14,7 +14,7 @@
     }
   },
   "devDependencies": {
-    "@naturalcycles/dev-lib": "0.0.0",
+    "@naturalcycles/dev-lib": "20.71.0",
     "@types/node": "^26",
     "@types/semver": "^7",
     "typescript": "^7",

package/src/array/array.util.ts

@@ -435,7 +435,7 @@ export function _shuffle<T>(array: T[], opt: MutateOptions = {}): T[] {
 }
 
 export function _firstLast<T>(array: readonly T[]): [first: T, last: T] {
-  if (!array.length) throw new Error('_firstLast called on empty array')
+  _assert(array.length, '_firstLast called on empty array')
   return [array[0]!, array[array.length - 1]!]
 }
 
@@ -449,7 +449,7 @@ export function _firstLastOrUndefined<T>(array: readonly T[]): [first: T, last:
  * Throws if array is empty.
  */
 export function _last<T>(array: readonly T[]): T {
-  if (!array.length) throw new Error('_last called on empty array')
+  _assert(array.length, '_last called on empty array')
   return array[array.length - 1]!
 }
 
@@ -465,7 +465,7 @@ export function _lastOrUndefined<T>(array: readonly T[]): T | undefined {
  * Throws if array is empty.
  */
 export function _first<T>(array: readonly T[]): T {
-  if (!array.length) throw new Error('_first called on empty array')
+  _assert(array.length, '_first called on empty array')
   return array[0]!
 }
 
@@ -561,7 +561,7 @@ export function _minBy<T>(array: readonly T[], mapper: Mapper<T, number | string
 }
 
 export function _minMax<T>(array: readonly T[]): [min: NonNullable<T>, max: NonNullable<T>] {
-  if (!array.length) throw new Error('_minMax called on empty array')
+  _assert(array.length, '_minMax called on empty array')
   const result = _minMaxOrUndefined(array)
   _assert(result !== undefined, '_minBy returned undefined')
   return result
@@ -592,7 +592,7 @@ export function _minMaxBy<T>(
   array: readonly T[],
   mapper: Mapper<T, number | string | undefined>,
 ): [min: NonNullable<T>, max: NonNullable<T>] {
-  if (!array.length) throw new Error('_minMaxBy called on empty array')
+  _assert(array.length, '_minMaxBy called on empty array')
   const result = _minMaxByOrUndefined(array, mapper)
   _assert(result !== undefined, '_minMaxBy returned undefined')
   return result

package/src/array/array2.ts

@@ -1,3 +1,4 @@
+import { _assert } from '../error/assert.js'
 import { _shuffle } from './array.util.js'
 
 /**
@@ -20,7 +21,7 @@ export class Array2<T> extends Array<T> {
   }
 
   first(): T {
-    if (!this.length) throw new Error('Array.first called on empty array')
+    _assert(this.length, 'Array.first called on empty array')
     return this[0]!
   }
 
@@ -30,7 +31,7 @@ export class Array2<T> extends Array<T> {
 
   last(): T {
     const { length } = this
-    if (!length) throw new Error('Array.last called on empty array')
+    _assert(length, 'Array.last called on empty array')
     return this[length - 1]!
   }
 

package/src/asyncManager.ts

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from './datetime/localTime.js'
 import { consoleLogger } from './log/commonLogger.js'
 import type { CommonLogger } from './log/commonLogger.js'
 import type { NumberOfMilliseconds } from './types.js'
@@ -32,7 +33,7 @@ class AsyncManagerImpl {
     if (!size) return
     const { logger } = this
 
-    const started = Date.now()
+    const started = nowUnixMillis()
     if (timeout) {
       const result = await Promise.race([
         Promise.allSettled(this.pendingOps),
@@ -47,7 +48,7 @@ class AsyncManagerImpl {
     } else {
       await Promise.allSettled(this.pendingOps)
     }
-    logger.log(`AsyncManager.allDone for ${size} op(s) in ${Date.now() - started} ms`)
+    logger.log(`AsyncManager.allDone for ${size} op(s) in ${nowUnixMillis() - started} ms`)
   }
 
   reset(): void {

package/src/browser/analytics.util.ts

@@ -1,3 +1,4 @@
+import { newDate, nowUnixMillis } from '../datetime/localTime.js'
 import { isServerSide } from '../env.js'
 import { loadScript } from './script.util.js'
 
@@ -17,7 +18,7 @@ export async function loadGTag(gtagId: string, enabled = true): Promise<void> {
   globalThis.gtag ||= function gtag() {
     globalThis.dataLayer.push(arguments)
   }
-  globalThis.gtag('js', new Date())
+  globalThis.gtag('js', newDate())
   globalThis.gtag('config', gtagId)
 
   if (!enabled) return
@@ -30,7 +31,7 @@ export async function loadGTM(gtmId: string, enabled = true): Promise<void> {
 
   globalThis.dataLayer ||= []
   globalThis.dataLayer.push({
-    'gtm.start': Date.now(),
+    'gtm.start': nowUnixMillis(),
     event: 'gtm.js',
   })
 

package/src/datetime/localDate.ts

@@ -14,6 +14,8 @@ import type {
 import type { DateObject, ISODayOfWeek, LocalTime } from './localTime.js'
 import { localTime, VALID_DAYS_OF_WEEK } from './localTime.js'
 
+// oxlint-disable no-restricted-globals -- LocalDate wraps the native Date
+
 export type LocalDateUnit = LocalDateUnitStrict | 'week'
 export type LocalDateUnitStrict = 'year' | 'month' | 'day'
 

package/src/datetime/localTime.ts

@@ -21,6 +21,8 @@ import { _ms } from './time.util.js'
 // oxlint-disable-next-line import/no-cycle -- intentional cycle
 import { WallTime } from './wallTime.js'
 
+// oxlint-disable no-restricted-globals -- LocalTime wraps the native Date
+
 export type LocalTimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second'
 
 export enum ISODayOfWeek {
@@ -814,16 +816,20 @@ class LocalTimeFactory {
   /**
    Convenience function to return current Unix timestamp in seconds.
    Like Date.now(), but in seconds.
+
+   Import nowUnix function individually in places where importing localTime is too heavy.
    */
   nowUnix(): UnixTimestamp {
-    return Math.floor(Date.now() / 1000) as UnixTimestamp
+    return nowUnix()
   }
 
   /**
    Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
+
+   Import nowUnixMillis function individually in places where importing localTime is too heavy.
    */
   nowUnixMillis(): UnixTimestampMillis {
-    return Date.now() as UnixTimestampMillis
+    return nowUnixMillis()
   }
 
   /**
@@ -1213,3 +1219,29 @@ export const localTime = localTimeFactory.fromInput.bind(localTimeFactory) as Lo
 // The line below is the blackest of black magic I have ever written in 2024.
 // And probably 2023 as well.
 Object.setPrototypeOf(localTime, localTimeFactory)
+
+/**
+ * Can be used instead of `oxlint-disable ...` in places where Date is intentionally needed
+ */
+export function newDate(): Date {
+  return new Date()
+}
+
+/**
+ Convenience function to return current Unix timestamp in seconds.
+ Like Date.now(), but in seconds.
+
+ Import nowUnix function individually in places where importing localTime is too heavy.
+ */
+export function nowUnix(): UnixTimestamp {
+  return Math.floor(Date.now() / 1000) as UnixTimestamp
+}
+
+/**
+ Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
+
+ Import nowUnixMillis function individually in places where importing localTime is too heavy.
+ */
+export function nowUnixMillis(): UnixTimestampMillis {
+  return Date.now() as UnixTimestampMillis
+}

package/src/datetime/time.util.ts

@@ -10,6 +10,7 @@ import type { NumberOfMilliseconds, UnixTimestampMillis } from '../types.js'
  * @experimental
  */
 export function _blockTimer(name?: string): Disposable {
+  // oxlint-disable-next-line no-restricted-globals -- localTime imports this module, so it can't import localTime back
   const started = Date.now() as UnixTimestampMillis
   return {
     [Symbol.dispose](): void {
@@ -23,6 +24,7 @@ export function _blockTimer(name?: string): Disposable {
  */
 export function _since(
   from: UnixTimestampMillis,
+  // oxlint-disable-next-line no-restricted-globals -- localTime imports this module, so it can't import localTime back
   until: UnixTimestampMillis = Date.now() as UnixTimestampMillis,
 ): string {
   return _ms(until - from)

package/src/decorators/createPromiseDecorator.ts

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js'
 import { _getTargetMethodSignature } from './decorator.util.js'
 
 export interface PromiseDecoratorCfg<RES = any, PARAMS = any> {
@@ -72,7 +73,7 @@ export function _createPromiseDecorator<RES = any, PARAMS = any>(
 
     pd.value = async function (this: typeof target, ...args: any[]): Promise<any> {
       // console.log(`@${cfg.decoratorName} called inside function`)
-      const started = Date.now()
+      const started = nowUnixMillis()
 
       try {
         // Before function

package/src/decorators/debounce.ts

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js'
 import { _anyToError } from '../error/error.util.js'
 import { pDefer } from '../promise/pDefer.js'
 import type { DeferredPromise } from '../promise/pDefer.js'
@@ -43,7 +44,7 @@ export function _debounce<T extends AnyFunction>(
   }
 
   function timerExpired(): void {
-    const time = Date.now()
+    const time = nowUnixMillis()
     if (shouldInvoke(time, state)) {
       trailingEdge(time)
       return
@@ -74,7 +75,7 @@ export function _debounce<T extends AnyFunction>(
   }
 
   function flush(): ReturnType<T> {
-    return timerId === undefined ? result : trailingEdge(Date.now())
+    return timerId === undefined ? result : trailingEdge(nowUnixMillis())
   }
 
   function pending(): boolean {
@@ -82,7 +83,7 @@ export function _debounce<T extends AnyFunction>(
   }
 
   function debounced(this: ThisParameterType<T>, ...args: Parameters<T>): ReturnType<T> {
-    const time = Date.now()
+    const time = nowUnixMillis()
     const isInvoking = shouldInvoke(time, state)
 
     lastArgs = args
@@ -189,7 +190,7 @@ export function _asyncDebounce<T extends AnyAsyncFunction>(
   }
 
   function timerExpired(): void {
-    const time = Date.now()
+    const time = nowUnixMillis()
     if (shouldInvoke(time, state)) {
       void trailingEdge(time)
       return
@@ -237,7 +238,7 @@ export function _asyncDebounce<T extends AnyAsyncFunction>(
     }
     const d = deferred
     cancelTimer(timerId)
-    await trailingEdge(Date.now())
+    await trailingEdge(nowUnixMillis())
     return d
   }
 
@@ -249,7 +250,7 @@ export function _asyncDebounce<T extends AnyAsyncFunction>(
     this: ThisParameterType<T>,
     ...args: Parameters<T>
   ): Promise<Awaited<ReturnType<T>> | undefined> {
-    const time = Date.now()
+    const time = nowUnixMillis()
     const isInvoking = shouldInvoke(time, state)
 
     lastArgs = args

package/src/decorators/logMethod.decorator.ts

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js'
 import { _ms } from '../datetime/time.util.js'
 import { _assert } from '../error/assert.js'
 import { consoleLogger } from '../log/commonLogger.js'
@@ -100,7 +101,7 @@ export function _LogMethod(opt: LogMethodOptions = {}): MethodDecorator {
     let count = 0
 
     descriptor.value = function (this: typeof _target, ...args: any[]) {
-      const started = Date.now()
+      const started = nowUnixMillis()
       const ctx = this
 
       // e.g `NameOfYourClass.methodName`
@@ -148,7 +149,7 @@ function logFinished(
   res?: any,
   err?: any,
 ): void {
-  const millis = Date.now() - started
+  const millis = nowUnixMillis() - started
 
   const t = ['<<', callSignature, 'took', _ms(millis)]
 

package/src/enum.util.ts

@@ -284,6 +284,7 @@ export function _numberEnumKey<T extends NumberEnum>(
 ): keyof T {
   const key = (en as any)[v]
   // This prevents passing a Key (not a Value) of enum here, which returns unexpected result (number, not string)
+  // oxlint-disable-next-line unicorn/prefer-type-error
   if (typeof key !== 'string') throw new Error(`_numberEnumKey not found for: ${v}`)
   return key
 }

package/src/error/assert.ts

@@ -1,3 +1,5 @@
+// `_assert` and friends are implemented by throwing in an if
+// oxlint-disable nc/prefer-assert
 import { _deepEquals } from '../object/deepEquals.js'
 import { _stringify } from '../string/stringify.js'
 import type { Class, NonEmptyArray, UnixTimestamp } from '../types.js'

package/src/error/tryCatch.ts

@@ -1,7 +1,8 @@
+import { nowUnixMillis } from '../datetime/localTime.js'
 import { _since } from '../datetime/time.util.js'
 import { consoleLogger } from '../log/commonLogger.js'
 import type { CommonLogger } from '../log/commonLogger.js'
-import type { AnyFunction, UnixTimestampMillis } from '../types.js'
+import type { AnyFunction } from '../types.js'
 import { _anyToError } from './error.util.js'
 
 export interface TryCatchOptions {
@@ -41,7 +42,7 @@ export function _tryCatch<T extends AnyFunction>(fn: T, opt: TryCatchOptions = {
   const fname = fn.name || 'anonymous'
 
   return async function (this: any, ...args: any[]) {
-    const started = Date.now() as UnixTimestampMillis
+    const started = nowUnixMillis()
 
     try {
       const r = await fn.apply(this, args)

package/src/http/fetcher.ts

@@ -4,9 +4,10 @@
 
 import type { ReadableStream as WebReadableStream } from 'node:stream/web'
 import { abortSignalAnyOrUndefined, abortSignalTimeoutOrUndefined } from '../abort.js'
+import { nowUnixMillis } from '../datetime/localTime.js'
 import { _ms, _since } from '../datetime/time.util.js'
 import { isServerSide } from '../env.js'
-import { _assertErrorClassOrRethrow, _assertIsError } from '../error/assert.js'
+import { _assert, _assertErrorClassOrRethrow, _assertIsError } from '../error/assert.js'
 import type { ErrorLike, ErrorObject } from '../error/error.model.js'
 import {
   _anyToError,
@@ -31,12 +32,7 @@ import { pDelaySignal } from '../promise/pDelay.js'
 import { pTimeout } from '../promise/pTimeout.js'
 import { _toUrlOrNull } from '../string/index.js'
 import { _jsonParse, _jsonParseIfPossible } from '../string/json.util.js'
-import type {
-  AnyObject,
-  ErrorDataTuple,
-  NumberOfMilliseconds,
-  UnixTimestampMillis,
-} from '../types.js'
+import type { AnyObject, ErrorDataTuple, NumberOfMilliseconds } from '../types.js'
 import type {
   FetcherAfterResponseHook,
   FetcherBeforeRequestHook,
@@ -250,7 +246,7 @@ export class Fetcher {
         requestSignature: res.signature,
         requestName: res.req.requestName,
         fetcherName: this.cfg.name,
-        requestDuration: Date.now() - res.req.started,
+        requestDuration: nowUnixMillis() - res.req.started,
       })
     }
 
@@ -400,7 +396,7 @@ export class Fetcher {
     } as FetcherResponse<any>
 
     while (!res.retryStatus.retryStopped) {
-      req.started = Date.now() as UnixTimestampMillis
+      req.started = nowUnixMillis()
       res.body = undefined
 
       req.init.signal = abortSignalAnyOrUndefined([
@@ -560,10 +556,8 @@ export class Fetcher {
     } else if (responseType === 'readableStream') {
       res.body = res.fetchResponse.body
 
-      if (res.body === null) {
-        // Error is to be handled upstream
-        throw new Error('fetchResponse.body is null')
-      }
+      // Error is to be handled upstream
+      _assert(res.body !== null, 'fetchResponse.body is null')
     }
 
     res.retryStatus.retryStopped = true
@@ -655,7 +649,7 @@ export class Fetcher {
         requestSignature: res.signature,
         requestName: res.req.requestName,
         fetcherName: this.cfg.name,
-        requestDuration: Date.now() - res.req.started,
+        requestDuration: nowUnixMillis() - res.req.started,
       }),
       {
         cause,
@@ -748,14 +742,15 @@ export class Fetcher {
           if (retryAfterNumber > 10 ** 9) {
             // Value is too large to be a "seconds from now" delay,
             // treat it as a UnixTimestamp instead (e.g GitHub sends `x-ratelimit-reset` like that)
-            timeout = retryAfterNumber * 1000 - Date.now()
+            timeout = retryAfterNumber * 1000 - nowUnixMillis()
           } else {
             timeout = retryAfterNumber * 1000
           }
         } else {
+          // oxlint-disable-next-line no-restricted-globals -- parses an HTTP-date, which localTime doesn't support
           const date = new Date(retryAfterStr)
           if (!Number.isNaN(date.getTime())) {
-            timeout = date.getTime() - Date.now()
+            timeout = date.getTime() - nowUnixMillis()
           }
         }
 
@@ -930,7 +925,7 @@ export class Fetcher {
         'fetchFn',
         'overrideFetchFn',
       ]),
-      started: Date.now() as UnixTimestampMillis,
+      started: nowUnixMillis(),
       ..._omit(opt, ['method', 'headers', 'credentials']),
       inputUrl: opt.url || '',
       fullUrl: opt.url || '',

package/src/object/deepEquals.ts

@@ -112,6 +112,7 @@ export function _deepJsonEquals<T>(a: T, b: T): boolean {
   } else if (typeof a === 'function') {
     ;(a as any) = undefined
   } else if (a && typeof a === 'object') {
+    // oxlint-disable-next-line no-restricted-globals -- Date instances are compared by value
     if (a instanceof Date) {
       ;(a as any) = a.valueOf()
     } else if ('toJSON' in a) {
@@ -123,6 +124,7 @@ export function _deepJsonEquals<T>(a: T, b: T): boolean {
   } else if (typeof b === 'function') {
     ;(b as any) = undefined
   } else if (b && typeof b === 'object') {
+    // oxlint-disable-next-line no-restricted-globals -- Date instances are compared by value
     if (b instanceof Date) {
       ;(b as any) = b.valueOf()
     } else if ('toJSON' in b) {

package/src/object/set2.ts

@@ -1,3 +1,5 @@
+import { _assert } from '../error/assert.js'
+
 /**
  * Like Set, but serializes to JSON as an array.
  *
@@ -22,7 +24,7 @@ export class Set2<T = any> extends Set<T> {
   }
 
   first(): T {
-    if (!this.size) throw new Error('Set.first called on empty set')
+    _assert(this.size, 'Set.first called on empty set')
     return this.firstOrUndefined()!
   }
 

package/src/promise/pGradualQueue.ts

@@ -1,3 +1,4 @@
+import { nowUnixMillis } from '../datetime/localTime.js'
 import { ErrorMode } from '../error/errorMode.js'
 import { createCommonLoggerAtLevel } from '../log/commonLogger.js'
 import type { CommonLogger, CommonLogLevel } from '../log/commonLogger.js'
@@ -73,7 +74,7 @@ export class PGradualQueue {
     // Fast-path: warmup complete
     if (this.warmupComplete) return this.cfg.concurrency
 
-    const elapsed = Date.now() - this.startTime
+    const elapsed = nowUnixMillis() - this.startTime
     if (elapsed >= this.warmupMs) {
       this.warmupComplete = true
       this.logger.debug('warmup complete')
@@ -92,7 +93,7 @@ export class PGradualQueue {
   async push<R>(fn: AsyncFunction<R>): Promise<R> {
     // Initialize start time on first push
     if (this.startTime === 0) {
-      this.startTime = Date.now()
+      this.startTime = nowUnixMillis()
     }
 
     const job: PGradualQueueJob<R> = { fn, defer: pDefer<R>() }

package/src/promise/pRetry.ts

@@ -1,9 +1,10 @@
+import { nowUnixMillis } from '../datetime/localTime.js'
 import { _since } from '../datetime/time.util.js'
 import type { ErrorData } from '../error/error.model.js'
 import { _errorDataAppend } from '../error/error.util.js'
 import { consoleLogger } from '../log/commonLogger.js'
 import type { CommonLogger } from '../log/commonLogger.js'
-import type { AnyAsyncFunction, UnixTimestampMillis } from '../types.js'
+import type { AnyAsyncFunction } from '../types.js'
 import { pDelay } from './pDelay.js'
 import { pTimeout } from './pTimeout.js'
 
@@ -141,7 +142,7 @@ export async function pRetry<T>(
   let attempt = 0
 
   while (true) {
-    const started = Date.now() as UnixTimestampMillis
+    const started = nowUnixMillis()
 
     try {
       attempt++