@naturalcycles/nodejs-lib 15.105.0 → 15.106.0

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

@@ -52,6 +52,15 @@ export declare const j: {
          */
         withEnumKeys: typeof withEnumKeys;
         withRegexKeys: typeof withRegexKeys;
+        /**
+         * Validates that the value is an instance of the given class/constructor.
+         *
+         * ```ts
+         * j.object.instanceOf(Date) // typed as Date
+         * j.object.instanceOf(Date).optional() // typed as Date | undefined
+         * ```
+         */
+        instanceOf<T>(ctor: new (...args: any[]) => T): JBuilder<T, false>;
     };
     array<OUT, Opt>(itemSchema: JSchema<OUT, Opt>): JArray<OUT, Opt>;
     tuple<const S extends JSchema<any, any>[]>(items: S): JTuple<S>;
@@ -410,9 +419,9 @@ export declare class JTuple<ITEMS extends JSchema<any, any>[]> extends JBuilder<
     constructor(items: ITEMS);
 }
 declare function object(props: AnyObject): never;
-declare function object<OUT extends AnyObject>(props: {
+declare function object<OUT extends AnyObject>(props: [keyof OUT] extends [never] ? Record<string, never> : {
     [K in keyof Required<OUT>]-?: JSchema<OUT[K], any>;
-}): JObject<OUT, false>;
+}): [keyof OUT] extends [never] ? never : JObject<OUT, false>;
 declare function objectInfer<P extends Record<string, JSchema<any, any>>>(props: P): JObjectInfer<P, false>;
 declare function objectDbEntity(props: AnyObject): never;
 declare function objectDbEntity<OUT extends BaseDBEntity, EXTRA_KEYS extends Exclude<keyof OUT, keyof BaseDBEntity> = Exclude<keyof OUT, keyof BaseDBEntity>>(props: {

package/dist/validation/ajv/jSchema.js

@@ -81,6 +81,21 @@ export const j = {
          */
         withEnumKeys,
         withRegexKeys,
+        /**
+         * Validates that the value is an instance of the given class/constructor.
+         *
+         * ```ts
+         * j.object.instanceOf(Date) // typed as Date
+         * j.object.instanceOf(Date).optional() // typed as Date | undefined
+         * ```
+         */
+        instanceOf(ctor) {
+            return new JBuilder({
+                type: 'object',
+                instanceof: ctor.name,
+                hasIsOfTypeCheck: true,
+            });
+        },
     }),
     array(itemSchema) {
         return new JArray(itemSchema);
@@ -1061,7 +1076,6 @@ export class AjvSchema {
         }
         let jsonSchema;
         if (schema instanceof JSchema) {
-            // oxlint-disable typescript-eslint(no-unnecessary-type-assertion)
             jsonSchema = schema.build();
             AjvSchema.requireValidJsonSchema(jsonSchema);
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.105.0",
+  "version": "15.106.0",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@standard-schema/spec": "^1",

package/src/validation/ajv/jSchema.ts

@@ -135,6 +135,22 @@ export const j = {
      */
     withEnumKeys,
     withRegexKeys,
+
+    /**
+     * Validates that the value is an instance of the given class/constructor.
+     *
+     * ```ts
+     * j.object.instanceOf(Date) // typed as Date
+     * j.object.instanceOf(Date).optional() // typed as Date | undefined
+     * ```
+     */
+    instanceOf<T>(ctor: new (...args: any[]) => T): JBuilder<T, false> {
+      return new JBuilder<T, false>({
+        type: 'object',
+        instanceof: ctor.name,
+        hasIsOfTypeCheck: true,
+      })
+    },
   }),
 
   array<OUT, Opt>(itemSchema: JSchema<OUT, Opt>): JArray<OUT, Opt> {
@@ -1323,9 +1339,11 @@ export class JTuple<ITEMS extends JSchema<any, any>[]> extends JBuilder<TupleOut
 // ==== Standalone functions for j.object ====
 
 function object(props: AnyObject): never
-function object<OUT extends AnyObject>(props: {
-  [K in keyof Required<OUT>]-?: JSchema<OUT[K], any>
-}): JObject<OUT, false>
+function object<OUT extends AnyObject>(
+  props: [keyof OUT] extends [never]
+    ? Record<string, never>
+    : { [K in keyof Required<OUT>]-?: JSchema<OUT[K], any> },
+): [keyof OUT] extends [never] ? never : JObject<OUT, false>
 
 function object<OUT extends AnyObject>(props: {
   [key in keyof OUT]: JSchema<OUT[key], any>
@@ -1531,8 +1549,7 @@ export class AjvSchema<OUT> {
     let jsonSchema: JsonSchema<OUT>
 
     if (schema instanceof JSchema) {
-      // oxlint-disable typescript-eslint(no-unnecessary-type-assertion)
-      jsonSchema = (schema as JSchema<OUT, any>).build()
+      jsonSchema = schema.build()
       AjvSchema.requireValidJsonSchema(jsonSchema)
     } else {
       jsonSchema = schema
@@ -1654,7 +1671,7 @@ function executeValidation<OUT>(
     const [err, result] = _try(() => builtSchema.postValidation!(output))
     if (err) {
       valid = false
-      ;(fn as any).errors = [
+      fn.errors = [
         {
           instancePath: '',
           message: err.message,