hysteria-orm 10.5.1 → 10.5.2

package/lib/index.d.cts

@@ -2969,22 +2969,30 @@ declare class SelectQueryBuilder<T extends Model, S extends Record<string, any>
     /**
      * @description Adds a SELECT condition to the query.
      * @description Can be stacked multiple times
-     * @description Supports: "column", "table.column", "column as alias", "*", "table.*"
+     * @description Supports: "column", "table.column", "*", "table.*", or [column, alias] tuples
+     * @example
+     * .select("id", "name")                           // Simple columns
+     * .select(["id", "userId"], ["name", "userName"]) // Columns with aliases
+     * .select("id", ["name", "userName"])             // Mixed
      */
-    select<C extends string>(...columns: SelectableColumn$1<C>[]): this;
-    select(...columns: (ModelKey<T> | "*")[]): this;
-    /**
-     * @description Parses a column string that may contain an alias (e.g., "column as alias")
-     * @returns The column part and optional alias part
-     */
-    protected parseColumnAlias(column: string): {
-        columnPart: string;
-        aliasPart: string | undefined;
-    };
+    select<C extends string>(...columns: (SelectableColumn$1<C> | Selectable)[]): this;
+    select(...columns: (ModelKey<T> | "*" | Selectable)[]): this;
     /**
      * @description Adds a raw SELECT statement to the query
      */
     selectRaw(statement: string): this;
+    /**
+     * @description Selects a SQL function applied to a column with a typed alias.
+     * @description Provides intellisense for common SQL functions while accepting any custom function.
+     * @param func The SQL function name (count, sum, avg, min, max, upper, lower, etc.)
+     * @param column The column to apply the function to (use "*" for count(*))
+     * @param alias The alias for the result
+     * @example
+     * .selectFunc("count", "*", "total")
+     * .selectFunc("upper", "name", "upperName")
+     * .selectFunc("custom_fn", "column", "result")
+     */
+    selectFunc<A extends string>(sqlFunc: SqlFunction, column: string, alias: A): this;
     /**
      * @description Clears the SELECT clause
      */
@@ -3044,88 +3052,6 @@ declare class SelectQueryBuilder<T extends Model, S extends Record<string, any>
      * @description Adds a raw JSON select expression
      */
     selectJsonRaw<A extends string>(raw: string, alias: A): this;
-    /**
-     * @description Selects COUNT(column) with an alias
-     */
-    selectCount<A extends string>(column: ModelKey<T> | "*", alias: A): this;
-    selectCount<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects SUM(column) with an alias
-     */
-    selectSum<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectSum<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects AVG(column) with an alias
-     */
-    selectAvg<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectAvg<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects MIN(column) with an alias
-     */
-    selectMin<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectMin<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects MAX(column) with an alias
-     */
-    selectMax<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectMax<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects COUNT(DISTINCT column) with an alias
-     */
-    selectCountDistinct<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectCountDistinct<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects UPPER(column) with an alias
-     */
-    selectUpper<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectUpper<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects LOWER(column) with an alias
-     */
-    selectLower<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectLower<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects LENGTH(column) with an alias
-     * @note MSSQL uses LEN() instead of LENGTH()
-     */
-    selectLength<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectLength<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects TRIM(column) with an alias
-     */
-    selectTrim<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectTrim<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects ABS(column) with an alias
-     */
-    selectAbs<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectAbs<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects ROUND(column, decimals) with an alias
-     */
-    selectRound<A extends string>(column: ModelKey<T>, decimals: number, alias: A): this;
-    selectRound<A extends string>(column: string, decimals: number, alias: A): this;
-    /**
-     * @description Selects COALESCE(column, defaultValue) with an alias
-     */
-    selectCoalesce<A extends string>(column: ModelKey<T>, defaultValue: string | number, alias: A): this;
-    selectCoalesce<A extends string>(column: string, defaultValue: string | number, alias: A): this;
-    /**
-     * @description Selects CEIL(column) with an alias
-     * @mssql Uses CEILING instead of CEIL
-     */
-    selectCeil<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectCeil<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects FLOOR(column) with an alias
-     */
-    selectFloor<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectFloor<A extends string>(column: string, alias: A): this;
-    /**
-     * @description Selects SQRT(column) with an alias
-     */
-    selectSqrt<A extends string>(column: ModelKey<T>, alias: A): this;
-    selectSqrt<A extends string>(column: string, alias: A): this;
 }
 
 declare abstract class WhereQueryBuilder<T extends Model, S extends Record<string, any> = Record<string, any>> extends SelectQueryBuilder<T, S> {
@@ -3637,17 +3563,17 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     /**
      * @description Adds a SELECT condition to the query with type safety.
      * @description Can be stacked multiple times
-     * @description Supports: "column", "table.column", "column as alias", "*", "table.*"
+     * @description Supports: "column", "table.column", "*", "table.*", or [column, alias] tuples
      * @example
      * ```ts
      * const user = await sql.query("users").select("name", "age").one();
      * // user type: { name: any, age: any } | null
      *
-     * const user = await sql.query("users").select("name as userName").one();
+     * const user = await sql.query("users").select(["name", "userName"]).one();
      * // user type: { userName: any } | null
      * ```
      */
-    select<Columns extends readonly string[]>(...columns: Columns): QueryBuilder<T, ComposeBuildRawSelect<S, Columns>>;
+    select<const Columns extends readonly Selectable[]>(...columns: Columns): QueryBuilder<T, ComposeBuildRawSelect<S, Columns>>;
     /**
      * @description Adds a raw SELECT statement to the query with type safety.
      * @description Use the generic parameter to specify the type of the selected columns.
@@ -3664,6 +3590,24 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
      * @description Clears the SELECT clause and resets type to default
      */
     clearSelect(): QueryBuilder<T, Record<string, any>>;
+    /**
+     * @description Selects a SQL function applied to a column with a typed alias.
+     * @description Provides intellisense for common SQL functions while accepting any custom function.
+     * @description Return type is auto-inferred based on function name (number for count/sum/avg, string for upper/lower/trim, etc.)
+     * @param sqlFunc The SQL function name (count, sum, avg, min, max, upper, lower, etc.)
+     * @param column The column to apply the function to (use "*" for count(*))
+     * @param alias The alias for the result
+     * @example
+     * ```ts
+     * const result = await sql.query("users")
+     *   .selectFunc("count", "*", "total")
+     *   .one();
+     * // result type: { total: number } | null - auto-inferred!
+     * ```
+     */
+    selectFunc<F extends SqlFunction, Alias extends string>(sqlFunc: F, column: string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
+        [K in Alias]: SqlFunctionReturnType<F>;
+    }>>;
     /**
      * @description Selects a subquery, subquery must return a single column
      */
@@ -3685,54 +3629,6 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     selectJsonRaw<ValueType = any, Alias extends string = string>(raw: string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
         [K in Alias]: ValueType;
     }>>;
-    selectCount<Alias extends string = string>(column: ModelKey<T> | "*" | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
-    selectSum<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
-    selectAvg<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
-    selectMin<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: any;
-    }>>;
-    selectMax<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: any;
-    }>>;
-    selectCountDistinct<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
-    selectUpper<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: string;
-    }>>;
-    selectLower<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: string;
-    }>>;
-    selectLength<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
-    selectTrim<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: string;
-    }>>;
-    selectAbs<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
-    selectRound<Alias extends string = string>(column: ModelKey<T> | string, decimals: number, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
-    selectCoalesce<ValueType = any, Alias extends string = string>(column: ModelKey<T> | string, defaultValue: string | number, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: ValueType;
-    }>>;
-    selectCeil<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
-    selectFloor<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
-    selectSqrt<Alias extends string = string>(column: ModelKey<T> | string, alias: Alias): QueryBuilder<T, ComposeRawSelect<S, {
-        [K in Alias]: number;
-    }>>;
     /**
      * @description Executes the query and returns true if the query returns at least one result, false otherwise.
      */
@@ -4086,6 +3982,40 @@ declare class DryQueryBuilder<T extends Model = any, S extends Record<string, an
 }
 
 type PluckReturnType<T extends Model, K extends ModelKey<T>> = T[K] extends infer U ? U[] : never;
