@veloxts/validation 0.4.6 → 0.4.9

package/dist/index.d.ts

@@ -33,4 +33,6 @@ export type { BaseEntity, IdParam, TimestampFields } from './schemas/common.js';
 export { baseEntitySchema, booleanStringSchema, createIdSchema, datetimeSchema, emailSchema, idParamSchema, integerStringSchema, makePartial, nonEmptyStringSchema, numberStringSchema, omitFields, partialExcept, pickFields, timestampFieldsSchema, urlSchema, uuidSchema, } from './schemas/common.js';
 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';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMjE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,EAAE,MAA+C,CAAC;AAMjF,YAAY,EAEV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,OAAO,EACP,YAAY,EACZ,aAAa,EAEb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU/D,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,KAAK,EACL,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAMzB,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,UAAU,GACX,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,mCAAmC,EACnC,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMjE,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,EAAE,MAA+C,CAAC;AAMjF,YAAY,EAEV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,EACX,OAAO,EACP,YAAY,EACZ,aAAa,EAEb,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,UAAU,EACV,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU/D,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,KAAK,EACL,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAMzB,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,UAAU,GACX,MAAM,qBAAqB,CAAC;AAM7B,YAAY,EACV,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,mCAAmC,EACnC,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAMjC,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,EACV,wBAAwB,EACxB,cAAc,GACf,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -37,4 +37,5 @@ export { isSchema, isZodSchema, wrapSchema } from './types.js';
 export { assertSchema, createTypeGuard, createValidator, formatZodErrors, parse, parseAll, safeParse, safeValidate, validate, validateAll, 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';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,gCAAgC;AAChC,yFAAyF;AACzF,OAAO,EAAE,QAAQ,EAAiC,CAAC,EAAE,MAAM,KAAK,CAAC;AAEjE,6CAA6C;AAC7C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,iCAAiC;AACjC,MAAM,CAAC,MAAM,kBAAkB,GAAW,WAAW,CAAC,OAAO,IAAI,eAAe,CAAC;AAwBjF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAW/D,wDAAwD;AACxD,iDAAiD;AACjD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,KAAK,EACL,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,UAAU,GACX,MAAM,qBAAqB,CAAC;AAc7B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,mCAAmC,EACnC,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,gCAAgC;AAChC,yFAAyF;AACzF,OAAO,EAAE,QAAQ,EAAiC,CAAC,EAAE,MAAM,KAAK,CAAC;AAEjE,6CAA6C;AAC7C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,iCAAiC;AACjC,MAAM,CAAC,MAAM,kBAAkB,GAAW,WAAW,CAAC,OAAO,IAAI,eAAe,CAAC;AAwBjF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAW/D,wDAAwD;AACxD,iDAAiD;AACjD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,KAAK,EACL,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,UAAU,GACX,MAAM,qBAAqB,CAAC;AAc7B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,mCAAmC,EACnC,uBAAuB,EACvB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAYjC,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,EACV,wBAAwB,EACxB,cAAc,GACf,MAAM,4BAA4B,CAAC"}

package/dist/schemas/serialization.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Serialization Utilities for API Responses
+ *
+ * Provides type-safe Date → string transformation that works with
+ * Zod's output validation in the procedure system.
+ *
+ * @module schemas/serialization
+ */
+import { type ZodObject, type ZodRawShape, z } from 'zod';
+/**
+ * Recursively transforms Date properties to string in a type
+ *
+ * This utility type mirrors the runtime transformation that happens
+ * when dates pass through Zod transforms.
+ *
+ * @example
+ * ```typescript
+ * import type { Prisma } from '@prisma/client';
+ *
+ * type DbUser = Prisma.UserGetPayload<{}>;
+ * // { id: string; name: string; createdAt: Date; updatedAt: Date }
+ *
+ * type ApiUser = SerializedDates<DbUser>;
+ * // { id: string; name: string; createdAt: string; updatedAt: string }
+ * ```
+ */
+export type SerializedDates<T> = T extends Date ? string : T extends Array<infer U> ? Array<SerializedDates<U>> : T extends object ? {
+    [K in keyof T]: SerializedDates<T[K]>;
+} : T;
+/**
+ * Makes specified keys optional (useful for create inputs)
+ */
+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 date field that serializes to ISO string
+ *
+ * Use in output schemas. Accepts Date objects from Prisma
+ * and transforms them to ISO strings for JSON responses.
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({
+ *   id: z.string().uuid(),
+ *   createdAt: dateToISOString(),
+ *   updatedAt: dateToISOString(),
+ * });
+ * ```
+ */
+export declare function dateToISOString(): z.ZodEffects<z.ZodDate, string, Date>;
+/**
+ * Creates a nullable date field that serializes to ISO string or null
+ */
+export declare function dateToISOStringNullable(): z.ZodEffects<z.ZodNullable<z.ZodDate>, string | null, Date | null>;
+/**
+ * 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>;
+/**
+ * Standard timestamp fields for entities
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string(),
+ * }).merge(timestamps);
+ * ```
+ */
+export declare const timestamps: ZodObject<{
+    createdAt: z.ZodEffects<z.ZodDate, string, Date>;
+    updatedAt: z.ZodEffects<z.ZodDate, string, Date>;
+}, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    updatedAt: string;
+}, {
+    createdAt: Date;
+    updatedAt: Date;
+}>;
+/**
+ * Timestamp fields with soft delete support
+ */
+export declare const timestampsWithSoftDelete: ZodObject<{
+    createdAt: z.ZodEffects<z.ZodDate, string, Date>;
+    updatedAt: z.ZodEffects<z.ZodDate, string, Date>;
+    deletedAt: z.ZodEffects<z.ZodNullable<z.ZodDate>, string | null, Date | null>;
+}, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    updatedAt: string;
+    deletedAt: string | null;
+}, {
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt: Date | null;
+}>;
+/**
+ * Configuration for withTimestamps
+ */
+interface TimestampConfig {
+    /** Include createdAt (default: true) */
+    createdAt?: boolean;
+    /** Include updatedAt (default: true) */
+    updatedAt?: boolean;
+    /** Include deletedAt for soft deletes (default: false) */
+    deletedAt?: boolean;
+}
+/**
+ * Extends a Zod object schema with timestamp fields
+ *
+ * This is the primary way to add serialized timestamps to entity schemas.
+ * Timestamps are automatically transformed from Date to ISO string.
+ *
+ * @example
+ * ```typescript
+ * // Define business fields
+ * const UserFields = z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string(),
+ *   email: z.string().email(),
+ * });
+ *
+ * // Add timestamps (createdAt, updatedAt as strings)
+ * export const UserSchema = withTimestamps(UserFields);
+ *
+ * // With soft delete
+ * export const UserSchema = withTimestamps(UserFields, { deletedAt: true });
+ *
+ * // Without updatedAt
+ * export const UserSchema = withTimestamps(UserFields, { updatedAt: false });
+ * ```
+ */
+export declare function withTimestamps<T extends ZodRawShape>(schema: ZodObject<T>, config?: TimestampConfig): ZodObject<T & typeof timestampShape>;
+declare const timestampShape: {
+    createdAt: z.ZodEffects<z.ZodDate, string, Date>;
+    updatedAt: z.ZodEffects<z.ZodDate, string, Date>;
+};
+/**
+ * Type helper to infer the output type of a schema with timestamps
+ */
+export type InferWithTimestamps<T extends ZodObject<ZodRawShape>> = z.infer<ReturnType<typeof withTimestamps<T['shape']>>>;
+export {};
+//# sourceMappingURL=serialization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/schemas/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM1D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GAC3C,MAAM,GACN,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACtB,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GACzB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACzC,CAAC,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAMjF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,0CAE9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,uEAKtC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,iFAKtC;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;;;;;;;;;EAGrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAMH;;GAEG;AACH,UAAU,eAAe;IACvB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,EAClD,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,eAAoB,GAC3B,SAAS,CAAC,CAAC,GAAG,OAAO,cAAc,CAAC,CAgBtC;AAGD,QAAA,MAAM,cAAc;;;CAGnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CACzE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAC9C,CAAC"}

