@naturalcycles/js-lib 14.210.0 → 14.212.0

package/dist/array/array.util.d.ts

@@ -176,6 +176,11 @@ export declare function _last<T>(array: T[]): T;
  * Returns last item of the array (or undefined if array is empty).
  */
 export declare function _lastOrUndefined<T>(array: T[]): T | undefined;
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+export declare function _first<T>(array: T[]): T;
 export declare function _minOrUndefined<T>(array: T[]): NonNullable<T> | undefined;
 /**
  * Filters out nullish values (undefined and null).

package/dist/array/array.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._zip = exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersectsWith = exports._intersection = exports._countBy = exports._count = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._mapBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
+exports._zip = exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._first = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersectsWith = exports._intersection = exports._countBy = exports._count = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._mapBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
 const is_util_1 = require("../is.util");
 const types_1 = require("../types");
 /**
@@ -333,6 +333,16 @@ function _lastOrUndefined(array) {
     return array[array.length - 1];
 }
 exports._lastOrUndefined = _lastOrUndefined;
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+function _first(array) {
+    if (!array.length)
+        throw new Error('_first called on empty array');
+    return array[0];
+}
+exports._first = _first;
 function _minOrUndefined(array) {
     const a = array.filter(is_util_1._isNotNullish);
     if (!a.length)

package/dist/http/fetcher.js

@@ -26,7 +26,7 @@ const acceptByResponseType = {
 const defRetryOptions = {
     count: 2,
     timeout: 1000,
-    timeoutMax: 30000,
+    timeoutMax: 30_000,
     timeoutMultiplier: 2,
 };
 /**

package/dist/json-schema/jsonSchemaBuilder.d.ts

@@ -24,7 +24,7 @@ export declare const jsonSchema: {
     dateString(): JsonSchemaStringBuilder;
     object<T_4 extends AnyObject>(props: { [k in keyof T_4]: JsonSchemaAnyBuilder<T_4[k], JsonSchema<T_4[k]>>; }): JsonSchemaObjectBuilder<T_4>;
     rootObject<T_5 extends AnyObject>(props: { [k_1 in keyof T_5]: JsonSchemaAnyBuilder<T_5[k_1], JsonSchema<T_5[k_1]>>; }): JsonSchemaObjectBuilder<T_5>;
-    array<ITEM = unknown>(itemSchema: JsonSchemaAnyBuilder<ITEM, JsonSchema<ITEM>>): JsonSchemaArrayBuilder<ITEM>;
+    array<ITEM = unknown>(itemSchema: JsonSchemaAnyBuilder<ITEM>): JsonSchemaArrayBuilder<ITEM>;
     tuple<T_6 extends any[] = unknown[]>(items: JsonSchemaAnyBuilder[]): JsonSchemaTupleBuilder<T_6>;
     oneOf<T_7 = unknown>(items: JsonSchemaAnyBuilder[]): JsonSchemaAnyBuilder<T_7, JsonSchemaOneOf<T_7>>;
     allOf<T_8 = unknown>(items: JsonSchemaAnyBuilder[]): JsonSchemaAnyBuilder<T_8, JsonSchemaAllOf<T_8>>;

package/dist/object/object.util.js

@@ -329,7 +329,6 @@ function _set(obj, path, value) {
             a[c]
         : // No: create the key. Is the next key a potential array-index?
             (a[c] =
-                // @ts-expect-error
                 // eslint-disable-next-line
                 Math.abs(path[i + 1]) >> 0 === +path[i + 1]
                     ? [] // Yes: assign a new array object

package/dist/string/stringify.js

@@ -123,7 +123,7 @@ function _stringify(obj, opt = {}) {
     if (s === undefined)
         return 'undefined';
     // Handle maxLen
-    const { maxLen = 10000 } = opt;
+    const { maxLen = 10_000 } = opt;
     if (maxLen && s.length > maxLen) {
         s = s.slice(0, maxLen) + `... ${Math.ceil(s.length / 1024)} KB message truncated`;
     }

package/dist/types.d.ts

@@ -177,6 +177,16 @@ export type NumberOfMilliseconds = number;
  * Same as `number`, but with semantic meaning that it's an Integer.
  */
 export type Integer = number;
