hysteria-orm 10.9.3 → 10.9.5

package/lib/index.d.cts

@@ -572,7 +572,7 @@ type CacheKeys = Record<string, (...args: any[]) => Promise<any> | any>;
 type UseCacheReturnType<C extends CacheKeys, K extends keyof C> = K extends never ? never : Awaited<ReturnType<C[K]>>;
 
 type Mysql2Import = typeof mysql2_promise;
-type PgImport = typeof pg;
+type PgImport = (typeof pg)["default"];
 type Sqlite3Import = typeof sqlite3;
 type MongoClientImport = typeof mongodb;
 type MssqlImport = typeof mssql;
@@ -949,6 +949,7 @@ type OpenApiModelPropertyType = {
     example?: any;
     default?: any;
     nullable?: boolean;
+    excludeFromSwagger?: boolean;
 };
 
 declare abstract class DataSource {
@@ -1829,6 +1830,8 @@ declare class FromNode extends QueryNode {
 declare class InterpreterUtils {
     private readonly model;
     private readonly modelColumnsMap;
+    private readonly autoInsertColumns;
+    private readonly autoUpdateColumns;
     constructor(model: typeof Model);
     formatStringColumn(dbType: SqlDataSourceType, column: string): string;
     /**
@@ -2823,11 +2826,6 @@ type ColumnOptions = {
      * @warning This will not be called on massive update operations since it's not possible to know which values are being updated, so you must pass the value you want to update in the payload
      */
     prepare?: (value: any) => any;
-    /**
-     * @description Whether the column is returned in the serialization output, this column will always be undefined
-     * @default false
-     */
-    hidden?: boolean;
     /**
      * @description If true, the prepare function will always be called on update regardless of whether the value has been provided in the update payload
      * @default false
@@ -2865,7 +2863,6 @@ type ColumnType = {
     databaseName: string;
     serialize?: (value: any) => any | Promise<any>;
     prepare?: (value: any) => any | Promise<any>;
-    hidden?: boolean;
     autoUpdate?: boolean;
     isPrimary: boolean;
     openApi?: OpenApiModelPropertyType & {
@@ -2908,6 +2905,7 @@ declare abstract class FooterQueryBuilder<T extends Model, S extends Record<stri
     protected modelColumns: ColumnType[];
     protected modelColumnsMap: Map<string, ColumnType>;
     protected logs: boolean | LoggerConfig;
+    private static readonly EMPTY_MAP;
     protected constructor(model: typeof Model, sqlDataSource: SqlDataSource);
     /**
      * @description Clears the group by query
@@ -3845,7 +3843,8 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     protected withNodes: WithNode[];
     protected lockQueryNodes: LockNode[];
     protected isNestedCondition: boolean;
-    protected interpreterUtils: InterpreterUtils;
+    protected _interpreterUtils: InterpreterUtils | null;
+    protected get interpreterUtils(): InterpreterUtils;
     protected insertNode: InsertNode | null;
     protected onDuplicateNode: OnDuplicateNode | null;
     protected updateNode: UpdateNode | null;
@@ -6303,6 +6302,16 @@ declare abstract class Model<T extends Model<T> = any> extends Entity {
     static beforeDelete?(queryBuilder: ModelQueryBuilder<any>): Promise<void> | void;
     static afterFetch?(data: any[]): Promise<any[]> | any[];
     static getColumns(): ColumnType[];
+    /**
+     * @description Returns a cached Map of model column name → ColumnType for O(1) lookup.
+     * Computed once per model class and reused across all queries.
+     */
+    static getColumnsByName(): Map<string, ColumnType>;
+    /**
+     * @description Returns a cached Map of database column name → ColumnType for O(1) lookup.
+     * Computed once per model class and reused across all queries.
+     */
+    static getColumnsByDatabaseName(): Map<string, ColumnType>;
     static getRelations(): LazyRelationType[];
     static getIndexes(): IndexType[];
     static getUniques(): UniqueType[];
@@ -6669,6 +6678,21 @@ interface ColNamespace {
      * ```
      */
     enum<const V extends readonly string[], O extends ColEnumOptions = ColEnumOptions>(values: V, options?: O & TypedSerialize<NullableColumn<V[number], O>> & TypedPrepare<NullableColumn<V[number], O>> & TypedDefault<V[number]>): ColumnDef<NullableColumn<V[number], O>>;
+    /**
+     * Native enum column from a TypeScript enum object.
+     * Handles both string and numeric enums (numeric values are coerced to strings).
+     * Type: `E[keyof E]` (nullable-aware).
+     *
+     * ```ts
+     * enum Status { Active = "active", Inactive = "inactive" }
+     * col.nativeEnum(Status)                           // Status | null
+     * col.nativeEnum(Status, { nullable: false })      // Status
+     *
+     * enum Priority { Low = 0, Medium = 1, High = 2 }
+     * col.nativeEnum(Priority)                         // Priority | null
+     * ```
+     */
+    nativeEnum<E extends Record<string, string | number>, O extends ColEnumOptions = ColEnumOptions>(enumObj: E, options?: O & TypedSerialize<NullableColumn<E[keyof E], O>> & TypedPrepare<NullableColumn<E[keyof E], O>> & TypedDefault<E[keyof E]>): ColumnDef<NullableColumn<E[keyof E], O>>;
     /**
      * CHAR column (fixed-length string). Accepts an optional `length` option.
      * Type: `string` (nullable-aware).

package/lib/index.d.ts

@@ -572,7 +572,7 @@ type CacheKeys = Record<string, (...args: any[]) => Promise<any> | any>;
 type UseCacheReturnType<C extends CacheKeys, K extends keyof C> = K extends never ? never : Awaited<ReturnType<C[K]>>;
 
 type Mysql2Import = typeof mysql2_promise;
-type PgImport = typeof pg;
+type PgImport = (typeof pg)["default"];
 type Sqlite3Import = typeof sqlite3;
 type MongoClientImport = typeof mongodb;
 type MssqlImport = typeof mssql;
@@ -949,6 +949,7 @@ type OpenApiModelPropertyType = {
     example?: any;
     default?: any;
     nullable?: boolean;
+    excludeFromSwagger?: boolean;
 };
 
 declare abstract class DataSource {
@@ -1829,6 +1830,8 @@ declare class FromNode extends QueryNode {
 declare class InterpreterUtils {
     private readonly model;
     private readonly modelColumnsMap;
+    private readonly autoInsertColumns;
+    private readonly autoUpdateColumns;
     constructor(model: typeof Model);
     formatStringColumn(dbType: SqlDataSourceType, column: string): string;
     /**
@@ -2823,11 +2826,6 @@ type ColumnOptions = {
      * @warning This will not be called on massive update operations since it's not possible to know which values are being updated, so you must pass the value you want to update in the payload
      */
     prepare?: (value: any) => any;
-    /**
-     * @description Whether the column is returned in the serialization output, this column will always be undefined
-     * @default false
-     */
-    hidden?: boolean;
     /**
      * @description If true, the prepare function will always be called on update regardless of whether the value has been provided in the update payload
      * @default false
@@ -2865,7 +2863,6 @@ type ColumnType = {
     databaseName: string;
     serialize?: (value: any) => any | Promise<any>;
     prepare?: (value: any) => any | Promise<any>;
-    hidden?: boolean;
     autoUpdate?: boolean;
     isPrimary: boolean;
     openApi?: OpenApiModelPropertyType & {
@@ -2908,6 +2905,7 @@ declare abstract class FooterQueryBuilder<T extends Model, S extends Record<stri
     protected modelColumns: ColumnType[];
     protected modelColumnsMap: Map<string, ColumnType>;
     protected logs: boolean | LoggerConfig;
+    private static readonly EMPTY_MAP;
     protected constructor(model: typeof Model, sqlDataSource: SqlDataSource);
     /**
      * @description Clears the group by query
@@ -3845,7 +3843,8 @@ declare class QueryBuilder<T extends Model = any, S extends Record<string, any>
     protected withNodes: WithNode[];
     protected lockQueryNodes: LockNode[];
     protected isNestedCondition: boolean;
-    protected interpreterUtils: InterpreterUtils;
+    protected _interpreterUtils: InterpreterUtils | null;
+    protected get interpreterUtils(): InterpreterUtils;
     protected insertNode: InsertNode | null;
     protected onDuplicateNode: OnDuplicateNode | null;
     protected updateNode: UpdateNode | null;
@@ -6303,6 +6302,16 @@ declare abstract class Model<T extends Model<T> = any> extends Entity {
     static beforeDelete?(queryBuilder: ModelQueryBuilder<any>): Promise<void> | void;
     static afterFetch?(data: any[]): Promise<any[]> | any[];
     static getColumns(): ColumnType[];
+    /**
+     * @description Returns a cached Map of model column name → ColumnType for O(1) lookup.
+     * Computed once per model class and reused across all queries.
+     */
+    static getColumnsByName(): Map<string, ColumnType>;
+    /**
+     * @description Returns a cached Map of database column name → ColumnType for O(1) lookup.
+     * Computed once per model class and reused across all queries.
+     */
+    static getColumnsByDatabaseName(): Map<string, ColumnType>;
     static getRelations(): LazyRelationType[];
     static getIndexes(): IndexType[];
     static getUniques(): UniqueType[];
@@ -6669,6 +6678,21 @@ interface ColNamespace {
      * ```
      */
     enum<const V extends readonly string[], O extends ColEnumOptions = ColEnumOptions>(values: V, options?: O & TypedSerialize<NullableColumn<V[number], O>> & TypedPrepare<NullableColumn<V[number], O>> & TypedDefault<V[number]>): ColumnDef<NullableColumn<V[number], O>>;
+    /**
+     * Native enum column from a TypeScript enum object.
+     * Handles both string and numeric enums (numeric values are coerced to strings).
+     * Type: `E[keyof E]` (nullable-aware).
+     *
+     * ```ts
+     * enum Status { Active = "active", Inactive = "inactive" }
+     * col.nativeEnum(Status)                           // Status | null
+     * col.nativeEnum(Status, { nullable: false })      // Status
+     *
+     * enum Priority { Low = 0, Medium = 1, High = 2 }
+     * col.nativeEnum(Priority)                         // Priority | null
+     * ```
+     */
+    nativeEnum<E extends Record<string, string | number>, O extends ColEnumOptions = ColEnumOptions>(enumObj: E, options?: O & TypedSerialize<NullableColumn<E[keyof E], O>> & TypedPrepare<NullableColumn<E[keyof E], O>> & TypedDefault<E[keyof E]>): ColumnDef<NullableColumn<E[keyof E], O>>;
     /**
      * CHAR column (fixed-length string). Accepts an optional `length` option.
      * Type: `string` (nullable-aware).