@naturalcycles/js-lib 15.99.0 → 15.100.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/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/http/fetcher.js

@@ -4,7 +4,7 @@
 import { abortSignalAnyOrUndefined, abortSignalTimeoutOrUndefined } from '../abort.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';
@@ -454,10 +454,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) {

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

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.99.0",
+  "version": "15.100.0",
   "dependencies": {
     "tslib": "^2"
   },
@@ -14,7 +14,7 @@
     }
   },
   "devDependencies": {
-    "@naturalcycles/dev-lib": "0.0.0",
+    "@naturalcycles/dev-lib": "20.70.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/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/http/fetcher.ts

@@ -6,7 +6,7 @@ import type { ReadableStream as WebReadableStream } from 'node:stream/web'
 import { abortSignalAnyOrUndefined, abortSignalTimeoutOrUndefined } from '../abort.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,
@@ -560,10 +560,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

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()!
   }