hysteria-orm 10.5.8 → 10.6.0

package/lib/index.d.ts

@@ -117,7 +117,7 @@ interface SqliteDataSourceInput extends CommonDataSourceInput {
      * @description The filename of the database file for SQLite
      * @default ":memory:"
      */
-    readonly database?: string;
+    readonly database?: ":memory:" | (string & {});
 }
 interface NotNullableSqliteDataSourceInput extends SqliteDataSourceInput {
     readonly type?: "sqlite";
@@ -876,6 +876,24 @@ type OracledbTableOptions = {
     inMemory?: boolean;
     compressFor?: "QUERY LOW" | "QUERY HIGH" | "ARCHIVE LOW" | "ARCHIVE HIGH";
 };
+type DateTimeOptions = {
+    /**
+     * @description Whether to include the timezone in the datetime column
+     */
+    withTimezone?: boolean;
+    /**
+     * @description The precision of the datetime column
+     */
+    precision?: number;
+    /**
+     * @description Sets DEFAULT CURRENT_TIMESTAMP on the column
+     */
+    autoCreate?: boolean;
+    /**
+     * @description Automatically updates the column on row update. Uses ON UPDATE CURRENT_TIMESTAMP on MySQL/MariaDB, auto-generates a trigger on other databases
+     */
+    autoUpdate?: boolean;
+};
 /**
  * @description Union type for all database-specific table options
  */
@@ -1517,6 +1535,8 @@ declare class ColumnTypeNode extends QueryNode {
     enumValues?: readonly string[];
     autoIncrement?: boolean;
     withTimezone?: boolean;
+    autoCreate?: boolean;
+    autoUpdate?: boolean;
     collate?: string;
     chainsWith: string;
     canKeywordBeSeenMultipleTimes: boolean;
@@ -1530,6 +1550,8 @@ declare class ColumnTypeNode extends QueryNode {
         enumValues?: readonly string[];
         withTimezone?: boolean;
         autoIncrement?: boolean;
+        autoCreate?: boolean;
+        autoUpdate?: boolean;
         collate?: string;
         isRawValue?: boolean;
     });
@@ -1791,21 +1813,19 @@ declare class CreateTableBuilder extends BaseBuilder {
      * @mysql DATETIME(precision)
      * @postgres TIMESTAMP(precision) WITHOUT TIME ZONE
      * @sqlite TEXT
+     * @param options.autoCreate Sets DEFAULT CURRENT_TIMESTAMP on the column
+     * @param options.autoUpdate Automatically updates the column on row update. Uses ON UPDATE CURRENT_TIMESTAMP on MySQL/MariaDB, auto-generates a trigger on other databases
      */
-    datetime(name: string, options?: {
-        withTimezone?: boolean;
-        precision?: number;
-    }): ConstraintBuilder;
+    datetime(name: string, options?: DateTimeOptions): ConstraintBuilder;
     /**
      * Timestamp type
      * @mysql TIMESTAMP(precision)
      * @postgres TIMESTAMP(precision) WITH/WITHOUT TIME ZONE
      * @sqlite TEXT
+     * @param options.autoCreate Sets DEFAULT CURRENT_TIMESTAMP on the column
+     * @param options.autoUpdate Automatically updates the column on row update. Uses ON UPDATE CURRENT_TIMESTAMP on MySQL/MariaDB, auto-generates a trigger on other databases
      */
-    timestamp(name: string, options?: {
-        withTimezone?: boolean;
-        precision?: number;
-    }): ConstraintBuilder;
+    timestamp(name: string, options?: DateTimeOptions): ConstraintBuilder;
     /**
      * Boolean type
      * @mysql BOOLEAN
@@ -3760,84 +3780,90 @@ declare abstract class WhereQueryBuilder<T extends Model, S extends Record<strin
     /**
      * @description Adds a WHERE condition to the query.
      */
-    where(column: ModelKey<T>, operator: BinaryOperatorType, value: BaseValues): this;
-    where<S extends string>(column: SelectableColumn$1<S>, operator: BinaryOperatorType, value: BaseValues): this;
     where(cb: (queryBuilder: WhereOnlyQueryBuilder<T>) => void): this;
-    where(column: ModelKey<T> | SelectableColumn$1<string>, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
-    where(column: ModelKey<T> | SelectableColumn$1<string>, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
-    where(column: ModelKey<T> | SelectableColumn$1<string>, value: BaseValues): this;
+    where(column: string, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    where(column: string, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    where<K extends ModelKey<T>>(column: K, operator: BinaryOperatorType, value: WhereColumnValue<T, K>): this;
+    where<K extends ModelKey<T>>(column: K, value: WhereColumnValue<T, K>): this;
+    where(column: `${string}.${string}`, operator: BinaryOperatorType, value: BaseValues): this;
+    where(column: `${string}.${string}`, value: BaseValues): this;
     /**
      * @description Adds an AND WHERE condition to the query.
      */
-    andWhere(column: ModelKey<T>, operator: BinaryOperatorType, value: BaseValues): this;
-    andWhere(column: SelectableColumn$1<string>, operator: BinaryOperatorType, value: BaseValues): this;
-    andWhere(column: ModelKey<T> | SelectableColumn$1<string>, value: BaseValues): this;
     andWhere(cb: (queryBuilder: WhereOnlyQueryBuilder<T>) => void): this;
-    andWhere(column: ModelKey<T> | SelectableColumn$1<string>, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
-    andWhere(column: ModelKey<T> | SelectableColumn$1<string>, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    andWhere(column: string, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    andWhere(column: string, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    andWhere<K extends ModelKey<T>>(column: K, operator: BinaryOperatorType, value: WhereColumnValue<T, K>): this;
+    andWhere<K extends ModelKey<T>>(column: K, value: WhereColumnValue<T, K>): this;
+    andWhere(column: `${string}.${string}`, operator: BinaryOperatorType, value: BaseValues): this;
+    andWhere(column: `${string}.${string}`, value: BaseValues): this;
     /**
      * @description Adds an OR WHERE condition to the query.
      */
-    orWhere(column: ModelKey<T>, operator: BinaryOperatorType, value: BaseValues): this;
-    orWhere<S extends string>(column: SelectableColumn$1<S>, operator: BinaryOperatorType, value: BaseValues): this;
-    orWhere<S extends string>(column: ModelKey<T> | SelectableColumn$1<S>, value: BaseValues): this;
     orWhere(cb: (queryBuilder: WhereOnlyQueryBuilder<T>) => void): this;
-    orWhere(column: ModelKey<T> | SelectableColumn$1<string>, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
-    orWhere(column: ModelKey<T> | SelectableColumn$1<string>, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    orWhere(column: string, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    orWhere(column: string, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    orWhere<K extends ModelKey<T>>(column: K, operator: BinaryOperatorType, value: WhereColumnValue<T, K>): this;
+    orWhere<K extends ModelKey<T>>(column: K, value: WhereColumnValue<T, K>): this;
+    orWhere(column: `${string}.${string}`, operator: BinaryOperatorType, value: BaseValues): this;
+    orWhere(column: `${string}.${string}`, value: BaseValues): this;
     /**
      * @description Adds a negated WHERE condition to the query.
      */
-    whereNot(column: ModelKey<T>, operator: BinaryOperatorType, value: BaseValues): this;
-    whereNot<S extends string>(column: SelectableColumn$1<S>, operator: BinaryOperatorType, value: BaseValues): this;
-    whereNot(column: ModelKey<T> | SelectableColumn$1<string>, value: BaseValues): this;
-    whereNot(column: ModelKey<T> | SelectableColumn$1<string>, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
-    whereNot(column: ModelKey<T> | SelectableColumn$1<string>, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    whereNot(column: string, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    whereNot(column: string, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    whereNot<K extends ModelKey<T>>(column: K, operator: BinaryOperatorType, value: WhereColumnValue<T, K>): this;
+    whereNot<K extends ModelKey<T>>(column: K, value: WhereColumnValue<T, K>): this;
+    whereNot(column: `${string}.${string}`, operator: BinaryOperatorType, value: BaseValues): this;
+    whereNot(column: `${string}.${string}`, value: BaseValues): this;
     /**
      * @description Adds a negated AND WHERE condition to the query.
      */
-    andWhereNot(column: ModelKey<T>, operator: BinaryOperatorType, value: BaseValues): this;
-    andWhereNot<S extends string>(column: SelectableColumn$1<S>, operator: BinaryOperatorType, value: BaseValues): this;
-    andWhereNot(column: ModelKey<T> | SelectableColumn$1<string>, value: BaseValues): this;
-    andWhereNot(column: ModelKey<T> | SelectableColumn$1<string>, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
-    andWhereNot(column: ModelKey<T> | SelectableColumn$1<string>, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    andWhereNot(column: string, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    andWhereNot(column: string, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    andWhereNot<K extends ModelKey<T>>(column: K, operator: BinaryOperatorType, value: WhereColumnValue<T, K>): this;
+    andWhereNot<K extends ModelKey<T>>(column: K, value: WhereColumnValue<T, K>): this;
+    andWhereNot(column: `${string}.${string}`, operator: BinaryOperatorType, value: BaseValues): this;
+    andWhereNot(column: `${string}.${string}`, value: BaseValues): this;
     /**
      * @description Adds a negated OR WHERE condition to the query.
      */
-    orWhereNot(column: ModelKey<T>, operator: BinaryOperatorType, value: BaseValues): this;
-    orWhereNot<S extends string>(column: SelectableColumn$1<S>, operator: BinaryOperatorType, value: BaseValues): this;
-    orWhereNot(column: ModelKey<T> | SelectableColumn$1<string>, value: BaseValues): this;
-    orWhereNot(column: ModelKey<T> | SelectableColumn$1<string>, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
-    orWhereNot(column: ModelKey<T> | SelectableColumn$1<string>, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    orWhereNot(column: string, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    orWhereNot(column: string, operator: SubqueryOperatorType, subQuery: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    orWhereNot<K extends ModelKey<T>>(column: K, operator: BinaryOperatorType, value: WhereColumnValue<T, K>): this;
+    orWhereNot<K extends ModelKey<T>>(column: K, value: WhereColumnValue<T, K>): this;
+    orWhereNot(column: `${string}.${string}`, operator: BinaryOperatorType, value: BaseValues): this;
+    orWhereNot(column: `${string}.${string}`, value: BaseValues): this;
     /**
      * @description Adds a WHERE BETWEEN condition to the query.
      */
-    whereBetween(column: ModelKey<T>, min: BaseValues, max: BaseValues): this;
-    whereBetween<S extends string>(column: SelectableColumn$1<S>, min: BaseValues, max: BaseValues): this;
+    whereBetween<K extends ModelKey<T>>(column: K, min: T[K], max: T[K]): this;
+    whereBetween(column: `${string}.${string}`, min: BaseValues, max: BaseValues): this;
     /**
      * @description Adds an AND WHERE BETWEEN condition to the query.
      */
-    andWhereBetween(column: ModelKey<T>, min: BaseValues, max: BaseValues): this;
-    andWhereBetween<S extends string>(column: SelectableColumn$1<S>, min: BaseValues, max: BaseValues): this;
+    andWhereBetween<K extends ModelKey<T>>(column: K, min: T[K], max: T[K]): this;
+    andWhereBetween(column: `${string}.${string}`, min: BaseValues, max: BaseValues): this;
     /**
      * @description Adds an OR WHERE BETWEEN condition to the query.
      */
-    orWhereBetween(column: ModelKey<T>, min: BaseValues, max: BaseValues): this;
-    orWhereBetween<S extends string>(column: SelectableColumn$1<S>, min: BaseValues, max: BaseValues): this;
+    orWhereBetween<K extends ModelKey<T>>(column: K, min: T[K], max: T[K]): this;
+    orWhereBetween(column: `${string}.${string}`, min: BaseValues, max: BaseValues): this;
     /**
      * @description Adds a WHERE NOT BETWEEN condition to the query.
      */
-    whereNotBetween(column: ModelKey<T>, min: BaseValues, max: BaseValues): this;
-    whereNotBetween<S extends string>(column: SelectableColumn$1<S>, min: BaseValues, max: BaseValues): this;
+    whereNotBetween<K extends ModelKey<T>>(column: K, min: T[K], max: T[K]): this;
+    whereNotBetween(column: `${string}.${string}`, min: BaseValues, max: BaseValues): this;
     /**
      * @description Adds an AND WHERE NOT BETWEEN condition to the query.
      */
-    andWhereNotBetween(column: ModelKey<T>, min: BaseValues, max: BaseValues): this;
-    andWhereNotBetween<S extends string>(column: SelectableColumn$1<S>, min: BaseValues, max: BaseValues): this;
+    andWhereNotBetween<K extends ModelKey<T>>(column: K, min: T[K], max: T[K]): this;
+    andWhereNotBetween(column: `${string}.${string}`, min: BaseValues, max: BaseValues): this;
     /**
      * @description Adds an OR WHERE NOT BETWEEN condition to the query.
      */
-    orWhereNotBetween(column: ModelKey<T>, min: BaseValues, max: BaseValues): this;
-    orWhereNotBetween<S extends string>(column: SelectableColumn$1<S>, min: BaseValues, max: BaseValues): this;
+    orWhereNotBetween<K extends ModelKey<T>>(column: K, min: T[K], max: T[K]): this;
+    orWhereNotBetween(column: `${string}.${string}`, min: BaseValues, max: BaseValues): this;
     /**
      * @description Adds a WHERE LIKE condition to the query.
      */
@@ -3902,38 +3928,44 @@ declare abstract class WhereQueryBuilder<T extends Model, S extends Record<strin
      * @description Adds a WHERE IN condition to the query.
      * @warning If the array is empty, it will add an impossible condition.
      */
-    whereIn(column: ModelKey<T>, values: BaseValues[]): this;
-    whereIn<S extends string>(column: SelectableColumn$1<S>, values: BaseValues[]): this;
+    whereIn(column: string, values: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    whereIn<K extends ModelKey<T>>(column: K, values: T[K][]): this;
+    whereIn(column: `${string}.${string}`, values: BaseValues[]): this;
     /**
      * @description Adds an AND WHERE IN condition to the query.
      * @warning If the array is empty, it will add an impossible condition.
      */
-    andWhereIn(column: ModelKey<T>, values: BaseValues[]): this;
-    andWhereIn<S extends string>(column: SelectableColumn$1<S>, values: BaseValues[]): this;
+    andWhereIn(column: string, values: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    andWhereIn<K extends ModelKey<T>>(column: K, values: T[K][]): this;
+    andWhereIn(column: `${string}.${string}`, values: BaseValues[]): this;
     /**
      * @description Adds an OR WHERE IN condition to the query.
      * @warning If the array is empty, it will add an impossible condition.
      */
-    orWhereIn(column: ModelKey<T>, values: BaseValues[]): this;
-    orWhereIn<S extends string>(column: SelectableColumn$1<S>, values: BaseValues[]): this;
+    orWhereIn(column: string, values: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    orWhereIn<K extends ModelKey<T>>(column: K, values: T[K][]): this;
+    orWhereIn(column: `${string}.${string}`, values: BaseValues[]): this;
     /**
      * @description Adds a WHERE NOT IN condition to the query.
      * @warning If the array is empty, it will add an obvious condition to make it true.
      */
-    whereNotIn(column: ModelKey<T>, values: BaseValues[]): this;
-    whereNotIn<S extends string>(column: SelectableColumn$1<S>, values: BaseValues[]): this;
+    whereNotIn(column: string, values: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    whereNotIn<K extends ModelKey<T>>(column: K, values: T[K][]): this;
+    whereNotIn(column: `${string}.${string}`, values: BaseValues[]): this;
     /**
      * @description Adds an OR WHERE NOT IN condition to the query.
      * @warning If the array is empty, it will add an obvious condition to make it true.
      */
-    andWhereNotIn(column: ModelKey<T>, values: BaseValues[]): this;
-    andWhereNotIn<S extends string>(column: SelectableColumn$1<S>, values: BaseValues[]): this;
+    andWhereNotIn(column: string, values: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    andWhereNotIn<K extends ModelKey<T>>(column: K, values: T[K][]): this;
+    andWhereNotIn(column: `${string}.${string}`, values: BaseValues[]): this;
     /**
      * @description Adds an OR WHERE NOT IN condition to the query.
      * @warning If the array is empty, it will add an obvious condition to make it true.
      */
-    orWhereNotIn(column: ModelKey<T>, values: BaseValues[]): this;
-    orWhereNotIn<S extends string>(column: SelectableColumn$1<S>, values: BaseValues[]): this;
+    orWhereNotIn(column: string, values: QueryBuilder<T> | ((subQuery: QueryBuilder<T>) => void)): this;
+    orWhereNotIn<K extends ModelKey<T>>(column: K, values: T[K][]): this;
+    orWhereNotIn(column: `${string}.${string}`, values: BaseValues[]): this;
     /**
      * @description Adds a WHERE NULL condition to the query.
      */
@@ -4045,18 +4077,25 @@ declare abstract class WhereQueryBuilder<T extends Model, S extends Record<strin
     /**
      * @description Adds a HAVING condition to the query.
      */
-    having<S extends string>(column: SelectableColumn$1<S>, value: any): this;
-    having(column: ModelKey<T>, operator: BinaryOperatorType, value: any): this;
+    having<K extends ModelKey<T>>(column: K, value: WhereColumnValue<T, K>): this;
+    having<K extends ModelKey<T>>(column: K, operator: BinaryOperatorType, value: WhereColumnValue<T, K>): this;
+    having(column: `${string}.${string}`, value: any): this;
+    having(column: `${string}.${string}`, operator: BinaryOperatorType, value: any): this;
     /**
      * @description Adds an AND HAVING condition to the query.
      */
-    andHaving<S extends string>(column: SelectableColumn$1<S>, value: any): this;
+    andHaving<K extends ModelKey<T>>(column: K, value: WhereColumnValue<T, K>): this;
+    andHaving<K extends ModelKey<T>>(column: K, operator: BinaryOperatorType, value: WhereColumnValue<T, K>): this;
+    andHaving(column: `${string}.${string}`, value: any): this;
+    andHaving(column: `${string}.${string}`, operator: BinaryOperatorType, value: any): this;
     andHaving(column: ModelKey<T>, operator: BinaryOperatorType, value: any): this;
     /**
      * @description Adds an OR HAVING condition to the query.
      */
-    orHaving<S extends string>(column: SelectableColumn$1<S>, value: any): this;
-    orHaving(column: ModelKey<T>, operator: BinaryOperatorType, value: any): this;
+    orHaving<K extends ModelKey<T>>(column: K, value: WhereColumnValue<T, K>): this;
+    orHaving<K extends ModelKey<T>>(column: K, operator: BinaryOperatorType, value: WhereColumnValue<T, K>): this;
+    orHaving(column: `${string}.${string}`, value: any): this;
+    orHaving(column: `${string}.${string}`, operator: BinaryOperatorType, value: any): this;
     /**
      * @description Adds a raw HAVING condition to the query.
      */
@@ -4514,19 +4553,19 @@ declare class ModelQueryBuilder<T extends Model, S extends Record<string, any> =
     update(data: Partial<ModelWithoutRelations<T>>, options?: UpdateOptions): WriteOperation<number>;
     softDelete(options?: SoftDeleteOptions<T>): WriteOperation<number>;
     delete(options?: DeleteOptions): WriteOperation<number>;
-    getCount(column?: string, options?: {
+    getCount(column?: (ModelKey<T> & string) | "*" | (string & {}), options?: {
         ignoreHooks: boolean;
     }): Promise<number>;
-    getMax(column: string, options?: {
+    getMax(column: (ModelKey<T> & string) | (string & {}), options?: {
         ignoreHooks: boolean;
     }): Promise<number>;
-    getMin(column: string, options?: {
+    getMin(column: (ModelKey<T> & string) | (string & {}), options?: {
         ignoreHooks: boolean;
     }): Promise<number>;
-    getAvg(column: string, options?: {
+    getAvg(column: (ModelKey<T> & string) | (string & {}), options?: {
         ignoreHooks: boolean;
     }): Promise<number>;
-    getSum(column: string, options?: {
+    getSum(column: (ModelKey<T> & string) | (string & {}), options?: {
         ignoreHooks: boolean;
     }): Promise<number>;
     paginate(page: number, perPage: number, options?: {
@@ -6024,6 +6063,11 @@ type WhereType<T> = BaseWhereType<T> & {
 type ModelKey<T extends Model> = {
     [K in keyof T]: T[K] extends NullableAndUndefinable<Model> | NullableAndUndefinable<Model[]> ? never : K extends "*" ? never : T[K] extends (...args: any[]) => any ? never : K;
 }[keyof T];
+/**
+ * Extracts the value type for a model column key, adding `null` for SQL compatibility.
+ * Used in type-safe where/having clauses to infer value types from column keys.
+ */
+type WhereColumnValue<T extends Model, K extends ModelKey<T>> = T[K] | null;
 type ModelRelation<T extends Model> = OnlyRelations<T>;
 type OrderByChoices = "asc" | "desc";
 type OrderByType<T extends Model> = {
@@ -7766,6 +7810,8 @@ declare class Schema {
      */
     createExtension(extensionName: CommonPostgresExtensions, ifNotExists?: boolean): void;
     createExtension(extensionName: string, ifNotExists?: boolean): void;
+    private generateAutoUpdateTriggers;
+    private getAutoUpdateTriggerSql;
     private generateAstInstance;
 }