drizzle-orm 0.42.0-da9af74 → 0.43.0-62ea5c4

package/pg-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 { PgColumn } from "../columns/index.js";
 import type { PgDialect } from "../dialect.js";
@@ -14,7 +13,7 @@ import { SQL } from "../../sql/sql.js";
 import type { ColumnsSelection, Placeholder, Query, SQLWrapper } from "../../sql/sql.js";
 import { Subquery } from "../../subquery.js";
 import { type DrizzleTypeError, type ValueOrArray } from "../../utils.js";
-import type { CreatePgSelectFromBuilderMode, GetPgSetOperators, LockConfig, LockStrength, PgCreateSetOperatorFn, PgSelectConfig, PgSelectDynamic, PgSelectHKT, PgSelectHKTBase, PgSelectJoinFn, PgSelectPrepare, PgSelectWithout, PgSetOperatorExcludedMethods, PgSetOperatorWithResult, SelectedFields, SetOperatorRightSelect, TableLikeHasEmptySelection } from "./select.types.js";
+import type { CreatePgSelectFromBuilderMode, GetPgSetOperators, LockConfig, LockStrength, PgCreateSetOperatorFn, PgSelectConfig, PgSelectDynamic, PgSelectHKT, PgSelectHKTBase, PgSelectPrepare, PgSelectWithout, PgSetOperatorExcludedMethods, PgSetOperatorWithResult, SelectedFields, SetOperatorRightSelect, TableLikeHasEmptySelection } from "./select.types.js";
 export declare class PgSelectBuilder<TSelection extends SelectedFields | undefined, TBuilderMode extends 'db' | 'qb' = 'db'> {
     static readonly [entityKind]: string;
     private fields;
@@ -53,16 +52,13 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
         readonly excludedMethods: TExcludedMethods;
         readonly result: TResult;
         readonly selectedFields: TSelectedFields;
-        readonly config: PgSelectConfig;
     };
     protected config: PgSelectConfig;
     protected joinsNotNullableMap: Record<string, boolean>;
-    protected tableName: string | undefined;
+    private tableName;
     private isPartialSelect;
     protected session: PgSession | undefined;
     protected dialect: PgDialect;
-    protected cacheConfig?: WithCacheConfig;
-    protected usedTables: Set<string>;
     constructor({ table, fields, isPartialSelect, session, dialect, withList, distinct }: {
         table: PgSelectConfig['table'];
         fields: PgSelectConfig['fields'];
@@ -89,12 +85,12 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
      *
      * ```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,
      * })
@@ -102,7 +98,20 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
      *   .leftJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    leftJoin: PgSelectJoinFn<this, TDynamic, "left">;
+    leftJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | PgTable<import("../table.js").TableConfig> | PgViewBase<string, boolean, ColumnsSelection>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").PgSelectJoin<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: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").PgSelectJoin<this, TDynamic, "left", TJoinedTable, TJoinedName>;
     /**
      * Executes a `right join` operation by adding another table to the current query.
      *
@@ -117,12 +126,12 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
      *
      * ```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,
      * })
@@ -130,7 +139,7 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
      *   .rightJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    rightJoin: PgSelectJoinFn<this, TDynamic, "right">;