+/**
+ * Convenience type alias, that allows to write this:
+ *
+ * data: NullableNumber[]
+ *
+ * instead of this:
+ *
+ * data: (number | null)[]
+ */
+export type NullableNumber = number | null;
 /**
  * Used as a compact representation of truthy value.
  * undefined ('' or other short falsy value) should be used as falsy value.

package/dist-esm/array/array.util.js

@@ -304,6 +304,15 @@ export function _last(array) {
 export function _lastOrUndefined(array) {
     return array[array.length - 1];
 }
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+export function _first(array) {
+    if (!array.length)
+        throw new Error('_first called on empty array');
+    return array[0];
+}
 export function _minOrUndefined(array) {
     const a = array.filter(_isNotNullish);
     if (!a.length)

package/dist-esm/object/object.util.js

@@ -306,7 +306,6 @@ export function _set(obj, path, value) {
             a[c]
         : // No: create the key. Is the next key a potential array-index?
             (a[c] =
-                // @ts-expect-error
                 // eslint-disable-next-line
                 Math.abs(path[i + 1]) >> 0 === +path[i + 1]
                     ? [] // Yes: assign a new array object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.210.0",
+  "version": "14.212.0",
   "scripts": {
     "prepare": "husky",
     "build-prod": "build-prod-esm-cjs",
@@ -13,7 +13,7 @@
     "zod": "^3.20.2"
   },
   "devDependencies": {
-    "@naturalcycles/bench-lib": "^1.5.0",
+    "@naturalcycles/bench-lib": "^2.0.0",
     "@naturalcycles/dev-lib": "^13.0.1",
     "@naturalcycles/nodejs-lib": "^13.0.1",
     "@naturalcycles/time-lib": "^3.5.1",

package/src/array/array.util.ts

@@ -365,6 +365,15 @@ export function _lastOrUndefined<T>(array: T[]): T | undefined {
   return array[array.length - 1]
 }
 
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+export function _first<T>(array: T[]): T {
+  if (!array.length) throw new Error('_first called on empty array')
+  return array[0]!
+}
+
 export function _minOrUndefined<T>(array: T[]): NonNullable<T> | undefined {
   const a = array.filter(_isNotNullish)
   if (!a.length) return

package/src/array/range.ts

@@ -39,7 +39,7 @@ export function _rangeIterable(fromIncl: number, toExcl?: number, step = 1): Ite
 
   return Iterable2.of({
     *[Symbol.iterator]() {
-      for (let i = fromIncl; i < toExcl!; i += step) {
+      for (let i = fromIncl; i < toExcl; i += step) {
         yield i
       }
     },
@@ -67,7 +67,7 @@ export function _rangeAsyncIterable(
 
   return AsyncIterable2.of({
     async *[Symbol.asyncIterator]() {
-      for (let i = fromIncl; i < toExcl!; i += step) {
+      for (let i = fromIncl; i < toExcl; i += step) {
         yield i
       }
     },

package/src/object/object.util.ts

@@ -360,7 +360,6 @@ export function _set<T extends AnyObject>(obj: T, path: PropertyPath, value: any
           a[c]
         : // No: create the key. Is the next key a potential array-index?
           (a[c] =
-            // @ts-expect-error
             // eslint-disable-next-line
             Math.abs(path[i + 1]) >> 0 === +path[i + 1]
               ? [] // Yes: assign a new array object

package/src/string/safeJsonStringify.ts

@@ -37,7 +37,7 @@ function serializer(replacer?: Reviver, cycleReplacer?: Reviver): Reviver {
       ~thisPos ? stack.splice(thisPos + 1) : stack.push(this)
       ~thisPos ? keys.splice(thisPos, Infinity, key) : keys.push(key)
       if (~stack.indexOf(value)) {
-        value = cycleReplacer!.call(this, key, value)
+        value = cycleReplacer.call(this, key, value)
       }
     } else {
       stack.push(value)

package/src/types.ts

@@ -235,6 +235,17 @@ export type NumberOfMilliseconds = number
  */
 export type Integer = number
 
+/**
+ * Convenience type alias, that allows to write this:
+ *
+ * data: NullableNumber[]
+ *
+ * instead of this:
+ *
+ * data: (number | null)[]
+ */
+export type NullableNumber = number | null
+
 /**
  * Used as a compact representation of truthy value.
  * undefined ('' or other short falsy value) should be used as falsy value.