drizzle-orm 0.42.0-da9af74 → 0.43.0-62ea5c4

package/singlestore-core/query-builders/select.d.cts

@@ -1,4 +1,3 @@
-import type { CacheConfig, WithCacheConfig } from "../../cache/core/types.cjs";
 import { entityKind } from "../../entity.cjs";
 import { TypedQueryBuilder } from "../../query-builders/query-builder.cjs";
 import type { BuildSubquerySelection, GetSelectTableName, GetSelectTableSelection, JoinNullability, SelectMode, SelectResult } from "../../query-builders/select.types.cjs";
@@ -12,7 +11,7 @@ import type { ColumnsSelection, Query } from "../../sql/sql.cjs";
 import { SQL } from "../../sql/sql.cjs";
 import { Subquery } from "../../subquery.cjs";
 import { type ValueOrArray } from "../../utils.cjs";
-import type { CreateSingleStoreSelectFromBuilderMode, GetSingleStoreSetOperators, LockConfig, LockStrength, SelectedFields, SetOperatorRightSelect, SingleStoreCreateSetOperatorFn, SingleStoreJoinFn, SingleStoreSelectConfig, SingleStoreSelectDynamic, SingleStoreSelectHKT, SingleStoreSelectHKTBase, SingleStoreSelectPrepare, SingleStoreSelectWithout, SingleStoreSetOperatorExcludedMethods, SingleStoreSetOperatorWithResult } from "./select.types.cjs";
+import type { CreateSingleStoreSelectFromBuilderMode, GetSingleStoreSetOperators, LockConfig, LockStrength, SelectedFields, SetOperatorRightSelect, SingleStoreCreateSetOperatorFn, SingleStoreSelectConfig, SingleStoreSelectDynamic, SingleStoreSelectHKT, SingleStoreSelectHKTBase, SingleStoreSelectPrepare, SingleStoreSelectWithout, SingleStoreSetOperatorExcludedMethods, SingleStoreSetOperatorWithResult } from "./select.types.cjs";
 export declare class SingleStoreSelectBuilder<TSelection extends SelectedFields | undefined, TPreparedQueryHKT extends PreparedQueryHKTBase, TBuilderMode extends 'db' | 'qb' = 'db'> {
     static readonly [entityKind]: string;
     private fields;
@@ -43,15 +42,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
         readonly excludedMethods: TExcludedMethods;
         readonly result: TResult;
         readonly selectedFields: TSelectedFields;
-        readonly config: SingleStoreSelectConfig;
     };
     protected config: SingleStoreSelectConfig;
     protected joinsNotNullableMap: Record<string, boolean>;
     private tableName;
     private isPartialSelect;
     protected dialect: SingleStoreDialect;
-    protected cacheConfig?: WithCacheConfig;
-    protected usedTables: Set<string>;
     constructor({ table, fields, isPartialSelect, session, dialect, withList, distinct }: {
         table: SingleStoreSelectConfig['table'];
         fields: SingleStoreSelectConfig['fields'];
@@ -76,12 +72,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *
      * ```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,
      * })
@@ -89,7 +85,20 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *   .leftJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    leftJoin: SingleStoreJoinFn<this, TDynamic, "left">;
+    leftJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | SingleStoreTable<import("../table.ts").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.ts").SingleStoreJoin<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) => import("./select.types.ts").SingleStoreJoin<this, TDynamic, "left", TJoinedTable, TJoinedName>;
     /**
      * Executes a `right join` operation by adding another table to the current query.
      *
@@ -104,12 +113,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *
      * ```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,
      * })