+    rightJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | PgTable<import("../table.js").TableConfig> | PgViewBase<string, boolean, ColumnsSelection>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").PgSelectJoin<this, TDynamic, "right", TJoinedTable, TJoinedName>;
     /**
      * Executes an `inner join` operation, creating a new table by combining rows from two tables that have matching values.
      *
@@ -145,12 +154,12 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
      *
      * ```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,
      * })
@@ -158,7 +167,20 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
      *   .innerJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    innerJoin: PgSelectJoinFn<this, TDynamic, "inner">;
+    innerJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | PgTable<import("../table.js").TableConfig> | PgViewBase<string, boolean, ColumnsSelection>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").PgSelectJoin<this, TDynamic, "inner", TJoinedTable, TJoinedName>;
+    /**
+     * Executes an `inner join lateral` operation, creating a new table by combining rows from two queries that have matching values.
+     *
+     * A `lateral` join allows the right-hand expression to refer to columns from the left-hand side.
+     *
+     * 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.
+     *
+     * 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: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").PgSelectJoin<this, TDynamic, "inner", TJoinedTable, TJoinedName>;
     /**
      * Executes a `full join` operation by combining rows from two tables into a new table.
      *
@@ -173,12 +195,12 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
      *
      * ```ts
      * // Select all users and their pets
-     * const usersWithPets: { user: User | null; pets: Pet | null }[] = await db.select()
+     * const usersWithPets: { user: User | null; pets: Pet | null; }[] = await db.select()
      *   .from(users)
      *   .fullJoin(pets, eq(users.id, pets.ownerId))
      *
      * // Select userId and petId
-     * const usersIdsAndPetIds: { userId: number | null; petId: number | null }[] = await db.select({
+     * const usersIdsAndPetIds: { userId: number | null; petId: number | null; }[] = await db.select({
      *   userId: users.id,
      *   petId: pets.id,
      * })
@@ -186,7 +208,46 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
      *   .fullJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    fullJoin: PgSelectJoinFn<this, TDynamic, "full">;
+    fullJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | PgTable<import("../table.js").TableConfig> | PgViewBase<string, boolean, ColumnsSelection>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").PgSelectJoin<this, TDynamic, "full", 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.
+     *
+     * @example
+     *
+     * ```ts
+     * // Select all users, each user with every pet
+     * const usersWithPets: { user: User; pets: Pet; }[] = await db.select()
+     *   .from(users)
+     *   .crossJoin(pets)
+     *
+     * // Select userId and petId
+     * const usersIdsAndPetIds: { userId: number; petId: number; }[] = await db.select({
+     *   userId: users.id,
+     *   petId: pets.id,
+     * })
+     *   .from(users)
+     *   .crossJoin(pets)
+     * ```
+     */
+    crossJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | PgTable<import("../table.js").TableConfig> | PgViewBase<string, boolean, ColumnsSelection>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable) => import("./select.types.js").PgSelectJoin<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: TableLikeHasEmptySelection<TJoinedTable> extends true ? DrizzleTypeError<"Cannot reference a data-modifying statement subquery if it doesn't contain a `returning` clause"> : TJoinedTable) => import("./select.types.js").PgSelectJoin<this, TDynamic, "cross", TJoinedTable, TJoinedName>;
     private createSetOperator;
     /**
      * Adds `union` set operator to the query.
@@ -522,11 +583,6 @@ export declare abstract class PgSelectQueryBuilderBase<THKT extends PgSelectHKTB
     toSQL(): Query;
     as<TAlias extends string>(alias: TAlias): SubqueryWithSelection<this['_']['selectedFields'], TAlias>;
     $dynamic(): PgSelectDynamic<this>;
-    $withCache(config?: {
-        config?: CacheConfig;
-        tag?: string;
-        autoInvalidate?: boolean;
-    } | false): this;
 }
 export interface PgSelectBase<TTableName extends string | undefined, TSelection extends ColumnsSelection, TSelectMode extends SelectMode, 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 PgSelectQueryBuilderBase<PgSelectHKT, TTableName, TSelection, TSelectMode, TNullabilityMap, TDynamic, TExcludedMethods, TResult, TSelectedFields>, QueryPromise<TResult>, SQLWrapper {
 }

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

@@ -15,7 +15,6 @@ import {
 } from "../../utils.js";
 import { orderSelectedFields } from "../../utils.js";
 import { ViewBaseConfig } from "../../view-common.js";
-import { extractUsedTable } from "../utils.js";
 class PgSelectBuilder {
   static [entityKind] = "PgSelectBuilder";
   fields;
@@ -81,8 +80,6 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
   isPartialSelect;
   session;
   dialect;
-  cacheConfig = void 0;
-  usedTables = /* @__PURE__ */ new Set();
   constructor({ table, fields, isPartialSelect, session, dialect, withList, distinct }) {
     super();
     this.config = {
@@ -96,24 +93,15 @@ class PgSelectQueryBuilderBase 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) {
+  createJoin(joinType, lateral) {
     return (table, on) => {
       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`);
       }
@@ -139,7 +127,7 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
       if (!this.config.joins) {
         this.config.joins = [];
       }
-      this.config.joins.push({ on, table, joinType, alias: tableName });
+      this.config.joins.push({ on, table, joinType, alias: tableName, lateral });
       if (typeof tableName === "string") {
         switch (joinType) {
           case "left": {
@@ -153,6 +141,7 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
             this.joinsNotNullableMap[tableName] = true;
             break;
           }
+          case "cross":
           case "inner": {
             this.joinsNotNullableMap[tableName] = true;
             break;
@@ -183,12 +172,12 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
    *
    * ```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,
    * })
@@ -196,7 +185,20 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
    *   .leftJoin(pets, eq(users.id, pets.ownerId))
    * ```
    */
-  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.
    *
@@ -211,12 +213,12 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
    *
    * ```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,
    * })
