@naturalcycles/nodejs-lib 15.51.2 → 15.53.0

package/dist/validation/ajv/jsonSchemaBuilder.d.ts

@@ -8,6 +8,10 @@ export declare const j: {
         dbEntity: typeof objectDbEntity;
         infer: typeof objectInfer;
         any(): JsonSchemaObjectBuilder<AnyObject, AnyObject, false>;
+        /**
+         * Builds the object schema with the indicated `keys` and uses the `schema` for their validation.
+         */
+        withEnumKeys<const T extends readonly (string | number)[] | StringEnum | NumberEnum, S extends JsonSchemaTerminal<any, any, any>, K extends string | number = EnumKeyUnion<T>>(keys: T, schema: S): JsonSchemaObjectBuilder<Record<K, SchemaIn<S>>, Record<K, SchemaOut<S>>>;
     };
     array<IN, OUT, Opt>(itemSchema: JsonSchemaAnyBuilder<IN, OUT, Opt>): JsonSchemaArrayBuilder<IN, OUT, Opt>;
     set<IN, OUT, Opt>(itemSchema: JsonSchemaAnyBuilder<IN, OUT, Opt>): JsonSchemaSet2Builder<IN, OUT, Opt>;
@@ -110,6 +114,7 @@ export declare class JsonSchemaStringBuilder<IN extends string = string, OUT = I
      */
     ianaTimezone(): JsonSchemaEnumBuilder<string | IANATimezone, IANATimezone, false>;
     base64Url(): this;
+    uuid(): this;
 }
 export interface JsonSchemaStringEmailOptions {
     checkTLD: boolean;
@@ -158,7 +163,7 @@ export declare class JsonSchemaBooleanBuilder<IN extends boolean = boolean, OUT
     constructor();
 }
 export declare class JsonSchemaObjectBuilder<IN extends AnyObject, OUT extends AnyObject, Opt extends boolean = false> extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
-    constructor(props?: AnyObject);
+    constructor(props?: AnyObject, opt?: JsonSchemaObjectBuilderOpts);
     addProperties(props: AnyObject): this;
     /**
      * When set, the validation will not strip away properties that are not specified explicitly in the schema.
@@ -172,6 +177,9 @@ export declare class JsonSchemaObjectBuilder<IN extends AnyObject, OUT extends A
     minProperties(minProperties: number): this;
     maxProperties(maxProperties: number): this;
 }
+interface JsonSchemaObjectBuilderOpts {
+    hasIsOfTypeCheck?: false;
+}
 export declare class JsonSchemaObjectInferringBuilder<PROPS extends Record<string, JsonSchemaAnyBuilder<any, any, any>>, Opt extends boolean = false> extends JsonSchemaAnyBuilder<Expand<{
     [K in keyof PROPS as PROPS[K] extends JsonSchemaAnyBuilder<any, any, infer IsOpt> ? IsOpt extends true ? never : K : never]: PROPS[K] extends JsonSchemaAnyBuilder<infer IN, any, any> ? IN : never;
 } & {
@@ -326,4 +334,7 @@ interface JsonBuilderRuleOpt {
      */
     name?: string;
 }
+type EnumKeyUnion<T> = T extends readonly (infer U)[] ? U : T extends StringEnum | NumberEnum ? T[keyof T] : never;
+type SchemaIn<S> = S extends JsonSchemaAnyBuilder<infer IN, any, any> ? IN : never;
+type SchemaOut<S> = S extends JsonSchemaAnyBuilder<any, infer OUT, any> ? OUT : never;
 export {};

package/dist/validation/ajv/jsonSchemaBuilder.js

@@ -5,9 +5,9 @@ import { _uniq } from '@naturalcycles/js-lib/array';
 import { _assert } from '@naturalcycles/js-lib/error';
 import { _deepCopy, _sortObject } from '@naturalcycles/js-lib/object';
 import { _objectAssign, JWT_REGEX, } from '@naturalcycles/js-lib/types';
-import { BASE64URL_REGEX, COUNTRY_CODE_REGEX, CURRENCY_REGEX, IPV4_REGEX, IPV6_REGEX, LANGUAGE_TAG_REGEX, SEMVER_REGEX, SLUG_REGEX, } from '../regexes.js';
+import { BASE64URL_REGEX, COUNTRY_CODE_REGEX, CURRENCY_REGEX, IPV4_REGEX, IPV6_REGEX, LANGUAGE_TAG_REGEX, SEMVER_REGEX, SLUG_REGEX, UUID_REGEX, } from '../regexes.js';
 import { TIMEZONES } from '../timezones.js';
