drizzle-orm 0.42.0-da9af74 → 0.43.0-62ea5c4

package/mysql-core/query-builders/select.d.ts

@@ -1,4 +1,3 @@
-import type { CacheConfig, WithCacheConfig } from "../../cache/core/types.js";
 import { entityKind } from "../../entity.js";
 import type { MySqlColumn } from "../columns/index.js";
 import type { MySqlDialect } from "../dialect.js";
@@ -14,7 +13,7 @@ import { Subquery } from "../../subquery.js";
 import type { ValueOrArray } from "../../utils.js";
 import type { IndexBuilder } from "../indexes.js";
 import { MySqlViewBase } from "../view-base.js";
-import type { CreateMySqlSelectFromBuilderMode, GetMySqlSetOperators, LockConfig, LockStrength, MySqlCreateSetOperatorFn, MySqlJoinFn, MySqlSelectConfig, MySqlSelectDynamic, MySqlSelectHKT, MySqlSelectHKTBase, MySqlSelectPrepare, MySqlSelectWithout, MySqlSetOperatorExcludedMethods, MySqlSetOperatorWithResult, SelectedFields, SetOperatorRightSelect } from "./select.types.js";
+import type { CreateMySqlSelectFromBuilderMode, GetMySqlSetOperators, LockConfig, LockStrength, MySqlCreateSetOperatorFn, MySqlSelectConfig, MySqlSelectDynamic, MySqlSelectHKT, MySqlSelectHKTBase, MySqlSelectPrepare, MySqlSelectWithout, MySqlSetOperatorExcludedMethods, MySqlSetOperatorWithResult, SelectedFields, SetOperatorRightSelect } from "./select.types.js";
 export type IndexForHint = IndexBuilder | string;
 export type IndexConfig = {
     useIndex?: IndexForHint | IndexForHint[];
@@ -50,15 +49,12 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
         readonly excludedMethods: TExcludedMethods;
         readonly result: TResult;
         readonly selectedFields: TSelectedFields;
-        readonly config: MySqlSelectConfig;
     };
     protected config: MySqlSelectConfig;
     protected joinsNotNullableMap: Record<string, boolean>;
     private tableName;
     private isPartialSelect;
     protected dialect: MySqlDialect;
