kysely 0.28.17 → 0.29.0

package/dist/esm/query-creator.js

@@ -1,619 +0,0 @@
-/// <reference types="./query-creator.d.ts" />
-import { createSelectQueryBuilder, } from './query-builder/select-query-builder.js';
-import { InsertQueryBuilder } from './query-builder/insert-query-builder.js';
-import { DeleteQueryBuilder } from './query-builder/delete-query-builder.js';
-import { UpdateQueryBuilder } from './query-builder/update-query-builder.js';
-import { DeleteQueryNode } from './operation-node/delete-query-node.js';
-import { InsertQueryNode } from './operation-node/insert-query-node.js';
-import { SelectQueryNode } from './operation-node/select-query-node.js';
-import { UpdateQueryNode } from './operation-node/update-query-node.js';
-import { parseTable, parseTableExpressionOrList, parseAliasedTable, } from './parser/table-parser.js';
-import { parseCommonTableExpression, } from './parser/with-parser.js';
-import { WithNode } from './operation-node/with-node.js';
-import { createQueryId } from './util/query-id.js';
-import { WithSchemaPlugin } from './plugin/with-schema/with-schema-plugin.js';
-import { freeze } from './util/object-utils.js';
-import { parseSelectArg, } from './parser/select-parser.js';
-import { MergeQueryBuilder } from './query-builder/merge-query-builder.js';
-import { MergeQueryNode } from './operation-node/merge-query-node.js';
-export class QueryCreator {
-    #props;
-    constructor(props) {
-        this.#props = freeze(props);
-    }
-    /**
-     * Creates a `select` query builder for the given table or tables.
-     *
-     * The tables passed to this method are built as the query's `from` clause.
-     *
-     * ### Examples
-     *
-     * Create a select query for one table:
-     *
-     * ```ts
-     * db.selectFrom('person').selectAll()
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * select * from "person"
-     * ```
-     *
-     * Create a select query for one table with an alias:
-     *
-     * ```ts
-     * const persons = await db.selectFrom('person as p')
-     *   .select(['p.id', 'first_name'])
-     *   .execute()
-     *
-     * console.log(persons[0].id)
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * select "p"."id", "first_name" from "person" as "p"
-     * ```
-     *
-     * Create a select query from a subquery:
-     *
-     * ```ts
-     * const persons = await db.selectFrom(
-     *     (eb) => eb.selectFrom('person').select('person.id as identifier').as('p')
-     *   )
-     *   .select('p.identifier')
-     *   .execute()
-     *
-     * console.log(persons[0].identifier)
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * select "p"."identifier",
-     * from (
-     *   select "person"."id" as "identifier" from "person"
-     * ) as p
-     * ```
-     *
-     * Create a select query from raw sql:
-     *
-     * ```ts
-     * import { sql } from 'kysely'
-     *
-     * const items = await db
-     *   .selectFrom(sql<{ one: number }>`(select 1 as one)`.as('q'))
-     *   .select('q.one')
-     *   .execute()
-     *
-     * console.log(items[0].one)
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * select "q"."one",
-     * from (
-     *   select 1 as one
-     * ) as q
-     * ```
-     *
-     * When you use the `sql` tag you need to also provide the result type of the
-     * raw snippet / query so that Kysely can figure out what columns are
-     * available for the rest of the query.
-     *
-     * The `selectFrom` method also accepts an array for multiple tables. All
-     * the above examples can also be used in an array.
-     *
-     * ```ts
-     * import { sql } from 'kysely'
-     *
-     * const items = await db.selectFrom([
-     *     'person as p',
-     *     db.selectFrom('pet').select('pet.species').as('a'),
-     *     sql<{ one: number }>`(select 1 as one)`.as('q')
-     *   ])
-     *   .select(['p.id', 'a.species', 'q.one'])
-     *   .execute()
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * select "p".id, "a"."species", "q"."one"
-     * from
-     *   "person" as "p",
-     *   (select "pet"."species" from "pet") as a,
-     *   (select 1 as one) as "q"
-     * ```
-     */
-    selectFrom(from) {
-        return createSelectQueryBuilder({
-            queryId: createQueryId(),
-            executor: this.#props.executor,
-            queryNode: SelectQueryNode.createFrom(parseTableExpressionOrList(from), this.#props.withNode),
-        });
-    }
-    selectNoFrom(selection) {
-        return createSelectQueryBuilder({
-            queryId: createQueryId(),
-            executor: this.#props.executor,
-            queryNode: SelectQueryNode.cloneWithSelections(SelectQueryNode.create(this.#props.withNode), parseSelectArg(selection)),
-        });
-    }
-    /**
-     * Creates an insert query.
-     *
-     * The return value of this query is an instance of {@link InsertResult}. {@link InsertResult}
-     * has the {@link InsertResult.insertId | insertId} field that holds the auto incremented id of
-     * the inserted row if the db returned one.
-     *
-     * See the {@link InsertQueryBuilder.values | values} method for more info and examples. Also see
-     * the {@link ReturningInterface.returning | returning} method for a way to return columns
-     * on supported databases like PostgreSQL.
-     *
-     * ### Examples
-     *
-     * ```ts
-     * const result = await db
-     *   .insertInto('person')
-     *   .values({
-     *     first_name: 'Jennifer',
-     *     last_name: 'Aniston'
-     *   })
-     *   .executeTakeFirst()
-     *
-     * console.log(result.insertId)
-     * ```
-     *
-     * Some databases like PostgreSQL support the `returning` method:
-     *
-     * ```ts
-     * const { id } = await db
-     *   .insertInto('person')
-     *   .values({
-     *     first_name: 'Jennifer',
-     *     last_name: 'Aniston'
-     *   })
-     *   .returning('id')
-     *   .executeTakeFirstOrThrow()
-     * ```
-     */
-    insertInto(table) {
-        return new InsertQueryBuilder({
-            queryId: createQueryId(),
-            executor: this.#props.executor,
-            queryNode: InsertQueryNode.create(parseTable(table), this.#props.withNode),
-        });
-    }
-    /**
-     * Creates a "replace into" query.
-     *
-     * This is only supported by some dialects like MySQL or SQLite.
-     *
-     * Similar to MySQL's {@link InsertQueryBuilder.onDuplicateKeyUpdate} that deletes
-     * and inserts values on collision instead of updating existing rows.
-     *
-     * An alias of SQLite's {@link InsertQueryBuilder.orReplace}.
-     *
-     * The return value of this query is an instance of {@link InsertResult}. {@link InsertResult}
-     * has the {@link InsertResult.insertId | insertId} field that holds the auto incremented id of
-     * the inserted row if the db returned one.
-     *
-     * See the {@link InsertQueryBuilder.values | values} method for more info and examples.
-     *
-     * ### Examples
-     *
-     * ```ts
-     * const result = await db
-     *   .replaceInto('person')
-     *   .values({
-     *     first_name: 'Jennifer',
-     *     last_name: 'Aniston'
-     *   })
-     *   .executeTakeFirstOrThrow()
-     *
-     * console.log(result.insertId)
-     * ```
-     *
-     * The generated SQL (MySQL):
-     *
-     * ```sql
-     * replace into `person` (`first_name`, `last_name`) values (?, ?)
-     * ```
-     */
-    replaceInto(table) {
-        return new InsertQueryBuilder({
-            queryId: createQueryId(),
-            executor: this.#props.executor,
-            queryNode: InsertQueryNode.create(parseTable(table), this.#props.withNode, true),
-        });
-    }
-    /**
-     * Creates a delete query.
-     *
-     * See the {@link DeleteQueryBuilder.where} method for examples on how to specify
-     * a where clause for the delete operation.
-     *
-     * The return value of the query is an instance of {@link DeleteResult}.
-     *
-     * ### Examples
-     *
-     * <!-- siteExample("delete", "Single row", 10) -->
-     *
-     * Delete a single row:
-     *
-     * ```ts
-     * const result = await db
-     *   .deleteFrom('person')
-     *   .where('person.id', '=', 1)
-     *   .executeTakeFirst()
-     *
-     * console.log(result.numDeletedRows)
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * delete from "person" where "person"."id" = $1
-     * ```
-     *
-     * Some databases such as MySQL support deleting from multiple tables:
-     *
-     * ```ts
-     * const result = await db
-     *   .deleteFrom(['person', 'pet'])
-     *   .using('person')
-     *   .innerJoin('pet', 'pet.owner_id', 'person.id')
-     *   .where('person.id', '=', 1)
-     *   .executeTakeFirst()
-     * ```
-     *
-     * The generated SQL (MySQL):
-     *
-     * ```sql
-     * delete from `person`, `pet`
-     * using `person`
-     * inner join `pet` on `pet`.`owner_id` = `person`.`id`
-     * where `person`.`id` = ?
-     * ```
-     */
-    deleteFrom(from) {
-        return new DeleteQueryBuilder({
-            queryId: createQueryId(),
-            executor: this.#props.executor,
-            queryNode: DeleteQueryNode.create(parseTableExpressionOrList(from), this.#props.withNode),
-        });
-    }
-    /**
-     * Creates an update query.
-     *
-     * See the {@link UpdateQueryBuilder.where} method for examples on how to specify
-     * a where clause for the update operation.
-     *
-     * See the {@link UpdateQueryBuilder.set} method for examples on how to
-     * specify the updates.
-     *
-     * The return value of the query is an {@link UpdateResult}.
-     *
-     * ### Examples
-     *
-     * ```ts
-     * const result = await db
-     *   .updateTable('person')
-     *   .set({ first_name: 'Jennifer' })
-     *   .where('person.id', '=', 1)
-     *   .executeTakeFirst()
-     *
-     * console.log(result.numUpdatedRows)
-     * ```
-     */
-    updateTable(tables) {
-        return new UpdateQueryBuilder({
-            queryId: createQueryId(),
-            executor: this.#props.executor,
-            queryNode: UpdateQueryNode.create(parseTableExpressionOrList(tables), this.#props.withNode),
-        });
-    }
-    /**
-     * Creates a merge query.
-     *
-     * The return value of the query is a {@link MergeResult}.
-     *
-     * See the {@link MergeQueryBuilder.using} method for examples on how to specify
-     * the other table.
-     *
-     * ### Examples
-     *
-     * <!-- siteExample("merge", "Source row existence", 10) -->
-     *
-     * Update a target column based on the existence of a source row:
-     *
-     * ```ts
-     * const result = await db
-     *   .mergeInto('person as target')
-     *   .using('pet as source', 'source.owner_id', 'target.id')
-     *   .whenMatchedAnd('target.has_pets', '!=', 'Y')
-     *   .thenUpdateSet({ has_pets: 'Y' })
-     *   .whenNotMatchedBySourceAnd('target.has_pets', '=', 'Y')
-     *   .thenUpdateSet({ has_pets: 'N' })
-     *   .executeTakeFirstOrThrow()
-     *
-     * console.log(result.numChangedRows)
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * merge into "person"
-     * using "pet"
-     * on "pet"."owner_id" = "person"."id"
-     * when matched and "has_pets" != $1
-     * then update set "has_pets" = $2
-     * when not matched by source and "has_pets" = $3
-     * then update set "has_pets" = $4
-     * ```
-     *
-     * <!-- siteExample("merge", "Temporary changes table", 20) -->
-     *
-     * Merge new entries from a temporary changes table:
-     *
-     * ```ts
-     * const result = await db
-     *   .mergeInto('wine as target')
-     *   .using(
-     *     'wine_stock_change as source',
-     *     'source.wine_name',
-     *     'target.name',
-     *   )
-     *   .whenNotMatchedAnd('source.stock_delta', '>', 0)
-     *   .thenInsertValues(({ ref }) => ({
-     *     name: ref('source.wine_name'),
-     *     stock: ref('source.stock_delta'),
-     *   }))
-     *   .whenMatchedAnd(
-     *     (eb) => eb('target.stock', '+', eb.ref('source.stock_delta')),
-     *     '>',
-     *     0,
-     *   )
-     *   .thenUpdateSet('stock', (eb) =>
-     *     eb('target.stock', '+', eb.ref('source.stock_delta')),
-     *   )
-     *   .whenMatched()
-     *   .thenDelete()
-     *   .executeTakeFirstOrThrow()
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * merge into "wine" as "target"
-     * using "wine_stock_change" as "source"
-     * on "source"."wine_name" = "target"."name"
-     * when not matched and "source"."stock_delta" > $1
-     * then insert ("name", "stock") values ("source"."wine_name", "source"."stock_delta")
-     * when matched and "target"."stock" + "source"."stock_delta" > $2
-     * then update set "stock" = "target"."stock" + "source"."stock_delta"
-     * when matched
-     * then delete
-     * ```
-     */
-    mergeInto(targetTable) {
-        return new MergeQueryBuilder({
-            queryId: createQueryId(),
-            executor: this.#props.executor,
-            queryNode: MergeQueryNode.create(parseAliasedTable(targetTable), this.#props.withNode),
-        });
-    }
-    /**
-     * Creates a `with` query (Common Table Expression).
-     *
-     * ### Examples
-     *
-     * <!-- siteExample("cte", "Simple selects", 10) -->
-     *
-     * Common table expressions (CTE) are a great way to modularize complex queries.
-     * Essentially they allow you to run multiple separate queries within a
-     * single roundtrip to the DB.
-     *
-     * Since CTEs are a part of the main query, query optimizers inside DB
-     * engines are able to optimize the overall query. For example, postgres
-     * is able to inline the CTEs inside the using queries if it decides it's
-     * faster.
-     *
-     * ```ts
-     * const result = await db
-     *   // Create a CTE called `jennifers` that selects all
-     *   // persons named 'Jennifer'.
-     *   .with('jennifers', (db) => db
-     *     .selectFrom('person')
-     *     .where('first_name', '=', 'Jennifer')
-     *     .select(['id', 'age'])
-     *   )
-     *   // Select all rows from the `jennifers` CTE and
-     *   // further filter it.
-     *   .with('adult_jennifers', (db) => db
-     *     .selectFrom('jennifers')
-     *     .where('age', '>', 18)
-     *     .select(['id', 'age'])
-     *   )
-     *   // Finally select all adult jennifers that are
-     *   // also younger than 60.
-     *   .selectFrom('adult_jennifers')
-     *   .where('age', '<', 60)
-     *   .selectAll()
-     *   .execute()
-     * ```
-     *
-     * <!-- siteExample("cte", "Inserts, updates and deletions", 20) -->
-     *
-     * Some databases like postgres also allow you to run other queries than selects
-     * in CTEs. On these databases CTEs are extremely powerful:
-     *
-     * ```ts
-     * const result = await db
-     *   .with('new_person', (db) => db
-     *     .insertInto('person')
-     *     .values({
-     *       first_name: 'Jennifer',
-     *       age: 35,
-     *     })
-     *     .returning('id')
-     *   )
-     *   .with('new_pet', (db) => db
-     *     .insertInto('pet')
-     *     .values({
-     *       name: 'Doggo',
-     *       species: 'dog',
-     *       is_favorite: true,
-     *       // Use the id of the person we just inserted.
-     *       owner_id: db
-     *         .selectFrom('new_person')
-     *         .select('id')
-     *     })
-     *     .returning('id')
-     *   )
-     *   .selectFrom(['new_person', 'new_pet'])
-     *   .select([
-     *     'new_person.id as person_id',
-     *     'new_pet.id as pet_id'
-     *   ])
-     *   .execute()
-     * ```
-     *
-     * The CTE name can optionally specify column names in addition to
-     * a name. In that case Kysely requires the expression to retun
-     * rows with the same columns.
-     *
-     * ```ts
-     * await db
-     *   .with('jennifers(id, age)', (db) => db
-     *     .selectFrom('person')
-     *     .where('first_name', '=', 'Jennifer')
-     *     // This is ok since we return columns with the same
-     *     // names as specified by `jennifers(id, age)`.
-     *     .select(['id', 'age'])
-     *   )
-     *   .selectFrom('jennifers')
-     *   .selectAll()
-     *   .execute()
-     * ```
-     *
-     * The first argument can also be a callback. The callback is passed
-     * a `CTEBuilder` instance that can be used to configure the CTE:
-     *
-     * ```ts
-     * await db
-     *   .with(
-     *     (cte) => cte('jennifers').materialized(),
-     *     (db) => db
-     *       .selectFrom('person')
-     *       .where('first_name', '=', 'Jennifer')
-     *       .select(['id', 'age'])
-     *   )
-     *   .selectFrom('jennifers')
-     *   .selectAll()
-     *   .execute()
-     * ```
-     */
-    with(nameOrBuilder, expression) {
-        const cte = parseCommonTableExpression(nameOrBuilder, expression);
-        return new QueryCreator({
-            ...this.#props,
-            withNode: this.#props.withNode
-                ? WithNode.cloneWithExpression(this.#props.withNode, cte)
-                : WithNode.create(cte),
-        });
-    }
-    /**
-     * Creates a recursive `with` query (Common Table Expression).
-     *
-     * Note that recursiveness is a property of the whole `with` statement.
-     * You cannot have recursive and non-recursive CTEs in a same `with` statement.
-     * Therefore the recursiveness is determined by the **first** `with` or
-     * `withRecusive` call you make.
-     *
-     * See the {@link with} method for examples and more documentation.
-     */
-    withRecursive(nameOrBuilder, expression) {
-        const cte = parseCommonTableExpression(nameOrBuilder, expression);
-        return new QueryCreator({
-            ...this.#props,
-            withNode: this.#props.withNode
-                ? WithNode.cloneWithExpression(this.#props.withNode, cte)
-                : WithNode.create(cte, { recursive: true }),
-        });
-    }
-    /**
-     * Returns a copy of this query creator instance with the given plugin installed.
-     */
-    withPlugin(plugin) {
-        return new QueryCreator({
-            ...this.#props,
-            executor: this.#props.executor.withPlugin(plugin),
-        });
-    }
-    /**
-     * Returns a copy of this query creator instance without any plugins.
-     */
-    withoutPlugins() {
-        return new QueryCreator({
-            ...this.#props,
-            executor: this.#props.executor.withoutPlugins(),
-        });
-    }
-    /**
-     * Sets the schema to be used for all table references that don't explicitly
-     * specify a schema.
-     *
-     * This only affects the query created through the builder returned from
-     * this method and doesn't modify the `db` instance.
-     *
-     * See [this recipe](https://github.com/kysely-org/kysely/blob/master/site/docs/recipes/0007-schemas.md)
-     * for a more detailed explanation.
-     *
-     * ### Examples
-     *
-     * ```
-     * await db
-     *   .withSchema('mammals')
-     *   .selectFrom('pet')
-     *   .selectAll()
-     *   .innerJoin('public.person', 'public.person.id', 'pet.owner_id')
-     *   .execute()
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * select * from "mammals"."pet"
-     * inner join "public"."person"
-     * on "public"."person"."id" = "mammals"."pet"."owner_id"
-     * ```
-     *
-     * `withSchema` is smart enough to not add schema for aliases,
-     * common table expressions or other places where the schema
-     * doesn't belong to:
-     *
-     * ```
-     * await db
-     *   .withSchema('mammals')
-     *   .selectFrom('pet as p')
-     *   .select('p.name')
-     *   .execute()
-     * ```
-     *
-     * The generated SQL (PostgreSQL):
-     *
-     * ```sql
-     * select "p"."name" from "mammals"."pet" as "p"
-     * ```
-     */
-    withSchema(schema) {
-        return new QueryCreator({
-            ...this.#props,
-            executor: this.#props.executor.withPluginAtFront(new WithSchemaPlugin(schema)),
-        });
-    }
-}

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

@@ -1,50 +0,0 @@
-import type { ConnectionProvider } from '../driver/connection-provider.js';
-import type { DatabaseConnection } from '../driver/database-connection.js';
-import type { CompiledQuery } from '../query-compiler/compiled-query.js';
-import type { RootOperationNode, QueryCompiler } from '../query-compiler/query-compiler.js';
-import type { KyselyPlugin } from '../plugin/kysely-plugin.js';
-import { QueryExecutorBase } from './query-executor-base.js';
-import type { DialectAdapter } from '../dialect/dialect-adapter.js';
-import type { QueryId } from '../util/query-id.js';
-export declare class DefaultQueryExecutor extends QueryExecutorBase {
-    #private;
-    constructor(compiler: QueryCompiler, adapter: DialectAdapter, connectionProvider: ConnectionProvider, plugins?: KyselyPlugin[]);
-    /**
-     * Returns the adapter for the current dialect.
-     */
-    get adapter(): DialectAdapter;
-    /**
-     * Compiles the transformed query into SQL. You usually want to pass
-     * the output of {@link transformQuery} into this method but you can
-     * compile any query using this method.
-     */
-    compileQuery(node: RootOperationNode, queryId: QueryId): CompiledQuery;
-    /**
-     * Provides a connection for the callback and takes care of disposing
-     * the connection after the callback has been run.
-     */
-    provideConnection<T>(consumer: (connection: DatabaseConnection) => Promise<T>): Promise<T>;
-    /**
-     * Returns a copy of this executor with a list of plugins added
-     * as the last plugins.
-     */
-    withPlugins(plugins: ReadonlyArray<KyselyPlugin>): DefaultQueryExecutor;
-    /**
-     * Returns a copy of this executor with a plugin added as the
-     * last plugin.
-     */
-    withPlugin(plugin: KyselyPlugin): DefaultQueryExecutor;
-    /**
-     * Returns a copy of this executor with a plugin added as the
-     * first plugin.
-     */
-    withPluginAtFront(plugin: KyselyPlugin): DefaultQueryExecutor;
-    /**
-     * Returns a copy of this executor with a new connection provider.
-     */
-    withConnectionProvider(connectionProvider: ConnectionProvider): DefaultQueryExecutor;
-    /**
-     * Returns a copy of this executor without any plugins.
-     */
-    withoutPlugins(): DefaultQueryExecutor;
-}

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

@@ -1,37 +0,0 @@
-/// <reference types="./default-query-executor.d.ts" />
-import { QueryExecutorBase } from './query-executor-base.js';
-export class DefaultQueryExecutor extends QueryExecutorBase {
-    #compiler;
-    #adapter;
-    #connectionProvider;
-    constructor(compiler, adapter, connectionProvider, plugins = []) {
-        super(plugins);
-        this.#compiler = compiler;
-        this.#adapter = adapter;
-        this.#connectionProvider = connectionProvider;
-    }
-    get adapter() {
-        return this.#adapter;
-    }
-    compileQuery(node, queryId) {
-        return this.#compiler.compileQuery(node, queryId);
-    }
-    provideConnection(consumer) {
-        return this.#connectionProvider.provideConnection(consumer);
-    }
-    withPlugins(plugins) {
-        return new DefaultQueryExecutor(this.#compiler, this.#adapter, this.#connectionProvider, [...this.plugins, ...plugins]);
-    }
-    withPlugin(plugin) {
-        return new DefaultQueryExecutor(this.#compiler, this.#adapter, this.#connectionProvider, [...this.plugins, plugin]);
-    }
-    withPluginAtFront(plugin) {
-        return new DefaultQueryExecutor(this.#compiler, this.#adapter, this.#connectionProvider, [plugin, ...this.plugins]);
-    }
-    withConnectionProvider(connectionProvider) {
-        return new DefaultQueryExecutor(this.#compiler, this.#adapter, connectionProvider, [...this.plugins]);
-    }
-    withoutPlugins() {
-        return new DefaultQueryExecutor(this.#compiler, this.#adapter, this.#connectionProvider, []);
-    }
-}