+/**
+ * Common SQL functions with intellisense support.
+ * Provides autocomplete for standard SQL aggregate and scalar functions,
+ * while still allowing any custom function name via string fallback.
+ *
+ * @example
+ * selectFunc("count", "*", "total")     // Intellisense suggests "count"
+ * selectFunc("custom_fn", "col", "res") // Custom functions still work
+ */
+type SqlFunction = "count" | "sum" | "avg" | "min" | "max" | "upper" | "lower" | "length" | "trim" | "abs" | "round" | "coalesce" | "ceil" | "floor" | "sqrt" | (string & {});
+/**
+ * Maps SQL function names to their return types.
+ * Used by selectFunc to auto-infer the result type.
+ *
+ * - Numeric functions (count, sum, avg, etc.) → number
+ * - String functions (upper, lower, trim) → string
+ * - Unknown functions → any
+ */
+type SqlFunctionReturnType<F extends string> = F extends "count" | "sum" | "avg" | "min" | "max" | "length" | "abs" | "round" | "ceil" | "floor" | "sqrt" ? number : F extends "upper" | "lower" | "trim" ? string : any;
+/**
+ * A tuple type for selecting a column with an alias.
+ * @example ["id", "userId"] selects "id" column as "userId"
+ */
+type SelectTuple<C extends string = string, A extends string = string> = readonly [column: C, alias: A];
+/**
+ * Input type for select() method in raw query builder.
+ * Accepts either a column string or a [column, alias] tuple.
+ *
+ * @example
+ * .select("id", "name")                    // Simple columns
+ * .select(["id", "userId"], ["name", "n"]) // Columns with aliases
+ * .select("id", ["name", "userName"])      // Mixed
+ */
+type Selectable = string | SelectTuple;
 /**
  * Unique symbol used internally to mark that a raw select() has been called.
  */