-    protected cacheConfig?: WithCacheConfig;
-    protected usedTables: Set<string>;
     constructor({ table, fields, isPartialSelect, session, dialect, withList, distinct, useIndex, forceIndex, ignoreIndex }: {
         table: MySqlSelectConfig['table'];
         fields: MySqlSelectConfig['fields'];
@@ -81,17 +77,18 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
      *
      * @param table the table to join.
      * @param on the `on` clause.
+     * @param onIndex index hint.
      *
      * @example
      *
      * ```ts
      * // Select all users and their pets
-     * const usersWithPets: { user: User; pets: Pet | null }[] = await db.select()
+     * const usersWithPets: { user: User; pets: Pet | null; }[] = await db.select()
      *   .from(users)
      *   .leftJoin(pets, eq(users.id, pets.ownerId))
      *
      * // Select userId and petId
-     * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+     * const usersIdsAndPetIds: { userId: number; petId: number | null; }[] = await db.select({
      *   userId: users.id,
      *   petId: pets.id,
      * })
@@ -99,7 +96,7 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
      *   .leftJoin(pets, eq(users.id, pets.ownerId))
      *
      * // Select userId and petId with use index hint
-     * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+     * const usersIdsAndPetIds: { userId: number; petId: number | null; }[] = await db.select({
      *   userId: users.id,
      *   petId: pets.id,
      * })
@@ -109,7 +106,20 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
      * })
      * ```
      */
-    leftJoin: MySqlJoinFn<this, TDynamic, "left">;
+    leftJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | MySqlTable<import("../table.js").TableConfig> | MySqlViewBase<string, boolean, ColumnsSelection>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined, onIndex?: (TJoinedTable extends MySqlTable<import("../table.js").TableConfig> ? IndexConfig : "Index hint configuration is allowed only for MySqlTable and not for subqueries or views") | undefined) => import("./select.types.js").MySqlJoin<this, TDynamic, "left", TJoinedTable, TJoinedName>;
+    /**
+     * Executes a `left join lateral` operation by adding subquery to the current query.
+     *
+     * A `lateral` join allows the right-hand expression to refer to columns from the left-hand side.
+     *
+     * Calling this method associates each row of the table with the corresponding row from the joined table, if a match is found. If no matching row exists, it sets all columns of the joined table to null.
+     *
+     * See docs: {@link https://orm.drizzle.team/docs/joins#left-join-lateral}
+     *
+     * @param table the subquery to join.
+     * @param on the `on` clause.
+     */
+    leftJoinLateral: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined, onIndex?: (TJoinedTable extends MySqlTable<import("../table.js").TableConfig> ? IndexConfig : "Index hint configuration is allowed only for MySqlTable and not for subqueries or views") | undefined) => import("./select.types.js").MySqlJoin<this, TDynamic, "left", TJoinedTable, TJoinedName>;
     /**
      * Executes a `right join` operation by adding another table to the current query.
      *
@@ -119,17 +129,18 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
      *
      * @param table the table to join.
      * @param on the `on` clause.
+     * @param onIndex index hint.
      *
      * @example
      *
      * ```ts
      * // Select all users and their pets
-     * const usersWithPets: { user: User | null; pets: Pet }[] = await db.select()
+     * const usersWithPets: { user: User | null; pets: Pet; }[] = await db.select()
      *   .from(users)
      *   .rightJoin(pets, eq(users.id, pets.ownerId))
      *
      * // Select userId and petId
-     * const usersIdsAndPetIds: { userId: number | null; petId: number }[] = await db.select({
+     * const usersIdsAndPetIds: { userId: number | null; petId: number; }[] = await db.select({
      *   userId: users.id,
      *   petId: pets.id,
      * })
@@ -137,7 +148,7 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
      *   .rightJoin(pets, eq(users.id, pets.ownerId))
      *
      * // Select userId and petId with use index hint
-     * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+     * const usersIdsAndPetIds: { userId: number; petId: number | null; }[] = await db.select({
      *   userId: users.id,
      *   petId: pets.id,
      * })
@@ -147,7 +158,7 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
      * })
      * ```
      */
-    rightJoin: MySqlJoinFn<this, TDynamic, "right">;
+    rightJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | MySqlTable<import("../table.js").TableConfig> | MySqlViewBase<string, boolean, ColumnsSelection>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined, onIndex?: (TJoinedTable extends MySqlTable<import("../table.js").TableConfig> ? IndexConfig : "Index hint configuration is allowed only for MySqlTable and not for subqueries or views") | undefined) => import("./select.types.js").MySqlJoin<this, TDynamic, "right", TJoinedTable, TJoinedName>;
     /**
      * Executes an `inner join` operation, creating a new table by combining rows from two tables that have matching values.
      *
@@ -157,17 +168,18 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
      *
      * @param table the table to join.
      * @param on the `on` clause.
+     * @param onIndex index hint.
      *
      * @example
      *
      * ```ts
      * // Select all users and their pets
-     * const usersWithPets: { user: User; pets: Pet }[] = await db.select()
+     * const usersWithPets: { user: User; pets: Pet; }[] = await db.select()
      *   .from(users)
      *   .innerJoin(pets, eq(users.id, pets.ownerId))
      *
      * // Select userId and petId
-     * const usersIdsAndPetIds: { userId: number; petId: number }[] = await db.select({
+     * const usersIdsAndPetIds: { userId: number; petId: number; }[] = await db.select({
      *   userId: users.id,
      *   petId: pets.id,
      * })
@@ -175,7 +187,7 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
      *   .innerJoin(pets, eq(users.id, pets.ownerId))
      *
      * // Select userId and petId with use index hint
-     * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+     * const usersIdsAndPetIds: { userId: number; petId: number | null; }[] = await db.select({
      *   userId: users.id,
      *   petId: pets.id,
      * })
@@ -185,45 +197,70 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
      * })
      * ```
      */
