@veloxts/validation 0.2.0 → 0.3.0

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

package/dist/types.js

@@ -0,0 +1,78 @@
+/**
+ * Core type definitions for @veloxts/validation
+ *
+ * Provides type-safe Zod integration with automatic type inference
+ * for procedure inputs/outputs.
+ *
+ * @module types
+ */
+/**
+ * Type guard to check if a value is a Schema instance
+ */
+export function isSchema(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '_schema' in value &&
+        value._schema === true);
+}
+/**
+ * Type guard to check if a value is a Zod schema
+ */
+export function isZodSchema(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'parse' in value &&
+        'safeParse' in value &&
+        '_def' in value);
+}
+// ============================================================================
+// Schema Wrapper Factory
+// ============================================================================
+/**
+ * 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 function wrapSchema(zodSchema) {
+    return {
+        _schema: true,
+        parse(input) {
+            return zodSchema.parse(input);
+        },
+        safeParse(input) {
+            const result = zodSchema.safeParse(input);
+            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,
+                })),
+            };
+        },
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2IH;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QACjB,KAA8B,CAAC,OAAO,KAAK,IAAI,CACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,WAAW,IAAI,KAAK;QACpB,MAAM,IAAI,KAAK,CAChB,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,UAAU,CACxB,SAA+C;IAE/C,OAAO;QACL,OAAO,EAAE,IAAa;QAEtB,KAAK,CAAC,KAAc;YAClB,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,SAAS,CAAC,KAAc;YACtB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAE1C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE,MAAM,CAAC,IAAI;iBAClB,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACzC,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/validation",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Zod integration and validation middleware for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,7 @@
   },
   "dependencies": {
     "zod": "3.24.4",
-    "@veloxts/core": "0.2.0"
+    "@veloxts/core": "0.3.0"
   },
   "devDependencies": {
     "typescript": "5.9.3",