hysteria-orm 10.4.5 → 10.4.7

package/lib/index.d.cts

@@ -2323,11 +2323,12 @@ declare class JoinNode extends QueryNode {
     folder: string;
     file: string;
     type: "inner" | "left" | "right" | "full" | "cross" | "natural";
+    additionalConditions?: (WhereNode | WhereGroupNode | WhereSubqueryNode)[];
     constructor(table: string, left: string, right: string, type: "inner" | "left" | "right" | "full" | "cross" | "natural" | undefined, on: {
         left?: string;
         right?: string;
         operator: string;
-    }, isRawValue?: boolean);
+    }, isRawValue?: boolean, additionalConditions?: (WhereNode | WhereGroupNode | WhereSubqueryNode)[]);
 }
 
 declare class GroupByNode extends QueryNode {
@@ -2651,6 +2652,222 @@ declare abstract class FooterQueryBuilder<T extends Model> {
     offset(offset: number): this;
 }
 
+declare class JoinOnQueryBuilder {
+    protected sqlDataSource: SqlDataSource;
+    protected whereNodes: (WhereNode | WhereGroupNode | WhereSubqueryNode)[];
+    protected isNestedCondition: boolean;
+    constructor(sqlDataSource: SqlDataSource, isNestedCondition?: boolean);
+    /**
+     * @description Get the where conditions for the join
+     */
+    getConditions(): (WhereNode | WhereGroupNode | WhereSubqueryNode)[];
+    /**
+     * @description Adds a WHERE condition to the query.
+     */
+    where(column: SelectableColumn<string>, operator: BinaryOperatorType, value: BaseValues): this;
+    where(cb: (queryBuilder: JoinOnQueryBuilder) => void): this;
+    where(column: SelectableColumn<string>, value: BaseValues): this;
+    /**
+     * @description Adds an AND WHERE condition to the query.
+     */
+    andWhere(column: SelectableColumn<string>, operator: BinaryOperatorType, value: BaseValues): this;
+    andWhere(column: SelectableColumn<string>, value: BaseValues): this;
+    andWhere(cb: (queryBuilder: JoinOnQueryBuilder) => void): this;
+    /**
+     * @description Adds an OR WHERE condition to the query.
+     */
+    orWhere(column: SelectableColumn<string>, operator: BinaryOperatorType, value: BaseValues): this;
+    orWhere(column: SelectableColumn<string>, value: BaseValues): this;
+    orWhere(cb: (queryBuilder: JoinOnQueryBuilder) => void): this;
+    /**
+     * @description Adds a negated WHERE condition to the query.
+     */
+    whereNot(column: SelectableColumn<string>, operator: BinaryOperatorType, value: BaseValues): this;
+    whereNot(column: SelectableColumn<string>, value: BaseValues): this;
+    /**
+     * @description Adds a negated AND WHERE condition to the query.
+     */
+    andWhereNot(column: SelectableColumn<string>, operator: BinaryOperatorType, value: BaseValues): this;
+    andWhereNot(column: SelectableColumn<string>, value: BaseValues): this;
+    /**
+     * @description Adds a negated OR WHERE condition to the query.
+     */
+    orWhereNot(column: SelectableColumn<string>, operator: BinaryOperatorType, value: BaseValues): this;
+    orWhereNot(column: SelectableColumn<string>, value: BaseValues): this;
+    /**
+     * @description Adds a WHERE BETWEEN condition to the query.
+     */
+    whereBetween(column: SelectableColumn<string>, min: BaseValues, max: BaseValues): this;
+    /**
+     * @description Adds an AND WHERE BETWEEN condition to the query.
+     */
+    andWhereBetween(column: SelectableColumn<string>, min: BaseValues, max: BaseValues): this;
+    /**
+     * @description Adds an OR WHERE BETWEEN condition to the query.
+     */
+    orWhereBetween(column: SelectableColumn<string>, min: BaseValues, max: BaseValues): this;
+    /**
+     * @description Adds a WHERE NOT BETWEEN condition to the query.
+     */
+    whereNotBetween(column: SelectableColumn<string>, min: BaseValues, max: BaseValues): this;
+    /**
+     * @description Adds an AND WHERE NOT BETWEEN condition to the query.
+     */
+    andWhereNotBetween(column: SelectableColumn<string>, min: BaseValues, max: BaseValues): this;
+    /**
+     * @description Adds an OR WHERE NOT BETWEEN condition to the query.
+     */
+    orWhereNotBetween(column: SelectableColumn<string>, min: BaseValues, max: BaseValues): this;
+    /**
+     * @description Adds a WHERE LIKE condition to the query.
+     */
+    whereLike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds an AND WHERE LIKE condition to the query.
+     */
+    andWhereLike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds an OR WHERE LIKE condition to the query.
+     */
+    orWhereLike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds a WHERE ILIKE condition to the query.
+     */
+    whereILike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds an AND WHERE ILIKE condition to the query.
+     */
+    andWhereILike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds an OR WHERE ILIKE condition to the query.
+     */
+    orWhereILike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds a WHERE NOT LIKE condition to the query.
+     */
+    whereNotLike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds an AND WHERE NOT LIKE condition to the query.
+     */
+    andWhereNotLike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds an OR WHERE NOT LIKE condition to the query.
+     */
+    orWhereNotLike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds a WHERE NOT ILIKE condition to the query.
+     */
+    whereNotILike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds an AND WHERE NOT ILIKE condition to the query.
+     */
+    andWhereNotILike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds an OR WHERE NOT ILIKE condition to the query.
+     */
+    orWhereNotILike(column: SelectableColumn<string>, value: string): this;
+    /**
+     * @description Adds a WHERE IN condition to the query.
+     */
+    whereIn(column: SelectableColumn<string>, values: BaseValues[]): this;
+    /**
+     * @description Adds an AND WHERE IN condition to the query.
+     */
+    andWhereIn(column: SelectableColumn<string>, values: BaseValues[]): this;
+    /**
+     * @description Adds an OR WHERE IN condition to the query.
+     */
+    orWhereIn(column: SelectableColumn<string>, values: BaseValues[]): this;
+    /**
+     * @description Adds a WHERE NOT IN condition to the query.
+     */
+    whereNotIn(column: SelectableColumn<string>, values: BaseValues[]): this;
+    /**
+     * @description Adds an AND WHERE NOT IN condition to the query.
+     */
+    andWhereNotIn(column: SelectableColumn<string>, values: BaseValues[]): this;
+    /**
+     * @description Adds an OR WHERE NOT IN condition to the query.
+     */
+    orWhereNotIn(column: SelectableColumn<string>, values: BaseValues[]): this;
+    /**
+     * @description Adds a WHERE NULL condition to the query.
+     */
+    whereNull(column: SelectableColumn<string>): this;
+    /**
+     * @description Adds an AND WHERE NULL condition to the query.
+     */
+    andWhereNull(column: SelectableColumn<string>): this;
+    /**
+     * @description Adds an OR WHERE NULL condition to the query.
+     */
+    orWhereNull(column: SelectableColumn<string>): this;
+    /**
+     * @description Adds a WHERE NOT NULL condition to the query.
+     */
+    whereNotNull(column: SelectableColumn<string>): this;
+    /**
+     * @description Adds an AND WHERE NOT NULL condition to the query.
+     */
+    andWhereNotNull(column: SelectableColumn<string>): this;
+    /**
+     * @description Adds an OR WHERE NOT NULL condition to the query.
+     */
+    orWhereNotNull(column: SelectableColumn<string>): this;
+    /**
+     * @description Adds a WHERE REGEXP condition to the query.
+     */
+    whereRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    /**
+     * @description Adds an AND WHERE REGEXP condition to the query.
+     */
+    andWhereRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    /**
+     * @description Adds an OR WHERE REGEXP condition to the query.
+     */
+    orWhereRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    /**
+     * @description Adds a WHERE NOT REGEXP condition to the query.
+     */
+    whereNotRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    /**
+     * @description Adds an AND WHERE NOT REGEXP condition to the query.
+     */
+    andWhereNotRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    /**
+     * @description Adds an OR WHERE NOT REGEXP condition to the query.
+     */
+    orWhereNotRegexp(column: SelectableColumn<string>, regexp: RegExp): this;
+    /**
+     * @description Adds a WHERE group condition with AND.
+     */
+    whereGroup(cb: (queryBuilder: JoinOnQueryBuilder) => void): this;
+    /**
+     * @description Adds a WHERE group condition with AND.
+     */
+    andWhereGroup(cb: (queryBuilder: JoinOnQueryBuilder) => void): this;
+    /**
+     * @description Adds a WHERE group condition with OR.
+     */
+    orWhereGroup(cb: (queryBuilder: JoinOnQueryBuilder) => void): this;
+    /**
+     * @description Adds a raw WHERE condition to the query.
+     */
+    whereRaw(sql: string, bindings?: BaseValues[]): this;
+    /**
+     * @description Adds an AND raw WHERE condition to the query.
+     */
+    andWhereRaw(sql: string, bindings?: BaseValues[]): this;
+    /**
+     * @description Adds an OR raw WHERE condition to the query.
+     */
+    orWhereRaw(sql: string, bindings?: BaseValues[]): this;
+}
+
+/**
+ * @description Callback type for join conditions
+ */
+type JoinOnCallback = (query: JoinOnQueryBuilder) => void;
 declare abstract class JoinQueryBuilder<T extends Model> extends FooterQueryBuilder<T> {
     protected joinNodes: JoinNode[];
     protected constructor(model: typeof Model, sqlDataSource: SqlDataSource);
@@ -2693,6 +2910,10 @@ declare abstract class JoinQueryBuilder<T extends Model> extends FooterQueryBuil
     innerJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
     innerJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator?: BinaryOperatorType): this;
     innerJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn?: ModelKey<T>, operator?: BinaryOperatorType): this;
