@veloxts/validation 0.6.68 → 0.6.69

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @veloxts/validation
 
+## 0.6.69
+
+### Patch Changes
+
+- implement user feedback improvements across packages
+
+  ## Summary
+
+  Addresses 9 user feedback items to improve DX, reduce boilerplate, and eliminate template duplications.
+
+  ### Phase 1: Validation Helpers (`@veloxts/validation`)
+
+  - Add `prismaDecimal()`, `prismaDecimalNullable()`, `prismaDecimalOptional()` for Prisma Decimal → number conversion
+  - Add `dateToIso`, `dateToIsoNullable`, `dateToIsoOptional` aliases for consistency
+
+  ### Phase 2: Template Deduplication (`@veloxts/auth`)
+
+  - Export `createEnhancedTokenStore()` with token revocation and refresh token reuse detection
+  - Export `parseUserRoles()` and `DEFAULT_ALLOWED_ROLES`
+  - Fix memory leak: track pending timeouts for proper cleanup on `destroy()`
+  - Update templates to import from `@veloxts/auth` instead of duplicating code
+  - Fix jwtManager singleton pattern in templates
+
+  ### Phase 3: Router Helpers (`@veloxts/router`)
+
+  - Add `createRouter()` returning `{ collections, router }` for DRY setup
+  - Add `toRouter()` for router-only use cases
+  - Update all router templates to use `createRouter()`
+
+  ### Phase 4: Guard Type Narrowing - Experimental (`@veloxts/auth`, `@veloxts/router`)
+
+  - Add `NarrowingGuard` interface with phantom `_narrows` type
+  - Add `authenticatedNarrow` and `hasRoleNarrow()` guards
+  - Add `guardNarrow()` method to `ProcedureBuilder` for context narrowing
+  - Enables `ctx.user` to be non-null after guard passes
+
+  ### Phase 5: Documentation (`@veloxts/router`)
+
+  - Document `.rest()` override patterns
+  - Document `createRouter()` helper usage
+  - Document `guardNarrow()` experimental API
+  - Add schema browser-safety patterns for RSC apps
+
+- Updated dependencies
+  - @veloxts/core@0.6.69
+
 ## 0.6.68
 
 ### Patch Changes

package/dist/index.d.ts

