@veloxts/validation 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @veloxts/validation - Zod integration for runtime validation
+ *
+ * Provides Zod-based validation with automatic type inference for
+ * procedure inputs/outputs and request validation.
+ *
+ * @example
+ * ```typescript
+ * import { z, parse, InferOutput } from '@veloxts/validation';
+ *
+ * const UserSchema = z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string().min(1),
+ *   email: z.string().email(),
+ * });
+ *
+ * type User = InferOutput<typeof UserSchema>;
+ *
+ * const user = parse(UserSchema, data);
+ * // user is typed as User
+ * ```
+ *
+ * @module @veloxts/validation
+ */
+export { ZodError, type ZodType, type ZodTypeDef, z } from 'zod';
+export declare const VALIDATION_VERSION: "0.1.0";
+export type { AnySchema, AnyZodSchema, InferInput, InferOutput, NoInput, ResolveInput, ResolveOutput, SafeParseError, SafeParseResult, SafeParseSuccess, Schema, SchemaLike, UnknownOutput, ValidationIssue, } from './types.js';
+export { isSchema, isZodSchema, wrapSchema } from './types.js';
+export type { Validator } from './middleware.js';
+export { assertSchema, createTypeGuard, createValidator, formatZodErrors, parse, parseAll, safeParse, safeValidate, validate, validateAll, zodErrorToValidationError, } from './middleware.js';
+export type { BaseEntity, IdParam, TimestampFields } from './schemas/common.js';
+export { baseEntitySchema, booleanStringSchema, createIdSchema, datetimeSchema, emailSchema, idParamSchema, integerStringSchema, makePartial, nonEmptyStringSchema, numberStringSchema, omitFields, partialExcept, pickFields, timestampFieldsSchema, urlSchema, uuidSchema, } from './schemas/common.js';
+export type { CursorPaginatedResponse, CursorPaginationInput, CursorPaginationMeta, PaginatedResponse, PaginationInput, PaginationMeta, } from './schemas/pagination.js';
+export { calculateOffset, calculatePaginationMeta, createCursorPaginatedResponseSchema, createPaginatedResponse, createPaginatedResponseSchema, createPaginationSchema, cursorPaginationSchema, PAGINATION_DEFAULTS, paginationInputSchema, } from './schemas/pagination.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGjE,eAAO,MAAM,kBAAkB,EAAG,OAAgB,CAAC;AAMnD,YAAY,EAEV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,OAAO,EACP,YAAY,EACZ,aAAa,EAEb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU/D,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,KAAK,EACL,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAMzB,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,UAAU,GACX,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,mCAAmC,EACnC,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * @veloxts/validation - Zod integration for runtime validation
+ *
+ * Provides Zod-based validation with automatic type inference for
+ * procedure inputs/outputs and request validation.
+ *
+ * @example
+ * ```typescript
+ * import { z, parse, InferOutput } from '@veloxts/validation';
+ *
+ * const UserSchema = z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string().min(1),
+ *   email: z.string().email(),
+ * });
+ *
+ * type User = InferOutput<typeof UserSchema>;
+ *
+ * const user = parse(UserSchema, data);
+ * // user is typed as User
+ * ```
+ *
+ * @module @veloxts/validation
+ */
+// Re-export Zod for convenience
+// Users can import { z } from '@veloxts/validation' instead of installing zod separately
+export { ZodError, z } from 'zod';
+// Version constant
+export const VALIDATION_VERSION = '0.1.0';
+export { isSchema, isZodSchema, wrapSchema } from './types.js';
+// Primary API - parse functions (Zod naming convention)
+// Deprecated aliases for backwards compatibility
+export { assertSchema, createTypeGuard, createValidator, formatZodErrors, parse, parseAll, safeParse, safeValidate, validate, validateAll, zodErrorToValidationError, } from './middleware.js';
+export { baseEntitySchema, booleanStringSchema, createIdSchema, datetimeSchema, emailSchema, idParamSchema, integerStringSchema, makePartial, nonEmptyStringSchema, numberStringSchema, omitFields, partialExcept, pickFields, timestampFieldsSchema, urlSchema, uuidSchema, } from './schemas/common.js';
+export { calculateOffset, calculatePaginationMeta, createCursorPaginatedResponseSchema, createPaginatedResponse, createPaginatedResponseSchema, createPaginationSchema, cursorPaginationSchema, PAGINATION_DEFAULTS, paginationInputSchema, } from './schemas/pagination.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,gCAAgC;AAChC,yFAAyF;AACzF,OAAO,EAAE,QAAQ,EAAiC,CAAC,EAAE,MAAM,KAAK,CAAC;AAEjE,mBAAmB;AACnB,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAgB,CAAC;AAwBnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAW/D,wDAAwD;AACxD,iDAAiD;AACjD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,KAAK,EACL,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,UAAU,GACX,MAAM,qBAAqB,CAAC;AAc7B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,mCAAmC,EACnC,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Validation middleware for VeloxTS procedures and routes
+ *
+ * Provides middleware utilities for validating request data
+ * with proper error handling and type inference.
+ *
+ * @module middleware
+ */
+import { ValidationError } from '@veloxts/core';
+import { ZodError, type ZodType, type ZodTypeDef } from 'zod';
+import type { AnySchema, AnyZodSchema, SafeParseResult } from './types.js';
+/**
+ * Transforms Zod validation issues into a field-error map
+ *
+ * @param issues - Array of Zod validation issues
+ * @returns Record mapping field paths to error messages
+ */
+export declare function formatZodErrors(issues: readonly {
+    path: readonly (string | number)[];
+    message: string;
+}[]): Record<string, string>;
+/**
+ * Transforms a ZodError into a VeloxTSValidationError
+ *
+ * @param error - ZodError from failed validation
+ * @param customMessage - Optional custom error message
+ * @returns ValidationError with field-specific errors
+ */
+export declare function zodErrorToValidationError(error: ZodError, customMessage?: string): ValidationError;
+/**
+ * Parses and validates data against a schema, throwing ValidationError on failure
+ *
+ * Follows Zod's naming convention for consistency with the ecosystem.
+ *
+ * @template T - The validated output type
+ * @param schema - Zod schema or Schema wrapper
+ * @param data - Data to validate
+ * @param errorMessage - Optional custom error message
+ * @returns Validated data with proper type
+ * @throws ValidationError if validation fails
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({ name: z.string(), email: z.string().email() });
+ *
+ * const user = parse(UserSchema, request.body);
+ * // user is typed as { name: string; email: string }
+ * ```
+ */
+export declare function parse<T>(schema: ZodType<T, ZodTypeDef, unknown> | AnySchema, data: unknown, errorMessage?: string): T;
+/**
+ * @deprecated Use `parse` instead. This alias will be removed in v1.0.
+ */
+export declare const validate: typeof parse;
+/**
+ * Safely parses data without throwing
+ *
+ * Follows Zod's naming convention for consistency with the ecosystem.
+ *
+ * @template T - The validated output type
+ * @param schema - Zod schema or Schema wrapper
+ * @param data - Data to validate
+ * @returns Safe parse result with success discriminator
+ *
+ * @example
+ * ```typescript
+ * const result = safeParse(UserSchema, request.body);
+ * if (result.success) {
+ *   console.log(result.data.name);
+ * } else {
+ *   console.log(result.error);
+ * }
+ * ```
+ */
+export declare function safeParse<T>(schema: ZodType<T, ZodTypeDef, unknown> | AnySchema, data: unknown): SafeParseResult<T>;
+/**
+ * @deprecated Use `safeParse` instead. This alias will be removed in v1.0.
+ */
+export declare const safeValidate: typeof safeParse;
+/**
+ * Creates a reusable validator function from a schema
+ *
+ * @template TOutput - The validated output type
+ * @template TInput - The input type (defaults to unknown)
+ * @param schema - Zod schema for validation
+ * @returns Object with parse and safeParse methods
+ *
+ * @example
+ * ```typescript
+ * const userValidator = createValidator(UserSchema);
+ *
+ * // In a handler
+ * const user = userValidator.parse(request.body);
+ * ```
+ */
+export declare function createValidator<TOutput, TInput = unknown>(schema: ZodType<TOutput, ZodTypeDef, TInput>): Validator<TOutput>;
+/**
+ * Validator interface for type-safe validation
+ */
+export interface Validator<T> {
+    /** Parses data, throwing ValidationError on failure */
+    parse(data: unknown): T;
+    /** Safely parses data without throwing */
+    safeParse(data: unknown): SafeParseResult<T>;
+    /** @deprecated Use `parse` instead */
+    validate(data: unknown): T;
+    /** @deprecated Use `safeParse` instead */
+    safeValidate(data: unknown): SafeParseResult<T>;
+    /** The underlying Zod schema */
+    schema: AnyZodSchema;
+}
+/**
+ * Parses multiple data sources at once
+ *
+ * Useful for validating body, query, and params together.
+ *
+ * @param validations - Object mapping names to schema/data pairs
+ * @returns Object with validated data for each key
+ * @throws ValidationError with combined errors if any validation fails
+ *
+ * @example
+ * ```typescript
+ * const { body, query, params } = parseAll({
+ *   body: [CreateUserSchema, request.body],
+ *   query: [PaginationSchema, request.query],
+ *   params: [IdParamSchema, request.params],
+ * });
+ * ```
+ */
+export declare function parseAll<T extends Record<string, [AnyZodSchema, unknown]>>(validations: T): {
+    [K in keyof T]: T[K][0] extends ZodType<infer O, ZodTypeDef, unknown> ? O : never;
+};
+/**
+ * @deprecated Use `parseAll` instead. This alias will be removed in v1.0.
+ */
+export declare const validateAll: typeof parseAll;
+/**
+ * Creates a type guard from a Zod schema
+ *
+ * @template T - The validated type
+ * @param schema - Zod schema to use for checking
+ * @returns Type predicate function
+ *
+ * @example
+ * ```typescript
+ * const isUser = createTypeGuard(UserSchema);
+ *
+ * if (isUser(data)) {
+ *   // data is typed as User
+ *   console.log(data.name);
+ * }
+ * ```
+ */
+export declare function createTypeGuard<T>(schema: ZodType<T, ZodTypeDef, unknown>): (value: unknown) => value is T;
+/**
+ * Asserts that a value matches a schema, narrowing the type
+ *
+ * @template T - The validated type
+ * @param schema - Zod schema to validate against
+ * @param value - Value to assert
+ * @param errorMessage - Optional custom error message
+ * @throws ValidationError if assertion fails
+ *
+ * @example
+ * ```typescript
+ * function processUser(data: unknown) {
+ *   assertSchema(UserSchema, data);
+ *   // data is now typed as User
+ *   console.log(data.name);
+ * }
+ * ```
+ */
+export declare function assertSchema<T>(schema: ZodType<T, ZodTypeDef, unknown>, value: unknown, errorMessage?: string): asserts value is T;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

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