-    innerJoin: MySqlJoinFn<this, TDynamic, "inner">;
+    innerJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | MySqlTable<import("../table.js").TableConfig> | MySqlViewBase<string, boolean, ColumnsSelection>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined, onIndex?: (TJoinedTable extends MySqlTable<import("../table.js").TableConfig> ? IndexConfig : "Index hint configuration is allowed only for MySqlTable and not for subqueries or views") | undefined) => import("./select.types.js").MySqlJoin<this, TDynamic, "inner", TJoinedTable, TJoinedName>;
     /**
-     * Executes a `full join` operation by combining rows from two tables into a new table.
+     * Executes an `inner join lateral` operation, creating a new table by combining rows from two queries that have matching values.
      *
-     * Calling this method retrieves all rows from both main and joined tables, merging rows with matching values and filling in `null` for non-matching columns.
+     * A `lateral` join allows the right-hand expression to refer to columns from the left-hand side.
      *
-     * See docs: {@link https://orm.drizzle.team/docs/joins#full-join}
+     * Calling this method retrieves rows that have corresponding entries in both joined tables. Rows without matching entries in either table are excluded, resulting in a table that includes only matching pairs.
      *
-     * @param table the table to join.
+     * See docs: {@link https://orm.drizzle.team/docs/joins#inner-join-lateral}
+     *
+     * @param table the subquery to join.
      * @param on the `on` clause.
+     */
+    innerJoinLateral: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined, onIndex?: (TJoinedTable extends MySqlTable<import("../table.js").TableConfig> ? IndexConfig : "Index hint configuration is allowed only for MySqlTable and not for subqueries or views") | undefined) => import("./select.types.js").MySqlJoin<this, TDynamic, "inner", TJoinedTable, TJoinedName>;
+    /**
+     * Executes a `cross join` operation by combining rows from two tables into a new table.
+     *
+     * Calling this method retrieves all rows from both main and joined tables, merging all rows from each table.
+     *
+     * See docs: {@link https://orm.drizzle.team/docs/joins#cross-join}
+     *
+     * @param table the table to join.
+     * @param onIndex index hint.
      *
      * @example
      *
      * ```ts
-     * // Select all users and their pets
-     * const usersWithPets: { user: User | null; pets: Pet | null }[] = await db.select()
+     * // Select all users, each user with every pet
+     * const usersWithPets: { user: User; pets: Pet; }[] = await db.select()
      *   .from(users)
-     *   .fullJoin(pets, eq(users.id, pets.ownerId))
+     *   .crossJoin(pets)
      *
      * // Select userId and petId
-     * const usersIdsAndPetIds: { userId: number | null; petId: number | null }[] = await db.select({
+     * const usersIdsAndPetIds: { userId: number; petId: number; }[] = await db.select({
      *   userId: users.id,
      *   petId: pets.id,
      * })
      *   .from(users)
-     *   .fullJoin(pets, eq(users.id, pets.ownerId))
+     *   .crossJoin(pets)
      *
      * // Select userId and petId with use index hint
-     * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+     * const usersIdsAndPetIds: { userId: number; petId: number; }[] = await db.select({
      *   userId: users.id,
      *   petId: pets.id,
      * })
      *   .from(users)
-     *   .leftJoin(pets, eq(users.id, pets.ownerId), {
+     *   .crossJoin(pets, {
      *     useIndex: ['pets_owner_id_index']
      * })
      * ```
      */
