@veloxts/validation 0.1.0

package/dist/schemas/pagination.d.ts

@@ -0,0 +1,287 @@
+/**
+ * Pagination schema utilities
+ *
+ * Provides standardized pagination input/output schemas for list endpoints.
+ *
+ * @module schemas/pagination
+ */
+import { z } from 'zod';
+/**
+ * Default pagination configuration
+ */
+export declare const PAGINATION_DEFAULTS: {
+    /** Default page number */
+    readonly page: 1;
+    /** Default items per page */
+    readonly limit: 20;
+    /** Maximum allowed items per page */
+    readonly maxLimit: 100;
+};
+/**
+ * Creates a pagination input schema with configurable defaults
+ *
+ * @param options - Pagination configuration options
+ * @returns Zod schema for pagination input
+ *
+ * @example
+ * ```typescript
+ * // Use defaults
+ * const PaginationSchema = createPaginationSchema();
+ *
+ * // Custom configuration
+ * const CustomPaginationSchema = createPaginationSchema({
+ *   defaultLimit: 10,
+ *   maxLimit: 50,
+ * });
+ * ```
+ */
+export declare function createPaginationSchema(options?: {
+    defaultPage?: number;
+    defaultLimit?: number;
+    maxLimit?: number;
+}): z.ZodObject<{
+    /** Current page number (1-indexed) */
+    page: z.ZodDefault<z.ZodNumber>;
+    /** Number of items per page */
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    limit: number;
+}, {
+    page?: number | undefined;
+    limit?: number | undefined;
+}>;
+/**
+ * Default pagination input schema
+ *
+ * Accepts page (default 1) and limit (default 20, max 100)
+ */
+export declare const paginationInputSchema: z.ZodObject<{
+    /** Current page number (1-indexed) */
+    page: z.ZodDefault<z.ZodNumber>;
+    /** Number of items per page */
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    limit: number;
+}, {
+    page?: number | undefined;
+    limit?: number | undefined;
+}>;
+/**
+ * Type for pagination input
+ */
+export type PaginationInput = z.infer<typeof paginationInputSchema>;
+/**
+ * Pagination with cursor-based navigation
+ *
+ * For more efficient pagination of large datasets
+ */
+export declare const cursorPaginationSchema: z.ZodObject<{
+    /** Cursor for the current position */
+    cursor: z.ZodOptional<z.ZodString>;
+    /** Number of items to fetch */
+    limit: z.ZodDefault<z.ZodNumber>;
+    /** Direction to fetch (forward/backward from cursor) */
+    direction: z.ZodDefault<z.ZodEnum<["forward", "backward"]>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    direction: "forward" | "backward";
+    cursor?: string | undefined;
+}, {
+    limit?: number | undefined;
+    cursor?: string | undefined;
+    direction?: "forward" | "backward" | undefined;
+}>;
+/**
+ * Type for cursor-based pagination input
+ */
+export type CursorPaginationInput = z.infer<typeof cursorPaginationSchema>;
+/**
+ * Creates a paginated response schema for a given item schema
+ *
+ * @param itemSchema - Zod schema for individual items
+ * @returns Zod schema for paginated response
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({ id: z.string(), name: z.string() });
+ * const PaginatedUsersSchema = createPaginatedResponseSchema(UserSchema);
+ *
+ * type PaginatedUsers = z.infer<typeof PaginatedUsersSchema>;
+ * // { data: User[]; meta: { page, limit, total, totalPages, hasMore } }
+ * ```
+ */
+export declare function createPaginatedResponseSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    /** Array of items for the current page */
+    data: z.ZodArray<T, "many">;
+    /** Pagination metadata */
+    meta: z.ZodObject<{
+        /** Current page number */
+        page: z.ZodNumber;
+        /** Items per page */
+        limit: z.ZodNumber;
+        /** Total number of items across all pages */
+        total: z.ZodNumber;
+        /** Total number of pages */
+        totalPages: z.ZodNumber;
+        /** Whether there are more pages after this one */
+        hasMore: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasMore: boolean;
+    }, {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasMore: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: T["_output"][];
+    meta: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasMore: boolean;
+    };
+}, {
+    data: T["_input"][];
+    meta: {
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasMore: boolean;
+    };
+}>;
+/**
+ * Type helper to infer paginated response type from item schema
+ */
+export type PaginatedResponse<T> = {
+    data: T[];
+    meta: PaginationMeta;
+};
+/**
+ * Pagination metadata type
+ */
+export interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasMore: boolean;
+}
+/**
+ * Creates a cursor-based paginated response schema
+ *
+ * @param itemSchema - Zod schema for individual items
+ * @returns Zod schema for cursor-paginated response
+ */
+export declare function createCursorPaginatedResponseSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    /** Array of items */
+    data: z.ZodArray<T, "many">;
+    /** Cursor pagination metadata */
+    meta: z.ZodObject<{
+        /** Cursor for the next page (null if no more) */
+        nextCursor: z.ZodNullable<z.ZodString>;
+        /** Cursor for the previous page (null if at start) */
+        prevCursor: z.ZodNullable<z.ZodString>;
+        /** Whether there are more items after this page */
+        hasMore: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        hasMore: boolean;
+        nextCursor: string | null;
+        prevCursor: string | null;
+    }, {
+        hasMore: boolean;
+        nextCursor: string | null;
+        prevCursor: string | null;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: T["_output"][];
+    meta: {
+        hasMore: boolean;
+        nextCursor: string | null;
+        prevCursor: string | null;
+    };
+}, {
+    data: T["_input"][];
+    meta: {
+        hasMore: boolean;
+        nextCursor: string | null;
+        prevCursor: string | null;
+    };
+}>;
+/**
+ * Type for cursor-paginated response
+ */
+export type CursorPaginatedResponse<T> = {
+    data: T[];
+    meta: CursorPaginationMeta;
+};
+/**
+ * Cursor pagination metadata type
+ */
+export interface CursorPaginationMeta {
+    nextCursor: string | null;
+    prevCursor: string | null;
+    hasMore: boolean;
+}
+/**
+ * Calculates pagination metadata from total count
+ *
+ * @param options - Pagination calculation options
+ * @returns Pagination metadata
+ *
+ * @example
+ * ```typescript
+ * const meta = calculatePaginationMeta({
+ *   page: 2,
+ *   limit: 20,
+ *   total: 55,
+ * });
+ * // { page: 2, limit: 20, total: 55, totalPages: 3, hasMore: true }
+ * ```
+ */
+export declare function calculatePaginationMeta(options: {
+    page: number;
+    limit: number;
+    total: number;
+}): PaginationMeta;
+/**
+ * Calculates offset for database queries
+ *
+ * @param page - Current page number (1-indexed)
+ * @param limit - Items per page
+ * @returns Offset for database skip
+ *
+ * @example
+ * ```typescript
+ * const offset = calculateOffset(3, 20);
+ * // offset = 40 (skip first 40 items for page 3)
+ * ```
+ */
+export declare function calculateOffset(page: number, limit: number): number;
+/**
+ * Creates a paginated response from items and total count
+ *
+ * @param items - Array of items for current page
+ * @param pagination - Pagination input parameters
+ * @param total - Total count of items
+ * @returns Paginated response object
+ *
+ * @example
+ * ```typescript
+ * const users = await db.user.findMany({ skip: 20, take: 20 });
+ * const total = await db.user.count();
+ *
+ * return createPaginatedResponse(users, { page: 2, limit: 20 }, total);
+ * ```
+ */
+export declare function createPaginatedResponse<T>(items: T[], pagination: PaginationInput, total: number): PaginatedResponse<T>;
+//# sourceMappingURL=pagination.d.ts.map

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

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

