hysteria-orm 10.0.5 → 10.0.7

package/lib/index.d.cts

@@ -1392,6 +1392,63 @@ declare class InterpreterUtils {
     getFromForWriteOperations(dbType: SqlDataSourceType, fromNode: FromNode): string;
 }
 
+type DeleteOptions = {
+    ignoreBeforeDeleteHook?: boolean;
+};
+type SoftDeleteOptions<T> = {
+    column?: MongoCollectionKey<T>;
+    value?: string | number | boolean;
+    ignoreBeforeUpdateHook?: boolean;
+};
+
+/**
+ * Allows to get queries without executing them
+ */
+declare class DryQueryBuilder extends QueryBuilder {
+    constructor(model: typeof Model, sqlDataSource: SqlDataSource);
+    many(): this;
+    /**
+     * @description Builds the insert query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the insert method
+     * @returns The query builder
+     */
+    insert(...args: Parameters<typeof QueryBuilder.prototype.insert>): this;
+    /**
+     * @description Builds the insert many query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the insert many method
+     * @returns The query builder
+     */
+    insertMany(...args: Parameters<typeof QueryBuilder.prototype.insertMany>): this;
+    /**
+     * @description Builds the upsert query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the upsert method
+     * @returns The query builder
+     */
+    upsert(...args: Parameters<typeof QueryBuilder.prototype.upsert>): this;
+    /**
+     * @description Builds the update query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param data The data to update
+     * @returns The query builder
+     */
+    update(data: Record<string, any>): this;
+    /**
+     * @description Builds the delete query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @returns The query builder
+     */
+    delete(): this;
+    /**
+     * @description Builds the truncate query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @returns The query builder
+     */
+    truncate(): this;
+    /**
+     * @description Builds the soft delete query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param options Soft delete options
+     * @returns The query builder
+     */
+    softDelete(options?: Omit<SoftDeleteOptions<any>, "ignoreBeforeDeleteHook">): this;
+}
+
 type BaseValues$1 = string | number | boolean | null;
 type BinaryOperatorType$1 = "=" | "!=" | "<>" | ">" | "<" | ">=" | "<=" | "like" | "ilike" | "in";
 declare class HavingNode extends QueryNode {
@@ -2401,6 +2458,12 @@ type PaginateWithCursorOptions<T extends Model, K extends ModelKey<T>> = {
     operator?: "<" | ">";
     orderBy?: "asc" | "desc";
 };
+type UpsertOptionsRawBuilder = {
+    updateOnConflict?: boolean;
+    returning?: string[];
+};
+type DryQueryBuilderWithoutReadOperations = Omit<DryQueryBuilder, "many" | "one" | "oneOrFail" | "first" | "firstOrFail" | "paginate" | "paginateWithCursor" | "exists" | "pluck" | "upsert" | "upsertMany" | "increment" | "decrement" | "getSum" | "getAvg" | "getMin" | "getMax" | "getCount" | "stream" | "chunk" | "paginate" | "paginateWithCursor" | "exists">;
+type DryModelQueryBuilderWithoutReadOperations<T extends Model, A extends Record<string, any> = {}, R extends Record<string, any> = {}> = Omit<DryModelQueryBuilder<T, A, R>, "many" | "one" | "oneOrFail" | "first" | "firstOrFail" | "paginate" | "paginateWithCursor" | "exists" | "pluck" | "upsert" | "upsertMany" | "increment" | "decrement" | "getSum" | "getAvg" | "getMin" | "getMax" | "getCount" | "stream" | "chunk" | "paginate" | "paginateWithCursor" | "exists">;
 
 declare class SqlModelManagerUtils<T extends Model> {
     protected dbType: SqlDataSourceType;
@@ -2436,15 +2499,6 @@ type CursorPaginatedData<T extends Model, A extends object = {}, R extends objec
     data: AnnotatedModel<T, A, R>[];
 };
 
-type DeleteOptions = {
-    ignoreBeforeDeleteHook?: boolean;
-};
-type SoftDeleteOptions<T> = {
-    column?: MongoCollectionKey<T>;
-    value?: string | number | boolean;
-    ignoreBeforeDeleteHook?: boolean;
-};
-
 type UpdateOptions = {
     ignoreBeforeUpdateHook?: boolean;
 };
@@ -2822,6 +2876,50 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
     private truncateWithPerformance;
 }
 
