kysely 0.28.2 → 0.28.4

package/dist/esm/kysely.js

@@ -17,6 +17,7 @@ import { CaseNode } from './operation-node/case-node.js';
 import { parseExpression } from './parser/expression-parser.js';
 import { WithSchemaPlugin } from './plugin/with-schema/with-schema-plugin.js';
 import { provideControlledConnection, } from './util/provide-controlled-connection.js';
+import { logOnce } from './util/log-once.js';
 // @ts-ignore
 Symbol.asyncDispose ??= Symbol('Symbol.asyncDispose');
 /**
@@ -457,9 +458,14 @@ export class Kysely extends QueryCreator {
      *
      * See {@link https://github.com/kysely-org/kysely/blob/master/site/docs/recipes/0004-splitting-query-building-and-execution.md#execute-compiled-queries splitting build, compile and execute code recipe} for more information.
      */
-    executeQuery(query, queryId = createQueryId()) {
+    executeQuery(query, 
+    // TODO: remove this in the future. deprecated in  0.28.x
+    queryId) {
+        if (queryId !== undefined) {
+            logOnce('Passing `queryId` in `db.executeQuery` is deprecated and will result in a compile-time error in the future.');
+        }
         const compiledQuery = isCompilable(query) ? query.compile() : query;
-        return this.getExecutor().executeQuery(compiledQuery, queryId);
+        return this.getExecutor().executeQuery(compiledQuery);
     }
     async [Symbol.asyncDispose]() {
         await this.destroy();
@@ -878,13 +884,13 @@ class NotCommittedOrRolledBackAssertingExecutor {
     provideConnection(consumer) {
         return this.#executor.provideConnection(consumer);
     }
-    executeQuery(compiledQuery, queryId) {
+    executeQuery(compiledQuery) {
         assertNotCommittedOrRolledBack(this.#state);
-        return this.#executor.executeQuery(compiledQuery, queryId);
+        return this.#executor.executeQuery(compiledQuery);
     }
-    stream(compiledQuery, chunkSize, queryId) {
+    stream(compiledQuery, chunkSize) {
         assertNotCommittedOrRolledBack(this.#state);
-        return this.#executor.stream(compiledQuery, chunkSize, queryId);
+        return this.#executor.stream(compiledQuery, chunkSize);
     }
     withConnectionProvider(connectionProvider) {
         return new NotCommittedOrRolledBackAssertingExecutor(this.#executor.withConnectionProvider(connectionProvider), this.#state);

package/dist/esm/migration/migrator.js

@@ -1,7 +1,7 @@
 /// <reference types="./migrator.d.ts" />
 import { NoopPlugin } from '../plugin/noop-plugin.js';
 import { WithSchemaPlugin } from '../plugin/with-schema/with-schema-plugin.js';
-import { freeze, getLast } from '../util/object-utils.js';
+import { freeze, getLast, isObject } from '../util/object-utils.js';
 export const DEFAULT_MIGRATION_TABLE = 'kysely_migration';
 export const DEFAULT_MIGRATION_LOCK_TABLE = 'kysely_migration_lock';
 export const DEFAULT_ALLOW_UNORDERED_MIGRATIONS = false;
@@ -176,7 +176,8 @@ export class Migrator {
      */
     async migrateTo(targetMigrationName) {
         return this.#migrate(({ migrations, executedMigrations, pendingMigrations, }) => {
-            if (targetMigrationName === NO_MIGRATIONS) {
+            if (isObject(targetMigrationName) &&
+                targetMigrationName.__noMigrations__ === true) {
                 return { direction: 'Down', step: Infinity };
             }
             if (!migrations.find((m) => m.name === targetMigrationName)) {

package/dist/esm/parser/delete-from-parser.d.ts

@@ -2,4 +2,8 @@ import type { DeleteQueryBuilder } from '../query-builder/delete-query-builder.j
 import type { DeleteResult } from '../query-builder/delete-result.js';
 import type { ShallowRecord } from '../util/type-utils.js';
 import type { ExtractTableAlias, From, FromTables, TableExpressionOrList } from './table-parser.js';
-export type DeleteFrom<DB, TE extends TableExpressionOrList<DB, never>> = TE extends ReadonlyArray<infer T> ? DeleteQueryBuilder<From<DB, T>, FromTables<DB, never, T>, DeleteResult> : TE extends keyof DB & string ? DeleteQueryBuilder<DB, ExtractTableAlias<DB, TE>, DeleteResult> : TE extends `${infer T} as ${infer A}` ? T extends keyof DB ? DeleteQueryBuilder<DB & ShallowRecord<A, DB[T]>, A, DeleteResult> : never : DeleteQueryBuilder<From<DB, TE>, FromTables<DB, never, TE>, DeleteResult>;
+export type DeleteFrom<DB, TE extends TableExpressionOrList<DB, never>> = [
+    TE
+] extends [keyof DB] ? DeleteQueryBuilder<DB, ExtractTableAlias<DB, TE>, DeleteResult> : [
+    TE
+] extends [`${infer T} as ${infer A}`] ? T extends keyof DB ? DeleteQueryBuilder<DB & ShallowRecord<A, DB[T]>, A, DeleteResult> : never : TE extends ReadonlyArray<infer T> ? DeleteQueryBuilder<From<DB, T>, FromTables<DB, never, T>, DeleteResult> : DeleteQueryBuilder<From<DB, TE>, FromTables<DB, never, TE>, DeleteResult>;

package/dist/esm/parser/merge-into-parser.d.ts

@@ -2,4 +2,6 @@ import type { MergeQueryBuilder } from '../query-builder/merge-query-builder.js'
 import type { MergeResult } from '../query-builder/merge-result.js';
 import type { ShallowRecord } from '../util/type-utils.js';
 import type { ExtractTableAlias, SimpleTableReference } from './table-parser.js';
-export type MergeInto<DB, TE extends SimpleTableReference<DB>> = TE extends keyof DB & string ? MergeQueryBuilder<DB, ExtractTableAlias<DB, TE>, MergeResult> : TE extends `${infer T} as ${infer A}` ? T extends keyof DB ? MergeQueryBuilder<DB & ShallowRecord<A, DB[T]>, A, MergeResult> : never : never;
+export type MergeInto<DB, TE extends SimpleTableReference<DB>> = [TE] extends [
+    keyof DB
+] ? MergeQueryBuilder<DB, ExtractTableAlias<DB, TE>, MergeResult> : [TE] extends [`${infer T} as ${infer A}`] ? T extends keyof DB ? MergeQueryBuilder<DB & ShallowRecord<A, DB[T]>, A, MergeResult> : never : never;

package/dist/esm/parser/select-from-parser.d.ts

@@ -1,4 +1,6 @@
 import type { SelectQueryBuilder } from '../query-builder/select-query-builder.js';
 import type { ShallowRecord } from '../util/type-utils.js';
 import type { ExtractTableAlias, From, FromTables, TableExpressionOrList } from './table-parser.js';
-export type SelectFrom<DB, TB extends keyof DB, TE extends TableExpressionOrList<DB, TB>> = TE extends keyof DB & string ? SelectQueryBuilder<DB, TB | ExtractTableAlias<DB, TE>, {}> : TE extends `${infer T} as ${infer A}` ? T extends keyof DB ? SelectQueryBuilder<DB & ShallowRecord<A, DB[T]>, TB | A, {}> : never : TE extends ReadonlyArray<infer T> ? SelectQueryBuilder<From<DB, T>, FromTables<DB, TB, T>, {}> : SelectQueryBuilder<From<DB, TE>, FromTables<DB, TB, TE>, {}>;
+export type SelectFrom<DB, TB extends keyof DB, TE extends TableExpressionOrList<DB, TB>> = [TE] extends [keyof DB] ? SelectQueryBuilder<DB, TB | ExtractTableAlias<DB, TE>, {}> : [
+    TE
+] extends [`${infer T} as ${infer A}`] ? T extends keyof DB ? SelectQueryBuilder<DB & ShallowRecord<A, DB[T]>, TB | A, {}> : never : TE extends ReadonlyArray<infer T> ? SelectQueryBuilder<From<DB, T>, FromTables<DB, TB, T>, {}> : SelectQueryBuilder<From<DB, TE>, FromTables<DB, TB, TE>, {}>;

package/dist/esm/parser/update-parser.d.ts

@@ -2,4 +2,8 @@ import type { UpdateQueryBuilder } from '../query-builder/update-query-builder.j
 import type { UpdateResult } from '../query-builder/update-result.js';
 import type { ShallowRecord } from '../util/type-utils.js';
 import type { ExtractTableAlias, From, FromTables, TableExpressionOrList } from './table-parser.js';
-export type UpdateTable<DB, TE extends TableExpressionOrList<DB, never>> = TE extends ReadonlyArray<infer T> ? UpdateQueryBuilder<From<DB, T>, FromTables<DB, never, T>, FromTables<DB, never, T>, UpdateResult> : TE extends keyof DB & string ? UpdateQueryBuilder<DB, ExtractTableAlias<DB, TE>, ExtractTableAlias<DB, TE>, UpdateResult> : TE extends `${infer T} as ${infer A}` ? T extends keyof DB ? UpdateQueryBuilder<DB & ShallowRecord<A, DB[T]>, A, A, UpdateResult> : never : UpdateQueryBuilder<From<DB, TE>, FromTables<DB, never, TE>, FromTables<DB, never, TE>, UpdateResult>;
+export type UpdateTable<DB, TE extends TableExpressionOrList<DB, never>> = [
+    TE
+] extends [keyof DB] ? UpdateQueryBuilder<DB, ExtractTableAlias<DB, TE>, ExtractTableAlias<DB, TE>, UpdateResult> : [
+    TE
+] extends [`${infer T} as ${infer A}`] ? T extends keyof DB ? UpdateQueryBuilder<DB & ShallowRecord<A, DB[T]>, A, A, UpdateResult> : never : TE extends ReadonlyArray<infer T> ? UpdateQueryBuilder<From<DB, T>, FromTables<DB, never, T>, FromTables<DB, never, T>, UpdateResult> : UpdateQueryBuilder<From<DB, TE>, FromTables<DB, never, TE>, FromTables<DB, never, TE>, UpdateResult>;

package/dist/esm/query-builder/delete-query-builder.js

@@ -449,7 +449,7 @@ export class DeleteQueryBuilder {
      */
     async execute() {
         const compiledQuery = this.compile();
-        const result = await this.#props.executor.executeQuery(compiledQuery, this.#props.queryId);
+        const result = await this.#props.executor.executeQuery(compiledQuery);
         const { adapter } = this.#props.executor;
         const query = compiledQuery.query;
         if ((query.returning && adapter.supportsReturning) ||
@@ -486,7 +486,7 @@ export class DeleteQueryBuilder {
     }
     async *stream(chunkSize = 100) {
         const compiledQuery = this.compile();
-        const stream = this.#props.executor.stream(compiledQuery, chunkSize, this.#props.queryId);
+        const stream = this.#props.executor.stream(compiledQuery, chunkSize);
         for await (const item of stream) {
             yield* item.rows;
         }

package/dist/esm/query-builder/function-module.d.ts

@@ -3,10 +3,10 @@ import { Expression } from '../expression/expression.js';
 import { ExtractTypeFromCoalesce1, ExtractTypeFromCoalesce3, ExtractTypeFromCoalesce2, ExtractTypeFromCoalesce4, ExtractTypeFromCoalesce5 } from '../parser/coalesce-parser.js';
 import { ExtractTypeFromReferenceExpression, ReferenceExpression, StringReference, ExtractTypeFromStringReference } from '../parser/reference-parser.js';
 import { KyselyTypeError } from '../util/type-error.js';
-import { IsNever } from '../util/type-utils.js';
+import { IsNever, ShallowDehydrateObject, ShallowDehydrateValue, Simplify } from '../util/type-utils.js';
 import { AggregateFunctionBuilder } from './aggregate-function-builder.js';
 import { SelectQueryBuilderExpression } from '../query-builder/select-query-builder-expression.js';
-import { Selectable } from '../util/column-type.js';
+import { Selectable, SelectType } from '../util/column-type.js';
 /**
  * Helpers for type safe SQL function calls.
  *
@@ -514,7 +514,7 @@ export interface FunctionModule<DB, TB extends keyof DB> {
      *  $1 = any("person"."nicknames")
      * ```
      */
-    any<RE extends StringReference<DB, TB>>(expr: RE): Exclude<ExtractTypeFromStringReference<DB, TB, RE>, null> extends ReadonlyArray<infer I> ? ExpressionWrapper<DB, TB, I> : KyselyTypeError<'any(expr) call failed: expr must be an array'>;
+    any<RE extends StringReference<DB, TB>>(expr: RE): Exclude<ExtractTypeFromReferenceExpression<DB, TB, RE>, null> extends ReadonlyArray<infer I> ? ExpressionWrapper<DB, TB, I> : KyselyTypeError<'any(expr) call failed: expr must be an array'>;
     any<T>(subquery: SelectQueryBuilderExpression<Record<string, T>>): ExpressionWrapper<DB, TB, T>;
     any<T>(expr: Expression<ReadonlyArray<T>>): ExpressionWrapper<DB, TB, T>;
     /**
@@ -565,8 +565,8 @@ export interface FunctionModule<DB, TB extends keyof DB> {
      * group by "person"."first_name"
      * ```
      */
-    jsonAgg<T extends (TB & string) | Expression<unknown>>(table: T): AggregateFunctionBuilder<DB, TB, T extends TB ? Selectable<DB[T]>[] : T extends Expression<infer O> ? O[] : never>;
-    jsonAgg<RE extends StringReference<DB, TB>>(column: RE): AggregateFunctionBuilder<DB, TB, ExtractTypeFromStringReference<DB, TB, RE>[] | null>;
+    jsonAgg<T extends (TB & string) | Expression<unknown>>(table: T): AggregateFunctionBuilder<DB, TB, T extends TB ? Simplify<ShallowDehydrateObject<Selectable<DB[T]>>>[] : T extends Expression<infer O> ? Simplify<ShallowDehydrateObject<O>>[] : never>;
+    jsonAgg<RE extends StringReference<DB, TB>>(column: RE): AggregateFunctionBuilder<DB, TB, ShallowDehydrateValue<SelectType<ExtractTypeFromStringReference<DB, TB, RE>>>[] | null>;
     /**
      * Creates a to_json function call.
      *
@@ -587,6 +587,6 @@ export interface FunctionModule<DB, TB extends keyof DB> {
      * inner join "pet" on "pet"."owner_id" = "person"."id"
      * ```
      */
-    toJson<T extends (TB & string) | Expression<unknown>>(table: T): ExpressionWrapper<DB, TB, T extends TB ? Selectable<DB[T]> : T extends Expression<infer O> ? O : never>;
+    toJson<T extends (TB & string) | Expression<unknown>>(table: T): ExpressionWrapper<DB, TB, T extends TB ? Simplify<ShallowDehydrateObject<Selectable<DB[T]>>> : T extends Expression<infer O> ? Simplify<ShallowDehydrateObject<O>> : never>;
 }
 export declare function createFunctionModule<DB, TB extends keyof DB>(): FunctionModule<DB, TB>;

package/dist/esm/query-builder/insert-query-builder.js

@@ -1103,7 +1103,7 @@ export class InsertQueryBuilder {
      */
     async execute() {
         const compiledQuery = this.compile();
-        const result = await this.#props.executor.executeQuery(compiledQuery, this.#props.queryId);
+        const result = await this.#props.executor.executeQuery(compiledQuery);
         const { adapter } = this.#props.executor;
         const query = compiledQuery.query;
         if ((query.returning && adapter.supportsReturning) ||
@@ -1142,7 +1142,7 @@ export class InsertQueryBuilder {
     }
     async *stream(chunkSize = 100) {
         const compiledQuery = this.compile();
-        const stream = this.#props.executor.stream(compiledQuery, chunkSize, this.#props.queryId);
+        const stream = this.#props.executor.stream(compiledQuery, chunkSize);
         for await (const item of stream) {
             yield* item.rows;
         }

package/dist/esm/query-builder/merge-query-builder.js

@@ -416,7 +416,7 @@ export class WheneableMergeQueryBuilder {
      */
     async execute() {
         const compiledQuery = this.compile();
-        const result = await this.#props.executor.executeQuery(compiledQuery, this.#props.queryId);
+        const result = await this.#props.executor.executeQuery(compiledQuery);
         const { adapter } = this.#props.executor;
         const query = compiledQuery.query;
         if ((query.returning && adapter.supportsReturning) ||

package/dist/esm/query-builder/select-query-builder.js

@@ -314,7 +314,7 @@ class SelectQueryBuilderImpl {
     }
     async execute() {
         const compiledQuery = this.compile();
-        const result = await this.#props.executor.executeQuery(compiledQuery, this.#props.queryId);
+        const result = await this.#props.executor.executeQuery(compiledQuery);
         return result.rows;
     }
     async executeTakeFirst() {
@@ -333,7 +333,7 @@ class SelectQueryBuilderImpl {
     }
     async *stream(chunkSize = 100) {
         const compiledQuery = this.compile();
-        const stream = this.#props.executor.stream(compiledQuery, chunkSize, this.#props.queryId);
+        const stream = this.#props.executor.stream(compiledQuery, chunkSize);
         for await (const item of stream) {
             yield* item.rows;
         }

package/dist/esm/query-builder/update-query-builder.js

@@ -456,7 +456,7 @@ export class UpdateQueryBuilder {
      */
     async execute() {
         const compiledQuery = this.compile();
-        const result = await this.#props.executor.executeQuery(compiledQuery, this.#props.queryId);
+        const result = await this.#props.executor.executeQuery(compiledQuery);
         const { adapter } = this.#props.executor;
         const query = compiledQuery.query;
         if ((query.returning && adapter.supportsReturning) ||
@@ -495,7 +495,7 @@ export class UpdateQueryBuilder {
     }
     async *stream(chunkSize = 100) {
         const compiledQuery = this.compile();
-        const stream = this.#props.executor.stream(compiledQuery, chunkSize, this.#props.queryId);
+        const stream = this.#props.executor.stream(compiledQuery, chunkSize);
         for await (const item of stream) {
             yield* item.rows;
         }

package/dist/esm/query-compiler/default-query-compiler.js

@@ -1318,7 +1318,7 @@ export class DefaultQueryCompiler extends OperationNodeVisitor {
         if (isString(value)) {
             this.appendStringLiteral(value);
         }
-        else if (isNumber(value) || isBoolean(value)) {
+        else if (isNumber(value) || isBoolean(value) || isBigInt(value)) {
             this.append(value.toString());
         }
         else if (isNull(value)) {
@@ -1327,9 +1327,6 @@ export class DefaultQueryCompiler extends OperationNodeVisitor {
         else if (isDate(value)) {
             this.appendImmediateValue(value.toISOString());
         }
-        else if (isBigInt(value)) {
-            this.appendImmediateValue(value.toString());
-        }
         else {
             throw new Error(`invalid immediate value ${value}`);
         }

package/dist/esm/query-executor/query-executor-base.d.ts

@@ -35,13 +35,13 @@ export declare abstract class QueryExecutorBase implements QueryExecutor {
      * Executes a compiled query and runs the result through all plugins'
      * `transformResult` method.
      */
-    executeQuery<R>(compiledQuery: CompiledQuery, queryId: QueryId): Promise<QueryResult<R>>;
+    executeQuery<R>(compiledQuery: CompiledQuery): Promise<QueryResult<R>>;
     /**
      * Executes a compiled query and runs the result through all plugins'
      * `transformResult` method. Results are streamead instead of loaded
      * at once.
      */
-    stream<R>(compiledQuery: CompiledQuery, chunkSize: number, queryId: QueryId): AsyncIterableIterator<QueryResult<R>>;
+    stream<R>(compiledQuery: CompiledQuery, chunkSize: number): AsyncIterableIterator<QueryResult<R>>;
     /**
      * Returns a copy of this executor with a new connection provider.
      */

package/dist/esm/query-executor/query-executor-base.js

@@ -30,20 +30,20 @@ export class QueryExecutorBase {
         }
         return node;
     }
-    async executeQuery(compiledQuery, queryId) {
+    async executeQuery(compiledQuery) {
         return await this.provideConnection(async (connection) => {
             const result = await connection.executeQuery(compiledQuery);
             if ('numUpdatedOrDeletedRows' in result) {
                 logOnce('kysely:warning: outdated driver/plugin detected! `QueryResult.numUpdatedOrDeletedRows` has been replaced with `QueryResult.numAffectedRows`.');
             }
-            return await this.#transformResult(result, queryId);
+            return await this.#transformResult(result, compiledQuery.queryId);
         });
     }
-    async *stream(compiledQuery, chunkSize, queryId) {
+    async *stream(compiledQuery, chunkSize) {
         const { connection, release } = await provideControlledConnection(this);
         try {
             for await (const result of connection.streamQuery(compiledQuery, chunkSize)) {
-                yield await this.#transformResult(result, queryId);
+                yield await this.#transformResult(result, compiledQuery.queryId);
             }
         }
         finally {

package/dist/esm/query-executor/query-executor.d.ts

@@ -36,7 +36,7 @@ export interface QueryExecutor extends ConnectionProvider {
      * Executes a compiled query and runs the result through all plugins'
      * `transformResult` method.
      */
-    executeQuery<R>(compiledQuery: CompiledQuery<R>, queryId: QueryId): Promise<QueryResult<R>>;
+    executeQuery<R>(compiledQuery: CompiledQuery<R>): Promise<QueryResult<R>>;
     /**
      * Executes a compiled query and runs the result through all plugins'
      * `transformResult` method. Results are streamead instead of loaded
@@ -47,7 +47,7 @@ export interface QueryExecutor extends ConnectionProvider {
      * How many rows should be pulled from the database at once. Supported
      * only by the postgres driver.
      */
-    chunkSize: number, queryId: QueryId): AsyncIterableIterator<QueryResult<R>>;
+    chunkSize: number): AsyncIterableIterator<QueryResult<R>>;
     /**
      * Returns a copy of this executor with a new connection provider.
      */

package/dist/esm/raw-builder/raw-builder.js

@@ -40,7 +40,7 @@ class RawBuilderImpl {
     }
     async execute(executorProvider) {
         const executor = this.#getExecutor(executorProvider);
-        return executor.executeQuery(this.#compile(executor), this.#props.queryId);
+        return executor.executeQuery(this.#compile(executor));
     }
     #getExecutor(executorProvider) {
         const executor = executorProvider !== undefined

package/dist/esm/schema/alter-table-add-foreign-key-constraint-builder.js

@@ -59,6 +59,6 @@ export class AlterTableAddForeignKeyConstraintBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/alter-table-add-index-builder.js

@@ -157,6 +157,6 @@ export class AlterTableAddIndexBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/alter-table-builder.js

@@ -258,6 +258,6 @@ export class AlterTableColumnAlteringBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/alter-table-drop-constraint-builder.js

@@ -51,6 +51,6 @@ export class AlterTableDropConstraintBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/alter-table-executor.js

@@ -12,6 +12,6 @@ export class AlterTableExecutor {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/create-index-builder.js

@@ -194,6 +194,6 @@ export class CreateIndexBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/create-schema-builder.js

@@ -26,6 +26,6 @@ export class CreateSchemaBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/create-table-builder.js

@@ -403,6 +403,6 @@ export class CreateTableBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/create-type-builder.js

@@ -35,6 +35,6 @@ export class CreateTypeBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/create-view-builder.js

@@ -90,6 +90,6 @@ export class CreateViewBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/drop-index-builder.js

@@ -49,6 +49,6 @@ export class DropIndexBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/drop-schema-builder.js

@@ -36,6 +36,6 @@ export class DropSchemaBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/drop-table-builder.js

@@ -36,6 +36,6 @@ export class DropTableBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/drop-type-builder.js

@@ -28,6 +28,6 @@ export class DropTypeBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/drop-view-builder.js

@@ -44,6 +44,6 @@ export class DropViewBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/schema/refresh-materialized-view-builder.js

@@ -67,6 +67,6 @@ export class RefreshMaterializedViewBuilder {
         return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
     }
     async execute() {
-        await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
+        await this.#props.executor.executeQuery(this.compile());
     }
 }

package/dist/esm/util/type-utils.d.ts

@@ -169,3 +169,21 @@ export type DrainOuterGeneric<T> = [T] extends [unknown] ? T : never;
 export type ShallowRecord<K extends keyof any, T> = DrainOuterGeneric<{
     [P in K]: T;
 }>;
+/**
+ * Dehydrates any root properties of an object that are not valid JSON types.
+ *
+ * For now, we catch anything in {@link StringsWhenDataTypeNotAvailable} and convert it to `string`.
+ */
+export type ShallowDehydrateObject<O> = {
+    [K in keyof O]: ShallowDehydrateValue<O[K]>;
+};
+/**
+ * Dehydrates a value when it is not a valid JSON type.
+ *
+ * For now, we catch anything in {@link StringsWhenDataTypeNotAvailable} and convert it to `string`,
+ * and anything in {@link NumbersWhenDataTypeNotAvailable} and convert it to `number`.
+ */
+export type ShallowDehydrateValue<T> = T extends null | undefined ? T : T extends (infer U)[] | null | undefined ? Array<ShallowDehydrateValue<U>> | Extract<T, null | undefined> : Exclude<T, StringsWhenDataTypeNotAvailable | NumbersWhenDataTypeNotAvailable> | ([Extract<T, NumbersWhenDataTypeNotAvailable>] extends [never] ? never : number) | ([Extract<T, StringsWhenDataTypeNotAvailable>] extends [never] ? never : string);
+export type StringsWhenDataTypeNotAvailable = Date | Buffer | ArrayBuffer;
+export type NumbersWhenDataTypeNotAvailable = bigint | NumericString;
+export type NumericString = `${number}`;