@naturalcycles/js-lib 14.42.1 → 14.46.0

package/CHANGELOG.md

@@ -1,3 +1,31 @@
+# [14.46.0](https://github.com/NaturalCycles/js-lib/compare/v14.45.0...v14.46.0) (2021-10-01)
+
+
+### Features
+
+* generateJsonSchemaFromData (experimental) ([87a74e9](https://github.com/NaturalCycles/js-lib/commit/87a74e9f033d8bb43d3137855044c09c63751b2c))
+
+# [14.45.0](https://github.com/NaturalCycles/js-lib/compare/v14.44.0...v14.45.0) (2021-10-01)
+
+
+### Features
+
+* stringifyAnyOptions.maxLen default to 10_000 (was: 1000) ([1d7750f](https://github.com/NaturalCycles/js-lib/commit/1d7750f21b7cfad40d571f8e564b76398fbe3bcf))
+
+# [14.44.0](https://github.com/NaturalCycles/js-lib/compare/v14.43.0...v14.44.0) (2021-09-22)
+
+
+### Features
+
+* export `is` (experimental) ([d83861c](https://github.com/NaturalCycles/js-lib/commit/d83861c7f65956eb2b67c5f6a86d1927f1ee7d3b))
+
+# [14.43.0](https://github.com/NaturalCycles/js-lib/compare/v14.42.1...v14.43.0) (2021-09-10)
+
+
+### Features
+
+* jsonSchema.buffer() ([67cd330](https://github.com/NaturalCycles/js-lib/commit/67cd330e805870f65cdc35c3974eb23347ec8692))
+
 ## [14.42.1](https://github.com/NaturalCycles/js-lib/compare/v14.42.0...v14.42.1) (2021-09-04)
 
 

package/dist/index.d.ts

@@ -18,6 +18,7 @@ import { ErrorMode } from './error/errorMode';
 import { HttpError } from './error/http.error';
 import { _try } from './error/try';
 import { TryCatchOptions, _TryCatch, _tryCatch } from './error/tryCatch';
+import { generateJsonSchemaFromData } from './json-schema/from-data/generateJsonSchemaFromData';
 import { JSON_SCHEMA_ORDER } from './json-schema/jsonSchema.cnst';
 import { JsonSchema, JsonSchemaAllOf, JsonSchemaAny, JsonSchemaAnyOf, JsonSchemaArray, JsonSchemaBoolean, JsonSchemaConst, JsonSchemaEnum, JsonSchemaNot, JsonSchemaNull, JsonSchemaNumber, JsonSchemaObject, JsonSchemaOneOf, JsonSchemaRef, JsonSchemaString, JsonSchemaTuple } from './json-schema/jsonSchema.model';
 import { mergeJsonSchemaObjects } from './json-schema/jsonSchema.util';
@@ -50,5 +51,6 @@ import { _ms, _since } from './time/time.util';
 import { Class, ConditionalExcept, ConditionalPick, Merge, Promisable, PromiseValue, ReadonlyDeep, Simplify } from './typeFest';
 import { AsyncMapper, AsyncPredicate, BaseDBEntity, BatchResult, InstanceId, IsoDate, IsoDateTime, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, Reviver, SavedDBEntity, StringMap, UnixTimestamp, ValueOf, ValuesOf, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues } from './types';
 import { _gb, _hb, _kb, _mb } from './unit/size.util';
+import { is } from './vendor/is';
 export type { MemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateTime, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, PromiseValue, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestamp, BaseDBEntity, SavedDBEntity, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, };
-export { _Memo, _memoFn, _LogMethod, _getArgsSignature, _createPromiseDecorator, AppError, HttpError, AssertionError, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse, _assert, _assertEquals, _assertDeepEquals, _assertIsError, _assertIsString, _assertIsNumber, _assertTypeOf, _randomInt, _createDeterministicRandom, _inRange, _stringMapValues, _stringMapEntries, _objectKeys, _capitalize, _upperFirst, _lowerFirst, _split, _removeWhitespace, _substringBefore, _substringBeforeLast, _substringAfter, _substringAfterLast, _substringBetweenLast, _replaceAll, _nl2br, _truncate, _truncateMiddle, _pick, _omit, _filterFalsyValues, _filterUndefinedValues, _filterNullishValues, _filterEmptyArrays, _filterEmptyValues, _filterObject, _undefinedIfEmpty, _isObject, _isPrimitive, _mapKeys, _mapValues, _mapObject, _objectNullValuesToUndefined, _deepEquals, _deepCopy, _isEmptyObject, _isEmpty, _merge, _deepTrim, _sortObjectDeep, _sortObject, _get, _set, _has, _unset, _mask, _invert, _invertMap, _by, _groupBy, _sortBy, _sortNumbers, _toFixed, _toPrecision, _round, _findLast, _takeWhile, _takeRightWhile, _dropWhile, _dropRightWhile, _countBy, _intersection, _difference, _shuffle, _mapToObject, _findKeyByValue, _anyToError, _anyToErrorObject, _errorToErrorObject, _errorObjectToAppError, _range, _uniq, _uniqBy, _flatten, _flattenDeep, _chunk, SimpleMovingAverage, _average, _averageWeighted, _percentile, _median, _debounce, _throttle, _Debounce, _Throttle, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, pBatch, ErrorMode, pFilter, pProps, pDelay, pDefer, pHang, pState, AggregatedError, pRetry, pTimeout, pTuple, _Retry, _Timeout, _tryCatch, _TryCatch, _try, _jsonParseIfPossible, _stringifyAny, _ms, _since, _hb, _gb, _mb, _kb, _snakeCase, _camelCase, _kebabCase, _sum, _sumBy, _clamp, _last, mergeJsonSchemaObjects, jsonSchema, JsonSchemaAnyBuilder, JSON_SCHEMA_ORDER, };
+export { is, _Memo, _memoFn, _LogMethod, _getArgsSignature, _createPromiseDecorator, AppError, HttpError, AssertionError, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse, _assert, _assertEquals, _assertDeepEquals, _assertIsError, _assertIsString, _assertIsNumber, _assertTypeOf, _randomInt, _createDeterministicRandom, _inRange, _stringMapValues, _stringMapEntries, _objectKeys, _capitalize, _upperFirst, _lowerFirst, _split, _removeWhitespace, _substringBefore, _substringBeforeLast, _substringAfter, _substringAfterLast, _substringBetweenLast, _replaceAll, _nl2br, _truncate, _truncateMiddle, _pick, _omit, _filterFalsyValues, _filterUndefinedValues, _filterNullishValues, _filterEmptyArrays, _filterEmptyValues, _filterObject, _undefinedIfEmpty, _isObject, _isPrimitive, _mapKeys, _mapValues, _mapObject, _objectNullValuesToUndefined, _deepEquals, _deepCopy, _isEmptyObject, _isEmpty, _merge, _deepTrim, _sortObjectDeep, _sortObject, _get, _set, _has, _unset, _mask, _invert, _invertMap, _by, _groupBy, _sortBy, _sortNumbers, _toFixed, _toPrecision, _round, _findLast, _takeWhile, _takeRightWhile, _dropWhile, _dropRightWhile, _countBy, _intersection, _difference, _shuffle, _mapToObject, _findKeyByValue, _anyToError, _anyToErrorObject, _errorToErrorObject, _errorObjectToAppError, _range, _uniq, _uniqBy, _flatten, _flattenDeep, _chunk, SimpleMovingAverage, _average, _averageWeighted, _percentile, _median, _debounce, _throttle, _Debounce, _Throttle, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, pBatch, ErrorMode, pFilter, pProps, pDelay, pDefer, pHang, pState, AggregatedError, pRetry, pTimeout, pTuple, _Retry, _Timeout, _tryCatch, _TryCatch, _try, _jsonParseIfPossible, _stringifyAny, _ms, _since, _hb, _gb, _mb, _kb, _snakeCase, _camelCase, _kebabCase, _sum, _sumBy, _clamp, _last, mergeJsonSchemaObjects, jsonSchema, JsonSchemaAnyBuilder, JSON_SCHEMA_ORDER, generateJsonSchemaFromData, };

package/dist/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._mapKeys = exports._isPrimitive = exports._isObject = exports._undefinedIfEmpty = exports._filterObject = exports._filterEmptyValues = exports._filterEmptyArrays = exports._filterNullishValues = exports._filterUndefinedValues = exports._filterFalsyValues = exports._omit = exports._pick = exports._truncateMiddle = exports._truncate = exports._nl2br = exports._replaceAll = exports._substringBetweenLast = exports._substringAfterLast = exports._substringAfter = exports._substringBeforeLast = exports._substringBefore = exports._removeWhitespace = exports._split = exports._lowerFirst = exports._upperFirst = exports._capitalize = exports._objectKeys = exports._stringMapEntries = exports._stringMapValues = exports._inRange = exports._createDeterministicRandom = exports._randomInt = exports._assertTypeOf = exports._assertIsNumber = exports._assertIsString = exports._assertIsError = exports._assertDeepEquals = exports._assertEquals = exports._assert = exports._isHttpErrorResponse = exports._isHttpErrorObject = exports._isErrorObject = exports.AssertionError = exports.HttpError = exports.AppError = exports._createPromiseDecorator = exports._getArgsSignature = exports._LogMethod = exports._memoFn = exports._Memo = void 0;
-exports._percentile = exports._averageWeighted = exports._average = exports.SimpleMovingAverage = exports._chunk = exports._flattenDeep = exports._flatten = exports._uniqBy = exports._uniq = exports._range = exports._errorObjectToAppError = exports._errorToErrorObject = exports._anyToErrorObject = exports._anyToError = exports._findKeyByValue = exports._mapToObject = exports._shuffle = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._round = exports._toPrecision = exports._toFixed = exports._sortNumbers = exports._sortBy = exports._groupBy = exports._by = exports._invertMap = exports._invert = exports._mask = exports._unset = exports._has = exports._set = exports._get = exports._sortObject = exports._sortObjectDeep = exports._deepTrim = exports._merge = exports._isEmpty = exports._isEmptyObject = exports._deepCopy = exports._deepEquals = exports._objectNullValuesToUndefined = exports._mapObject = exports._mapValues = void 0;
-exports.JSON_SCHEMA_ORDER = exports.JsonSchemaAnyBuilder = exports.jsonSchema = exports.mergeJsonSchemaObjects = exports._last = exports._clamp = exports._sumBy = exports._sum = exports._kebabCase = exports._camelCase = exports._snakeCase = exports._kb = exports._mb = exports._gb = exports._hb = exports._since = exports._ms = exports._stringifyAny = exports._jsonParseIfPossible = exports._try = exports._TryCatch = exports._tryCatch = exports._Timeout = exports._Retry = exports.pTuple = exports.pTimeout = exports.pRetry = exports.AggregatedError = exports.pState = exports.pHang = exports.pDefer = exports.pDelay = exports.pProps = exports.pFilter = exports.ErrorMode = exports.pBatch = exports._noop = exports._passNothingPredicate = exports._passthroughPredicate = exports._passUndefinedMapper = exports._passthroughMapper = exports.pMap = exports._Throttle = exports._Debounce = exports._throttle = exports._debounce = exports._median = void 0;
+exports._isPrimitive = exports._isObject = exports._undefinedIfEmpty = exports._filterObject = exports._filterEmptyValues = exports._filterEmptyArrays = exports._filterNullishValues = exports._filterUndefinedValues = exports._filterFalsyValues = exports._omit = exports._pick = exports._truncateMiddle = exports._truncate = exports._nl2br = exports._replaceAll = exports._substringBetweenLast = exports._substringAfterLast = exports._substringAfter = exports._substringBeforeLast = exports._substringBefore = exports._removeWhitespace = exports._split = exports._lowerFirst = exports._upperFirst = exports._capitalize = exports._objectKeys = exports._stringMapEntries = exports._stringMapValues = exports._inRange = exports._createDeterministicRandom = exports._randomInt = exports._assertTypeOf = exports._assertIsNumber = exports._assertIsString = exports._assertIsError = exports._assertDeepEquals = exports._assertEquals = exports._assert = exports._isHttpErrorResponse = exports._isHttpErrorObject = exports._isErrorObject = exports.AssertionError = exports.HttpError = exports.AppError = exports._createPromiseDecorator = exports._getArgsSignature = exports._LogMethod = exports._memoFn = exports._Memo = exports.is = void 0;
+exports._averageWeighted = exports._average = exports.SimpleMovingAverage = exports._chunk = exports._flattenDeep = exports._flatten = exports._uniqBy = exports._uniq = exports._range = exports._errorObjectToAppError = exports._errorToErrorObject = exports._anyToErrorObject = exports._anyToError = exports._findKeyByValue = exports._mapToObject = exports._shuffle = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._round = exports._toPrecision = exports._toFixed = exports._sortNumbers = exports._sortBy = exports._groupBy = exports._by = exports._invertMap = exports._invert = exports._mask = exports._unset = exports._has = exports._set = exports._get = exports._sortObject = exports._sortObjectDeep = exports._deepTrim = exports._merge = exports._isEmpty = exports._isEmptyObject = exports._deepCopy = exports._deepEquals = exports._objectNullValuesToUndefined = exports._mapObject = exports._mapValues = exports._mapKeys = void 0;
+exports.generateJsonSchemaFromData = exports.JSON_SCHEMA_ORDER = exports.JsonSchemaAnyBuilder = exports.jsonSchema = exports.mergeJsonSchemaObjects = exports._last = exports._clamp = exports._sumBy = exports._sum = exports._kebabCase = exports._camelCase = exports._snakeCase = exports._kb = exports._mb = exports._gb = exports._hb = exports._since = exports._ms = exports._stringifyAny = exports._jsonParseIfPossible = exports._try = exports._TryCatch = exports._tryCatch = exports._Timeout = exports._Retry = exports.pTuple = exports.pTimeout = exports.pRetry = exports.AggregatedError = exports.pState = exports.pHang = exports.pDefer = exports.pDelay = exports.pProps = exports.pFilter = exports.ErrorMode = exports.pBatch = exports._noop = exports._passNothingPredicate = exports._passthroughPredicate = exports._passUndefinedMapper = exports._passthroughMapper = exports.pMap = exports._Throttle = exports._Debounce = exports._throttle = exports._debounce = exports._median = exports._percentile = void 0;
 const array_util_1 = require("./array/array.util");
 Object.defineProperty(exports, "_by", { enumerable: true, get: function () { return array_util_1._by; } });
 Object.defineProperty(exports, "_chunk", { enumerable: true, get: function () { return array_util_1._chunk; } });
@@ -75,6 +75,8 @@ Object.defineProperty(exports, "_try", { enumerable: true, get: function () { re
 const tryCatch_1 = require("./error/tryCatch");
 Object.defineProperty(exports, "_TryCatch", { enumerable: true, get: function () { return tryCatch_1._TryCatch; } });
 Object.defineProperty(exports, "_tryCatch", { enumerable: true, get: function () { return tryCatch_1._tryCatch; } });
+const generateJsonSchemaFromData_1 = require("./json-schema/from-data/generateJsonSchemaFromData");
+Object.defineProperty(exports, "generateJsonSchemaFromData", { enumerable: true, get: function () { return generateJsonSchemaFromData_1.generateJsonSchemaFromData; } });
 const jsonSchema_cnst_1 = require("./json-schema/jsonSchema.cnst");
 Object.defineProperty(exports, "JSON_SCHEMA_ORDER", { enumerable: true, get: function () { return jsonSchema_cnst_1.JSON_SCHEMA_ORDER; } });
 const jsonSchema_util_1 = require("./json-schema/jsonSchema.util");
@@ -198,3 +200,5 @@ Object.defineProperty(exports, "_gb", { enumerable: true, get: function () { ret
 Object.defineProperty(exports, "_hb", { enumerable: true, get: function () { return size_util_1._hb; } });
 Object.defineProperty(exports, "_kb", { enumerable: true, get: function () { return size_util_1._kb; } });
 Object.defineProperty(exports, "_mb", { enumerable: true, get: function () { return size_util_1._mb; } });
+const is_1 = require("./vendor/is");
+Object.defineProperty(exports, "is", { enumerable: true, get: function () { return is_1.is; } });

package/dist/json-schema/from-data/generateJsonSchemaFromData.d.ts

@@ -0,0 +1,7 @@
+import { JsonSchema } from '../..';
+/**
+ * Each row must be an object (current limitation).
+ *
+ * `additionalProperties` is set to `true`, cause it's safer.
+ */
+export declare function generateJsonSchemaFromData<T = unknown>(rows: any[]): JsonSchema<T>;

package/dist/json-schema/from-data/generateJsonSchemaFromData.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateJsonSchemaFromData = void 0;
+const __1 = require("../..");
+/**
+ * Each row must be an object (current limitation).
+ *
+ * `additionalProperties` is set to `true`, cause it's safer.
+ */
+function generateJsonSchemaFromData(rows) {
+    return objectToJsonSchema(rows);
+}
+exports.generateJsonSchemaFromData = generateJsonSchemaFromData;
+function objectToJsonSchema(rows) {
+    const typesByKey = {};
+    rows.forEach(r => {
+        Object.keys(r).forEach(key => {
+            typesByKey[key] || (typesByKey[key] = new Set());
+            typesByKey[key].add(getTypeOfValue(r[key]));
+        });
+    });
+    const s = {
+        type: 'object',
+        properties: {},
+        required: [],
+        additionalProperties: true,
+    };
+    (0, __1._stringMapEntries)(typesByKey).forEach(([key, types]) => {
+        const schema = mergeTypes([...types], rows.map(r => r[key]));
+        if (!schema)
+            return;
+        s.properties[key] = schema;
+    });
+    // console.log(typesByKey)
+    return s;
+}
+function mergeTypes(types, samples) {
+    // skip "undefined" types
+    types = types.filter(t => t !== 'undefined');
+    if (!types.length)
+        return undefined;
+    if (types.length > 1) {
+        // oneOf
+        const s = {
+            oneOf: types.map(type => mergeTypes([type], samples)),
+        };
+        return s;
+    }
+    const type = types[0];
+    if (type === 'null') {
+        return {
+            type: 'null',
+        };
+    }
+    if (type === 'boolean') {
+        return {
+            type: 'boolean',
+        };
+    }
+    if (type === 'string') {
+        return {
+            type: 'string',
+        };
+    }
+    if (type === 'number') {
+        return {
+            type: 'number',
+        };
+    }
+    if (type === 'object') {
+        return objectToJsonSchema(samples.filter((r) => r && typeof r === 'object'));
+    }
+    if (type === 'array') {
+        // possible feature: detect if it's a tuple
+        // currently assume no-tuple
+        const items = samples.filter(r => Array.isArray(r)).flat(1);
+        const itemTypes = (0, __1._uniq)(items.map(i => getTypeOfValue(i)));
+        return {
+            type: 'array',
+            items: mergeTypes(itemTypes, items),
+        };
+    }
+}
+function getTypeOfValue(v) {
+    if (v === null)
+        return 'null';
+    if (Array.isArray(v))
+        return 'array';
+    return typeof v;
+}

package/dist/json-schema/jsonSchema.model.d.ts

@@ -13,6 +13,13 @@ export interface JsonSchemaAny<T = unknown> {
     if?: JsonSchema;
     then?: JsonSchema;
     else?: JsonSchema;
+    /**
+     * https://ajv.js.org/packages/ajv-keywords.html#instanceof
+     *
+     * Useful for Node.js Buffer, you can use it like:
+     * `instanceof: 'Buffer'`
+     */
+    instanceof?: string | string[];
     /**
      * This is a temporary "intermediate AST" field that is used inside the parser.
      * In the final schema this field will NOT be present.

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

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import { BaseDBEntity, JsonSchemaAllOf, JsonSchemaArray, JsonSchemaOneOf, JsonSchemaTuple, SavedDBEntity } from '../index';
 import { JsonSchema, JsonSchemaAny, JsonSchemaBoolean, JsonSchemaConst, JsonSchemaEnum, JsonSchemaNull, JsonSchemaNumber, JsonSchemaObject, JsonSchemaRef, JsonSchemaString } from './jsonSchema.model';
 export interface JsonSchemaBuilder<T = unknown> {
@@ -14,6 +15,7 @@ export declare const jsonSchema: {
     ref<T_2 = unknown>($ref: string): JsonSchemaAnyBuilder<T_2, JsonSchemaRef<T_2>>;
     enum<T_3 = unknown>(enumValues: T_3[]): JsonSchemaAnyBuilder<T_3, JsonSchemaEnum<T_3>>;
     boolean(): JsonSchemaAnyBuilder<boolean, JsonSchemaBoolean>;
+    buffer(): JsonSchemaAnyBuilder<Buffer, JsonSchemaAny<Buffer>>;
     number(): JsonSchemaNumberBuilder;
     integer(): JsonSchemaNumberBuilder;
     unixTimestamp(): JsonSchemaNumberBuilder;
@@ -43,6 +45,7 @@ export declare class JsonSchemaAnyBuilder<T = unknown, SCHEMA_TYPE extends JsonS
     default(v: any): this;
     oneOf(schemas: JsonSchema[]): this;
     allOf(schemas: JsonSchema[]): this;
+    instanceof(of: string): this;
     optional(optional?: boolean): this;
     /**
      * Produces a "clean schema object" without methods.

package/dist/json-schema/jsonSchemaBuilder.js

@@ -35,6 +35,11 @@ exports.jsonSchema = {
             type: 'boolean',
         });
     },
+    buffer() {
+        return new JsonSchemaAnyBuilder({
+            instanceof: 'Buffer',
+        });
+    },
     // number types
     number() {
         return new JsonSchemaNumberBuilder();
@@ -127,6 +132,10 @@ class JsonSchemaAnyBuilder {
         Object.assign(this.schema, { allOf: schemas });
         return this;
     }
+    instanceof(of) {
+        this.schema.instanceof = of;
+        return this;
+    }
     optional(optional = true) {
         if (optional) {
             this.schema.optionalField = true;

package/dist/string/stringifyAny.d.ts

@@ -2,7 +2,7 @@ import { Reviver } from '../types';
 export declare type JsonStringifyFunction = (obj: any, reviver?: Reviver, space?: number) => string;
 export interface StringifyAnyOptions {
     /**
-     * @default 1000
+     * @default 10_000
      * Default limit is less than in Node, cause it's likely to be used e.g in Browser alert()
      */
     maxLen?: number;

package/dist/string/stringifyAny.js

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

package/dist/typeFest.d.ts

@@ -251,4 +251,20 @@ export declare type ConditionalPick<Base, Condition> = Pick<Base, ConditionalKey
  @category Basic
  */
 export declare type Class<T = any> = new (...args: any[]) => T;
+/**
+ Matches any [typed array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray), like `Uint8Array` or `Float64Array`.
+ */
+export declare type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | BigInt64Array | BigUint64Array;
+declare global {
+    interface SymbolConstructor {
+        readonly observable: symbol;
+    }
+}
+/**
+ Matches a value that is like an [Observable](https://github.com/tc39/proposal-observable).
+ */
+export interface ObservableLike {
+    subscribe(observer: (value: unknown) => void): void;
+    [Symbol.observable](): ObservableLike;
+}
 export {};

package/dist/vendor/is.d.ts

@@ -0,0 +1,224 @@
+/// <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"];
+declare type ObjectTypeName = typeof objectTypeNames[number];
+declare const primitiveTypeNames: readonly ["null", "undefined", "string", "number", "bigint", "boolean", "symbol"];
+declare type PrimitiveTypeName = typeof primitiveTypeNames[number];
+export declare 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<any>;
+    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 declare 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 {};