drizzle-kit 0.30.1-e6823b4 → 0.30.1-efed06b

package/api.mjs

@@ -22260,7 +22260,7 @@ var init_sql = __esm({
             const schemaName = chunk[Table2.Symbol.Schema];
             const tableName = chunk[Table2.Symbol.Name];
             return {
-              sql: schemaName === void 0 ? escapeName(tableName) : escapeName(schemaName) + "." + escapeName(tableName),
+              sql: schemaName === void 0 || chunk[Table2.Symbol.IsAlias] ? escapeName(tableName) : escapeName(schemaName) + "." + escapeName(tableName),
               params: []
             };
           }
@@ -24842,24 +24842,33 @@ var init_primary_keys = __esm({
 function getOrderByOperators() {
   return orderByOperators;
 }
-function mapRelationalRow(row, buildQueryResultSelection, mapColumnValue = (value) => value, parseJson = false) {
+function mapRelationalRow(row, buildQueryResultSelection, mapColumnValue = (value) => value, parseJson = false, path2) {
   for (const selectionItem of buildQueryResultSelection) {
     const field = selectionItem.field;
     if (is(field, Table2)) {
+      const currentPath = `${path2 ? `${path2}.` : ""}${selectionItem.key}`;
       if (row[selectionItem.key] === null)
         continue;
       if (parseJson)
         row[selectionItem.key] = JSON.parse(row[selectionItem.key]);
       if (selectionItem.isArray) {
         for (const item of row[selectionItem.key]) {
-          mapRelationalRow(item, selectionItem.selection, mapColumnValue);
+          mapRelationalRow(
+            item,
+            selectionItem.selection,
+            mapColumnValue,
+            false,
+            currentPath
+          );
         }
         continue;
       }
       mapRelationalRow(
         row[selectionItem.key],
         selectionItem.selection,
-        mapColumnValue
+        mapColumnValue,
+        false,
+        currentPath
       );
       continue;
     }
@@ -24910,7 +24919,7 @@ function defineRelations(schema5, relations) {
   );
 }
 function relationsFieldFilterToSQL(column5, filter2) {
-  if (typeof filter2 !== "object" || is(filter2, Placeholder))
+  if (typeof filter2 !== "object")
     return eq(column5, filter2);
   const entries = Object.entries(filter2);
   if (!entries.length)
@@ -24937,6 +24946,21 @@ function relationsFieldFilterToSQL(column5, filter2) {
         );
         continue;
       }
+      case "isNotNull":
+      case "isNull": {
+        if (!value)
+          continue;
+        parts.push(operators[target](column5));
+        continue;
+      }
+      case "in": {
+        parts.push(operators.inArray(column5, value));
+        continue;
+      }
+      case "notIn": {
+        parts.push(operators.notInArray(column5, value));
+        continue;
+      }
       default: {
         parts.push(
           operators[target](
@@ -24964,7 +24988,7 @@ function relationsFilterToSQL(table5, filter2) {
       case "RAW": {
         if (value) {
           parts.push(
-            value(table5[Columns], operators)
+            value(table5, operators)
           );
         }
         continue;
@@ -25034,18 +25058,46 @@ function relationExtrasToSQL(table5, extras) {
     selection
   };
 }
-function relationToSQL(relation, sourceTable, targetTable) {
+function relationToSQL(relation, sourceTable, targetTable, throughTable) {
+  if (relation.through) {
+    const outerColumnWhere = relation.sourceColumns.map((s, i) => {
+      const t = relation.through.source[i];
+      return eq(
+        sql`${sourceTable}.${sql.identifier(s.name)}`,
+        sql`${throughTable}.${sql.identifier(t.name)}`
+      );
+    });
+    const innerColumnWhere = relation.targetColumns.map((s, i) => {
+      const t = relation.through.target[i];
+      return eq(
+        sql`${throughTable}.${sql.identifier(t.name)}`,
+        sql`${targetTable}.${sql.identifier(s.name)}`
+      );
+    });
+    return {
+      filter: and(
+        relation.where ? relation.isReversed ? relationsFilterToSQL(targetTable, relation.where) : relationsFilterToSQL(sourceTable, relation.where) : void 0
+      ),
+      joinCondition: and(
+        ...outerColumnWhere,
+        ...innerColumnWhere
+      )
+    };
+  }
   const columnWhere = relation.sourceColumns.map((s, i) => {
     const t = relation.targetColumns[i];
     return eq(
-      sql`${sql`${sql`${sql.identifier(sourceTable[Schema] ?? "")}.`.if(sourceTable[Schema] && !sourceTable[IsAlias])}`}${sourceTable}.${sql.identifier(s.name)}`,
-      sql`${sql`${sql`${sql.identifier(targetTable[Schema] ?? "")}.`.if(targetTable[Schema] && !targetTable[IsAlias])}`}${targetTable}.${sql.identifier(t.name)}`
+      sql`${sourceTable}.${sql.identifier(s.name)}`,
+      sql`${targetTable}.${sql.identifier(t.name)}`
     );
   });
-  const targetWhere = relation.where ? and(...columnWhere, relationsFilterToSQL(sourceTable, relation.where)) : and(...columnWhere);
-  return targetWhere;
+  const fullWhere = and(
+    ...columnWhere,
+    relation.where ? relation.isReversed ? relationsFilterToSQL(targetTable, relation.where) : relationsFilterToSQL(sourceTable, relation.where) : void 0
+  );
+  return { filter: fullWhere };
 }
-var _a118, Relations, _a119, Relation, _a120, _b95, One, _a121, _b96, Many, _a122, AggregatedField, _a123, _b97, Count, operators, orderByOperators, _a124, RelationsBuilderTable, _a125, RelationsBuilderColumn, _a126, RelationsHelperStatic;
+var _a118, Relations, _a119, Relation, _a120, _b95, One, _a121, _b96, Many, _a122, AggregatedField, _a123, _b97, Count, operators, orderByOperators, _a124, RelationsBuilderTable, _a125, _RelationsBuilderColumn, RelationsBuilderColumn, _a126, RelationsHelperStatic;
 var init_relations = __esm({
   "../drizzle-orm/dist/relations.js"() {
     "use strict";
@@ -25120,9 +25172,30 @@ var init_relations = __esm({
             if (relation.sourceColumns && relation.targetColumns) {
               if (relation.sourceColumns.length !== relation.targetColumns.length) {
                 throw new Error(
-                  `${relationPrintName}: "from" and "to" arrays must have the same length`
+                  `${relationPrintName}: "from" and "to" fields must have the same length`
                 );
               }
+              if (relation.through) {
+                if (relation.through.source.length !== relation.through.target.length || relation.through.source.length !== relation.sourceColumns.length || relation.through.target.length !== relation.targetColumns.length) {
+                  throw new Error(
+                    `${relationPrintName}: ".through(column)" must be used either on all columns in "from" and "to" or not defined on any of them`
+                  );
+                }
+                for (const column5 of relation.through.source) {
+                  if (column5.table !== relation.throughTable) {
+                    throw new Error(
+                      `${relationPrintName}: ".through(column)" must be used on the same table by all columns of the relation`
+                    );
+                  }
+                }
+                for (const column5 of relation.through.target) {
+                  if (column5.table !== relation.throughTable) {
+                    throw new Error(
+                      `${relationPrintName}: ".through(column)" must be used on the same table by all columns of the relation`
+                    );
+                  }
+                }
+              }
               continue;
             }
             if (relation.sourceColumns || relation.targetColumns) {
@@ -25182,7 +25255,13 @@ Hint: you can specify "alias" on both sides of the relation with the same value`
             }
             relation.sourceColumns = reverseRelation.targetColumns;
             relation.targetColumns = reverseRelation.sourceColumns;
-            relation.where = reverseRelation.where;
+            relation.through = reverseRelation.through ? {
+              source: reverseRelation.through.target,
+              target: reverseRelation.through.source
+            } : void 0;
+            relation.throughTable = reverseRelation.throughTable;
+            relation.isReversed = !relation.where;
+            relation.where = relation.where ?? reverseRelation.where;
           }
         }
       }
@@ -25197,6 +25276,9 @@ Hint: you can specify "alias" on both sides of the relation with the same value`
         __publicField(this, "alias");
         __publicField(this, "where");
         __publicField(this, "sourceTable");
+        __publicField(this, "through");
+        __publicField(this, "throughTable");
+        __publicField(this, "isReversed");
         this.targetTable = targetTable;
       }
     };
@@ -25208,12 +25290,30 @@ Hint: you can specify "alias" on both sides of the relation with the same value`
         this.alias = config?.alias;
         this.where = config?.where;
         if (config?.from) {
-          this.sourceColumns = Array.isArray(config.from) ? config.from.map((it) => it._.column) : [config.from._.column];
+          this.sourceColumns = (Array.isArray(config.from) ? config.from : [config.from]).map((it) => {
+            this.throughTable ??= it._.through?._.column.table;
+            return it._.column;
+          });
         }
         if (config?.to) {
-          this.targetColumns = Array.isArray(config.to) ? config.to.map((it) => it._.column) : [config.to._.column];
+          this.targetColumns = (Array.isArray(config.to) ? config.to : [config.to]).map((it) => {
+            this.throughTable ??= it._.through?._.column.table;
+            return it._.column;
+          });
         }
-        this.optional = config?.optional ?? false;
+        if (this.throughTable) {
+          this.through = Array.isArray(config?.from) ? {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain -- in case it's undefined, error will be thrown in Relations constructor
+            source: config.from.map((e) => e._.through?._.column),
+            target: (config.to ?? []).map((e) => e._.column)
+          } : {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain -- in case it's undefined, error will be thrown in Relations constructor
+            source: [config?.from?._.through?._.column],
+            // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain
+            target: [config?.to?._.through?._.column]
+          };
+        }
+        this.optional = config?.optional ?? true;
       }
     };
     __publicField(One, _a120, "OneV2");
@@ -25224,10 +25324,28 @@ Hint: you can specify "alias" on both sides of the relation with the same value`
         this.alias = config?.alias;
         this.where = config?.where;
         if (config?.from) {
-          this.sourceColumns = Array.isArray(config.from) ? config.from.map((it) => it._.column) : [config.from._.column];
+          this.sourceColumns = (Array.isArray(config.from) ? config.from : [config.from]).map((it) => {
+            this.throughTable ??= it._.through?._.column.table;
+            return it._.column;
+          });
         }
         if (config?.to) {
-          this.targetColumns = Array.isArray(config.to) ? config.to.map((it) => it._.column) : [config.to._.column];
+          this.targetColumns = (Array.isArray(config.to) ? config.to : [config.to]).map((it) => {
+            this.throughTable ??= it._.through?._.column.table;
+            return it._.column;
+          });
+        }
+        if (this.throughTable) {
+          this.through = Array.isArray(config?.from) ? {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain -- in case it's undefined, error will be thrown in Relations constructor
+            source: config.from.map((e) => e._.through?._.column),
+            target: (config.to ?? []).map((e) => e._.column)
+          } : {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain -- in case it's undefined, error will be thrown in Relations constructor
+            source: [config?.from?._.through?._.column],
+            // eslint-disable-next-line @typescript-eslint/no-non-null-asserted-optional-chain
+            target: [config?.to?._.through?._.column]
+          };
         }
       }
     };
@@ -25252,7 +25370,8 @@ Hint: you can specify "alias" on both sides of the relation with the same value`
         if (!this.query) {
           if (!this.table)
             throw new Error("Table must be set before building aggregate field");
-          this.query = sql`select count(*) as ${sql.identifier("r")} from ${this.table}`.mapWith(Number);
+          const table5 = this.table;
+          this.query = sql`select count(*) as ${sql.identifier("r")} from ${table5[IsAlias] ? sql`${sql`${sql.identifier(table5[Schema] ?? "")}.`.if(table5[Schema])}${sql.identifier(table5[OriginalName])} as ${table5}` : table5}`.mapWith(Number);
         }
         return this.query;
       }
@@ -25302,24 +25421,25 @@ Hint: you can specify "alias" on both sides of the relation with the same value`
     };
     __publicField(RelationsBuilderTable, _a124, "RelationsBuilderTable");
     _a125 = entityKind;
-    RelationsBuilderColumn = class {
-      constructor(column5) {
+    _RelationsBuilderColumn = class _RelationsBuilderColumn {
+      constructor(column5, through) {
         __publicField(this, "_");
         this._ = {
           tableName: getTableName(column5.table),
           data: void 0,
-          column: column5
+          column: column5,
+          through
         };
       }
       through(column5) {
-        this._.through = column5;
-        return this;
+        return new _RelationsBuilderColumn(this._.column, column5);
       }
       getSQL() {
         return this._.column.getSQL();
       }
     };
-    __publicField(RelationsBuilderColumn, _a125, "RelationsBuilderColumn");
+    __publicField(_RelationsBuilderColumn, _a125, "RelationsBuilderColumn");
+    RelationsBuilderColumn = _RelationsBuilderColumn;
     _a126 = entityKind;
     RelationsHelperStatic = class {
       constructor(tables) {
@@ -26076,7 +26196,7 @@ var init_dialect = __esm({
             sql`, `
           );
         });
-        __publicField(this, "buildColumns", (table5, tableConfig, selection, config) => config?.columns ? (() => {
+        __publicField(this, "buildColumns", (table5, selection, config) => config?.columns ? (() => {
           const entries = Object.entries(config.columns);
           const columnIdentifiers = [];
           let colSelectionMode;
@@ -26723,7 +26843,8 @@ var init_dialect = __esm({
         relationWhere,
         mode,
         errorPath,
-        depth
+        depth,
+        throughJoin
       }) {
         const selection = [];
         const isSingle = mode === "first";
@@ -26734,7 +26855,7 @@ var init_dialect = __esm({
         const offset = params?.offset;
         const where = params?.where && relationWhere ? and(relationsFilterToSQL(table5, params.where), relationWhere) : params?.where ? relationsFilterToSQL(table5, params.where) : relationWhere;
         const order = params?.orderBy ? relationsOrderToSQL(table5, params.orderBy) : void 0;
-        const columns = this.buildColumns(table5, tableConfig, selection, params);
+        const columns = this.buildColumns(table5, selection, params);
         const extras = params?.extras ? relationExtrasToSQL(table5, params.extras) : void 0;
         if (extras)
           selection.push(...extras.selection);
@@ -26762,10 +26883,15 @@ var init_dialect = __esm({
               const relation = tableConfig.relations[k];
               const isSingle2 = is(relation, One);
               const targetTable = aliasedTable(relation.targetTable, `d${currentDepth + 1}`);
-              const relationFilter = relationToSQL(relation, table5, targetTable);
-              selectionArr.push(
-                isSingle2 ? sql`${sql.identifier(k)}.${sql.identifier("r")} as ${sql.identifier(k)}` : sql`coalesce(${sql.identifier(k)}.${sql.identifier("r")}, '[]') as ${sql.identifier(k)}`
+              const throughTable = relation.throughTable ? aliasedTable(relation.throughTable, `tr${currentDepth}`) : void 0;
+              const { filter: filter2, joinCondition } = relationToSQL(
+                relation,
+                table5,
+                targetTable,
+                throughTable
               );
+              selectionArr.push(sql`${sql.identifier(k)}.${sql.identifier("r")} as ${sql.identifier(k)}`);
+              const throughJoin2 = throughTable ? sql` inner join ${sql`${sql.identifier(throughTable[Schema] ?? "")}.`.if(throughTable[Schema])}${sql.identifier(throughTable[OriginalName])} as ${throughTable} on ${joinCondition}` : void 0;
               const innerQuery = this.buildRelationalQuery({
                 table: targetTable,
                 mode: isSingle2 ? "first" : "many",
@@ -26774,17 +26900,20 @@ var init_dialect = __esm({
                 tableConfig: schema5[tableNamesMap[getTableUniqueName(relation.targetTable)]],
                 tableNamesMap,
                 tables,
-                relationWhere: relationFilter,
+                relationWhere: filter2,
                 errorPath: `${currentPath.length ? `${currentPath}.` : ""}${k}`,
-                depth: currentDepth + 1
+                depth: currentDepth + 1,
+                throughJoin: throughJoin2
               });
               selection.push({
                 field: targetTable,
                 key: k,
                 selection: innerQuery.selection,
-                isArray: !isSingle2
+                isArray: !isSingle2,
+                isOptional: (relation.optional ?? false) || join !== true && !!join.where
               });
-              return sql`left join lateral(select ${isSingle2 ? sql`row_to_json(${sql.identifier("t")}.*) ${sql.identifier("r")}` : sql`json_agg(row_to_json(${sql.identifier("t")}.*)) ${sql.identifier("r")}`} from (${innerQuery.sql}) as ${sql.identifier("t")}) as ${sql.identifier(k)} on true`;
+              const joinQuery = sql`left join lateral(select ${isSingle2 ? sql`row_to_json(${sql.identifier("t")}.*) ${sql.identifier("r")}` : sql`coalesce(json_agg(row_to_json(${sql.identifier("t")}.*)), '[]') as ${sql.identifier("r")}`} from (${innerQuery.sql}) as ${sql.identifier("t")}) as ${sql.identifier(k)} on true`;
+              return joinQuery;
             }),
             sql` `
           );
@@ -26797,7 +26926,7 @@ var init_dialect = __esm({
           });
         }
         const selectionSet = sql.join(selectionArr.filter((e) => e !== void 0), sql`, `);
-        const query = sql`select ${selectionSet} from ${table5[IsAlias] ? sql`${sql`${sql.identifier(table5[Schema] ?? "")}.`.if(table5[Schema])}${sql.identifier(table5[OriginalName])} as ${table5}` : table5}${sql` ${joins}`.if(joins)}${sql` where ${where}`.if(where)}${sql` order by ${order}`.if(order)}${sql` limit ${limit}`.if(limit !== void 0)}${sql` offset ${offset}`.if(offset !== void 0)}`;
+        const query = sql`select ${selectionSet} from ${table5[IsAlias] ? sql`${sql`${sql.identifier(table5[Schema] ?? "")}.`.if(table5[Schema])}${sql.identifier(table5[OriginalName])} as ${table5}` : table5}${throughJoin}${sql` ${joins}`.if(joins)}${sql` where ${where}`.if(where)}${sql` order by ${order}`.if(order)}${sql` limit ${limit}`.if(limit !== void 0)}${sql` offset ${offset}`.if(offset !== void 0)}`;
         return {
           sql: query,
           selection
@@ -32802,7 +32931,8 @@ var init_dialect2 = __esm({
         mode,
         isNested,
         errorPath,
-        depth
+        depth,
+        throughJoin
       }) {
         const selection = [];
         const isSingle = mode === "first";
@@ -32839,7 +32969,14 @@ var init_dialect2 = __esm({
               const relation = tableConfig.relations[k];
               const isSingle2 = is(relation, One);
               const targetTable = aliasedTable(relation.targetTable, `d${currentDepth + 1}`);
-              const relationFilter = relationToSQL(relation, table5, targetTable);
+              const throughTable = relation.throughTable ? aliasedTable(relation.throughTable, `tr${currentDepth}`) : void 0;
+              const { filter: filter2, joinCondition } = relationToSQL(
+                relation,
+                table5,
+                targetTable,
+                throughTable
+              );
+              const throughJoin2 = throughTable ? sql` inner join ${sql`${sql.identifier(throughTable[Schema] ?? "")}.`.if(throughTable[Schema])}${sql.identifier(throughTable[OriginalName])} as ${throughTable} on ${joinCondition}` : void 0;
               const innerQuery = this.buildRelationalQuery({
                 table: targetTable,
                 mode: isSingle2 ? "first" : "many",
@@ -32848,16 +32985,18 @@ var init_dialect2 = __esm({
                 tableConfig: schema5[tableNamesMap[getTableUniqueName(relation.targetTable)]],
                 tableNamesMap,
                 tables,
-                relationWhere: relationFilter,
+                relationWhere: filter2,
                 isNested: true,
                 errorPath: `${currentPath.length ? `${currentPath}.` : ""}${k}`,
-                depth: currentDepth + 1
+                depth: currentDepth + 1,
+                throughJoin: throughJoin2
               });
               selection.push({
                 field: targetTable,
                 key: k,
                 selection: innerQuery.selection,
-                isArray: !isSingle2
+                isArray: !isSingle2,
+                isOptional: (relation.optional ?? false) || join !== true && !!join.where
               });
               const jsonColumns = sql.join(
                 innerQuery.selection.map((s) => {
@@ -32865,7 +33004,9 @@ var init_dialect2 = __esm({
                 }),
                 sql`, `
               );
-              return isNested ? isSingle2 ? sql`(select jsonb_object(${jsonColumns}) as ${sql.identifier("r")} from (${innerQuery.sql}) as ${sql.identifier("t")}) as ${sql.identifier(k)}` : sql`coalesce((select jsonb_group_array(json_object(${jsonColumns})) as ${sql.identifier("r")} from (${innerQuery.sql}) as ${sql.identifier("t")}), jsonb_array()) as ${sql.identifier(k)}` : isSingle2 ? sql`(select json_object(${jsonColumns}) as ${sql.identifier("r")} from (${innerQuery.sql}) as ${sql.identifier("t")}) as ${sql.identifier(k)}` : sql`coalesce((select json_group_array(json_object(${jsonColumns})) as ${sql.identifier("r")} from (${innerQuery.sql}) as ${sql.identifier("t")}), jsonb_array()) as ${sql.identifier(k)}`;
+              const json4 = isNested ? sql`jsonb` : sql`json`;
+              const joinQuery = isSingle2 ? sql`(select ${json4}_object(${jsonColumns}) as ${sql.identifier("r")} from (${innerQuery.sql}) as ${sql.identifier("t")}) as ${sql.identifier(k)}` : sql`coalesce((select ${json4}_group_array(json_object(${jsonColumns})) as ${sql.identifier("r")} from (${innerQuery.sql}) as ${sql.identifier("t")}), jsonb_array()) as ${sql.identifier(k)}`;
+              return joinQuery;
             }),
             sql`, `
           );
@@ -32877,7 +33018,7 @@ var init_dialect2 = __esm({
           });
         }
         const selectionSet = sql.join(selectionArr, sql`, `);
-        const query = sql`select ${selectionSet} from ${table5[IsAlias] ? sql`${sql`${sql.identifier(table5[Schema] ?? "")}.`.if(table5[Schema])}${sql.identifier(table5[OriginalName])} as ${table5}` : table5}${sql` where ${where}`.if(where)}${sql` order by ${order}`.if(order)}${sql` limit ${limit}`.if(limit !== void 0)}${sql` offset ${offset}`.if(offset !== void 0)}`;
+        const query = sql`select ${selectionSet} from ${table5[IsAlias] ? sql`${sql`${sql.identifier(table5[Schema] ?? "")}.`.if(table5[Schema])}${sql.identifier(table5[OriginalName])} as ${table5}` : table5}${throughJoin}${sql` where ${where}`.if(where)}${sql` order by ${order}`.if(order)}${sql` limit ${limit}`.if(limit !== void 0)}${sql` offset ${offset}`.if(offset !== void 0)}`;
         return {
           sql: query,
           selection
@@ -34252,9 +34393,10 @@ var init_query4 = __esm({
     init_entity();
     init_query_promise();
     init_relations();
+    init_sql();
     _a224 = entityKind;
     RelationalQueryBuilder2 = class {
-      constructor(mode, tables, schema5, tableNamesMap, table5, tableConfig, dialect6, session) {
+      constructor(mode, tables, schema5, tableNamesMap, table5, tableConfig, dialect6, session, rowMode) {
         this.mode = mode;
         this.tables = tables;
         this.schema = schema5;
@@ -34263,6 +34405,7 @@ var init_query4 = __esm({
         this.tableConfig = tableConfig;
         this.dialect = dialect6;
         this.session = session;
+        this.rowMode = rowMode;
       }
       findMany(config) {
         return this.mode === "sync" ? new SQLiteSyncRelationalQuery2(
@@ -34274,7 +34417,8 @@ var init_query4 = __esm({
           this.dialect,
           this.session,
           config ?? true,
-          "many"
+          "many",
+          this.rowMode
         ) : new SQLiteRelationalQuery2(
           this.tables,
           this.schema,
@@ -34284,7 +34428,8 @@ var init_query4 = __esm({
           this.dialect,
           this.session,
           config ?? true,
-          "many"
+          "many",
+          this.rowMode
         );
       }
       findFirst(config) {
@@ -34297,7 +34442,8 @@ var init_query4 = __esm({
           this.dialect,
           this.session,
           config ?? true,
-          "first"
+          "first",
+          this.rowMode
         ) : new SQLiteRelationalQuery2(
           this.tables,
           this.schema,
@@ -34307,13 +34453,14 @@ var init_query4 = __esm({
           this.dialect,
           this.session,
           config ?? true,
-          "first"
+          "first",
+          this.rowMode
         );
       }
     };
     __publicField(RelationalQueryBuilder2, _a224, "SQLiteAsyncRelationalQueryBuilderV2");
     SQLiteRelationalQuery2 = class extends (_b156 = QueryPromise, _a225 = entityKind, _b156) {
-      constructor(tables, schema5, tableNamesMap, table5, tableConfig, dialect6, session, config, mode) {
+      constructor(tables, schema5, tableNamesMap, table5, tableConfig, dialect6, session, config, mode, rowMode) {
         super();
         /** @internal */
         __publicField(this, "mode");
@@ -34326,6 +34473,7 @@ var init_query4 = __esm({
         this.dialect = dialect6;
         this.session = session;
         this.config = config;
+        this.rowMode = rowMode;
         this.mode = mode;
         this.table = table5;
       }
@@ -34350,7 +34498,7 @@ var init_query4 = __esm({
           void 0,
           this.mode === "first" ? "get" : "all",
           (rawRows, mapColumnValue) => {
-            const rows = rawRows.map((row) => mapRelationalRow(row, query.selection, mapColumnValue, true));
+            const rows = rawRows.map((row) => mapRelationalRow(row, query.selection, mapColumnValue, !this.rowMode));
             if (this.mode === "first") {
               return rows[0];
             }
@@ -34362,15 +34510,26 @@ var init_query4 = __esm({
         return this._prepare(false);
       }
       _getQuery() {
-        return this.dialect.buildRelationalQuery({
+        const query = this.dialect.buildRelationalQuery({
           schema: this.schema,
           tableNamesMap: this.tableNamesMap,
           table: this.table,
           tableConfig: this.tableConfig,
           queryConfig: this.config,
           tables: this.tables,
-          mode: this.mode
+          mode: this.mode,
+          isNested: this.rowMode
         });
+        if (this.rowMode) {
+          const jsonColumns = sql.join(
+            query.selection.map((s) => {
+              return sql`${sql.raw(this.dialect.escapeString(s.key))}, ${s.selection ? sql`jsonb(${sql.identifier(s.key)})` : sql.identifier(s.key)}`;
+            }),
+            sql`, `
+          );
+          query.sql = sql`select json_object(${jsonColumns}) as ${sql.identifier("r")} from (${query.sql}) as ${sql.identifier("t")}`;
+        }
+        return query;
       }
       _toSQL() {
         const query = this._getQuery();
@@ -34453,7 +34612,7 @@ var init_db2 = __esm({
     init_raw2();
     _a228 = entityKind;
     BaseSQLiteDatabase = class {
-      constructor(resultKind, dialect6, session, relations, _schema) {
+      constructor(resultKind, dialect6, session, relations, _schema, rowModeRQB) {
         /** @deprecated */
         __publicField(this, "_query");
         // TO-DO: Figure out how to pass DrizzleTypeError without breaking withReplicas
@@ -34461,6 +34620,7 @@ var init_db2 = __esm({
         this.resultKind = resultKind;
         this.dialect = dialect6;
         this.session = session;
+        this.rowModeRQB = rowModeRQB;
         const rel = relations ?? {};
         this._ = _schema ? {
           schema: _schema.schema,
@@ -34500,7 +34660,8 @@ var init_db2 = __esm({
               relation.table,
               relation,
               dialect6,
-              session
+              session,
+              rowModeRQB
             );
           }
         }
@@ -34966,8 +35127,8 @@ var init_session2 = __esm({
     };
     __publicField(SQLiteSession, _a236, "SQLiteSession");
     SQLiteTransaction = class extends (_b160 = BaseSQLiteDatabase, _a237 = entityKind, _b160) {
-      constructor(resultType, dialect6, session, relations, schema5, nestedIndex = 0) {
-        super(resultType, dialect6, session, relations, schema5);
+      constructor(resultType, dialect6, session, relations, schema5, nestedIndex = 0, rowModeRQB) {
+        super(resultType, dialect6, session, relations, schema5, rowModeRQB);
         this.relations = relations;
         this.schema = schema5;
         this.nestedIndex = nestedIndex;
@@ -37746,9 +37907,11 @@ var init_dialect3 = __esm({
           const columnIdentifiers = [];
           const selectedColumns = this.getSelectedTableColumns(table5, params?.columns);
           for (const column5 of selectedColumns) {
-            columnIdentifiers.push(
-              sql`${table5[column5.tsName]} as ${sql.identifier(column5.tsName)}`
-            );
+            columnIdentifiers.push(sql`${column5.column} as ${sql.identifier(column5.tsName)}`);
+            selection.push({
+              key: column5.tsName,
+              field: column5.column
+            });
           }
           return columnIdentifiers.length ? sql.join(columnIdentifiers, sql`, `) : void 0;
         })() : this.unwrapAllColumns(table5, selection));
@@ -38570,7 +38733,9 @@ var init_dialect3 = __esm({
         relationWhere,
         mode,
         errorPath,
-        depth
+        depth,
+        isNested,
+        throughJoin
       }) {
         const selection = [];
         const isSingle = mode === "first";
@@ -38604,12 +38769,19 @@ var init_dialect3 = __esm({
                   key: k,
                   field: relation2
                 });
-                return sql`, lateral(${query2}) as ${sql.identifier(k)}`;
+                return sql` left join lateral (${query2}) as ${sql.identifier(k)} on true`;
               }
               const relation = tableConfig.relations[k];
               const isSingle2 = is(relation, One);
               const targetTable = aliasedTable(relation.targetTable, `d${currentDepth + 1}`);
-              const relationFilter = relationToSQL(relation, table5, targetTable);
+              const throughTable = relation.throughTable ? aliasedTable(relation.throughTable, `tr${currentDepth}`) : void 0;
+              const { filter: filter2, joinCondition } = relationToSQL(
+                relation,
+                table5,
+                targetTable,
+                throughTable
+              );
+              const throughJoin2 = throughTable ? sql` inner join ${sql`${sql.identifier(throughTable[Schema] ?? "")}.`.if(throughTable[Schema])}${sql.identifier(throughTable[OriginalName])} as ${throughTable} on ${joinCondition}` : void 0;
               const innerQuery = this.buildRelationalQuery({
                 table: targetTable,
                 mode: isSingle2 ? "first" : "many",
@@ -38618,21 +38790,25 @@ var init_dialect3 = __esm({
                 tableConfig: schema5[tableNamesMap[getTableUniqueName(relation.targetTable)]],
                 tableNamesMap,
                 tables,
-                relationWhere: relationFilter,
+                relationWhere: filter2,
                 errorPath: `${currentPath.length ? `${currentPath}.` : ""}${k}`,
-                depth: currentDepth + 1
+                depth: currentDepth + 1,
+                isNested: true,
+                throughJoin: throughJoin2
               });
               selection.push({
                 field: targetTable,
                 key: k,
                 selection: innerQuery.selection,
-                isArray: !isSingle2
+                isArray: !isSingle2,
+                isOptional: (relation.optional ?? false) || join !== true && !!join.where
               });
               const jsonColumns = sql.join(
                 innerQuery.selection.map((s) => sql`${sql.raw(this.escapeString(s.key))}, ${sql.identifier(s.key)}`),
                 sql`, `
               );
-              return sql`, lateral(select ${isSingle2 ? sql`json_object(${jsonColumns}) as ${sql.identifier("r")}` : sql`coalesce(json_arrayagg(json_object(${jsonColumns})), json_array()) as ${sql.identifier("r")}`} from (${innerQuery.sql}) as ${sql.identifier("t")}) as ${sql.identifier(k)}`;
+              const joinQuery = sql` left join lateral(select ${sql`${isSingle2 ? sql`json_object(${jsonColumns})` : sql`coalesce(json_arrayagg(json_object(${jsonColumns})), json_array())`} as ${sql.identifier("r")}`} from (${innerQuery.sql}) as ${sql.identifier("t")}) as ${sql.identifier(k)} on true`;
+              return joinQuery;
             })
           );
         })() : void 0;
@@ -38643,8 +38819,11 @@ var init_dialect3 = __esm({
             message: `No fields selected for table "${tableConfig.tsName}"${currentPath ? ` ("${currentPath}")` : ""}`
           });
         }
+        if (isNested && order) {
+          selectionArr.push(sql`row_number() over (order by ${order})`);
+        }
         const selectionSet = sql.join(selectionArr, sql`, `);
-        const query = sql`select ${selectionSet} from ${table5[IsAlias] ? sql`${sql`${sql.identifier(table5[Schema] ?? "")}.`.if(table5[Schema])}${sql.identifier(table5[OriginalName])} as ${table5}` : table5}${sql`${joins}`.if(joins)}${sql` where ${where}`.if(where)}${sql` order by ${order}`.if(order)}${sql` limit ${limit}`.if(limit !== void 0)}${sql` offset ${offset}`.if(offset !== void 0)}`;
+        const query = sql`select ${selectionSet} from ${table5[IsAlias] ? sql`${sql`${sql.identifier(table5[Schema] ?? "")}.`.if(table5[Schema])}${sql.identifier(table5[OriginalName])} as ${table5}` : table5}${throughJoin}${sql`${joins}`.if(joins)}${sql` where ${where}`.if(where)}${sql` order by ${order}`.if(order)}${sql` limit ${limit}`.if(limit !== void 0)}${sql` offset ${offset}`.if(offset !== void 0)}`;
         return {
           sql: query,
           selection