hysteria-orm 11.0.2 → 11.0.4

package/lib/index.d.cts

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import { PassThrough } from 'node:stream';
 import * as mssql from 'mssql';
 import { config, Transaction as Transaction$1, IResult } from 'mssql';
@@ -4082,82 +4083,71 @@ declare abstract class WhereQueryBuilder<T extends Model, S extends Record<strin
     private orWhereGroup;
 }
 
-type JsonParam = Record<string, unknown> | any[];
+type DefaultJsonParam = Record<string, any> | any[];
+type JsonValueForColumn<T extends Model, K extends string> = K extends ModelKey<T> ? NonNullable<T[StripTablePrefix<K> & keyof T]> : DefaultJsonParam;
 declare class JsonQueryBuilder<T extends Model, S extends Record<string, any> = Record<string, any>> extends WhereQueryBuilder<T, S> {
     /**
      * @description Filters records matching exact JSON value.
      */
-    whereJson(column: ModelKey<T>, value: JsonParam): this;
-    whereJson(column: string, value: JsonParam): this;
+    whereJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records matching the given JSON value.
      * @mssql Partial JSON matching not supported - only exact matches work
      */
-    andWhereJson(column: ModelKey<T>, value: JsonParam): this;
-    andWhereJson(column: string, value: JsonParam): this;
+    andWhereJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records matching the given JSON value.
      * @mssql Partial JSON matching not supported - only exact matches work
      */
-    orWhereJson(column: ModelKey<T>, value: JsonParam): this;
-    orWhereJson(column: string, value: JsonParam): this;
+    orWhereJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT contain the given value.
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    whereJsonNotContains(column: ModelKey<T>, value: JsonParam): this;
-    whereJsonNotContains(column: string, value: JsonParam): this;
+    whereJsonNotContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT contain the given value (AND).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    andWhereJsonNotContains(column: ModelKey<T>, value: JsonParam): this;
-    andWhereJsonNotContains(column: string, value: JsonParam): this;
+    andWhereJsonNotContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT contain the given value (OR).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    orWhereJsonNotContains(column: ModelKey<T>, value: JsonParam): this;
-    orWhereJsonNotContains(column: string, value: JsonParam): this;
+    orWhereJsonNotContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column contains the given value.
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    whereJsonContains(column: ModelKey<T>, value: JsonParam): this;
-    whereJsonContains(column: string, value: JsonParam): this;
+    whereJsonContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column contains the given value (AND).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    andWhereJsonContains(column: ModelKey<T>, value: JsonParam): this;
-    andWhereJsonContains(column: string, value: JsonParam): this;
+    andWhereJsonContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column contains the given value (OR).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    orWhereJsonContains(column: ModelKey<T>, value: JsonParam): this;
-    orWhereJsonContains(column: string, value: JsonParam): this;
+    orWhereJsonContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT match the given value.
      */
-    whereNotJson(column: ModelKey<T>, value: JsonParam): this;
-    whereNotJson(column: string, value: JsonParam): this;
+    whereNotJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT match the given value (AND).
      */
-    andWhereNotJson(column: ModelKey<T>, value: JsonParam): this;
-    andWhereNotJson(column: string, value: JsonParam): this;
+    andWhereNotJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT match the given value (OR).
      */
-    orWhereNotJson(column: ModelKey<T>, value: JsonParam): this;
-    orWhereNotJson(column: string, value: JsonParam): this;
+    orWhereNotJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Add a raw JSON filter expression.
      */
@@ -4699,6 +4689,7 @@ declare class Transaction {
 
 type Operation = "SELECT" | "INSERT" | "UPDATE" | "DELETE" | "OTHER";
 interface QueryContext {
+    id: string;
     sql: string;
     params: any[];
     model?: any;
@@ -4837,6 +4828,10 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Cached AdminJS instance
      */
     private adminJsInstance?;
+    /**
+     * @description Optional zod instance for schema generation
+     */
+    zodEngine: typeof z | null;
     /**
      * @description Callback to handle slave server failures
      */
@@ -5127,6 +5122,11 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Returns the AdminJS configuration options
      */
     getAdminJsOptions(): AdminJsOptions | undefined;
+    /**
+     * @description Loads the zod engine into the data source
+     * @param zod The zod namespace import
+     */
+    loadZodEngine(zod: typeof z): this;
     /**
      * @description Checks if AdminJS is enabled
      */
@@ -6506,6 +6506,10 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
  */
 declare abstract class Model<T extends Model<T> = any> extends Entity {
     private "*";
+    /**
+     * @description The zod instance to use for creating zod schemas, if not set, toZodSchema will throw an error
+     */
+    static zodEngine: typeof z | null;
     /**
      * @description The column used to soft delete a record, default is deletedAt
      */
@@ -7105,6 +7109,14 @@ type DefinedModel<T extends string, C extends Record<string, ColumnDef>, R exten
     beforeDelete?: (queryBuilder: ModelQueryBuilder<{
         readonly __tableName: T;
     } & InferColumns<C> & Model>) => Promise<void> | void;
+    /**
+     * Translates the model definition to a Zod schema.
+     * @throws {HysteriaError} If the zod engine is not loaded. Call `sql.loadZodEngine(z)` first.
+     * @returns A ZodObject representing the model's columns.
+     */
+    toZodSchema(): z.ZodObject<{
+        [K in keyof C]: z.ZodType<InferColumns<C>[K]>;
+    }>;
 } & ModelColumns<T, C>;
 /**
  * Maps a model's column definitions to their fully-qualified `"table.column"`
@@ -7255,6 +7267,14 @@ type HiddenViewStatics = HiddenModelStatics;
 type DefinedView<T extends string, C extends Record<string, ColumnDef>> = Omit<ConcreteModelStatics, HiddenViewStatics> & {
     readonly table: T;
     new (): InferModel<T, C, {}> & Model;
+    /**
+     * Translates the model definition to a Zod schema.
+     * @throws {HysteriaError} If the zod engine is not loaded. Call `sql.loadZodEngine(z)` first.
+     * @returns A ZodObject representing the model's columns.
+     */
+    toZodSchema(): z.ZodObject<{
+        [K in keyof C]: z.ZodType<InferColumns<C>[K]>;
+    }>;
 } & ModelColumns<T, C>;
 
 declare const col: ColNamespace;
@@ -7333,10 +7353,9 @@ declare function createSchema<M extends Record<string, AnyModelConstructor>, R e
     [K in keyof M]?: RelationDefinitions<any, any>;
 }>(models: M, relations?: R): CreateSchemaResult<M, R>;
 /**
- * Creates a fully-typed read-only Model subclass backed by a SQL view.
- *
  * The returned class works with `sql.from(View).many()` and other read operations.
  * Mutation operations (insert, update, delete) are not intended for views.
+ * Does not create a real database view, this is just a shortcut for common query results
  *
  * @example
  * ```typescript
@@ -7986,7 +8005,7 @@ declare abstract class BaseSeeder {
     abstract run(): Promise<void>;
 }
 
-type HysteriaErrorCode = "VALIDATION_ERROR" | "CONNECTION_ALREADY_ESTABLISHED" | `UNSUPPORTED_ISOLATION_LEVEL_${string}` | "ROW_NOT_FOUND" | `UNSUPPORTED_DATABASE_TYPE_${string}` | `RELATION_TYPE_NOT_SUPPORTED_${string}` | `NOT_SUPPORTED_IN_${string}` | `RELATION_NOT_FOUND_IN_MODEL_${string}` | `UNKNOWN_RELATION_TYPE_${string}` | `DISTINCT_ON_NOT_SUPPORTED_IN_${string}` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_HAS_ONE_RELATION_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_BELONGS_TO_RELATION_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_HAS_MANY_RELATION_${string}` | `MANY_TO_MANY_RELATION_NOT_FOUND_FOR_RELATED_MODEL_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_MANY_TO_MANY_RELATION_${string}` | `RELATED_MODEL_DOES_NOT_HAVE_A_PRIMARY_KEY_${string}` | `FOR_SHARE_NOT_SUPPORTED_IN_${string}` | `SKIP_LOCKED_NOT_SUPPORTED_IN_${string}` | `LOCK_FOR_UPDATE_NOT_SUPPORTED_${string}` | `KEY_${string}_HAS_NO_HANDLER_IN_CACHE_KEYS_CONFIG` | `CACHE_ADAPTER_NOT_CONFIGURED` | `SQLITE_NOT_SUPPORTED` | `COCKROACHDB_NOT_SUPPORTED` | `RELATION_NOT_FOUND` | `POSTGRES_TABLE_REQUIRED` | `MODEL_HAS_NO_PRIMARY_KEY_VALUE` | `RELATION_NOT_MANY_TO_MANY` | "MATERIALIZED_CTE_NOT_SUPPORTED" | "DUPLICATE_MODEL_KEYS_WHILE_INSTANTIATING_MODELS" | "INVALID_ONE_PARAMETER_WHERE_CONDITION" | "INVALID_PAGINATION_PARAMETERS" | "MISSING_ALIAS_FOR_SUBQUERY" | "MODEL_HAS_NO_PRIMARY_KEY" | "PRIMARY_KEY_NOT_FOUND" | "SQLITE_ONLY_SUPPORTS_SERIALIZABLE_ISOLATION_LEVEL" | "MUST_CALL_BUILD_CTE_AT_LEAST_ONCE" | "REGEXP_NOT_SUPPORTED_IN_SQLITE" | "MANY_TO_MANY_RELATION_MUST_HAVE_A_THROUGH_MODEL" | "INSERT_FAILED" | "MULTIPLE_PRIMARY_KEYS_NOT_ALLOWED" | "FILE_NOT_A_SQL_OR_TXT_FILE" | "CONNECTION_NOT_ESTABLISHED" | "TRANSACTION_NOT_ACTIVE" | "DEVELOPMENT_ERROR" | "MIGRATION_MODULE_NOT_FOUND" | "DRIVER_NOT_FOUND" | "FILE_NOT_FOUND_OR_NOT_ACCESSIBLE" | "ENV_NOT_SET" | "REQUIRED_VALUE_NOT_SET" | "SET_FAILED" | "GET_FAILED" | "REFERENCES_OPTION_REQUIRED" | "DELETE_FAILED" | "INVALID_DEFAULT_VALUE" | "DISCONNECT_FAILED" | "FLUSH_FAILED" | "LEFT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "RIGHT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "MODEL_HAS_NO_PRIMARY_KEY" | "GLOBAL_TRANSACTION_ALREADY_STARTED" | "GLOBAL_TRANSACTION_NOT_STARTED" | "MYSQL_REQUIRES_TABLE_NAME_FOR_INDEX_DROP" | "INVALID_DATE_OBJECT" | "INVALID_DATE_STRING" | "FAILED_TO_PARSE_DATE" | "MIGRATION_MODULE_REQUIRES_TS_NODE" | "FAILED_TO_ENCRYPT_SYMMETRICALLY" | "FAILED_TO_DECRYPT_SYMMETRICALLY" | "FAILED_TO_ENCRYPT_ASYMMETRICALLY" | "FAILED_TO_DECRYPT_ASYMMETRICALLY" | "UNSUPPORTED_RELATION_TYPE" | "LPUSH_FAILED" | "RPUSH_FAILED" | "LPOP_FAILED" | "RPOP_FAILED" | "LRANGE_FAILED" | "LLEN_FAILED" | "HSET_FAILED" | "HMSET_FAILED" | "HGET_FAILED" | "HGETALL_FAILED" | "HMGET_FAILED" | "HDEL_FAILED" | "HEXISTS_FAILED" | "HKEYS_FAILED" | "HLEN_FAILED" | "SADD_FAILED" | "SMEMBERS_FAILED" | "SREM_FAILED" | "SISMEMBER_FAILED" | "SCARD_FAILED" | "SINTER_FAILED" | "SUNION_FAILED" | "SDIFF_FAILED" | "ZADD_FAILED" | "ZRANGE_FAILED" | "ZREVRANGE_FAILED" | "ZREM_FAILED" | "ZSCORE_FAILED" | "ZCARD_FAILED" | "SUBSCRIBE_FAILED" | "UNSUBSCRIBE_FAILED" | "PUBLISH_FAILED" | "PSUBSCRIBE_FAILED" | "PUNSUBSCRIBE_FAILED" | "EXISTS_FAILED" | "EXPIRE_FAILED" | "EXPIREAT_FAILED" | "PEXPIRE_FAILED" | "TTL_FAILED" | "PTTL_FAILED" | "PERSIST_FAILED" | "KEYS_FAILED" | "RENAME_FAILED" | "TYPE_FAILED" | "SCAN_FAILED" | "ADMINJS_NOT_ENABLED" | "ADMINJS_INITIALIZATION_FAILED" | "ADMINJS_NO_MODELS_PROVIDED" | `SCOPE_NOT_FOUND_${string}`;
+type HysteriaErrorCode = "VALIDATION_ERROR" | "CONNECTION_ALREADY_ESTABLISHED" | `UNSUPPORTED_ISOLATION_LEVEL_${string}` | "ROW_NOT_FOUND" | `UNSUPPORTED_DATABASE_TYPE_${string}` | `RELATION_TYPE_NOT_SUPPORTED_${string}` | `NOT_SUPPORTED_IN_${string}` | `RELATION_NOT_FOUND_IN_MODEL_${string}` | `UNKNOWN_RELATION_TYPE_${string}` | `DISTINCT_ON_NOT_SUPPORTED_IN_${string}` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_HAS_ONE_RELATION_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_BELONGS_TO_RELATION_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_HAS_MANY_RELATION_${string}` | `MANY_TO_MANY_RELATION_NOT_FOUND_FOR_RELATED_MODEL_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_MANY_TO_MANY_RELATION_${string}` | `RELATED_MODEL_DOES_NOT_HAVE_A_PRIMARY_KEY_${string}` | `FOR_SHARE_NOT_SUPPORTED_IN_${string}` | `SKIP_LOCKED_NOT_SUPPORTED_IN_${string}` | `LOCK_FOR_UPDATE_NOT_SUPPORTED_${string}` | `KEY_${string}_HAS_NO_HANDLER_IN_CACHE_KEYS_CONFIG` | `CACHE_ADAPTER_NOT_CONFIGURED` | `SQLITE_NOT_SUPPORTED` | `COCKROACHDB_NOT_SUPPORTED` | `RELATION_NOT_FOUND` | `POSTGRES_TABLE_REQUIRED` | `MODEL_HAS_NO_PRIMARY_KEY_VALUE` | `RELATION_NOT_MANY_TO_MANY` | "MATERIALIZED_CTE_NOT_SUPPORTED" | "DUPLICATE_MODEL_KEYS_WHILE_INSTANTIATING_MODELS" | "INVALID_ONE_PARAMETER_WHERE_CONDITION" | "INVALID_PAGINATION_PARAMETERS" | "MISSING_ALIAS_FOR_SUBQUERY" | "MODEL_HAS_NO_PRIMARY_KEY" | "PRIMARY_KEY_NOT_FOUND" | "SQLITE_ONLY_SUPPORTS_SERIALIZABLE_ISOLATION_LEVEL" | "MUST_CALL_BUILD_CTE_AT_LEAST_ONCE" | "REGEXP_NOT_SUPPORTED_IN_SQLITE" | "MANY_TO_MANY_RELATION_MUST_HAVE_A_THROUGH_MODEL" | "INSERT_FAILED" | "MULTIPLE_PRIMARY_KEYS_NOT_ALLOWED" | "FILE_NOT_A_SQL_OR_TXT_FILE" | "CONNECTION_NOT_ESTABLISHED" | "TRANSACTION_NOT_ACTIVE" | "DEVELOPMENT_ERROR" | "MIGRATION_MODULE_NOT_FOUND" | "DRIVER_NOT_FOUND" | "FILE_NOT_FOUND_OR_NOT_ACCESSIBLE" | "ENV_NOT_SET" | "REQUIRED_VALUE_NOT_SET" | "SET_FAILED" | "GET_FAILED" | "REFERENCES_OPTION_REQUIRED" | "DELETE_FAILED" | "INVALID_DEFAULT_VALUE" | "DISCONNECT_FAILED" | "FLUSH_FAILED" | "LEFT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "RIGHT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "MODEL_HAS_NO_PRIMARY_KEY" | "GLOBAL_TRANSACTION_ALREADY_STARTED" | "GLOBAL_TRANSACTION_NOT_STARTED" | "MYSQL_REQUIRES_TABLE_NAME_FOR_INDEX_DROP" | "INVALID_DATE_OBJECT" | "INVALID_DATE_STRING" | "FAILED_TO_PARSE_DATE" | "MIGRATION_MODULE_REQUIRES_TS_NODE" | "FAILED_TO_ENCRYPT_SYMMETRICALLY" | "FAILED_TO_DECRYPT_SYMMETRICALLY" | "FAILED_TO_ENCRYPT_ASYMMETRICALLY" | "FAILED_TO_DECRYPT_ASYMMETRICALLY" | "UNSUPPORTED_RELATION_TYPE" | "LPUSH_FAILED" | "RPUSH_FAILED" | "LPOP_FAILED" | "RPOP_FAILED" | "LRANGE_FAILED" | "LLEN_FAILED" | "HSET_FAILED" | "HMSET_FAILED" | "HGET_FAILED" | "HGETALL_FAILED" | "HMGET_FAILED" | "HDEL_FAILED" | "HEXISTS_FAILED" | "HKEYS_FAILED" | "HLEN_FAILED" | "SADD_FAILED" | "SMEMBERS_FAILED" | "SREM_FAILED" | "SISMEMBER_FAILED" | "SCARD_FAILED" | "SINTER_FAILED" | "SUNION_FAILED" | "SDIFF_FAILED" | "ZADD_FAILED" | "ZRANGE_FAILED" | "ZREVRANGE_FAILED" | "ZREM_FAILED" | "ZSCORE_FAILED" | "ZCARD_FAILED" | "SUBSCRIBE_FAILED" | "UNSUBSCRIBE_FAILED" | "PUBLISH_FAILED" | "PSUBSCRIBE_FAILED" | "PUNSUBSCRIBE_FAILED" | "EXISTS_FAILED" | "EXPIRE_FAILED" | "EXPIREAT_FAILED" | "PEXPIRE_FAILED" | "TTL_FAILED" | "PTTL_FAILED" | "PERSIST_FAILED" | "KEYS_FAILED" | "RENAME_FAILED" | "TYPE_FAILED" | "SCAN_FAILED" | "ADMINJS_NOT_ENABLED" | "ADMINJS_INITIALIZATION_FAILED" | "ADMINJS_NO_MODELS_PROVIDED" | "ZOD_ENGINE_NOT_LOADED" | `SCOPE_NOT_FOUND_${string}`;
 
 declare class HysteriaError extends Error {
     code: HysteriaErrorCode;

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+import { z } from 'zod';
 import { PassThrough } from 'node:stream';
 import * as mssql from 'mssql';
 import { config, Transaction as Transaction$1, IResult } from 'mssql';
@@ -4082,82 +4083,71 @@ declare abstract class WhereQueryBuilder<T extends Model, S extends Record<strin
     private orWhereGroup;
 }
 
-type JsonParam = Record<string, unknown> | any[];
+type DefaultJsonParam = Record<string, any> | any[];
+type JsonValueForColumn<T extends Model, K extends string> = K extends ModelKey<T> ? NonNullable<T[StripTablePrefix<K> & keyof T]> : DefaultJsonParam;
 declare class JsonQueryBuilder<T extends Model, S extends Record<string, any> = Record<string, any>> extends WhereQueryBuilder<T, S> {
     /**
      * @description Filters records matching exact JSON value.
      */
-    whereJson(column: ModelKey<T>, value: JsonParam): this;
-    whereJson(column: string, value: JsonParam): this;
+    whereJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records matching the given JSON value.
      * @mssql Partial JSON matching not supported - only exact matches work
      */
-    andWhereJson(column: ModelKey<T>, value: JsonParam): this;
-    andWhereJson(column: string, value: JsonParam): this;
+    andWhereJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records matching the given JSON value.
      * @mssql Partial JSON matching not supported - only exact matches work
      */
-    orWhereJson(column: ModelKey<T>, value: JsonParam): this;
-    orWhereJson(column: string, value: JsonParam): this;
+    orWhereJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT contain the given value.
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    whereJsonNotContains(column: ModelKey<T>, value: JsonParam): this;
-    whereJsonNotContains(column: string, value: JsonParam): this;
+    whereJsonNotContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT contain the given value (AND).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    andWhereJsonNotContains(column: ModelKey<T>, value: JsonParam): this;
-    andWhereJsonNotContains(column: string, value: JsonParam): this;
+    andWhereJsonNotContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT contain the given value (OR).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    orWhereJsonNotContains(column: ModelKey<T>, value: JsonParam): this;
-    orWhereJsonNotContains(column: string, value: JsonParam): this;
+    orWhereJsonNotContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column contains the given value.
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    whereJsonContains(column: ModelKey<T>, value: JsonParam): this;
-    whereJsonContains(column: string, value: JsonParam): this;
+    whereJsonContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column contains the given value (AND).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    andWhereJsonContains(column: ModelKey<T>, value: JsonParam): this;
-    andWhereJsonContains(column: string, value: JsonParam): this;
+    andWhereJsonContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column contains the given value (OR).
      * @sqlite might not work for all cases, suggest using the whereJsonRaw method instead
      * @mssql not supported - CHARINDEX cannot do partial JSON containment
      */
-    orWhereJsonContains(column: ModelKey<T>, value: JsonParam): this;
-    orWhereJsonContains(column: string, value: JsonParam): this;
+    orWhereJsonContains<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT match the given value.
      */
-    whereNotJson(column: ModelKey<T>, value: JsonParam): this;
-    whereNotJson(column: string, value: JsonParam): this;
+    whereNotJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT match the given value (AND).
      */
-    andWhereNotJson(column: ModelKey<T>, value: JsonParam): this;
-    andWhereNotJson(column: string, value: JsonParam): this;
+    andWhereNotJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Filters records where JSON column does NOT match the given value (OR).
      */
-    orWhereNotJson(column: ModelKey<T>, value: JsonParam): this;
-    orWhereNotJson(column: string, value: JsonParam): this;
+    orWhereNotJson<K extends string>(column: K, value: JsonValueForColumn<T, K>): this;
     /**
      * @description Add a raw JSON filter expression.
      */
@@ -4699,6 +4689,7 @@ declare class Transaction {
 
 type Operation = "SELECT" | "INSERT" | "UPDATE" | "DELETE" | "OTHER";
 interface QueryContext {
+    id: string;
     sql: string;
     params: any[];
     model?: any;
@@ -4837,6 +4828,10 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Cached AdminJS instance
      */
     private adminJsInstance?;
+    /**
+     * @description Optional zod instance for schema generation
+     */
+    zodEngine: typeof z | null;
     /**
      * @description Callback to handle slave server failures
      */
@@ -5127,6 +5122,11 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description Returns the AdminJS configuration options
      */
     getAdminJsOptions(): AdminJsOptions | undefined;
+    /**
+     * @description Loads the zod engine into the data source
+     * @param zod The zod namespace import
+     */
+    loadZodEngine(zod: typeof z): this;
     /**
      * @description Checks if AdminJS is enabled
      */
@@ -6506,6 +6506,10 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
  */
 declare abstract class Model<T extends Model<T> = any> extends Entity {
     private "*";
+    /**
+     * @description The zod instance to use for creating zod schemas, if not set, toZodSchema will throw an error
+     */
+    static zodEngine: typeof z | null;
     /**
      * @description The column used to soft delete a record, default is deletedAt
      */
@@ -7105,6 +7109,14 @@ type DefinedModel<T extends string, C extends Record<string, ColumnDef>, R exten
     beforeDelete?: (queryBuilder: ModelQueryBuilder<{
         readonly __tableName: T;
     } & InferColumns<C> & Model>) => Promise<void> | void;
+    /**
+     * Translates the model definition to a Zod schema.
+     * @throws {HysteriaError} If the zod engine is not loaded. Call `sql.loadZodEngine(z)` first.
+     * @returns A ZodObject representing the model's columns.
+     */
+    toZodSchema(): z.ZodObject<{
+        [K in keyof C]: z.ZodType<InferColumns<C>[K]>;
+    }>;
 } & ModelColumns<T, C>;
 /**
  * Maps a model's column definitions to their fully-qualified `"table.column"`
@@ -7255,6 +7267,14 @@ type HiddenViewStatics = HiddenModelStatics;
 type DefinedView<T extends string, C extends Record<string, ColumnDef>> = Omit<ConcreteModelStatics, HiddenViewStatics> & {
     readonly table: T;
     new (): InferModel<T, C, {}> & Model;
+    /**
+     * Translates the model definition to a Zod schema.
+     * @throws {HysteriaError} If the zod engine is not loaded. Call `sql.loadZodEngine(z)` first.
+     * @returns A ZodObject representing the model's columns.
+     */
+    toZodSchema(): z.ZodObject<{
+        [K in keyof C]: z.ZodType<InferColumns<C>[K]>;
+    }>;
 } & ModelColumns<T, C>;
 
 declare const col: ColNamespace;
@@ -7333,10 +7353,9 @@ declare function createSchema<M extends Record<string, AnyModelConstructor>, R e
     [K in keyof M]?: RelationDefinitions<any, any>;
 }>(models: M, relations?: R): CreateSchemaResult<M, R>;
 /**
- * Creates a fully-typed read-only Model subclass backed by a SQL view.
- *
  * The returned class works with `sql.from(View).many()` and other read operations.
  * Mutation operations (insert, update, delete) are not intended for views.
+ * Does not create a real database view, this is just a shortcut for common query results
  *
  * @example
  * ```typescript
@@ -7986,7 +8005,7 @@ declare abstract class BaseSeeder {
     abstract run(): Promise<void>;
 }
 
-type HysteriaErrorCode = "VALIDATION_ERROR" | "CONNECTION_ALREADY_ESTABLISHED" | `UNSUPPORTED_ISOLATION_LEVEL_${string}` | "ROW_NOT_FOUND" | `UNSUPPORTED_DATABASE_TYPE_${string}` | `RELATION_TYPE_NOT_SUPPORTED_${string}` | `NOT_SUPPORTED_IN_${string}` | `RELATION_NOT_FOUND_IN_MODEL_${string}` | `UNKNOWN_RELATION_TYPE_${string}` | `DISTINCT_ON_NOT_SUPPORTED_IN_${string}` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_HAS_ONE_RELATION_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_BELONGS_TO_RELATION_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_HAS_MANY_RELATION_${string}` | `MANY_TO_MANY_RELATION_NOT_FOUND_FOR_RELATED_MODEL_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_MANY_TO_MANY_RELATION_${string}` | `RELATED_MODEL_DOES_NOT_HAVE_A_PRIMARY_KEY_${string}` | `FOR_SHARE_NOT_SUPPORTED_IN_${string}` | `SKIP_LOCKED_NOT_SUPPORTED_IN_${string}` | `LOCK_FOR_UPDATE_NOT_SUPPORTED_${string}` | `KEY_${string}_HAS_NO_HANDLER_IN_CACHE_KEYS_CONFIG` | `CACHE_ADAPTER_NOT_CONFIGURED` | `SQLITE_NOT_SUPPORTED` | `COCKROACHDB_NOT_SUPPORTED` | `RELATION_NOT_FOUND` | `POSTGRES_TABLE_REQUIRED` | `MODEL_HAS_NO_PRIMARY_KEY_VALUE` | `RELATION_NOT_MANY_TO_MANY` | "MATERIALIZED_CTE_NOT_SUPPORTED" | "DUPLICATE_MODEL_KEYS_WHILE_INSTANTIATING_MODELS" | "INVALID_ONE_PARAMETER_WHERE_CONDITION" | "INVALID_PAGINATION_PARAMETERS" | "MISSING_ALIAS_FOR_SUBQUERY" | "MODEL_HAS_NO_PRIMARY_KEY" | "PRIMARY_KEY_NOT_FOUND" | "SQLITE_ONLY_SUPPORTS_SERIALIZABLE_ISOLATION_LEVEL" | "MUST_CALL_BUILD_CTE_AT_LEAST_ONCE" | "REGEXP_NOT_SUPPORTED_IN_SQLITE" | "MANY_TO_MANY_RELATION_MUST_HAVE_A_THROUGH_MODEL" | "INSERT_FAILED" | "MULTIPLE_PRIMARY_KEYS_NOT_ALLOWED" | "FILE_NOT_A_SQL_OR_TXT_FILE" | "CONNECTION_NOT_ESTABLISHED" | "TRANSACTION_NOT_ACTIVE" | "DEVELOPMENT_ERROR" | "MIGRATION_MODULE_NOT_FOUND" | "DRIVER_NOT_FOUND" | "FILE_NOT_FOUND_OR_NOT_ACCESSIBLE" | "ENV_NOT_SET" | "REQUIRED_VALUE_NOT_SET" | "SET_FAILED" | "GET_FAILED" | "REFERENCES_OPTION_REQUIRED" | "DELETE_FAILED" | "INVALID_DEFAULT_VALUE" | "DISCONNECT_FAILED" | "FLUSH_FAILED" | "LEFT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "RIGHT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "MODEL_HAS_NO_PRIMARY_KEY" | "GLOBAL_TRANSACTION_ALREADY_STARTED" | "GLOBAL_TRANSACTION_NOT_STARTED" | "MYSQL_REQUIRES_TABLE_NAME_FOR_INDEX_DROP" | "INVALID_DATE_OBJECT" | "INVALID_DATE_STRING" | "FAILED_TO_PARSE_DATE" | "MIGRATION_MODULE_REQUIRES_TS_NODE" | "FAILED_TO_ENCRYPT_SYMMETRICALLY" | "FAILED_TO_DECRYPT_SYMMETRICALLY" | "FAILED_TO_ENCRYPT_ASYMMETRICALLY" | "FAILED_TO_DECRYPT_ASYMMETRICALLY" | "UNSUPPORTED_RELATION_TYPE" | "LPUSH_FAILED" | "RPUSH_FAILED" | "LPOP_FAILED" | "RPOP_FAILED" | "LRANGE_FAILED" | "LLEN_FAILED" | "HSET_FAILED" | "HMSET_FAILED" | "HGET_FAILED" | "HGETALL_FAILED" | "HMGET_FAILED" | "HDEL_FAILED" | "HEXISTS_FAILED" | "HKEYS_FAILED" | "HLEN_FAILED" | "SADD_FAILED" | "SMEMBERS_FAILED" | "SREM_FAILED" | "SISMEMBER_FAILED" | "SCARD_FAILED" | "SINTER_FAILED" | "SUNION_FAILED" | "SDIFF_FAILED" | "ZADD_FAILED" | "ZRANGE_FAILED" | "ZREVRANGE_FAILED" | "ZREM_FAILED" | "ZSCORE_FAILED" | "ZCARD_FAILED" | "SUBSCRIBE_FAILED" | "UNSUBSCRIBE_FAILED" | "PUBLISH_FAILED" | "PSUBSCRIBE_FAILED" | "PUNSUBSCRIBE_FAILED" | "EXISTS_FAILED" | "EXPIRE_FAILED" | "EXPIREAT_FAILED" | "PEXPIRE_FAILED" | "TTL_FAILED" | "PTTL_FAILED" | "PERSIST_FAILED" | "KEYS_FAILED" | "RENAME_FAILED" | "TYPE_FAILED" | "SCAN_FAILED" | "ADMINJS_NOT_ENABLED" | "ADMINJS_INITIALIZATION_FAILED" | "ADMINJS_NO_MODELS_PROVIDED" | `SCOPE_NOT_FOUND_${string}`;
+type HysteriaErrorCode = "VALIDATION_ERROR" | "CONNECTION_ALREADY_ESTABLISHED" | `UNSUPPORTED_ISOLATION_LEVEL_${string}` | "ROW_NOT_FOUND" | `UNSUPPORTED_DATABASE_TYPE_${string}` | `RELATION_TYPE_NOT_SUPPORTED_${string}` | `NOT_SUPPORTED_IN_${string}` | `RELATION_NOT_FOUND_IN_MODEL_${string}` | `UNKNOWN_RELATION_TYPE_${string}` | `DISTINCT_ON_NOT_SUPPORTED_IN_${string}` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA` | `CONFLICT_COLUMNS_NOT_PRESENT_IN_DATA_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_HAS_ONE_RELATION_${string}` | `FOREIGN_KEY_VALUES_MISSING_FOR_BELONGS_TO_RELATION_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_HAS_MANY_RELATION_${string}` | `MANY_TO_MANY_RELATION_NOT_FOUND_FOR_RELATED_MODEL_${string}` | `PRIMARY_KEY_VALUES_MISSING_FOR_MANY_TO_MANY_RELATION_${string}` | `RELATED_MODEL_DOES_NOT_HAVE_A_PRIMARY_KEY_${string}` | `FOR_SHARE_NOT_SUPPORTED_IN_${string}` | `SKIP_LOCKED_NOT_SUPPORTED_IN_${string}` | `LOCK_FOR_UPDATE_NOT_SUPPORTED_${string}` | `KEY_${string}_HAS_NO_HANDLER_IN_CACHE_KEYS_CONFIG` | `CACHE_ADAPTER_NOT_CONFIGURED` | `SQLITE_NOT_SUPPORTED` | `COCKROACHDB_NOT_SUPPORTED` | `RELATION_NOT_FOUND` | `POSTGRES_TABLE_REQUIRED` | `MODEL_HAS_NO_PRIMARY_KEY_VALUE` | `RELATION_NOT_MANY_TO_MANY` | "MATERIALIZED_CTE_NOT_SUPPORTED" | "DUPLICATE_MODEL_KEYS_WHILE_INSTANTIATING_MODELS" | "INVALID_ONE_PARAMETER_WHERE_CONDITION" | "INVALID_PAGINATION_PARAMETERS" | "MISSING_ALIAS_FOR_SUBQUERY" | "MODEL_HAS_NO_PRIMARY_KEY" | "PRIMARY_KEY_NOT_FOUND" | "SQLITE_ONLY_SUPPORTS_SERIALIZABLE_ISOLATION_LEVEL" | "MUST_CALL_BUILD_CTE_AT_LEAST_ONCE" | "REGEXP_NOT_SUPPORTED_IN_SQLITE" | "MANY_TO_MANY_RELATION_MUST_HAVE_A_THROUGH_MODEL" | "INSERT_FAILED" | "MULTIPLE_PRIMARY_KEYS_NOT_ALLOWED" | "FILE_NOT_A_SQL_OR_TXT_FILE" | "CONNECTION_NOT_ESTABLISHED" | "TRANSACTION_NOT_ACTIVE" | "DEVELOPMENT_ERROR" | "MIGRATION_MODULE_NOT_FOUND" | "DRIVER_NOT_FOUND" | "FILE_NOT_FOUND_OR_NOT_ACCESSIBLE" | "ENV_NOT_SET" | "REQUIRED_VALUE_NOT_SET" | "SET_FAILED" | "GET_FAILED" | "REFERENCES_OPTION_REQUIRED" | "DELETE_FAILED" | "INVALID_DEFAULT_VALUE" | "DISCONNECT_FAILED" | "FLUSH_FAILED" | "LEFT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "RIGHT_COLUMN_NOT_PROVIDED_FOR_JOIN" | "MODEL_HAS_NO_PRIMARY_KEY" | "GLOBAL_TRANSACTION_ALREADY_STARTED" | "GLOBAL_TRANSACTION_NOT_STARTED" | "MYSQL_REQUIRES_TABLE_NAME_FOR_INDEX_DROP" | "INVALID_DATE_OBJECT" | "INVALID_DATE_STRING" | "FAILED_TO_PARSE_DATE" | "MIGRATION_MODULE_REQUIRES_TS_NODE" | "FAILED_TO_ENCRYPT_SYMMETRICALLY" | "FAILED_TO_DECRYPT_SYMMETRICALLY" | "FAILED_TO_ENCRYPT_ASYMMETRICALLY" | "FAILED_TO_DECRYPT_ASYMMETRICALLY" | "UNSUPPORTED_RELATION_TYPE" | "LPUSH_FAILED" | "RPUSH_FAILED" | "LPOP_FAILED" | "RPOP_FAILED" | "LRANGE_FAILED" | "LLEN_FAILED" | "HSET_FAILED" | "HMSET_FAILED" | "HGET_FAILED" | "HGETALL_FAILED" | "HMGET_FAILED" | "HDEL_FAILED" | "HEXISTS_FAILED" | "HKEYS_FAILED" | "HLEN_FAILED" | "SADD_FAILED" | "SMEMBERS_FAILED" | "SREM_FAILED" | "SISMEMBER_FAILED" | "SCARD_FAILED" | "SINTER_FAILED" | "SUNION_FAILED" | "SDIFF_FAILED" | "ZADD_FAILED" | "ZRANGE_FAILED" | "ZREVRANGE_FAILED" | "ZREM_FAILED" | "ZSCORE_FAILED" | "ZCARD_FAILED" | "SUBSCRIBE_FAILED" | "UNSUBSCRIBE_FAILED" | "PUBLISH_FAILED" | "PSUBSCRIBE_FAILED" | "PUNSUBSCRIBE_FAILED" | "EXISTS_FAILED" | "EXPIRE_FAILED" | "EXPIREAT_FAILED" | "PEXPIRE_FAILED" | "TTL_FAILED" | "PTTL_FAILED" | "PERSIST_FAILED" | "KEYS_FAILED" | "RENAME_FAILED" | "TYPE_FAILED" | "SCAN_FAILED" | "ADMINJS_NOT_ENABLED" | "ADMINJS_INITIALIZATION_FAILED" | "ADMINJS_NO_MODELS_PROVIDED" | "ZOD_ENGINE_NOT_LOADED" | `SCOPE_NOT_FOUND_${string}`;
 
 declare class HysteriaError extends Error {
     code: HysteriaErrorCode;