@naturalcycles/nodejs-lib 15.54.0 → 15.55.0

package/dist/validation/ajv/ajvSchema.js

@@ -59,6 +59,12 @@ export class AjvSchema {
         else {
             jsonSchema = schema;
         }
+        // This is our own helper which marks a schema as optional
+        // in case it is going to be used in an object schema,
+        // where we need to mark the given property as not-required.
+        // But once all compilation is done, the presence of this field
+        // really upsets Ajv.
+        delete jsonSchema.optionalField;
         const ajvSchema = new AjvSchema(jsonSchema, cfg);
         AjvSchema.cacheAjvSchema(schema, ajvSchema);
         return ajvSchema;

package/dist/validation/ajv/getAjv.js

@@ -91,7 +91,7 @@ export function createAjv(opt) {
     });
     ajv.addKeyword({
         keyword: 'instanceof',
-        modifying: true,
+        modifying: false,
         schemaType: 'string',
         validate(instanceOf, data, _schema, _ctx) {
             if (typeof data !== 'object')
@@ -354,6 +354,23 @@ export function createAjv(opt) {
         keyword: 'hasIsOfTypeCheck',
         schemaType: 'boolean',
     });
+    ajv.addKeyword({
+        keyword: 'optionalValues',
+        type: ['string', 'number', 'boolean'],
+        modifying: true,
+        errors: false,
+        schemaType: 'array',
+        validate: function validate(optionalValues, data, _schema, ctx) {
+            if (!optionalValues)
+                return true;
+            if (!optionalValues.includes(data))
+                return true;
+            if (ctx?.parentData && ctx.parentDataProperty) {
+                ctx.parentData[ctx.parentDataProperty] = undefined;
+            }
+            return true;
+        },
+    });
     return ajv;
 }
 const monthLengths = [0, 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];

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

@@ -19,6 +19,9 @@ export declare const j: {
     buffer(): JsonSchemaBufferBuilder;
     enum<const T extends readonly (string | number | boolean | null)[] | StringEnum | NumberEnum>(input: T, opt?: JsonBuilderRuleOpt): JsonSchemaEnumBuilder<T extends readonly (infer U)[] ? U : T extends StringEnum ? T[keyof T] : T extends NumberEnum ? T[keyof T] : never>;
     oneOf<B extends readonly JsonSchemaAnyBuilder<any, any, boolean>[], IN = BuilderInUnion<B>, OUT = BuilderOutUnion<B>>(items: [...B]): JsonSchemaAnyBuilder<IN, OUT, false>;
+    and(): {
+        silentBob: () => never;
+    };
 };
 export declare class JsonSchemaTerminal<IN, OUT, Opt> {
     protected schema: JsonSchema;
@@ -73,8 +76,15 @@ export declare class JsonSchemaAnyBuilder<IN, OUT, Opt> extends JsonSchemaTermin
      */
     final(): JsonSchemaTerminal<IN, OUT, Opt>;
 }
-export declare class JsonSchemaStringBuilder<IN extends string = string, OUT = IN, Opt extends boolean = false> extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
+export declare class JsonSchemaStringBuilder<IN extends string | undefined = string, OUT = IN, Opt extends boolean = false> extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
     constructor();
+    /**
+     * @param optionalValues List of values that should be considered/converted as `undefined`.
+     *
+     * This `optionalValues` feature only works when the current schema is nested in an object or array schema,
+     * due to how mutability works in Ajv.
+     */
+    optional(optionalValues?: string[]): JsonSchemaStringBuilder<IN | undefined, OUT | undefined, true>;
     regex(pattern: RegExp, opt?: JsonBuilderRuleOpt): this;
     pattern(pattern: string, opt?: JsonBuilderRuleOpt): this;
     minLength(minLength: number): this;
@@ -134,8 +144,15 @@ export interface JsonSchemaIsoDateOptions {
     after?: string;
     sameOrAfter?: string;
 }
-export declare class JsonSchemaNumberBuilder<IN extends number = number, OUT = IN, Opt extends boolean = false> extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
+export declare class JsonSchemaNumberBuilder<IN extends number | undefined = number, OUT = IN, Opt extends boolean = false> extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
     constructor();
+    /**
+     * @param optionalValues List of values that should be considered/converted as `undefined`.
+     *
+     * This `optionalValues` feature only works when the current schema is nested in an object or array schema,
+     * due to how mutability works in Ajv.
+     */
+    optional(optionalValues?: number[]): JsonSchemaNumberBuilder<IN | undefined, OUT | undefined, true>;
     integer(): this;
     branded<B extends number>(): JsonSchemaNumberBuilder<B, B, Opt>;
     multipleOf(multipleOf: number): this;
@@ -160,8 +177,15 @@ export declare class JsonSchemaNumberBuilder<IN extends number = number, OUT = I
     utcOffset(): this;
     utcOffsetHour(): this;
 }
-export declare class JsonSchemaBooleanBuilder<IN extends boolean = boolean, OUT = IN, Opt extends boolean = false> extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
+export declare class JsonSchemaBooleanBuilder<IN extends boolean | undefined = boolean, OUT = IN, Opt extends boolean = false> extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
     constructor();