@@ -4103,41 +4033,52 @@ type RawSelectBrand = {
  */
 type UnionToIntersection$1<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 /**
- * Extracts the final property name from a column selection string for raw queries.
+ * Extracts the final property name from a column selection for raw queries.
+ * Supports both string columns and [column, alias] tuples.
  *
- * | Input                    | Output        |
- * |--------------------------|---------------|
- * | `"name"`                 | `"name"`      |
- * | `"users.name"`           | `"name"`      |
- * | `"name as userName"`     | `"userName"`  |
- * | `"count(*) as total"`    | `"total"`     |
- * | `"*"`                    | `never`       |
- * | `"users.*"`              | `never`       |
+ * | Input                        | Output        |
+ * |------------------------------|---------------|
+ * | `"name"`                     | `"name"`      |
+ * | `"users.name"`               | `"name"`      |
+ * | `["name", "userName"]`       | `"userName"`  |
+ * | `["users.id", "id"]`         | `"id"`        |
+ * | `"*"`                        | `never`       |
+ * | `"users.*"`                  | `never`       |
  */
-type ExtractRawColumnName<S extends string> = S extends `${string} as ${infer Alias}` ? Alias : S extends "*" ? never : S extends `${string}.*` ? never : S extends `${string}.${infer Column}` ? Column extends "*" ? never : Column : S;
+type ExtractRawColumnName<S> = S extends readonly [
+    string,
+    infer Alias extends string
+] ? Alias : S extends string ? S extends "*" ? never : S extends `${string}.*` ? never : S extends `${string}.${infer Column}` ? Column extends "*" ? never : Column : S : never;
 /**
  * Builds the type for a single selected column in a raw query.
  * All column types are `any` since we don't have model type information.
+ * Supports both string columns and [column, alias] tuples.
  *
- * | Selection          | Result Type                           |
- * |--------------------|---------------------------------------|
- * | `"*"`              | `Record<string, any>`                 |
- * | `"table.*"`        | `Record<string, any>`                 |
- * | `"column"`         | `{ column: any }`                     |
- * | `"col as alias"`   | `{ alias: any }`                      |
+ * | Selection              | Result Type                           |
+ * |------------------------|---------------------------------------|
+ * | `"*"`                  | `Record<string, any>`                 |
+ * | `"table.*"`            | `Record<string, any>`                 |
+ * | `"column"`             | `{ column: any }`                     |
+ * | `["col", "alias"]`     | `{ alias: any }`                      |
  *
  * @internal
  */
-type BuildRawSingleSelectType<S extends string> = S extends "*" ? Record<string, any> : S extends `${string}.*` ? Record<string, any> : ExtractRawColumnName<S> extends never ? {} : {
-    [K in ExtractRawColumnName<S>]: any;
-};
+type BuildRawSingleSelectType<S> = S extends readonly [
+    string,
+    infer Alias extends string
+] ? {
+    [K in Alias]: any;
+} : S extends string ? S extends "*" ? Record<string, any> : S extends `${string}.*` ? Record<string, any> : ExtractRawColumnName<S> extends never ? {} : {
+    [K in ExtractRawColumnName<S> & string]: any;
+} : {};
 /**
  * Checks if a column selection includes wildcards or is empty.
  * @internal
  */
-type HasRawStarOrEmpty<Columns extends readonly string[]> = Columns["length"] extends 0 ? true : "*" extends Columns[number] ? true : false;
+type HasRawStarOrEmpty<Columns extends readonly Selectable[]> = Columns["length"] extends 0 ? true : "*" extends Columns[number] ? true : false;
 /**
  * Builds the combined TypeScript type for multiple selected columns in a raw query.
+ * Supports both string columns and [column, alias] tuples.
  *
  * ## Rules
  *
@@ -4146,8 +4087,8 @@ type HasRawStarOrEmpty<Columns extends readonly string[]> = Columns["length"] ex
  * 3. **With `table.*`**: Adds `Record<string, any>` to allow unknown properties
  *
  * @example
- * // .select("name", "age as userAge")
- * BuildRawSelectType<["name", "age as userAge"]>
+ * // .select("name", ["age", "userAge"])
+ * BuildRawSelectType<["name", ["age", "userAge"]]>
  * // Result: { name: any; userAge: any } & RawSelectBrand
  *
  * @example
@@ -4155,8 +4096,8 @@ type HasRawStarOrEmpty<Columns extends readonly string[]> = Columns["length"] ex
  * BuildRawSelectType<["*"]>
  * // Result: Record<string, any>
  */
-type BuildRawSelectType<Columns extends readonly string[]> = HasRawStarOrEmpty<Columns> extends true ? Record<string, any> : UnionToIntersection$1<{
-    [K in keyof Columns]: Columns[K] extends string ? BuildRawSingleSelectType<Columns[K]> : {};
+type BuildRawSelectType<Columns extends readonly Selectable[]> = HasRawStarOrEmpty<Columns> extends true ? Record<string, any> : UnionToIntersection$1<{
+    [K in keyof Columns]: BuildRawSingleSelectType<Columns[K]>;
 }[number]> extends infer Result ? Result extends Record<string, any> ? keyof Result extends never ? Record<string, any> : Result & RawSelectBrand : Record<string, any> : Record<string, any>;
 /**
  * Composes a new selection with the existing selection state for raw queries.
@@ -4186,10 +4127,15 @@ type ComposeRawSelect<S extends Record<string, any>, Added extends Record<string
  * @typeParam S - Current selection state
  * @typeParam Columns - The columns being selected
  */
-type ComposeBuildRawSelect<S extends Record<string, any>, Columns extends readonly string[]> = (typeof RAW_SELECT_BRAND extends keyof S ? S : {}) & BuildRawSelectType<Columns>;
+type ComposeBuildRawSelect<S extends Record<string, any>, Columns extends readonly Selectable[]> = (typeof RAW_SELECT_BRAND extends keyof S ? S : {}) & BuildRawSelectType<Columns>;
 type WhereOnlyQueryBuilder<T extends Model> = Pick<WhereQueryBuilder<T>, "where" | "andWhere" | "orWhere" | "whereNot" | "andWhereNot" | "orWhereNot" | "whereIn" | "andWhereIn" | "orWhereIn" | "whereNotIn" | "andWhereNotIn" | "orWhereNotIn" | "whereBetween" | "andWhereBetween" | "orWhereBetween" | "whereNotBetween" | "andWhereNotBetween" | "orWhereNotBetween" | "whereNull" | "andWhereNull" | "orWhereNull" | "whereNotNull" | "andWhereNotNull" | "orWhereNotNull" | "whereLike" | "andWhereLike" | "orWhereLike" | "whereILike" | "andWhereILike" | "orWhereILike" | "whereNotLike" | "andWhereNotLike" | "orWhereNotLike" | "whereNotILike" | "andWhereNotILike" | "orWhereNotILike" | "whereRegexp" | "andWhereRegexp" | "orWhereRegexp" | "whereNotRegexp" | "andWhereNotRegexp" | "orWhereNotRegexp" | "whereRaw" | "andWhereRaw" | "orWhereRaw" | "whereExists" | "orWhereExists" | "andWhereExists"> & Pick<JsonQueryBuilder<T>, "whereJson" | "andWhereJson" | "orWhereJson" | "whereJsonContains" | "andWhereJsonContains" | "orWhereJsonContains" | "whereJsonNotContains" | "andWhereJsonNotContains" | "orWhereJsonNotContains" | "whereJsonNotContains" | "andWhereJsonNotContains" | "orWhereJsonNotContains" | "whereJsonRaw" | "andWhereJsonRaw" | "orWhereJsonRaw" | "whereJsonNotContains" | "andWhereJsonNotContains" | "orWhereJsonNotContains">;
 type RelationRetrieveMethod<P extends any> = P extends any[] ? "many" : "one";
-type SelectableColumn$1<T extends string = string> = T extends `${infer Table}.${infer Column}.${string}` ? never : T extends `${string}(${string})` ? T : T extends `${string} as ${string}` ? T : T extends `${string} ${string}` ? never : T extends `.${string}` | `${string}.` ? never : T extends `${string}-${string}` ? never : T extends `${string}.${string}` ? T : T;
+/**
+ * Validates a column string for raw query builder select().
+ * Use [column, alias] tuple format for aliases instead of "column as alias".
+ * Use selectFunction() for SQL functions instead of embedding them in select().
+ */
+type SelectableColumn$1<T extends string = string> = T extends `${string}.${string}.${string}` ? never : T extends `${string} ${string}` ? never : T extends `.${string}` | `${string}.` ? never : T extends `${string}-${string}` ? never : T extends `${string}.${string}` ? T : T;
 /**
  * @description A column that can be used in a join statement e.g. `users.id`
  */
@@ -4405,7 +4351,7 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     }): Promise<PaginatedData<T, S, R>>;
     /**
      * @description Adds columns to the SELECT clause with full type safety.
-     * @description Supports formats: "column", "table.column", "column as alias", "*", "table.*"
+     * @description Supports formats: "column", "table.column", "*", "table.*", or [column, alias] tuples
      * @description When columns are selected, the return type reflects only those columns
      * @warning This only allows selecting columns that are part of the model. For other columns, use `selectRaw`.
      * @example
@@ -4413,14 +4359,14 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
      * // Select specific columns - return type is { id: number, name: string }
      * const users = await User.query().select("id", "name").many();
      *
-     * // Select with alias - return type includes the alias
-     * const users = await User.query().select("id as userId").many();
+     * // Select with alias using tuple - return type includes the alias
+     * const users = await User.query().select(["id", "userId"]).many();
      *
      * // Select all - return type is the full model
      * const users = await User.query().select("*").many();
      * ```
      */
-    select<Columns extends readonly SelectableColumn<T>[]>(...columns: Columns): ModelQueryBuilder<T, ComposeBuildSelect<S, T, Columns extends readonly string[] ? Columns : readonly string[]>, R>;
+    select<const Columns extends readonly ModelSelectableInput<T>[]>(...columns: Columns): ModelQueryBuilder<T, ComposeBuildSelect<S, T, Columns extends readonly (string | readonly [string, string])[] ? Columns : readonly (string | readonly [string, string])[]>, R>;
     /**
      * @description Adds a raw SELECT statement with type-safe return type.
      * @description Use the generic parameter to specify the type of the selected columns.
@@ -4441,6 +4387,30 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
      * ```
      */
     selectRaw<Added extends Record<string, any> = Record<string, any>>(statement: string): ModelQueryBuilder<T, ComposeSelect<S, Added>, R>;