@@ -224,7 +226,7 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
    *   .rightJoin(pets, eq(users.id, pets.ownerId))
    * ```
    */
-  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.
    *
@@ -239,12 +241,12 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
    *
    * ```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,
    * })
@@ -252,7 +254,20 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
    *   .innerJoin(pets, eq(users.id, pets.ownerId))
    * ```
    */
-  innerJoin = this.createJoin("inner");
+  innerJoin = this.createJoin("inner", false);
+  /**
+   * Executes an `inner join lateral` operation, creating a new table by combining rows from two queries that have matching values.
+   *
+   * A `lateral` join allows the right-hand expression to refer to columns from the left-hand side.
+   *
+   * 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.
+   *
+   * 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 `full join` operation by combining rows from two tables into a new table.
    *
@@ -267,12 +282,12 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
    *
    * ```ts
    * // Select all users and their pets
-   * const usersWithPets: { user: User | null; pets: Pet | null }[] = await db.select()
+   * const usersWithPets: { user: User | null; pets: Pet | null; }[] = await db.select()
    *   .from(users)
    *   .fullJoin(pets, eq(users.id, pets.ownerId))
    *
    * // Select userId and petId
-   * const usersIdsAndPetIds: { userId: number | null; petId: number | null }[] = await db.select({
+   * const usersIdsAndPetIds: { userId: number | null; petId: number | null; }[] = await db.select({
    *   userId: users.id,
    *   petId: pets.id,
    * })
@@ -280,7 +295,46 @@ class PgSelectQueryBuilderBase extends TypedQueryBuilder {
    *   .fullJoin(pets, eq(users.id, pets.ownerId))
    * ```
    */
-  fullJoin = this.createJoin("full");
+  fullJoin = this.createJoin("full", false);
+  /**
+   * 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.
+   *
+   * @example
+   *
+   * ```ts
+   * // Select all users, each user with every pet
+   * const usersWithPets: { user: User; pets: Pet; }[] = await db.select()
+   *   .from(users)
+   *   .crossJoin(pets)
+   *
+   * // Select userId and petId
+   * const usersIdsAndPetIds: { userId: number; petId: number; }[] = await db.select({
+   *   userId: users.id,
+   *   petId: pets.id,
+   * })
+   *   .from(users)
+   *   .crossJoin(pets)
+   * ```
+   */
+  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(getPgSetOperators()) : rightSelection;
@@ -668,14 +722,8 @@ class PgSelectQueryBuilderBase 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" })
     );
   }
@@ -689,26 +737,18 @@ class PgSelectQueryBuilderBase 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 PgSelectBase extends PgSelectQueryBuilderBase {
   static [entityKind] = "PgSelect";
   /** @internal */
   _prepare(name) {
-    const { session, config, dialect, joinsNotNullableMap, authToken, cacheConfig, usedTables } = this;
+    const { session, config, dialect, joinsNotNullableMap, authToken } = this;
     if (!session) {
       throw new Error("Cannot execute a query on a query builder. Please use a database instance instead.");
     }
-    const { fields } = config;
     return tracer.startActiveSpan("drizzle.prepareQuery", () => {
-      const fieldsList = orderSelectedFields(fields);
-      const query = session.prepareQuery(dialect.sqlToQuery(this.getSQL()), fieldsList, name, true, void 0, {
-        type: "select",
-        tables: [...usedTables]
-      }, cacheConfig);
+      const fieldsList = orderSelectedFields(config.fields);
+      const query = session.prepareQuery(dialect.sqlToQuery(this.getSQL()), fieldsList, name, true);
       query.joinsNotNullableMap = joinsNotNullableMap;
       return query.setToken(authToken);
     });