+    /**
+     * @param optionalValue One of the two possible boolean values that should be considered/converted as `undefined`.
+     *
+     * This `optionalValue` feature only works when the current schema is nested in an object or array schema,
+     * due to how mutability works in Ajv.
+     */
+    optional(optionalValue?: boolean): JsonSchemaBooleanBuilder<IN | undefined, OUT | undefined, true>;
 }
 export declare class JsonSchemaObjectBuilder<IN extends AnyObject, OUT extends AnyObject, Opt extends boolean = false> extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
     constructor(props?: AnyObject, opt?: JsonSchemaObjectBuilderOpts);
@@ -276,6 +300,7 @@ export interface JsonSchema<IN = unknown, OUT = IN> {
     maxItems?: number;
     uniqueItems?: boolean;
     enum?: any;
+    hasIsOfTypeCheck?: boolean;
     email?: JsonSchemaStringEmailOptions;
     Set2?: JsonSchema;
     Buffer?: true;
@@ -289,7 +314,7 @@ export interface JsonSchema<IN = unknown, OUT = IN> {
         truncate?: number;
     };
     errorMessages?: StringMap<string>;
-    hasIsOfTypeCheck?: boolean;
+    optionalValues?: (string | number | boolean)[];
 }
 declare function object(props: AnyObject): never;
 declare function object<IN extends AnyObject>(props: {

package/dist/validation/ajv/jsonSchemaBuilder.js

@@ -101,6 +101,13 @@ export const j = {
             oneOf: schemas,
         });
     },
+    and() {
+        return {
+            silentBob: () => {
+                throw new Error('...strike back!');
+            },
+        };
+    },
 };
 const TS_2500 = 16725225600; // 2500-01-01
 const TS_2500_MILLIS = TS_2500 * 1000;
@@ -227,6 +234,16 @@ export class JsonSchemaStringBuilder extends JsonSchemaAnyBuilder {
             type: 'string',
         });
     }
+    /**
+     * @param optionalValues List of values that should be considered/converted as `undefined`.
+     *
+     * This `optionalValues` feature only works when the current schema is nested in an object or array schema,
+     * due to how mutability works in Ajv.
+     */
+    optional(optionalValues) {
+        _objectAssign(this.schema, { optionalValues });
+        return super.optional();
+    }
     regex(pattern, opt) {
         return this.pattern(pattern.source, opt);
     }
@@ -379,6 +396,16 @@ export class JsonSchemaNumberBuilder extends JsonSchemaAnyBuilder {
             type: 'number',
         });
     }
+    /**
+     * @param optionalValues List of values that should be considered/converted as `undefined`.
+     *
+     * This `optionalValues` feature only works when the current schema is nested in an object or array schema,
+     * due to how mutability works in Ajv.
+     */
+    optional(optionalValues) {
+        _objectAssign(this.schema, { optionalValues });
+        return super.optional();
+    }
     integer() {
         _objectAssign(this.schema, { type: 'integer' });
         return this;
@@ -477,6 +504,18 @@ export class JsonSchemaBooleanBuilder extends JsonSchemaAnyBuilder {
             type: 'boolean',
         });
     }
+    /**
+     * @param optionalValue One of the two possible boolean values that should be considered/converted as `undefined`.
+     *
+     * This `optionalValue` feature only works when the current schema is nested in an object or array schema,
+     * due to how mutability works in Ajv.
+     */
+    optional(optionalValue) {
+        if (typeof optionalValue !== 'undefined') {
+            _objectAssign(this.schema, { optionalValues: [optionalValue] });
+        }
+        return super.optional();
+    }
 }
 export class JsonSchemaObjectBuilder extends JsonSchemaAnyBuilder {
     constructor(props, opt) {

package/package.json

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

package/src/validation/ajv/ajvSchema.ts

@@ -79,6 +79,13 @@ export class AjvSchema<IN = unknown, OUT = IN> {
       jsonSchema = schema
     }
 
+    // This is our own helper which marks a schema as optional
+    // in case it is going to be used in an object schema,
+    // where we need to mark the given property as not-required.
+    // But once all compilation is done, the presence of this field
+    // really upsets Ajv.
+    delete jsonSchema.optionalField
+
     const ajvSchema = new AjvSchema<IN, OUT>(jsonSchema, cfg)
     AjvSchema.cacheAjvSchema(schema, ajvSchema)
 

package/src/validation/ajv/getAjv.ts

@@ -109,7 +109,7 @@ export function createAjv(opt?: Options): Ajv {
 
   ajv.addKeyword({
     keyword: 'instanceof',
-    modifying: true,
+    modifying: false,
     schemaType: 'string',
     validate(instanceOf: string, data: unknown, _schema, _ctx) {
       if (typeof data !== 'object') return false
@@ -396,6 +396,30 @@ export function createAjv(opt?: Options): Ajv {
     schemaType: 'boolean',
   })
 
+  ajv.addKeyword({
+    keyword: 'optionalValues',
+    type: ['string', 'number', 'boolean'],
+    modifying: true,
+    errors: false,
+    schemaType: 'array',
+    validate: function validate(
+      optionalValues: (string | number | boolean)[],
+      data: string | number | boolean,
+      _schema,
+      ctx,
+    ) {
+      if (!optionalValues) return true
+
+      if (!optionalValues.includes(data)) return true
+
+      if (ctx?.parentData && ctx.parentDataProperty) {
+        ctx.parentData[ctx.parentDataProperty] = undefined
+      }
+
+      return true
+    },
+  })
+
   return ajv
 }
 

package/src/validation/ajv/jsonSchemaBuilder.ts

@@ -193,6 +193,14 @@ export const j = {
       oneOf: schemas,
     })
   },
+
+  and() {
+    return {
+      silentBob: () => {
+        throw new Error('...strike back!')
+      },
+    }
+  },
 }
 
 const TS_2500 = 16725225600 // 2500-01-01
@@ -338,7 +346,7 @@ export class JsonSchemaAnyBuilder<IN, OUT, Opt> extends JsonSchemaTerminal<IN, O
 }
 
 export class JsonSchemaStringBuilder<
