@lyxa.ai/core 1.0.8 → 1.0.10

package/dist/utilities/validation/global-validation.d.ts

@@ -1,17 +1,25 @@
-import { z } from 'zod';
-import { mongoose } from '@typegoose/typegoose';
+import { z } from "zod";
+import { mongoose } from "@typegoose/typegoose";
 export declare class ZodValidation {
-    static objectId(field?: string): z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+    static objectId(field?: string): z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     static enumType<T extends z.EnumLike>(enumObj: T, field?: string): z.ZodNativeEnum<T>;
-    static number(field?: string, minLength?: number): z.ZodNumber;
-    static string(field?: string, minLength?: number): z.ZodString;
+    static number(field?: string, min?: number, max?: number, options?: {
+        isInt?: boolean;
+        isPositive?: boolean;
+        isNonpositive?: boolean;
+        isNegative?: boolean;
+        isNonnegative?: boolean;
+    }): z.ZodNumber;
+    static string(field?: string, minLength?: number, maxLength?: number, regex?: {
+        pattern: RegExp;
+        message: string;
+    }): z.ZodString;
     static email(field?: string): z.ZodString;
     static url(field?: string): z.ZodString;
     static phoneNumber(field?: string): z.ZodString;
-    static dateString(field?: string): z.ZodEffects<z.ZodString, string, string>;
-    static date(field?: string): z.ZodDate;
+    static date(field?: string, minDate?: Date, maxDate?: Date): z.ZodEffects<z.ZodEffects<z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, Date, string>, z.ZodDate]>, Date, string | Date>, Date, string | Date>;
     static boolean(field?: string): z.ZodBoolean;