package/dist/schemas/pagination.js

@@ -0,0 +1,202 @@
+/**
+ * Pagination schema utilities
+ *
+ * Provides standardized pagination input/output schemas for list endpoints.
+ *
+ * @module schemas/pagination
+ */
+import { z } from 'zod';
+// ============================================================================
+// Pagination Constants
+// ============================================================================
+/**
+ * Default pagination configuration
+ */
+export const PAGINATION_DEFAULTS = {
+    /** Default page number */
+    page: 1,
+    /** Default items per page */
+    limit: 20,
+    /** Maximum allowed items per page */
+    maxLimit: 100,
+};
+// ============================================================================
+// Pagination Input Schemas
+// ============================================================================
+/**
+ * Creates a pagination input schema with configurable defaults
+ *
+ * @param options - Pagination configuration options
+ * @returns Zod schema for pagination input
+ *
+ * @example
+ * ```typescript
+ * // Use defaults
+ * const PaginationSchema = createPaginationSchema();
+ *
+ * // Custom configuration
+ * const CustomPaginationSchema = createPaginationSchema({
+ *   defaultLimit: 10,
+ *   maxLimit: 50,
+ * });
+ * ```
+ */
+export function createPaginationSchema(options = {}) {
+    const { defaultPage = PAGINATION_DEFAULTS.page, defaultLimit = PAGINATION_DEFAULTS.limit, maxLimit = PAGINATION_DEFAULTS.maxLimit, } = options;
+    return z.object({
+        /** Current page number (1-indexed) */
+        page: z.coerce.number().int().positive().default(defaultPage),
+        /** Number of items per page */
+        limit: z.coerce.number().int().positive().max(maxLimit).default(defaultLimit),
+    });
+}
+/**
+ * Default pagination input schema
+ *
+ * Accepts page (default 1) and limit (default 20, max 100)
+ */
+export const paginationInputSchema = createPaginationSchema();
+/**
+ * Pagination with cursor-based navigation
+ *
+ * For more efficient pagination of large datasets
+ */
+export const cursorPaginationSchema = z.object({
+    /** Cursor for the current position */
+    cursor: z.string().optional(),
+    /** Number of items to fetch */
+    limit: z.coerce.number().int().positive().max(100).default(20),
+    /** Direction to fetch (forward/backward from cursor) */
+    direction: z.enum(['forward', 'backward']).default('forward'),
+});
+// ============================================================================
+// Pagination Output Types
+// ============================================================================
+/**
+ * Creates a paginated response schema for a given item schema
+ *
+ * @param itemSchema - Zod schema for individual items
+ * @returns Zod schema for paginated response
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({ id: z.string(), name: z.string() });
+ * const PaginatedUsersSchema = createPaginatedResponseSchema(UserSchema);
+ *
+ * type PaginatedUsers = z.infer<typeof PaginatedUsersSchema>;
+ * // { data: User[]; meta: { page, limit, total, totalPages, hasMore } }
+ * ```
+ */
+export function createPaginatedResponseSchema(itemSchema) {
+    return z.object({
+        /** Array of items for the current page */
+        data: z.array(itemSchema),
+        /** Pagination metadata */
+        meta: z.object({
+            /** Current page number */
+            page: z.number().int().positive(),
+            /** Items per page */
+            limit: z.number().int().positive(),
+            /** Total number of items across all pages */
+            total: z.number().int().nonnegative(),
+            /** Total number of pages */
+            totalPages: z.number().int().nonnegative(),
+            /** Whether there are more pages after this one */
+            hasMore: z.boolean(),
+        }),
+    });
+}
+/**
+ * Creates a cursor-based paginated response schema
+ *
+ * @param itemSchema - Zod schema for individual items
+ * @returns Zod schema for cursor-paginated response
+ */
+export function createCursorPaginatedResponseSchema(itemSchema) {
+    return z.object({
+        /** Array of items */
+        data: z.array(itemSchema),
+        /** Cursor pagination metadata */
+        meta: z.object({
+            /** Cursor for the next page (null if no more) */
+            nextCursor: z.string().nullable(),
+            /** Cursor for the previous page (null if at start) */
+            prevCursor: z.string().nullable(),
+            /** Whether there are more items after this page */
+            hasMore: z.boolean(),
+        }),
+    });
+}
+// ============================================================================
+// Pagination Utilities
+// ============================================================================
+/**
+ * Calculates pagination metadata from total count
+ *
+ * @param options - Pagination calculation options
+ * @returns Pagination metadata
+ *
+ * @example
+ * ```typescript
+ * const meta = calculatePaginationMeta({
+ *   page: 2,
+ *   limit: 20,
+ *   total: 55,
+ * });
+ * // { page: 2, limit: 20, total: 55, totalPages: 3, hasMore: true }
+ * ```
+ */
+export function calculatePaginationMeta(options) {
+    const { page, limit, total } = options;
+    const totalPages = Math.ceil(total / limit);
+    return {
+        page,
+        limit,
+        total,
+        totalPages,
+        hasMore: page < totalPages,
+    };
+}
+/**
+ * Calculates offset for database queries
+ *
+ * @param page - Current page number (1-indexed)
+ * @param limit - Items per page
+ * @returns Offset for database skip
+ *
+ * @example
+ * ```typescript
+ * const offset = calculateOffset(3, 20);
+ * // offset = 40 (skip first 40 items for page 3)
+ * ```
+ */
+export function calculateOffset(page, limit) {
+    return (page - 1) * limit;
+}
+/**
+ * Creates a paginated response from items and total count
+ *
+ * @param items - Array of items for current page
+ * @param pagination - Pagination input parameters
+ * @param total - Total count of items
+ * @returns Paginated response object
+ *
+ * @example
+ * ```typescript
+ * const users = await db.user.findMany({ skip: 20, take: 20 });
+ * const total = await db.user.count();
+ *
+ * return createPaginatedResponse(users, { page: 2, limit: 20 }, total);
+ * ```
+ */
+export function createPaginatedResponse(items, pagination, total) {
+    return {
+        data: items,
+        meta: calculatePaginationMeta({
+            page: pagination.page,
+            limit: pagination.limit,
+            total,
+        }),
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/schemas/pagination.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Core type definitions for @veloxts/validation
+ *
+ * Provides type-safe Zod integration with automatic type inference
+ * for procedure inputs/outputs.
+ *
+ * @module types
+ */
+import type { ZodType, ZodTypeDef } from 'zod';
+/**
+ * Type-safe validator interface that wraps Zod schemas
+ *
+ * This abstraction allows the framework to work with Zod while maintaining
+ * the flexibility to support other validation libraries in the future.
+ *
+ * @template TOutput - The validated output type
+ * @template TInput - The raw input type (defaults to TOutput)
+ */
+export interface Schema<TOutput = unknown, _TInput = TOutput> {
+    /**
+     * Parses input and returns validated data
+     * Throws ZodError on validation failure
+     */
+    readonly parse: (input: unknown) => TOutput;
+    /**
+     * Safely parses input without throwing
+     * Returns discriminated union with success/error
+     */
+    readonly safeParse: (input: unknown) => SafeParseResult<TOutput>;
+    /**
+     * Brand to identify Schema instances
+     * @internal
+     */
+    readonly _schema: true;
+}
+/**
+ * Result type for safe parsing operations
+ */
+export type SafeParseResult<T> = SafeParseSuccess<T> | SafeParseError;
+/**
+ * Successful parse result
+ */
+export interface SafeParseSuccess<T> {
+    readonly success: true;
+    readonly data: T;
+}
+/**
+ * Failed parse result with error details
+ */
+export interface SafeParseError {
+    readonly success: false;
+    readonly error: ValidationIssue[];
+}
+/**
+ * Individual validation issue
+ */
+export interface ValidationIssue {
+    /** Dot-notation path to the invalid field */
+    readonly path: readonly (string | number)[];
+    /** Human-readable error message */
+    readonly message: string;
+    /** Zod error code */
+    readonly code: string;
+}
+/**
+ * Infers the output type from a Schema or ZodType
+ *
+ * Works with both wrapped Schema instances and raw Zod schemas,
+ * enabling seamless type inference in procedure chains.
+ *
+ * @template T - Schema or ZodType to infer from
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({ id: z.string(), name: z.string() });
+ * type User = InferOutput<typeof UserSchema>;
+ * // User = { id: string; name: string }
+ * ```
+ */
+export type InferOutput<T> = T extends Schema<infer O, infer _I> ? O : T extends ZodType<infer O, ZodTypeDef, infer _I> ? O : never;
+/**
+ * Infers the input type from a Schema or ZodType
+ *
+ * For schemas with transforms, this returns the pre-transform type.
+ *
+ * @template T - Schema or ZodType to infer from
+ *
+ * @example
+ * ```typescript
+ * const DateSchema = z.string().transform((s) => new Date(s));
+ * type DateInput = InferInput<typeof DateSchema>;
+ * // DateInput = string (not Date)
+ * ```
+ */
+export type InferInput<T> = T extends Schema<infer _O, infer I> ? I : T extends ZodType<infer _O, ZodTypeDef, infer I> ? I : never;
+/**
+ * Type constraint for any Zod schema
+ *
+ * Used in generic constraints to accept any valid Zod schema.
+ */
+export type AnyZodSchema = ZodType<unknown, ZodTypeDef, unknown>;
+/**
+ * Type constraint for any Schema wrapper
+ */
+export type AnySchema = Schema<unknown, unknown>;
+/**
+ * Union type accepting both raw Zod schemas and wrapped Schema instances
+ */
+export type SchemaLike = AnyZodSchema | AnySchema;
+/**
+ * Type guard to check if a value is a Schema instance
+ */
+export declare function isSchema(value: unknown): value is AnySchema;
+/**
+ * Type guard to check if a value is a Zod schema
+ */
+export declare function isZodSchema(value: unknown): value is AnyZodSchema;
+/**
+ * Wraps a Zod schema in the framework's Schema interface
+ *
+ * This provides a consistent API and transforms Zod errors into
+ * a framework-friendly format.
+ *
+ * @template TOutput - The validated output type
+ * @template TInput - The raw input type
+ * @param zodSchema - The Zod schema to wrap
+ * @returns Wrapped Schema instance
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ * import { wrapSchema } from '@veloxts/validation';
+ *
+ * const UserSchema = wrapSchema(z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string().min(1),
+ * }));
+ * ```
+ */
+export declare function wrapSchema<TOutput, TInput = TOutput>(zodSchema: ZodType<TOutput, ZodTypeDef, TInput>): Schema<TOutput, TInput>;
+/**
+ * Represents no input (undefined) for procedures without input schemas
+ */
+export type NoInput = undefined;
+/**
+ * Represents unknown output for procedures without output schemas
+ */
+export type UnknownOutput = unknown;
+/**
+ * Utility type to resolve the effective input type
+ * Returns NoInput if undefined, otherwise the inferred type
+ */
+export type ResolveInput<T> = T extends undefined ? NoInput : InferOutput<T>;
+/**
+ * Utility type to resolve the effective output type
+ * Returns UnknownOutput if undefined, otherwise the inferred type
+ */
+export type ResolveOutput<T> = T extends undefined ? UnknownOutput : InferOutput<T>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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