@naturalcycles/js-lib 14.170.0 → 14.171.0

package/dist/http/fetcher.d.ts

@@ -8,6 +8,14 @@ import type { FetcherAfterResponseHook, FetcherBeforeRequestHook, FetcherBeforeR
  * Works in both Browser and Node, using `globalThis.fetch`.
  */
 export declare class Fetcher {
+    /**
+     * Included in UserAgent when run in Node.
+     * In the browser it's not included, as we want "browser own" UserAgent to be included instead.
+     *
+     * Version is to be incremented every time a difference in behaviour (or a bugfix) is done.
+     */
+    static readonly VERSION = 1;
+    static readonly userAgent: string | undefined;
     private constructor();
     /**
      * Add BeforeRequest hook at the end of the hooks list.

package/dist/http/fetcher.js

@@ -34,6 +34,14 @@ const defRetryOptions = {
  * Works in both Browser and Node, using `globalThis.fetch`.
  */
 class Fetcher {
+    /**
+     * Included in UserAgent when run in Node.
+     * In the browser it's not included, as we want "browser own" UserAgent to be included instead.
+     *
+     * Version is to be incremented every time a difference in behaviour (or a bugfix) is done.
+     */
+    static { this.VERSION = 1; }
+    static { this.userAgent = (0, env_1.isServerSide)() ? `fetcher${this.VERSION}` : undefined; }
     constructor(cfg = {}) {
         if (typeof globalThis.fetch !== 'function') {
             throw new TypeError(`globalThis.fetch is not available`);
@@ -487,10 +495,10 @@ class Fetcher {
             retry: { ...defRetryOptions },
             init: {
                 method: cfg.method || 'GET',
-                headers: {
-                    'user-agent': 'fetcher',
+                headers: (0, object_util_1._filterNullishValues)({
+                    'user-agent': Fetcher.userAgent,
                     ...cfg.headers,
-                },
+                }),
                 credentials: cfg.credentials,
                 redirect: cfg.redirect,
             },
@@ -532,6 +540,8 @@ class Fetcher {
                 headers: (0, object_util_1._mapKeys)(opt.headers || {}, k => k.toLowerCase()),
             }),
         };
+        // Because all header values are stringified, so `a: undefined` becomes `undefined` as a string
+        (0, object_util_1._filterNullishValues)(req.init.headers, true);
         // setup url
         const baseUrl = opt.baseUrl || this.cfg.baseUrl;
         if (baseUrl) {

package/dist/index.d.ts

@@ -86,6 +86,5 @@ export * from './web';
 export * from './zod/zod.util';
 export * from './zod/zod.shared.schemas';
 import { z, ZodSchema, ZodError, ZodIssue } from 'zod';
-import { is } from './vendor/is';
-export { is, z, ZodSchema, ZodError };
+export { z, ZodSchema, ZodError };
 export type { ZodIssue };

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZodError = exports.ZodSchema = exports.z = exports.is = void 0;
+exports.ZodError = exports.ZodSchema = exports.z = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./array/array.util"), exports);
 tslib_1.__exportStar(require("./define"), exports);
@@ -93,5 +93,3 @@ const zod_1 = require("zod");
 Object.defineProperty(exports, "z", { enumerable: true, get: function () { return zod_1.z; } });
 Object.defineProperty(exports, "ZodSchema", { enumerable: true, get: function () { return zod_1.ZodSchema; } });
 Object.defineProperty(exports, "ZodError", { enumerable: true, get: function () { return zod_1.ZodError; } });
-const is_1 = require("./vendor/is");
-Object.defineProperty(exports, "is", { enumerable: true, get: function () { return is_1.is; } });

package/dist-esm/http/fetcher.js

@@ -1,5 +1,6 @@
 /// <reference lib="dom"/>
 /// <reference lib="dom.iterable"/>
+var _a;
 import { isServerSide } from '../env';
 import { _assertErrorClassOrRethrow } from '../error/assert';
 import { _anyToError, _anyToErrorObject, _errorLikeToErrorObject } from '../error/error.util';
@@ -60,21 +61,21 @@ export class Fetcher {
      * Add BeforeRequest hook at the end of the hooks list.
      */
     onBeforeRequest(hook) {
-        var _a;
+        var _b;
         ;
-        ((_a = this.cfg.hooks).beforeRequest || (_a.beforeRequest = [])).push(hook);
+        ((_b = this.cfg.hooks).beforeRequest || (_b.beforeRequest = [])).push(hook);
         return this;
     }
     onAfterResponse(hook) {
-        var _a;
+        var _b;
         ;
-        ((_a = this.cfg.hooks).afterResponse || (_a.afterResponse = [])).push(hook);
+        ((_b = this.cfg.hooks).afterResponse || (_b.afterResponse = [])).push(hook);
         return this;
     }
     onBeforeRetry(hook) {
-        var _a;
+        var _b;
         ;
-        ((_a = this.cfg.hooks).beforeRetry || (_a.beforeRetry = [])).push(hook);
+        ((_b = this.cfg.hooks).beforeRetry || (_b.beforeRetry = [])).push(hook);
         return this;
     }
     static create(cfg = {}) {
@@ -120,7 +121,7 @@ export class Fetcher {
      * Note: responseType defaults to `void`, so, override it if you expect different.
      */
     async doFetch(opt) {
-        var _a, _b;
+        var _b, _c;
         const req = this.normalizeOptions(opt);
         const { logger } = this.cfg;
         const { timeoutSeconds, init: { method }, } = req;
@@ -182,8 +183,8 @@ export class Fetcher {
                 // Separate Timeout will be introduced to "download and parse the body"
             }
             res.statusFamily = this.getStatusFamily(res);
-            res.statusCode = (_a = res.fetchResponse) === null || _a === void 0 ? void 0 : _a.status;
-            if ((_b = res.fetchResponse) === null || _b === void 0 ? void 0 : _b.ok) {
+            res.statusCode = (_b = res.fetchResponse) === null || _b === void 0 ? void 0 : _b.status;
+            if ((_c = res.fetchResponse) === null || _c === void 0 ? void 0 : _c.ok) {
                 try {
                     // We are applying a separate Timeout (as long as original Timeout for now) to "download and parse the body"
                     await pTimeout(async () => await this.onOkResponse(res), {
@@ -274,7 +275,7 @@ export class Fetcher {
         return await globalThis.fetch(url, init);
     }
     async onNotOkResponse(res) {
-        var _a, _b;
+        var _b, _c;
         let cause;
         if (res.err) {
             // This is only possible on JSON.parse error, or CORS error,
@@ -293,10 +294,10 @@ export class Fetcher {
             message: 'Fetch failed',
             data: {},
         });
-        const message = [(_a = res.fetchResponse) === null || _a === void 0 ? void 0 : _a.status, res.signature].filter(Boolean).join(' ');
+        const message = [(_b = res.fetchResponse) === null || _b === void 0 ? void 0 : _b.status, res.signature].filter(Boolean).join(' ');
         res.err = new HttpRequestError(message, _filterNullishValues({
             response: res.fetchResponse,
-            responseStatusCode: ((_b = res.fetchResponse) === null || _b === void 0 ? void 0 : _b.status) || 0,
+            responseStatusCode: ((_c = res.fetchResponse) === null || _c === void 0 ? void 0 : _c.status) || 0,
             // These properties are provided to be used in e.g custom Sentry error grouping
             // Actually, disabled now, to avoid unnecessary error printing when both msg and data are printed
             // Enabled, cause `data` is not printed by default when error is HttpError
@@ -313,7 +314,7 @@ export class Fetcher {
         await this.processRetry(res);
     }
     async processRetry(res) {
-        var _a;
+        var _b;
         const { retryStatus } = res;
         if (!this.shouldRetry(res)) {
             retryStatus.retryStopped = true;
@@ -333,7 +334,7 @@ export class Fetcher {
         if (res.err && (!retryStatus.retryStopped || res.req.logResponse)) {
             this.cfg.logger.error([
                 ' <<',
-                ((_a = res.fetchResponse) === null || _a === void 0 ? void 0 : _a.status) || 0,
+                ((_b = res.fetchResponse) === null || _b === void 0 ? void 0 : _b.status) || 0,
                 res.signature,
                 count &&
                     (retryStatus.retryAttempt || !retryStatus.retryStopped) &&
@@ -356,12 +357,12 @@ export class Fetcher {
         await pDelay(timeout);
     }
     getRetryTimeout(res) {
-        var _a;
+        var _b;
         let timeout = 0;
         // Handling http 429 with specific retry headers
         // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After
         if (res.fetchResponse && [429, 503].includes(res.fetchResponse.status)) {
-            const retryAfterStr = (_a = res.fetchResponse.headers.get('retry-after')) !== null && _a !== void 0 ? _a : res.fetchResponse.headers.get('x-ratelimit-reset');
+            const retryAfterStr = (_b = res.fetchResponse.headers.get('retry-after')) !== null && _b !== void 0 ? _b : res.fetchResponse.headers.get('x-ratelimit-reset');
             if (retryAfterStr) {
                 if (Number(retryAfterStr)) {
                     timeout = Number(retryAfterStr) * 1000;
@@ -391,13 +392,13 @@ export class Fetcher {
      * statusCode of 0 (or absense of it) will BE retried.
      */
     shouldRetry(res) {
-        var _a, _b, _c, _d, _e;
+        var _b, _c, _d, _e, _f;
         const { retryPost, retry3xx, retry4xx, retry5xx } = res.req;
         const { method } = res.req.init;
         if (method === 'POST' && !retryPost)
             return false;
         const { statusFamily } = res;
-        const statusCode = ((_a = res.fetchResponse) === null || _a === void 0 ? void 0 : _a.status) || 0;
+        const statusCode = ((_b = res.fetchResponse) === null || _b === void 0 ? void 0 : _b.status) || 0;
         if (statusFamily === 5 && !retry5xx)
             return false;
         if ([408, 429].includes(statusCode)) {
@@ -409,14 +410,14 @@ export class Fetcher {
         if (statusFamily === 3 && !retry3xx)
             return false;
         // should not retry on `unexpected redirect` in error.cause.cause
-        if ((_e = (_d = (_c = (_b = res.err) === null || _b === void 0 ? void 0 : _b.cause) === null || _c === void 0 ? void 0 : _c.cause) === null || _d === void 0 ? void 0 : _d.message) === null || _e === void 0 ? void 0 : _e.includes('unexpected redirect')) {
+        if ((_f = (_e = (_d = (_c = res.err) === null || _c === void 0 ? void 0 : _c.cause) === null || _d === void 0 ? void 0 : _d.cause) === null || _e === void 0 ? void 0 : _e.message) === null || _f === void 0 ? void 0 : _f.includes('unexpected redirect')) {
             return false;
         }
         return true; // default is true
     }
     getStatusFamily(res) {
-        var _a;
-        const status = (_a = res.fetchResponse) === null || _a === void 0 ? void 0 : _a.status;
+        var _b;
+        const status = (_b = res.fetchResponse) === null || _b === void 0 ? void 0 : _b.status;
         if (!status)
             return;
         if (status >= 500)
@@ -449,8 +450,8 @@ export class Fetcher {
         return shortUrl;
     }
     normalizeCfg(cfg) {
-        var _a;
-        if ((_a = cfg.baseUrl) === null || _a === void 0 ? void 0 : _a.endsWith('/')) {
+        var _b;
+        if ((_b = cfg.baseUrl) === null || _b === void 0 ? void 0 : _b.endsWith('/')) {
             console.warn(`Fetcher: baseUrl should not end with slash: ${cfg.baseUrl}`);
             cfg.baseUrl = cfg.baseUrl.slice(0, cfg.baseUrl.length - 1);
         }
@@ -477,7 +478,7 @@ export class Fetcher {
             retry: Object.assign({}, defRetryOptions),
             init: {
                 method: cfg.method || 'GET',
-                headers: Object.assign({ 'user-agent': 'fetcher' }, cfg.headers),
+                headers: _filterNullishValues(Object.assign({ 'user-agent': Fetcher.userAgent }, cfg.headers)),
                 credentials: cfg.credentials,
                 redirect: cfg.redirect,
             },
@@ -487,7 +488,7 @@ export class Fetcher {
         return norm;
     }
     normalizeOptions(opt) {
-        var _a;
+        var _b;
         const req = Object.assign(Object.assign(Object.assign(Object.assign({}, _pick(this.cfg, [
             'timeoutSeconds',
             'retryPost',
@@ -503,6 +504,8 @@ export class Fetcher {
         ])), { started: Date.now() }), _omit(opt, ['method', 'headers', 'credentials'])), { inputUrl: opt.url || '', fullUrl: opt.url || '', retry: Object.assign(Object.assign({}, this.cfg.retry), _filterUndefinedValues(opt.retry || {})), init: _merge(Object.assign(Object.assign({}, this.cfg.init), { headers: Object.assign({}, this.cfg.init.headers), method: opt.method || this.cfg.init.method, credentials: opt.credentials || this.cfg.init.credentials, redirect: opt.redirect || this.cfg.init.redirect || 'follow' }), {
                 headers: _mapKeys(opt.headers || {}, k => k.toLowerCase()),
             }) });
+        // Because all header values are stringified, so `a: undefined` becomes `undefined` as a string
+        _filterNullishValues(req.init.headers, true);
         // setup url
         const baseUrl = opt.baseUrl || this.cfg.baseUrl;
         if (baseUrl) {
@@ -540,10 +543,19 @@ export class Fetcher {
             req.init.body = opt.body;
         }
         // Unless `accept` header was already set - set it based on responseType
-        (_a = req.init.headers)['accept'] || (_a['accept'] = acceptByResponseType[req.responseType]);
+        (_b = req.init.headers)['accept'] || (_b['accept'] = acceptByResponseType[req.responseType]);
         return req;
     }
 }
+_a = Fetcher;
+/**
+ * Included in UserAgent when run in Node.
+ * In the browser it's not included, as we want "browser own" UserAgent to be included instead.
+ *
+ * Version is to be incremented every time a difference in behaviour (or a bugfix) is done.
+ */
+Fetcher.VERSION = 1;
+Fetcher.userAgent = isServerSide() ? `fetcher${_a.VERSION}` : undefined;
 export function getFetcher(cfg = {}) {
     return Fetcher.create(cfg);
 }

package/dist-esm/index.js

@@ -86,5 +86,4 @@ export * from './web';
 export * from './zod/zod.util';
 export * from './zod/zod.shared.schemas';
 import { z, ZodSchema, ZodError } from 'zod';
-import { is } from './vendor/is';
-export { is, z, ZodSchema, ZodError };
+export { z, ZodSchema, ZodError };

package/package.json

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

package/src/http/fetcher.ts

@@ -58,6 +58,15 @@ const defRetryOptions: FetcherRetryOptions = {
  * Works in both Browser and Node, using `globalThis.fetch`.
  */
 export class Fetcher {
+  /**
+   * Included in UserAgent when run in Node.
+   * In the browser it's not included, as we want "browser own" UserAgent to be included instead.
+   *
+   * Version is to be incremented every time a difference in behaviour (or a bugfix) is done.
+   */
+  static readonly VERSION = 1
+  static readonly userAgent = isServerSide() ? `fetcher${this.VERSION}` : undefined
+
   private constructor(cfg: FetcherCfg & FetcherOptions = {}) {
     if (typeof globalThis.fetch !== 'function') {
       throw new TypeError(`globalThis.fetch is not available`)
@@ -594,10 +603,10 @@ export class Fetcher {
         retry: { ...defRetryOptions },
         init: {
           method: cfg.method || 'GET',
-          headers: {
-            'user-agent': 'fetcher',
+          headers: _filterNullishValues({
+            'user-agent': Fetcher.userAgent,
             ...cfg.headers,
-          },
+          }),
           credentials: cfg.credentials,
           redirect: cfg.redirect,
         },
@@ -647,6 +656,10 @@ export class Fetcher {
         } satisfies RequestInit,
       ),
     }
+
+    // Because all header values are stringified, so `a: undefined` becomes `undefined` as a string
+    _filterNullishValues(req.init.headers, true)
+
     // setup url
     const baseUrl = opt.baseUrl || this.cfg.baseUrl
     if (baseUrl) {

package/src/index.ts

@@ -86,7 +86,6 @@ export * from './web'
 export * from './zod/zod.util'
 export * from './zod/zod.shared.schemas'
 import { z, ZodSchema, ZodError, ZodIssue } from 'zod'
-import { is } from './vendor/is'
 
-export { is, z, ZodSchema, ZodError }
+export { z, ZodSchema, ZodError }
 export type { ZodIssue }

package/dist/vendor/is.d.ts

@@ -1,226 +0,0 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference lib="es2018" />
-/// <reference lib="dom" />
-import { Class, ObservableLike, Primitive, TypedArray } from '../typeFest';
-declare const objectTypeNames: readonly ["Function", "Generator", "AsyncGenerator", "GeneratorFunction", "AsyncGeneratorFunction", "AsyncFunction", "Observable", "Array", "Buffer", "Object", "RegExp", "Date", "Error", "Map", "Set", "WeakMap", "WeakSet", "ArrayBuffer", "SharedArrayBuffer", "DataView", "Promise", "URL", "FormData", "URLSearchParams", "HTMLElement", "Int8Array", "Uint8Array", "Uint8ClampedArray", "Int16Array", "Uint16Array", "Int32Array", "Uint32Array", "Float32Array", "Float64Array", "BigInt64Array", "BigUint64Array"];
-type ObjectTypeName = (typeof objectTypeNames)[number];
-declare const primitiveTypeNames: readonly ["null", "undefined", "string", "number", "bigint", "boolean", "symbol"];
-type PrimitiveTypeName = (typeof primitiveTypeNames)[number];
-export type TypeName = ObjectTypeName | PrimitiveTypeName;
-export declare function is(value: unknown): TypeName;
-export declare namespace is {
-    var undefined: (value: unknown) => value is undefined;
-    var string: (value: unknown) => value is string;
-    var number: (value: unknown) => value is number;
-    var bigint: (value: unknown) => value is bigint;
-    var function_: (value: unknown) => value is Function;
-    var null_: (value: unknown) => value is null;
-    var class_: (value: unknown) => value is Class;
-    var boolean: (value: unknown) => value is boolean;
-    var symbol: (value: unknown) => value is symbol;
-    var numericString: (value: unknown) => value is string;
-    var array: <T = unknown>(value: unknown, assertion?: ((value: T) => value is T) | undefined) => value is T[];
-    var buffer: (value: unknown) => value is Buffer;
-    var nullOrUndefined: (value: unknown) => value is null | undefined;
-    var object: (value: unknown) => value is object;
-    var iterable: <T = unknown>(value: unknown) => value is IterableIterator<T>;
-    var asyncIterable: <T = unknown>(value: unknown) => value is AsyncIterableIterator<T>;
-    var generator: (value: unknown) => value is Generator<unknown, any, unknown>;
-    var asyncGenerator: (value: unknown) => value is AsyncGenerator<unknown, any, unknown>;
-    var nativePromise: <T = unknown>(value: unknown) => value is Promise<T>;
-    var promise: <T = unknown>(value: unknown) => value is Promise<T>;
-    var generatorFunction: (value: unknown) => value is GeneratorFunction;
-    var asyncGeneratorFunction: (value: unknown) => value is (...args: any[]) => Promise<unknown>;
-    var asyncFunction: <T = unknown>(value: unknown) => value is (...args: any[]) => Promise<T>;
-    var boundFunction: (value: unknown) => value is Function;
-    var regExp: (value: unknown) => value is RegExp;
-    var date: (value: unknown) => value is Date;
-    var error: (value: unknown) => value is Error;
-    var map: <Key = unknown, Value = unknown>(value: unknown) => value is Map<Key, Value>;
-    var set: <T = unknown>(value: unknown) => value is Set<T>;
-    var weakMap: <Key extends object = object, Value = unknown>(value: unknown) => value is WeakMap<Key, Value>;
-    var weakSet: (value: unknown) => value is WeakSet<object>;
-    var int8Array: (value: unknown) => value is Int8Array;
-    var uint8Array: (value: unknown) => value is Uint8Array;
-    var uint8ClampedArray: (value: unknown) => value is Uint8ClampedArray;
-    var int16Array: (value: unknown) => value is Int16Array;
-    var uint16Array: (value: unknown) => value is Uint16Array;
-    var int32Array: (value: unknown) => value is Int32Array;
-    var uint32Array: (value: unknown) => value is Uint32Array;
-    var float32Array: (value: unknown) => value is Float32Array;
-    var float64Array: (value: unknown) => value is Float64Array;
-    var bigInt64Array: (value: unknown) => value is BigInt64Array;
-    var bigUint64Array: (value: unknown) => value is BigUint64Array;
-    var arrayBuffer: (value: unknown) => value is ArrayBuffer;
-    var sharedArrayBuffer: (value: unknown) => value is SharedArrayBuffer;
-    var dataView: (value: unknown) => value is DataView;
-    var directInstanceOf: <T>(instance: unknown, class_: Class<T>) => instance is T;
-    var urlInstance: (value: unknown) => value is URL;
-    var urlString: (value: unknown) => value is string;
-    var truthy: (value: unknown) => boolean;
-    var falsy: (value: unknown) => boolean;
-    var nan: (value: unknown) => boolean;
-    var primitive: (value: unknown) => value is Primitive;
-    var integer: (value: unknown) => value is number;
-    var safeInteger: (value: unknown) => value is number;
-    var plainObject: <Value = unknown>(value: unknown) => value is Record<PropertyKey, Value>;
-    var typedArray: (value: unknown) => value is TypedArray;
-    var arrayLike: <T = unknown>(value: unknown) => value is ArrayLike<T>;
-    var inRange: (value: number, range: number | number[]) => value is number;
-    var domElement: (value: unknown) => value is HTMLElement;
-    var observable: (value: unknown) => value is ObservableLike;
-    var nodeStream: (value: unknown) => value is NodeStream;
-    var infinite: (value: unknown) => value is number;
-    var evenInteger: (value: number) => value is number;
-    var oddInteger: (value: number) => value is number;
-    var emptyArray: (value: unknown) => value is never[];
-    var nonEmptyArray: (value: unknown) => value is unknown[];
-    var emptyString: (value: unknown) => value is "";
-    var nonEmptyString: (value: unknown) => value is string;
-    var emptyStringOrWhitespace: (value: unknown) => value is string;
-    var emptyObject: <Key extends string | number | symbol = string>(value: unknown) => value is Record<Key, never>;
-    var nonEmptyObject: <Key extends string | number | symbol = string, Value = unknown>(value: unknown) => value is Record<Key, Value>;
-    var emptySet: (value: unknown) => value is Set<never>;
-    var nonEmptySet: <T = unknown>(value: unknown) => value is Set<T>;
-    var emptyMap: (value: unknown) => value is Map<never, never>;
-    var nonEmptyMap: <Key = unknown, Value = unknown>(value: unknown) => value is Map<Key, Value>;
-    var propertyKey: (value: unknown) => value is PropertyKey;
-    var formData: (value: unknown) => value is FormData;
-    var urlSearchParams: (value: unknown) => value is URLSearchParams;
-    var any: (predicate: Predicate | Predicate[], ...values: unknown[]) => boolean;
-    var all: (predicate: Predicate, ...values: unknown[]) => boolean;
-}
-export interface ArrayLike<T> {
-    readonly [index: number]: T;
-    readonly length: number;
-}
-export interface NodeStream extends NodeJS.EventEmitter {
-    pipe<T extends NodeJS.WritableStream>(destination: T, options?: {
-        end?: boolean;
-    }): T;
-}
-export type Predicate = (value: unknown) => boolean;
-export declare const enum AssertionTypeDescription {
-    class_ = "Class",
-    numericString = "string with a number",
-    nullOrUndefined = "null or undefined",
-    iterable = "Iterable",
-    asyncIterable = "AsyncIterable",
-    nativePromise = "native Promise",
-    urlString = "string with a URL",
-    truthy = "truthy",
-    falsy = "falsy",
-    nan = "NaN",
-    primitive = "primitive",
-    integer = "integer",
-    safeInteger = "integer",
-    plainObject = "plain object",
-    arrayLike = "array-like",
-    typedArray = "TypedArray",
-    domElement = "HTMLElement",
-    nodeStream = "Node.js Stream",
-    infinite = "infinite number",
-    emptyArray = "empty array",
-    nonEmptyArray = "non-empty array",
-    emptyString = "empty string",
-    nonEmptyString = "non-empty string",
-    emptyStringOrWhitespace = "empty string or whitespace",
-    emptyObject = "empty object",
-    nonEmptyObject = "non-empty object",
-    emptySet = "empty set",
-    nonEmptySet = "non-empty set",
-    emptyMap = "empty map",
-    nonEmptyMap = "non-empty map",
-    evenInteger = "even integer",
-    oddInteger = "odd integer",
-    directInstanceOf = "T",
-    inRange = "in range",
-    any = "predicate returns truthy for any value",
-    all = "predicate returns truthy for all values"
-}
-interface Assert {
-    undefined: (value: unknown) => asserts value is undefined;
-    string: (value: unknown) => asserts value is string;
-    number: (value: unknown) => asserts value is number;
-    bigint: (value: unknown) => asserts value is bigint;
-    function_: (value: unknown) => asserts value is Function;
-    null_: (value: unknown) => asserts value is null;
-    class_: (value: unknown) => asserts value is Class;
-    boolean: (value: unknown) => asserts value is boolean;
-    symbol: (value: unknown) => asserts value is symbol;
-    numericString: (value: unknown) => asserts value is string;
-    array: <T = unknown>(value: unknown, assertion?: (element: unknown) => asserts element is T) => asserts value is T[];
-    buffer: (value: unknown) => asserts value is Buffer;
-    nullOrUndefined: (value: unknown) => asserts value is null | undefined;
-    object: <Key extends keyof any = string, Value = unknown>(value: unknown) => asserts value is Record<Key, Value>;
-    iterable: <T = unknown>(value: unknown) => asserts value is Iterable<T>;
-    asyncIterable: <T = unknown>(value: unknown) => asserts value is AsyncIterable<T>;
-    generator: (value: unknown) => asserts value is Generator;
-    asyncGenerator: (value: unknown) => asserts value is AsyncGenerator;
-    nativePromise: <T = unknown>(value: unknown) => asserts value is Promise<T>;
-    promise: <T = unknown>(value: unknown) => asserts value is Promise<T>;
-    generatorFunction: (value: unknown) => asserts value is GeneratorFunction;
-    asyncGeneratorFunction: (value: unknown) => asserts value is AsyncGeneratorFunction;
-    asyncFunction: (value: unknown) => asserts value is Function;
-    boundFunction: (value: unknown) => asserts value is Function;
-    regExp: (value: unknown) => asserts value is RegExp;
-    date: (value: unknown) => asserts value is Date;
-    error: (value: unknown) => asserts value is Error;
-    map: <Key = unknown, Value = unknown>(value: unknown) => asserts value is Map<Key, Value>;
-    set: <T = unknown>(value: unknown) => asserts value is Set<T>;
-    weakMap: <Key extends object = object, Value = unknown>(value: unknown) => asserts value is WeakMap<Key, Value>;
-    weakSet: <T extends object = object>(value: unknown) => asserts value is WeakSet<T>;
-    int8Array: (value: unknown) => asserts value is Int8Array;
-    uint8Array: (value: unknown) => asserts value is Uint8Array;
-    uint8ClampedArray: (value: unknown) => asserts value is Uint8ClampedArray;
-    int16Array: (value: unknown) => asserts value is Int16Array;
-    uint16Array: (value: unknown) => asserts value is Uint16Array;
-    int32Array: (value: unknown) => asserts value is Int32Array;
-    uint32Array: (value: unknown) => asserts value is Uint32Array;
-    float32Array: (value: unknown) => asserts value is Float32Array;
-    float64Array: (value: unknown) => asserts value is Float64Array;
-    bigInt64Array: (value: unknown) => asserts value is BigInt64Array;
-    bigUint64Array: (value: unknown) => asserts value is BigUint64Array;
-    arrayBuffer: (value: unknown) => asserts value is ArrayBuffer;
-    sharedArrayBuffer: (value: unknown) => asserts value is SharedArrayBuffer;
-    dataView: (value: unknown) => asserts value is DataView;
-    urlInstance: (value: unknown) => asserts value is URL;
-    urlString: (value: unknown) => asserts value is string;
-    truthy: (value: unknown) => asserts value is unknown;
-    falsy: (value: unknown) => asserts value is unknown;
-    nan: (value: unknown) => asserts value is unknown;
-    primitive: (value: unknown) => asserts value is Primitive;
-    integer: (value: unknown) => asserts value is number;
-    safeInteger: (value: unknown) => asserts value is number;
-    plainObject: <Value = unknown>(value: unknown) => asserts value is Record<PropertyKey, Value>;
-    typedArray: (value: unknown) => asserts value is TypedArray;
-    arrayLike: <T = unknown>(value: unknown) => asserts value is ArrayLike<T>;
-    domElement: (value: unknown) => asserts value is HTMLElement;
-    observable: (value: unknown) => asserts value is ObservableLike;
-    nodeStream: (value: unknown) => asserts value is NodeStream;
-    infinite: (value: unknown) => asserts value is number;
-    emptyArray: (value: unknown) => asserts value is never[];
-    nonEmptyArray: (value: unknown) => asserts value is unknown[];
-    emptyString: (value: unknown) => asserts value is '';
-    nonEmptyString: (value: unknown) => asserts value is string;
-    emptyStringOrWhitespace: (value: unknown) => asserts value is string;
-    emptyObject: <Key extends keyof any = string>(value: unknown) => asserts value is Record<Key, never>;
-    nonEmptyObject: <Key extends keyof any = string, Value = unknown>(value: unknown) => asserts value is Record<Key, Value>;
-    emptySet: (value: unknown) => asserts value is Set<never>;
-    nonEmptySet: <T = unknown>(value: unknown) => asserts value is Set<T>;
-    emptyMap: (value: unknown) => asserts value is Map<never, never>;
-    nonEmptyMap: <Key = unknown, Value = unknown>(value: unknown) => asserts value is Map<Key, Value>;
-    propertyKey: (value: unknown) => asserts value is PropertyKey;
-    formData: (value: unknown) => asserts value is FormData;
-    urlSearchParams: (value: unknown) => asserts value is URLSearchParams;
-    evenInteger: (value: number) => asserts value is number;
-    oddInteger: (value: number) => asserts value is number;
-    directInstanceOf: <T>(instance: unknown, class_: Class<T>) => asserts instance is T;
-    inRange: (value: number, range: number | number[]) => asserts value is number;
-    any: (predicate: Predicate | Predicate[], ...values: unknown[]) => void | never;
-    all: (predicate: Predicate, ...values: unknown[]) => void | never;
-}
-export declare const assert: Assert;
-export {};