@veloxts/validation 0.1.0

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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"}

package/dist/schemas/common.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Common schema utilities and pre-built schemas
+ *
+ * Provides commonly used validation patterns with proper type inference.
+ *
+ * @module schemas/common
+ */
+import { z } from 'zod';
+/**
+ * UUID v4 string schema
+ *
+ * @example
+ * ```typescript
+ * const id = uuidSchema.parse('123e4567-e89b-12d3-a456-426614174000');
+ * // id: string (validated UUID)
+ * ```
+ */
+export declare const uuidSchema: z.ZodString;
+/**
+ * Email address schema
+ */
+export declare const emailSchema: z.ZodString;
+/**
+ * Non-empty string schema
+ */
+export declare const nonEmptyStringSchema: z.ZodString;
+/**
+ * URL string schema
+ */
+export declare const urlSchema: z.ZodString;
+/**
+ * ISO 8601 datetime string schema
+ */
+export declare const datetimeSchema: z.ZodString;
+/**
+ * Generic ID parameter schema (UUID)
+ * Commonly used for route parameters like `/users/:id`
+ */
+export declare const idParamSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+/**
+ * Type for id parameter objects
+ */
+export type IdParam = z.infer<typeof idParamSchema>;
+/**
+ * Creates an ID schema that accepts either UUID or integer string
+ *
+ * @param type - Type of ID to accept ('uuid' | 'integer' | 'string')
+ * @returns Zod schema for the specified ID type
+ */
+export declare function createIdSchema<T extends 'uuid' | 'integer' | 'string'>(type: T): T extends 'uuid' ? typeof uuidSchema : T extends 'integer' ? z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber> : z.ZodString;
+/**
+ * Timestamp fields commonly added to database records
+ */
+export declare const timestampFieldsSchema: z.ZodObject<{
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    createdAt: Date;
+    updatedAt: Date;
+}, {
+    createdAt: Date;
+    updatedAt: Date;
+}>;
+/**
+ * Type for timestamp fields
+ */
+export type TimestampFields = z.infer<typeof timestampFieldsSchema>;
+/**
+ * Base entity schema with ID and timestamps
+ */
+export declare const baseEntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: Date;
+    updatedAt: Date;
+}, {
+    id: string;
+    createdAt: Date;
+    updatedAt: Date;
+}>;
+/**
+ * Type for base entity
+ */
+export type BaseEntity = z.infer<typeof baseEntitySchema>;
+/**
+ * Makes all fields in a schema optional
+ *
+ * @param schema - Zod object schema
+ * @returns Schema with all fields optional
+ *
+ * @example
+ * ```typescript
+ * const UpdateUserSchema = makePartial(UserSchema);
+ * // All fields are now optional
+ * ```
+ */
+export declare function makePartial<T extends z.ZodRawShape>(schema: z.ZodObject<T>): z.ZodObject<{
+    [K in keyof T]: z.ZodOptional<T[K]>;
+}>;
+/**
+ * Makes specific fields required in a partial schema
+ *
+ * @param schema - Zod object schema
+ * @param keys - Array of keys to make required
+ * @returns Schema with specified fields required, others optional
+ *
+ * @example
+ * ```typescript
+ * const UpdateUserSchema = partialExcept(UserSchema, ['id'] as const);
+ * // id is required, all other fields are optional
+ * ```
+ */
+export declare function partialExcept<T extends z.ZodRawShape, K extends keyof T & string>(schema: z.ZodObject<T>, keys: readonly K[]): z.ZodObject<{
+    [P in K]: T[P];
+} & {
+    [P in Exclude<keyof T, K>]: z.ZodOptional<T[P]>;
+}>;
+/**
+ * Omits specified fields from a schema
+ *
+ * @param schema - Zod object schema
+ * @param keys - Array of keys to omit
+ * @returns Schema without the specified fields
+ *
+ * @example
+ * ```typescript
+ * const UserWithoutPassword = omitFields(UserSchema, ['password'] as const);
+ * ```
+ */
+export declare function omitFields<T extends z.ZodRawShape, K extends keyof T & string>(schema: z.ZodObject<T>, keys: readonly K[]): z.ZodObject<Omit<T, K>>;
+/**
+ * Picks specified fields from a schema
+ *
+ * @param schema - Zod object schema
+ * @param keys - Array of keys to pick
+ * @returns Schema with only the specified fields
+ *
+ * @example
+ * ```typescript
+ * const UserIdAndName = pickFields(UserSchema, ['id', 'name'] as const);
+ * ```
+ */
+export declare function pickFields<T extends z.ZodRawShape, K extends keyof T & string>(schema: z.ZodObject<T>, keys: readonly K[]): z.ZodObject<Pick<T, K>>;
+/**
+ * String that coerces to boolean
+ * Accepts 'true', '1', 'yes' as true; 'false', '0', 'no' as false
+ */
+export declare const booleanStringSchema: z.ZodPipeline<z.ZodEffects<z.ZodString, boolean | undefined, string>, z.ZodBoolean>;
+/**
+ * String that coerces to number
+ * Useful for query parameters
+ */
+export declare const numberStringSchema: z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>;
+/**
+ * String that coerces to integer
+ * Useful for pagination parameters
+ */
+export declare const integerStringSchema: z.ZodPipeline<z.ZodEffects<z.ZodString, number, string>, z.ZodNumber>;
+//# sourceMappingURL=common.d.ts.map

package/dist/schemas/common.d.ts.map

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

package/dist/schemas/common.js

