drizzle-orm 0.42.0 → 0.43.0-62ea5c4

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

@@ -13,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[];
@@ -77,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,
      * })
@@ -95,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,
      * })
@@ -105,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.
      *
@@ -115,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,
      * })
@@ -133,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,
      * })
@@ -143,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.
      *
@@ -153,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,
      * })
@@ -171,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,
      * })
@@ -181,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.

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

@@ -103,8 +103,11 @@ class MySqlSelectQueryBuilderBase extends TypedQueryBuilder {
     this.tableName = getTableLikeName(table);
     this.joinsNotNullableMap = typeof this.tableName === "string" ? { [this.tableName]: true } : {};
   }
-  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);
       if (typeof tableName === "string" && this.config.joins?.some((join) => join.alias === tableName)) {
@@ -146,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": {
@@ -160,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;
@@ -185,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,
    * })
@@ -203,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,
    * })
@@ -213,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.
    *
@@ -223,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,
    * })
@@ -241,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,
    * })
@@ -251,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.
    *
@@ -261,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,
    * })
@@ -279,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,
    * })
@@ -289,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;