package/dist/schemas/serialization.js

@@ -0,0 +1,119 @@
+/**
+ * Serialization Utilities for API Responses
+ *
+ * Provides type-safe Date → string transformation that works with
+ * Zod's output validation in the procedure system.
+ *
+ * @module schemas/serialization
+ */
+import { z } from 'zod';
+// ============================================================================
+// Date Field Helpers
+// ============================================================================
+/**
+ * Creates a date field that serializes to ISO string
+ *
+ * Use in output schemas. Accepts Date objects from Prisma
+ * and transforms them to ISO strings for JSON responses.
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({
+ *   id: z.string().uuid(),
+ *   createdAt: dateToISOString(),
+ *   updatedAt: dateToISOString(),
+ * });
+ * ```
+ */
+export function dateToISOString() {
+    return z.coerce.date().transform((date) => date.toISOString());
+}
+/**
+ * Creates a nullable date field that serializes to ISO string or null
+ */
+export function dateToISOStringNullable() {
+    return z.coerce
+        .date()
+        .nullable()
+        .transform((date) => (date ? date.toISOString() : null));
+}
+/**
+ * Creates an optional date field that serializes to ISO string or undefined
+ */
+export function dateToISOStringOptional() {
+    return z.coerce
+        .date()
+        .optional()
+        .transform((date) => (date ? date.toISOString() : undefined));
+}
+// ============================================================================
+// Timestamp Schema Presets
+// ============================================================================
+/**
+ * Standard timestamp fields for entities
+ *
+ * @example
+ * ```typescript
+ * const UserSchema = z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string(),
+ * }).merge(timestamps);
+ * ```
+ */
+export const timestamps = z.object({
+    createdAt: dateToISOString(),
+    updatedAt: dateToISOString(),
+});
+/**
+ * Timestamp fields with soft delete support
+ */
+export const timestampsWithSoftDelete = z.object({
+    createdAt: dateToISOString(),
+    updatedAt: dateToISOString(),
+    deletedAt: dateToISOStringNullable(),
+});
+/**
+ * Extends a Zod object schema with timestamp fields
+ *
+ * This is the primary way to add serialized timestamps to entity schemas.
+ * Timestamps are automatically transformed from Date to ISO string.
+ *
+ * @example
+ * ```typescript
+ * // Define business fields
+ * const UserFields = z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string(),
+ *   email: z.string().email(),
+ * });
+ *
+ * // Add timestamps (createdAt, updatedAt as strings)
+ * export const UserSchema = withTimestamps(UserFields);
+ *
+ * // With soft delete
+ * export const UserSchema = withTimestamps(UserFields, { deletedAt: true });
+ *
+ * // Without updatedAt
+ * export const UserSchema = withTimestamps(UserFields, { updatedAt: false });
+ * ```
+ */
+export function withTimestamps(schema, config = {}) {
+    const { createdAt = true, updatedAt = true, deletedAt = false } = config;
+    const extensions = {};
+    if (createdAt) {
+        extensions.createdAt = dateToISOString();
+    }
+    if (updatedAt) {
+        extensions.updatedAt = dateToISOString();
+    }
+    if (deletedAt) {
+        extensions.deletedAt = dateToISOStringNullable();
+    }
+    return schema.extend(extensions);
+}
+// Type helper for withTimestamps return type inference
+const timestampShape = {
+    createdAt: dateToISOString(),
+    updatedAt: dateToISOString(),
+};
+//# sourceMappingURL=serialization.js.map

