@tsoa-next/runtime 7.2.1 → 7.3.2

package/README.MD

@@ -1,9 +1,9 @@
 This package contains the runtime helpers for `tsoa-next`.
 
-`tsoa-next` continues the original [`tsoa`](https://github.com/lukeautry/tsoa) project, and this package carries forward the runtime foundation established there.
+`tsoa-next` continues the original [`tsoa`](https://github.com/tsoa-next/tsoa-next) project, and this package carries forward the runtime foundation established there.
 
 For the main README and API reference, see:
 
-- [Repository README](https://github.com/VannaDii/tsoa-next#readme)
-- [Project documentation](https://vannadii.github.io/tsoa-next/docs/)
-- [API reference](https://vannadii.github.io/tsoa-next/reference/)
+- [Repository README](https://github.com/tsoa-next/tsoa-next#readme)
+- [Project documentation](https://tsoa-next.dev/)
+- [API reference](https://tsoa-next.dev/reference/)

package/dist/config.d.ts

@@ -49,8 +49,8 @@ export interface Config {
      * @deprecated
      *  since v6.4.0 instroduces RegisterRoutes can pass multerOptions,
      *  we will quickly remove this options soon at future version.
-     *  (https://github.com/lukeautry/tsoa/issues/1587#issuecomment-2391291433)
-     *  (https://github.com/lukeautry/tsoa/pull/1638)
+     *  (https://github.com/tsoa-next/tsoa-next/issues/1587#issuecomment-2391291433)
+     *  (https://github.com/tsoa-next/tsoa-next/pull/1638)
      */
     multerOpts?: MulterOpts;
     defaultNumberType?: 'double' | 'float' | 'integer' | 'long';

package/dist/decorators/validate.d.ts

@@ -0,0 +1,9 @@
+import { Tsoa } from '../metadataGeneration/tsoa';
+type ValidateDecoratorConfig = {
+    kind: Tsoa.ExternalValidatorKind;
+    schema: unknown;
+};
+type DecoratorPropertyKey = string | symbol | undefined;
+export declare function getParameterExternalValidatorMetadata(target: object, propertyKey: DecoratorPropertyKey, parameterIndex: number): ValidateDecoratorConfig | undefined;
+export declare function Validate(...args: unknown[]): ParameterDecorator;
+export {};

package/dist/decorators/validate.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getParameterExternalValidatorMetadata = getParameterExternalValidatorMetadata;
+exports.Validate = Validate;
+const VALIDATE_METADATA_KEY = Symbol.for('@tsoa-next/runtime:validate');
+const CONSTRUCTOR_PROPERTY = '__constructor__';
+function inferValidatorKind(schema) {
+    if (!schema || typeof schema !== 'object') {
+        return undefined;
+    }
+    const candidate = schema;
+    if (typeof candidate.safeParse === 'function') {
+        return 'zod';
+    }
+    if (typeof candidate.decode === 'function' && typeof candidate.encode === 'function' && typeof candidate.is === 'function') {
+        return 'io-ts';
+    }
+    if (typeof candidate.validateSync === 'function' && typeof candidate.describe === 'function') {
+        return 'yup';
+    }
+    if (candidate.isJoi === true || (typeof candidate.validate === 'function' && candidate.$_terms && typeof candidate.type === 'string')) {
+        return 'joi';
+    }
+    if (typeof candidate.validator === 'function' && typeof candidate.refiner === 'function' && typeof candidate.type === 'string') {
+        return 'superstruct';
+    }
+    return undefined;
+}
+function isValidateDecoratorShape(value) {
+    return !!value && typeof value === 'object' && 'kind' in value && 'schema' in value;
+}
+function requireSchemaValue(schema) {
+    if (schema === undefined) {
+        throw new TypeError('@Validate requires a schema value.');
+    }
+    return schema;
+}
+function normalizeSingleValidateDecoratorArg(value) {
+    if (isValidateDecoratorShape(value)) {
+        const { kind, schema } = value;
+        if (!isExternalValidatorKind(kind)) {
+            throw new TypeError(`@Validate received unsupported validator kind '${String(kind)}'.`);
+        }
+        return { kind, schema: requireSchemaValue(schema) };
+    }
+    if (isExternalValidatorKind(value)) {
+        throw new TypeError(`@Validate('${value}', schema) requires a schema value.`);
+    }
+    const inferredKind = inferValidatorKind(value);
+    if (!inferredKind) {
+        throw new TypeError('@Validate(schema) could not infer the validator kind. Use @Validate(kind, schema) instead.');
+    }
+    return { kind: inferredKind, schema: value };
+}
+function normalizeKindAndSchemaArgs(kind, schema) {
+    if (!isExternalValidatorKind(kind)) {
+        throw new TypeError(`@Validate received unsupported validator kind '${String(kind)}'.`);
+    }
+    return { kind, schema: requireSchemaValue(schema) };
+}
+function normalizeValidateDecoratorArgs(args) {
+    switch (args.length) {
+        case 0:
+            throw new TypeError('@Validate requires a schema argument.');
+        case 1:
+            return normalizeSingleValidateDecoratorArg(args[0]);
+        case 2:
+            return normalizeKindAndSchemaArgs(args[0], args[1]);
+        default:
+            throw new TypeError('@Validate accepts only (schema), (kind, schema), or ({ kind, schema }).');
+    }
+}
+function isExternalValidatorKind(value) {
+    return value === 'zod' || value === 'joi' || value === 'yup' || value === 'superstruct' || value === 'io-ts';
+}
+function getPropertyKey(propertyKey) {
+    return propertyKey === undefined ? CONSTRUCTOR_PROPERTY : String(propertyKey);
+}
+function getValidateMetadataStore(target) {
+    const existing = Reflect.getOwnMetadata(VALIDATE_METADATA_KEY, target);
+    if (existing) {
+        return existing;
+    }
+    const created = {};
+    Reflect.defineMetadata(VALIDATE_METADATA_KEY, created, target);
+    return created;
+}
+function getParameterExternalValidatorMetadata(target, propertyKey, parameterIndex) {
+    const lookupKey = getPropertyKey(propertyKey);
+    let currentTarget = target;
+    while (currentTarget) {
+        const store = Reflect.getOwnMetadata(VALIDATE_METADATA_KEY, currentTarget);
+        const parameterMetadata = store?.[lookupKey]?.[parameterIndex];
+        if (parameterMetadata) {
+            return parameterMetadata;
+        }
+        currentTarget = Object.getPrototypeOf(currentTarget);
+    }
+    return undefined;
+}
+function Validate(...args) {
+    const normalized = normalizeValidateDecoratorArgs(args);
+    return (target, propertyKey, parameterIndex) => {
+        const store = getValidateMetadataStore(target);
+        const lookupKey = getPropertyKey(propertyKey);
+        const propertyStore = store[lookupKey] || {};
+        propertyStore[parameterIndex] = normalized;
+        store[lookupKey] = propertyStore;
+        Reflect.defineMetadata(VALIDATE_METADATA_KEY, store, target);
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/decorators/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/decorators/validate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,12 +11,14 @@ export * from './decorators/response';
 export * from './decorators/route';
 export * from './decorators/security';
 export * from './decorators/tags';
+export * from './decorators/validate';
 export * from './interfaces/controller';
 export * from './interfaces/file';
 export * from './interfaces/iocModule';
 export * from './interfaces/response';
 export * from './metadataGeneration/tsoa';
 export * from './routeGeneration/additionalProps';
+export * from './routeGeneration/externalValidation';
 export * from './routeGeneration/templateHelpers';
 export * from './routeGeneration/templates';
 export * from './routeGeneration/tsoa-route';

package/dist/index.js

@@ -27,12 +27,14 @@ __exportStar(require("./decorators/response"), exports);
 __exportStar(require("./decorators/route"), exports);
 __exportStar(require("./decorators/security"), exports);
 __exportStar(require("./decorators/tags"), exports);
+__exportStar(require("./decorators/validate"), exports);
 __exportStar(require("./interfaces/controller"), exports);
 __exportStar(require("./interfaces/file"), exports);
 __exportStar(require("./interfaces/iocModule"), exports);
 __exportStar(require("./interfaces/response"), exports);
 __exportStar(require("./metadataGeneration/tsoa"), exports);
 __exportStar(require("./routeGeneration/additionalProps"), exports);
+__exportStar(require("./routeGeneration/externalValidation"), exports);
 __exportStar(require("./routeGeneration/templateHelpers"), exports);
 __exportStar(require("./routeGeneration/templates"), exports);
 __exportStar(require("./routeGeneration/tsoa-route"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAAyB;AACzB,2CAAwB;AACxB,0DAAuC;AACvC,uDAAoC;AACpC,yDAAsC;AACtC,uDAAoC;AACpC,2DAAwC;AACxC,2DAAwC;AACxC,yDAAsC;AACtC,wDAAqC;AACrC,qDAAkC;AAClC,wDAAqC;AACrC,oDAAiC;AACjC,0DAAuC;AACvC,oDAAiC;AACjC,yDAAsC;AACtC,wDAAqC;AACrC,4DAAyC;AACzC,oEAAiD;AACjD,oEAAiD;AACjD,8DAA2C;AAC3C,+DAA4C;AAC5C,oDAAiC;AACjC,sDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAAyB;AACzB,2CAAwB;AACxB,0DAAuC;AACvC,uDAAoC;AACpC,yDAAsC;AACtC,uDAAoC;AACpC,2DAAwC;AACxC,2DAAwC;AACxC,yDAAsC;AACtC,wDAAqC;AACrC,qDAAkC;AAClC,wDAAqC;AACrC,oDAAiC;AACjC,wDAAqC;AACrC,0DAAuC;AACvC,oDAAiC;AACjC,yDAAsC;AACtC,wDAAqC;AACrC,4DAAyC;AACzC,oEAAiD;AACjD,uEAAoD;AACpD,oEAAiD;AACjD,8DAA2C;AAC3C,+DAA4C;AAC5C,oDAAiC;AACjC,sDAAmC"}

package/dist/metadataGeneration/tsoa.d.ts

@@ -2,6 +2,31 @@ import { ExtensionType } from '../decorators/extension';
 import type { Swagger } from '../swagger/swagger';
 import { Validator } from '..';
 export declare namespace Tsoa {
+    export type ExternalValidatorKind = 'zod' | 'joi' | 'yup' | 'superstruct' | 'io-ts';
+    export type ValidationStrategy = 'standard' | 'external';
+    export interface ExternalValidatorDescriptor {
+        kind: ExternalValidatorKind;
+        strategy: 'external';
+    }
+    export interface ValidationIssue {
+        path: string;
+        code: string;
+        message?: string;
+        messageKey?: string;
+        messageParams?: Record<string, unknown>;
+        source: 'tsoa' | ExternalValidatorKind;
+        raw?: unknown;
+    }
+    export interface ValidationFailure {
+        summaryMessage: string;
+        issues: ValidationIssue[];
+        source: ValidationIssue['source'];
+    }
+    export interface ValidationContext {
+        locale?: string;
+        translate?: (key: string, params?: Record<string, unknown>) => string;
+        errorFormatter?: (failure: ValidationFailure) => ValidationFailure;
+    }
     export type Example = string | number | boolean | null | undefined | Date | Example[] | {
         [exampleName: string]: Example;
     };
@@ -36,6 +61,7 @@ export declare namespace Tsoa {
         operationId?: string;
     }
     export interface Parameter {
+        parameterIndex?: number;
         parameterName: string;
         example?: Example[];
         description?: string;
@@ -45,6 +71,8 @@ export declare namespace Tsoa {
         type: Type;
         default?: unknown;
         validators: Validators;
+        validationStrategy?: ValidationStrategy;
+        externalValidator?: ExternalValidatorDescriptor;
         deprecated: boolean;
         exampleLabels?: Array<string | undefined>;
         title?: string;

package/dist/routeGeneration/additionalProps.d.ts

@@ -1,6 +1,8 @@
 import { Config, RoutesConfig } from '../config';
+import type { Tsoa } from '../metadataGeneration/tsoa';
 export interface AdditionalProps {
     noImplicitAdditionalProperties: Exclude<Config['noImplicitAdditionalProperties'], undefined>;
     bodyCoercion: Exclude<RoutesConfig['bodyCoercion'], undefined>;
     maxValidationErrorSize?: number;
+    validation?: Tsoa.ValidationContext;
 }

package/dist/routeGeneration/externalValidation.d.ts

@@ -0,0 +1,13 @@
+import type { Tsoa } from '../metadataGeneration/tsoa';
+export type RuntimeSchemaAdapterResult<T = unknown> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    failure: Tsoa.ValidationFailure;
+};
+export interface RuntimeSchemaAdapter {
+    kind: Tsoa.ExternalValidatorKind;
+    validate(value: unknown, schema: unknown, context: Tsoa.ValidationContext): RuntimeSchemaAdapterResult;
+}
+export declare function validateExternalSchema(kind: Tsoa.ExternalValidatorKind, schema: unknown, value: unknown, context?: Tsoa.ValidationContext): RuntimeSchemaAdapterResult;

package/dist/routeGeneration/externalValidation.js

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateExternalSchema = validateExternalSchema;
+let superstructModule;
+function isMissingOptionalModuleError(error) {
+    return error instanceof Error && error.code === 'MODULE_NOT_FOUND';
+}
+function loadOptionalModule(moduleName) {
+    let resolvedModuleName;
+    try {
+        resolvedModuleName = require.resolve(moduleName);
+    }
+    catch (error) {
+        if (!isMissingOptionalModuleError(error)) {
+            throw error;
+        }
+        throw new Error(`External validator '${moduleName}' is not installed. Install it in your application to use @Validate with that schema kind.`);
+    }
+    return require(resolvedModuleName);
+}
+function normalizePath(input) {
+    if (!Array.isArray(input)) {
+        return typeof input === 'string' ? input : '';
+    }
+    return input
+        .filter(segment => segment !== undefined && segment !== null && segment !== '')
+        .map(segment => (typeof segment === 'number' ? `$${segment}` : String(segment)))
+        .join('.');
+}
+function normalizeJoiPath(input) {
+    if (!Array.isArray(input)) {
+        return typeof input === 'string' ? input : '';
+    }
+    return input.map(segment => (typeof segment === 'number' ? `$${segment}` : String(segment))).join('.');
+}
+function maybeMessageKey(message) {
+    if (typeof message !== 'string' || message.length === 0) {
+        return undefined;
+    }
+    return /^[A-Za-z0-9_.-]+$/.test(message) && message.includes('.') ? message : undefined;
+}
+function finalizeFailure(failure, context) {
+    const translatedIssues = failure.issues.map(issue => {
+        const messageKey = issue.messageKey || maybeMessageKey(issue.message);
+        const translatedMessage = messageKey && context.translate ? context.translate(messageKey, issue.messageParams) : issue.message;
+        return {
+            ...issue,
+            ...(messageKey ? { messageKey } : {}),
+            ...(translatedMessage ? { message: translatedMessage } : {}),
+        };
+    });
+    const translatedFailure = {
+        ...failure,
+        issues: translatedIssues,
+        summaryMessage: translatedIssues.find(issue => issue.message)?.message || failure.summaryMessage,
+    };
+    return context.errorFormatter ? context.errorFormatter(translatedFailure) : translatedFailure;
+}
+function buildFailure(source, issues, fallbackSummary, context) {
+    return finalizeFailure({
+        source,
+        issues,
+        summaryMessage: issues.find(issue => issue.message)?.message || fallbackSummary,
+    }, context);
+}
+const zodAdapter = {
+    kind: 'zod',
+    validate(value, schema, context) {
+        const zodSchema = schema;
+        if (typeof zodSchema.safeParse !== 'function') {
+            throw new TypeError('Expected a Zod schema with safeParse().');
+        }
+        const result = zodSchema.safeParse(value);
+        if (result.success) {
+            return { ok: true, value: result.data };
+        }
+        const issues = (result.error?.issues || []).map(issue => {
+            const entry = issue;
+            return {
+                path: normalizePath(entry.path),
+                code: typeof entry.code === 'string' ? entry.code : 'invalid',
+                message: typeof entry.message === 'string' ? entry.message : undefined,
+                source: 'zod',
+                raw: issue,
+            };
+        });
+        return { ok: false, failure: buildFailure('zod', issues, 'Zod validation failed.', context) };
+    },
+};
+const joiAdapter = {
+    kind: 'joi',
+    validate(value, schema, context) {
+        const joiSchema = schema;
+        if (typeof joiSchema.validate !== 'function') {
+            throw new TypeError('Expected a Joi schema with validate().');
+        }
+        const result = joiSchema.validate(value, { abortEarly: false });
+        if (!result.error) {
+            return { ok: true, value: result.value };
+        }
+        const issues = (result.error.details || []).map(detail => {
+            const entry = detail;
+            return {
+                path: normalizeJoiPath(entry.path),
+                code: typeof entry.type === 'string' ? entry.type : 'invalid',
+                message: typeof entry.message === 'string' ? entry.message : undefined,
+                messageParams: entry.context,
+                source: 'joi',
+                raw: detail,
+            };
+        });
+        return { ok: false, failure: buildFailure('joi', issues, 'Joi validation failed.', context) };
+    },
+};
+const yupAdapter = {
+    kind: 'yup',
+    validate(value, schema, context) {
+        const yupSchema = schema;
+        if (typeof yupSchema.validateSync !== 'function') {
+            throw new TypeError('Expected a Yup schema with validateSync().');
+        }
+        try {
+            return { ok: true, value: yupSchema.validateSync(value, { abortEarly: false }) };
+        }
+        catch (error) {
+            const validationError = error;
+            const errors = validationError.inner && validationError.inner.length > 0 ? validationError.inner : [validationError];
+            const issues = errors.map(entry => {
+                const yupEntry = entry;
+                return {
+                    path: typeof yupEntry.path === 'string' ? yupEntry.path : '',
+                    code: typeof yupEntry.type === 'string' ? yupEntry.type : 'invalid',
+                    message: typeof yupEntry.message === 'string' ? yupEntry.message : undefined,
+                    messageParams: yupEntry.params,
+                    source: 'yup',
+                    raw: entry,
+                };
+            });
+            return { ok: false, failure: buildFailure('yup', issues, 'Yup validation failed.', context) };
+        }
+    },
+};
+const superstructAdapter = {
+    kind: 'superstruct',
+    validate(value, schema, context) {
+        const { validate } = superstructModule ?? (superstructModule = loadOptionalModule('superstruct'));
+        const [error, result] = validate(value, schema);
+        if (!error) {
+            return { ok: true, value: result };
+        }
+        const structError = error;
+        const failures = typeof structError.failures === 'function' ? Array.from(structError.failures()) : [structError];
+        const issues = failures.map(entry => {
+            const failure = entry;
+            let code = 'invalid';
+            if (typeof failure.refinement === 'string') {
+                code = failure.refinement;
+            }
+            else if (typeof failure.type === 'string') {
+                code = failure.type;
+            }
+            return {
+                path: normalizePath(failure.path),
+                code,
+                message: typeof failure.message === 'string' ? failure.message : undefined,
+                source: 'superstruct',
+                raw: entry,
+            };
+        });
+        return { ok: false, failure: buildFailure('superstruct', issues, 'Superstruct validation failed.', context) };
+    },
+};
+function getIoTsDecodeResult(schema, value) {
+    const codec = schema;
+    if (typeof codec.decode !== 'function') {
+        throw new TypeError('Expected an io-ts codec with decode().');
+    }
+    return codec.decode(value);
+}
+function getIoTsSummary(decoded) {
+    try {
+        const reporterModule = loadOptionalModule('io-ts/PathReporter');
+        const reporter = reporterModule.PathReporter;
+        if (reporter && typeof reporter.report === 'function') {
+            return reporter.report(decoded).join('; ');
+        }
+    }
+    catch {
+        // Ignore reporter loading issues and fall back to a generic summary.
+    }
+    return 'io-ts validation failed.';
+}
+const ioTsAdapter = {
+    kind: 'io-ts',
+    validate(value, schema, context) {
+        const decoded = getIoTsDecodeResult(schema, value);
+        if (decoded?._tag === 'Right') {
+            return { ok: true, value: decoded.right };
+        }
+        const validationErrors = (decoded?._tag === 'Left' ? decoded.left : []);
+        const issues = validationErrors.map(entry => {
+            const validationError = entry;
+            const contextPath = (validationError.context || [])
+                .slice(1)
+                .map(item => item.key)
+                .filter((segment) => !!segment);
+            const finalType = validationError.context?.[validationError.context.length - 1]?.type?.name;
+            const message = typeof validationError.message === 'string' ? validationError.message : undefined;
+            const messageKey = maybeMessageKey(message);
+            return {
+                path: contextPath.join('.'),
+                code: typeof finalType === 'string' ? finalType : 'invalid',
+                ...(message ? { message } : {}),
+                ...(messageKey ? { messageKey } : {}),
+                source: 'io-ts',
+                raw: entry,
+            };
+        });
+        return { ok: false, failure: buildFailure('io-ts', issues, getIoTsSummary(decoded), context) };
+    },
+};
+const adapterRegistry = {
+    'io-ts': ioTsAdapter,
+    joi: joiAdapter,
+    superstruct: superstructAdapter,
+    yup: yupAdapter,
+    zod: zodAdapter,
+};
+function validateExternalSchema(kind, schema, value, context = {}) {
+    return adapterRegistry[kind].validate(value, schema, context);
+}
+//# sourceMappingURL=externalValidation.js.map

package/dist/routeGeneration/externalValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"externalValidation.js","sourceRoot":"","sources":["../../src/routeGeneration/externalValidation.ts"],"names":[],"mappings":"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"}

package/dist/routeGeneration/templateHelpers.d.ts

@@ -1,17 +1,67 @@
 import { AdditionalProps } from './additionalProps';
 import { TsoaRoute } from './tsoa-route';
-export declare function ValidateParam<TValue>(property: TsoaRoute.PropertySchema, value: TValue, generatedModels: TsoaRoute.Models, name: string | undefined, fieldErrors: FieldErrors, isBodyParam: boolean, parent: string | undefined, config: AdditionalProps): TValue;
+export interface ParameterValidationMetadata {
+    controllerClass?: object;
+    methodName?: string;
+    parameterIndex?: number;
+}
+type ValidateNestedObjectLiteralOptions = {
+    name: string;
+    value: unknown;
+    fieldErrors: FieldErrors;
+    isBodyParam: boolean;
+    nestedProperties: {
+        [name: string]: TsoaRoute.PropertySchema;
+    } | undefined;
+    additionalProperties: TsoaRoute.PropertySchema | boolean | undefined;
+    parent: string;
+    metadata?: ParameterValidationMetadata;
+};
+type ValidateNestedObjectLiteralTupleArgs = [
+    string,
+    unknown,
+    FieldErrors,
+    boolean,
+    {
+        [name: string]: TsoaRoute.PropertySchema;
+    } | undefined,
+    TsoaRoute.PropertySchema | boolean | undefined,
+    string?,
+    ParameterValidationMetadata?
+];
+type ValidateArrayOptions = {
+    name: string;
+    value: unknown;
+    fieldErrors: FieldErrors;
+    isBodyParam: boolean;
+    schema?: TsoaRoute.PropertySchema;
+    validators?: ArrayValidator;
+    parent: string;
+    metadata?: ParameterValidationMetadata;
+};
+type ValidateArrayTupleArgs = [string, unknown, FieldErrors, boolean, TsoaRoute.PropertySchema?, ArrayValidator?, string?, ParameterValidationMetadata?];
+export declare function ValidateParam<TValue>(property: TsoaRoute.PropertySchema, value: TValue, generatedModels: TsoaRoute.Models, name: string | undefined, fieldErrors: FieldErrors, isBodyParam: boolean, parent: string | undefined, config: AdditionalProps, metadata?: ParameterValidationMetadata): TValue;
 export declare class ValidationService {
     private readonly models;
     private readonly config;
     private validationStack;
     constructor(models: TsoaRoute.Models, config: AdditionalProps);
     private isRecord;
-    ValidateParam<TValue>(property: TsoaRoute.PropertySchema, rawValue: TValue, name: string | undefined, fieldErrors: FieldErrors, isBodyParam: boolean, parent?: string): TValue;
+    private buildChildPath;
+    ValidateParam<TValue>(property: TsoaRoute.PropertySchema, rawValue: TValue, name: string | undefined, fieldErrors: FieldErrors, isBodyParam: boolean, parent?: string, metadata?: ParameterValidationMetadata): TValue;
+    private handleUndefinedValue;
+    private getRequiredFieldMessage;
+    private validateResolvedProperty;
+    private validateExternal;
+    private getRuntimeExternalValidatorMetadata;
+    private projectExternalFailureToFieldErrors;
     hasCorrectJsType(value: unknown, type: 'object' | 'boolean' | 'number' | 'string', isBodyParam: boolean): boolean;
-    validateNestedObjectLiteral(name: string, value: unknown, fieldErrors: FieldErrors, isBodyParam: boolean, nestedProperties: {
-        [name: string]: TsoaRoute.PropertySchema;
-    } | undefined, additionalProperties: TsoaRoute.PropertySchema | boolean | undefined, parent: string): Record<string, unknown> | undefined;
+    validateNestedObjectLiteral(...args: [ValidateNestedObjectLiteralOptions]): unknown;
+    /**
+     * @deprecated Use the object overload instead.
+     */
+    validateNestedObjectLiteral(...args: ValidateNestedObjectLiteralTupleArgs): unknown;
+    private normalizeValidateNestedObjectLiteralArgs;
     validateInt(name: string, value: unknown, fieldErrors: FieldErrors, isBodyParam: boolean, validators?: IntegerValidator, parent?: string): number | undefined;
     validateFloat(name: string, value: unknown, fieldErrors: FieldErrors, isBodyParam: boolean, validators?: FloatValidator, parent?: string): number | undefined;
     validateEnum(name: string, value: unknown, fieldErrors: FieldErrors, members?: Array<string | number | boolean | null>, parent?: string): unknown;
@@ -20,10 +70,18 @@ export declare class ValidationService {
     validateString(name: string, value: unknown, fieldErrors: FieldErrors, validators?: StringValidator, parent?: string): string | undefined;
     validateBool(name: string, value: unknown, fieldErrors: FieldErrors, isBodyParam: boolean, validators?: BooleanValidator, parent?: string): boolean | undefined;
     validateUndefined(name: string, value: unknown, fieldErrors: FieldErrors, parent?: string): undefined;
-    validateArray(name: string, value: unknown, fieldErrors: FieldErrors, isBodyParam: boolean, schema?: TsoaRoute.PropertySchema, validators?: ArrayValidator, parent?: string): unknown[] | undefined;
+    validateArray(options: ValidateArrayOptions): unknown[] | undefined;
+    /**
+     * @deprecated Use the object overload instead.
+     */
+    validateArray(...args: ValidateArrayTupleArgs): unknown[] | undefined;
+    private normalizeValidateArrayArgs;
+    private getArrayValidatorError;
+    private hasDuplicateArrayItems;
+    private buildIssueFieldPath;
     validateBuffer(name: string, value: unknown, fieldErrors: FieldErrors, parent?: string): Buffer | undefined;
-    validateUnion<TValue>(name: string, value: TValue, fieldErrors: FieldErrors, isBodyParam: boolean, property: TsoaRoute.PropertySchema, parent?: string): TValue;
-    validateIntersection<TValue>(name: string, value: TValue, fieldErrors: FieldErrors, isBodyParam: boolean, subSchemas: TsoaRoute.PropertySchema[] | undefined, parent?: string): TValue;
+    validateUnion<TValue>(name: string, value: TValue, fieldErrors: FieldErrors, isBodyParam: boolean, property: TsoaRoute.PropertySchema, parent?: string, metadata?: ParameterValidationMetadata): TValue;
+    validateIntersection<TValue>(name: string, value: TValue, fieldErrors: FieldErrors, isBodyParam: boolean, subSchemas: TsoaRoute.PropertySchema[] | undefined, parent?: string, metadata?: ParameterValidationMetadata): TValue;
     private toModelLike;
     /**
      * combine all schemas once, ignoring order ie
@@ -53,6 +111,7 @@ export declare class ValidationService {
         fieldErrors: FieldErrors;
         isBodyParam: boolean;
         parent?: string;
+        metadata?: ParameterValidationMetadata;
     }): TValue;
     /**
      * Creates a new ValidationService instance with specific configuration
@@ -218,3 +277,4 @@ export declare class ValidateError extends Error implements Exception {
     name: string;
     constructor(fields: FieldErrors, message: string);
 }
+export {};