@naturalcycles/js-lib 15.97.0 → 15.98.0

package/dist/error/assert.d.ts

@@ -1,4 +1,4 @@
-import type { Class, UnixTimestamp } from '../types.js';
+import type { Class, NonEmptyArray, UnixTimestamp } from '../types.js';
 import type { BackendErrorResponseObject, ErrorData, ErrorObject } from './error.model.js';
 /**
  * Evaluates the `condition` (casts it to Boolean).
@@ -43,6 +43,12 @@ export declare function _assertIsErrorObject<DATA_TYPE extends ErrorData = Error
 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;
+/**
+ * Asserts that the array has at least one element, narrowing it to NonEmptyArray.
+ * Readonly arrays are narrowed to `Readonly<NonEmptyArray<T>>`.
+ */
+export declare function _assertIsNonEmptyArray<T>(arr: T[], message?: string): asserts arr is NonEmptyArray<T>;
+export declare function _assertIsNonEmptyArray<T>(arr: readonly T[], message?: string): asserts arr is Readonly<NonEmptyArray<T>>;
 export declare function _assertTypeOf<T>(v: any, expectedType: string, message?: string): asserts v is T;
 /**
  * Casts an arbitrary number as UnixTimestamp.

package/dist/error/assert.js

@@ -91,6 +91,11 @@ export function _assertIsString(v, message) {
 export function _assertIsNumber(v, message) {
     _assertTypeOf(v, 'number', message);
 }
+export function _assertIsNonEmptyArray(arr, message) {
+    if (!arr.length) {
+        throw new AssertionError(message || 'Expected non-empty array');
+    }
+}
 export function _assertTypeOf(v, expectedType, message) {
     if (typeof v !== expectedType) {
         const msg = message || `Expected typeof ${expectedType}, actual typeof: ${typeof v}`;

package/package.json

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

package/src/error/assert.ts

@@ -1,6 +1,6 @@
 import { _deepEquals } from '../object/deepEquals.js'
 import { _stringify } from '../string/stringify.js'
-import type { Class, UnixTimestamp } from '../types.js'
+import type { Class, NonEmptyArray, UnixTimestamp } from '../types.js'
 import type { BackendErrorResponseObject, ErrorData, ErrorObject } from './error.model.js'
 import { _isBackendErrorResponseObject, _isErrorObject, AssertionError } from './error.util.js'
 
@@ -134,6 +134,24 @@ export function _assertIsNumber(v: any, message?: string): asserts v is number {
   _assertTypeOf<number>(v, 'number', message)
 }
 
+/**
+ * Asserts that the array has at least one element, narrowing it to NonEmptyArray.
+ * Readonly arrays are narrowed to `Readonly<NonEmptyArray<T>>`.
+ */
+export function _assertIsNonEmptyArray<T>(
+  arr: T[],
+  message?: string,
+): asserts arr is NonEmptyArray<T>
+export function _assertIsNonEmptyArray<T>(
+  arr: readonly T[],
+  message?: string,
+): asserts arr is Readonly<NonEmptyArray<T>>
+export function _assertIsNonEmptyArray(arr: readonly unknown[], message?: string): void {
+  if (!arr.length) {
+    throw new AssertionError(message || 'Expected non-empty array')
+  }
+}
+
 export function _assertTypeOf<T>(v: any, expectedType: string, message?: string): asserts v is T {
   if (typeof v !== expectedType) {
     const msg = message || `Expected typeof ${expectedType}, actual typeof: ${typeof v}`