@naturalcycles/nodejs-lib 15.86.0 → 15.87.0

package/dist/validation/ajv/getAjv.js

@@ -417,6 +417,15 @@ export function createAjv(opt) {
             return validate;
         },
     });
+    // Validates that the value is undefined. Used in record/stringMap with optional value schemas
+    // to allow undefined values in patternProperties via anyOf.
+    ajv.addKeyword({
+        keyword: 'isUndefined',
+        modifying: false,
+        errors: false,
+        schemaType: 'boolean',
+        validate: (_schema, data) => data === undefined,
+    });
     // This is added because Ajv validates the `min/maxProperties` before validating the properties.
     // So, in case of `minProperties(1)` and `{ foo: 'bar' }` Ajv will let it pass, even
     // if the property validation would strip `foo` from the data.

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

@@ -511,6 +511,7 @@ export interface JsonSchema<IN = unknown, OUT = IN> {
     errorMessages?: StringMap<string>;
     optionalValues?: (string | number | boolean | null)[];
     keySchema?: JsonSchema;
+    isUndefined?: true;
     minProperties2?: number;
     exclusiveProperties?: (readonly string[])[];
     anyOfBy?: {

package/dist/validation/ajv/jsonSchemaBuilder.js

@@ -32,11 +32,15 @@ export const j = {
             return j.object({}).allowAdditionalProperties();
         },
         stringMap(schema) {
+            const isValueOptional = schema.getSchema().optionalField;
             const builtSchema = schema.build();
+            const finalValueSchema = isValueOptional
+                ? { anyOf: [{ isUndefined: true }, builtSchema] }
+                : builtSchema;
             return new JsonSchemaObjectBuilder({}, {
                 hasIsOfTypeCheck: false,
                 patternProperties: {
-                    '^.+$': builtSchema,
+                    '^.+$': finalValueSchema,
                 },
             });
         },
@@ -979,12 +983,19 @@ function objectDbEntity(props) {
 }
 function record(keySchema, valueSchema) {
     const keyJsonSchema = keySchema.build();
+    // Check if value schema is optional before build() strips the optionalField flag
+    const isValueOptional = valueSchema.getSchema()
+        .optionalField;
     const valueJsonSchema = valueSchema.build();
+    // When value schema is optional, wrap in anyOf to allow undefined values
+    const finalValueSchema = isValueOptional
+        ? { anyOf: [{ isUndefined: true }, valueJsonSchema] }
+        : valueJsonSchema;
     return new JsonSchemaObjectBuilder([], {
         hasIsOfTypeCheck: false,
         keySchema: keyJsonSchema,
         patternProperties: {
-            ['^.*$']: valueJsonSchema,
+            ['^.*$']: finalValueSchema,
         },
     });
 }

package/package.json

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

package/src/validation/ajv/getAjv.ts

@@ -486,6 +486,16 @@ export function createAjv(opt?: Options): Ajv2020 {
     },
   })
 
+  // Validates that the value is undefined. Used in record/stringMap with optional value schemas
+  // to allow undefined values in patternProperties via anyOf.
+  ajv.addKeyword({
+    keyword: 'isUndefined',
+    modifying: false,
+    errors: false,
+    schemaType: 'boolean',
+    validate: (_schema: boolean, data: unknown) => data === undefined,
+  })
+
   // This is added because Ajv validates the `min/maxProperties` before validating the properties.
   // So, in case of `minProperties(1)` and `{ foo: 'bar' }` Ajv will let it pass, even
   // if the property validation would strip `foo` from the data.

package/src/validation/ajv/jsonSchemaBuilder.ts

@@ -80,14 +80,18 @@ export const j = {
     stringMap<S extends JsonSchemaTerminal<any, any, any>>(
       schema: S,
     ): JsonSchemaObjectBuilder<StringMap<SchemaIn<S>>, StringMap<SchemaOut<S>>> {
+      const isValueOptional = schema.getSchema().optionalField
       const builtSchema = schema.build()
+      const finalValueSchema: JsonSchema = isValueOptional
+        ? { anyOf: [{ isUndefined: true }, builtSchema] }
+        : builtSchema
 
       return new JsonSchemaObjectBuilder<StringMap<SchemaIn<S>>, StringMap<SchemaOut<S>>>(
         {},
         {
           hasIsOfTypeCheck: false,
           patternProperties: {
-            '^.+$': builtSchema,
+            '^.+$': finalValueSchema,
           },
         },
       )
@@ -1574,6 +1578,7 @@ export interface JsonSchema<IN = unknown, OUT = IN> {
   errorMessages?: StringMap<string>
   optionalValues?: (string | number | boolean | null)[]
   keySchema?: JsonSchema
+  isUndefined?: true
   minProperties2?: number
   exclusiveProperties?: (readonly string[])[]
   anyOfBy?: {
@@ -1648,8 +1653,16 @@ function record<
   false
 > {
   const keyJsonSchema = keySchema.build()
+  // Check if value schema is optional before build() strips the optionalField flag
+  const isValueOptional = (valueSchema as JsonSchemaTerminal<any, any, any>).getSchema()
+    .optionalField
   const valueJsonSchema = valueSchema.build()
 
+  // When value schema is optional, wrap in anyOf to allow undefined values
+  const finalValueSchema: JsonSchema = isValueOptional
+    ? { anyOf: [{ isUndefined: true }, valueJsonSchema] }
+    : valueJsonSchema
+
   return new JsonSchemaObjectBuilder<
     Opt extends true
       ? Partial<Record<SchemaIn<KS>, SchemaIn<VS>>>
@@ -1662,7 +1675,7 @@ function record<
     hasIsOfTypeCheck: false,
     keySchema: keyJsonSchema,
     patternProperties: {
-      ['^.*$']: valueJsonSchema,
+      ['^.*$']: finalValueSchema,
     },
   })
 }