@veloxts/validation 0.6.25 → 0.6.27

package/CHANGELOG.md

@@ -0,0 +1,499 @@
+# @veloxts/validation
+
+## 0.6.27
+
+### Patch Changes
+
+- chore: add GUIDE, LICENSE and CHANGELOG.md to npm files
+- Updated dependencies
+  - @veloxts/core@0.6.27
+
+## 0.6.26
+
+### Patch Changes
+
+- docs(mcp): add README and GUIDE, docs(web): simplify README and create concise GUIDE
+- Updated dependencies
+  - @veloxts/core@0.6.26
+
+## 0.6.25
+
+### Patch Changes
+
+- docs(create): add guide for React Server Components setup
+- Updated dependencies
+  - @veloxts/core@0.6.25
+
+## 0.6.24
+
+### Patch Changes
+
+- clarify installation paths and package contents
+- Updated dependencies
+  - @veloxts/core@0.6.24
+
+## 0.6.23
+
+### Patch Changes
+
+- add defineContract for improved type inference DX
+- Updated dependencies
+  - @veloxts/core@0.6.23
+
+## 0.6.22
+
+### Patch Changes
+
+- support {method, path} route entry format
+- Updated dependencies
+  - @veloxts/core@0.6.22
+
+## 0.6.21
+
+### Patch Changes
+
+- separate schemas from procedures for browser-safe import
+- Updated dependencies
+  - @veloxts/core@0.6.21
+
+## 0.6.20
+
+### Patch Changes
+
+- add Fastify ecosystem stubs and debuglog to util
+- Updated dependencies
+  - @veloxts/core@0.6.20
+
+## 0.6.19
+
+### Patch Changes
+
+- restore dotenv stub for browser compatibility
+- Updated dependencies
+  - @veloxts/core@0.6.19
+
+## 0.6.18
+
+### Patch Changes
+
+- add node:fs/promises stub and fix esbuild plugin
+- Updated dependencies
+  - @veloxts/core@0.6.18
+
+## 0.6.17
+
+### Patch Changes
+
+- remove optimizeDeps.exclude to fix CJS/ESM interop
+- Updated dependencies
+  - @veloxts/core@0.6.17
+
+## 0.6.16
+
+### Patch Changes
+
+- add stubs for Fastify ecosystem packages
+- Updated dependencies
+  - @veloxts/core@0.6.16
+
+## 0.6.15
+
+### Patch Changes
+
+- implement three-layer Node.js stubbing for Vite
+- Updated dependencies
+  - @veloxts/core@0.6.15
+
+## 0.6.14
+
+### Patch Changes
+
+- stub dotenv as virtual module instead of process shims
+- Updated dependencies
+  - @veloxts/core@0.6.14
+
+## 0.6.13
+
+### Patch Changes
+
+- add process.argv stub for dotenv browser compatibility
+- Updated dependencies
+  - @veloxts/core@0.6.13
+
+## 0.6.12
+
+### Patch Changes
+
+- Fixes the "process is not defined" error from dotenv
+- Updated dependencies
+  - @veloxts/core@0.6.12
+
+## 0.6.11
+
+### Patch Changes
+
+- add Vite plugin for Node.js module stubs
+- Updated dependencies
+  - @veloxts/core@0.6.11
+
+## 0.6.10
+
+### Patch Changes
+
+- use import() type syntax for AppRouter
+- Updated dependencies
+  - @veloxts/core@0.6.10
+
+## 0.6.9
+
+### Patch Changes
+
+- isolate auth procedures from database imports
+- Updated dependencies
+  - @veloxts/core@0.6.9
+
+## 0.6.8
+
+### Patch Changes
+
+- prevent dotenv from leaking into browser bundle
+- Updated dependencies
+  - @veloxts/core@0.6.8
+
+## 0.6.7
+
+### Patch Changes
+
+- better-sqlite3 versions mismatch fix
+- Updated dependencies
+  - @veloxts/core@0.6.7
+
+## 0.6.6
+
+### Patch Changes
+
+- ensure the web app never imports server-side code paths
+- Updated dependencies
+  - @veloxts/core@0.6.6
+
+## 0.6.5
+
+### Patch Changes
+
+- move @prisma/client-runtime-utils to root package.json
+- Updated dependencies
+  - @veloxts/core@0.6.5
+
+## 0.6.4
+
+### Patch Changes
+
+- add @prisma/client-runtime-utils dependency
+- Updated dependencies
+  - @veloxts/core@0.6.4
+
+## 0.6.3
+
+### Patch Changes
+
+- Add workspaces field to root package.json template + Fix Prisma ESM/CJS import for Node.js v24
+- Updated dependencies
+  - @veloxts/core@0.6.3
+
+## 0.6.2
+
+### Patch Changes
+
+- add server actions, removed some deprecated and other chore
+- Updated dependencies
+  - @veloxts/core@0.6.2
+
+## 0.6.1
+
+### Patch Changes
+
+- route groups for file-based routing; add dynamic route support with [param] segments
+- Updated dependencies
+  - @veloxts/core@0.6.1
+
+## 0.6.0
+
+### Minor Changes
+
+- RSC streaming, dynamic routes, Vinxi integration
+
+### Patch Changes
+
+- Updated dependencies
+  - @veloxts/core@0.6.0
+
+## 0.5.0
+
+### Minor Changes
+
+- Auto-register procedures + inject Prisma models feature
+
+### Patch Changes
+
+- Updated dependencies
+  - @veloxts/core@0.5.0
+
+## 0.4.21
+
+### Patch Changes
+
+- format Prisma default values correctly by type
+- Updated dependencies
+  - @veloxts/core@0.4.21
+
+## 0.4.20
+
+### Patch Changes
+
+- import consolidation: update import paths for `@veloxts/velox`
+- Updated dependencies
+  - @veloxts/core@0.4.20
+
+## 0.4.19
+
+### Patch Changes
+
+- update default dev server port to 3030
+- Updated dependencies
+  - @veloxts/core@0.4.19
+
+## 0.4.18
+
+### Patch Changes
+
+- introduce interactive field menu and templates for resource generation
+- Updated dependencies
+  - @veloxts/core@0.4.18
+
+## 0.4.17
+
+### Patch Changes
+
+- add interactive field prompts for resource generation
+- Updated dependencies
+  - @veloxts/core@0.4.17
+
+## 0.4.16
+
+### Patch Changes
+
+- fixed velox procedures list
+- Updated dependencies
+  - @veloxts/core@0.4.16
+
+## 0.4.15
+
+### Patch Changes
+
+- chore lint fixes
+- Updated dependencies
+  - @veloxts/core@0.4.15
+
+## 0.4.14
+
+### Patch Changes
+
+- fixed proxy-type inferance and update proxy hooks for optional input handling
+- Updated dependencies
+  - @veloxts/core@0.4.14
+
+## 0.4.13
+
+### Patch Changes
+
+- add debug mode to dev server
+- Updated dependencies
+  - @veloxts/core@0.4.13
+
+## 0.4.12
+
+### Patch Changes
+
+- preserve type info in trpc template AppRouter export
+- Updated dependencies
+  - @veloxts/core@0.4.12
+
+## 0.4.11
+
+### Patch Changes
+
+- fixed api.health.check.useQuery is not a function issue
+- Updated dependencies
+  - @veloxts/core@0.4.11
+
+## 0.4.10
+
+### Patch Changes
+
+- fixed ReferenceError: styles is not defined in rpc template
+- Updated dependencies
+  - @veloxts/core@0.4.10
+
+## 0.4.7
+
+### Patch Changes
+
+- Add dynamic headers and routes config to client
+- Updated dependencies
+  - @veloxts/core@0.4.7
+
+## 0.4.6
+
+### Patch Changes
+
+- Fix broken npm packages - republish with correct dependencies
+- Updated dependencies
+  - @veloxts/core@0.4.6
+
+## 0.4.5
+
+### Patch Changes
+
+- b06631b: CI CD npm Trusted Publishing setup
+- Updated dependencies [b06631b]
+  - @veloxts/core@0.4.5
+
+## 0.4.4
+
+### Patch Changes
+
+- 05ae1a5: Update to boilerplate, work in progress
+- 9961b52: full-stack React frontend implementation
+- Updated dependencies [05ae1a5]
+- Updated dependencies [9961b52]
+  - @veloxts/core@0.4.4
+
+## 0.4.3
+
+### Patch Changes
+
+- ef8d5d0: Dynamically load VeloxTS version from `package.json` in shared template configuration
+- Updated dependencies [ef8d5d0]
+  - @veloxts/core@0.4.3
+
+## 0.4.2
+
+### Patch Changes
+
+- 5b4f02c: Updated documentations
+- 0d8d775: Updated guides and readme files
+- Updated dependencies [5b4f02c]
+- Updated dependencies [0d8d775]
+  - @veloxts/core@0.4.2
+
+## 0.4.1
+
+### Patch Changes
+
+- 0eea918: Completed CLI generators
+- Updated dependencies [0eea918]
+  - @veloxts/core@0.4.1
+
+## 0.4.0
+
+### Minor Changes
+
+- b478fee: Performance Benchmarks | 34k req/s, <1ms p50 latency, 75MB memory, 530ms startup
+
+### Patch Changes
+
+- Updated dependencies [b478fee]
+  - @veloxts/core@0.4.0
+
+## 0.3.6
+
+### Patch Changes
+
+- 929f2ab: Interactive CLI setup
+- Updated dependencies [929f2ab]
+  - @veloxts/core@0.3.6
+
+## 0.3.5
+
+### Patch Changes
+
+- 658e83f: @veloxts/auth, Full REST Support, Better error messages, Type tests with tsd
+- Updated dependencies [658e83f]
+  - @veloxts/core@0.3.5
+
+## 0.3.4
+
+### Patch Changes
+
+- 65ef3e7: DI container and Auth Guards
+- Updated dependencies [65ef3e7]
+  - @veloxts/core@0.3.4
+
+## 0.3.3
+
+### Patch Changes
+
+- 4ee103b: Full REST support PUT, PATCH and DELETE
+- Updated dependencies [4ee103b]
+  - @veloxts/core@0.3.3
+
+## 0.3.2
+
+### Patch Changes
+
+- abf270e: Dynamically set core `VELOX_VERSION` from package.json
+- Updated dependencies [abf270e]
+  - @veloxts/core@0.3.2
+
+## 0.3.1
+
+### Patch Changes
+
+- cb9806e: Fixed the value for VELOXTS_VERSION in create app template
+- Updated dependencies [cb9806e]
+  - @veloxts/core@0.3.1
+
+## 0.3.0
+
+### Minor Changes
+
+- 1adce10: Introduced an umbrella package for server side packages: @veloxts/velox
+
+### Patch Changes
+
+- Updated dependencies [1adce10]
+  - @veloxts/core@0.3.0
+
+## 0.2.2
+
+### Patch Changes
+
+- Version bump to sync with create-velox-app native module fix
+- Updated dependencies
+  - @veloxts/core@0.2.2
+
+## 0.2.0
+
+### Minor Changes
+
+- 9404976: fix Prisma client generation. README adjustments
+
+### Patch Changes
+
+- Updated dependencies [9404976]
+  - @veloxts/core@0.2.0
+
+## 0.1.1
+
+### Patch Changes
+
+- Fix Prisma client generation in scaffolder
+
+  - Added automatic Prisma client generation after dependency installation in create-velox-app
+  - Fixed database template to validate DATABASE_URL environment variable
+  - Added alpha release warning to all package READMEs
+  - Fixed TypeScript type for registerTRPCPlugin to accept FastifyInstance
+  - Updated playground app to use Prisma 7.x custom output path
+
+- Updated dependencies
+  - @veloxts/core@0.1.1