-import { isEveryItemNumber, isEveryItemString, JSON_SCHEMA_ORDER, mergeJsonSchemaObjects, } from './jsonSchemaBuilder.util.js';
+import { isEveryItemNumber, isEveryItemPrimitive, isEveryItemString, JSON_SCHEMA_ORDER, mergeJsonSchemaObjects, } from './jsonSchemaBuilder.util.js';
 export const j = {
     string() {
         return new JsonSchemaStringBuilder();
@@ -24,6 +24,30 @@ export const j = {
         any() {
             return j.object({}).allowAdditionalProperties();
         },
+        /**
+         * Builds the object schema with the indicated `keys` and uses the `schema` for their validation.
+         */
+        withEnumKeys(keys, schema) {
+            let enumValues;
+            if (Array.isArray(keys)) {
+                _assert(isEveryItemPrimitive(keys), 'Every item in the key list should be string, number or symbol');
+                enumValues = keys;
+            }
+            else if (typeof keys === 'object') {
+                const enumType = getEnumType(keys);
+                _assert(enumType === 'NumberEnum' || enumType === 'StringEnum', 'The key list should be StringEnum or NumberEnum');
+                if (enumType === 'NumberEnum') {
+                    enumValues = _numberEnumValues(keys);
+                }
+                else if (enumType === 'StringEnum') {
+                    enumValues = _stringEnumValues(keys);
+                }
+            }
+            _assert(enumValues, 'The key list should be an array of values, NumberEnum or a StrinEnum');
+            const typedValues = enumValues;
+            const props = Object.fromEntries(typedValues.map(key => [key, schema]));
+            return new JsonSchemaObjectBuilder(props, { hasIsOfTypeCheck: false });
+        },
     }),
     array(itemSchema) {
         return new JsonSchemaArrayBuilder(itemSchema);
@@ -301,6 +325,9 @@ export class JsonSchemaStringBuilder extends JsonSchemaAnyBuilder {
             msg: 'contains characters not allowed in Base64 URL characterset',
         });
     }
