exisjs 0.1.2

package/dist/utils/errors.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalError = exports.RateLimitError = exports.UnprocessableError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.UnauthorizedError = exports.BadRequestError = exports.HttpError = void 0;
+exports.createErrorHandler = createErrorHandler;
+exports.asyncHandler = asyncHandler;
+// ─── HttpError ─────────────────────────────────────────────────────────────────
+class HttpError extends Error {
+    constructor(message, statusCode = 500, code = 'INTERNAL_ERROR', details) {
+        super(message);
+        this.name = 'HttpError';
+        this.statusCode = statusCode;
+        this.code = code;
+        this.isOperational = true;
+        this.details = details;
+        // maintains proper stack trace
+        Error.captureStackTrace(this, this.constructor);
+    }
+    // ─── Factory methods ─────────────────────────────────────────────────────────
+    static badRequest(message, details) {
+        return new HttpError(message, 400, 'BAD_REQUEST', details);
+    }
+    static unauthorized(message = 'Unauthorized') {
+        return new HttpError(message, 401, 'UNAUTHORIZED');
+    }
+    static forbidden(message = 'Forbidden') {
+        return new HttpError(message, 403, 'FORBIDDEN');
+    }
+    static notFound(resource = 'Resource') {
+        return new HttpError(`${resource} not found`, 404, 'NOT_FOUND');
+    }
+    static conflict(message) {
+        return new HttpError(message, 409, 'CONFLICT');
+    }
+    static unprocessable(message, details) {
+        return new HttpError(message, 422, 'UNPROCESSABLE_ENTITY', details);
+    }
+    static tooManyRequests(message = 'Too many requests') {
+        return new HttpError(message, 429, 'RATE_LIMITED');
+    }
+    static internal(message = 'Internal server error') {
+        return new HttpError(message, 500, 'INTERNAL_ERROR');
+    }
+    static serviceUnavailable(message = 'Service unavailable') {
+        return new HttpError(message, 503, 'SERVICE_UNAVAILABLE');
+    }
+    toJSON() {
+        return {
+            success: false,
+            error: {
+                code: this.code,
+                message: this.message,
+                ...(this.details !== undefined && { details: this.details }),
+            },
+        };
+    }
+}
+exports.HttpError = HttpError;
+class BadRequestError extends HttpError {
+    constructor(message = 'Bad Request', details) {
+        super(message, 400, 'BAD_REQUEST', details);
+        this.name = 'BadRequestError';
+    }
+}
+exports.BadRequestError = BadRequestError;
+class UnauthorizedError extends HttpError {
+    constructor(message = 'Unauthorized') {
+        super(message, 401, 'UNAUTHORIZED');
+        this.name = 'UnauthorizedError';
+    }
+}
+exports.UnauthorizedError = UnauthorizedError;
+class ForbiddenError extends HttpError {
+    constructor(message = 'Forbidden') {
+        super(message, 403, 'FORBIDDEN');
+        this.name = 'ForbiddenError';
+    }
+}
+exports.ForbiddenError = ForbiddenError;
+class NotFoundError extends HttpError {
+    constructor(resource = 'Resource') {
+        super(`${resource} not found`, 404, 'NOT_FOUND');
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+class ConflictError extends HttpError {
+    constructor(message = 'Conflict') {
+        super(message, 409, 'CONFLICT');
+        this.name = 'ConflictError';
+    }
+}
+exports.ConflictError = ConflictError;
+class UnprocessableError extends HttpError {
+    constructor(message = 'Unprocessable Entity', details) {
+        super(message, 422, 'UNPROCESSABLE_ENTITY', details);
+        this.name = 'UnprocessableError';
+    }
+}
+exports.UnprocessableError = UnprocessableError;
+class RateLimitError extends HttpError {
+    constructor(message = 'Too many requests') {
+        super(message, 429, 'RATE_LIMITED');
+        this.name = 'RateLimitError';
+    }
+}
+exports.RateLimitError = RateLimitError;
+class InternalError extends HttpError {
+    constructor(message = 'Internal server error') {
+        super(message, 500, 'INTERNAL_ERROR');
+        this.name = 'InternalError';
+    }
+}
+exports.InternalError = InternalError;
+// ─── Global Error Handler ─────────────────────────────────────────────────────
+function renderErrorHtml(err, req) {
+    const stack = err.stack
+        ? err.stack.replace(/\n/g, '<br/>').replace(/ {2}/g, '&nbsp;&nbsp;')
+        : 'No stack trace available.';
+    return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Unhandled Error | Exis</title>
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; background-color: #fcebeb; color: #333; margin: 0; padding: 40px; }
+    .container { max-width: 900px; margin: 0 auto; background: #fff; padding: 30px; border-radius: 8px; box-shadow: 0 10px 25px rgba(200, 0, 0, 0.1); border-left: 6px solid #e53e3e; }
+    h1 { color: #e53e3e; margin-top: 0; font-size: 24px; }
+    .message { font-size: 18px; font-weight: 500; margin-bottom: 20px; padding-bottom: 10px; border-bottom: 1px solid #eee; }
+    .code-block { background: #1e1e1e; color: #d4d4d4; padding: 20px; border-radius: 6px; overflow-x: auto; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace; font-size: 14px; line-height: 1.5; }
+    .req-info { margin-top: 20px; font-size: 14px; color: #666; }
+    .highlight { color: #e53e3e; font-weight: bold; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>Unhandled Server Error</h1>
+    <div class="message">${err.message || 'Unknown Error'}</div>
+    <div class="code-block">${stack}</div>
+    <div class="req-info">
+      <strong>Request:</strong> <span class="highlight">${req.method}</span> ${req.path}
+    </div>
+  </div>
+</body>
+</html>
+  `.trim();
+}
+function createErrorHandler(isDev = false) {
+    return (err, req, res, _next) => {
+        if (res.headersSent)
+            return;
+        // known operational error
+        if (err instanceof HttpError) {
+            if (isDev &&
+                req.headers.accept?.includes('text/html') &&
+                err.statusCode >= 500) {
+                res.status(err.statusCode).html(renderErrorHtml(err, req));
+                return;
+            }
+            res.status(err.statusCode).json(err.toJSON());
+            return;
+        }
+        if (err.name === 'ZodError' ||
+            err.name === 'ValidationError' ||
+            err.name === 'ValidatorError') {
+            let message = err.message;
+            // Normalize ZodError
+            if (err.name === 'ZodError' && 'errors' in err && Array.isArray(err.errors)) {
+                const zodErrors = err.errors;
+                message = 'Validation Error: ' + zodErrors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ');
+            }
+            // Normalize Yup ValidationError
+            else if (err.name === 'ValidationError' && 'inner' in err && Array.isArray(err.inner) && err.inner.length > 0) {
+                const yupErrors = err.inner;
+                message = 'Validation Error: ' + yupErrors.map((e) => `${e.path}: ${e.message}`).join(', ');
+            }
+            res.status(400).json({
+                statusCode: 400,
+                error: 'Bad Request',
+                message,
+            });
+            return;
+        }
+        // syntax error in body
+        if (err instanceof SyntaxError && 'body' in err) {
+            res.status(400).json({
+                success: false,
+                error: {
+                    code: 'INVALID_JSON',
+                    message: 'Invalid JSON in request body',
+                },
+            });
+            return;
+        }
+        // unknown error — don't leak internals in production
+        if (req.log) {
+            req.log.error({ err }, 'unhandled server error');
+        }
+        if (isDev) {
+            console.error('\n\x1b[31m[Exis Unhandled Error]\x1b[0m', err, '\n');
+        }
+        else if (!req.log) {
+            console.error('[Exis Error]', err);
+        }
+        if (isDev && req.headers.accept?.includes('text/html')) {
+            res
+                .status(500)
+                .html(renderErrorHtml(err instanceof Error ? err : new Error(String(err)), req));
+            return;
+        }
+        res.status(500).json({
+            success: false,
+            error: {
+                code: 'INTERNAL_ERROR',
+                message: isDev ? err.message : 'An unexpected error occurred',
+                ...(isDev && { stack: err.stack }),
+            },
+        });
+    };
+}
+/**
+ * Async handler wrapper — catches promise rejections.
+ * Note: Exis automatically handles async promise rejections internally.
+ * This is kept solely for API compatibility with Express middleware.
+ * It is redundant and adds unnecessary Promise allocations.
+ */
+function asyncHandler(fn) {
+    return (req, res, next) => {
+        Promise.resolve(fn(req, res, next)).catch(next);
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,6 @@
+import type { LoggerConfig, Logger } from '../types';
+export declare function createLogger(config?: LoggerConfig): Logger;
+export declare function createSilentLogger(): Logger;
+export declare function isLogger(obj: unknown): obj is Logger;
+export declare function resolveLoggerConfig(config: LoggerConfig | boolean | undefined): LoggerConfig;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAkBpD,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAiB,GAAG,MAAM,CA8B9D;AAID,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAID,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CASpD;AAID,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,GAAG,OAAO,GAAG,SAAS,GACzC,YAAY,CAId"}

package/dist/utils/logger.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+exports.createSilentLogger = createSilentLogger;
+exports.isLogger = isLogger;
+exports.resolveLoggerConfig = resolveLoggerConfig;
+const pino_1 = __importDefault(require("pino"));
+// ─── Create Logger ────────────────────────────────────────────────────────────
+const DEFAULT_REDACT = [
+    'req.headers.authorization',
+    'req.headers.cookie',
+    'req.body.password',
+    'req.body.token',
+    'req.body.secret',
+    '*.password',
+    '*.token',
+    '*.secret',
+    'password',
+    'token',
+    'secret',
+];
+function createLogger(config = {}) {
+    const { level = 'info', pretty = process.env.NODE_ENV !== 'production', redact = DEFAULT_REDACT, } = config;
+    const options = {
+        level,
+        ...(redact && redact.length > 0 && { redact }),
+    };
+    const streams = [];
+    if (pretty) {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const prettyStream = require('pino-pretty')({
+            colorize: true,
+            translateTime: 'SYS:HH:MM:ss',
+            ignore: 'pid,hostname',
+        });
+        streams.push({
+            level: options.level,
+            stream: prettyStream,
+        });
+    }
+    else {
+        streams.push({ level: options.level, stream: process.stdout });
+    }
+    return (0, pino_1.default)(options, pino_1.default.multistream(streams));
+}
+// ─── Silent Logger ────────────────────────────────────────────────────────────
+function createSilentLogger() {
+    return (0, pino_1.default)({ level: 'silent' });
+}
+// ─── Type Guard ───────────────────────────────────────────────────────────────
+function isLogger(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'child' in obj &&
+        typeof obj.child === 'function' &&
+        'info' in obj &&
+        typeof obj.info === 'function');
+}
+// ─── Resolve Config ───────────────────────────────────────────────────────────
+function resolveLoggerConfig(config) {
+    if (config === false)
+        return { level: 'silent' };
+    if (config === true || config === undefined)
+        return {};
+    return config;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;;;AAmBA,oCA8BC;AAID,gDAEC;AAID,4BASC;AAID,kDAMC;AA9ED,gDAAuB;AAGvB,iFAAiF;AAEjF,MAAM,cAAc,GAAG;IACrB,2BAA2B;IAC3B,oBAAoB;IACpB,mBAAmB;IACnB,gBAAgB;IAChB,iBAAiB;IACjB,YAAY;IACZ,SAAS;IACT,UAAU;IACV,UAAU;IACV,OAAO;IACP,QAAQ;CACT,CAAA;AAED,SAAgB,YAAY,CAAC,SAAuB,EAAE;IACpD,MAAM,EACJ,KAAK,GAAG,MAAM,EACd,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAC9C,MAAM,GAAG,cAAc,GACxB,GAAG,MAAM,CAAA;IAEV,MAAM,OAAO,GAAuB;QAClC,KAAK;QACL,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;KAC/C,CAAA;IAED,MAAM,OAAO,GAAuB,EAAE,CAAA;IAEtC,IAAI,MAAM,EAAE,CAAC;QACX,iEAAiE;QACjE,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;YAC1C,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,cAAc;YAC7B,MAAM,EAAE,cAAc;SACvB,CAAC,CAAA;QACF,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,OAAO,CAAC,KAAmB;YAClC,MAAM,EAAE,YAAY;SACrB,CAAC,CAAA;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAmB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9E,CAAC;IAED,OAAO,IAAA,cAAI,EAAC,OAAO,EAAE,cAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAsB,CAAA;AACtE,CAAC;AAED,iFAAiF;AAEjF,SAAgB,kBAAkB;IAChC,OAAO,IAAA,cAAI,EAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAsB,CAAA;AACvD,CAAC;AAED,iFAAiF;AAEjF,SAAgB,QAAQ,CAAC,GAAY;IACnC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAO,IAAI,GAAG;QACd,OAAQ,GAA+B,CAAC,KAAK,KAAK,UAAU;QAC5D,MAAM,IAAI,GAAG;QACb,OAAQ,GAA+B,CAAC,IAAI,KAAK,UAAU,CAC5D,CAAA;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAgB,mBAAmB,CACjC,MAA0C;IAE1C,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,QAAiB,EAAE,CAAA;IACzD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IACtD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/utils/plugin.d.ts

@@ -0,0 +1,7 @@
+import type { ExisPlugin, ExisPluginInstance } from '../types';
+/**
+ * Defines a new Exis plugin.
+ * Returns a hybrid object that can be passed directly to `app.register()` OR called as a function `myPlugin({ options })`.
+ */
+export declare function definePlugin<TOptions = Record<string, unknown>>(plugin: ExisPlugin<TOptions>): ExisPlugin<TOptions> & ((options?: TOptions) => ExisPluginInstance);
+//# sourceMappingURL=plugin.d.ts.map

package/dist/utils/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/utils/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAE9D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,GAC3B,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,KAAK,kBAAkB,CAAC,CAsBrE"}

package/dist/utils/plugin.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definePlugin = definePlugin;
+/**
+ * Defines a new Exis plugin.
+ * Returns a hybrid object that can be passed directly to `app.register()` OR called as a function `myPlugin({ options })`.
+ */
+function definePlugin(plugin) {
+    const factory = (options) => ({
+        plugin: plugin,
+        options,
+    });
+    // Safely copy properties from the plugin object to the factory function
+    // Functions have a read-only 'name' property, so we must use Object.defineProperty
+    for (const key of Object.keys(plugin)) {
+        if (key === 'name') {
+            Object.defineProperty(factory, 'name', {
+                value: plugin.name,
+                writable: false,
+                configurable: true,
+            });
+        }
+        else {
+            ;
+            factory[key] = plugin[key];
+        }
+    }
+    return factory;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/utils/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/utils/plugin.ts"],"names":[],"mappings":";;AAMA,oCAwBC;AA5BD;;;GAGG;AACH,SAAgB,YAAY,CAC1B,MAA4B;IAE5B,MAAM,OAAO,GAAG,CAAC,OAAkB,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,EAAE,MAA6B;QACrC,OAAO;KACR,CAAC,CAAA;IAEF,wEAAwE;IACxE,mFAAmF;IACnF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE;gBACrC,KAAK,EAAE,MAAM,CAAC,IAAI;gBAClB,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,IAAI;aACnB,CAAC,CAAA;QACJ,CAAC;aAAM,CAAC;YACN,CAAC;YAAC,OAAe,CAAC,GAAG,CAAC,GAAI,MAAc,CAAC,GAAG,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,OACuC,CAAA;AAChD,CAAC"}

package/dist/utils/validator.d.ts

@@ -0,0 +1,300 @@
+export type ValidationError = {
+    path: string;
+    message: string;
+};
+export declare class ValidatorError extends Error {
+    errors: ValidationError[];
+    constructor(errors: ValidationError[]);
+}
+export declare abstract class ValidatorType<T> {
+    protected isOptional: boolean;
+    protected _hasDefault: boolean;
+    protected defaultValue?: T | (() => T);
+    optional(): ValidatorType<T | undefined>;
+    default(val: T | (() => T)): ValidatorType<T>;
+    refine(check: (val: T) => boolean, message?: string | ((val: T) => string)): ValidatorType<T>;
+    transform<U>(fn: (val: T) => U): ValidatorType<U>;
+    abstract toOpenApi(): Record<string, unknown>;
+    abstract _validate(value: unknown, path: string): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+    _validateAsync(value: unknown, path: string): Promise<{
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    }>;
+    validate(value: unknown, path?: string): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+    validateAsync(value: unknown, path?: string): Promise<{
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    }>;
+    refineAsync(check: (val: T) => Promise<boolean>, message?: string | ((val: T) => string)): ValidatorType<T>;
+    parse(value: unknown): T;
+    parseAsync(value: unknown): Promise<T>;
+}
+export declare class RefineValidator<T> extends ValidatorType<T> {
+    private base;
+    private check;
+    private message;
+    constructor(base: ValidatorType<T>, check: (val: T) => boolean, message: string | ((val: T) => string));
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class TransformValidator<T, U> extends ValidatorType<U> {
+    private base;
+    private fn;
+    constructor(base: ValidatorType<T>, fn: (val: T) => U);
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: U;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class AsyncRefineValidator<T> extends ValidatorType<T> {
+    private base;
+    private check;
+    private message;
+    constructor(base: ValidatorType<T>, check: (val: T) => Promise<boolean>, message: string | ((val: T) => string));
+    toOpenApi(): Record<string, unknown>;
+    _validate(_value: unknown, _path: string): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+    _validateAsync(value: unknown, path: string): Promise<{
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    }>;
+}
+export declare class StringValidator extends ValidatorType<string> {
+    private minLen?;
+    private minMsg?;
+    private maxLen?;
+    private maxMsg?;
+    private isEmail?;
+    private emailMsg?;
+    private regexPattern?;
+    private regexMsg?;
+    min(len: number, message?: string): this;
+    max(len: number, message?: string): this;
+    email(message?: string): this;
+    regex(pattern: RegExp, message?: string): this;
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: string;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class NumberValidator extends ValidatorType<number> {
+    private minVal?;
+    private minMsg?;
+    private maxVal?;
+    private maxMsg?;
+    min(val: number, message?: string): this;
+    max(val: number, message?: string): this;
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: number;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class BooleanValidator extends ValidatorType<boolean> {
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: boolean;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class ObjectValidator<T extends Record<string, ValidatorType<unknown>>> extends ValidatorType<{
+    [K in keyof T]: ReturnType<T[K]['parse']>;
+}> {
+    private shape;
+    private _keys;
+    constructor(shape: T);
+    partial(): ObjectValidator<{
+        [K in keyof T]: ValidatorType<any>;
+    }>;
+    pick<K extends keyof T>(keys: K[]): ObjectValidator<{
+        [P in K]: T[P];
+    }>;
+    omit<K extends keyof T>(keys: K[]): ObjectValidator<Omit<T, K>>;
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: {
+            [K in keyof T]: ReturnType<T[K]['parse']>;
+        };
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+    _validateAsync(value: unknown, path: string): Promise<{
+        success: true;
+        data: {
+            [K in keyof T]: ReturnType<T[K]['parse']>;
+        };
+    } | {
+        success: false;
+        errors: ValidationError[];
+    }>;
+}
+export declare class ArrayValidator<T extends ValidatorType<unknown>> extends ValidatorType<ReturnType<T['parse']>[]> {
+    private schema;
+    private minLen?;
+    private minMsg?;
+    private maxLen?;
+    private maxMsg?;
+    constructor(schema: T);
+    min(len: number, message?: string): this;
+    max(len: number, message?: string): this;
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: ReturnType<T['parse']>[];
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class EnumValidator<U extends string, T extends [U, ...U[]]> extends ValidatorType<T[number]> {
+    private values;
+    constructor(values: T);
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: T[number];
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class LiteralValidator<T extends string | number | boolean> extends ValidatorType<T> {
+    private exact;
+    constructor(exact: T);
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class UnionValidator<T extends ValidatorType<unknown>[]> extends ValidatorType<ReturnType<T[number]['parse']>> {
+    private schemas;
+    constructor(schemas: T);
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: ReturnType<T[number]['parse']>;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class DateValidator extends ValidatorType<Date> {
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: Date;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class RecordValidator<T extends ValidatorType<unknown>> extends ValidatorType<Record<string, ReturnType<T['parse']>>> {
+    private schema;
+    constructor(schema: T);
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: Record<string, ReturnType<T['parse']>>;
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare class AnyValidator extends ValidatorType<unknown> {
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown): {
+        success: true;
+        data: unknown;
+    };
+}
+export declare class FileValidator extends ValidatorType<{
+    filename: string;
+    mimeType: string;
+    buffer: Buffer;
+}> {
+    private _maxSize?;
+    private _mimeTypes?;
+    maxSize(bytes: number): this;
+    mimeTypes(types: string[]): this;
+    toOpenApi(): Record<string, unknown>;
+    _validate(value: unknown, path: string): {
+        success: true;
+        data: {
+            filename: string;
+            mimeType: string;
+            buffer: Buffer;
+        };
+    } | {
+        success: false;
+        errors: ValidationError[];
+    };
+}
+export declare const v: {
+    string: () => StringValidator;
+    number: () => NumberValidator;
+    boolean: () => BooleanValidator;
+    object: <T extends Record<string, ValidatorType<unknown>>>(shape: T) => ObjectValidator<T>;
+    array: <T extends ValidatorType<unknown>>(schema: T) => ArrayValidator<T>;
+    enum: <U extends string, T extends [U, ...U[]]>(values: T) => EnumValidator<U, T>;
+    literal: <T extends string | number | boolean>(exact: T) => LiteralValidator<T>;
+    union: <T extends ValidatorType<unknown>[]>(schemas: T) => UnionValidator<T>;
+    date: () => DateValidator;
+    record: <T extends ValidatorType<unknown>>(schema: T) => RecordValidator<T>;
+    any: () => AnyValidator;
+    file: () => FileValidator;
+    env: <T extends Record<string, ValidatorType<unknown>>>(schema: ObjectValidator<T>) => ReturnType<ObjectValidator<T>["parse"]>;
+};
+export type Infer<T extends ValidatorType<any>> = ReturnType<T['parse']>;
+//# sourceMappingURL=validator.d.ts.map