kysely 0.12.2 → 0.15.0

package/README.md

@@ -4,8 +4,7 @@
 # [Kysely](https://koskimas.github.io/kysely/index.html)
 
 A type-safe and autocompletion-friendly typescript SQL query builder for node.js. Inspired by
-[knex](http://knexjs.org/). [Here's](https://www.jakso.me/blog/kysely-a-type-safe-sql-query-builder-for-typescript)
-an introductory blog post for you.
+[knex](http://knexjs.org/).
 
 ![](https://github.com/koskimas/kysely/blob/master/assets/demo.gif)
 
@@ -29,6 +28,9 @@ Kysely is still young and some useful features are propably not yet implemented.
 using Kysely and can't find something you'd want to use, please open an issue or join our
 [discord server](https://discord.gg/C9aJ49mCra).
 
+[Here's](https://www.jakso.me/blog/kysely-a-type-safe-sql-query-builder-for-typescript)
+an introductory blog post.
+
 # Table of contents
 
 - [Installation](#installation)
@@ -36,6 +38,7 @@ using Kysely and can't find something you'd want to use, please open an issue or
 - [Query examples](#query-examples)
 - [Migrations](#migrations)
 - [API reference](https://koskimas.github.io/kysely/index.html)
+- [Changelog](https://github.com/koskimas/kysely/releases)
 
 # Installation
 
@@ -65,34 +68,55 @@ All you need to do is define an interface for each table in the database and pas
 interfaces to the `Kysely` constructor:
 
 ```ts
-import { Kysely, PostgresDialect } from 'kysely'
+import {
+  Kysely,
+  PostgresDialect,
+  Generated,
+  ColumnType,
+  Selectable,
+  Insertable,
+  Updateable,
+} from 'kysely'
+
+interface PersonTable {
+  // Columns that are generated by the database should be marked
+  // using the `Generated` type. This way they are automatically
+  // made optional in inserts.
+  id: Generated<number>
 
-interface Person {
-  id: number
   first_name: string
-  // If the column is nullable in the db, make its type nullable.
-  // Don't use optional properties.
-  last_name: string | null
   gender: 'male' | 'female' | 'other'
+
+  // If the column is nullable in the database, make its type nullable.
+  // Don't use optional properties. Optionality is always determined
+  // automatically by Kysely.
+  last_name: string | null
+
+  // You can specity a type for each operation (select, insert and update)
+  // using the `ColumnType<SelectType, InsertType, UpdateType>` wrapper.
+  // Here we define a column `modified_at` that is selected as a `Date`,
+  // can optionally be provided as a `string` in inserts and can never
+  // be updated:
+  modified_at: ColumnType<Date, string | undefined, never>
 }
 
-interface Pet {
-  id: number
+interface PetTable {
+  id: Generated<number>
   name: string
   owner_id: number
   species: 'dog' | 'cat'
 }
 
-interface Movie {
-  id: string
+interface MovieTable {
+  id: Generated<string>
   stars: number
 }
 
 // Keys of this interface are table names.
 interface Database {
-  person: Person
-  pet: Pet
-  movie: Movie
+  person: PersonTable
+  pet: PetTable
+  movie: MovieTable
 }
 
 // You'd create one of these when you start your app.
@@ -101,15 +125,26 @@ const db = new Kysely<Database>({
   dialect: new PostgresDialect({
     host: 'localhost',
     database: 'kysely_test',
-  })
+  }),
 })
 
 async function demo() {
+  const { id } = await db
+    .insertInto('person')
+    .values({ first_name: 'Jennifer', gender: 'female' })
+    .returning('id')
+    .executeTakeFirstOrThrow()
+
+  await db
+    .insertInto('pet')
+    .values({ name: 'Catto', species: 'cat', owner_id: id })
+    .execute()
+
   const person = await db
     .selectFrom('person')
     .innerJoin('pet', 'pet.owner_id', 'person.id')
     .select(['first_name', 'pet.name as pet_name'])
-    .where('person.id', '=', 1)
+    .where('person.id', '=', id)
     .executeTakeFirst()
 
   if (person) {
@@ -118,6 +153,14 @@ async function demo() {
 }
 ```
 
+```ts
+// You can extract the select, insert and update interfaces like this
+// if you want (you don't need to):
+type Person = Selectable<PersonTable>
+type InsertablePerson = Insertable<PersonTable>
+type UpdateablePerson = Updateable<PersonTable>
+```
+
 # Query examples
 
 ## Select queries
@@ -248,36 +291,77 @@ export async function down(db: Kysely<any>): Promise<void> {
 You can then use
 
 ```ts
-await db.migration.migrateToLatest(pathToMigrationsFolder)
+const migrator = new Migrator(migratorConfig);
+await migrator.migrateToLatest(pathToMigrationsFolder)
 ```
 
 to run all migrations that have not yet been run. The migrations are executed in alphabetical
-order by their file name.
+order by their name. See the [Migrator](https://koskimas.github.io/kysely/classes/Migrator.html) 
+documentation for more info.
 
 Kysely doesn't have a CLI for running migrations and probably never will. This is because Kysely's
 migrations are also written in typescript. To run the migrations, you need to first build the
-typescript code into javascript. The CLI would cause confusion over which migrations are being
-run, the typescript ones or the javascript ones. If we added support for both, it would mean the
-CLI would depend on a typescript compiler, which most production environments don't (and shouldn't)
+typescript code into javascript. A CLI would cause confusion over which migrations are being
+run, the typescript ones or the javascript ones. If we added support for both, the CLI would 
+need to depend on a typescript compiler, which most production environments don't (and shouldn't)
 have. You will probably want to add a simple migration script to your projects like this:
 
 ```ts
-import path from 'path'
-import { db } from './database'
+import * as path from 'path'
+import * as fs from 'fs/promises'
+
+import {
+  Kysely,
+  Migrator,
+  PostgresDialect,
+  FileMigrationProvider
+} from 'kysely'
+
+async function migrateToLatest() {
+  const db = new Kysely<Database>({
+    dialect: new PostgresDialect({
+      host: 'localhost',
+      database: 'kysely_test',
+    }),
+  })
+
+  const migrator = new Migrator({
+    db,
+    // The constructor signature of FileMigrationProvider is a
+    // bit weird to keep Kysely independent of node.js or any
+    // other environment.
+    provider: new FileMigrationProvider(
+      fs.readdir,
+      path.join,
+      // Path to the folder that contains all your migrations.
+      'migrations'
+    )
+  })
+
+  const { error, results } = await migrator.migrateToLatest()
 
-db.migration
-  .migrateToLatest(path.join(__dirname, 'migrations'))
-  .then(() => db.destroy())
+  results?.forEach((it) => {
+    if (it.status === 'Success') {
+      console.log(`migration "${it.migrationName}" was executed successfully`)
+    } else if (it.status === 'Error') {
+      console.error(`failed to execute migration "${it.migrationName}"`)
+    }
+  })
+
+  if (error) {
+    console.error('failed to migrate')
+    console.error(error)
+    process.exit(1)
+  }
+}
+
+migrateToLatest()
 ```
 
 The migration methods use a lock on the database level, and parallel calls are executed serially.
 This means that you can safely call `migrateToLatest` and other migration methods from multiple
 server instances simultaneously and the migrations are guaranteed to only be executed once.
 
-NOTE: Only `db.migration.migrateToLatest` method is implemented at the moment. There is no way
-to run the down migrations, or to go forward to a specific migration. These methods will be
-added soon.
-
 # Why not just contribute to knex
 
 Kysely is very similar to knex, but it also attempts to fix things that I personally find not-so-good

package/dist/cjs/dialect/dialect.d.ts

@@ -1,7 +1,7 @@
 import { Driver } from '../driver/driver.js';
 import { Kysely } from '../kysely.js';
 import { QueryCompiler } from '../query-compiler/query-compiler.js';
-import { DatabaseIntrospector } from '../introspection/database-introspector.js';
+import { DatabaseIntrospector } from './database-introspector.js';
 import { DialectAdapter } from './dialect-adapter.js';
 /**
  * A Dialect is the glue between Kysely and the underlying database engine.

package/dist/cjs/dialect/mysql/mysql-adapter.d.ts

@@ -1,6 +1,6 @@
 import { Kysely } from '../../kysely.js';
-import { DialectAdapter } from '../dialect-adapter.js';
-export declare class MysqlAdapter implements DialectAdapter {
+import { DialectAdapterBase } from '../dialect-adapter-base.js';
+export declare class MysqlAdapter extends DialectAdapterBase {
     /**
      * Whether or not this dialect supports transactional DDL.
      *

package/dist/cjs/dialect/mysql/mysql-adapter.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MysqlAdapter = void 0;
+const dialect_adapter_base_js_1 = require("../dialect-adapter-base.js");
 const LOCK_ID = 'ea586330-2c93-47c8-908d-981d9d270f9d';
 const LOCK_TIMEOUT_SECONDS = 60 * 60;
-class MysqlAdapter {
+class MysqlAdapter extends dialect_adapter_base_js_1.DialectAdapterBase {
     get supportsTransactionalDdl() {
         return false;
     }

package/dist/cjs/dialect/mysql/mysql-dialect.d.ts

@@ -2,7 +2,7 @@ import { Driver } from '../../driver/driver.js';
 import { Kysely } from '../../kysely.js';
 import { QueryCompiler } from '../../query-compiler/query-compiler.js';
 import { Dialect } from '../dialect.js';
-import { DatabaseIntrospector } from '../../introspection/database-introspector.js';
+import { DatabaseIntrospector } from '../database-introspector.js';
 import { DialectAdapter } from '../dialect-adapter.js';
 import { DatabaseConnection } from '../../driver/database-connection.js';
 /**

package/dist/cjs/dialect/mysql/mysql-introspector.d.ts

@@ -1,4 +1,4 @@
-import { DatabaseIntrospector, DatabaseMetadata, DatabaseMetadataOptions } from '../../introspection/database-introspector.js';
+import { DatabaseIntrospector, DatabaseMetadata, DatabaseMetadataOptions } from '../database-introspector.js';
 import { Kysely } from '../../kysely.js';
 export declare class MysqlIntrospector implements DatabaseIntrospector {
     #private;

package/dist/cjs/dialect/mysql/mysql-introspector.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MysqlIntrospector = void 0;
-const migration_js_1 = require("../../migration/migration.js");
+const migrator_js_1 = require("../../migration/migrator.js");
 const object_utils_js_1 = require("../../util/object-utils.js");
 class MysqlIntrospector {
     #db;
@@ -16,8 +16,8 @@ class MysqlIntrospector {
             .castTo();
         if (!options.withInternalKyselyTables) {
             query = query
-                .where('table_name', '!=', migration_js_1.MIGRATION_TABLE)
-                .where('table_name', '!=', migration_js_1.MIGRATION_LOCK_TABLE);
+                .where('table_name', '!=', migrator_js_1.MIGRATION_TABLE)
+                .where('table_name', '!=', migrator_js_1.MIGRATION_LOCK_TABLE);
         }
         const rawColumns = await query.execute();
         return {

package/dist/cjs/dialect/postgres/postgres-adapter.d.ts

@@ -1,6 +1,6 @@
 import { Kysely } from '../../kysely.js';
-import { DialectAdapter } from '../dialect-adapter.js';
-export declare class PostgresAdapter implements DialectAdapter {
+import { DialectAdapterBase } from '../dialect-adapter-base.js';
+export declare class PostgresAdapter extends DialectAdapterBase {
     /**
      * Whether or not this dialect supports transactional DDL.
      *

package/dist/cjs/dialect/postgres/postgres-adapter.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PostgresAdapter = void 0;
+const dialect_adapter_base_js_1 = require("../dialect-adapter-base.js");
 // Random id for our transaction lock.
 const LOCK_ID = '3853314791062309107';
-class PostgresAdapter {
+class PostgresAdapter extends dialect_adapter_base_js_1.DialectAdapterBase {
     get supportsTransactionalDdl() {
         return true;
     }

package/dist/cjs/dialect/postgres/postgres-dialect.d.ts

@@ -5,7 +5,7 @@ import { Driver } from '../../driver/driver.js';
 import { Kysely } from '../../kysely.js';
 import { QueryCompiler } from '../../query-compiler/query-compiler.js';
 import { Dialect } from '../dialect.js';
-import { DatabaseIntrospector } from '../../introspection/database-introspector.js';
+import { DatabaseIntrospector } from '../database-introspector.js';
 import { DialectAdapter } from '../dialect-adapter.js';
 import { DatabaseConnection } from '../../driver/database-connection.js';
 /**

package/dist/cjs/dialect/postgres/postgres-introspector.d.ts

@@ -1,4 +1,4 @@
-import { DatabaseIntrospector, DatabaseMetadata, DatabaseMetadataOptions } from '../../introspection/database-introspector.js';
+import { DatabaseIntrospector, DatabaseMetadata, DatabaseMetadataOptions } from '../database-introspector.js';
 import { Kysely } from '../../kysely.js';
 export declare class PostgresIntrospector implements DatabaseIntrospector {
     #private;

package/dist/cjs/dialect/postgres/postgres-introspector.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PostgresIntrospector = void 0;
-const migration_js_1 = require("../../migration/migration.js");
+const migrator_js_1 = require("../../migration/migrator.js");
 const object_utils_js_1 = require("../../util/object-utils.js");
 class PostgresIntrospector {
     #db;
@@ -28,8 +28,8 @@ class PostgresIntrospector {
             .castTo();
         if (!options.withInternalKyselyTables) {
             query = query
-                .where('t.tablename', '!=', migration_js_1.MIGRATION_TABLE)
-                .where('t.tablename', '!=', migration_js_1.MIGRATION_LOCK_TABLE);
+                .where('t.tablename', '!=', migrator_js_1.MIGRATION_TABLE)
+                .where('t.tablename', '!=', migrator_js_1.MIGRATION_LOCK_TABLE);
         }
         const rawColumns = await query.execute();
         return {

package/dist/cjs/dialect/sqlite/sqlite-adapter.d.ts

@@ -1,5 +1,5 @@
-import { DialectAdapter } from '../dialect-adapter.js';
-export declare class SqliteAdapter implements DialectAdapter {
+import { DialectAdapterBase } from '../dialect-adapter-base.js';
+export declare class SqliteAdapter implements DialectAdapterBase {
     /**
      * Whether or not this dialect supports transactional DDL.
      *

package/dist/cjs/dialect/sqlite/sqlite-dialect.d.ts

@@ -2,7 +2,7 @@ import { Driver } from '../../driver/driver.js';
 import { Kysely } from '../../kysely.js';
 import { QueryCompiler } from '../../query-compiler/query-compiler.js';
 import { Dialect } from '../dialect.js';
-import { DatabaseIntrospector } from '../../introspection/database-introspector.js';
+import { DatabaseIntrospector } from '../database-introspector.js';
 import { DialectAdapter } from '../dialect-adapter.js';
 import { DatabaseConnection } from '../../driver/database-connection.js';
 /**

package/dist/cjs/dialect/sqlite/sqlite-introspector.d.ts

@@ -1,4 +1,4 @@
-import { DatabaseIntrospector, DatabaseMetadata, DatabaseMetadataOptions } from '../../introspection/database-introspector.js';
+import { DatabaseIntrospector, DatabaseMetadata, DatabaseMetadataOptions } from '../database-introspector.js';
 import { Kysely } from '../../kysely.js';
 export declare class SqliteIntrospector implements DatabaseIntrospector {
     #private;

package/dist/cjs/dialect/sqlite/sqlite-introspector.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SqliteIntrospector = void 0;
-const migration_js_1 = require("../../migration/migration.js");
+const migrator_js_1 = require("../../migration/migrator.js");
 class SqliteIntrospector {
     #db;
     constructor(db) {
@@ -16,8 +16,8 @@ class SqliteIntrospector {
             .castTo();
         if (!options.withInternalKyselyTables) {
             query = query
-                .where('name', '!=', migration_js_1.MIGRATION_TABLE)
-                .where('name', '!=', migration_js_1.MIGRATION_LOCK_TABLE);
+                .where('name', '!=', migrator_js_1.MIGRATION_TABLE)
+                .where('name', '!=', migrator_js_1.MIGRATION_LOCK_TABLE);
         }
         const tables = await query.execute();
         return {

package/dist/cjs/index.d.ts

@@ -15,6 +15,7 @@ export * from './query-builder/function-builder.js';
 export * from './query-builder/insert-result.js';
 export * from './query-builder/delete-result.js';
 export * from './query-builder/update-result.js';
+export * from './query-builder/on-conflict-builder.js';
 export * from './raw-builder/raw-builder.js';
 export * from './query-executor/query-executor.js';
 export * from './query-executor/default-query-executor.js';
@@ -56,7 +57,8 @@ export * from './dialect/sqlite/sqlite-introspector.js';
 export * from './dialect/sqlite/sqlite-adapter.js';
 export * from './query-compiler/default-query-compiler.js';
 export * from './query-compiler/query-compiler.js';
-export * from './migration/migration.js';
+export * from './migration/migrator.js';
+export * from './migration/file-migration-provider.js';
 export * from './dialect/dialect.js';
 export * from './dialect/dialect-adapter.js';
 export * from './dialect/dialect-adapter-base.js';
@@ -91,7 +93,7 @@ export * from './operation-node/drop-view-node.js';
 export * from './operation-node/filter-node.js';
 export * from './operation-node/foreign-key-constraint-node.js';
 export * from './operation-node/from-node.js';
-export * from './operation-node/generated-always-as-node.js';
+export * from './operation-node/generated-node.js';
 export * from './operation-node/group-by-item-node.js';
 export * from './operation-node/group-by-node.js';
 export * from './operation-node/having-node.js';
@@ -136,11 +138,12 @@ export * from './operation-node/value-node.js';
 export * from './operation-node/values-node.js';
 export * from './operation-node/where-node.js';
 export * from './operation-node/with-node.js';
-export * from './introspection/database-introspector.js';
+export * from './dialect/database-introspector.js';
+export * from './util/column-type.js';
 export * from './util/compilable.js';
 export * from './util/log.js';
 export { AnyColumn, UnknownRow, AnySelectQueryBuilder, } from './util/type-utils.js';
-export { SelectExpression, SelectExpressionOrList, } from './parser/select-parser.js';
+export { SelectExpression, SelectExpressionOrList, Selection, } from './parser/select-parser.js';
 export { ReferenceExpression, ReferenceExpressionOrList, } from './parser/reference-parser.js';
 export { ValueExpression, ValueExpressionOrList, } from './parser/value-parser.js';
 export { FilterValueExpression, FilterValueExpressionOrList, ExistsExpression, FilterOperator, } from './parser/filter-parser.js';

package/dist/cjs/index.js

@@ -27,6 +27,7 @@ __exportStar(require("./query-builder/function-builder.js"), exports);
 __exportStar(require("./query-builder/insert-result.js"), exports);
 __exportStar(require("./query-builder/delete-result.js"), exports);
 __exportStar(require("./query-builder/update-result.js"), exports);
+__exportStar(require("./query-builder/on-conflict-builder.js"), exports);
 __exportStar(require("./raw-builder/raw-builder.js"), exports);
 __exportStar(require("./query-executor/query-executor.js"), exports);
 __exportStar(require("./query-executor/default-query-executor.js"), exports);
@@ -68,7 +69,8 @@ __exportStar(require("./dialect/sqlite/sqlite-introspector.js"), exports);
 __exportStar(require("./dialect/sqlite/sqlite-adapter.js"), exports);
 __exportStar(require("./query-compiler/default-query-compiler.js"), exports);
 __exportStar(require("./query-compiler/query-compiler.js"), exports);
-__exportStar(require("./migration/migration.js"), exports);
+__exportStar(require("./migration/migrator.js"), exports);
+__exportStar(require("./migration/file-migration-provider.js"), exports);
 __exportStar(require("./dialect/dialect.js"), exports);
 __exportStar(require("./dialect/dialect-adapter.js"), exports);
 __exportStar(require("./dialect/dialect-adapter-base.js"), exports);
@@ -103,7 +105,7 @@ __exportStar(require("./operation-node/drop-view-node.js"), exports);
 __exportStar(require("./operation-node/filter-node.js"), exports);
 __exportStar(require("./operation-node/foreign-key-constraint-node.js"), exports);
 __exportStar(require("./operation-node/from-node.js"), exports);
-__exportStar(require("./operation-node/generated-always-as-node.js"), exports);
+__exportStar(require("./operation-node/generated-node.js"), exports);
 __exportStar(require("./operation-node/group-by-item-node.js"), exports);
 __exportStar(require("./operation-node/group-by-node.js"), exports);
 __exportStar(require("./operation-node/having-node.js"), exports);
@@ -148,6 +150,7 @@ __exportStar(require("./operation-node/value-node.js"), exports);
 __exportStar(require("./operation-node/values-node.js"), exports);
 __exportStar(require("./operation-node/where-node.js"), exports);
 __exportStar(require("./operation-node/with-node.js"), exports);
-__exportStar(require("./introspection/database-introspector.js"), exports);
+__exportStar(require("./dialect/database-introspector.js"), exports);
+__exportStar(require("./util/column-type.js"), exports);
 __exportStar(require("./util/compilable.js"), exports);
 __exportStar(require("./util/log.js"), exports);

package/dist/cjs/kysely.d.ts

@@ -1,16 +1,16 @@
 import { Dialect } from './dialect/dialect.js';
 import { SchemaModule } from './schema/schema.js';
 import { DynamicModule } from './dynamic/dynamic.js';
-import { MigrationModule } from './migration/migration.js';
 import { QueryExecutor } from './query-executor/query-executor.js';
 import { QueryCreator } from './query-creator.js';
 import { KyselyPlugin } from './plugin/kysely-plugin.js';
-import { GeneratedPlaceholder } from './util/type-utils.js';
-import { DatabaseIntrospector } from './introspection/database-introspector.js';
+import { DatabaseIntrospector } from './dialect/database-introspector.js';
 import { Driver, IsolationLevel } from './driver/driver.js';
 import { ParseContext } from './parser/parse-context.js';
 import { FunctionBuilder } from './query-builder/function-builder.js';
 import { LogConfig } from './util/log.js';
+import { PRIVATE_ADAPTER } from './util/private-symbols.js';
+import { DialectAdapter } from './dialect/dialect-adapter.js';
 /**
  * The main Kysely class.
  *
@@ -60,10 +60,6 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
      * Returns the {@link SchemaModule} module for building database schema.
      */
     get schema(): SchemaModule;
-    /**
-     * Returns the {@link MigrationModule} module for managing and running migrations.
-     */
-    get migration(): MigrationModule;
     /**
      * Returns a the {@link DynamicModule} module.
      *
@@ -75,31 +71,6 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
      * Returns a {@link DatabaseIntrospector | database introspector}.
      */
     get introspection(): DatabaseIntrospector;
-    /**
-     * A value to be used in place of columns that are generated in the database
-     * when inserting rows.
-     *
-     * ### Examples
-     *
-     * In this example the `Person` table has non-null properties `id` and `created_at`
-     * which are both automatically genereted by the database. Since their types are
-     * `number` and `string` respectively instead of `number | null` and `string | null`
-     * the `values` method requires you to give a value for them. the `generated`
-     * placeholder can be used in these cases.
-     *
-     * ```ts
-     * await db.insertInto('person')
-     *   .values({
-     *     id: db.generated,
-     *     created_at: db.generated,
-     *     first_name: 'Jennifer',
-     *     last_name: 'Aniston',
-     *     gender: 'female'
-     *   })
-     *   .execute()
-     * ```
-     */
-    get generated(): GeneratedPlaceholder;
     /**
      * Returns a {@link FunctionBuilder} that can be used to write type safe function
      * calls.
@@ -149,7 +120,6 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
      * const catto = await db.transaction().execute(async (trx) => {
      *   const jennifer = await trx.insertInto('person')
      *     .values({
-     *       id: db.generated,
      *       first_name: 'Jennifer',
      *       last_name: 'Aniston',
      *     })
@@ -160,7 +130,6 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
      *
      *   return await trx.insertInto('pet')
      *     .values({
-     *       id: db.generated,
      *       user_id: jennifer.id,
      *       name: 'Catto',
      *       species: 'cat'
@@ -251,6 +220,11 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
      * You can also use `db instanceof Transaction`.
      */
     get isTransaction(): boolean;
+    /**
+     * @internal
+     * @private
+     */
+    get [PRIVATE_ADAPTER](): DialectAdapter;
 }
 export declare class Transaction<DB> extends Kysely<DB> {
     #private;
@@ -261,10 +235,6 @@ export declare class Transaction<DB> extends Kysely<DB> {
      * You can also use `db instanceof Transaction`.
      */
     get isTransaction(): true;
-    /**
-     * Returns the {@link MigrationModule} module for managing and running migrations.
-     */
-    get migration(): MigrationModule;
     /**
      * Creates a {@link TransactionBuilder} that can be used to run queries inside a transaction.
      *
@@ -285,7 +255,6 @@ export declare class Transaction<DB> extends Kysely<DB> {
      * const catto = await db.transaction().execute(async (trx) => {
      *   const jennifer = await trx.insertInto('person')
      *     .values({
-     *       id: db.generated,
      *       first_name: 'Jennifer',
      *       last_name: 'Aniston',
      *     })
@@ -296,7 +265,6 @@ export declare class Transaction<DB> extends Kysely<DB> {
      *
      *   return await trx.insertInto('pet')
      *     .values({
-     *       id: db.generated,
      *       user_id: jennifer.id,
      *       name: 'Catto',
      *       species: 'cat'