package/GUIDE.md

@@ -0,0 +1,216 @@
+# @veloxts/validation
+
+Type-safe validation using Zod schemas for VeloxTS Framework.
+
+## Installation
+
+```bash
+npm install @veloxts/validation
+```
+
+## Quick Start
+
+```typescript
+import { z, parse } from '@veloxts/validation';
+
+const UserSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string().min(1),
+  email: z.string().email(),
+});
+
+const user = parse(UserSchema, untrustedData);
+// user is validated and typed
+```
+
+## Validation Functions
+
+### parse()
+
+Parse and validate data, throwing `ValidationError` if invalid:
+
+```typescript
+import { parse, ValidationError } from '@veloxts/validation';
+
+try {
+  const user = parse(UserSchema, data);
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.log(error.fields); // Field-specific errors
+  }
+}
+```
+
+### safeParse()
+
+Validate without throwing, returns result object:
+
+```typescript
+import { safeParse } from '@veloxts/validation';
+
+const result = safeParse(UserSchema, data);
+
+if (result.success) {
+  console.log(result.data);
+} else {
+  console.log(result.error.issues);
+}
+```
+
+## Common Schemas
+
+Pre-built schemas for common use cases:
+
+```typescript
+import {
+  uuidSchema,
+  emailSchema,
+  urlSchema,
+  nonEmptyStringSchema,
+  datetimeSchema,
+  idParamSchema,
+} from '@veloxts/validation';
+
+const id = parse(uuidSchema, '123e4567-...');
+const email = parse(emailSchema, 'user@example.com');
+const url = parse(urlSchema, 'https://example.com');
+const name = parse(nonEmptyStringSchema, '  Alice  '); // "Alice"
+```
+
+## Pagination
+
+Built-in pagination support:
+
+```typescript
+import {
+  paginationInputSchema,
+  createPaginatedResponseSchema,
+  calculatePaginationMeta,
+} from '@veloxts/validation';
+
+const input = parse(paginationInputSchema, {
+  page: 1,
+  limit: 20, // Default: 10, max: 100
+});
+
+const UserListSchema = createPaginatedResponseSchema(UserSchema);
+
+const meta = calculatePaginationMeta({
+  page: 1,
+  limit: 10,
+  total: 95,
+});
+// { page: 1, limit: 10, total: 95, totalPages: 10, hasNext: true, hasPrev: false }
+```
+
+## Schema Utilities
+
+Manipulate schemas:
+
+```typescript
+import { pickFields, omitFields, makePartial, partialExcept } from '@veloxts/validation';
+
+const UserSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string(),
+  email: z.string().email(),
+  password: z.string(),
+});
+
+const PublicUserSchema = pickFields(UserSchema, ['id', 'name', 'email']);
+const SafeUserSchema = omitFields(UserSchema, ['password']);
+const PartialUserSchema = makePartial(UserSchema);
+const UpdateSchema = partialExcept(UserSchema, ['id']);
+```
+
+## String Coercion
+
+Parse string inputs to other types:
+
+```typescript
+import {
+  numberStringSchema,
+  integerStringSchema,
+  booleanStringSchema,
+} from '@veloxts/validation';
+
+const age = parse(numberStringSchema, '25'); // 25 (number)
+const count = parse(integerStringSchema, '42'); // 42 (number)
+const enabled = parse(booleanStringSchema, 'true'); // true (boolean)
+```
+
+## Type Inference
+
+Extract TypeScript types from schemas:
+
+```typescript
+import { InferInput, InferOutput } from '@veloxts/validation';
+
+const UserSchema = z.object({
+  email: z.string().email(),
+  age: z.number().transform((n) => n + 1),
+});
+
+type UserInput = InferInput<typeof UserSchema>;
+// { email: string; age: number }
+
+type UserOutput = InferOutput<typeof UserSchema>;
+// { email: string; age: number } (after transform)
+```
+
+## Using with Procedures
+
+Validation integrates seamlessly with VeloxTS procedures:
+
+```typescript
+import { procedure, defineProcedures } from '@veloxts/router';
+import { z, emailSchema, nonEmptyStringSchema } from '@veloxts/validation';
+
+const CreateUserInput = z.object({
+  name: nonEmptyStringSchema,
+  email: emailSchema,
+  age: z.number().int().min(18).optional(),
+});
+
+export const userProcedures = defineProcedures('users', {
+  createUser: procedure()
+    .input(CreateUserInput)
+    .output(UserSchema)
+    .mutation(async ({ input, ctx }) => {
+      // input is validated and typed
+      return ctx.db.user.create({ data: input });
+    }),
+});
+```
+
+## Error Handling
+
+Validation errors include field-level details:
+
+```typescript
+import { ValidationError, parse } from '@veloxts/validation';
+
+try {
+  parse(UserSchema, invalidData);
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.log(error.statusCode); // 400
+    console.log(error.fields);
+    // {
+    //   name: "String must contain at least 2 character(s)",
+    //   email: "Invalid email"
+    // }
+  }
+}
+```
+
+## Learn More
+
+- [@veloxts/core](https://www.npmjs.com/package/@veloxts/core) - Error classes
+- [@veloxts/router](https://www.npmjs.com/package/@veloxts/router) - Procedure definitions
+- [@veloxts/client](https://www.npmjs.com/package/@veloxts/client) - Type-safe client
+- [VeloxTS Framework](https://www.npmjs.com/package/@veloxts/velox) - Complete framework
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/validation",
-  "version": "0.6.25",
+  "version": "0.6.27",
   "description": "Zod integration and validation middleware for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "zod": "3.25.76",
-    "@veloxts/core": "0.6.25"
+    "@veloxts/core": "0.6.27"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.16",
@@ -40,7 +40,10 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "GUIDE.md",
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "keywords": [
     "velox",