@veloxts/validation 0.6.91 → 0.6.93

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @veloxts/validation
 
+## 0.6.93
+
+### Patch Changes
+
+- feat(router): add Resource API with phantom types for context-dependent outputs
+- Updated dependencies
+  - @veloxts/core@0.6.93
+
+## 0.6.92
+
+### Patch Changes
+
+- feat(storage): add provider factories, lifecycle hooks, and presigned uploads
+- Updated dependencies
+  - @veloxts/core@0.6.92
+
 ## 0.6.91
 
 ### Patch Changes

package/GUIDE.md

@@ -183,6 +183,42 @@ export const userProcedures = procedures('users', {
 });
 ```
 
+## Resource API with Zod Schemas
+
+For context-dependent outputs, use `resourceSchema()` with Zod field schemas:
+
+```typescript
+import { resourceSchema, resource } from '@veloxts/router';
+import { z } from '@veloxts/validation';
+
+// Define field visibility with Zod schemas
+const UserSchema = resourceSchema()
+  .public('id', z.string().uuid())
+  .public('name', z.string())
+  .authenticated('email', z.string().email())
+  .admin('internalNotes', z.string().nullable())
+  .build();
+
+// Returns different fields based on access level
+const publicUser = resource(user, UserSchema).forAnonymous();
+// Type: { id: string; name: string }
+
+const authUser = resource(user, UserSchema).forAuthenticated();
+// Type: { id: string; name: string; email: string }
+
+const adminUser = resource(user, UserSchema).forAdmin();
+// Type: { id: string; name: string; email: string; internalNotes: string | null }
+```
+
+### When to Use Each Approach
+
+| Scenario | Approach |
+|----------|----------|
+| Same output for all users | `.output(zodSchema)` |
+| Different fields per role | `resourceSchema()` + `resource()` |
+| Input validation | `.input(zodSchema)` |
+| Complex transforms | `.output()` with Zod transforms |
+
 ## Error Handling
 
 Validation errors include field-level details:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/validation",
-  "version": "0.6.91",
+  "version": "0.6.93",
   "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.91"
+    "@veloxts/core": "0.6.93"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.18",