+    innerJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    innerJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
+    innerJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    innerJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, callback: JoinOnCallback): this;
     /**
      * @description Join a table with the current model
      * @param relationTable - The table to join
@@ -2704,6 +2925,10 @@ declare abstract class JoinQueryBuilder<T extends Model> extends FooterQueryBuil
     join(relationTable: string, referencingColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
     join<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator?: BinaryOperatorType): this;
     join<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn?: ModelKey<T>, operator?: BinaryOperatorType): this;
+    join(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    join(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
+    join<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    join<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, callback: JoinOnCallback): this;
     /**
      * @description Join a table with the current model
      * @param relationTable - The table to join
@@ -2715,6 +2940,10 @@ declare abstract class JoinQueryBuilder<T extends Model> extends FooterQueryBuil
     leftJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
     leftJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator?: BinaryOperatorType): this;
     leftJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn?: ModelKey<T>, operator?: BinaryOperatorType): this;
+    leftJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    leftJoin(relationTable: string, referencingColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
+    leftJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    leftJoin<R extends typeof Model>(relationModel: R, referencingColumn: ModelKey<InstanceType<R>>, primaryColumn: ModelKey<T>, callback: JoinOnCallback): this;
     /**
      * @description Join a table with the current model
      * @param relationTable - The table to join
@@ -2724,6 +2953,9 @@ declare abstract class JoinQueryBuilder<T extends Model> extends FooterQueryBuil
      */
     rightJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, operator?: BinaryOperatorType): this;
     rightJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
+    rightJoin<R extends typeof Model>(relationTable: string | R, referencingColumnOrPrimaryColumn: ModelKey<InstanceType<R>> | JoinableColumn | ModelKey<T>, primaryColumn?: JoinableColumn | ModelKey<T>, operator?: BinaryOperatorType): this;
+    rightJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    rightJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
     /**
      * @description Perform a FULL OUTER JOIN with another table
      * @param relationTable - The table to join
@@ -2733,6 +2965,9 @@ declare abstract class JoinQueryBuilder<T extends Model> extends FooterQueryBuil
      */
     fullJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, operator?: BinaryOperatorType): this;
     fullJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn?: JoinableColumn, operator?: BinaryOperatorType): this;