+    /**
+     * @description Selects a SQL function applied to a column with a typed alias.
+     * @description Provides intellisense for common SQL functions while accepting any custom function.
+     * @description Return type is auto-inferred based on function name (number for count/sum/avg, string for upper/lower/trim, etc.)
+     * @param sqlFunc The SQL function name (count, sum, avg, min, max, upper, lower, etc.)
+     * @param column The column to apply the function to (use "*" for count(*))
+     * @param alias The alias for the result
+     * @example
+     * ```ts
+     * const users = await User.query()
+     *   .selectFunc("count", "*", "total")
+     *   .many();
+     * // users[0].total is typed as number - auto-inferred!
+     *
+     * const users = await User.query()
+     *   .select("id")
+     *   .selectFunc("upper", "name", "upperName")
+     *   .many();
+     * // users[0] is { id: number, upperName: string } - auto-inferred!
+     * ```
+     */
+    selectFunc<F extends SqlFunction, Alias extends string>(sqlFunc: F, column: ModelKey<T> | "*" | (string & {}), alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
+        [K in Alias]: SqlFunctionReturnType<F>;
+    }>, R>;
     /**
      * @description Selects a subquery with a typed alias
      * @param cbOrQueryBuilder A callback that receives a QueryBuilder or a QueryBuilder instance
@@ -4666,241 +4636,6 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     selectJsonRaw<ValueType = any, Alias extends string = string>(raw: string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
         [K in Alias]: ValueType;
     }>, R>;
-    /**
-     * @description Selects COUNT(column) with a typed alias
-     * @param column The column to count (use "*" for COUNT(*), supports "table.column" format)
-     * @param alias The alias for the count result
-     * @example
-     * ```ts
-     * // Count all rows
-     * const result = await User.query().selectCount("*", "totalUsers").one();
-     * console.log(result?.totalUsers); // Typed as number
-     *
-     * // Count specific column
-     * const result = await User.query().selectCount("id", "userCount").one();
-     *
-     * // With table prefix
-     * const result = await User.query().selectCount("users.id", "total").one();
-     * ```
-     */
-    selectCount<Alias extends string>(column: ModelKey<T> | "*" | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects SUM(column) with a typed alias
-     * @param column The column to sum (supports "table.column" format)
-     * @param alias The alias for the sum result
-     * @example
-     * ```ts
-     * const result = await Order.query().selectSum("amount", "totalAmount").one();
-     * console.log(result?.totalAmount); // Typed as number
-     *
-     * // With table prefix
-     * const result = await Order.query().selectSum("orders.amount", "total").one();
-     * ```
-     */
-    selectSum<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects AVG(column) with a typed alias
-     * @param column The column to average (supports "table.column" format)
-     * @param alias The alias for the average result
-     * @example
-     * ```ts
-     * const result = await User.query().selectAvg("age", "averageAge").one();
-     * console.log(result?.averageAge); // Typed as number
-     *
-     * // With table prefix
-     * const result = await User.query().selectAvg("users.age", "avgAge").one();
-     * ```
-     */
-    selectAvg<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects MIN(column) with a typed alias
-     * @param column The column to get minimum value (supports "table.column" format)
-     * @param alias The alias for the min result
-     * @example
-     * ```ts
-     * const result = await User.query().selectMin("age", "youngestAge").one();
-     * console.log(result?.youngestAge); // Typed as number
-     *
-     * // With table prefix
-     * const result = await User.query().selectMin("users.age", "minAge").one();
-     * ```
-     */
-    selectMin<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects MAX(column) with a typed alias
-     * @param column The column to get maximum value (supports "table.column" format)
-     * @param alias The alias for the max result
-     * @example
-     * ```ts
-     * const result = await User.query().selectMax("age", "oldestAge").one();
-     * console.log(result?.oldestAge); // Typed as number
-     *
-     * // With table prefix
-     * const result = await User.query().selectMax("users.age", "maxAge").one();
-     * ```
-     */
-    selectMax<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects COUNT(DISTINCT column) with a typed alias
-     * @param column The column to count distinct values (supports "table.column" format)
-     * @param alias The alias for the count result
-     * @example
-     * ```ts
-     * const result = await User.query().selectCountDistinct("email", "uniqueEmails").one();
-     * console.log(result?.uniqueEmails); // Typed as number
-     * ```
-     */
-    selectCountDistinct<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects UPPER(column) with a typed alias
-     * @param column The column to convert to uppercase
-     * @param alias The alias for the result
-     * @example
-     * ```ts
-     * const result = await User.query().selectUpper("name", "upperName").one();
-     * console.log(result?.upperName); // Typed as string
-     * ```
-     */
-    selectUpper<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: string;
-    }>, R>;
-    /**
-     * @description Selects LOWER(column) with a typed alias
-     * @param column The column to convert to lowercase
-     * @param alias The alias for the result
-     * @example
-     * ```ts
-     * const result = await User.query().selectLower("name", "lowerName").one();
-     * console.log(result?.lowerName); // Typed as string
-     * ```
-     */
-    selectLower<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: string;
-    }>, R>;
-    /**
-     * @description Selects LENGTH(column) with a typed alias
-     * @param column The column to get length of
-     * @param alias The alias for the result
-     * @note MSSQL uses LEN() instead of LENGTH(), handled automatically
-     * @example
-     * ```ts
-     * const result = await User.query().selectLength("name", "nameLength").one();
-     * console.log(result?.nameLength); // Typed as number
-     * ```
-     */
-    selectLength<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects TRIM(column) with a typed alias
-     * @param column The column to trim whitespace from
-     * @param alias The alias for the result
-     * @example
-     * ```ts
-     * const result = await User.query().selectTrim("name", "trimmedName").one();
-     * console.log(result?.trimmedName); // Typed as string
-     * ```
-     */
-    selectTrim<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: string;
-    }>, R>;
-    /**
-     * @description Selects ABS(column) with a typed alias
-     * @param column The column to get absolute value of
-     * @param alias The alias for the result
-     * @example
-     * ```ts
-     * const result = await Order.query().selectAbs("balance", "absoluteBalance").one();
-     * console.log(result?.absoluteBalance); // Typed as number
-     * ```
-     */
-    selectAbs<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects ROUND(column, decimals) with a typed alias
-     * @param column The column to round
-     * @param decimals Number of decimal places
-     * @param alias The alias for the result
-     * @postgres Not fully supported - ROUND with precision requires NUMERIC type, not REAL/FLOAT
-     * @cockroachdb Not fully supported - ROUND with precision requires NUMERIC type, not REAL/FLOAT
-     * @example
-     * ```ts
-     * const result = await Order.query().selectRound("price", 2, "roundedPrice").one();
-     * console.log(result?.roundedPrice); // Typed as number
-     * ```
-     */
-    selectRound<Alias extends string>(column: ModelKey<T> | string, decimals: number, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects COALESCE(column, defaultValue) with a typed alias
-     * @param column The column to check for NULL
-     * @param defaultValue The value to use if column is NULL
-     * @param alias The alias for the result
-     * @example
-     * ```ts
-     * const result = await User.query().selectCoalesce("nickname", "'Unknown'", "displayName").one();
-     * console.log(result?.displayName); // Typed as any (depends on column type)
-     * ```
-     */
-    selectCoalesce<Alias extends string>(column: ModelKey<T> | string, defaultValue: string | number, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: any;
-    }>, R>;
-    /**
-     * @description Selects CEIL(column) with a typed alias (rounds up to nearest integer)
-     * @param column The column to round up
-     * @param alias The alias for the result
-     * @sqlite Not supported - SQLite does not have a native CEIL function
-     * @mssql Uses CEILING instead of CEIL (handled automatically)
-     * @example
-     * ```ts
-     * const result = await Order.query().selectCeil("price", "ceilPrice").one();
-     * console.log(result?.ceilPrice); // Typed as number
-     * ```
-     */
-    selectCeil<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects FLOOR(column) with a typed alias (rounds down to nearest integer)
-     * @param column The column to round down
-     * @param alias The alias for the result
-     * @sqlite Not supported - SQLite does not have a native FLOOR function
-     * @example
-     * ```ts
-     * const result = await Order.query().selectFloor("price", "floorPrice").one();
-     * console.log(result?.floorPrice); // Typed as number
-     * ```
-     */
-    selectFloor<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
-    /**
-     * @description Selects SQRT(column) with a typed alias (square root)
-     * @param column The column to get square root of
-     * @param alias The alias for the result
-     * @example
-     * ```ts
-     * const result = await Data.query().selectSqrt("value", "sqrtValue").one();
-     * console.log(result?.sqrtValue); // Typed as number
-     * ```
-     */
-    selectSqrt<Alias extends string>(column: ModelKey<T> | string, alias: Alias): ModelQueryBuilder<T, ComposeSelect<S, {
-        [K in Alias]: number;
-    }>, R>;
     /**
      * @description Fills the relations in the model in the serialized response. Relation must be defined in the model.
      * @warning Many to many relations have special behavior, since they require a join, a join clause will always be added to the query.
@@ -5680,7 +5415,117 @@ type ExcludeMethods<T> = {
  * like save(), delete(), refresh() are not incorrectly included.
  */
 type ModelDataProperties = Pick<Model, ExcludeMethods<Model>>;
+/**
+ * Model instance methods available on query results.
+ * These methods enable CRUD operations on fetched models.
+ *
+ * All query results from Model static methods (find, findOne, findOneOrFail,
+ * findBy, findOneBy, findOneByPrimaryKey, all, first, insert, insertMany,
+ * upsert, upsertMany, updateRecord, softDelete) and from ModelQueryBuilder
+ * (one, many, oneOrFail) include these instance methods.
+ *
+ * @example
+ * ```typescript
+ * // Using instance methods on query results
+ * const user = await User.findOne({ where: { email: "test@example.com" } });
+ * if (user) {
+ *   user.mergeProps({ name: "Updated Name" });
+ *   await user.save();
+ *
+ *   // Or update directly
+ *   await user.update({ name: "Another Name" });
+ *
+ *   // Refresh from database
+ *   await user.refresh();
+ *
+ *   // Soft delete or hard delete
+ *   await user.softDelete();
+ *   // or: await user.delete();
+ * }
+ *
+ * // Works with query builder too
+ * const user2 = await User.query().where("id", 1).oneOrFail();
+ * await user2.update({ status: "inactive" });
+ *
+ * // Works with select projections
+ * const user3 = await User.query().select("id", "name").one();
+ * if (user3) {
+ *   await user3.delete(); // Still has access to instance methods
+ * }
+ * ```
+ *
+ * Note: These signatures are simplified versions that don't carry the
+ * `this: T extends Model` constraint, allowing them to work on selected
+ * model results without requiring full Model type compatibility.
+ */
+type ModelInstanceMethods<T extends Model> = {
+    /**
+     * Merges the provided data with the model instance.
+     * Does not persist to database - use save() or update() after merging.
+     */
+    mergeProps: (data: Partial<ModelWithoutRelations<T>>) => void;
+    /**
+     * Saves the model to the database (insert or update based on primary key).
+     * @throws {HysteriaError} If the model has no primary key defined
+     */
+    save: (options?: Omit<BaseModelMethodOptions, "ignoreHooks">) => Promise<any>;
+    /**
+     * Updates the model in the database with the provided payload.
+     * @throws {HysteriaError} If the model has no primary key or primary key value
+     */
+    update: (payload: Partial<ModelWithoutRelations<T>>, options?: Omit<BaseModelMethodOptions, "ignoreHooks">) => Promise<void>;
+    /**
+     * Soft deletes the model by setting the soft delete column.
+     * @throws {HysteriaError} If the model has no primary key or primary key value
+     */
+    softDelete: (softDeleteOptions?: {
+        column?: string;
+        value?: string | number | boolean | Date;
+    }, options?: Omit<BaseModelMethodOptions, "ignoreHooks">) => Promise<void>;
+    /**
+     * Hard deletes the model from the database.
+     * @throws {HysteriaError} If the model has no primary key or primary key value
+     */
+    delete: (options?: Omit<BaseModelMethodOptions, "ignoreHooks">) => Promise<void>;
+    /**
+     * Refreshes the model from the database, updating all properties with current values.
+     * @throws {HysteriaError} If the model has no primary key or primary key value
+     */
+    refresh: (options?: Omit<BaseModelMethodOptions, "ignoreHooks">) => Promise<any>;
+};
+/**
+ * Model data without relation properties.
+ * Includes only data columns from the model, excluding foreign keys and relation accessors.
+ */
 type ModelWithoutRelations<T extends Model> = Pick<Omit<T, "*">, ExcludeRelations<Omit<T, "*">>> & ModelDataProperties;
+/**
+ * Return type for Model query/mutation methods.
+ * Combines data properties with instance methods for CRUD operations.
+ *
+ * This type is used as the return type for:
+ * - Static find methods: find, findOne, findOneOrFail, findBy, findOneBy, findOneByPrimaryKey
+ * - Static retrieval methods: all, first
+ * - Static mutation methods: insert, insertMany, upsert, upsertMany, updateRecord, softDelete
+ * - Static refresh method: refresh
+ *
+ * @example
+ * ```typescript
+ * // All these methods return ModelQueryResult<User> (or arrays/nullables thereof)
+ * const user1 = await User.findOne({ where: { id: 1 } });
+ * const user2 = await User.findOneOrFail({ where: { id: 1 } });
+ * const users = await User.find({});
+ * const allUsers = await User.all();
+ * const newUser = await User.insert({ name: "John" });
+ *
+ * // Each result has instance methods available
+ * if (user1) {
+ *   await user1.update({ name: "Jane" });
+ *   await user1.refresh();
+ *   await user1.delete();
+ * }
+ * ```
+ */
+type ModelQueryResult<T extends Model> = ModelWithoutRelations<T> & ModelInstanceMethods<T>;
 type NumberModelKey<T extends Model> = {
     [K in keyof T]: T[K] extends number | bigint ? K : never;
 }[keyof T];
@@ -5779,7 +5624,9 @@ type RelatedInstance<M extends Model, K extends ModelRelation<M>> = NonNullable<
  */
 type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 /**
- * Represents all valid column selection formats with intellisense support.
+ * Represents valid string column selection formats with intellisense support.
+ * Use [column, alias] tuple format for aliases instead of "column as alias".
+ * Use selectFunction() for SQL functions instead of embedding them in select().
  *
  * ## Supported Formats
  *
@@ -5787,7 +5634,6 @@ type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (
  * |---------------------------|--------------------------|--------------------------------|
  * | Model column              | `"name"`                 | Direct column with intellisense |
  * | Qualified column          | `"users.name"`           | Table-prefixed column          |
- * | Aliased column            | `"name as userName"`     | Column with custom alias       |
  * | Wildcard                  | `"*"`                    | Select all from primary table  |
  * | Table wildcard            | `"users.*"`              | Select all from specific table |
  *
@@ -5795,17 +5641,32 @@ type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (
  * User.query().select(
  *   "name",                    // Model column with intellisense
  *   "users.email",             // Qualified column
- *   "age as userAge",          // Aliased column
  *   "*"                        // All columns
  * );
  */
-type SelectableColumn<T extends Model> = ModelKey<T> | `${string}.${string | "*"}` | `${ModelKey<T> & string} as ${string}` | `${string}(${string}) as ${string}` | "*";
+type SelectableColumn<T extends Model> = ModelKey<T> | `${string}.${string | "*"}` | "*";
 /**
- * Extracts the final property name from a column selection string.
+ * A tuple type for selecting a column with an alias in ModelQueryBuilder.
+ * @example ["id", "userId"] selects "id" column as "userId"
+ */
+type ModelSelectTuple<T extends Model, C extends ModelKey<T> | `${string}.${string}` = ModelKey<T> | `${string}.${string}`, A extends string = string> = readonly [column: C, alias: A];
+/**
+ * Input type for select() method in ModelQueryBuilder.
+ * Accepts either a column string or a [column, alias] tuple for aliasing.
+ *
+ * @example
+ * .select("id", "name")                           // Simple columns
+ * .select(["id", "userId"], ["name", "userName"]) // Columns with aliases
+ * .select("id", ["name", "userName"])             // Mixed
+ */
+type ModelSelectableInput<T extends Model> = SelectableColumn<T> | ModelSelectTuple<T>;
+/**
+ * Extracts the final property name from a column selection.
+ * Supports both string columns and [column, alias] tuples.
  *
  * This type determines what property name will be available on the result:
  * - Plain columns use their name directly
- * - Aliased columns use the alias
+ * - Tuples use the alias (second element)
  * - Wildcards return `never` (handled specially to return full model)
  *
  * ## Extraction Rules
@@ -5814,12 +5675,26 @@ type SelectableColumn<T extends Model> = ModelKey<T> | `${string}.${string | "*"
  * |--------------------------|---------------|--------------------------------|
  * | `"name"`                 | `"name"`      | Direct column                  |
  * | `"users.name"`           | `"name"`      | Extract column from qualified  |
- * | `"name as userName"`     | `"userName"`  | Use alias                      |
- * | `"users.name as author"` | `"author"`    | Alias takes precedence         |
+ * | `["name", "userName"]`   | `"userName"`  | Use alias from tuple           |
+ * | `["users.id", "id"]`     | `"id"`        | Use alias from tuple           |
  * | `"*"`                    | `never`       | Wildcard - full model          |
  * | `"users.*"`              | `never`       | Table wildcard - Record<>      |
  */
-type ExtractColumnName<S extends string> = S extends `${string} as ${infer Alias}` ? Alias : S extends "*" ? never : S extends `${string}.*` ? never : S extends `${string}.${infer Column}` ? Column extends "*" ? never : Column : S;
+type ExtractColumnName<S> = S extends readonly [
+    string,
+    infer Alias extends string
+] ? Alias : S extends string ? S extends "*" ? never : S extends `${string}.*` ? never : S extends `${string}.${infer Column}` ? Column extends "*" ? never : Column : S : never;
+/**
+ * Extracts the source column name from a selectable input.
+ * For strings, returns the column part (after last dot if qualified).
+ * For tuples, returns the first element (the column).
+ *
+ * @internal
+ */
+type ExtractSourceColumn<S> = S extends readonly [
+    infer Column extends string,
+    string
+] ? Column extends `${string}.${infer Col}` ? Col : Column : S extends string ? S extends `${string}.${infer Column}` ? Column : S : never;
 /**
  * Resolves the TypeScript type for a selected column.
  *
@@ -5834,28 +5709,34 @@ type ExtractColumnName<S extends string> = S extends `${string} as ${infer Alias
 type GetColumnType<T extends Model, ColumnName extends string> = ColumnName extends keyof ModelWithoutRelations<T> ? ModelWithoutRelations<T>[ColumnName] : any;
 /**
  * Builds the type for a single selected column.
+ * Supports both string columns and [column, alias] tuples.
  *
  * ## Type Resolution
  *
- * | Selection          | Result Type                           |
- * |--------------------|---------------------------------------|
- * | `"*"`              | `ModelWithoutRelations<T>` (full)     |
- * | `"table.*"`        | `Record<string, any>` (unknown shape) |
- * | `"column"`         | `{ column: ColumnType }`              |
- * | `"col as alias"`   | `{ alias: ColumnType }`               |
+ * | Selection              | Result Type                           |
+ * |------------------------|---------------------------------------|
+ * | `"*"`                  | `ModelWithoutRelations<T>` (full)     |
+ * | `"table.*"`            | `Record<string, any>` (unknown shape) |
+ * | `"column"`             | `{ column: ColumnType }`              |
+ * | `["col", "alias"]`     | `{ alias: ColumnType }`               |
  *
  * @internal
  */
-type BuildSingleSelectType<T extends Model, S extends string> = S extends "*" ? ModelWithoutRelations<T> : S extends `${string}.*` ? Record<string, any> : ExtractColumnName<S> extends never ? {} : {
-    [K in ExtractColumnName<S>]: GetColumnType<T, ExtractColumnName<S>>;
-};
+type BuildSingleSelectType<T extends Model, S> = S extends readonly [
+    infer Column extends string,
+    infer Alias extends string
+] ? {
+    [K in Alias]: GetColumnType<T, ExtractSourceColumn<S> & string>;
+} : S extends string ? S extends "*" ? ModelWithoutRelations<T> : S extends `${string}.*` ? Record<string, any> : ExtractColumnName<S> extends never ? {} : {
+    [K in ExtractColumnName<S> & string]: GetColumnType<T, ExtractColumnName<S> & string>;
+} : {};
 /**
  * Checks if a column selection includes wildcards or is empty.
  * Used to determine if the full model type should be returned.
  *
  * @internal
  */
-type HasStarOrEmpty<Columns extends readonly string[]> = Columns["length"] extends 0 ? true : "*" extends Columns[number] ? true : false;
+type HasStarOrEmpty<Columns extends readonly (string | readonly [string, string])[]> = Columns["length"] extends 0 ? true : "*" extends Columns[number] ? true : false;
 /**
  * Unique symbol used internally to mark that a select() has been called.
  */
@@ -5873,6 +5754,7 @@ type SelectBrand = {
 };
 /**
  * Builds the combined TypeScript type for multiple selected columns.
+ * Supports both string columns and [column, alias] tuples.
  *
  * This is the main type used to compute the return type of `select()` calls.
  * It handles all the complexity of combining multiple column selections into
@@ -5886,8 +5768,8 @@ type SelectBrand = {
  * 4. **Always includes**: Base `Model` methods (save, delete, etc.)
  *
  * @example
- * // .select("name", "age as userAge")
- * BuildSelectType<User, ["name", "age as userAge"]>
+ * // .select("name", ["age", "userAge"])
+ * BuildSelectType<User, ["name", ["age", "userAge"]]>
  * // Result: { name: string; userAge: number } & Pick<Model, keyof Model>
  *
  * @example
@@ -5895,8 +5777,8 @@ type SelectBrand = {
  * BuildSelectType<User, ["*"]>
  * // Result: ModelWithoutRelations<User> (all columns)
  */
-type BuildSelectType<T extends Model, Columns extends readonly string[]> = HasStarOrEmpty<Columns> extends true ? ModelWithoutRelations<T> : UnionToIntersection<{
-    [K in keyof Columns]: Columns[K] extends string ? BuildSingleSelectType<T, Columns[K]> : {};
+type BuildSelectType<T extends Model, Columns extends readonly (string | readonly [string, string])[]> = HasStarOrEmpty<Columns> extends true ? ModelWithoutRelations<T> : UnionToIntersection<{
+    [K in keyof Columns]: BuildSingleSelectType<T, Columns[K]>;
 }[number]> extends infer Result ? Result extends Record<string, any> ? keyof Result extends never ? ModelWithoutRelations<T> : Result & ModelDataProperties & SelectBrand : ModelWithoutRelations<T> : ModelWithoutRelations<T>;
 /**
  * Composes a new selection with the existing selection state.
@@ -5923,6 +5805,7 @@ type BuildSelectType<T extends Model, Columns extends readonly string[]> = HasSt
 type ComposeSelect<S extends Record<string, any>, Added extends Record<string, any>> = (typeof SELECT_BRAND extends keyof S ? S : ModelDataProperties & SelectBrand) & Added;
 /**
  * Composes a BuildSelectType result with the existing selection state.
+ * Supports both string columns and [column, alias] tuples.
  *
  * Similar to ComposeSelect but designed for use with BuildSelectType which already
  * includes Pick<Model, keyof Model> and SelectBrand in its result.
@@ -5945,21 +5828,24 @@ type ComposeSelect<S extends Record<string, any>, Added extends Record<string, a
  * ComposeBuildSelect<{ count: number } & Pick<Model, keyof Model> & SelectBrand, User, ["id"]>
  * // Result: { count: number } & Pick<Model, keyof Model> & SelectBrand & { id: number }
  */
-type ComposeBuildSelect<S extends Record<string, any>, T extends Model, Columns extends readonly string[]> = (typeof SELECT_BRAND extends keyof S ? S : {}) & BuildSelectType<T, Columns>;
+type ComposeBuildSelect<S extends Record<string, any>, T extends Model, Columns extends readonly (string | readonly [string, string])[]> = (typeof SELECT_BRAND extends keyof S ? S : {}) & BuildSelectType<T, Columns>;
 /**
  * The final result type for ModelQueryBuilder queries.
  *
- * Combines selected columns (S) with loaded relations (R) into a single type.
+ * Combines selected columns (S) with loaded relations (R) and Model instance methods
+ * into a single type. This ensures query results have access to CRUD operations
+ * like save(), update(), delete(), etc.
  *
+ * @typeParam M - The Model type
  * @typeParam S - Selected columns type from `select()` calls
  * @typeParam R - Relations type from `load()` calls
  *
  * @example
  * // User.query().select("name").load("posts").one()
- * SelectedModel<{ name: string }, { posts: Post[] }>
- * // Result: { name: string; posts: Post[] }
+ * SelectedModel<User, { name: string }, { posts: Post[] }>
+ * // Result: { name: string; posts: Post[] } & ModelInstanceMethods
  */
-type SelectedModel<M extends Model, S extends Record<string, any> = {}, R extends Record<string, any> = {}> = S & R;
+type SelectedModel<M extends Model, S extends Record<string, any> = {}, R extends Record<string, any> = {}> = S & R & ModelInstanceMethods<M>;
 
 type NullableAndUndefinable<T> = T | (T | null) | (T | undefined) | (T | null | undefined);
 type UpsertOptions<T extends Model> = {
@@ -6047,7 +5933,7 @@ type FindOneType<T extends Model, S extends ModelKey<T>[] = any[], R extends Mod
 type FindType<T extends Model, S extends ModelKey<T>[] = any[], R extends ModelRelation<T>[] = never[]> = Omit<FindOneType<T, S, R>, "throwErrorOnNull"> & {
     limit?: number;
 };
-type FindReturnType<T extends Model, S extends ModelKey<T>[] = any[], R extends ModelRelation<T>[] = never[]> = S extends readonly any[] ? S[number] extends never ? ModelWithoutRelations<T> & {
+type FindReturnType<T extends Model, S extends ModelKey<T>[] = any[], R extends ModelRelation<T>[] = never[]> = (S extends readonly any[] ? S[number] extends never ? ModelWithoutRelations<T> & {
     [K in R[number] & keyof T]: T[K];
 } : {
     [K in S[number] & keyof T]: T[K];
@@ -6055,7 +5941,7 @@ type FindReturnType<T extends Model, S extends ModelKey<T>[] = any[], R extends
     [K in R[number] & keyof T]: T[K];
 } : ModelWithoutRelations<T> & {
     [K in R[number] & keyof T]: T[K];
-};
+}) & ModelInstanceMethods<T>;
 
 /**
  * @description Represents a Table in the Database
@@ -6091,7 +5977,7 @@ declare abstract class Model extends Entity {
     /**
      * @description Returns all the records for the given model
      */
-    static all<T extends Model>(this: new () => T | typeof Model, options?: BaseModelMethodOptions): Promise<ModelWithoutRelations<T>[]>;
+    static all<T extends Model>(this: new () => T | typeof Model, options?: BaseModelMethodOptions): Promise<ModelQueryResult<T>[]>;
     /**
      * @description Gives a query sqlInstance for the given model
      */
@@ -6105,7 +5991,7 @@ declare abstract class Model extends Entity {
      * @description Finds the first record in the database
      * @deprecated Used only for debugging purposes, use `.findOne` or `.query` instead
      */
-    static first<T extends Model>(this: new () => T | typeof Model, options?: BaseModelMethodOptions): Promise<ModelWithoutRelations<T> | null>;
+    static first<T extends Model>(this: new () => T | typeof Model, options?: BaseModelMethodOptions): Promise<ModelQueryResult<T> | null>;
     /**
      * @description Finds records for the given model
      */
@@ -6135,7 +6021,7 @@ declare abstract class Model extends Entity {
     /**
      * @description Refreshes a model from the database, the model must have a primary key defined
      */
-    static refresh<T extends Model>(this: new () => T | typeof Model, model: T, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): Promise<ModelWithoutRelations<T> | null>;
+    static refresh<T extends Model>(this: new () => T | typeof Model, model: T, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): Promise<ModelQueryResult<T> | null>;
     /**
      * @description Saves a new record to the database
      * @warning If not using postgres and the model has no primary key, the model will be saved, but it won't be possible to retrieve it so at that point it will be returned as null, this is not typed as Model | null for type safety reasons
@@ -6143,7 +6029,7 @@ declare abstract class Model extends Entity {
      * @sqlite If no Primary Key is present in the model definition, the model will be returned
      * @sqlite Returning Not supported and won't have effect
      */
-    static insert<T extends Model>(this: new () => T | typeof Model, modelData: Partial<ModelWithoutRelations<T>>, options?: BaseModelMethodOptions & InsertOptions<T>): Promise<ModelWithoutRelations<T>>;
+    static insert<T extends Model>(this: new () => T | typeof Model, modelData: Partial<ModelWithoutRelations<T>>, options?: BaseModelMethodOptions & InsertOptions<T>): Promise<ModelQueryResult<T>>;
     /**
      * @description Saves multiple records to the database
      * @warning If not using postgres and the model has no primary key, the models will be saved, but it won't be possible to retrieve them so at that point they will be returned as an empty array
@@ -6152,7 +6038,7 @@ declare abstract class Model extends Entity {
      * @sqlite Returning Not supported and won't have effect
      * @oracledb may do multiple inserts with auto-generated identity columns
      */
-    static insertMany<T extends Model>(this: new () => T | typeof Model, modelsData: Partial<ModelWithoutRelations<T>>[], options?: BaseModelMethodOptions & InsertOptions<T>): Promise<ModelWithoutRelations<T>[]>;
+    static insertMany<T extends Model>(this: new () => T | typeof Model, modelsData: Partial<ModelWithoutRelations<T>>[], options?: BaseModelMethodOptions & InsertOptions<T>): Promise<ModelQueryResult<T>[]>;
     /**
      * @description Syncs in the through table the given models for the given relation
      * @param relation The many to many relation to sync, this is not type safe since many to many relations defined at a decorator level
@@ -6174,7 +6060,7 @@ declare abstract class Model extends Entity {
      * @description Can only be used if the model has a primary key, use a massive update if the model has no primary key
      * @throws {HysteriaError} If the model has no primary key
      */
-    static updateRecord<T extends Model>(this: new () => T | typeof Model, modelSqlInstance: Partial<T>, updatePayload?: Partial<ModelWithoutRelations<T>>, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): Promise<ModelWithoutRelations<T>>;
+    static updateRecord<T extends Model>(this: new () => T | typeof Model, modelSqlInstance: Partial<T>, updatePayload?: Partial<ModelWithoutRelations<T>>, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): Promise<ModelQueryResult<T>>;
     /**
      * @description Finds the first record or creates a new one if it doesn't exist
      */
@@ -6187,12 +6073,12 @@ declare abstract class Model extends Entity {
     /**
      * @description Updates or creates a new record, if no searchCriteria payload is provided, provided data will be inserted as is
      */
-    static upsert<T extends Model>(this: new () => T | typeof Model, searchCriteria: Partial<ModelWithoutRelations<T>>, data: Partial<ModelWithoutRelations<T>>, options?: UpsertOptions<T> & BaseModelMethodOptions): Promise<ModelWithoutRelations<T>>;
+    static upsert<T extends Model>(this: new () => T | typeof Model, searchCriteria: Partial<ModelWithoutRelations<T>>, data: Partial<ModelWithoutRelations<T>>, options?: UpsertOptions<T> & BaseModelMethodOptions): Promise<ModelQueryResult<T>>;
     /**
      * @description Updates or creates multiple records
      * @param {updateOnConflict} If true, the record will be updated if it exists, otherwise it will be ignored
      */
-    static upsertMany<T extends Model>(this: new () => T | typeof Model, conflictColumns: ModelKey<T>[], data: Partial<ModelWithoutRelations<T>>[], options?: UpsertOptions<T> & BaseModelMethodOptions): Promise<ModelWithoutRelations<T>[]>;
+    static upsertMany<T extends Model>(this: new () => T | typeof Model, conflictColumns: ModelKey<T>[], data: Partial<ModelWithoutRelations<T>>[], options?: UpsertOptions<T> & BaseModelMethodOptions): Promise<ModelQueryResult<T>[]>;
     /**
      * @description Deletes a record to the database
      */
@@ -6206,7 +6092,7 @@ declare abstract class Model extends Entity {
     static softDelete<T extends Model>(this: new () => T | typeof Model, modelSqlInstance: T, softDeleteOptions?: {
         column?: ModelKey<T>;
         value?: string | number | boolean | Date;
-    }, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): Promise<ModelWithoutRelations<T>>;
+    }, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): Promise<ModelQueryResult<T>>;
     /**
      * @description Truncates the table for the given model
      */
@@ -7798,4 +7684,4 @@ declare const generateOpenApiModelWithMetadata: <T extends new () => Model>(mode
     $id?: string;
 }>;
 
-export { type AbstractConstructor, type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyConstructor, type AsymmetricEncryptionOptions, type BaseModelMethodOptions, type BaseModelRelationType, BaseSeeder, type BigIntFields, BigIntMixin, type BuildSelectType, type BuildSingleSelectType, 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 ComposeBuildSelect, type ComposeSelect, type ConnectionPolicies, type Constructor, type DataSourceInput, type DataSourceType, type DateColumnOptions, DryModelQueryBuilder, DryQueryBuilder, type ExcludeMethods, type ExtractColumnName, type FetchHooks, type GetColumnType, 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 ModelDataProperties, 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, Schema, SchemaBuilder, type SeederConfig, type SelectBrand, type SelectableColumn, type SelectedModel, 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 };
+export { type AbstractConstructor, type AdminJsActionOptions, type AdminJsAssets, type AdminJsBranding, type AdminJsInstance, type AdminJsLocale, type AdminJsOptions, type AdminJsPage, type AdminJsPropertyOptions, type AdminJsResourceOptions, type AdminJsSettings, type AnyConstructor, type AsymmetricEncryptionOptions, type BaseModelMethodOptions, type BaseModelRelationType, BaseSeeder, type BigIntFields, BigIntMixin, type BuildSelectType, type BuildSingleSelectType, 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 ComposeBuildSelect, type ComposeSelect, type ConnectionPolicies, type Constructor, type DataSourceInput, type DataSourceType, type DateColumnOptions, DryModelQueryBuilder, DryQueryBuilder, type ExcludeMethods, type ExtractColumnName, type ExtractSourceColumn, type FetchHooks, type GetColumnType, 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 ModelDataProperties, type ModelInstanceMethods, type ModelInstanceType, ModelQueryBuilder, type ModelQueryResult, type ModelSelectTuple, type ModelSelectableInput, 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, Schema, SchemaBuilder, type SeederConfig, type SelectBrand, type SelectableColumn, type SelectedModel, 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 };