@naturalcycles/js-lib 14.45.0 → 14.46.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [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)
 
 

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';
@@ -52,4 +53,4 @@ import { AsyncMapper, AsyncPredicate, BaseDBEntity, BatchResult, InstanceId, Iso
 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 { 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, };
+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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 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.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;
+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");

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-esm/index.js

@@ -16,6 +16,7 @@ import { ErrorMode } from './error/errorMode';
 import { HttpError } from './error/http.error';
 import { _try } from './error/try';
 import { _TryCatch, _tryCatch } from './error/tryCatch';
+import { generateJsonSchemaFromData } from './json-schema/from-data/generateJsonSchemaFromData';
 import { JSON_SCHEMA_ORDER } from './json-schema/jsonSchema.cnst';
 import { mergeJsonSchemaObjects } from './json-schema/jsonSchema.util';
 import { jsonSchema, JsonSchemaAnyBuilder, } from './json-schema/jsonSchemaBuilder';
@@ -47,4 +48,4 @@ import { _ms, _since } from './time/time.util';
 import { _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 { 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, };
+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-esm/json-schema/from-data/generateJsonSchemaFromData.js

@@ -0,0 +1,86 @@
+import { _stringMapEntries, _uniq, } from '../..';
+/**
+ * Each row must be an object (current limitation).
+ *
+ * `additionalProperties` is set to `true`, cause it's safer.
+ */
+export function generateJsonSchemaFromData(rows) {
+    return objectToJsonSchema(rows);
+}
+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,
+    };
+    _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 = _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/package.json

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

package/src/index.ts

@@ -68,6 +68,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,
@@ -424,4 +425,5 @@ export {
   jsonSchema,
   JsonSchemaAnyBuilder,
   JSON_SCHEMA_ORDER,
+  generateJsonSchemaFromData,
 }

package/src/json-schema/from-data/generateJsonSchemaFromData.ts

@@ -0,0 +1,120 @@
+import {
+  JsonSchema,
+  JsonSchemaArray,
+  JsonSchemaBoolean,
+  JsonSchemaNull,
+  JsonSchemaNumber,
+  JsonSchemaObject,
+  JsonSchemaOneOf,
+  JsonSchemaString,
+  StringMap,
+  _stringMapEntries,
+  _uniq,
+} from '../..'
+
+type PrimitiveType = 'undefined' | 'null' | 'boolean' | 'string' | 'number'
+type Type = PrimitiveType | 'array' | 'object'
+
+/**
+ * Each row must be an object (current limitation).
+ *
+ * `additionalProperties` is set to `true`, cause it's safer.
+ */
+export function generateJsonSchemaFromData<T = unknown>(rows: any[]): JsonSchema<T> {
+  return objectToJsonSchema(rows as any) as JsonSchema<T>
+}
+
+function objectToJsonSchema(rows: Record<string, any>[]): JsonSchema {
+  const typesByKey: StringMap<Set<Type>> = {}
+
+  rows.forEach(r => {
+    Object.keys(r).forEach(key => {
+      typesByKey[key] ||= new Set<Type>()
+      typesByKey[key]!.add(getTypeOfValue(r[key]))
+    })
+  })
+
+  const s: JsonSchemaObject = {
+    type: 'object',
+    properties: {},
+    required: [],
+    additionalProperties: true,
+  }
+
+  _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: Type[], samples: any[]): JsonSchema | undefined {
+  // skip "undefined" types
+  types = types.filter(t => t !== 'undefined')
+
+  if (!types.length) return undefined
+
+  if (types.length > 1) {
+    // oneOf
+    const s: JsonSchemaOneOf = {
+      oneOf: types.map(type => mergeTypes([type], samples)!),
+    }
+
+    return s
+  }
+
+  const type = types[0]!
+
+  if (type === 'null') {
+    return {
+      type: 'null',
+    } as JsonSchemaNull
+  }
+
+  if (type === 'boolean') {
+    return {
+      type: 'boolean',
+    } as JsonSchemaBoolean
+  }
+
+  if (type === 'string') {
+    return {
+      type: 'string',
+    } as JsonSchemaString
+  }
+
+  if (type === 'number') {
+    return {
+      type: 'number',
+    } as JsonSchemaNumber
+  }
+
+  if (type === 'object') {
+    return objectToJsonSchema(samples.filter((r: any) => 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 = _uniq(items.map(i => getTypeOfValue(i)))
+
+    return {
+      type: 'array',
+      items: mergeTypes(itemTypes, items),
+    } as JsonSchemaArray
+  }
+}
+
+function getTypeOfValue(v: any): Type {
+  if (v === null) return 'null'
+  if (Array.isArray(v)) return 'array'
+  return typeof v as Type
+}