+    fullJoin<R extends typeof Model>(relationTable: string | R, referencingColumnOrPrimaryColumn: ModelKey<InstanceType<R>> | JoinableColumn | ModelKey<T>, primaryColumn?: JoinableColumn | ModelKey<T>, operator?: BinaryOperatorType): this;
+    fullJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, operator: BinaryOperatorType, callback: JoinOnCallback): this;
+    fullJoin(relationTable: string, referencingColumnOrPrimaryColumn: JoinableColumn, primaryColumn: JoinableColumn, callback: JoinOnCallback): this;
 }
 
 declare class SelectQueryBuilder<T extends Model> extends JoinQueryBuilder<T> {
@@ -2751,8 +2986,8 @@ declare class SelectQueryBuilder<T extends Model> extends JoinQueryBuilder<T> {
      * @warning For annotations, use the `annotate` method instead, aliases and methods are not supported in the select method and will give error `column "${columnName} as ${alias}" does not exist`
      * @example
      * ```ts
-     * const user = await User.query().select("name", "age").first(); // SELECT name, age FROM users
-     * const user = await User.query().select("name", "users.age").first(); // SELECT name, users.age FROM users
+     * const user = await User.query().select("name", "age").one(); // SELECT name, age FROM users
+     * const user = await User.query().select("name", "users.age").one(); // SELECT name, users.age FROM users
      * ```
      */
     select<S extends string>(...columns: SelectableColumn<S>[]): this;
@@ -2783,9 +3018,9 @@ declare class SelectQueryBuilder<T extends Model> extends JoinQueryBuilder<T> {
      * @description If using a model, the result will be available in the $annotations property of the model, else it will be available in the result of the query
      * @example
      * ```ts
-     * const user = await User.query().annotate("max", "id", "maxId").first(); // max(id) as maxId
-     * const user = await User.query().annotate("id", "superId").first(); // id as superId
-     * const user = await User.query().annotate("id", "superId").first(); // id as superId
+     * const user = await User.query().annotate("max", "id", "maxId").one(); // max(id) as maxId
+     * const user = await User.query().annotate("id", "superId").one(); // id as superId
+     * const user = await User.query().annotate("id", "superId").one(); // id as superId
      * ```
      */
     annotate<A extends string>(column: string, alias: A): this;
@@ -2824,15 +3059,15 @@ declare class SelectQueryBuilder<T extends Model> extends JoinQueryBuilder<T> {
      * @example
      * ```ts
      * // All databases accept the same path format:
-     * const user = await User.query().selectJson("data", "$.user.name", "userName").first();
+     * const user = await User.query().selectJson("data", "$.user.name", "userName").one();
      * console.log(user?.$annotations?.userName); // Typed!
      *
-     * await User.query().selectJson("data", "user.name", "userName").first(); // $ is optional
-     * await User.query().selectJson("data", ["user", "name"], "userName").first();
+     * await User.query().selectJson("data", "user.name", "userName").one(); // $ is optional
+     * await User.query().selectJson("data", ["user", "name"], "userName").one();
      *
      * // Array indices:
-     * await User.query().selectJson("data", "items.0.name", "firstItemName").first();
-     * await User.query().selectJson("data", ["items", 0, "name"], "firstItemName").first();
+     * await User.query().selectJson("data", "items.0.name", "firstItemName").one();
+     * await User.query().selectJson("data", ["items", 0, "name"], "firstItemName").one();
      * ```
      */
     selectJson<A extends string>(column: ModelKey<T>, path: JsonPathInput, alias: A): this;
@@ -2847,10 +3082,10 @@ declare class SelectQueryBuilder<T extends Model> extends JoinQueryBuilder<T> {
      * @example
      * ```ts
      * // All databases accept the same path format:
-     * const user = await User.query().selectJsonText("data", "$.user.name", "userName").first();
+     * const user = await User.query().selectJsonText("data", "$.user.name", "userName").one();
      * console.log(user?.$annotations?.userName); // Typed!
      *
-     * await User.query().selectJsonText("data", ["user", "name"], "userName").first();
+     * await User.query().selectJsonText("data", ["user", "name"], "userName").one();
      * ```
      */
     selectJsonText<A extends string>(column: ModelKey<T>, path: JsonPathInput, alias: A): this;
@@ -2865,11 +3100,11 @@ declare class SelectQueryBuilder<T extends Model> extends JoinQueryBuilder<T> {
      * @example
      * ```ts
      * // All databases accept the same path format:
-     * const user = await User.query().selectJsonArrayLength("data", "$.items", "itemCount").first();
+     * const user = await User.query().selectJsonArrayLength("data", "$.items", "itemCount").one();
      * console.log(user?.$annotations?.itemCount); // Typed!
      *
-     * await User.query().selectJsonArrayLength("data", "items", "itemCount").first();
-     * await User.query().selectJsonArrayLength("data", "$", "totalCount").first(); // root array
+     * await User.query().selectJsonArrayLength("data", "items", "itemCount").one();
+     * await User.query().selectJsonArrayLength("data", "$", "totalCount").one(); // root array
      * ```
      */
     selectJsonArrayLength<A extends string>(column: ModelKey<T>, path: JsonPathInput, alias: A): this;
@@ -2886,11 +3121,11 @@ declare class SelectQueryBuilder<T extends Model> extends JoinQueryBuilder<T> {
      * @example
      * ```ts
      * // All databases accept the same path format:
-     * const user = await User.query().selectJsonKeys("data", "$.user", "userKeys").first();
+     * const user = await User.query().selectJsonKeys("data", "$.user", "userKeys").one();
      * console.log(user?.$annotations?.userKeys); // Typed!
      *
-     * await User.query().selectJsonKeys("data", "user", "userKeys").first();
-     * await User.query().selectJsonKeys("data", "$", "rootKeys").first(); // root object
+     * await User.query().selectJsonKeys("data", "user", "userKeys").one();
+     * await User.query().selectJsonKeys("data", "$", "rootKeys").one(); // root object
      * ```
      */
     selectJsonKeys<A extends string>(column: ModelKey<T>, path: JsonPathInput, alias: A): this;
@@ -2902,7 +3137,7 @@ declare class SelectQueryBuilder<T extends Model> extends JoinQueryBuilder<T> {
      * @description Result will be available in model.$annotations[alias]
      * @example
      * ```ts
-     * const user = await User.query().selectJsonRaw("data->>'email'", "userEmail").first();
+     * const user = await User.query().selectJsonRaw("data->>'email'", "userEmail").one();
      * console.log(user?.$annotations?.userEmail); // Typed!
      * ```
      */
@@ -3450,14 +3685,6 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
             data: AnnotatedModel<T, A, R>;
             time: number;
         }>;
-        first: (options?: OneOptions, returnType?: "millis" | "seconds") => Promise<{
-            data: AnnotatedModel<T, A, R> | null;
-            time: number;
-        }>;
-        firstOrFail: (options?: OneOptions, returnType?: "millis" | "seconds") => Promise<{
-            data: AnnotatedModel<T, A, R>;
-            time: number;
-        }>;
         paginate: (page: number, perPage: number, options?: {
             ignoreHooks?: boolean;
         }, returnType?: "millis" | "seconds") => Promise<{
@@ -3504,7 +3731,6 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
      */
     static from(model: typeof Model, options?: BaseModelMethodOptions): ModelQueryBuilder<InstanceType<typeof model>>;
     one(options?: OneOptions): Promise<AnnotatedModel<T, A, R> | null>;
-    first(options?: OneOptions): Promise<AnnotatedModel<T, A, R> | null>;
     oneOrFail(options?: {
         ignoreHooks?: OneOptions["ignoreHooks"] & {
             customError?: Error;
@@ -3555,10 +3781,10 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
      * @description If the alias matches a model field name, it overrides that field. Otherwise, it's available in $annotations
      * @example
      * ```ts
-     * const user = await User.query().annotate("max", "id", "maxId").first(); // max(id) as maxId
-     * const user = await User.query().annotate("id", "superId").first(); // id as superId
+     * const user = await User.query().annotate("max", "id", "maxId").one(); // max(id) as maxId
+     * const user = await User.query().annotate("id", "superId").one(); // id as superId
      * // If alias matches model field, it overrides it:
-     * const user = await User.query().annotate("COUNT(*)", "email").first(); // user.email is now a number
+     * const user = await User.query().annotate("COUNT(*)", "email").one(); // user.email is now a number
      * ```
      */
     annotate<K extends string, V = any>(column: string, alias: K): AnnotationResult<T, A, R, K, V>;
@@ -3577,29 +3803,29 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
      * // All these path formats are supported:
      *
      * // 1. With $ prefix (standard JSON path)
-     * await User.query().selectJson("data", "$.user.name", "userName").first();
+     * await User.query().selectJson("data", "$.user.name", "userName").one();
      *
      * // 2. Without $ prefix ($ is optional)
-     * await User.query().selectJson("data", "user.name", "userName").first();
+     * await User.query().selectJson("data", "user.name", "userName").one();
      *
      * // 3. Array format
-     * await User.query().selectJson("data", ["user", "name"], "userName").first();
+     * await User.query().selectJson("data", ["user", "name"], "userName").one();
      *
      * // 4. Array indices with dot notation
-     * await User.query().selectJson("data", "items.0.name", "firstItemName").first();
+     * await User.query().selectJson("data", "items.0.name", "firstItemName").one();
      *
      * // 5. Array indices with array format
-     * await User.query().selectJson("data", ["items", 0, "name"], "firstItemName").first();
+     * await User.query().selectJson("data", ["items", 0, "name"], "firstItemName").one();
      *
      * // 6. Root object
-     * await User.query().selectJson("data", "$", "allData").first();
+     * await User.query().selectJson("data", "$", "allData").one();
      *
      * // Access the result - in $annotations if not a model field
-     * const user = await User.query().selectJson("data", "user.name", "userName").first();
+     * const user = await User.query().selectJson("data", "user.name", "userName").one();
      * console.log(user?.$annotations?.userName); // Typed as any
      *
      * // If alias matches model field, it overrides it
-     * const user2 = await User.query().selectJson("data", "$.name", "email").first();
+     * const user2 = await User.query().selectJson("data", "$.name", "email").one();
      * console.log(user2?.email); // Overrides model's email field
      * ```
      */
@@ -3617,23 +3843,23 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
      * // All these path formats are supported:
      *
      * // 1. With $ prefix
-     * await User.query().selectJsonText("data", "$.user.email", "userEmail").first();
+     * await User.query().selectJsonText("data", "$.user.email", "userEmail").one();
      *
      * // 2. Without $ prefix
-     * await User.query().selectJsonText("data", "user.email", "userEmail").first();
+     * await User.query().selectJsonText("data", "user.email", "userEmail").one();
      *
      * // 3. Array format
-     * await User.query().selectJsonText("data", ["user", "email"], "userEmail").first();
+     * await User.query().selectJsonText("data", ["user", "email"], "userEmail").one();
      *
      * // 4. Array indices
-     * await User.query().selectJsonText("data", "tags.0", "firstTag").first();
-     * await User.query().selectJsonText("data", ["tags", 0], "firstTag").first();
+     * await User.query().selectJsonText("data", "tags.0", "firstTag").one();
+     * await User.query().selectJsonText("data", ["tags", 0], "firstTag").one();
      *
      * // 5. Deep nesting
-     * await User.query().selectJsonText("data", "user.profile.bio", "biography").first();
+     * await User.query().selectJsonText("data", "user.profile.bio", "biography").one();
      *
      * // Access the result - in $annotations if not a model field
-     * const user = await User.query().selectJsonText("data", "user.email", "userEmail").first();
+     * const user = await User.query().selectJsonText("data", "user.email", "userEmail").one();
      * console.log(user?.$annotations?.userEmail); // Typed as string
      * ```
      */
@@ -3652,27 +3878,27 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
      * // All these path formats are supported:
      *
      * // 1. With $ prefix
-     * await User.query().selectJsonArrayLength("data", "$.items", "itemCount").first();
+     * await User.query().selectJsonArrayLength("data", "$.items", "itemCount").one();
      *
      * // 2. Without $ prefix
-     * await User.query().selectJsonArrayLength("data", "items", "itemCount").first();
+     * await User.query().selectJsonArrayLength("data", "items", "itemCount").one();
      *
      * // 3. Array format
-     * await User.query().selectJsonArrayLength("data", ["items"], "itemCount").first();
+     * await User.query().selectJsonArrayLength("data", ["items"], "itemCount").one();
      *
      * // 4. Root array (use "$" or "")
-     * await User.query().selectJsonArrayLength("data", "$", "totalCount").first();
-     * await User.query().selectJsonArrayLength("data", "", "totalCount").first();
+     * await User.query().selectJsonArrayLength("data", "$", "totalCount").one();
+     * await User.query().selectJsonArrayLength("data", "", "totalCount").one();
      *
      * // 5. Nested arrays
-     * await User.query().selectJsonArrayLength("data", "user.roles", "roleCount").first();
-     * await User.query().selectJsonArrayLength("data", ["user", "roles"], "roleCount").first();
+     * await User.query().selectJsonArrayLength("data", "user.roles", "roleCount").one();
+     * await User.query().selectJsonArrayLength("data", ["user", "roles"], "roleCount").one();
      *
      * // 6. Deeply nested arrays
-     * await User.query().selectJsonArrayLength("data", "level1.level2.items", "deepCount").first();
+     * await User.query().selectJsonArrayLength("data", "level1.level2.items", "deepCount").one();
      *
      * // Access the result - in $annotations if not a model field
-     * const user = await User.query().selectJsonArrayLength("data", "items", "count").first();
+     * const user = await User.query().selectJsonArrayLength("data", "items", "count").one();
      * console.log(user?.$annotations?.count); // Typed as number
      * ```
      */
@@ -3693,27 +3919,27 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
      * // All these path formats are supported:
      *
      * // 1. With $ prefix
-     * await User.query().selectJsonKeys("data", "$.settings", "settingKeys").first();
+     * await User.query().selectJsonKeys("data", "$.settings", "settingKeys").one();
      *
      * // 2. Without $ prefix
-     * await User.query().selectJsonKeys("data", "settings", "settingKeys").first();
+     * await User.query().selectJsonKeys("data", "settings", "settingKeys").one();
      *
      * // 3. Array format
-     * await User.query().selectJsonKeys("data", ["settings"], "settingKeys").first();
+     * await User.query().selectJsonKeys("data", ["settings"], "settingKeys").one();
      *
      * // 4. Root object (use "$" or "")
-     * await User.query().selectJsonKeys("data", "$", "rootKeys").first();
-     * await User.query().selectJsonKeys("data", "", "rootKeys").first();
+     * await User.query().selectJsonKeys("data", "$", "rootKeys").one();
+     * await User.query().selectJsonKeys("data", "", "rootKeys").one();
      *
      * // 5. Nested objects
-     * await User.query().selectJsonKeys("data", "user.profile", "profileKeys").first();
-     * await User.query().selectJsonKeys("data", ["user", "profile"], "profileKeys").first();
+     * await User.query().selectJsonKeys("data", "user.profile", "profileKeys").one();
+     * await User.query().selectJsonKeys("data", ["user", "profile"], "profileKeys").one();
      *
      * // 6. Deeply nested objects
-     * await User.query().selectJsonKeys("data", "settings.display.theme", "themeKeys").first();
+     * await User.query().selectJsonKeys("data", "settings.display.theme", "themeKeys").one();
      *
      * // Access the result - in $annotations if not a model field
-     * const user = await User.query().selectJsonKeys("data", "settings", "keys").first();
+     * const user = await User.query().selectJsonKeys("data", "settings", "keys").one();
      * console.log(user?.$annotations?.keys); // Typed as any[] - ["theme", "fontSize", "autoSave"]
      * ```
      */
@@ -3729,28 +3955,28 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
      * @example
      * ```ts
      * // PostgreSQL - Extract as text with ->> operator
-     * await User.query().selectJsonRaw("data->>'email'", "userEmail").first();
+     * await User.query().selectJsonRaw("data->>'email'", "userEmail").one();
      *
      * // PostgreSQL - Extract nested JSON with -> operator
-     * await User.query().selectJsonRaw("data->'user'->'profile'->>'name'", "profileName").first();
+     * await User.query().selectJsonRaw("data->'user'->'profile'->>'name'", "profileName").one();
      *
      * // PostgreSQL - Array element access
-     * await User.query().selectJsonRaw("data->'items'->0->>'name'", "firstName").first();
+     * await User.query().selectJsonRaw("data->'items'->0->>'name'", "firstName").one();
      *
      * // MySQL - Extract value with JSON_EXTRACT and ->>
-     * await User.query().selectJsonRaw("data->>'$.email'", "userEmail").first();
+     * await User.query().selectJsonRaw("data->>'$.email'", "userEmail").one();
      *
      * // MySQL - Array length with JSON_LENGTH
-     * await User.query().selectJsonRaw("JSON_LENGTH(data, '$.items')", "itemCount").first();
+     * await User.query().selectJsonRaw("JSON_LENGTH(data, '$.items')", "itemCount").one();
      *
      * // MSSQL - Extract value with JSON_VALUE
-     * await User.query().selectJsonRaw("JSON_VALUE(data, '$.email')", "userEmail").first();
+     * await User.query().selectJsonRaw("JSON_VALUE(data, '$.email')", "userEmail").one();
      *
      * // SQLite - Extract value with json_extract
-     * await User.query().selectJsonRaw("json_extract(data, '$.email')", "userEmail").first();
+     * await User.query().selectJsonRaw("json_extract(data, '$.email')", "userEmail").one();
      *
      * // Access the result - in $annotations if not a model field
-     * const user = await User.query().selectJsonRaw("data->>'email'", "userEmail").first();
+     * const user = await User.query().selectJsonRaw("data->>'email'", "userEmail").one();
      * console.log(user?.$annotations?.userEmail); // Typed as any
      * ```
      */
@@ -3831,7 +4057,6 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
     private oneWithPerformance;
     private oneOrFailWithPerformance;
     private firstOrFailWithPerformance;
-    private firstWithPerformance;
     private paginateWithPerformance;
     private paginateWithCursorWithPerformance;
     private existsWithPerformance;
@@ -4028,7 +4253,7 @@ type TransactionExecutionOptions = {
 };
 
 /**
- * @description Transaction class, not meant to be used directly, use sql.startTransaction() instead
+ * @description Transaction class, not meant to be used directly, use sql.transaction() instead
  */
 declare class Transaction {
     /**
@@ -4039,7 +4264,7 @@ declare class Transaction {
      * import { User } from "./models/user";
      *
      * // Raw queries
-     * const trx = await sql.startTransaction();
+     * const trx = await sql.transaction();
      * await trx.rawQuery("SELECT * FROM users");
      *
      * // Model manager
@@ -4052,7 +4277,7 @@ declare class Transaction {
      * await trx.commit();
      * ```
      */
-    sql: Omit<SqlDataSource, "transaction" | "startGlobalTransaction" | "startTransaction">;
+    sql: Omit<SqlDataSource, "transaction" | "startGlobalTransaction">;
     /**
      * @description Whether the transaction is active
      */
@@ -4073,9 +4298,9 @@ declare class Transaction {
     nestedTransaction(): Promise<Transaction>;
     nestedTransaction(cb: (trx: Transaction) => Promise<void>): Promise<void>;
     /**
-     * @description Starts a transaction, automatically handled from the sql data source instance in the `startTransaction` method
+     * @description Starts a transaction, automatically handled from the sql data source instance in the `transaction` method
      */
-    startTransaction(): Promise<void>;
+    transaction(): Promise<void>;
     /**
      * @description Commit the transaction releasing the connection
      * @throws {HysteriaError} if the transaction is not active and options.throwErrorOnInactiveTransaction is true
@@ -4228,10 +4453,6 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
     /**
      * @description Closes the primary connection (singleton instance)
      */
-    static closeConnection(): Promise<void>;
-    /**
-     * @alias closeConnection
-     */
     static disconnect(): Promise<void>;
     /**
      * @description Starts a global transaction on the primary database connection
@@ -4375,11 +4596,6 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @param options.isolationLevel The isolation level to use for the transaction
      * @sqlite ignores the isolation level
      */
-    startTransaction(options?: StartTransactionOptions): Promise<Transaction>;
-    startTransaction(cb: (trx: Transaction) => Promise<void>, options?: StartTransactionOptions): Promise<void>;
-    /**
-     * @alias startTransaction
-     */
     transaction(options?: StartTransactionOptions): Promise<Transaction>;
     transaction(cb: (trx: Transaction) => Promise<void>, options?: StartTransactionOptions): Promise<void>;
     /**
@@ -4403,15 +4619,11 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
      * @description If there is an active global transaction, it will be rolled back
      * @description Also disconnects all slave connections if any are configured
      */
-    closeConnection(): Promise<void>;
+    disconnect(): Promise<void>;
     /**
      * @description Returns the connection details
      */
     getConnectionDetails(): SqlDataSourceInput<D, T, C>;
-    /**
-     * @alias closeConnection
-     */
-    disconnect(): Promise<void>;
     /**
      * @description Syncs the schema of the database with the models metadata
      * @warning This will drop and recreate all the indexes and constraints, use with caution
@@ -4420,6 +4632,11 @@ declare class SqlDataSource<D extends SqlDataSourceType = SqlDataSourceType, T e
     syncSchema(options?: {
         transactional: boolean;
     }): Promise<void>;
+    /**
+     * @description Extracts rows from raw query result based on database type
+     * MySQL/MariaDB returns [rows, fields], Postgres returns {rows: []}, others return rows directly
+     */
+    private extractRowsFromRawResult;
     /**
      * @description Executes a raw query on the database and returns the raw driver result
      */
@@ -4539,7 +4756,7 @@ type BaseModelMethodOptions = {
      *   port: 5432,
      * });
      *
-     * const user = await User.query({ connection: customConnection }).first();
+     * const user = await User.query({ connection: customConnection }).one();
      * ```
      */
     connection?: SqlDataSource;
@@ -4612,14 +4829,6 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
             data: any;
             time: number;
         }>;
-        first: (returnType?: "millis" | "seconds") => Promise<{
-            data: AnnotatedModel<T, any, any> | null;
-            time: number;
-        }>;
-        firstOrFail: (returnType?: "millis" | "seconds") => Promise<{
-            data: any;
-            time: number;
-        }>;
         paginate: (page: number, perPage: number, returnType?: "millis" | "seconds") => Promise<{
             data: PaginatedData<T>;
             time: number;
@@ -4687,10 +4896,6 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
      * @description Executes the query and retrieves a single result.
      */
     one(): Promise<AnnotatedModel<T, any, any> | null>;
-    /**
-     * @alias one
-     */
-    first(): Promise<AnnotatedModel<T, any, any> | null>;
     /**
      * @description Executes the query and retrieves the first result. Fail if no result is found.
      */
@@ -4937,10 +5142,6 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
      * @description Makes a one query and returns the time that took to execute that query
      */
     private oneWithPerformance;
-    /**
-     * @alias oneWithPerformance
-     */
-    private firstWithPerformance;
     /**
      * @alias oneOrFailWithPerformance
      */
@@ -5111,7 +5312,7 @@ declare abstract class Model extends Entity {
     static dryQuery<T extends Model>(this: new () => T | typeof Model, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): DryModelQueryBuilderWithoutReadOperations<T>;
     /**
      * @description Finds the first record in the database
-     * @deprecated Used only for debugging purposes, use findOne or query instead
+     * @deprecated Used only for debugging purposes, use `.findOne` or `.query` instead
      */
     static first<T extends Model>(this: new () => T | typeof Model, options?: BaseModelMethodOptions): Promise<AnnotatedModel<T, {}> | null>;
     /**
@@ -5304,6 +5505,76 @@ declare abstract class Model extends Entity {
      * @javascript
      */
     static column(columnName: string, ...args: Parameters<typeof column>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static dateColumn(columnName: string, ...args: Parameters<(typeof column)["date"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static datetimeColumn(columnName: string, ...args: Parameters<(typeof column)["datetime"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static timestampColumn(columnName: string, ...args: Parameters<(typeof column)["timestamp"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static timeColumn(columnName: string, ...args: Parameters<(typeof column)["time"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static booleanColumn(columnName: string, ...args: Parameters<(typeof column)["boolean"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static jsonColumn(columnName: string, ...args: Parameters<(typeof column)["json"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static uuidColumn(columnName: string, ...args: Parameters<(typeof column)["uuid"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static ulidColumn(columnName: string, ...args: Parameters<(typeof column)["ulid"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static integerColumn(columnName: string, ...args: Parameters<(typeof column)["integer"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static floatColumn(columnName: string, ...args: Parameters<(typeof column)["float"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static incrementColumn(columnName: string, ...args: Parameters<(typeof column)["increment"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static bigIncrementColumn(columnName: string, ...args: Parameters<(typeof column)["bigIncrement"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static encryptionSymmetricColumn(columnName: string, ...args: Parameters<(typeof column)["encryption"]["symmetric"]>): void;
+    /**
+     * @description Defines a column in the model, useful in javascript in order to not have to rely on decorators since are not supported without a transpiler like babel
+     * @javascript
+     */
+    static encryptionAsymmetricColumn(columnName: string, ...args: Parameters<(typeof column)["encryption"]["asymmetric"]>): void;
     /**
      * @description Defines an hasOne relation
      * @javascript
@@ -5626,39 +5897,155 @@ declare class ModelFactory<M extends Model> {
 }
 declare const createModelFactory: <M extends Model>(typeofModel: typeof Model, modelData: Partial<ModelWithoutRelations<M>>) => ModelFactory<M>;
 
+type Constructor<T = Model> = new (...args: any[]) => T;
+type AbstractConstructor<T = Model> = abstract new (...args: any[]) => T;
+type AnyConstructor<T = Model> = Constructor<T> | AbstractConstructor<T>;
+
+interface BigIntFields {
+    id: number;
+}
 /**
- * @description Mixin to add createdAt, updatedAt and deletedAt columns to a model
+ * Mixin to add a bigint primary key column with auto-increment.
+ * Uses bigint database type but TypeScript number type.
+ *
+ * @example
+ * ```ts
+ * class User extends bigIntMixin() {
+ *   declare name: string;
+ * }
+ *
+ * // Composable with other mixins
+ * class Post extends timestampMixin(bigIntMixin()) {}
+ * ```
  */
-declare class TimestampedModel extends Model {
-    createdAt: Date;
-    updatedAt: Date;
-    deletedAt: Date | null;
-}
+declare function bigIntMixin(): typeof Model & Constructor<BigIntFields>;
+declare function bigIntMixin<TBase extends AnyConstructor>(Base: TBase): TBase & Constructor<BigIntFields>;
+declare const BigIntMixin: typeof bigIntMixin;
 
+interface IncrementFields {
+    id: number;
+}
 /**
- * @description Mixin to add a uuid column to a model
+ * Mixin to add an auto-incrementing integer primary key column.
+ *
+ * @example
+ * ```ts
+ * class User extends incrementMixin() {
+ *   declare name: string;
+ * }
+ *
+ * // Composable with other mixins
+ * class Post extends timestampMixin(incrementMixin()) {}
+ * ```
  */
-declare class UuidModel extends Model {
+declare function incrementMixin(): typeof Model & Constructor<IncrementFields>;
+declare function incrementMixin<TBase extends AnyConstructor>(Base: TBase): TBase & Constructor<IncrementFields>;
+declare const IncrementMixin: typeof incrementMixin;
+
+interface UlidFields {
     id: string;
 }
-
 /**
- * @description Mixin to add an autogenerated id column to a model
+ * Mixin to add a ULID primary key column.
+ * ULID = Universally Unique Lexicographically Sortable Identifier.
+ * Automatically generates ULID if not provided.
+ *
+ * @example
+ * ```ts
+ * class User extends ulidMixin() {
+ *   declare name: string;
+ * }
+ *
+ * // Composable with other mixins
+ * class Post extends timestampMixin(ulidMixin()) {}
+ * ```
  */
-declare class AutogeneratedModel extends Model {
-    id: BigInt;
-}
+declare function ulidMixin(): typeof Model & Constructor<UlidFields>;
+declare function ulidMixin<TBase extends AnyConstructor>(Base: TBase): TBase & Constructor<UlidFields>;
+declare const UlidMixin: typeof ulidMixin;
 
+interface UuidFields {
+    id: string;
+}
 /**
- * @description Mixin to add a user model with id, email, createdAt, updatedAt and deletedAt columns
+ * Mixin to add a UUID primary key column.
+ * Automatically generates UUID if not provided.
+ *
+ * @example
+ * ```ts
+ * class User extends uuidMixin() {
+ *   declare name: string;
+ * }
+ *
+ * // Composable with other mixins
+ * class Post extends timestampMixin(uuidMixin()) {}
+ * ```
  */
-declare class UserMixin extends Model {
-    id: BigInt;
-    email: string;
+declare function uuidMixin(): typeof Model & Constructor<UuidFields>;
+declare function uuidMixin<TBase extends AnyConstructor>(Base: TBase): TBase & Constructor<UuidFields>;
+declare const UuidMixin: typeof uuidMixin;
+
+interface TimestampFields {
     createdAt: Date;
     updatedAt: Date;
     deletedAt: Date | null;
 }
+/**
+ * Mixin to add timestamp columns for tracking record creation and updates.
+ * Adds createdAt, updatedAt, and deletedAt columns.
+ * - createdAt: Auto-set on record creation
+ * - updatedAt: Auto-set on creation and updates
+ * - deletedAt: Nullable, for soft deletes
+ *
+ * @example
+ * ```ts
+ * class User extends timestampMixin() {
+ *   declare name: string;
+ * }
+ *
+ * // Composable with other mixins
+ * class Post extends timestampMixin(uuidMixin()) {}
+ * ```
+ */
+declare function timestampMixin(): typeof Model & Constructor<TimestampFields>;
+declare function timestampMixin<TBase extends AnyConstructor>(Base: TBase): TBase & Constructor<TimestampFields>;
+declare const TimestampMixin: typeof timestampMixin;
+
+/**
+ * Column definitions map for the mixin factory.
+ * Keys are property names, values are ColumnOptions.
+ */
+type MixinColumns<TFields> = {
+    [K in keyof TFields]: ColumnOptions;
+};
+/**
+ * Creates a custom mixin function with the specified columns.
+ *
+ * @example
+ * ```ts
+ * interface AuditFields {
+ *   createdBy: string | null;
+ *   updatedBy: string | null;
+ * }
+ *
+ * const auditMixin = createMixin<AuditFields>({
+ *   createdBy: { nullable: true },
+ *   updatedBy: { nullable: true },
+ * });
+ *
+ * class User extends auditMixin(timestampMixin(uuidMixin())) {
+ *   static table = 'users';
+ * }
+ * ```
+ */
+declare const createMixin: <TFields>(columns: MixinColumns<TFields>) => {
+    (): typeof Model & Constructor<TFields>;
+    <TBase extends AnyConstructor>(base: TBase): TBase & Constructor<TFields>;
+};
+declare const MixinFactory: <TFields>(columns: MixinColumns<TFields>) => {
+    (): typeof Model & Constructor<TFields>;
+    <TBase extends AnyConstructor>(base: TBase): TBase & Constructor<TFields>;
+};
 
 declare class InMemoryAdapter implements CacheAdapter {
     get<T = void>(key: string): Promise<T>;
@@ -6523,4 +6910,4 @@ declare const generateOpenApiModelWithMetadata: <T extends new () => Model>(mode
     $id?: string;
 }>;
 
-export { type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnnotatedModel, type AsymmetricEncryptionOptions, AutogeneratedModel, type BaseModelMethodOptions, type BaseModelRelationType, BaseSeeder, type CacheAdapter, type CacheKeys, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type CommonSqlMethodReturnType, type ConnectionPolicies, type DataSourceInput, type DataSourceType, type DateColumnOptions, DryModelQueryBuilder, DryQueryBuilder, type FetchHooks, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type IndexType, type LazyRelationType, type ManyOptions, type ManyToManyOptions, type ManyToManyStringOptions, Migration, type MigrationConfig, type MigrationConfigBase, Model, type ModelInstanceType, ModelQueryBuilder, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullableOracleDBDataSourceInput, type NotNullableOracleMssqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NumberModelKey, type OneOptions, type OracleDBDataSourceInput, type OracleDBPoolInstance, type PgPoolClientInstance, type PostgresSqlDataSourceInput, QueryBuilder, type RawModelOptions, RawNode, type RawQueryOptions, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationQueryBuilderType, type ReplicationType, type SeederConfig, type SlaveAlgorithm, type SlaveContext, type SqlCloneOptions, SqlDataSource, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDriverSpecificOptions, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type SymmetricEncryptionOptions, type TableFormat, type ThroughModel, TimestampedModel, Transaction, type TransactionExecutionOptions, type UniqueType, type UseCacheReturnType, type UseConnectionInput, UserMixin, UuidModel, belongsTo, column, createModelFactory, defineMigrator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, index, HysteriaLogger as logger, manyToMany, property, RedisDataSource as redis, unique, view, withPerformance };
+export { type AbstractConstructor, type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnnotatedModel, type AnyConstructor, type AsymmetricEncryptionOptions, type BaseModelMethodOptions, type BaseModelRelationType, BaseSeeder, type BigIntFields, BigIntMixin, type CacheAdapter, type CacheKeys, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type CommonSqlMethodReturnType, type ConnectionPolicies, type Constructor, type DataSourceInput, type DataSourceType, type DateColumnOptions, DryModelQueryBuilder, DryQueryBuilder, type FetchHooks, type GetConnectionReturnType, HysteriaError, InMemoryAdapter, type IncrementFields, IncrementMixin, type IndexType, type LazyRelationType, type ManyOptions, type ManyToManyOptions, type ManyToManyStringOptions, Migration, type MigrationConfig, type MigrationConfigBase, type MixinColumns, MixinFactory, Model, type ModelInstanceType, ModelQueryBuilder, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput$1 as MongoDataSourceInput, type MssqlConnectionInstance, type MssqlDataSourceInput, type MssqlPoolInstance, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullableOracleDBDataSourceInput, type NotNullableOracleMssqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NumberModelKey, type OneOptions, type OracleDBDataSourceInput, type OracleDBPoolInstance, type PgPoolClientInstance, type PostgresSqlDataSourceInput, QueryBuilder, type RawModelOptions, RawNode, type RawQueryOptions, RedisCacheAdapter, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationQueryBuilderType, type ReplicationType, type SeederConfig, type SlaveAlgorithm, type SlaveContext, type SqlCloneOptions, SqlDataSource, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDriverSpecificOptions, type SqlPoolType, type Sqlite3ConnectionOptions, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type SymmetricEncryptionOptions, type TableFormat, type ThroughModel, type TimestampFields, TimestampMixin, Transaction, type TransactionExecutionOptions, type UlidFields, UlidMixin, type UniqueType, type UseCacheReturnType, type UseConnectionInput, type UuidFields, UuidMixin, belongsTo, bigIntMixin, column, createMixin, createModelFactory, defineMigrator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, incrementMixin, index, HysteriaLogger as logger, manyToMany, property, RedisDataSource as redis, timestampMixin, ulidMixin, unique, uuidMixin, view, withPerformance };