-    fullJoin: MySqlJoinFn<this, TDynamic, "full">;
+    crossJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | MySqlTable<import("../table.js").TableConfig> | MySqlViewBase<string, boolean, ColumnsSelection>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, onIndex?: (TJoinedTable extends MySqlTable<import("../table.js").TableConfig> ? IndexConfig : "Index hint configuration is allowed only for MySqlTable and not for subqueries or views") | undefined) => import("./select.types.js").MySqlJoin<this, TDynamic, "cross", TJoinedTable, TJoinedName>;
+    /**
+     * Executes a `cross join lateral` operation by combining rows from two queries into a new table.
+     *
+     * A `lateral` join allows the right-hand expression to refer to columns from the left-hand side.
+     *
+     * Calling this method retrieves all rows from both main and joined queries, merging all rows from each query.
+     *
+     * See docs: {@link https://orm.drizzle.team/docs/joins#cross-join-lateral}
+     *
+     * @param table the query to join.
+     */
+    crossJoinLateral: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, onIndex?: (TJoinedTable extends MySqlTable<import("../table.js").TableConfig> ? IndexConfig : "Index hint configuration is allowed only for MySqlTable and not for subqueries or views") | undefined) => import("./select.types.js").MySqlJoin<this, TDynamic, "cross", TJoinedTable, TJoinedName>;
     private createSetOperator;
     /**
      * Adds `union` set operator to the query.
@@ -559,11 +596,6 @@ export declare abstract class MySqlSelectQueryBuilderBase<THKT extends MySqlSele
     toSQL(): Query;
     as<TAlias extends string>(alias: TAlias): SubqueryWithSelection<this['_']['selectedFields'], TAlias>;
     $dynamic(): MySqlSelectDynamic<this>;
-    $withCache(config?: {
-        config?: CacheConfig;
-        tag?: string;
-        autoInvalidate?: boolean;
-    } | false): this;
 }
 export interface MySqlSelectBase<TTableName extends string | undefined, TSelection extends ColumnsSelection, TSelectMode extends SelectMode, TPreparedQueryHKT extends PreparedQueryHKTBase, TNullabilityMap extends Record<string, JoinNullability> = TTableName extends string ? Record<TTableName, 'not-null'> : {}, TDynamic extends boolean = false, TExcludedMethods extends string = never, TResult extends any[] = SelectResult<TSelection, TSelectMode, TNullabilityMap>[], TSelectedFields extends ColumnsSelection = BuildSubquerySelection<TSelection, TNullabilityMap>> extends MySqlSelectQueryBuilderBase<MySqlSelectHKT, TTableName, TSelection, TSelectMode, TPreparedQueryHKT, TNullabilityMap, TDynamic, TExcludedMethods, TResult, TSelectedFields>, QueryPromise<TResult> {
 }

package/mysql-core/query-builders/select.js

@@ -8,7 +8,7 @@ import { Subquery } from "../../subquery.js";
 import { Table } from "../../table.js";
 import { applyMixins, getTableColumns, getTableLikeName, haveSameKeys, orderSelectedFields } from "../../utils.js";
 import { ViewBaseConfig } from "../../view-common.js";
-import { convertIndexToString, extractUsedTable, toArray } from "../utils.js";
+import { convertIndexToString, toArray } from "../utils.js";
 import { MySqlViewBase } from "../view-base.js";
 class MySqlSelectBuilder {
   static [entityKind] = "MySqlSelectBuilder";
@@ -82,8 +82,6 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
   /** @internal */
   session;
   dialect;