@@ -117,7 +126,7 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *   .rightJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    rightJoin: SingleStoreJoinFn<this, TDynamic, "right">;
+    rightJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | SingleStoreTable<import("../table.ts").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.ts").SingleStoreJoin<this, TDynamic, "right", TJoinedTable, TJoinedName>;
     /**
      * Executes an `inner join` operation, creating a new table by combining rows from two tables that have matching values.
      *
@@ -132,12 +141,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *
      * ```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,
      * })
@@ -145,7 +154,20 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *   .innerJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    innerJoin: SingleStoreJoinFn<this, TDynamic, "inner">;
+    innerJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | SingleStoreTable<import("../table.ts").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.ts").SingleStoreJoin<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: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.ts").SingleStoreJoin<this, TDynamic, "inner", TJoinedTable, TJoinedName>;
     /**
      * Executes a `full join` operation by combining rows from two tables into a new table.
      *
@@ -160,12 +182,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *
      * ```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,
      * })
@@ -173,7 +195,46 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *   .fullJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    fullJoin: SingleStoreJoinFn<this, TDynamic, "full">;
+    fullJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | SingleStoreTable<import("../table.ts").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.ts").SingleStoreJoin<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>> | SingleStoreTable<import("../table.ts").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable) => import("./select.types.ts").SingleStoreJoin<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) => import("./select.types.ts").SingleStoreJoin<this, TDynamic, "cross", TJoinedTable, TJoinedName>;
     private createSetOperator;
     /**
      * Adds `union` set operator to the query.
@@ -455,11 +516,6 @@ export interface SingleStoreSelectBase<TTableName extends string | undefined, TS
 export declare class SingleStoreSelectBase<TTableName extends string | undefined, TSelection, 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 = SelectResult<TSelection, TSelectMode, TNullabilityMap>[], TSelectedFields = BuildSubquerySelection<TSelection, TNullabilityMap>> extends SingleStoreSelectQueryBuilderBase<SingleStoreSelectHKT, TTableName, TSelection, TSelectMode, TPreparedQueryHKT, TNullabilityMap, TDynamic, TExcludedMethods, TResult, TSelectedFields> {
     static readonly [entityKind]: string;
     prepare(): SingleStoreSelectPrepare<this>;
-    $withCache(config?: {
-        config?: CacheConfig;
-        tag?: string;
-        autoInvalidate?: boolean;
-    } | false): this;
     execute: ReturnType<this["prepare"]>["execute"];
     private createIterator;
     iterator: ReturnType<this["prepare"]>["iterator"];

package/singlestore-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 { TypedQueryBuilder } from "../../query-builders/query-builder.js";
 import type { BuildSubquerySelection, GetSelectTableName, GetSelectTableSelection, JoinNullability, SelectMode, SelectResult } from "../../query-builders/select.types.js";
@@ -12,7 +11,7 @@ import type { ColumnsSelection, Query } from "../../sql/sql.js";
 import { SQL } from "../../sql/sql.js";
 import { Subquery } from "../../subquery.js";
 import { type ValueOrArray } from "../../utils.js";
-import type { CreateSingleStoreSelectFromBuilderMode, GetSingleStoreSetOperators, LockConfig, LockStrength, SelectedFields, SetOperatorRightSelect, SingleStoreCreateSetOperatorFn, SingleStoreJoinFn, SingleStoreSelectConfig, SingleStoreSelectDynamic, SingleStoreSelectHKT, SingleStoreSelectHKTBase, SingleStoreSelectPrepare, SingleStoreSelectWithout, SingleStoreSetOperatorExcludedMethods, SingleStoreSetOperatorWithResult } from "./select.types.js";
+import type { CreateSingleStoreSelectFromBuilderMode, GetSingleStoreSetOperators, LockConfig, LockStrength, SelectedFields, SetOperatorRightSelect, SingleStoreCreateSetOperatorFn, SingleStoreSelectConfig, SingleStoreSelectDynamic, SingleStoreSelectHKT, SingleStoreSelectHKTBase, SingleStoreSelectPrepare, SingleStoreSelectWithout, SingleStoreSetOperatorExcludedMethods, SingleStoreSetOperatorWithResult } from "./select.types.js";
 export declare class SingleStoreSelectBuilder<TSelection extends SelectedFields | undefined, TPreparedQueryHKT extends PreparedQueryHKTBase, TBuilderMode extends 'db' | 'qb' = 'db'> {
     static readonly [entityKind]: string;
     private fields;
@@ -43,15 +42,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
         readonly excludedMethods: TExcludedMethods;
         readonly result: TResult;
         readonly selectedFields: TSelectedFields;
-        readonly config: SingleStoreSelectConfig;
     };
     protected config: SingleStoreSelectConfig;
     protected joinsNotNullableMap: Record<string, boolean>;
     private tableName;
     private isPartialSelect;
     protected dialect: SingleStoreDialect;
-    protected cacheConfig?: WithCacheConfig;
-    protected usedTables: Set<string>;
     constructor({ table, fields, isPartialSelect, session, dialect, withList, distinct }: {
         table: SingleStoreSelectConfig['table'];
         fields: SingleStoreSelectConfig['fields'];
@@ -76,12 +72,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *
      * ```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,
      * })
@@ -89,7 +85,20 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *   .leftJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    leftJoin: SingleStoreJoinFn<this, TDynamic, "left">;
+    leftJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | SingleStoreTable<import("../table.js").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").SingleStoreJoin<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) => import("./select.types.js").SingleStoreJoin<this, TDynamic, "left", TJoinedTable, TJoinedName>;
     /**
      * Executes a `right join` operation by adding another table to the current query.
      *
@@ -104,12 +113,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *
      * ```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,
      * })
@@ -117,7 +126,7 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *   .rightJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    rightJoin: SingleStoreJoinFn<this, TDynamic, "right">;
+    rightJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | SingleStoreTable<import("../table.js").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").SingleStoreJoin<this, TDynamic, "right", TJoinedTable, TJoinedName>;
     /**
      * Executes an `inner join` operation, creating a new table by combining rows from two tables that have matching values.
      *
@@ -132,12 +141,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *
      * ```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,
      * })
@@ -145,7 +154,20 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *   .innerJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    innerJoin: SingleStoreJoinFn<this, TDynamic, "inner">;
+    innerJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | SingleStoreTable<import("../table.js").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").SingleStoreJoin<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: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").SingleStoreJoin<this, TDynamic, "inner", TJoinedTable, TJoinedName>;
     /**
      * Executes a `full join` operation by combining rows from two tables into a new table.
      *
@@ -160,12 +182,12 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *
      * ```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,
      * })
@@ -173,7 +195,46 @@ export declare abstract class SingleStoreSelectQueryBuilderBase<THKT extends Sin
      *   .fullJoin(pets, eq(users.id, pets.ownerId))
      * ```
      */