+    uuid() {
+        return this.regex(UUID_REGEX, { msg: 'is an invalid UUID' });
+    }
 }
 export class JsonSchemaIsoDateBuilder extends JsonSchemaAnyBuilder {
     constructor() {
@@ -441,13 +468,13 @@ export class JsonSchemaBooleanBuilder extends JsonSchemaAnyBuilder {
     }
 }
 export class JsonSchemaObjectBuilder extends JsonSchemaAnyBuilder {
-    constructor(props) {
+    constructor(props, opt) {
         super({
             type: 'object',
             properties: {},
             required: [],
             additionalProperties: false,
-            hasIsOfTypeCheck: true,
+            hasIsOfTypeCheck: opt?.hasIsOfTypeCheck ?? true,
         });
         if (props)
             this.addProperties(props);

package/dist/validation/ajv/jsonSchemaBuilder.util.d.ts

@@ -9,3 +9,4 @@ export declare const JSON_SCHEMA_ORDER: string[];
 export declare function mergeJsonSchemaObjects<T1 extends AnyObject, T2 extends AnyObject>(schema1: JsonSchema<T1>, schema2: JsonSchema<T2>): JsonSchema<T1 & T2>;
 export declare function isEveryItemString(arr: any[]): boolean;
 export declare function isEveryItemNumber(arr: any[]): boolean;
+export declare function isEveryItemPrimitive(arr: any[]): boolean;

package/dist/validation/ajv/jsonSchemaBuilder.util.js

@@ -77,3 +77,11 @@ export function isEveryItemNumber(arr) {
     }
     return true;
 }
+export function isEveryItemPrimitive(arr) {
+    for (const item of arr) {
+        if (typeof item !== 'number' && typeof item !== 'string' && typeof item !== 'symbol') {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/validation/regexes.d.ts

@@ -1,6 +1,7 @@
 export declare const BASE62_REGEX: RegExp;
 export declare const BASE64_REGEX: RegExp;
 export declare const BASE64URL_REGEX: RegExp;
+export declare const UUID_REGEX: RegExp;
 export declare const COUNTRY_CODE_REGEX: RegExp;
 export declare const CURRENCY_REGEX: RegExp;
 /**

package/dist/validation/regexes.js

@@ -1,6 +1,8 @@
 export const BASE62_REGEX = /^[a-zA-Z0-9]+$/;
 export const BASE64_REGEX = /^[a-zA-Z0-9+/]+={0,2}$/;
 export const BASE64URL_REGEX = /^[a-zA-Z0-9_-]+$/;
+// from `ajv-formats`
+export const UUID_REGEX = /^(?:urn:uuid:)?[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i;
 export const COUNTRY_CODE_REGEX = /^[A-Z]{2}$/;
 export const CURRENCY_REGEX = /^[A-Z]{3}$/;
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.51.2",
+  "version": "15.53.0",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@types/js-yaml": "^4",

package/src/validation/ajv/jsonSchemaBuilder.ts

@@ -35,10 +35,12 @@ import {
   LANGUAGE_TAG_REGEX,
   SEMVER_REGEX,
   SLUG_REGEX,
+  UUID_REGEX,
 } from '../regexes.js'
 import { TIMEZONES } from '../timezones.js'
 import {
   isEveryItemNumber,
+  isEveryItemPrimitive,
   isEveryItemString,
   JSON_SCHEMA_ORDER,
   mergeJsonSchemaObjects,
@@ -63,6 +65,48 @@ export const j = {
     any() {
       return j.object<AnyObject>({}).allowAdditionalProperties()
     },
+
+    /**
+     * Builds the object schema with the indicated `keys` and uses the `schema` for their validation.
+     */
+    withEnumKeys<
+      const T extends readonly (string | number)[] | StringEnum | NumberEnum,
+      S extends JsonSchemaTerminal<any, any, any>,
+      K extends string | number = EnumKeyUnion<T>,
+    >(
+      keys: T,
+      schema: S,
+    ): JsonSchemaObjectBuilder<Record<K, SchemaIn<S>>, Record<K, SchemaOut<S>>> {
+      let enumValues: readonly (string | number)[] | undefined
+      if (Array.isArray(keys)) {
+        _assert(
+          isEveryItemPrimitive(keys),
+          'Every item in the key list should be string, number or symbol',
+        )
+        enumValues = keys
+      } else if (typeof keys === 'object') {
+        const enumType = getEnumType(keys)
+        _assert(
+          enumType === 'NumberEnum' || enumType === 'StringEnum',
+          'The key list should be StringEnum or NumberEnum',
+        )
+        if (enumType === 'NumberEnum') {
+          enumValues = _numberEnumValues(keys as NumberEnum)
+        } else if (enumType === 'StringEnum') {
+          enumValues = _stringEnumValues(keys as StringEnum)
+        }
+      }
+
+      _assert(enumValues, 'The key list should be an array of values, NumberEnum or a StrinEnum')
+
+      const typedValues = enumValues as readonly K[]
+      const props = Object.fromEntries(typedValues.map(key => [key, schema])) as any
+
+      return new JsonSchemaObjectBuilder<Record<K, SchemaIn<S>>, Record<K, SchemaOut<S>>, false>(
+        props,
+        { hasIsOfTypeCheck: false },
+      )
+    },
   }),
 
   array<IN, OUT, Opt>(
@@ -414,6 +458,10 @@ export class JsonSchemaStringBuilder<
       msg: 'contains characters not allowed in Base64 URL characterset',
     })
   }
+
+  uuid(): this {
+    return this.regex(UUID_REGEX, { msg: 'is an invalid UUID' })
+  }
 }
 
 export interface JsonSchemaStringEmailOptions {
@@ -617,13 +665,13 @@ export class JsonSchemaObjectBuilder<
   OUT extends AnyObject,
   Opt extends boolean = false,
 > extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
-  constructor(props?: AnyObject) {
+  constructor(props?: AnyObject, opt?: JsonSchemaObjectBuilderOpts) {
     super({
       type: 'object',
       properties: {},
       required: [],
       additionalProperties: false,
-      hasIsOfTypeCheck: true,
+      hasIsOfTypeCheck: opt?.hasIsOfTypeCheck ?? true,
     })
 
     if (props) this.addProperties(props)
@@ -692,6 +740,10 @@ export class JsonSchemaObjectBuilder<
   }
 }
 
+interface JsonSchemaObjectBuilderOpts {
+  hasIsOfTypeCheck?: false
+}
+
 export class JsonSchemaObjectInferringBuilder<
   PROPS extends Record<string, JsonSchemaAnyBuilder<any, any, any>>,
   Opt extends boolean = false,
@@ -1049,3 +1101,15 @@ interface JsonBuilderRuleOpt {
    */
   name?: string
 }
+
+type EnumKeyUnion<T> =
+  // array of literals -> union of its elements
+  T extends readonly (infer U)[]
+    ? U
+    : // enum object -> union of its values
+      T extends StringEnum | NumberEnum
+      ? T[keyof T]
+      : never
+
+type SchemaIn<S> = S extends JsonSchemaAnyBuilder<infer IN, any, any> ? IN : never
+type SchemaOut<S> = S extends JsonSchemaAnyBuilder<any, infer OUT, any> ? OUT : never

package/src/validation/ajv/jsonSchemaBuilder.util.ts

@@ -90,3 +90,12 @@ export function isEveryItemNumber(arr: any[]): boolean {
   }
   return true
 }
+
+export function isEveryItemPrimitive(arr: any[]): boolean {
+  for (const item of arr) {
+    if (typeof item !== 'number' && typeof item !== 'string' && typeof item !== 'symbol') {
+      return false
+    }
+  }
+  return true
+}

package/src/validation/regexes.ts

@@ -1,6 +1,8 @@
 export const BASE62_REGEX = /^[a-zA-Z0-9]+$/
 export const BASE64_REGEX = /^[a-zA-Z0-9+/]+={0,2}$/
 export const BASE64URL_REGEX = /^[a-zA-Z0-9_-]+$/
+// from `ajv-formats`
+export const UUID_REGEX = /^(?:urn:uuid:)?[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i
 export const COUNTRY_CODE_REGEX = /^[A-Z]{2}$/
 export const CURRENCY_REGEX = /^[A-Z]{3}$/
 /**