@@ -34,4 +34,4 @@ export { baseEntitySchema, booleanStringSchema, createIdSchema, datetimeSchema,
 export type { CursorPaginatedResponse, CursorPaginationInput, CursorPaginationMeta, PaginatedResponse, PaginationInput, PaginationMeta, } from './schemas/pagination.js';
 export { calculateOffset, calculatePaginationMeta, createCursorPaginatedResponseSchema, createPaginatedResponse, createPaginatedResponseSchema, createPaginationSchema, cursorPaginationSchema, PAGINATION_DEFAULTS, paginationInputSchema, } from './schemas/pagination.js';
 export type { InferWithTimestamps, OmitTimestamps, SerializedDates, WithOptional, } from './schemas/serialization.js';
-export { dateToISOString, dateToISOStringNullable, dateToISOStringOptional, timestamps, timestampsWithSoftDelete, withTimestamps, } from './schemas/serialization.js';
+export { dateToISOString, dateToISOStringNullable, dateToISOStringOptional, dateToIso, dateToIsoNullable, dateToIsoOptional, prismaDecimal, prismaDecimalNullable, prismaDecimalOptional, timestamps, timestampsWithSoftDelete, withTimestamps, } from './schemas/serialization.js';

package/dist/index.js

@@ -35,4 +35,12 @@ export { isSchema, isZodSchema, wrapSchema } from './types.js';
 export { assertSchema, createTypeGuard, createValidator, formatZodErrors, parse, parseAll, safeParse, zodErrorToValidationError, } from './middleware.js';
 export { baseEntitySchema, booleanStringSchema, createIdSchema, datetimeSchema, emailSchema, idParamSchema, integerStringSchema, makePartial, nonEmptyStringSchema, numberStringSchema, omitFields, partialExcept, pickFields, timestampFieldsSchema, urlSchema, uuidSchema, } from './schemas/common.js';
 export { calculateOffset, calculatePaginationMeta, createCursorPaginatedResponseSchema, createPaginatedResponse, createPaginatedResponseSchema, createPaginationSchema, cursorPaginationSchema, PAGINATION_DEFAULTS, paginationInputSchema, } from './schemas/pagination.js';
-export { dateToISOString, dateToISOStringNullable, dateToISOStringOptional, timestamps, timestampsWithSoftDelete, withTimestamps, } from './schemas/serialization.js';
+export { 
+// Date serialization
+dateToISOString, dateToISOStringNullable, dateToISOStringOptional, 
+// Date aliases (shorter names)
+dateToIso, dateToIsoNullable, dateToIsoOptional, 
+// Prisma Decimal helpers
+prismaDecimal, prismaDecimalNullable, prismaDecimalOptional, 
+// Timestamp presets
+timestamps, timestampsWithSoftDelete, withTimestamps, } from './schemas/serialization.js';

package/dist/schemas/serialization.d.ts

@@ -35,6 +35,34 @@ export type WithOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>
  * Omits timestamp fields from a type (useful for create/update inputs)
  */
 export type OmitTimestamps<T> = Omit<T, 'createdAt' | 'updatedAt' | 'deletedAt'>;
+/**
+ * Creates a field that accepts Prisma Decimal and transforms to number
+ *
+ * Use in OUTPUT schemas where Prisma returns Decimal objects.
+ * Handles Prisma Decimal, regular numbers, and string representations.
+ *
+ * @example
+ * ```typescript
+ * const ProductSchema = z.object({
+ *   id: z.string(),
+ *   price: prismaDecimal(),          // Decimal -> number
+ *   discount: prismaDecimalNullable() // Decimal | null -> number | null
+ * });
+ * ```
+ */
+export declare function prismaDecimal(): z.ZodEffects<z.ZodAny, number, any>;
+/**
+ * Nullable version of prismaDecimal
+ *
+ * Returns null for null/undefined inputs, otherwise converts to number.
+ */
+export declare function prismaDecimalNullable(): z.ZodEffects<z.ZodAny, number | null, any>;
+/**
+ * Optional version of prismaDecimal
+ *
+ * Returns undefined for null/undefined inputs, otherwise converts to number.
+ */
+export declare function prismaDecimalOptional(): z.ZodEffects<z.ZodAny, number | undefined, any>;
 /**
  * Creates a date field that serializes to ISO string
  *
@@ -59,6 +87,21 @@ export declare function dateToISOStringNullable(): z.ZodEffects<z.ZodNullable<z.
  * Creates an optional date field that serializes to ISO string or undefined
  */
 export declare function dateToISOStringOptional(): z.ZodEffects<z.ZodOptional<z.ZodDate>, string | undefined, Date | undefined>;
+/**
+ * Alias for dateToISOString for naming consistency
+ * @alias dateToISOString
+ */
+export declare const dateToIso: typeof dateToISOString;
+/**
+ * Alias for dateToISOStringNullable for naming consistency
+ * @alias dateToISOStringNullable
+ */
+export declare const dateToIsoNullable: typeof dateToISOStringNullable;
+/**
+ * Alias for dateToISOStringOptional for naming consistency
+ * @alias dateToISOStringOptional
+ */
+export declare const dateToIsoOptional: typeof dateToISOStringOptional;
 /**
  * Standard timestamp fields for entities
  *

package/dist/schemas/serialization.js

@@ -8,6 +8,100 @@
  */
 import { z } from 'zod';
 // ============================================================================
+// Prisma Decimal Helpers
+// ============================================================================
+/**
+ * Creates a field that accepts Prisma Decimal and transforms to number
+ *
+ * Use in OUTPUT schemas where Prisma returns Decimal objects.
+ * Handles Prisma Decimal, regular numbers, and string representations.
+ *
+ * @example
+ * ```typescript
+ * const ProductSchema = z.object({
+ *   id: z.string(),
+ *   price: prismaDecimal(),          // Decimal -> number
+ *   discount: prismaDecimalNullable() // Decimal | null -> number | null
+ * });
+ * ```
+ */
+export function prismaDecimal() {
+    return z.any().transform((val) => {
+        if (val === null || val === undefined) {
+            throw new Error('Expected Decimal, got null/undefined');
+        }
+        // Prisma Decimal has toNumber() method
+        if (typeof val === 'object' && 'toNumber' in val && typeof val.toNumber === 'function') {
+            return val.toNumber();
+        }
+        // Already a number
+        if (typeof val === 'number') {
+            return val;
+        }
+        // String (from JSON)
+        if (typeof val === 'string') {
+            const num = Number.parseFloat(val);
+            if (Number.isNaN(num)) {
+                throw new Error(`Cannot convert "${val}" to number`);
+            }
+            return num;
+        }
+        throw new Error(`Cannot convert ${typeof val} to number`);
+    });
+}
+/**
+ * Nullable version of prismaDecimal
+ *
+ * Returns null for null/undefined inputs, otherwise converts to number.
+ */
+export function prismaDecimalNullable() {
+    return z.any().transform((val) => {
+        if (val === null || val === undefined) {
+            return null;
+        }
+        if (typeof val === 'object' && 'toNumber' in val && typeof val.toNumber === 'function') {
+            return val.toNumber();
+        }
+        if (typeof val === 'number') {
+            return val;
+        }
+        if (typeof val === 'string') {
+            const num = Number.parseFloat(val);
+            if (Number.isNaN(num)) {
+                throw new Error(`Cannot convert "${val}" to number`);
+            }
+            return num;
+        }
+        throw new Error(`Cannot convert ${typeof val} to number`);
+    });
+}
+/**
+ * Optional version of prismaDecimal
+ *
+ * Returns undefined for null/undefined inputs, otherwise converts to number.
+ */
+export function prismaDecimalOptional() {
+    return z.any().transform((val) => {
+        if (val === null || val === undefined) {
+            return undefined;
+        }
+        if (typeof val === 'object' && 'toNumber' in val && typeof val.toNumber === 'function') {
+            return val.toNumber();
+        }
+        if (typeof val === 'number') {
+            return val;
+        }
+        if (typeof val === 'string') {
+            const num = Number.parseFloat(val);
+            if (Number.isNaN(num)) {
+                throw new Error(`Cannot convert "${val}" to number`);
+            }
+            return num;
+        }
+        throw new Error(`Cannot convert ${typeof val} to number`);
+    });
+}
+// ============================================================================
 // Date Field Helpers
 // ============================================================================
 /**
@@ -46,6 +140,21 @@ export function dateToISOStringOptional() {
         .optional()
         .transform((date) => (date ? date.toISOString() : undefined));
 }
+/**
+ * Alias for dateToISOString for naming consistency
+ * @alias dateToISOString
+ */
+export const dateToIso = dateToISOString;
+/**
+ * Alias for dateToISOStringNullable for naming consistency
+ * @alias dateToISOStringNullable
+ */
+export const dateToIsoNullable = dateToISOStringNullable;
+/**
+ * Alias for dateToISOStringOptional for naming consistency
+ * @alias dateToISOStringOptional
+ */
+export const dateToIsoOptional = dateToISOStringOptional;
 // ============================================================================
 // Timestamp Schema Presets
 // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/validation",
-  "version": "0.6.68",
+  "version": "0.6.69",
   "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.68"
+    "@veloxts/core": "0.6.69"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.16",