-  cacheConfig = void 0;
-  usedTables = /* @__PURE__ */ new Set();
   constructor({ table, fields, isPartialSelect, session, dialect, withList, distinct, useIndex, forceIndex, ignoreIndex }) {
     super();
     this.config = {
@@ -100,24 +98,18 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
     this.session = session;
     this.dialect = dialect;
     this._ = {
-      selectedFields: fields,
-      config: this.config
+      selectedFields: fields
     };
     this.tableName = getTableLikeName(table);
     this.joinsNotNullableMap = typeof this.tableName === "string" ? { [this.tableName]: true } : {};
-    for (const item of extractUsedTable(table))
-      this.usedTables.add(item);
   }
-  /** @internal */
-  getUsedTables() {
-    return [...this.usedTables];
-  }
-  createJoin(joinType) {
-    return (table, on, onIndex) => {
+  createJoin(joinType, lateral) {
+    return (table, a, b) => {
+      const isCrossJoin = joinType === "cross";
+      let on = isCrossJoin ? void 0 : a;
+      const onIndex = isCrossJoin ? a : b;
       const baseTableName = this.tableName;
       const tableName = getTableLikeName(table);
-      for (const item of extractUsedTable(table))
-        this.usedTables.add(item);
       if (typeof tableName === "string" && this.config.joins?.some((join) => join.alias === tableName)) {
         throw new Error(`Alias "${tableName}" is already used in this query`);
       }
@@ -157,7 +149,7 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
           ignoreIndex = convertIndexToString(toArray(onIndex.ignoreIndex));
         }
       }
-      this.config.joins.push({ on, table, joinType, alias: tableName, useIndex, forceIndex, ignoreIndex });
+      this.config.joins.push({ on, table, joinType, alias: tableName, useIndex, forceIndex, ignoreIndex, lateral });
       if (typeof tableName === "string") {
         switch (joinType) {
           case "left": {
@@ -171,17 +163,11 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
             this.joinsNotNullableMap[tableName] = true;
             break;
           }
+          case "cross":
           case "inner": {
             this.joinsNotNullableMap[tableName] = true;
             break;
           }
-          case "full": {
-            this.joinsNotNullableMap = Object.fromEntries(
-              Object.entries(this.joinsNotNullableMap).map(([key]) => [key, false])
-            );
-            this.joinsNotNullableMap[tableName] = false;
-            break;
-          }
         }
       }
       return this;
@@ -196,17 +182,18 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
    *
    * @param table the table to join.
    * @param on the `on` clause.
+   * @param onIndex index hint.
    *
    * @example
    *
    * ```ts
    * // Select all users and their pets
-   * const usersWithPets: { user: User; pets: Pet | null }[] = await db.select()
+   * const usersWithPets: { user: User; pets: Pet | null; }[] = await db.select()
    *   .from(users)
    *   .leftJoin(pets, eq(users.id, pets.ownerId))
    *
    * // Select userId and petId
-   * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+   * const usersIdsAndPetIds: { userId: number; petId: number | null; }[] = await db.select({
    *   userId: users.id,
    *   petId: pets.id,
    * })
@@ -214,7 +201,7 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
    *   .leftJoin(pets, eq(users.id, pets.ownerId))
    *
    * // Select userId and petId with use index hint
-   * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+   * const usersIdsAndPetIds: { userId: number; petId: number | null; }[] = await db.select({
    *   userId: users.id,
    *   petId: pets.id,
    * })
@@ -224,7 +211,20 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
    * })
    * ```
    */
-  leftJoin = this.createJoin("left");
+  leftJoin = this.createJoin("left", false);
+  /**
+   * Executes a `left join lateral` operation by adding subquery to the current query.
+   *
+   * A `lateral` join allows the right-hand expression to refer to columns from the left-hand side.
+   *
+   * Calling this method associates each row of the table with the corresponding row from the joined table, if a match is found. If no matching row exists, it sets all columns of the joined table to null.
+   *
+   * See docs: {@link https://orm.drizzle.team/docs/joins#left-join-lateral}
+   *
+   * @param table the subquery to join.
+   * @param on the `on` clause.
+   */
+  leftJoinLateral = this.createJoin("left", true);
   /**
    * Executes a `right join` operation by adding another table to the current query.
    *
@@ -234,17 +234,18 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
    *
    * @param table the table to join.
    * @param on the `on` clause.
+   * @param onIndex index hint.
    *
    * @example
    *
    * ```ts
    * // Select all users and their pets
-   * const usersWithPets: { user: User | null; pets: Pet }[] = await db.select()
+   * const usersWithPets: { user: User | null; pets: Pet; }[] = await db.select()
    *   .from(users)
    *   .rightJoin(pets, eq(users.id, pets.ownerId))
    *
    * // Select userId and petId
-   * const usersIdsAndPetIds: { userId: number | null; petId: number }[] = await db.select({
+   * const usersIdsAndPetIds: { userId: number | null; petId: number; }[] = await db.select({
    *   userId: users.id,
    *   petId: pets.id,
    * })
@@ -252,7 +253,7 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
    *   .rightJoin(pets, eq(users.id, pets.ownerId))
    *
    * // Select userId and petId with use index hint
-   * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+   * const usersIdsAndPetIds: { userId: number; petId: number | null; }[] = await db.select({
    *   userId: users.id,
    *   petId: pets.id,
    * })
@@ -262,7 +263,7 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
    * })
    * ```
    */
-  rightJoin = this.createJoin("right");
+  rightJoin = this.createJoin("right", false);
   /**
    * Executes an `inner join` operation, creating a new table by combining rows from two tables that have matching values.
    *
@@ -272,17 +273,18 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
    *
    * @param table the table to join.
    * @param on the `on` clause.
+   * @param onIndex index hint.
    *
    * @example
    *
    * ```ts
    * // Select all users and their pets
-   * const usersWithPets: { user: User; pets: Pet }[] = await db.select()
+   * const usersWithPets: { user: User; pets: Pet; }[] = await db.select()
    *   .from(users)
    *   .innerJoin(pets, eq(users.id, pets.ownerId))
    *
    * // Select userId and petId
-   * const usersIdsAndPetIds: { userId: number; petId: number }[] = await db.select({
+   * const usersIdsAndPetIds: { userId: number; petId: number; }[] = await db.select({
    *   userId: users.id,
    *   petId: pets.id,
    * })
@@ -290,7 +292,7 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
    *   .innerJoin(pets, eq(users.id, pets.ownerId))
    *
    * // Select userId and petId with use index hint
-   * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+   * const usersIdsAndPetIds: { userId: number; petId: number | null; }[] = await db.select({
    *   userId: users.id,
    *   petId: pets.id,
    * })
@@ -300,45 +302,70 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
    * })
    * ```
    */
-  innerJoin = this.createJoin("inner");
+  innerJoin = this.createJoin("inner", false);
   /**
-   * Executes a `full join` operation by combining rows from two tables into a new table.
+   * Executes an `inner join lateral` operation, creating a new table by combining rows from two queries that have matching values.
    *
-   * Calling this method retrieves all rows from both main and joined tables, merging rows with matching values and filling in `null` for non-matching columns.
+   * A `lateral` join allows the right-hand expression to refer to columns from the left-hand side.
    *
-   * See docs: {@link https://orm.drizzle.team/docs/joins#full-join}
+   * Calling this method retrieves rows that have corresponding entries in both joined tables. Rows without matching entries in either table are excluded, resulting in a table that includes only matching pairs.
    *
-   * @param table the table to join.
+   * See docs: {@link https://orm.drizzle.team/docs/joins#inner-join-lateral}
+   *
+   * @param table the subquery to join.
    * @param on the `on` clause.
+   */
+  innerJoinLateral = this.createJoin("inner", true);
+  /**
+   * Executes a `cross join` operation by combining rows from two tables into a new table.
+   *
+   * Calling this method retrieves all rows from both main and joined tables, merging all rows from each table.
+   *
+   * See docs: {@link https://orm.drizzle.team/docs/joins#cross-join}
+   *
+   * @param table the table to join.
+   * @param onIndex index hint.
    *
    * @example
    *
    * ```ts
-   * // Select all users and their pets
-   * const usersWithPets: { user: User | null; pets: Pet | null }[] = await db.select()
+   * // Select all users, each user with every pet
+   * const usersWithPets: { user: User; pets: Pet; }[] = await db.select()
    *   .from(users)
-   *   .fullJoin(pets, eq(users.id, pets.ownerId))
+   *   .crossJoin(pets)
    *
    * // Select userId and petId
-   * const usersIdsAndPetIds: { userId: number | null; petId: number | null }[] = await db.select({
+   * const usersIdsAndPetIds: { userId: number; petId: number; }[] = await db.select({
    *   userId: users.id,
    *   petId: pets.id,
    * })
    *   .from(users)
-   *   .fullJoin(pets, eq(users.id, pets.ownerId))
+   *   .crossJoin(pets)
    *
    * // Select userId and petId with use index hint
-   * const usersIdsAndPetIds: { userId: number; petId: number | null }[] = await db.select({
+   * const usersIdsAndPetIds: { userId: number; petId: number; }[] = await db.select({
    *   userId: users.id,
    *   petId: pets.id,
    * })
    *   .from(users)
-   *   .leftJoin(pets, eq(users.id, pets.ownerId), {
+   *   .crossJoin(pets, {
    *     useIndex: ['pets_owner_id_index']
    * })
    * ```
    */
-  fullJoin = this.createJoin("full");
+  crossJoin = this.createJoin("cross", false);
+  /**
+   * Executes a `cross join lateral` operation by combining rows from two queries into a new table.
+   *
+   * A `lateral` join allows the right-hand expression to refer to columns from the left-hand side.
+   *
+   * Calling this method retrieves all rows from both main and joined queries, merging all rows from each query.
+   *
+   * See docs: {@link https://orm.drizzle.team/docs/joins#cross-join-lateral}
+   *
+   * @param table the query to join.
+   */
+  crossJoinLateral = this.createJoin("cross", true);
   createSetOperator(type, isAll) {
     return (rightSelection) => {
       const rightSelect = typeof rightSelection === "function" ? rightSelection(getMySqlSetOperators()) : rightSelection;
@@ -726,14 +753,8 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
     return rest;
   }
   as(alias) {
-    const usedTables = [];
-    usedTables.push(...extractUsedTable(this.config.table));
-    if (this.config.joins) {
-      for (const it of this.config.joins)
-        usedTables.push(...extractUsedTable(it.table));
-    }
     return new Proxy(
-      new Subquery(this.getSQL(), this.config.fields, alias, false, [...new Set(usedTables)]),
+      new Subquery(this.getSQL(), this.config.fields, alias),
       new SelectionProxyHandler({ alias, sqlAliasedBehavior: "alias", sqlBehavior: "error" })
     );
   }
@@ -747,10 +768,6 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
   $dynamic() {
     return this;
   }
-  $withCache(config) {
-    this.cacheConfig = config === void 0 ? { config: {}, enable: true, autoInvalidate: true } : config === false ? { enable: false } : { enable: true, autoInvalidate: true, ...config };
-    return this;
-  }
 }
 class MySqlSelectBase extends MySqlSelectQueryBuilderBase {
   static [entityKind] = "MySqlSelect";
@@ -759,10 +776,7 @@ class MySqlSelectBase extends MySqlSelectQueryBuilderBase {
       throw new Error("Cannot execute a query on a query builder. Please use a database instance instead.");
     }
     const fieldsList = orderSelectedFields(this.config.fields);
-    const query = this.session.prepareQuery(this.dialect.sqlToQuery(this.getSQL()), fieldsList, void 0, void 0, void 0, {
-      type: "select",
-      tables: [...this.usedTables]
-    }, this.cacheConfig);
+    const query = this.session.prepareQuery(this.dialect.sqlToQuery(this.getSQL()), fieldsList);
     query.joinsNotNullableMap = this.joinsNotNullableMap;
     return query;
   }