-    static array<T extends z.ZodTypeAny>(schema: T, field?: string, minItems?: number): z.ZodArray<T, "many">;
+    static array<T extends z.ZodTypeAny>(schema: T, field?: string, minItems?: number, maxItems?: number): z.ZodArray<T, "many">;
     static timestamps(): {
         createdAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
         updatedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
@@ -21,9 +29,9 @@ export declare class ZodValidation {
         createdAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
         updatedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
         deletedAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
-        createdBy: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>>;
-        updatedBy: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>>;
-        deletedBy: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>>;
+        createdBy: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>>;
+        updatedBy: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>>;
+        deletedBy: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>>;
     };
 }
 export type ExcludeFromUpdate = {
@@ -40,37 +48,37 @@ export declare class SchemaBuilder<T extends z.ZodRawShape> {
     constructor(baseFields: T, includeTimestamps?: boolean, includeTracking?: boolean);
     getBaseSchema(): z.ZodObject<T, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<T>, any> extends infer T_1 ? { [k in keyof T_1]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<T>, any>[k]; } : never, z.baseObjectInputType<T> extends infer T_2 ? { [k_1 in keyof T_2]: z.baseObjectInputType<T>[k_1]; } : never>;
     getEntitySchema(): z.ZodObject<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>>, any> extends infer T_1 ? { [k in keyof T_1]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>>, any>[k]; } : never, z.baseObjectInputType<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>> extends infer T_2 ? { [k_1 in keyof T_2]: z.baseObjectInputType<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>>[k_1]; } : never>;
-    getIdSchema(): z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+    getIdSchema(): z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     getUpdateSchema(excludeFields?: ExcludeFromUpdate): z.ZodObject<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }> extends infer T_1 extends z.ZodRawShape ? { [k in keyof T_1]: z.ZodOptional<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>[k]>; } : never, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }> extends infer T_4 extends z.ZodRawShape ? { [k in keyof T_4]: z.ZodOptional<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>[k]>; } : never>, any> extends infer T_2 ? { [k_1 in keyof T_2]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }> extends infer T_3 extends z.ZodRawShape ? { [k in keyof T_3]: z.ZodOptional<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>[k]>; } : never>, any>[k_1]; } : never, z.baseObjectInputType<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }> extends infer T_7 extends z.ZodRawShape ? { [k in keyof T_7]: z.ZodOptional<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>[k]>; } : never> extends infer T_5 ? { [k_2 in keyof T_5]: z.baseObjectInputType<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }> extends infer T_6 extends z.ZodRawShape ? { [k in keyof T_6]: z.ZodOptional<z.objectUtil.extendShape<T, {
-        _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
     }>[k]>; } : never>[k_2]; } : never> | z.ZodObject<{
         [x: string]: z.ZodOptional<z.ZodTypeAny>;
     }, "strip", z.ZodTypeAny, {
@@ -81,37 +89,37 @@ export declare class SchemaBuilder<T extends z.ZodRawShape> {
     getAllSchemas(excludeFromUpdate?: ExcludeFromUpdate): {
         BaseSchema: z.ZodObject<T, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<T>, any> extends infer T_1 ? { [k in keyof T_1]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<T>, any>[k]; } : never, z.baseObjectInputType<T> extends infer T_2 ? { [k_1 in keyof T_2]: z.baseObjectInputType<T>[k_1]; } : never>;
         EntitySchema: z.ZodObject<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>>, any> extends infer T_3 ? { [k_2 in keyof T_3]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>>, any>[k_2]; } : never, z.baseObjectInputType<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>> extends infer T_4 ? { [k_3 in keyof T_4]: z.baseObjectInputType<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>>[k_3]; } : never>;
-        IdSchema: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+        IdSchema: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         UpdateSchema: z.ZodObject<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }> extends infer T_5 extends z.ZodRawShape ? { [k_4 in keyof T_5]: z.ZodOptional<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>[k_4]>; } : never, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }> extends infer T_8 extends z.ZodRawShape ? { [k_4 in keyof T_8]: z.ZodOptional<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>[k_4]>; } : never>, any> extends infer T_6 ? { [k_5 in keyof T_6]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }> extends infer T_7 extends z.ZodRawShape ? { [k_4 in keyof T_7]: z.ZodOptional<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>[k_4]>; } : never>, any>[k_5]; } : never, z.baseObjectInputType<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }> extends infer T_11 extends z.ZodRawShape ? { [k_4 in keyof T_11]: z.ZodOptional<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>[k_4]>; } : never> extends infer T_9 ? { [k_6 in keyof T_9]: z.baseObjectInputType<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }> extends infer T_10 extends z.ZodRawShape ? { [k_4 in keyof T_10]: z.ZodOptional<z.objectUtil.extendShape<T, {
-            _id: z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodEffects<z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>, string, mongoose.Types.ObjectId>]>;
+            _id: z.ZodUnion<[z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, mongoose.Types.ObjectId, string>, z.ZodType<mongoose.Types.ObjectId, z.ZodTypeDef, mongoose.Types.ObjectId>]>;
         }>[k_4]>; } : never>[k_6]; } : never> | z.ZodObject<{
             [x: string]: z.ZodOptional<z.ZodTypeAny>;
         }, "strip", z.ZodTypeAny, {

package/dist/utilities/validation/global-validation.js

@@ -5,75 +5,127 @@ exports.createSchemaBuilder = createSchemaBuilder;
 const zod_1 = require("zod");
 const typegoose_1 = require("@typegoose/typegoose");
 class ZodValidation {
-    static objectId(field = 'Field') {
+    static objectId(field = "Field") {
         return zod_1.z.union([
-            zod_1.z.string().refine(val => typegoose_1.mongoose.Types.ObjectId.isValid(val), {
-                message: `Invalid ${field} ObjectID format`,
-            }),
-            zod_1.z.instanceof(typegoose_1.mongoose.Types.ObjectId).transform(val => val.toString()),
-        ]);
-    }
-    static enumType(enumObj, field = 'Field') {
+            zod_1.z
+                .string({ required_error: `${field} is required` })
+                .refine((val) => typegoose_1.mongoose.Types.ObjectId.isValid(val), {
+                message: `${field} must be a valid ObjectID`
+            })
+                .transform((val) => new typegoose_1.mongoose.Types.ObjectId(val)),
+            zod_1.z.instanceof(typegoose_1.mongoose.Types.ObjectId, {
+                message: `${field} must be a valid ObjectID`
+            })
+        ], { message: `${field} is required` });
+    }
+    static enumType(enumObj, field = "Field") {
         return zod_1.z.nativeEnum(enumObj, {
-            message: `${field} must be one of: ${Object.values(enumObj).join(', ')}`,
+            message: `${field} must be one of: ${Object.values(enumObj).join(", ")}`
+        });
+    }
+    static number(field = "Field", min, max, options) {
+        let schema = zod_1.z.number({
+            required_error: `${field} is required`,
+            invalid_type_error: `${field} must be a number`
         });
+        if (min !== undefined) {
+            schema = schema.gte(min, { message: `${field} must be at least ${min}` });
+        }
+        if (max !== undefined) {
+            schema = schema.lte(max, { message: `${field} must be at most ${max}` });
+        }
+        if (options?.isInt) {
+            schema = schema.int({ message: `${field} must be an integer` });
+        }
+        if (options?.isPositive) {
+            schema = schema.positive({ message: `${field} must be positive` });
+        }
+        if (options?.isNonpositive) {
+            schema = schema.nonpositive({ message: `${field} must be non-positive` });
+        }
+        if (options?.isNegative) {
+            schema = schema.negative({ message: `${field} must be negative` });
+        }
+        if (options?.isNonnegative) {
+            schema = schema.nonnegative({ message: `${field} must be non-negative` });
+        }
+        return schema;
     }
-    static number(field = 'Field', minLength) {
-        const numberSchema = zod_1.z.number({
+    static string(field = "Field", minLength, maxLength, regex) {
+        let schema = zod_1.z.string({
             required_error: `${field} is required`,
-            invalid_type_error: `${field} must be a number`,
+            invalid_type_error: `${field} must be a string`
         });
-        return minLength !== undefined
-            ? numberSchema.min(minLength, `${field} value must be greater than or equal to ${minLength}`)
-            : numberSchema;
-    }
-    static string(field = 'Field', minLength) {
-        const stringSchema = zod_1.z
-            .string({ required_error: `${field} is required`, invalid_type_error: `${field} must be a string` })
-            .trim();
-        return minLength !== undefined
-            ? stringSchema.min(minLength, `${field} value length must be greater than or equal to ${minLength}`)
-            : stringSchema;
-    }
-    static email(field = 'Field') {
+        if (minLength !== undefined) {
+            schema = schema.min(minLength, `${field} value length must be greater than or equal to ${minLength}`);
+        }
+        if (maxLength !== undefined) {
+            schema = schema.max(maxLength, `${field} value length must be less than or equal to ${maxLength}`);
+        }
+        if (regex !== undefined) {
+            schema = schema.regex(regex.pattern, regex.message);
+        }
+        return schema;
+    }
+    static email(field = "Field") {
         return zod_1.z
             .string({ required_error: `${field} is required` })
             .email(`${field} must be a valid email address`);
     }
-    static url(field = 'Field') {
-        return zod_1.z.string({ required_error: `${field} is required` }).url(`${field} must be a valid URL`);
+    static url(field = "Field") {
+        return zod_1.z
+            .string({ required_error: `${field} is required` })
+            .url(`${field} must be a valid URL`);
     }
-    static phoneNumber(field = 'Field') {
+    static phoneNumber(field = "Field") {
         return zod_1.z
             .string({ required_error: `${field} is required` })
             .regex(/^[+]{1}(?:[0-9\-\\(\\)\\/.]\s?){6,15}[0-9]{1}$/, `${field} must be a valid phone number`);
     }
-    static dateString(field = 'Field') {
-        return zod_1.z.string({ required_error: `${field} is required` }).refine(val => !isNaN(Date.parse(val)), {
-            message: `${field} must be a valid date format`,
-        });
-    }
-    static date(field = 'Field') {
-        return zod_1.z.date({
-            required_error: `${field} is required`,
-            invalid_type_error: `${field} must be a date`,
-        });
-    }
-    static boolean(field = 'Field') {
+    static date(field = "Field", minDate, maxDate) {
+        return zod_1.z
+            .union([
+            zod_1.z
+                .string({ required_error: `${field} is required` })
+                .refine((val) => {
+                const date = new Date(val);
+                return !isNaN(date.getTime());
+            }, `${field} must be a valid date`)
+                .transform((val) => new Date(val)),
+            zod_1.z.date({
+                required_error: `${field} is required`,
+                invalid_type_error: `${field} must be a valid date`
+            })
+        ], { message: `${field} is required` })
+            .refine((val) => minDate === undefined || val >= minDate, `${field} must be on or after ${minDate?.toISOString()}`)
+            .refine((val) => maxDate === undefined || val <= maxDate, `${field} must be on or before ${maxDate?.toISOString()}`);
+    }
+    static boolean(field = "Field") {
         return zod_1.z.boolean({
             required_error: `${field} is required`,
-            invalid_type_error: `${field} must be a boolean`,
+            invalid_type_error: `${field} must be a boolean`
         });
     }
-    static array(schema, field = 'Array', minItems) {
-        const arraySchema = zod_1.z.array(schema);
-        return minItems !== undefined ? arraySchema.min(minItems, `${field} cannot be empty`) : arraySchema;
+    static array(schema, field = "Array", minItems, maxItems) {
+        let arraySchema = zod_1.z.array(schema, {
+            required_error: `${field} is required`
+        });
+        if (minItems === 1) {
+            arraySchema = arraySchema.min(1, `${field} cannot be empty`);
+        }
+        if (minItems !== undefined && minItems !== 1) {
+            arraySchema = arraySchema.min(minItems, `${field} must have at least ${minItems} items`);
+        }
+        if (maxItems !== undefined) {
+            arraySchema = arraySchema.max(maxItems, `${field} must have at most ${maxItems} items`);
+        }
+        return arraySchema;
     }
     static timestamps() {
         return {
             createdAt: zod_1.z.date().nullable().optional(),
             updatedAt: zod_1.z.date().nullable().optional(),
-            deletedAt: zod_1.z.date().nullable().optional(),
+            deletedAt: zod_1.z.date().nullable().optional()
         };
     }
     static trackingFields() {
@@ -81,7 +133,7 @@ class ZodValidation {
             createdBy: ZodValidation.objectId().optional(),
             updatedBy: ZodValidation.objectId().optional(),
             deletedBy: ZodValidation.objectId().optional(),
-            ...ZodValidation.timestamps(),
+            ...ZodValidation.timestamps()
         };
     }
 }
@@ -96,13 +148,13 @@ class SchemaBuilder {
         if (includeTracking) {
             this.baseSchema = zod_1.z.object({
                 ...baseFields,
-                ...ZodValidation.trackingFields(),
+                ...ZodValidation.trackingFields()
             });
         }
         else if (includeTimestamps) {
             this.baseSchema = zod_1.z.object({
                 ...baseFields,
-                ...ZodValidation.timestamps(),
+                ...ZodValidation.timestamps()
             });
         }
         else {
@@ -114,7 +166,7 @@ class SchemaBuilder {
     }
     getEntitySchema() {
         return this.baseSchema.extend({
-            _id: ZodValidation.objectId(),
+            _id: ZodValidation.objectId()
         });
     }
     getIdSchema() {
@@ -139,7 +191,7 @@ class SchemaBuilder {
             BaseSchema: this.getBaseSchema(),
             EntitySchema: this.getEntitySchema(),
             IdSchema: this.getIdSchema(),
-            UpdateSchema: this.getUpdateSchema(excludeFromUpdate),
+            UpdateSchema: this.getUpdateSchema(excludeFromUpdate)
         };
     }
 }

package/dist/utilities/validation/global-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"global-validation.js","sourceRoot":"/","sources":["utilities/validation/global-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\r\nimport { mongoose } from '@typegoose/typegoose';\r\n\r\n/**\r\n * Enhanced validation utilities for creating robust Zod schemas.\r\n * This class provides a collection of static methods to create common validation patterns.\r\n *\r\n * @example\r\n * ```typescript\r\n * const userSchema = z.object({\r\n *   username: ZodValidation.requiredString(\"Username is required\"),\r\n *   email: ZodValidation.email(),\r\n *   role: ZodValidation.enumType(UserRole)\r\n * });\r\n * ```\r\n */\r\nexport class ZodValidation {\r\n\t/**\r\n\t * Creates a union type that accepts both string ObjectId and mongoose ObjectId instance.\r\n\t * This is useful when dealing with both raw string IDs and Mongoose ObjectId instances.\r\n\t *\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @returns A Zod union schema that accepts both string and ObjectId\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const idSchema = ZodValidation.objectIdUnion();\r\n\t * // Accepts \"507f1f77bcf86cd799439011\" or new mongoose.Types.ObjectId(\"507f1f77bcf86cd799439011\")\r\n\t * ```\r\n\t */\r\n\tstatic objectId(field: string = 'Field') {\r\n\t\treturn z.union([\r\n\t\t\tz.string().refine(val => mongoose.Types.ObjectId.isValid(val), {\r\n\t\t\t\tmessage: `Invalid ${field} ObjectID format`,\r\n\t\t\t}),\r\n\t\t\tz.instanceof(mongoose.Types.ObjectId).transform(val => val.toString()),\r\n\t\t]);\r\n\t}\r\n\r\n\t/**\r\n\t * Creates an enum validation with custom error message.\r\n\t * This validates that a value is one of the values defined in the enum.\r\n\t *\r\n\t * @template T - Type of the enum\r\n\t * @param enumObj - The enum object to validate against\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @returns A Zod schema that validates against the provided enum\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * enum UserRole { ADMIN = \"admin\", USER = \"user\" }\r\n\t * const roleSchema = ZodValidation.enumType(UserRole, \"Invalid user role\");\r\n\t * ```\r\n\t */\r\n\tstatic enumType<T extends z.EnumLike>(enumObj: T, field: string = 'Field') {\r\n\t\treturn z.nativeEnum(enumObj, {\r\n\t\t\tmessage: `${field} must be one of: ${Object.values(enumObj).join(', ')}`,\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * Creates a required number validation with a minimum length.\r\n\t * The number is also trimmed to remove leading/trailing whitespace.\r\n\t *\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @param minLength - Minimum required length (default: 1)\r\n\t * @returns A Zod schema that validates numbers with minimum length\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const nameSchema = ZodValidation.Number(\"Price\");\r\n\t * ```\r\n\t */\r\n\tstatic number(field: string = 'Field', minLength?: number) {\r\n\t\tconst numberSchema = z.number({\r\n\t\t\trequired_error: `${field} is required`,\r\n\t\t\tinvalid_type_error: `${field} must be a number`,\r\n\t\t});\r\n\t\treturn minLength !== undefined\r\n\t\t\t? numberSchema.min(minLength, `${field} value must be greater than or equal to ${minLength}`)\r\n\t\t\t: numberSchema;\r\n\t}\r\n\r\n\t/**\r\n\t * Creates a required string validation with a minimum length.\r\n\t * The string is also trimmed to remove leading/trailing whitespace.\r\n\t *\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @param minLength - Minimum required length (default: 1)\r\n\t * @returns A Zod schema that validates strings with minimum length\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const nameSchema = ZodValidation.String(\"Name\");\r\n\t * ```\r\n\t */\r\n\tstatic string(field: string = 'Field', minLength?: number) {\r\n\t\tconst stringSchema = z\r\n\t\t\t.string({ required_error: `${field} is required`, invalid_type_error: `${field} must be a string` })\r\n\t\t\t.trim();\r\n\r\n\t\treturn minLength !== undefined\r\n\t\t\t? stringSchema.min(minLength, `${field} value length must be greater than or equal to ${minLength}`)\r\n\t\t\t: stringSchema;\r\n\t}\r\n\r\n\t/**\r\n\t * Creates an email validation.\r\n\t * Validates that the string is a valid email address format.\r\n\t *\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @returns A Zod schema that validates email addresses\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const emailSchema = ZodValidation.email(\"Please enter a valid email\");\r\n\t * ```\r\n\t */\r\n\tstatic email(field: string = 'Field') {\r\n\t\treturn z\r\n\t\t\t.string({ required_error: `${field} is required` })\r\n\t\t\t.email(`${field} must be a valid email address`);\r\n\t}\r\n\r\n\t/**\r\n\t * Creates a URL validation.\r\n\t * Validates that the string is a valid URL format.\r\n\t *\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @returns A Zod schema that validates URLs\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const websiteSchema = ZodValidation.url(\"Please enter a valid URL\");\r\n\t * ```\r\n\t */\r\n\tstatic url(field: string = 'Field') {\r\n\t\treturn z.string({ required_error: `${field} is required` }).url(`${field} must be a valid URL`);\r\n\t}\r\n\r\n\t/**\r\n\t * Creates a phone number validation schema using a regex pattern for global phone numbers.\r\n\t *\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @returns A Zod schema that validates phone numbers\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const phoneSchema = ZodValidation.phoneNumber(\"Phone number\");\r\n\t * ```\r\n\t */\r\n\tstatic phoneNumber(field: string = 'Field') {\r\n\t\treturn z\r\n\t\t\t.string({ required_error: `${field} is required` })\r\n\t\t\t.regex(/^[+]{1}(?:[0-9\\-\\\\(\\\\)\\\\/.]\\s?){6,15}[0-9]{1}$/, `${field} must be a valid phone number`);\r\n\t}\r\n\r\n\t/**\r\n\t * Creates a date string validation that ensures the input is a valid date.\r\n\t * Validates that the string can be parsed as a valid date.\r\n\t *\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @returns A Zod schema that validates date strings\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const birthDateSchema = ZodValidation.dateString(\"Please enter a valid date\");\r\n\t * ```\r\n\t */\r\n\tstatic dateString(field: string = 'Field') {\r\n\t\treturn z.string({ required_error: `${field} is required` }).refine(val => !isNaN(Date.parse(val)), {\r\n\t\t\tmessage: `${field} must be a valid date format`,\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * Creates a date validation.\r\n\t * Validates that the input is a JavaScript Date object.\r\n\t *@param field - The name of the field to be included in the error message\r\n\t * @returns A Zod schema that validates Date objects\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const createdAtSchema = ZodValidation.date();\r\n\t * ```\r\n\t */\r\n\tstatic date(field: string = 'Field') {\r\n\t\treturn z.date({\r\n\t\t\trequired_error: `${field} is required`,\r\n\t\t\tinvalid_type_error: `${field} must be a date`,\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * Creates a boolean validation with an optional default value.\r\n\t *\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @returns A Zod schema that validates booleans\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const isActiveSchema = ZodValidation.boolean(true); // Defaults to true\r\n\t * ```\r\n\t */\r\n\tstatic boolean(field: string = 'Field') {\r\n\t\treturn z.boolean({\r\n\t\t\trequired_error: `${field} is required`,\r\n\t\t\tinvalid_type_error: `${field} must be a boolean`,\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * Creates an array validation with optional minimum items constraint.\r\n\t *\r\n\t * @template T - Type of the schema for array items\r\n\t * @param schema - The schema for validating array items\r\n\t * @param field - The name of the field to be included in the error message\r\n\t * @param minItems - Minimum number of items required (optional)\r\n\t * @returns A Zod schema that validates arrays\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const tagsSchema = ZodValidation.array(z.string(), \"At least one tag required\", 1);\r\n\t * ```\r\n\t */\r\n\tstatic array<T extends z.ZodTypeAny>(schema: T, field: string = 'Array', minItems?: number) {\r\n\t\tconst arraySchema = z.array(schema);\r\n\t\treturn minItems !== undefined ? arraySchema.min(minItems, `${field} cannot be empty`) : arraySchema;\r\n\t}\r\n\r\n\t/**\r\n\t * Standard timestamp fields for entities.\r\n\t * Includes createdAt, updatedAt, and deletedAt fields.\r\n\t *\r\n\t * @returns An object containing timestamp field schemas\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const userSchema = z.object({\r\n\t *   name: z.string(),\r\n\t *   ...ZodValidation.timestamps()\r\n\t * });\r\n\t * ```\r\n\t */\r\n\tstatic timestamps() {\r\n\t\treturn {\r\n\t\t\tcreatedAt: z.date().nullable().optional(),\r\n\t\t\tupdatedAt: z.date().nullable().optional(),\r\n\t\t\tdeletedAt: z.date().nullable().optional(),\r\n\t\t};\r\n\t}\r\n\r\n\t/**\r\n\t * Common fields for tracking model metadata.\r\n\t * Includes timestamps and user tracking fields (createdBy, updatedBy, deletedBy).\r\n\t *\r\n\t * @returns An object containing tracking field schemas\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const postSchema = z.object({\r\n\t *   title: z.string(),\r\n\t *   content: z.string(),\r\n\t *   ...ZodValidation.trackingFields()\r\n\t * });\r\n\t * ```\r\n\t */\r\n\tstatic trackingFields() {\r\n\t\treturn {\r\n\t\t\tcreatedBy: ZodValidation.objectId().optional(),\r\n\t\t\tupdatedBy: ZodValidation.objectId().optional(),\r\n\t\t\tdeletedBy: ZodValidation.objectId().optional(),\r\n\t\t\t...ZodValidation.timestamps(),\r\n\t\t};\r\n\t}\r\n}\r\n\r\n/**\r\n * Represents the common fields to exclude from update operations.\r\n * This is used to specify which fields should not be updateable.\r\n *\r\n * @example\r\n * ```typescript\r\n * const excludeFields: ExcludeFromUpdate = {\r\n *   createdAt: true,\r\n *   createdBy: true,\r\n *   status: true  // Prevent status from being updated\r\n * };\r\n * ```\r\n */\r\nexport type ExcludeFromUpdate = {\r\n\tcreatedAt?: true;\r\n\tupdatedAt?: true;\r\n\tdeletedAt?: true;\r\n\tcreatedBy?: true;\r\n\t_id?: true;\r\n} & Record<string, true>;\r\n\r\n/**\r\n * Schema builder for creating consistent CRUD schemas.\r\n * Provides utility methods to generate schemas for create, read, update, and delete operations.\r\n *\r\n * @template T - Type of the base schema shape\r\n *\r\n * @example\r\n * ```typescript\r\n * const userBuilder = new SchemaBuilder({\r\n *   name: z.string(),\r\n *   email: z.string().email()\r\n * });\r\n *\r\n * const schemas = userBuilder.getAllSchemas();\r\n * ```\r\n */\r\nexport class SchemaBuilder<T extends z.ZodRawShape> {\r\n\tprivate baseSchema: z.ZodObject<T>;\r\n\r\n\t/**\r\n\t * Create a new schema builder\r\n\t *\r\n\t * @param baseFields - The base fields for the schema\r\n\t * @param includeTimestamps - Whether to include timestamp fields (default: true)\r\n\t * @param includeTracking - Whether to include tracking fields (createdBy, etc.) (default: false)\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const userFields = {\r\n\t *   name: ZodValidation.requiredString(),\r\n\t *   email: ZodValidation.email()\r\n\t * };\r\n\t *\r\n\t * // With timestamps\r\n\t * const builder1 = new SchemaBuilder(userFields);\r\n\t *\r\n\t * // Without timestamps\r\n\t * const builder2 = new SchemaBuilder(userFields, false);\r\n\t *\r\n\t * // With tracking fields\r\n\t * const builder3 = new SchemaBuilder(userFields, true, true);\r\n\t * ```\r\n\t */\r\n\tconstructor(\r\n\t\tbaseFields: T,\r\n\t\tprivate includeTimestamps: boolean = true,\r\n\t\tprivate includeTracking: boolean = false\r\n\t) {\r\n\t\tif (includeTracking) {\r\n\t\t\tthis.baseSchema = z.object({\r\n\t\t\t\t...baseFields,\r\n\t\t\t\t...ZodValidation.trackingFields(),\r\n\t\t\t});\r\n\t\t} else if (includeTimestamps) {\r\n\t\t\tthis.baseSchema = z.object({\r\n\t\t\t\t...baseFields,\r\n\t\t\t\t...ZodValidation.timestamps(),\r\n\t\t\t});\r\n\t\t} else {\r\n\t\t\tthis.baseSchema = z.object(baseFields);\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * Gets the base validation schema without ID.\r\n\t * Used for creating new entities.\r\n\t *\r\n\t * @returns The base schema for creating new entities\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const createUserSchema = userBuilder.getBaseSchema();\r\n\t * ```\r\n\t */\r\n\tgetBaseSchema() {\r\n\t\treturn this.baseSchema;\r\n\t}\r\n\r\n\t/**\r\n\t * Gets the schema for entities with ID.\r\n\t * Used for representing complete entities with their ID.\r\n\t *\r\n\t * @returns The entity schema including ID\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const userSchema = userBuilder.getEntitySchema();\r\n\t * ```\r\n\t */\r\n\tgetEntitySchema() {\r\n\t\treturn this.baseSchema.extend({\r\n\t\t\t_id: ZodValidation.objectId(),\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * Gets the schema for validating an entity ID.\r\n\t * Used for validating ID parameters in requests.\r\n\t *\r\n\t * @returns The ID validation schema\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const userIdSchema = userBuilder.getIdSchema();\r\n\t * ```\r\n\t */\r\n\tgetIdSchema() {\r\n\t\treturn ZodValidation.objectId();\r\n\t}\r\n\r\n\t/**\r\n\t * Gets the schema for updating an entity, excluding specified fields.\r\n\t * Creates a partial schema where all fields are optional, and removes\r\n\t * fields that should not be updateable.\r\n\t *\r\n\t * @param excludeFields - Fields to exclude from update operations\r\n\t * @returns The update schema with excluded fields removed\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * // Prevent updating createdAt and status\r\n\t * const updateUserSchema = userBuilder.getUpdateSchema({\r\n\t *   createdAt: true,\r\n\t *   status: true\r\n\t * });\r\n\t * ```\r\n\t */\r\n\tgetUpdateSchema(excludeFields: ExcludeFromUpdate = { createdAt: true }) {\r\n\t\tconst entitySchema = this.getEntitySchema();\r\n\r\n\t\t// Simple approach - just make everything optional\r\n\t\tif (Object.keys(excludeFields).length === 0) {\r\n\t\t\treturn entitySchema.partial();\r\n\t\t}\r\n\r\n\t\t// For the type-safe approach, we need to create a new schema\r\n\t\t// without the excluded fields and then make it partial\r\n\r\n\t\t// Get all fields from the entity schema\r\n\t\tconst shape = entitySchema._def.shape();\r\n\r\n\t\t// Filter out the fields we want to exclude\r\n\t\tconst filteredShape: z.ZodRawShape = {};\r\n\t\tfor (const key in shape) {\r\n\t\t\tif (!excludeFields[key as keyof typeof excludeFields]) {\r\n\t\t\t\tfilteredShape[key] = shape[key];\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\t// Create a new schema with the filtered fields\r\n\t\treturn z.object(filteredShape).partial();\r\n\t}\r\n\r\n\t/**\r\n\t * Gets all common schemas for an entity.\r\n\t * Returns base, entity, ID, and update schemas in a single object.\r\n\t *\r\n\t * @param excludeFromUpdate - Fields to exclude from update operations\r\n\t * @returns Object containing all schemas\r\n\t *\r\n\t * @example\r\n\t * ```typescript\r\n\t * const {\r\n\t *   BaseSchema,   // For creating\r\n\t *   EntitySchema, // For reading\r\n\t *   IdSchema,     // For validating IDs\r\n\t *   UpdateSchema  // For updating\r\n\t * } = userBuilder.getAllSchemas();\r\n\t * ```\r\n\t */\r\n\tgetAllSchemas(excludeFromUpdate: ExcludeFromUpdate = { createdAt: true }) {\r\n\t\treturn {\r\n\t\t\tBaseSchema: this.getBaseSchema(),\r\n\t\t\tEntitySchema: this.getEntitySchema(),\r\n\t\t\tIdSchema: this.getIdSchema(),\r\n\t\t\tUpdateSchema: this.getUpdateSchema(excludeFromUpdate),\r\n\t\t};\r\n\t}\r\n}\r\n\r\n/**\r\n * Type helper for creating DTO types from creation schemas.\r\n * Used to derive the type for creating new entities.\r\n *\r\n * @template T - The schema type\r\n *\r\n * @example\r\n * ```typescript\r\n * type CreateUserDTO = CreateDTO<typeof UserValidationSchema>;\r\n * ```\r\n */\r\nexport type CreateDTO<T extends z.ZodType> = z.infer<T>;\r\n\r\n/**\r\n * Type helper for creating DTO types from entity schemas.\r\n * Used to derive the type for complete entities.\r\n *\r\n * @template T - The schema type\r\n *\r\n * @example\r\n * ```typescript\r\n * type UserDTO = EntityDTO<typeof UserSchema>;\r\n * ```\r\n */\r\nexport type EntityDTO<T extends z.ZodType> = z.infer<T>;\r\n\r\n/**\r\n * Type helper for creating DTO types from update schemas.\r\n * Used to derive the type for updating entities.\r\n *\r\n * @template T - The schema type\r\n *\r\n * @example\r\n * ```typescript\r\n * type UpdateUserDTO = UpdateDTO<typeof UpdateUserSchema>;\r\n * ```\r\n */\r\nexport type UpdateDTO<T extends z.ZodType> = z.infer<T>;\r\n\r\n/**\r\n * Type alias for ID DTOs.\r\n * Represents the type of entity IDs (string).\r\n *\r\n * @example\r\n * ```typescript\r\n * type UserIdDTO = IdDTO;\r\n * ```\r\n */\r\nexport type IdDTO = string;\r\n\r\n/**\r\n * Creates a schema builder for an entity.\r\n * Helper function to create a new SchemaBuilder instance.\r\n *\r\n * @template T - Type of the base schema shape\r\n * @param baseFields - Base fields for the entity\r\n * @param includeTimestamps - Whether to include timestamp fields (default: true)\r\n * @param includeTracking - Whether to include tracking fields (default: false)\r\n * @returns A new SchemaBuilder instance\r\n *\r\n * @example\r\n * ```typescript\r\n * const userFields = {\r\n *   name: ZodValidation.requiredString(),\r\n *   email: ZodValidation.email()\r\n * };\r\n *\r\n * const userSchemaBuilder = createSchemaBuilder(userFields);\r\n * const userSchemaBuilder = createSchemaBuilder(userFields, true, true); // With tracking\r\n * ```\r\n */\r\nexport function createSchemaBuilder<T extends z.ZodRawShape>(\r\n\tbaseFields: T,\r\n\tincludeTimestamps: boolean = true,\r\n\tincludeTracking: boolean = false\r\n) {\r\n\treturn new SchemaBuilder(baseFields, includeTimestamps, includeTracking);\r\n}\r\n"]}
+{"version":3,"file":"global-validation.js","sourceRoot":"/","sources":["utilities/validation/global-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\r\nimport { mongoose } from \"@typegoose/typegoose\";\r\n\r\n/**\r\n * Enhanced validation utilities for creating robust Zod schemas.\r\n * This class provides a collection of static methods to create common validation patterns.\r\n *\r\n * @example\r\n * ```typescript\r\n * const userSchema = z.object({\r\n *   username: ZodValidation.requiredString(\"Username is required\"),\r\n *   email: ZodValidation.email(),\r\n *   role: ZodValidation.enumType(UserRole)\r\n * });\r\n * ```\r\n */\r\nexport class ZodValidation {\r\n  /**\r\n   * Creates a union type that accepts both string ObjectId and mongoose ObjectId instance.\r\n   * This is useful when dealing with both raw string IDs and Mongoose ObjectId instances.\r\n   *\r\n   * @param field - The name of the field to be included in the error message\r\n   * @returns A Zod union schema that accepts both string and ObjectId\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const idSchema = ZodValidation.objectIdUnion();\r\n   * // Accepts \"507f1f77bcf86cd799439011\" or new mongoose.Types.ObjectId(\"507f1f77bcf86cd799439011\")\r\n   * ```\r\n   */\r\n  static objectId(field: string = \"Field\") {\r\n    return z.union(\r\n      [\r\n        z\r\n          .string({ required_error: `${field} is required` })\r\n          .refine((val) => mongoose.Types.ObjectId.isValid(val), {\r\n            message: `${field} must be a valid ObjectID`\r\n          })\r\n          .transform((val) => new mongoose.Types.ObjectId(val)),\r\n        z.instanceof(mongoose.Types.ObjectId, {\r\n          message: `${field} must be a valid ObjectID`\r\n        })\r\n      ],\r\n      { message: `${field} is required` }\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Creates an enum validation with custom error message.\r\n   * This validates that a value is one of the values defined in the enum.\r\n   *\r\n   * @template T - Type of the enum\r\n   * @param enumObj - The enum object to validate against\r\n   * @param field - The name of the field to be included in the error message\r\n   * @returns A Zod schema that validates against the provided enum\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * enum UserRole { ADMIN = \"admin\", USER = \"user\" }\r\n   * const roleSchema = ZodValidation.enumType(UserRole, \"Invalid user role\");\r\n   * ```\r\n   */\r\n  static enumType<T extends z.EnumLike>(enumObj: T, field: string = \"Field\") {\r\n    return z.nativeEnum(enumObj, {\r\n      message: `${field} must be one of: ${Object.values(enumObj).join(\", \")}`\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates a required number validation with a minimum length.\r\n   * The number is also trimmed to remove leading/trailing whitespace.\r\n   *\r\n   * @param field - The name of the field to be included in the error message\r\n   * @param min - Minimum number (optional)\r\n   * @param max - MAximum number (optional)\r\n   * @param options - options (optional)\r\n   * @returns A Zod schema that validates numbers with minimum length\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const nameSchema = ZodValidation.Number(\"Price\");\r\n   * ```\r\n   */\r\n  static number(\r\n    field: string = \"Field\",\r\n    min?: number,\r\n    max?: number,\r\n    options?: {\r\n      isInt?: boolean;\r\n      isPositive?: boolean;\r\n      isNonpositive?: boolean;\r\n      isNegative?: boolean;\r\n      isNonnegative?: boolean;\r\n    }\r\n  ) {\r\n    let schema = z.number({\r\n      required_error: `${field} is required`,\r\n      invalid_type_error: `${field} must be a number`\r\n    });\r\n\r\n    // Range validation\r\n    if (min !== undefined) {\r\n      schema = schema.gte(min, { message: `${field} must be at least ${min}` });\r\n    }\r\n    if (max !== undefined) {\r\n      schema = schema.lte(max, { message: `${field} must be at most ${max}` });\r\n    }\r\n\r\n    // Option validation\r\n    if (options?.isInt) {\r\n      schema = schema.int({ message: `${field} must be an integer` });\r\n    }\r\n    if (options?.isPositive) {\r\n      schema = schema.positive({ message: `${field} must be positive` });\r\n    }\r\n    if (options?.isNonpositive) {\r\n      schema = schema.nonpositive({ message: `${field} must be non-positive` });\r\n    }\r\n    if (options?.isNegative) {\r\n      schema = schema.negative({ message: `${field} must be negative` });\r\n    }\r\n    if (options?.isNonnegative) {\r\n      schema = schema.nonnegative({ message: `${field} must be non-negative` });\r\n    }\r\n\r\n    return schema;\r\n  }\r\n\r\n  /**\r\n   * Creates a required string validation with a minimum length.\r\n   * The string is also trimmed to remove leading/trailing whitespace.\r\n   *\r\n   * @param field - The name of the field to be included in the error message\r\n   * @param minLength - Minimum required length (optional)\r\n   * @param maxLength - Maximum required length (optional)\r\n   * @param regex - Regular erpression (optional)\r\n   * @returns A Zod schema that validates strings with minimum length\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const nameSchema = ZodValidation.String(\"Name\");\r\n   * ```\r\n   */\r\n  static string(\r\n    field: string = \"Field\",\r\n    minLength?: number,\r\n    maxLength?: number,\r\n    regex?: { pattern: RegExp; message: string }\r\n  ) {\r\n    let schema = z.string({\r\n      required_error: `${field} is required`,\r\n      invalid_type_error: `${field} must be a string`\r\n    });\r\n\r\n    if (minLength !== undefined) {\r\n      schema = schema.min(\r\n        minLength,\r\n        `${field} value length must be greater than or equal to ${minLength}`\r\n      );\r\n    }\r\n    if (maxLength !== undefined) {\r\n      schema = schema.max(\r\n        maxLength,\r\n        `${field} value length must be less than or equal to ${maxLength}`\r\n      );\r\n    }\r\n    if (regex !== undefined) {\r\n      schema = schema.regex(regex.pattern, regex.message);\r\n    }\r\n\r\n    return schema;\r\n  }\r\n\r\n  /**\r\n   * Creates an email validation.\r\n   * Validates that the string is a valid email address format.\r\n   *\r\n   * @param field - The name of the field to be included in the error message\r\n   * @returns A Zod schema that validates email addresses\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const emailSchema = ZodValidation.email(\"Please enter a valid email\");\r\n   * ```\r\n   */\r\n  static email(field: string = \"Field\") {\r\n    return z\r\n      .string({ required_error: `${field} is required` })\r\n      .email(`${field} must be a valid email address`);\r\n  }\r\n\r\n  /**\r\n   * Creates a URL validation.\r\n   * Validates that the string is a valid URL format.\r\n   *\r\n   * @param field - The name of the field to be included in the error message\r\n   * @returns A Zod schema that validates URLs\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const websiteSchema = ZodValidation.url(\"Please enter a valid URL\");\r\n   * ```\r\n   */\r\n  static url(field: string = \"Field\") {\r\n    return z\r\n      .string({ required_error: `${field} is required` })\r\n      .url(`${field} must be a valid URL`);\r\n  }\r\n\r\n  /**\r\n   * Creates a phone number validation schema using a regex pattern for global phone numbers.\r\n   *\r\n   * @param field - The name of the field to be included in the error message\r\n   * @returns A Zod schema that validates phone numbers\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const phoneSchema = ZodValidation.phoneNumber(\"Phone number\");\r\n   * ```\r\n   */\r\n  static phoneNumber(field: string = \"Field\") {\r\n    return z\r\n      .string({ required_error: `${field} is required` })\r\n      .regex(\r\n        /^[+]{1}(?:[0-9\\-\\\\(\\\\)\\\\/.]\\s?){6,15}[0-9]{1}$/,\r\n        `${field} must be a valid phone number`\r\n      );\r\n  }\r\n\r\n  /**\r\n   * Creates a date validation.\r\n   * Validates that the input is a JavaScript Date object.\r\n   *@param field - The name of the field to be included in the error message\r\n   *@param minDate - Minimum required date (optional)\r\n   *@param maxDate - Maximum required date (optional)\r\n   * @returns A Zod schema that validates Date objects\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const createdAtSchema = ZodValidation.date();\r\n   * ```\r\n   */\r\n  static date(field: string = \"Field\", minDate?: Date, maxDate?: Date) {\r\n    return z\r\n      .union(\r\n        [\r\n          z\r\n            .string({ required_error: `${field} is required` })\r\n            .refine((val) => {\r\n              const date = new Date(val);\r\n              return !isNaN(date.getTime());\r\n            }, `${field} must be a valid date`)\r\n            .transform((val) => new Date(val)),\r\n          z.date({\r\n            required_error: `${field} is required`,\r\n            invalid_type_error: `${field} must be a valid date`\r\n          })\r\n        ],\r\n        { message: `${field} is required` }\r\n      )\r\n      .refine(\r\n        (val) => minDate === undefined || val >= minDate,\r\n        `${field} must be on or after ${minDate?.toISOString()}`\r\n      )\r\n      .refine(\r\n        (val) => maxDate === undefined || val <= maxDate,\r\n        `${field} must be on or before ${maxDate?.toISOString()}`\r\n      );\r\n  }\r\n\r\n  /**\r\n   * Creates a boolean validation with an optional default value.\r\n   *\r\n   * @param field - The name of the field to be included in the error message\r\n   * @returns A Zod schema that validates booleans\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const isActiveSchema = ZodValidation.boolean(true); // Defaults to true\r\n   * ```\r\n   */\r\n  static boolean(field: string = \"Field\") {\r\n    return z.boolean({\r\n      required_error: `${field} is required`,\r\n      invalid_type_error: `${field} must be a boolean`\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Creates an array validation with optional minimum items constraint.\r\n   *\r\n   * @template T - Type of the schema for array items\r\n   * @param schema - The schema for validating array items\r\n   * @param field - The name of the field to be included in the error message\r\n   * @param minItems - Minimum number of items required (optional)\r\n   * @param maxItems - Maximum number of items required (optional)\r\n   * @returns A Zod schema that validates arrays\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const tagsSchema = ZodValidation.array(z.string(), \"At least one tag required\", 1);\r\n   * ```\r\n   */\r\n  static array<T extends z.ZodTypeAny>(\r\n    schema: T,\r\n    field: string = \"Array\",\r\n    minItems?: number,\r\n    maxItems?: number\r\n  ) {\r\n    let arraySchema = z.array(schema, {\r\n      required_error: `${field} is required`\r\n    });\r\n\r\n    if (minItems === 1) {\r\n      arraySchema = arraySchema.min(1, `${field} cannot be empty`);\r\n    }\r\n    if (minItems !== undefined && minItems !== 1) {\r\n      arraySchema = arraySchema.min(\r\n        minItems,\r\n        `${field} must have at least ${minItems} items`\r\n      );\r\n    }\r\n    if (maxItems !== undefined) {\r\n      arraySchema = arraySchema.max(\r\n        maxItems,\r\n        `${field} must have at most ${maxItems} items`\r\n      );\r\n    }\r\n\r\n    return arraySchema;\r\n  }\r\n\r\n  /**\r\n   * Standard timestamp fields for entities.\r\n   * Includes createdAt, updatedAt, and deletedAt fields.\r\n   *\r\n   * @returns An object containing timestamp field schemas\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const userSchema = z.object({\r\n   *   name: z.string(),\r\n   *   ...ZodValidation.timestamps()\r\n   * });\r\n   * ```\r\n   */\r\n  static timestamps() {\r\n    return {\r\n      createdAt: z.date().nullable().optional(),\r\n      updatedAt: z.date().nullable().optional(),\r\n      deletedAt: z.date().nullable().optional()\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Common fields for tracking model metadata.\r\n   * Includes timestamps and user tracking fields (createdBy, updatedBy, deletedBy).\r\n   *\r\n   * @returns An object containing tracking field schemas\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const postSchema = z.object({\r\n   *   title: z.string(),\r\n   *   content: z.string(),\r\n   *   ...ZodValidation.trackingFields()\r\n   * });\r\n   * ```\r\n   */\r\n  static trackingFields() {\r\n    return {\r\n      createdBy: ZodValidation.objectId().optional(),\r\n      updatedBy: ZodValidation.objectId().optional(),\r\n      deletedBy: ZodValidation.objectId().optional(),\r\n      ...ZodValidation.timestamps()\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Represents the common fields to exclude from update operations.\r\n * This is used to specify which fields should not be updateable.\r\n *\r\n * @example\r\n * ```typescript\r\n * const excludeFields: ExcludeFromUpdate = {\r\n *   createdAt: true,\r\n *   createdBy: true,\r\n *   status: true  // Prevent status from being updated\r\n * };\r\n * ```\r\n */\r\nexport type ExcludeFromUpdate = {\r\n  createdAt?: true;\r\n  updatedAt?: true;\r\n  deletedAt?: true;\r\n  createdBy?: true;\r\n  _id?: true;\r\n} & Record<string, true>;\r\n\r\n/**\r\n * Schema builder for creating consistent CRUD schemas.\r\n * Provides utility methods to generate schemas for create, read, update, and delete operations.\r\n *\r\n * @template T - Type of the base schema shape\r\n *\r\n * @example\r\n * ```typescript\r\n * const userBuilder = new SchemaBuilder({\r\n *   name: z.string(),\r\n *   email: z.string().email()\r\n * });\r\n *\r\n * const schemas = userBuilder.getAllSchemas();\r\n * ```\r\n */\r\nexport class SchemaBuilder<T extends z.ZodRawShape> {\r\n  private baseSchema: z.ZodObject<T>;\r\n\r\n  /**\r\n   * Create a new schema builder\r\n   *\r\n   * @param baseFields - The base fields for the schema\r\n   * @param includeTimestamps - Whether to include timestamp fields (default: true)\r\n   * @param includeTracking - Whether to include tracking fields (createdBy, etc.) (default: false)\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const userFields = {\r\n   *   name: ZodValidation.requiredString(),\r\n   *   email: ZodValidation.email()\r\n   * };\r\n   *\r\n   * // With timestamps\r\n   * const builder1 = new SchemaBuilder(userFields);\r\n   *\r\n   * // Without timestamps\r\n   * const builder2 = new SchemaBuilder(userFields, false);\r\n   *\r\n   * // With tracking fields\r\n   * const builder3 = new SchemaBuilder(userFields, true, true);\r\n   * ```\r\n   */\r\n  constructor(\r\n    baseFields: T,\r\n    private includeTimestamps: boolean = true,\r\n    private includeTracking: boolean = false\r\n  ) {\r\n    if (includeTracking) {\r\n      this.baseSchema = z.object({\r\n        ...baseFields,\r\n        ...ZodValidation.trackingFields()\r\n      });\r\n    } else if (includeTimestamps) {\r\n      this.baseSchema = z.object({\r\n        ...baseFields,\r\n        ...ZodValidation.timestamps()\r\n      });\r\n    } else {\r\n      this.baseSchema = z.object(baseFields);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Gets the base validation schema without ID.\r\n   * Used for creating new entities.\r\n   *\r\n   * @returns The base schema for creating new entities\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const createUserSchema = userBuilder.getBaseSchema();\r\n   * ```\r\n   */\r\n  getBaseSchema() {\r\n    return this.baseSchema;\r\n  }\r\n\r\n  /**\r\n   * Gets the schema for entities with ID.\r\n   * Used for representing complete entities with their ID.\r\n   *\r\n   * @returns The entity schema including ID\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const userSchema = userBuilder.getEntitySchema();\r\n   * ```\r\n   */\r\n  getEntitySchema() {\r\n    return this.baseSchema.extend({\r\n      _id: ZodValidation.objectId()\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Gets the schema for validating an entity ID.\r\n   * Used for validating ID parameters in requests.\r\n   *\r\n   * @returns The ID validation schema\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const userIdSchema = userBuilder.getIdSchema();\r\n   * ```\r\n   */\r\n  getIdSchema() {\r\n    return ZodValidation.objectId();\r\n  }\r\n\r\n  /**\r\n   * Gets the schema for updating an entity, excluding specified fields.\r\n   * Creates a partial schema where all fields are optional, and removes\r\n   * fields that should not be updateable.\r\n   *\r\n   * @param excludeFields - Fields to exclude from update operations\r\n   * @returns The update schema with excluded fields removed\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * // Prevent updating createdAt and status\r\n   * const updateUserSchema = userBuilder.getUpdateSchema({\r\n   *   createdAt: true,\r\n   *   status: true\r\n   * });\r\n   * ```\r\n   */\r\n  getUpdateSchema(excludeFields: ExcludeFromUpdate = { createdAt: true }) {\r\n    const entitySchema = this.getEntitySchema();\r\n\r\n    // Simple approach - just make everything optional\r\n    if (Object.keys(excludeFields).length === 0) {\r\n      return entitySchema.partial();\r\n    }\r\n\r\n    // For the type-safe approach, we need to create a new schema\r\n    // without the excluded fields and then make it partial\r\n\r\n    // Get all fields from the entity schema\r\n    const shape = entitySchema._def.shape();\r\n\r\n    // Filter out the fields we want to exclude\r\n    const filteredShape: z.ZodRawShape = {};\r\n    for (const key in shape) {\r\n      if (!excludeFields[key as keyof typeof excludeFields]) {\r\n        filteredShape[key] = shape[key];\r\n      }\r\n    }\r\n\r\n    // Create a new schema with the filtered fields\r\n    return z.object(filteredShape).partial();\r\n  }\r\n\r\n  /**\r\n   * Gets all common schemas for an entity.\r\n   * Returns base, entity, ID, and update schemas in a single object.\r\n   *\r\n   * @param excludeFromUpdate - Fields to exclude from update operations\r\n   * @returns Object containing all schemas\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const {\r\n   *   BaseSchema,   // For creating\r\n   *   EntitySchema, // For reading\r\n   *   IdSchema,     // For validating IDs\r\n   *   UpdateSchema  // For updating\r\n   * } = userBuilder.getAllSchemas();\r\n   * ```\r\n   */\r\n  getAllSchemas(excludeFromUpdate: ExcludeFromUpdate = { createdAt: true }) {\r\n    return {\r\n      BaseSchema: this.getBaseSchema(),\r\n      EntitySchema: this.getEntitySchema(),\r\n      IdSchema: this.getIdSchema(),\r\n      UpdateSchema: this.getUpdateSchema(excludeFromUpdate)\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Type helper for creating DTO types from creation schemas.\r\n * Used to derive the type for creating new entities.\r\n *\r\n * @template T - The schema type\r\n *\r\n * @example\r\n * ```typescript\r\n * type CreateUserDTO = CreateDTO<typeof UserValidationSchema>;\r\n * ```\r\n */\r\nexport type CreateDTO<T extends z.ZodType> = z.infer<T>;\r\n\r\n/**\r\n * Type helper for creating DTO types from entity schemas.\r\n * Used to derive the type for complete entities.\r\n *\r\n * @template T - The schema type\r\n *\r\n * @example\r\n * ```typescript\r\n * type UserDTO = EntityDTO<typeof UserSchema>;\r\n * ```\r\n */\r\nexport type EntityDTO<T extends z.ZodType> = z.infer<T>;\r\n\r\n/**\r\n * Type helper for creating DTO types from update schemas.\r\n * Used to derive the type for updating entities.\r\n *\r\n * @template T - The schema type\r\n *\r\n * @example\r\n * ```typescript\r\n * type UpdateUserDTO = UpdateDTO<typeof UpdateUserSchema>;\r\n * ```\r\n */\r\nexport type UpdateDTO<T extends z.ZodType> = z.infer<T>;\r\n\r\n/**\r\n * Type alias for ID DTOs.\r\n * Represents the type of entity IDs (string).\r\n *\r\n * @example\r\n * ```typescript\r\n * type UserIdDTO = IdDTO;\r\n * ```\r\n */\r\nexport type IdDTO = string;\r\n\r\n/**\r\n * Creates a schema builder for an entity.\r\n * Helper function to create a new SchemaBuilder instance.\r\n *\r\n * @template T - Type of the base schema shape\r\n * @param baseFields - Base fields for the entity\r\n * @param includeTimestamps - Whether to include timestamp fields (default: true)\r\n * @param includeTracking - Whether to include tracking fields (default: false)\r\n * @returns A new SchemaBuilder instance\r\n *\r\n * @example\r\n * ```typescript\r\n * const userFields = {\r\n *   name: ZodValidation.requiredString(),\r\n *   email: ZodValidation.email()\r\n * };\r\n *\r\n * const userSchemaBuilder = createSchemaBuilder(userFields);\r\n * const userSchemaBuilder = createSchemaBuilder(userFields, true, true); // With tracking\r\n * ```\r\n */\r\nexport function createSchemaBuilder<T extends z.ZodRawShape>(\r\n  baseFields: T,\r\n  includeTimestamps: boolean = true,\r\n  includeTracking: boolean = false\r\n) {\r\n  return new SchemaBuilder(baseFields, includeTimestamps, includeTracking);\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lyxa.ai/core",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "The Core system of the Lyxa services.",
   "author": "elie <42282499+Internalizable@users.noreply.github.com>",
   "license": "MIT",