+/**
+ * Allows to get model queries without executing them
+ */
+declare class DryModelQueryBuilder<T extends Model, A extends Record<string, any> = {}, R extends Record<string, any> = {}> extends ModelQueryBuilder<T, A, R> {
+    constructor(model: typeof Model, sqlDataSource: SqlDataSource);
+    many(): this;
+    /**
+     * @description Builds the insert query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the insert method
+     * @returns The query builder
+     */
+    insert(...args: Parameters<typeof this$1.model.insert<T>>): this;
+    /**
+     * @description Builds the insert many query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the insert many method
+     * @returns The query builder
+     */
+    insertMany(...args: Parameters<typeof this$1.model.insertMany<T>>): this;
+    /**
+     * @description Builds the update query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param data The data to update
+     * @param options Update options
+     * @returns The query builder
+     */
+    update(...args: Parameters<ReturnType<typeof this$1.model.query<T>>["update"]>): this;
+    /**
+     * @description Builds the delete query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param options Delete options
+     * @returns The query builder
+     */
+    delete(...args: Parameters<ReturnType<typeof this$1.model.query<T>>["delete"]>): this;
+    /**
+     * @description Builds the truncate query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @returns The query builder
+     */
+    truncate(): this;
+    /**
+     * @description Builds the soft delete query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param options Soft delete options
+     * @returns The query builder
+     */
+    softDelete(...args: Parameters<ReturnType<typeof this$1.model.query<T>>["softDelete"]>): this;
+}
+
 declare class ModelManager<T extends Model> {
     protected sqlDataSource: SqlDataSource;
     protected sqlType: SqlDataSourceType;
@@ -2881,6 +2979,11 @@ declare class ModelManager<T extends Model> {
      * @description Returns a query builder instance
      */
     query(): Omit<ModelQueryBuilder<T>, "insert" | "insertMany">;
+    /**
+     * @description Returns a dry query builder instance
+     * @description The dry query builder instance will not execute the query, it will return the query statement
+     */
+    dryQuery(): Omit<DryModelQueryBuilder<T>, "insert" | "insertMany">;
     /**
      * @description Mysql does not return the inserted model, so we need to get the inserted model from the database
      */
@@ -3004,6 +3107,12 @@ declare class SqlDataSource extends DataSource {
      * @param table The table name to query from, must be in valid sql format `table` or `table as alias`
      */
     static query<S extends string>(table: TableFormat<S>, options?: RawModelOptions): QueryBuilder;
+    /**
+     * @description Returns a dry query builder instance
+     * @description The dry query builder instance will not execute the query, it will return the query statement
+     * @returns The dry query builder instance
+     */
+    static dryQuery<S extends string>(table: TableFormat<S>, options?: RawModelOptions): DryQueryBuilderWithoutReadOperations;
     /**
      * @description Creates a table on the database, return the query to be executed to create the table
      */
@@ -3098,6 +3207,12 @@ declare class SqlDataSource extends DataSource {
      * @param table The table name to query from, must be in valid sql format `table` or `table as alias`
      */
     query<S extends string>(table: TableFormat<S>, options?: RawModelOptions): QueryBuilder;
+    /**
+     * @description Returns a DryQueryBuilder instance
+     * @description The dry query builder instance will not execute the query, it will return the query statement
+     * @returns The dry query builder instance
+     */
+    dryQuery<S extends string>(table: TableFormat<S>, options?: RawModelOptions): DryQueryBuilderWithoutReadOperations;
     /**
      * @description Return the query to alter the given table schema
      */
@@ -3324,6 +3439,47 @@ declare class AstParser {
     private mapCommonDbType;
 }
 
+declare class DeleteNode extends QueryNode {
+    fromNode: FromNode;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(fromNode: FromNode, isRawValue?: boolean);
+}
+
+declare class InsertNode extends QueryNode {
+    fromNode: FromNode;
+    records: Record<string, any>[];
+    returning?: string[];
+    disableReturning: boolean;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(fromNode: FromNode, records?: Record<string, any>[], returning?: string[], disableReturning?: boolean, isRawValue?: boolean);
+}
+
+declare class TruncateNode extends QueryNode {
+    fromNode: FromNode | string;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(fromNode: FromNode | string, isRawValue?: boolean);
+}
+
+declare class UpdateNode extends QueryNode {
+    fromNode: FromNode;
+    columns: string[];
+    values: (any | RawNode)[];
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(fromNode: FromNode, columns?: string[], values?: (any | RawNode)[], isRawValue?: boolean);
+}
+
 declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
     model: typeof Model;
     protected astParser: AstParser;
@@ -3333,6 +3489,10 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
     protected isNestedCondition: boolean;
     protected mustRemoveAnnotations: boolean;
     protected interpreterUtils: InterpreterUtils;
+    protected insertNode: InsertNode | null;
+    protected updateNode: UpdateNode | null;
+    protected deleteNode: DeleteNode | null;
+    protected truncateNode: TruncateNode | null;
     /**
      * @description Performance methods that return the time that took to execute the query with the result
      */
@@ -3434,7 +3594,7 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
      * @postgres needs the pg-query-stream package in order to work
      * @throws If using postgres and the `pg-query-stream` package is not installed
      */
-    stream<M extends Model = T>(options?: StreamOptions, cb?: (stream: PassThrough & AsyncGenerator<AnnotatedModel<M, any, any>>) => void | Promise<void>): Promise<PassThrough & AsyncGenerator<AnnotatedModel<M, {}, {}>>>;
+    stream<M extends Model = T>(options?: StreamOptions): Promise<PassThrough & AsyncGenerator<AnnotatedModel<M, {}, {}>>>;
     /**
      * @description Chunks the query into smaller queries, it returns a generator of the chunks
      * @description It will continue to yield chunks until the query returns no results
@@ -3584,6 +3744,22 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
      * @returns raw driver response
      */
     insertMany(data: Record<string, any>[], returning?: string[]): Promise<T[]>;
+    /**
+     * @description Updates or creates a new record using upsert functionality
+     * @param data The data to insert or update
+     * @param searchCriteria The criteria to search for existing records
+     * @param options Upsert options including updateOnConflict and returning columns
+     * @returns The upserted record
+     */
+    upsert<O extends Record<string, any>>(data: O, searchCriteria: Partial<O>, options?: UpsertOptionsRawBuilder): Promise<T[]>;
+    /**
+     * @description Updates or creates multiple records using upsert functionality
+     * @param conflictColumns The columns to check for conflicts
+     * @param columnsToUpdate The columns to update on conflict
+     * @param data Array of data objects to insert or update
+     * @param options Upsert options including updateOnConflict and returning columns
+     */
+    upsertMany<O extends Record<string, any>>(conflictColumns: string[], columnsToUpdate: string[], data: O[], options?: UpsertOptionsRawBuilder): Promise<T[]>;
     /**
      * @description Updates records from a table
      * @returns the number of affected rows
@@ -3609,11 +3785,11 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
     /**
      * @description Returns the query with the parameters bound to the query
      */
-    toQuery(dbType?: SqlDataSourceType): string;
+    toQuery(): string;
     /**
      * @description Returns the query with database driver placeholders and the params
      */
-    unWrap(_dbType?: SqlDataSourceType): ReturnType<typeof AstParser.prototype.parse>;
+    unWrap(): ReturnType<typeof AstParser.prototype.parse>;
     /**
      * @description Returns a deep clone of the query builder instance.
      */
@@ -3846,6 +4022,11 @@ declare abstract class Model extends Entity {
      * @description Gives a query sqlInstance for the given model
      */
     static query<T extends Model>(this: new () => T | typeof Model, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): ModelQueryBuilder<T>;
+    /**
+     * @description Returns a dry query builder instance
+     * @description The dry query builder instance will not execute the query
+     */
+    static dryQuery<T extends Model>(this: new () => T | typeof Model, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): DryModelQueryBuilderWithoutReadOperations<T>;
     /**
      * @description Finds the first record in the database
      * @deprecated Used only for debugging purposes, use findOne or query instead
@@ -5120,4 +5301,4 @@ declare const generateOpenApiModelWithMetadata: <T extends new () => Model>(mode
     modelName: string;
 }>;
 
-export { type AnnotatedModel, type AsymmetricEncryptionOptions, type AugmentedSqlDataSource, AutogeneratedModel, type BaseModelMethodOptions, type BaseModelRelationType, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type CommonSqlMethodReturnType, type ConnectionPolicies, type DataSourceInput, type DataSourceType, type DateColumnOptions, type FetchHooks, type GetConnectionReturnType, HysteriaError, type IndexType, type LazyRelationType, type ManyOptions, type ManyToManyOptions, Migration, Model, type ModelInstanceType, ModelQueryBuilder, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NumberModelKey, type OneOptions, type PgPoolClientInstance, type PostgresSqlDataSourceInput, QueryBuilder, type RawModelOptions, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationQueryBuilderType, type SqlCloneOptions, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDataSourceWithoutTransaction, type SqlDriverSpecificOptions, type SqlPoolType, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type SymmetricEncryptionOptions, type TableFormat, type ThroughModel, TimestampedModel, Transaction, type TransactionExecutionOptions, type UniqueType, type UseConnectionInput, User, UuidModel, belongsTo, column, createModelFactory, defineMigrator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, index, HysteriaLogger as logger, manyToMany, MongoDataSource as mongo, property, RedisDataSource as redis, SqlDataSource as sql, unique, view, withPerformance };
+export { type AnnotatedModel, type AsymmetricEncryptionOptions, type AugmentedSqlDataSource, AutogeneratedModel, type BaseModelMethodOptions, type BaseModelRelationType, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type CommonSqlMethodReturnType, type ConnectionPolicies, type DataSourceInput, type DataSourceType, type DateColumnOptions, DryModelQueryBuilder, DryQueryBuilder, type FetchHooks, type GetConnectionReturnType, HysteriaError, type IndexType, type LazyRelationType, type ManyOptions, type ManyToManyOptions, Migration, Model, type ModelInstanceType, ModelQueryBuilder, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NumberModelKey, type OneOptions, type PgPoolClientInstance, type PostgresSqlDataSourceInput, QueryBuilder, type RawModelOptions, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationQueryBuilderType, type SqlCloneOptions, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDataSourceWithoutTransaction, type SqlDriverSpecificOptions, type SqlPoolType, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type SymmetricEncryptionOptions, type TableFormat, type ThroughModel, TimestampedModel, Transaction, type TransactionExecutionOptions, type UniqueType, type UseConnectionInput, User, UuidModel, belongsTo, column, createModelFactory, defineMigrator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, index, HysteriaLogger as logger, manyToMany, MongoDataSource as mongo, property, RedisDataSource as redis, SqlDataSource as sql, unique, view, withPerformance };

package/lib/index.d.ts

@@ -1392,6 +1392,63 @@ declare class InterpreterUtils {
     getFromForWriteOperations(dbType: SqlDataSourceType, fromNode: FromNode): string;
 }
 
+type DeleteOptions = {
+    ignoreBeforeDeleteHook?: boolean;
+};
+type SoftDeleteOptions<T> = {
+    column?: MongoCollectionKey<T>;
+    value?: string | number | boolean;
+    ignoreBeforeUpdateHook?: boolean;
+};
+
+/**
+ * Allows to get queries without executing them
+ */
+declare class DryQueryBuilder extends QueryBuilder {
+    constructor(model: typeof Model, sqlDataSource: SqlDataSource);
+    many(): this;
+    /**
+     * @description Builds the insert query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the insert method
+     * @returns The query builder
+     */
+    insert(...args: Parameters<typeof QueryBuilder.prototype.insert>): this;
+    /**
+     * @description Builds the insert many query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the insert many method
+     * @returns The query builder
+     */
+    insertMany(...args: Parameters<typeof QueryBuilder.prototype.insertMany>): this;
+    /**
+     * @description Builds the upsert query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the upsert method
+     * @returns The query builder
+     */
+    upsert(...args: Parameters<typeof QueryBuilder.prototype.upsert>): this;
+    /**
+     * @description Builds the update query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param data The data to update
+     * @returns The query builder
+     */
+    update(data: Record<string, any>): this;
+    /**
+     * @description Builds the delete query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @returns The query builder
+     */
+    delete(): this;
+    /**
+     * @description Builds the truncate query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @returns The query builder
+     */
+    truncate(): this;
+    /**
+     * @description Builds the soft delete query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param options Soft delete options
+     * @returns The query builder
+     */
+    softDelete(options?: Omit<SoftDeleteOptions<any>, "ignoreBeforeDeleteHook">): this;
+}
+
 type BaseValues$1 = string | number | boolean | null;
 type BinaryOperatorType$1 = "=" | "!=" | "<>" | ">" | "<" | ">=" | "<=" | "like" | "ilike" | "in";
 declare class HavingNode extends QueryNode {
@@ -2401,6 +2458,12 @@ type PaginateWithCursorOptions<T extends Model, K extends ModelKey<T>> = {
     operator?: "<" | ">";
     orderBy?: "asc" | "desc";
 };
+type UpsertOptionsRawBuilder = {
+    updateOnConflict?: boolean;
+    returning?: string[];
+};
+type DryQueryBuilderWithoutReadOperations = Omit<DryQueryBuilder, "many" | "one" | "oneOrFail" | "first" | "firstOrFail" | "paginate" | "paginateWithCursor" | "exists" | "pluck" | "upsert" | "upsertMany" | "increment" | "decrement" | "getSum" | "getAvg" | "getMin" | "getMax" | "getCount" | "stream" | "chunk" | "paginate" | "paginateWithCursor" | "exists">;
+type DryModelQueryBuilderWithoutReadOperations<T extends Model, A extends Record<string, any> = {}, R extends Record<string, any> = {}> = Omit<DryModelQueryBuilder<T, A, R>, "many" | "one" | "oneOrFail" | "first" | "firstOrFail" | "paginate" | "paginateWithCursor" | "exists" | "pluck" | "upsert" | "upsertMany" | "increment" | "decrement" | "getSum" | "getAvg" | "getMin" | "getMax" | "getCount" | "stream" | "chunk" | "paginate" | "paginateWithCursor" | "exists">;
 
 declare class SqlModelManagerUtils<T extends Model> {
     protected dbType: SqlDataSourceType;
@@ -2436,15 +2499,6 @@ type CursorPaginatedData<T extends Model, A extends object = {}, R extends objec
     data: AnnotatedModel<T, A, R>[];
 };
 
-type DeleteOptions = {
-    ignoreBeforeDeleteHook?: boolean;
-};
-type SoftDeleteOptions<T> = {
-    column?: MongoCollectionKey<T>;
-    value?: string | number | boolean;
-    ignoreBeforeDeleteHook?: boolean;
-};
-
 type UpdateOptions = {
     ignoreBeforeUpdateHook?: boolean;
 };
@@ -2822,6 +2876,50 @@ declare class ModelQueryBuilder<T extends Model, A extends Record<string, any> =
     private truncateWithPerformance;
 }
 
+/**
+ * Allows to get model queries without executing them
+ */
+declare class DryModelQueryBuilder<T extends Model, A extends Record<string, any> = {}, R extends Record<string, any> = {}> extends ModelQueryBuilder<T, A, R> {
+    constructor(model: typeof Model, sqlDataSource: SqlDataSource);
+    many(): this;
+    /**
+     * @description Builds the insert query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the insert method
+     * @returns The query builder
+     */
+    insert(...args: Parameters<typeof this$1.model.insert<T>>): this;
+    /**
+     * @description Builds the insert many query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param args The arguments to pass to the insert many method
+     * @returns The query builder
+     */
+    insertMany(...args: Parameters<typeof this$1.model.insertMany<T>>): this;
+    /**
+     * @description Builds the update query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param data The data to update
+     * @param options Update options
+     * @returns The query builder
+     */
+    update(...args: Parameters<ReturnType<typeof this$1.model.query<T>>["update"]>): this;
+    /**
+     * @description Builds the delete query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param options Delete options
+     * @returns The query builder
+     */
+    delete(...args: Parameters<ReturnType<typeof this$1.model.query<T>>["delete"]>): this;
+    /**
+     * @description Builds the truncate query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @returns The query builder
+     */
+    truncate(): this;
+    /**
+     * @description Builds the soft delete query statement without executing it, use 'unWrap' or 'toQuery' to get the query statement
+     * @param options Soft delete options
+     * @returns The query builder
+     */
+    softDelete(...args: Parameters<ReturnType<typeof this$1.model.query<T>>["softDelete"]>): this;
+}
+
 declare class ModelManager<T extends Model> {
     protected sqlDataSource: SqlDataSource;
     protected sqlType: SqlDataSourceType;
@@ -2881,6 +2979,11 @@ declare class ModelManager<T extends Model> {
      * @description Returns a query builder instance
      */
     query(): Omit<ModelQueryBuilder<T>, "insert" | "insertMany">;
+    /**
+     * @description Returns a dry query builder instance
+     * @description The dry query builder instance will not execute the query, it will return the query statement
+     */
+    dryQuery(): Omit<DryModelQueryBuilder<T>, "insert" | "insertMany">;
     /**
      * @description Mysql does not return the inserted model, so we need to get the inserted model from the database
      */
@@ -3004,6 +3107,12 @@ declare class SqlDataSource extends DataSource {
      * @param table The table name to query from, must be in valid sql format `table` or `table as alias`
      */
     static query<S extends string>(table: TableFormat<S>, options?: RawModelOptions): QueryBuilder;
+    /**
+     * @description Returns a dry query builder instance
+     * @description The dry query builder instance will not execute the query, it will return the query statement
+     * @returns The dry query builder instance
+     */
+    static dryQuery<S extends string>(table: TableFormat<S>, options?: RawModelOptions): DryQueryBuilderWithoutReadOperations;
     /**
      * @description Creates a table on the database, return the query to be executed to create the table
      */
@@ -3098,6 +3207,12 @@ declare class SqlDataSource extends DataSource {
      * @param table The table name to query from, must be in valid sql format `table` or `table as alias`
      */
     query<S extends string>(table: TableFormat<S>, options?: RawModelOptions): QueryBuilder;
+    /**
+     * @description Returns a DryQueryBuilder instance
+     * @description The dry query builder instance will not execute the query, it will return the query statement
+     * @returns The dry query builder instance
+     */
+    dryQuery<S extends string>(table: TableFormat<S>, options?: RawModelOptions): DryQueryBuilderWithoutReadOperations;
     /**
      * @description Return the query to alter the given table schema
      */
@@ -3324,6 +3439,47 @@ declare class AstParser {
     private mapCommonDbType;
 }
 
+declare class DeleteNode extends QueryNode {
+    fromNode: FromNode;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(fromNode: FromNode, isRawValue?: boolean);
+}
+
+declare class InsertNode extends QueryNode {
+    fromNode: FromNode;
+    records: Record<string, any>[];
+    returning?: string[];
+    disableReturning: boolean;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(fromNode: FromNode, records?: Record<string, any>[], returning?: string[], disableReturning?: boolean, isRawValue?: boolean);
+}
+
+declare class TruncateNode extends QueryNode {
+    fromNode: FromNode | string;
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(fromNode: FromNode | string, isRawValue?: boolean);
+}
+
+declare class UpdateNode extends QueryNode {
+    fromNode: FromNode;
+    columns: string[];
+    values: (any | RawNode)[];
+    chainsWith: string;
+    canKeywordBeSeenMultipleTimes: boolean;
+    folder: string;
+    file: string;
+    constructor(fromNode: FromNode, columns?: string[], values?: (any | RawNode)[], isRawValue?: boolean);
+}
+
 declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
     model: typeof Model;
     protected astParser: AstParser;
@@ -3333,6 +3489,10 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
     protected isNestedCondition: boolean;
     protected mustRemoveAnnotations: boolean;
     protected interpreterUtils: InterpreterUtils;
+    protected insertNode: InsertNode | null;
+    protected updateNode: UpdateNode | null;
+    protected deleteNode: DeleteNode | null;
+    protected truncateNode: TruncateNode | null;
     /**
      * @description Performance methods that return the time that took to execute the query with the result
      */
@@ -3434,7 +3594,7 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
      * @postgres needs the pg-query-stream package in order to work
      * @throws If using postgres and the `pg-query-stream` package is not installed
      */
-    stream<M extends Model = T>(options?: StreamOptions, cb?: (stream: PassThrough & AsyncGenerator<AnnotatedModel<M, any, any>>) => void | Promise<void>): Promise<PassThrough & AsyncGenerator<AnnotatedModel<M, {}, {}>>>;
+    stream<M extends Model = T>(options?: StreamOptions): Promise<PassThrough & AsyncGenerator<AnnotatedModel<M, {}, {}>>>;
     /**
      * @description Chunks the query into smaller queries, it returns a generator of the chunks
      * @description It will continue to yield chunks until the query returns no results
@@ -3584,6 +3744,22 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
      * @returns raw driver response
      */
     insertMany(data: Record<string, any>[], returning?: string[]): Promise<T[]>;
+    /**
+     * @description Updates or creates a new record using upsert functionality
+     * @param data The data to insert or update
+     * @param searchCriteria The criteria to search for existing records
+     * @param options Upsert options including updateOnConflict and returning columns
+     * @returns The upserted record
+     */
+    upsert<O extends Record<string, any>>(data: O, searchCriteria: Partial<O>, options?: UpsertOptionsRawBuilder): Promise<T[]>;
+    /**
+     * @description Updates or creates multiple records using upsert functionality
+     * @param conflictColumns The columns to check for conflicts
+     * @param columnsToUpdate The columns to update on conflict
+     * @param data Array of data objects to insert or update
+     * @param options Upsert options including updateOnConflict and returning columns
+     */
+    upsertMany<O extends Record<string, any>>(conflictColumns: string[], columnsToUpdate: string[], data: O[], options?: UpsertOptionsRawBuilder): Promise<T[]>;
     /**
      * @description Updates records from a table
      * @returns the number of affected rows
@@ -3609,11 +3785,11 @@ declare class QueryBuilder<T extends Model = any> extends JsonQueryBuilder<T> {
     /**
      * @description Returns the query with the parameters bound to the query
      */
-    toQuery(dbType?: SqlDataSourceType): string;
+    toQuery(): string;
     /**
      * @description Returns the query with database driver placeholders and the params
      */
-    unWrap(_dbType?: SqlDataSourceType): ReturnType<typeof AstParser.prototype.parse>;
+    unWrap(): ReturnType<typeof AstParser.prototype.parse>;
     /**
      * @description Returns a deep clone of the query builder instance.
      */
@@ -3846,6 +4022,11 @@ declare abstract class Model extends Entity {
      * @description Gives a query sqlInstance for the given model
      */
     static query<T extends Model>(this: new () => T | typeof Model, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): ModelQueryBuilder<T>;
+    /**
+     * @description Returns a dry query builder instance
+     * @description The dry query builder instance will not execute the query
+     */
+    static dryQuery<T extends Model>(this: new () => T | typeof Model, options?: Omit<BaseModelMethodOptions, "ignoreHooks">): DryModelQueryBuilderWithoutReadOperations<T>;
     /**
      * @description Finds the first record in the database
      * @deprecated Used only for debugging purposes, use findOne or query instead
@@ -5120,4 +5301,4 @@ declare const generateOpenApiModelWithMetadata: <T extends new () => Model>(mode
     modelName: string;
 }>;
 
-export { type AnnotatedModel, type AsymmetricEncryptionOptions, type AugmentedSqlDataSource, AutogeneratedModel, type BaseModelMethodOptions, type BaseModelRelationType, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type CommonSqlMethodReturnType, type ConnectionPolicies, type DataSourceInput, type DataSourceType, type DateColumnOptions, type FetchHooks, type GetConnectionReturnType, HysteriaError, type IndexType, type LazyRelationType, type ManyOptions, type ManyToManyOptions, Migration, Model, type ModelInstanceType, ModelQueryBuilder, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NumberModelKey, type OneOptions, type PgPoolClientInstance, type PostgresSqlDataSourceInput, QueryBuilder, type RawModelOptions, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationQueryBuilderType, type SqlCloneOptions, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDataSourceWithoutTransaction, type SqlDriverSpecificOptions, type SqlPoolType, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type SymmetricEncryptionOptions, type TableFormat, type ThroughModel, TimestampedModel, Transaction, type TransactionExecutionOptions, type UniqueType, type UseConnectionInput, User, UuidModel, belongsTo, column, createModelFactory, defineMigrator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, index, HysteriaLogger as logger, manyToMany, MongoDataSource as mongo, property, RedisDataSource as redis, SqlDataSource as sql, unique, view, withPerformance };
+export { type AnnotatedModel, type AsymmetricEncryptionOptions, type AugmentedSqlDataSource, AutogeneratedModel, type BaseModelMethodOptions, type BaseModelRelationType, ClientMigrator, Collection, type ColumnDataTypeOption, type ColumnDataTypeOptionSimple, type ColumnDataTypeOptionWithBinary, type ColumnDataTypeOptionWithDatePrecision, type ColumnDataTypeOptionWithEnum, type ColumnDataTypeOptionWithLength, type ColumnDataTypeOptionWithPrecision, type ColumnDataTypeOptionWithScaleAndPrecision, type ColumnDataTypeOptionWithText, type ColumnOptions, type ColumnType, type CommonDataSourceInput, type CommonSqlMethodReturnType, type ConnectionPolicies, type DataSourceInput, type DataSourceType, type DateColumnOptions, DryModelQueryBuilder, DryQueryBuilder, type FetchHooks, type GetConnectionReturnType, HysteriaError, type IndexType, type LazyRelationType, type ManyOptions, type ManyToManyOptions, Migration, Model, type ModelInstanceType, ModelQueryBuilder, type ModelWithoutRelations, MongoDataSource, type MongoDataSourceInput, type MysqlConnectionInstance, type MysqlSqlDataSourceInput, type NotNullableMysqlSqlDataSourceInput, type NotNullablePostgresSqlDataSourceInput, type NotNullableSqliteDataSourceInput, type NumberModelKey, type OneOptions, type PgPoolClientInstance, type PostgresSqlDataSourceInput, QueryBuilder, type RawModelOptions, type RedisFetchable, type RedisStorable, type RelatedInstance, type RelationQueryBuilderType, type SqlCloneOptions, type SqlDataSourceInput, type SqlDataSourceModel, type SqlDataSourceType, type SqlDataSourceWithoutTransaction, type SqlDriverSpecificOptions, type SqlPoolType, type SqliteConnectionInstance, type SqliteDataSourceInput, type StartTransactionOptions, type SymmetricEncryptionOptions, type TableFormat, type ThroughModel, TimestampedModel, Transaction, type TransactionExecutionOptions, type UniqueType, type UseConnectionInput, User, UuidModel, belongsTo, column, createModelFactory, defineMigrator, generateOpenApiModel, generateOpenApiModelSchema, generateOpenApiModelWithMetadata, getCollectionProperties, getIndexes, getModelColumns, type getPoolReturnType, getPrimaryKey, getRelations, getRelationsMetadata, getUniques, hasMany, hasOne, index, HysteriaLogger as logger, manyToMany, MongoDataSource as mongo, property, RedisDataSource as redis, SqlDataSource as sql, unique, view, withPerformance };