-  IN extends string = string,
+  IN extends string | undefined = string,
   OUT = IN,
   Opt extends boolean = false,
 > extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
@@ -348,6 +356,23 @@ export class JsonSchemaStringBuilder<
     })
   }
 
+  /**
+   * @param optionalValues List of values that should be considered/converted as `undefined`.
+   *
+   * This `optionalValues` feature only works when the current schema is nested in an object or array schema,
+   * due to how mutability works in Ajv.
+   */
+  override optional(
+    optionalValues?: string[],
+  ): JsonSchemaStringBuilder<IN | undefined, OUT | undefined, true> {
+    _objectAssign(this.schema, { optionalValues })
+    return super.optional() as unknown as JsonSchemaStringBuilder<
+      IN | undefined,
+      OUT | undefined,
+      true
+    >
+  }
+
   regex(pattern: RegExp, opt?: JsonBuilderRuleOpt): this {
     return this.pattern(pattern.source, opt)
   }
@@ -540,7 +565,7 @@ export interface JsonSchemaIsoDateOptions {
 }
 
 export class JsonSchemaNumberBuilder<
-  IN extends number = number,
+  IN extends number | undefined = number,
   OUT = IN,
   Opt extends boolean = false,
 > extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
@@ -550,6 +575,23 @@ export class JsonSchemaNumberBuilder<
     })
   }
 
+  /**
+   * @param optionalValues List of values that should be considered/converted as `undefined`.
+   *
+   * This `optionalValues` feature only works when the current schema is nested in an object or array schema,
+   * due to how mutability works in Ajv.
+   */
+  override optional(
+    optionalValues?: number[],
+  ): JsonSchemaNumberBuilder<IN | undefined, OUT | undefined, true> {
+    _objectAssign(this.schema, { optionalValues })
+    return super.optional() as unknown as JsonSchemaNumberBuilder<
+      IN | undefined,
+      OUT | undefined,
+      true
+    >
+  }
+
   integer(): this {
     _objectAssign(this.schema, { type: 'integer' })
     return this
@@ -670,7 +712,7 @@ export class JsonSchemaNumberBuilder<
 }
 
 export class JsonSchemaBooleanBuilder<
-  IN extends boolean = boolean,
+  IN extends boolean | undefined = boolean,
   OUT = IN,
   Opt extends boolean = false,
 > extends JsonSchemaAnyBuilder<IN, OUT, Opt> {
@@ -679,6 +721,26 @@ export class JsonSchemaBooleanBuilder<
       type: 'boolean',
     })
   }
+
+  /**
+   * @param optionalValue One of the two possible boolean values that should be considered/converted as `undefined`.
+   *
+   * This `optionalValue` feature only works when the current schema is nested in an object or array schema,
+   * due to how mutability works in Ajv.
+   */
+  override optional(
+    optionalValue?: boolean,
+  ): JsonSchemaBooleanBuilder<IN | undefined, OUT | undefined, true> {
+    if (typeof optionalValue !== 'undefined') {
+      _objectAssign(this.schema, { optionalValues: [optionalValue] })
+    }
+
+    return super.optional() as unknown as JsonSchemaBooleanBuilder<
+      IN | undefined,
+      OUT | undefined,
+      true
+    >
+  }
 }
 
 export class JsonSchemaObjectBuilder<
@@ -1036,6 +1098,8 @@ export interface JsonSchema<IN = unknown, OUT = IN> {
 
   enum?: any
 
+  hasIsOfTypeCheck?: boolean
+
   // Below we add custom Ajv keywords
 
   email?: JsonSchemaStringEmailOptions
@@ -1046,7 +1110,7 @@ export interface JsonSchema<IN = unknown, OUT = IN> {
   instanceof?: string | string[]
   transform?: { trim?: true; toLowerCase?: true; toUpperCase?: true; truncate?: number }
   errorMessages?: StringMap<string>
-  hasIsOfTypeCheck?: boolean
+  optionalValues?: (string | number | boolean)[]
 }
 
 function object(props: AnyObject): never