@naturalcycles/nodejs-lib 15.88.0 → 15.89.1

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

@@ -243,6 +243,18 @@ export interface JsonSchemaStringEmailOptions {
 }
 export declare class JsonSchemaIsoDateBuilder<Opt extends boolean = false> extends JsonSchemaAnyBuilder<string | IsoDate, IsoDate, 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.
+     *
+     * Make sure this `optional()` call is at the end of your call chain.
+     *
+     * When `null` is included in optionalValues, the return type becomes `JsonSchemaTerminal`
+     * (no further chaining allowed) because the schema is wrapped in an anyOf structure.
+     */
+    optional<T extends readonly null[] | undefined = undefined>(optionalValues?: T): T extends readonly null[] ? JsonSchemaTerminal<string | IsoDate | undefined, IsoDate | undefined, true> : JsonSchemaAnyBuilder<string | IsoDate | undefined, IsoDate | undefined, true>;
     before(date: string): this;
     sameOrBefore(date: string): this;
     after(date: string): this;

package/dist/validation/ajv/jsonSchemaBuilder.js

@@ -508,6 +508,29 @@ export class JsonSchemaIsoDateBuilder extends JsonSchemaAnyBuilder {
             IsoDate: {},
         });
     }
+    /**
+     * @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.
+     *
+     * Make sure this `optional()` call is at the end of your call chain.
+     *
+     * When `null` is included in optionalValues, the return type becomes `JsonSchemaTerminal`
+     * (no further chaining allowed) because the schema is wrapped in an anyOf structure.
+     */
+    optional(optionalValues) {
+        if (!optionalValues) {
+            return super.optional();
+        }
+        _typeCast(optionalValues);
+        const optionalBuilder = this.cloneAndUpdateSchema({ optionalField: true });
+        const newBuilder = new JsonSchemaTerminal({
+            anyOf: [{ type: 'null', optionalValues }, optionalBuilder.build()],
+            optionalField: true,
+        });
+        return newBuilder;
+    }
     before(date) {
         return this.cloneAndUpdateSchema({ IsoDate: { before: date } });
     }

package/package.json

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

package/src/validation/ajv/jsonSchemaBuilder.ts

@@ -703,6 +703,42 @@ export class JsonSchemaIsoDateBuilder<Opt extends boolean = false> extends JsonS
     })
   }
 
+  /**
+   * @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.
+   *
+   * Make sure this `optional()` call is at the end of your call chain.
+   *
+   * When `null` is included in optionalValues, the return type becomes `JsonSchemaTerminal`
+   * (no further chaining allowed) because the schema is wrapped in an anyOf structure.
+   */
+  override optional<T extends readonly null[] | undefined = undefined>(
+    optionalValues?: T,
+  ): T extends readonly null[]
+    ? JsonSchemaTerminal<string | IsoDate | undefined, IsoDate | undefined, true>
+    : JsonSchemaAnyBuilder<string | IsoDate | undefined, IsoDate | undefined, true> {
+    if (!optionalValues) {
+      return super.optional() as any
+    }
+
+    _typeCast<null[]>(optionalValues)
+
+    const optionalBuilder = this.cloneAndUpdateSchema({ optionalField: true })
+
+    const newBuilder = new JsonSchemaTerminal<
+      string | IsoDate | undefined,
+      IsoDate | undefined,
+      true
+    >({
+      anyOf: [{ type: 'null', optionalValues }, optionalBuilder.build()],
+      optionalField: true,
+    })
+
+    return newBuilder as any
+  }
+
   before(date: string): this {
     return this.cloneAndUpdateSchema({ IsoDate: { before: date } })
   }