-    fullJoin: SingleStoreJoinFn<this, TDynamic, "full">;
+    fullJoin: <TJoinedTable extends SQL<unknown> | Subquery<string, Record<string, unknown>> | SingleStoreTable<import("../table.js").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable, on: SQL<unknown> | ((aliases: this["_"]["selection"]) => SQL | undefined) | undefined) => import("./select.types.js").SingleStoreJoin<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>> | SingleStoreTable<import("../table.js").TableConfig>, TJoinedName extends GetSelectTableName<TJoinedTable> = GetSelectTableName<TJoinedTable>>(table: TJoinedTable) => import("./select.types.js").SingleStoreJoin<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) => import("./select.types.js").SingleStoreJoin<this, TDynamic, "cross", TJoinedTable, TJoinedName>;
     private createSetOperator;
     /**
      * Adds `union` set operator to the query.
@@ -455,11 +516,6 @@ export interface SingleStoreSelectBase<TTableName extends string | undefined, TS
 export declare class SingleStoreSelectBase<TTableName extends string | undefined, TSelection, 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 = SelectResult<TSelection, TSelectMode, TNullabilityMap>[], TSelectedFields = BuildSubquerySelection<TSelection, TNullabilityMap>> extends SingleStoreSelectQueryBuilderBase<SingleStoreSelectHKT, TTableName, TSelection, TSelectMode, TPreparedQueryHKT, TNullabilityMap, TDynamic, TExcludedMethods, TResult, TSelectedFields> {
     static readonly [entityKind]: string;
     prepare(): SingleStoreSelectPrepare<this>;
-    $withCache(config?: {
-        config?: CacheConfig;
-        tag?: string;
-        autoInvalidate?: boolean;
-    } | false): this;
     execute: ReturnType<this["prepare"]>["execute"];
     private createIterator;
     iterator: ReturnType<this["prepare"]>["iterator"];

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

@@ -12,7 +12,6 @@ import {
   haveSameKeys,
   orderSelectedFields
 } from "../../utils.js";
-import { extractUsedTable } from "../utils.js";
 class SingleStoreSelectBuilder {
   static [entityKind] = "SingleStoreSelectBuilder";
   fields;
@@ -66,8 +65,6 @@ class SingleStoreSelectQueryBuilderBase extends TypedQueryBuilder {
   /** @internal */
   session;
   dialect;
-  cacheConfig = void 0;
-  usedTables = /* @__PURE__ */ new Set();
   constructor({ table, fields, isPartialSelect, session, dialect, withList, distinct }) {
     super();
     this.config = {
@@ -81,24 +78,15 @@ class SingleStoreSelectQueryBuilderBase 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`);
       }
@@ -124,7 +112,7 @@ class SingleStoreSelectQueryBuilderBase 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": {
@@ -138,6 +126,7 @@ class SingleStoreSelectQueryBuilderBase extends TypedQueryBuilder {
             this.joinsNotNullableMap[tableName] = true;
             break;
           }
+          case "cross":
           case "inner": {
             this.joinsNotNullableMap[tableName] = true;
             break;
@@ -168,12 +157,12 @@ class SingleStoreSelectQueryBuilderBase 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,
    * })
@@ -181,7 +170,20 @@ class SingleStoreSelectQueryBuilderBase 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.
    *
@@ -196,12 +198,12 @@ class SingleStoreSelectQueryBuilderBase 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,
    * })
@@ -209,7 +211,7 @@ class SingleStoreSelectQueryBuilderBase 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.
    *
@@ -224,12 +226,12 @@ class SingleStoreSelectQueryBuilderBase 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,
    * })
@@ -237,7 +239,20 @@ class SingleStoreSelectQueryBuilderBase 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.
    *
@@ -252,12 +267,12 @@ class SingleStoreSelectQueryBuilderBase 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,
    * })
@@ -265,7 +280,46 @@ class SingleStoreSelectQueryBuilderBase 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(getSingleStoreSetOperators()) : rightSelection;
@@ -593,14 +647,8 @@ class SingleStoreSelectQueryBuilderBase 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" })
     );
   }
@@ -622,17 +670,10 @@ class SingleStoreSelectBase extends SingleStoreSelectQueryBuilderBase {
       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;
   }
-  $withCache(config) {
-    this.cacheConfig = config === void 0 ? { config: {}, enable: true, autoInvalidate: true } : config === false ? { enable: false } : { enable: true, autoInvalidate: true, ...config };
-    return this;
-  }
   execute = (placeholderValues) => {
     return this.prepare().execute(placeholderValues);
   };