@@ -0,0 +1,211 @@
+/**
+ * Common schema utilities and pre-built schemas
+ *
+ * Provides commonly used validation patterns with proper type inference.
+ *
+ * @module schemas/common
+ */
+import { z } from 'zod';
+// ============================================================================
+// Common String Schemas
+// ============================================================================
+/**
+ * UUID v4 string schema
+ *
+ * @example
+ * ```typescript
+ * const id = uuidSchema.parse('123e4567-e89b-12d3-a456-426614174000');
+ * // id: string (validated UUID)
+ * ```
+ */
+export const uuidSchema = z.string().uuid();
+/**
+ * Email address schema
+ */
+export const emailSchema = z.string().email();
+/**
+ * Non-empty string schema
+ */
+export const nonEmptyStringSchema = z.string().min(1);
+/**
+ * URL string schema
+ */
+export const urlSchema = z.string().url();
+/**
+ * ISO 8601 datetime string schema
+ */
+export const datetimeSchema = z.string().datetime();
+// ============================================================================
+// Common ID Schemas
+// ============================================================================
+/**
+ * Generic ID parameter schema (UUID)
+ * Commonly used for route parameters like `/users/:id`
+ */
+export const idParamSchema = z.object({
+    id: uuidSchema,
+});
+/**
+ * Creates an ID schema that accepts either UUID or integer string
+ *
+ * @param type - Type of ID to accept ('uuid' | 'integer' | 'string')
+ * @returns Zod schema for the specified ID type
+ */
+export function createIdSchema(type) {
+    switch (type) {
+        case 'uuid':
+            return uuidSchema;
+        case 'integer':
+            return z
+                .string()
+                .transform((val) => parseInt(val, 10))
+                .pipe(z.number().int().positive());
+        default:
+            return z.string().min(1);
+    }
+}
+// ============================================================================
+// Common Object Schemas
+// ============================================================================
+/**
+ * Timestamp fields commonly added to database records
+ */
+export const timestampFieldsSchema = z.object({
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+});
+/**
+ * Base entity schema with ID and timestamps
+ */
+export const baseEntitySchema = z.object({
+    id: uuidSchema,
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+});
+// ============================================================================
+// Schema Composition Utilities
+// ============================================================================
+/**
+ * Makes all fields in a schema optional
+ *
+ * @param schema - Zod object schema
+ * @returns Schema with all fields optional
+ *
+ * @example
+ * ```typescript
+ * const UpdateUserSchema = makePartial(UserSchema);
+ * // All fields are now optional
+ * ```
+ */
+export function makePartial(schema) {
+    return schema.partial();
+}
+/**
+ * Makes specific fields required in a partial schema
+ *
+ * @param schema - Zod object schema
+ * @param keys - Array of keys to make required
+ * @returns Schema with specified fields required, others optional
+ *
+ * @example
+ * ```typescript
+ * const UpdateUserSchema = partialExcept(UserSchema, ['id'] as const);
+ * // id is required, all other fields are optional
+ * ```
+ */
+export function partialExcept(schema, keys) {
+    const shape = schema.shape;
+    const requiredKeys = new Set(keys);
+    const newShape = {};
+    for (const key in shape) {
+        if (requiredKeys.has(key)) {
+            newShape[key] = shape[key];
+        }
+        else {
+            newShape[key] = shape[key].optional();
+        }
+    }
+    return z.object(newShape);
+}
+/**
+ * Omits specified fields from a schema
+ *
+ * @param schema - Zod object schema
+ * @param keys - Array of keys to omit
+ * @returns Schema without the specified fields
+ *
+ * @example
+ * ```typescript
+ * const UserWithoutPassword = omitFields(UserSchema, ['password'] as const);
+ * ```
+ */
+export function omitFields(schema, keys) {
+    // Build the omit mask manually to avoid Zod's strict typing
+    const shape = schema.shape;
+    const keysToOmit = new Set(keys);
+    const newShape = {};
+    for (const key in shape) {
+        if (!keysToOmit.has(key)) {
+            newShape[key] = shape[key];
+        }
+    }
+    return z.object(newShape);
+}
+/**
+ * Picks specified fields from a schema
+ *
+ * @param schema - Zod object schema
+ * @param keys - Array of keys to pick
+ * @returns Schema with only the specified fields
+ *
+ * @example
+ * ```typescript
+ * const UserIdAndName = pickFields(UserSchema, ['id', 'name'] as const);
+ * ```
+ */
+export function pickFields(schema, keys) {
+    // Build the pick mask manually to avoid Zod's strict typing
+    const shape = schema.shape;
+    const newShape = {};
+    for (const key of keys) {
+        if (key in shape) {
+            newShape[key] = shape[key];
+        }
+    }
+    return z.object(newShape);
+}
+// ============================================================================
+// Coercion Utilities
+// ============================================================================
+/**
+ * String that coerces to boolean
+ * Accepts 'true', '1', 'yes' as true; 'false', '0', 'no' as false
+ */
+export const booleanStringSchema = z
+    .string()
+    .transform((val) => {
+    const lower = val.toLowerCase();
+    if (['true', '1', 'yes'].includes(lower))
+        return true;
+    if (['false', '0', 'no'].includes(lower))
+        return false;
+    return undefined;
+})
+    .pipe(z.boolean());
+/**
+ * String that coerces to number
+ * Useful for query parameters
+ */
+export const numberStringSchema = z
+    .string()
+    .transform((val) => Number(val))
+    .pipe(z.number());
+/**
+ * String that coerces to integer
+ * Useful for pagination parameters
+ */
+export const integerStringSchema = z
+    .string()
+    .transform((val) => parseInt(val, 10))
+    .pipe(z.number().int());
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

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