package/dist/middleware.js

@@ -0,0 +1,274 @@
+/**
+ * Validation middleware for VeloxTS procedures and routes
+ *
+ * Provides middleware utilities for validating request data
+ * with proper error handling and type inference.
+ *
+ * @module middleware
+ */
+import { ValidationError } from '@veloxts/core';
+import { ZodError } from 'zod';
+import { isSchema, isZodSchema } from './types.js';
+// ============================================================================
+// Error Transformation
+// ============================================================================
+/**
+ * Transforms Zod validation issues into a field-error map
+ *
+ * @param issues - Array of Zod validation issues
+ * @returns Record mapping field paths to error messages
+ */
+export function formatZodErrors(issues) {
+    const fields = {};
+    for (const issue of issues) {
+        const path = issue.path.join('.') || '_root';
+        // Only keep the first error for each field
+        if (!(path in fields)) {
+            fields[path] = issue.message;
+        }
+    }
+    return fields;
+}
+/**
+ * Transforms a ZodError into a VeloxTSValidationError
+ *
+ * @param error - ZodError from failed validation
+ * @param customMessage - Optional custom error message
+ * @returns ValidationError with field-specific errors
+ */
+export function zodErrorToValidationError(error, customMessage) {
+    const fields = formatZodErrors(error.issues);
+    const message = customMessage ?? 'Validation failed';
+    return new ValidationError(message, fields);
+}
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Parses and validates data against a schema, throwing ValidationError on failure
+ *
+ * Follows Zod's naming convention for consistency with the ecosystem.
+ *
+ * @template T - The validated output type
+ * @param schema - Zod schema or Schema wrapper
+ * @param data - Data to validate
+ * @param errorMessage - Optional custom error message
+ * @returns Validated data with proper type
+ * @throws ValidationError if validation fails
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({ name: z.string(), email: z.string().email() });
+ *
+ * const user = parse(UserSchema, request.body);
+ * // user is typed as { name: string; email: string }
+ * ```
+ */
+export function parse(schema, data, errorMessage) {
+    try {
+        if (isSchema(schema)) {
+            const result = schema.safeParse(data);
+            if (result.success) {
+                return result.data;
+            }
+            throw new ValidationError(errorMessage ?? 'Validation failed', formatZodErrors(result.error));
+        }
+        if (isZodSchema(schema)) {
+            return schema.parse(data);
+        }
+        throw new Error('Invalid schema provided to parse()');
+    }
+    catch (error) {
+        if (error instanceof ValidationError) {
+            throw error;
+        }
+        if (error instanceof ZodError) {
+            throw zodErrorToValidationError(error, errorMessage);
+        }
+        throw error;
+    }
+}
+/**
+ * @deprecated Use `parse` instead. This alias will be removed in v1.0.
+ */
+export const validate = parse;
+/**
+ * Safely parses data without throwing
+ *
+ * Follows Zod's naming convention for consistency with the ecosystem.
+ *
+ * @template T - The validated output type
+ * @param schema - Zod schema or Schema wrapper
+ * @param data - Data to validate
+ * @returns Safe parse result with success discriminator
+ *
+ * @example
+ * ```typescript
+ * const result = safeParse(UserSchema, request.body);
+ * if (result.success) {
+ *   console.log(result.data.name);
+ * } else {
+ *   console.log(result.error);
+ * }
+ * ```
+ */
+export function safeParse(schema, data) {
+    if (isSchema(schema)) {
+        return schema.safeParse(data);
+    }
+    if (isZodSchema(schema)) {
+        const zodSchema = schema;
+        const result = zodSchema.safeParse(data);
+        if (result.success) {
+            return { success: true, data: result.data };
+        }
+        return {
+            success: false,
+            error: result.error.issues.map((issue) => ({
+                path: issue.path,
+                message: issue.message,
+                code: issue.code,
+            })),
+        };
+    }
+    return {
+        success: false,
+        error: [{ path: [], message: 'Invalid schema provided', code: 'custom' }],
+    };
+}
+/**
+ * @deprecated Use `safeParse` instead. This alias will be removed in v1.0.
+ */
+export const safeValidate = safeParse;
+// ============================================================================
+// Schema Validators
+// ============================================================================
+/**
+ * Creates a reusable validator function from a schema
+ *
+ * @template TOutput - The validated output type
+ * @template TInput - The input type (defaults to unknown)
+ * @param schema - Zod schema for validation
+ * @returns Object with parse and safeParse methods
+ *
+ * @example
+ * ```typescript
+ * const userValidator = createValidator(UserSchema);
+ *
+ * // In a handler
+ * const user = userValidator.parse(request.body);
+ * ```
+ */
+export function createValidator(schema) {
+    return {
+        parse(data) {
+            return parse(schema, data);
+        },
+        safeParse(data) {
+            return safeParse(schema, data);
+        },
+        // Deprecated aliases
+        validate(data) {
+            return parse(schema, data);
+        },
+        safeValidate(data) {
+            return safeParse(schema, data);
+        },
+        schema,
+    };
+}
+// ============================================================================
+// Request Validation Helpers
+// ============================================================================
+/**
+ * Parses multiple data sources at once
+ *
+ * Useful for validating body, query, and params together.
+ *
+ * @param validations - Object mapping names to schema/data pairs
+ * @returns Object with validated data for each key
+ * @throws ValidationError with combined errors if any validation fails
+ *
+ * @example
+ * ```typescript
+ * const { body, query, params } = parseAll({
+ *   body: [CreateUserSchema, request.body],
+ *   query: [PaginationSchema, request.query],
+ *   params: [IdParamSchema, request.params],
+ * });
+ * ```
+ */
+export function parseAll(validations) {
+    const results = {};
+    const allErrors = {};
+    for (const [key, [schema, data]] of Object.entries(validations)) {
+        const result = safeParse(schema, data);
+        if (result.success) {
+            results[key] = result.data;
+        }
+        else {
+            for (const issue of result.error) {
+                const path = issue.path.length > 0 ? `${key}.${issue.path.join('.')}` : key;
+                if (!(path in allErrors)) {
+                    allErrors[path] = issue.message;
+                }
+            }
+        }
+    }
+    if (Object.keys(allErrors).length > 0) {
+        throw new ValidationError('Validation failed', allErrors);
+    }
+    return results;
+}
+/**
+ * @deprecated Use `parseAll` instead. This alias will be removed in v1.0.
+ */
+export const validateAll = parseAll;
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Creates a type guard from a Zod schema
+ *
+ * @template T - The validated type
+ * @param schema - Zod schema to use for checking
+ * @returns Type predicate function
+ *
+ * @example
+ * ```typescript
+ * const isUser = createTypeGuard(UserSchema);
+ *
+ * if (isUser(data)) {
+ *   // data is typed as User
+ *   console.log(data.name);
+ * }
+ * ```
+ */
+export function createTypeGuard(schema) {
+    return (value) => {
+        const result = schema.safeParse(value);
+        return result.success;
+    };
+}
+/**
+ * Asserts that a value matches a schema, narrowing the type
+ *
+ * @template T - The validated type
+ * @param schema - Zod schema to validate against
+ * @param value - Value to assert
+ * @param errorMessage - Optional custom error message
+ * @throws ValidationError if assertion fails
+ *
+ * @example
+ * ```typescript
+ * function processUser(data: unknown) {
+ *   assertSchema(UserSchema, data);
+ *   // data is now typed as User
+ *   console.log(data.name);
+ * }
+ * ```
+ */
+export function assertSchema(schema, value, errorMessage) {
+    validate(schema, value, errorMessage);
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

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