package/dist/schemas/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/schemas/serialization.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAoC,CAAC,EAAE,MAAM,KAAK,CAAC;AAyC1D,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,CAAC,MAAM;SACZ,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,CAAC,MAAM;SACZ,IAAI,EAAE;SACN,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,SAAS,EAAE,eAAe,EAAE;IAC5B,SAAS,EAAE,eAAe,EAAE;CAC7B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,eAAe,EAAE;IAC5B,SAAS,EAAE,eAAe,EAAE;IAC5B,SAAS,EAAE,uBAAuB,EAAE;CACrC,CAAC,CAAC;AAkBH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAoB,EACpB,SAA0B,EAAE;IAE5B,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;IAEzE,MAAM,UAAU,GAAgB,EAAE,CAAC;IAEnC,IAAI,SAAS,EAAE,CAAC;QACd,UAAU,CAAC,SAAS,GAAG,eAAe,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,UAAU,CAAC,SAAS,GAAG,eAAe,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,UAAU,CAAC,SAAS,GAAG,uBAAuB,EAAE,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAyC,CAAC;AAC3E,CAAC;AAED,uDAAuD;AACvD,MAAM,cAAc,GAAG;IACrB,SAAS,EAAE,eAAe,EAAE;IAC5B,SAAS,EAAE,eAAe,EAAE;CAC7B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veloxts/validation",
-  "version": "0.4.6",
+  "version": "0.4.9",
   "description": "Zod integration and validation middleware for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "zod": "3.24.4",
-    "@veloxts/core": "0.4.6"
+    "@veloxts/core": "0.4.9"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.15",