@tsed/ajv 8.25.5 → 8.26.1

package/lib/esm/fn/validate.js

@@ -1,9 +1,17 @@
 import { inject } from "@tsed/di";
 import { AjvService } from "../services/AjvService.js";
 /**
- * Validate a value against a JSON schema or a type.
- * @param value
- * @param options
+ * Validate a value against a JSON schema or a type using the configured `AjvService`.
+ *
+ * The return type is inferred from `value` by default and can be overridden with an explicit generic:
+ * `validate<MyType>(value, options)`.
+ *
+ * @typeParam TReturn Explicit return type override. When omitted, `TValue` is returned.
+ * @typeParam TValue Input value type.
+ * @param value Value to validate.
+ * @param options Validation options, a JSON schema, or a target type descriptor.
+ * @returns The validated value. If `returnsCoercedValues` is enabled, it may contain coerced values.
+ * @throws {AjvValidationError} When validation fails.
  */
 export function validate(value, options) {
     return inject(AjvService).validate(value, options);

package/lib/esm/services/AjvService.js

@@ -13,6 +13,21 @@ export class AjvService {
         this.returnsCoercedValues = constant("ajv.returnsCoercedValues");
         this.ajv = inject(Ajv);
     }
+    /**
+     * Validate a value against a JSON schema, a model type, or explicit AJV options.
+     *
+     * The return type is inferred from `value` by default and can be overridden with an explicit generic:
+     * `ajvService.validate<MyType>(value, options)`.
+     *
+     * If `returnsCoercedValues` is enabled globally or in `options`, coercions performed by AJV are returned.
+     *
+     * @typeParam TReturn Explicit return type override. When omitted, `TValue` is returned.
+     * @typeParam TValue Input value type.
+     * @param value Value to validate.
+     * @param options Validation options or `JsonSchema`.
+     * @returns The validated value (possibly coerced when configured).
+     * @throws {AjvValidationError} When validation fails.
+     */
     async validate(value, options) {
         let { schema: defaultSchema, type, collectionType, returnsCoercedValues = this.returnsCoercedValues, ...additionalOptions } = this.mapOptions(options);
         const schema = defaultSchema || getJsonSchema(type, { ...additionalOptions, customKeys: true });
@@ -66,7 +81,7 @@ export class AjvService {
                 error.modelName = nameOf(type);
                 error.message = this.mapClassError(error, type);
             }
-            return this.errorFormatter.call(this, error, {});
+            return this.errorFormatter(error);
         })
             .join("\n");
         return new AjvValidationError(message, errors);

package/lib/types/fn/validate.d.ts

@@ -1,8 +1,16 @@
 import { JsonSchema } from "@tsed/schema";
 import { type AjvValidateOptions } from "../services/AjvService.js";
 /**
- * Validate a value against a JSON schema or a type.
- * @param value
- * @param options
+ * Validate a value against a JSON schema or a type using the configured `AjvService`.
+ *
+ * The return type is inferred from `value` by default and can be overridden with an explicit generic:
+ * `validate<MyType>(value, options)`.
+ *
+ * @typeParam TReturn Explicit return type override. When omitted, `TValue` is returned.
+ * @typeParam TValue Input value type.
+ * @param value Value to validate.
+ * @param options Validation options, a JSON schema, or a target type descriptor.
+ * @returns The validated value. If `returnsCoercedValues` is enabled, it may contain coerced values.
+ * @throws {AjvValidationError} When validation fails.
  */
-export declare function validate(value: unknown, options: AjvValidateOptions | JsonSchema): Promise<any>;
+export declare function validate<TReturn = never, TValue = unknown>(value: TValue, options: AjvValidateOptions | JsonSchema): Promise<[TReturn] extends [never] ? TValue : TReturn>;

package/lib/types/services/AjvService.d.ts

@@ -15,7 +15,22 @@ export declare class AjvService {
     protected errorFormatter: ErrorFormatter;
     protected returnsCoercedValues: boolean | undefined;
     protected ajv: Ajv;
-    validate(value: any, options: AjvValidateOptions | JsonSchema): Promise<any>;
+    /**
+     * Validate a value against a JSON schema, a model type, or explicit AJV options.
+     *
+     * The return type is inferred from `value` by default and can be overridden with an explicit generic:
+     * `ajvService.validate<MyType>(value, options)`.
+     *
+     * If `returnsCoercedValues` is enabled globally or in `options`, coercions performed by AJV are returned.
+     *
+     * @typeParam TReturn Explicit return type override. When omitted, `TValue` is returned.
+     * @typeParam TValue Input value type.
+     * @param value Value to validate.
+     * @param options Validation options or `JsonSchema`.
+     * @returns The validated value (possibly coerced when configured).
+     * @throws {AjvValidationError} When validation fails.
+     */
+    validate<TReturn = never, TValue = unknown>(value: TValue, options: AjvValidateOptions | JsonSchema): Promise<[TReturn] extends [never] ? TValue : TReturn>;
     protected mapOptions(options: AjvValidateOptions | JsonSchema): AjvValidateOptions;
     protected mapErrors(errors: ErrorObject[], options: any): AjvValidationError;
     protected mapClassError(error: AjvErrorObject, targetType: Type<any>): string | undefined;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@tsed/ajv",
   "description": "AJV package for Ts.ED framework",
   "type": "module",
-  "version": "8.25.5",
+  "version": "8.26.1",
   "source": "./src/index.ts",
   "main": "./lib/esm/index.js",
   "module": "./lib/esm/index.js",
@@ -26,19 +26,19 @@
   "dependencies": {
     "ajv-errors": "3.0.0",
     "ajv-formats": "3.0.1",
-    "tslib": "2.7.0"
+    "tslib": ">=2.7.0"
   },
   "devDependencies": {
-    "@tsed/barrels": "8.25.5",
-    "@tsed/core": "8.25.5",
-    "@tsed/di": "8.25.5",
-    "@tsed/exceptions": "8.25.5",
-    "@tsed/schema": "8.25.5",
-    "@tsed/typescript": "8.25.5",
+    "@tsed/barrels": "8.26.1",
+    "@tsed/core": "8.26.1",
+    "@tsed/di": "8.26.1",
+    "@tsed/exceptions": "8.26.1",
+    "@tsed/schema": "8.26.1",
+    "@tsed/typescript": "8.26.1",
     "ajv": "^8.17.1",
     "eslint": "9.12.0",
-    "typescript": "5.9.3",
-    "vite": "7.1.11",
+    "typescript": "6.0.2",
+    "vite": "7.3.2",
     "vitest": "3.2.4"
   },
   "peerDependencies": {