@vantreeseba/drizzle-graphql 5.6.0 → 6.0.0

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-import { is as is7 } from "drizzle-orm";
+import { is as is8 } from "drizzle-orm";
 import { MySqlDatabase } from "drizzle-orm/mysql-core";
 import { PgAsyncDatabase } from "drizzle-orm/pg-core";
 import { BaseSQLiteDatabase } from "drizzle-orm/sqlite-core";
@@ -198,15 +198,42 @@ var GraphQLDecimalString = new GraphQLScalarType({
 
 // src/util/type-converter/index.ts
 var allowedNameChars = /^[a-zA-Z0-9_]+$/;
-var enumMap = /* @__PURE__ */ new WeakMap();
+var declaredEnum = (column) => {
+  const declared = column.enum;
+  return typeof declared?.enumName === "string" ? { enumName: declared.enumName, schema: typeof declared.schema === "string" ? declared.schema : void 0 } : void 0;
+};
+var pascalize = (input) => input.split(/[^a-zA-Z0-9]+/).filter(Boolean).map((part) => capitalize(part)).join("");
+var enumValuesKey = (values) => JSON.stringify(values);
+var enumNamesInUse = /* @__PURE__ */ new Map();
+var enumNameMapper;
+var registerEnumConfig = (config) => {
+  enumNameMapper = config.enumNameMapper;
+  enumNamesInUse = /* @__PURE__ */ new Map();
+};
 var generateEnumCached = (column, columnName, tableName) => {
-  if (enumMap.has(column)) {
-    return enumMap.get(column);
+  const declared = declaredEnum(column);
+  const values = column.enumValues;
+  const name = enumNameMapper?.({
+    enumName: declared?.enumName,
+    schema: declared?.schema,
+    tableName,
+    columnName,
+    values
+  }) ?? (declared ? `${pascalize(declared.enumName)}Enum` : `${capitalize(tableName)}${capitalize(columnName)}Enum`);
+  const valuesKey = enumValuesKey(values);
+  const claimed = enumNamesInUse.get(name);
+  if (claimed) {
+    if (claimed.valuesKey !== valuesKey) {
+      throw new Error(
+        `Drizzle-GraphQL Error: Two different enums both map to the GraphQL type name '${name}' (most recently '${tableName}.${columnName}'). Give one of them a different name via config.enumNameMapper.`
+      );
+    }
+    return claimed.type;
   }
   const gqlEnum = new GraphQLEnumType({
-    name: `${capitalize(tableName)}${capitalize(columnName)}Enum`,
+    name,
     values: Object.fromEntries(
-      column.enumValues.map((e, index) => [
+      values.map((e, index) => [
         allowedNameChars.test(e) ? e : `Option${index}`,
         {
           value: e,
@@ -215,7 +242,7 @@ var generateEnumCached = (column, columnName, tableName) => {
       ])
     )
   });
-  enumMap.set(column, gqlEnum);
+  enumNamesInUse.set(name, { type: gqlEnum, valuesKey });
   return gqlEnum;
 };
 var geoXyType = new GraphQLObjectType({
@@ -236,14 +263,14 @@ var columnToGraphQLCore = (column, columnName, tableName, isInput) => {
   const dimensions = column.dimensions;
   if (dimensions !== void 0 && dimensions > 0) {
     const inner = columnBaseToGraphQLCore(column, columnName, tableName, isInput);
-    const innerDesc = inner.description ?? inner.type.name;
+    const innerLabel = inner.typeLabel ?? inner.type.name;
     let type = inner.type;
-    let description = innerDesc;
+    let typeLabel = innerLabel;
     for (let i = 0; i < dimensions; i++) {
       type = new GraphQLList(new GraphQLNonNull(type));
-      description = `Array<${description}>`;
+      typeLabel = `Array<${typeLabel}>`;
     }
-    return { type, description };
+    return { type, typeLabel };
   }
   return columnBaseToGraphQLCore(column, columnName, tableName, isInput);
 };
@@ -251,51 +278,51 @@ var columnBaseToGraphQLCore = (column, columnName, tableName, isInput) => {
   const { type: baseType, constraint } = extractExtendedColumnType(column);
   switch (baseType) {
     case "boolean":
-      return { type: GraphQLBoolean, description: "Boolean" };
+      return { type: GraphQLBoolean, typeLabel: "Boolean" };
     case "object":
       if (column instanceof PgTimestamp || column instanceof PgDate) {
-        return { type: GraphQLDateTime, description: "DateTime" };
+        return { type: GraphQLDateTime, typeLabel: "DateTime" };
       }
       return column.columnType === "PgGeometryObject" ? {
         type: isInput ? geoXyInputType : geoXyType,
-        description: "Geometry points XY"
+        typeLabel: "Geometry points XY"
       } : column.columnType === "PgBytea" ? {
         type: new GraphQLList(new GraphQLNonNull(GraphQLInt)),
-        description: "Buffer"
-      } : { type: GraphQLJSON, description: "JSON" };
+        typeLabel: "Buffer"
+      } : { type: GraphQLJSON, typeLabel: "JSON" };
     case "string":
       if (column.enumValues?.length) {
         return { type: generateEnumCached(column, columnName, tableName) };
       }
       if (constraint === "numeric" && !column.dimensions) {
-        return { type: GraphQLDecimalString, description: "Decimal" };
+        return { type: GraphQLDecimalString, typeLabel: "Decimal" };
       }
       if (column instanceof PgTimestamp || column instanceof PgTimestampString) {
-        return { type: GraphQLDateTime, description: "DateTime" };
+        return { type: GraphQLDateTime, typeLabel: "DateTime" };
       }
       if (column instanceof PgUUID) {
-        return { type: GraphQLUUID, description: "UUID" };
+        return { type: GraphQLUUID, typeLabel: "UUID" };
       }
       if (column instanceof PgDateString) {
-        return isInput ? { type: GraphQLString, description: "Date" } : { type: GraphQLDate, description: "Date" };
+        return isInput ? { type: GraphQLString, typeLabel: "Date" } : { type: GraphQLDate, typeLabel: "Date" };
       }
-      return { type: GraphQLString, description: "String" };
+      return { type: GraphQLString, typeLabel: "String" };
     case "bigint":
-      return { type: GraphQLBigIntString, description: "BigInt" };
+      return { type: GraphQLBigIntString, typeLabel: "BigInt" };
     case "number": {
-      return is(column, PgInteger) || is(column, PgSerial) || is(column, MySqlInt) || is(column, MySqlSerial) || is(column, SQLiteInteger) ? { type: GraphQLInt, description: "Integer" } : { type: GraphQLFloat, description: "Float" };
+      return is(column, PgInteger) || is(column, PgSerial) || is(column, MySqlInt) || is(column, MySqlSerial) || is(column, SQLiteInteger) ? { type: GraphQLInt, typeLabel: "Integer" } : { type: GraphQLFloat, typeLabel: "Float" };
     }
     case "array": {
       if (column.columnType === "PgVector") {
         return {
           type: new GraphQLList(new GraphQLNonNull(GraphQLFloat)),
-          description: "Array<Float>"
+          typeLabel: "Array<Float>"
         };
       }
       if (column.columnType === "PgGeometry") {
         return {
           type: new GraphQLList(new GraphQLNonNull(GraphQLFloat)),
-          description: "Tuple<[Float, Float]>"
+          typeLabel: "Tuple<[Float, Float]>"
         };
       }
       const innerType = columnToGraphQLCore(
@@ -306,7 +333,7 @@ var columnBaseToGraphQLCore = (column, columnName, tableName, isInput) => {
       );
       return {
         type: new GraphQLList(new GraphQLNonNull(innerType.type)),
-        description: `Array<${innerType.description}>`
+        typeLabel: `Array<${innerType.typeLabel}>`
       };
     }
     default:
@@ -362,24 +389,14 @@ var registerScalarOverrides = (tables, config) => {
 };
 var drizzleColumnToGraphQLType = (column, columnName, tableName, forceNullable = false, defaultIsNullable = false, isInput = false) => {
   const override = getColumnScalarOverride(column, isInput);
-  let typeDesc;
-  if (override) {
-    typeDesc = { type: override, description: override.name };
-  } else {
-    typeDesc = columnToGraphQLCore(column, columnName, tableName, isInput);
-    const noDesc = ["string", "boolean", "number"];
-    const { type: baseType } = extractExtendedColumnType(column);
-    if (noDesc.find((e) => e === baseType)) {
-      delete typeDesc.description;
-    }
-  }
+  const typeDesc = override ? { type: override, typeLabel: override.name } : columnToGraphQLCore(column, columnName, tableName, isInput);
   if (forceNullable) {
     return typeDesc;
   }
   if (column.notNull && !(defaultIsNullable && (column.hasDefault || column.defaultFn))) {
     return {
       type: new GraphQLNonNull(typeDesc.type),
-      description: typeDesc.description
+      typeLabel: typeDesc.typeLabel
     };
   }
   return typeDesc;
@@ -962,6 +979,22 @@ var createRelationResolverFactory = (db, tables, filterCtx) => ({ tableName, rel
     return loader.load(localValue);
   };
 };
+var columnDocs = (docs, column, tableName, columnName) => {
+  const description = docs.describeColumn?.(column, { tableName, columnName });
+  const deprecationReason = docs.deprecateColumn?.(column, { tableName, columnName });
+  return {
+    ...description !== void 0 ? { description } : {},
+    ...deprecationReason !== void 0 ? { deprecationReason } : {}
+  };
+};
+var inputFieldDocs = (docs, column, tableName, columnName, fieldType) => {
+  const resolved = columnDocs(docs, column, tableName, columnName);
+  if (resolved.deprecationReason !== void 0 && fieldType instanceof GraphQLNonNull2) {
+    const { deprecationReason: _dropped, ...rest } = resolved;
+    return rest;
+  }
+  return resolved;
+};
 var listFieldComplexity = (options) => ({ args, childComplexity }) => {
   const limit = args["limit"];
   const rows = typeof limit === "number" && limit > 0 ? limit : options.defaultListSize;
@@ -969,18 +1002,21 @@ var listFieldComplexity = (options) => ({ args, childComplexity }) => {
 };
 var aggregateFieldComplexity = (options) => ({ childComplexity }) => options.aggregateCost + childComplexity;
 var AGGREGATE_FIELD_SUFFIX = "Aggregate";
-var relationAggregateJoinColumns = (tree, table, selectionCtx) => {
-  const relations = selectionCtx?.relationMap[selectionCtx.tableName];
-  if (!relations || !selectionCtx) {
+var relationJoinColumns = (tree, table, selectionCtx) => {
+  if (!selectionCtx) {
+    return [];
+  }
+  const relations = (selectionCtx.allRelations ?? selectionCtx.relationMap)[selectionCtx.tableName] ?? selectionCtx.relationMap[selectionCtx.tableName];
+  if (!relations) {
     return [];
   }
   const tableColumns = getColumns(table);
   const needed = [];
   for (const fieldData of Object.values(tree)) {
-    if (tableColumns[fieldData.name] || !fieldData.name.endsWith(AGGREGATE_FIELD_SUFFIX)) {
+    if (tableColumns[fieldData.name]) {
       continue;
     }
-    const relEntry = relations[fieldData.name.slice(0, -AGGREGATE_FIELD_SUFFIX.length)];
+    const relEntry = fieldData.name.endsWith(AGGREGATE_FIELD_SUFFIX) ? relations[fieldData.name.slice(0, -AGGREGATE_FIELD_SUFFIX.length)] : relations[fieldData.name];
     const targetTable = relEntry ? selectionCtx.tables[relEntry.targetTableName] : void 0;
     if (!relEntry || !targetTable) {
       continue;
@@ -1002,7 +1038,7 @@ var extractSelectedColumnsFromTree = (tree, table, selectionCtx) => {
     }
     selectedColumns.push([fieldData.name, true]);
   }
-  for (const columnName of relationAggregateJoinColumns(tree, table, selectionCtx)) {
+  for (const columnName of relationJoinColumns(tree, table, selectionCtx)) {
     selectedColumns.push([columnName, true]);
   }
   if (!selectedColumns.length) {
@@ -1022,7 +1058,7 @@ var extractSelectedColumnsFromTreeSQLFormat = (tree, table, selectionCtx) => {
     }
     selectedColumns.push([fieldData.name, tableColumns[fieldData.name]]);
   }
-  for (const columnName of relationAggregateJoinColumns(tree, table, selectionCtx)) {
+  for (const columnName of relationJoinColumns(tree, table, selectionCtx)) {
     selectedColumns.push([columnName, tableColumns[columnName]]);
   }
   if (!selectedColumns.length) {
@@ -1143,21 +1179,23 @@ var jsonFilterFields = (column, colType) => {
     isNotNull: { type: GraphQLBoolean2 }
   };
 };
-var arrayFilterFields = (colType, colArr, colDesc) => {
+var IN_ARRAY_DESCRIPTION = "Matches any one of these values (SQL `IN`)";
+var NOT_IN_ARRAY_DESCRIPTION = "Matches none of these values (SQL `NOT IN`)";
+var arrayFilterFields = (colType, colArr) => {
   let element = colType.ofType;
   if (element instanceof GraphQLNonNull2) {
     element = element.ofType;
   }
   const elementList = new GraphQLList2(new GraphQLNonNull2(element));
   return {
-    eq: { type: colType, description: colDesc },
-    ne: { type: colType, description: colDesc },
+    eq: { type: colType, description: "The whole array equals this array" },
+    ne: { type: colType, description: "The whole array differs from this array" },
     has: { type: element, description: "Array contains this element" },
     hasSome: { type: elementList, description: "Array contains at least one of these elements (overlap, `&&`)" },
     hasEvery: { type: elementList, description: "Array contains every one of these elements (containment, `@>`)" },
     isEmpty: { type: GraphQLBoolean2, description: "When true, matches arrays with no elements" },
-    inArray: { type: colArr, description: `Array<${colDesc}>` },
-    notInArray: { type: colArr, description: `Array<${colDesc}>` },
+    inArray: { type: colArr, description: IN_ARRAY_DESCRIPTION },
+    notInArray: { type: colArr, description: NOT_IN_ARRAY_DESCRIPTION },
     isNull: { type: GraphQLBoolean2 },
     isNotNull: { type: GraphQLBoolean2 }
   };
@@ -1193,18 +1231,17 @@ var generateColumnFilterValues = (column, tableName, columnName, cacheCtx) => {
     return cached;
   }
   const colType = columnGraphQLType.type;
-  const colDesc = columnGraphQLType.description;
   const colArr = new GraphQLList2(new GraphQLNonNull2(colType));
   const customOverrideFilter = inputOverride !== void 0 && !BUILTIN_FILTER_SCALARS.has(inputOverride);
   const underlying = extractExtendedColumnType2(column);
   const omitStringOps = customOverrideFilter ? underlying.type !== "string" || underlying.constraint === "numeric" : FILTERS_WITHOUT_STRING_OPS.has(genericName);
-  const baseFields = kind === "json" ? jsonFilterFields(column, colType) : kind === "array" ? arrayFilterFields(colType, colArr, colDesc) : {
-    eq: { type: colType, description: colDesc },
-    ne: { type: colType, description: colDesc },
-    lt: { type: colType, description: colDesc },
-    lte: { type: colType, description: colDesc },
-    gt: { type: colType, description: colDesc },
-    gte: { type: colType, description: colDesc },
+  const baseFields = kind === "json" ? jsonFilterFields(column, colType) : kind === "array" ? arrayFilterFields(colType, colArr) : {
+    eq: { type: colType, description: "Equal to" },
+    ne: { type: colType, description: "Not equal to" },
+    lt: { type: colType, description: "Less than" },
+    lte: { type: colType, description: "Less than or equal to" },
+    gt: { type: colType, description: "Greater than" },
+    gte: { type: colType, description: "Greater than or equal to" },
     ...omitStringOps ? {} : {
       like: { type: GraphQLString2 },
       notLike: { type: GraphQLString2 },
@@ -1235,10 +1272,10 @@ var generateColumnFilterValues = (column, tableName, columnName, cacheCtx) => {
         description: "Case-insensitive `contains`."
       }
     },
-    inArray: { type: colArr, description: `Array<${colDesc}>` },
-    notInArray: { type: colArr, description: `Array<${colDesc}>` },
-    isNull: { type: GraphQLBoolean2 },
-    isNotNull: { type: GraphQLBoolean2 }
+    inArray: { type: colArr, description: IN_ARRAY_DESCRIPTION },
+    notInArray: { type: colArr, description: NOT_IN_ARRAY_DESCRIPTION },
+    isNull: { type: GraphQLBoolean2, description: "When true, matches rows where the column is NULL" },
+    isNotNull: { type: GraphQLBoolean2, description: "When true, matches rows where the column is not NULL" }
   };
   const mainType = new GraphQLInputObjectType2({
     name: `${genericName}Filter`,
@@ -1285,10 +1322,14 @@ var generateTableFilterValuesCached = (table, tableName, cacheCtx) => {
   const columns = getColumns(table);
   const columnEntries = Object.entries(columns);
   const remapped = Object.fromEntries(
-    columnEntries.map(([columnName, columnDescription]) => [
+    columnEntries.map(([columnName, column]) => [
       columnName,
       {
-        type: generateColumnFilterValues(columnDescription, tableName, columnName, cacheCtx)
+        type: generateColumnFilterValues(column, tableName, columnName, cacheCtx),
+        // A filter field is the same column, so it carries the same documentation. Deprecation
+        // is not propagated: filtering on a deprecated column is how a caller finds the rows
+        // that still use it.
+        ...cacheCtx.docs.describeColumn ? { description: cacheCtx.docs.describeColumn(column, { tableName, columnName }) } : {}
       }
     ])
   );
@@ -1302,9 +1343,12 @@ var generateTableSelectTypeFieldsCached = (table, tableName, cacheCtx) => {
   const columns = getColumns(table);
   const columnEntries = Object.entries(columns);
   const remapped = Object.fromEntries(
-    columnEntries.map(([columnName, columnDescription]) => [
+    columnEntries.map(([columnName, column]) => [
       columnName,
-      drizzleColumnToGraphQLType(columnDescription, columnName, tableName)
+      {
+        ...drizzleColumnToGraphQLType(column, columnName, tableName),
+        ...columnDocs(cacheCtx.docs, column, tableName, columnName)
+      }
     ])
   );
   if (!remapped[CURSOR_FIELD_NAME]) {
@@ -1501,6 +1545,7 @@ var generateSelectFields = (tables, tableName, relationMap, fromTableName, fromR
     const typeName = resolveTypeName(tableName, typeNameMapper);
     const shell = new GraphQLObjectType2({
       name: typeName,
+      description: cacheCtx.docs.describeTable?.(tableName),
       fields: () => ({ ...tableFields, ...container.fields })
     });
     cacheCtx.objectTypeCache.set(tableName, shell);
@@ -1542,11 +1587,14 @@ var generateSelectFields = (tables, tableName, relationMap, fromTableName, fromR
         const capturedTargetContainer = targetContainer;
         relType = new GraphQLObjectType2({
           name: resolveTypeName(targetTableName, typeNameMapper),
+          description: cacheCtx.docs.describeTable?.(targetTableName),
           fields: () => ({ ...targetTableFields, ...capturedTargetContainer.fields })
         });
         cacheCtx.objectTypeCache.set(targetTableName, relType);
       }
       const resolve = resolverFactory?.({ tableName, relationName, relEntry, isOne });
+      const relationDescription = cacheCtx.docs.describeRelation?.(tableName, relationName);
+      const relationDocs = relationDescription !== void 0 ? { description: relationDescription } : {};
       if (isOne) {
         const isRequired = relation.optional === false;
         rawRelationFields.push([
@@ -1556,7 +1604,8 @@ var generateSelectFields = (tables, tableName, relationMap, fromTableName, fromR
             args: {
               where: { type: relSelectData.filters }
             },
-            resolve
+            resolve,
+            ...relationDocs
           }
         ]);
         continue;
@@ -1572,6 +1621,7 @@ var generateSelectFields = (tables, tableName, relationMap, fromTableName, fromR
             limit: { type: GraphQLInt2 }
           },
           resolve,
+          ...relationDocs,
           ...cacheCtx.complexity ? { extensions: { complexity: listFieldComplexity(cacheCtx.complexity) } } : {}
         }
       ]);
@@ -1619,7 +1669,7 @@ var generateSelectFields = (tables, tableName, relationMap, fromTableName, fromR
     relationFields: {}
   };
 };
-var generateTableTypes = (tableName, tables, relationMap, withReturning, relationsDepthLimit, cacheCtx, typeNameMapper = void 0, insertPrefix = "create", updatePrefix = "update", resolverFactory, relationAggregateFactory) => {
+var generateTableTypes = (tableName, tables, relationMap, withReturning, relationsDepthLimit, cacheCtx, typeNameMapper = void 0, insertPrefix = "create", updatePrefix = "update", resolverFactory, relationAggregateFactory, nestedWrites) => {
   const { tableFields, relationFields, filters, order } = generateSelectFields(
     tables,
     tableName,
@@ -1640,28 +1690,44 @@ var generateTableTypes = (tableName, tables, relationMap, withReturning, relatio
   const table = tables[tableName];
   const columns = getColumns(table);
   const columnEntries = Object.entries(columns);
+  const relaxedColumns = nestedWrites?.relaxedColumns(tableName);
   const insertFields = Object.fromEntries(
-    columnEntries.map(([columnName, columnDescription]) => [
-      columnName,
-      drizzleColumnToGraphQLType(columnDescription, columnName, tableName, false, true, true)
-    ])
+    columnEntries.map(([columnName, column]) => {
+      const converted = drizzleColumnToGraphQLType(
+        column,
+        columnName,
+        tableName,
+        !!relaxedColumns?.has(columnName),
+        true,
+        true
+      );
+      return [
+        columnName,
+        { ...converted, ...inputFieldDocs(cacheCtx.docs, column, tableName, columnName, converted.type) }
+      ];
+    })
   );
   const updateFields = Object.fromEntries(
-    columnEntries.map(([columnName, columnDescription]) => [
-      columnName,
-      drizzleColumnToGraphQLType(columnDescription, columnName, tableName, true, false, true)
-    ])
+    columnEntries.map(([columnName, column]) => {
+      const converted = drizzleColumnToGraphQLType(column, columnName, tableName, true, false, true);
+      return [
+        columnName,
+        { ...converted, ...inputFieldDocs(cacheCtx.docs, column, tableName, columnName, converted.type) }
+      ];
+    })
   );
+  const typeName = resolveTypeName(tableName, typeNameMapper);
   const insertInput = new GraphQLInputObjectType2({
-    name: `${capitalize(insertPrefix)}${resolveTypeName(tableName, typeNameMapper)}Input`,
-    fields: insertFields
+    name: `${capitalize(insertPrefix)}${typeName}Input`,
+    fields: nestedWrites ? () => ({ ...insertFields, ...nestedWrites.createFields(tableName, typeName) }) : insertFields
   });
   const updateInput = new GraphQLInputObjectType2({
-    name: `${capitalize(updatePrefix)}${resolveTypeName(tableName, typeNameMapper)}Input`,
-    fields: updateFields
+    name: `${capitalize(updatePrefix)}${typeName}Input`,
+    fields: nestedWrites ? () => ({ ...updateFields, ...nestedWrites.updateFields(tableName, typeName) }) : updateFields
   });
   const selectSingleOutput = cacheCtx.objectTypeCache.get(tableName) ?? new GraphQLObjectType2({
     name: resolveTypeName(tableName, typeNameMapper),
+    description: cacheCtx.docs.describeTable?.(tableName),
     fields: { ...tableFields, ...relationFields }
   });
   const selectArrOutput = new GraphQLNonNull2(new GraphQLList2(new GraphQLNonNull2(selectSingleOutput)));
@@ -2053,6 +2119,13 @@ var extractRelationsParamsInner = (relationMap, tables, tableName, typeName, ori
     if (!field) {
       continue;
     }
+    const selectionCount = Object.values(baseField).reduce(
+      (n, f) => n + (f.name === relName ? 1 : 0),
+      0
+    );
+    if (selectionCount > 1) {
+      continue;
+    }
     const relField = field?.fieldsByTypeName;
     const relFieldSelection = relField?.[relTypeName];
     if (!relFieldSelection) {
@@ -2061,7 +2134,8 @@ var extractRelationsParamsInner = (relationMap, tables, tableName, typeName, ori
     const columns = extractSelectedColumnsFromTree(relFieldSelection, tables[targetTableName], {
       tableName: targetTableName,
       relationMap,
-      tables
+      tables,
+      allRelations: filterCtx?.relationMap
     });
     const thisRecord = {};
     thisRecord.columns = columns;
@@ -2667,7 +2741,8 @@ var runRelationalSelect = async (opts) => {
     columns: extractSelectedColumnsFromTree(parsedInfo.fieldsByTypeName[typeName], table, {
       tableName,
       relationMap,
-      tables
+      tables,
+      allRelations: filterCtx?.relationMap
     }),
     offset: distinctKeys ? void 0 : offset,
     // drizzle-orm v1 RQB calls orderBy/where with the aliased table proxy — use it
@@ -2879,9 +2954,9 @@ var generateAggregateTypes = (table, tableName, typeName, cacheCtx) => {
         type: new GraphQLObjectType3({
           name: `${typeName}${capitalize(op)}Aggregate`,
           fields: Object.fromEntries(
-            Object.entries(orderable).map(([columnName, { converted }]) => [
+            Object.entries(orderable).map(([columnName, { column, converted }]) => [
               columnName,
-              { type: converted.type, description: converted.description }
+              { type: converted.type, ...columnDocs(cacheCtx?.docs ?? {}, column, tableName, columnName) }
             ])
           )
         })
@@ -2928,7 +3003,7 @@ var aggregateTarget = (table, tableName, typeName) => {
     typeName,
     columns: getColumns2(table),
     dateTimeColumns: new Set(
-      Object.entries(orderable).filter(([, { converted }]) => converted.description === "DateTime").map(([columnName]) => columnName)
+      Object.entries(orderable).filter(([, { converted }]) => converted.typeLabel === "DateTime").map(([columnName]) => columnName)
     )
   };
 };
@@ -3146,9 +3221,9 @@ var generateGroupByType = (table, tableName, typeName, cacheCtx) => {
     name: `${typeName}GroupKeys`,
     description: `The grouped column values of one ${typeName} group. A column the query did not group by is null.`,
     fields: Object.fromEntries(
-      Object.entries(groupable).map(([columnName, { converted }]) => [
+      Object.entries(groupable).map(([columnName, { column, converted }]) => [
         columnName,
-        { type: converted.type, description: converted.description }
+        { type: converted.type, ...columnDocs(cacheCtx?.docs ?? {}, column, tableName, columnName) }
       ])
     )
   });
@@ -3548,7 +3623,13 @@ var generateSchemaData = (db, schema, relations, options) => {
       "Drizzle-GraphQL Error: No tables detected in Drizzle-ORM's database instance. Did you forget to pass schema to drizzle constructor?"
     );
   }
+  if (features.nestedWrites) {
+    throw new Error(
+      "Drizzle-GraphQL Error: features.nestedWrites is not supported on MySQL \u2014 a nested write needs the parent row it just inserted returned to it, and MySQL has no RETURNING clause."
+    );
+  }
   registerScalarOverrides(tables, options);
+  registerEnumConfig(options);
   const namedRelations = buildNamedRelations(relations ?? {}, tableEntries);
   attachTargetPrimaryKeys(namedRelations, tables, mysqlPrimaryKeyPropNames);
   const eagerRelations = pruneNonEagerRelations(namedRelations, shouldEagerLoad);
@@ -3566,7 +3647,8 @@ var generateSchemaData = (db, schema, relations, options) => {
     filterTypeCache: /* @__PURE__ */ new WeakMap(),
     listRelationFilterCache: /* @__PURE__ */ new Map(),
     aggregateTypeCache: /* @__PURE__ */ new Map(),
-    complexity
+    complexity,
+    docs: options.docs ?? {}
   };
   const relationAggregateFactory = features.relationAggregates ? createRelationAggregateFactory(db, tables, cacheCtx, typeNameMapper, filterCtx) : void 0;
   const queries = {};
@@ -3858,14 +3940,399 @@ var generateSchemaData = (db, schema, relations, options) => {
 };
 
 // src/util/builders/pg.ts
-import { and as and3, getColumns as getColumns3, is as is5, One as One4 } from "drizzle-orm";
+import { and as and4, getColumns as getColumns4, is as is6, One as One5 } from "drizzle-orm";
 import { getTableConfig as getTableConfig2, PgTable } from "drizzle-orm/pg-core";
 import {
+  GraphQLError as GraphQLError7,
+  GraphQLList as GraphQLList6,
+  GraphQLNonNull as GraphQLNonNull6
+} from "graphql";
+import { parseResolveInfo as parseResolveInfo3 } from "graphql-parse-resolve-info";
+
+// src/util/builders/nested-writes.ts
+import { and as and3, eq as eq3, getColumns as getColumns3, is as is5, One as One4 } from "drizzle-orm";
+import {
+  GraphQLBoolean as GraphQLBoolean4,
   GraphQLError as GraphQLError6,
+  GraphQLInputObjectType as GraphQLInputObjectType4,
   GraphQLList as GraphQLList5,
   GraphQLNonNull as GraphQLNonNull5
 } from "graphql";
-import { parseResolveInfo as parseResolveInfo3 } from "graphql-parse-resolve-info";
+var isOptionalOnInsert = (column) => !column.notNull || !!column.hasDefault || !!column.defaultFn;
+var buildNestedWritePlans = (tables, relationMap, resolveUniqueSets, resolvePrimaryKeys, extractJoinColumns) => {
+  const uniqueCache = /* @__PURE__ */ new Map();
+  const singleColumnUniques = (tableName, table) => {
+    let cached = uniqueCache.get(tableName);
+    if (!cached) {
+      cached = new Set(
+        resolveUniqueSets(table).filter((set) => set.length === 1).map((set) => set[0])
+      );
+      uniqueCache.set(tableName, cached);
+    }
+    return cached;
+  };
+  const pkCache = /* @__PURE__ */ new Map();
+  const singleColumnPk = (tableName, table) => {
+    if (!pkCache.has(tableName)) {
+      const pk = resolvePrimaryKeys(table);
+      pkCache.set(tableName, pk.length === 1 ? pk[0] : void 0);
+    }
+    return pkCache.get(tableName);
+  };
+  const plans = {};
+  for (const [tableName, relations] of Object.entries(relationMap)) {
+    const table = tables[tableName];
+    if (!table) {
+      continue;
+    }
+    const tablePlans = {};
+    for (const [relationName, relEntry] of Object.entries(relations)) {
+      const relation = relEntry.relation;
+      if (relation.through) {
+        continue;
+      }
+      const targetTableName = relEntry.targetTableName;
+      const targetTable = tables[targetTableName];
+      if (!targetTable) {
+        continue;
+      }
+      const joinColumns = extractJoinColumns(relEntry, table, targetTable);
+      if (!joinColumns) {
+        continue;
+      }
+      const { localColPropName, foreignCol, foreignColPropName } = joinColumns;
+      const localCol = getColumns3(table)[localColPropName];
+      if (!localCol) {
+        continue;
+      }
+      const isOne = is5(relation, One4);
+      const localIsPk = singleColumnPk(tableName, table) === localColPropName;
+      const foreignIsPk = singleColumnPk(targetTableName, targetTable) === foreignColPropName;
+      const localIsUnique = singleColumnUniques(tableName, table).has(localColPropName);
+      const foreignIsUnique = singleColumnUniques(targetTableName, targetTable).has(foreignColPropName);
+      let fkSide;
+      if (!isOne) {
+        fkSide = "child";
+      } else if (foreignIsPk && !localIsPk) {
+        fkSide = "parent";
+      } else if (localIsPk) {
+        fkSide = "child";
+      } else if (foreignIsUnique) {
+        fkSide = "parent";
+      } else if (localIsUnique) {
+        fkSide = "child";
+      } else {
+        continue;
+      }
+      const fkColumn = fkSide === "child" ? foreignCol : localCol;
+      tablePlans[relationName] = {
+        relationName,
+        targetTableName,
+        targetTable,
+        localColPropName,
+        foreignColPropName,
+        foreignCol,
+        localCol,
+        isOne,
+        fkSide,
+        canDetach: !fkColumn.notNull
+      };
+    }
+    if (Object.keys(tablePlans).length) {
+      plans[tableName] = tablePlans;
+    }
+  }
+  return plans;
+};
+var NO_COLUMNS = /* @__PURE__ */ new Set();
+var createNestedWriteTypes = (params) => {
+  const { plans, cacheCtx, typeNameMapper, insertPrefix } = params;
+  const wrapperCache = /* @__PURE__ */ new Map();
+  const payloadCache = /* @__PURE__ */ new Map();
+  const payloadType = (tableName, typeName, plan) => {
+    const key = `${tableName}.${plan.relationName}`;
+    const cached = payloadCache.get(key);
+    if (cached) {
+      return cached;
+    }
+    const omitted = plan.fkSide === "child" ? plan.foreignColPropName : void 0;
+    const fields = Object.fromEntries(
+      Object.entries(getColumns3(plan.targetTable)).filter(([columnName]) => columnName !== omitted).map(([columnName, column]) => [
+        columnName,
+        drizzleColumnToGraphQLType(column, columnName, plan.targetTableName, false, true, true)
+      ])
+    );
+    const type = new GraphQLInputObjectType4({
+      name: `${capitalize(insertPrefix)}${typeName}${capitalize(plan.relationName)}Input`,
+      description: omitted === void 0 ? `A new ${resolveTypeName(plan.targetTableName, typeNameMapper)} row for ${typeName}.${plan.relationName}` : `A new ${resolveTypeName(plan.targetTableName, typeNameMapper)} row for ${typeName}.${plan.relationName}. \`${omitted}\` is set from the ${typeName} row this is written with.`,
+      fields
+    });
+    payloadCache.set(key, type);
+    return type;
+  };
+  const targetFilters = (plan) => cacheCtx.filterTypeCache.get(plan.targetTable);
+  const listOf = (type) => new GraphQLList5(new GraphQLNonNull5(type));
+  const wrapperType = (tableName, typeName, plan, forUpdate) => {
+    const key = `${tableName}.${plan.relationName}.${forUpdate ? "update" : "create"}`;
+    const cached = wrapperCache.get(key);
+    if (cached) {
+      return cached;
+    }
+    const filters = targetFilters(plan);
+    const payload = payloadType(tableName, typeName, plan);
+    const targetTypeName = resolveTypeName(plan.targetTableName, typeNameMapper);
+    const fields = {};
+    if (plan.isOne) {
+      fields["create"] = { type: payload, description: `Insert a ${targetTypeName} row and attach it` };
+      if (filters) {
+        fields["connect"] = {
+          type: filters,
+          description: `Attach the existing ${targetTypeName} row this matches. Must match exactly one row.`
+        };
+      }
+      if (forUpdate && plan.canDetach) {
+        fields["disconnect"] = {
+          type: GraphQLBoolean4,
+          description: `Detach the currently attached ${targetTypeName} row, leaving it in place`
+        };
+      }
+    } else {
+      fields["create"] = { type: listOf(payload), description: `Insert these ${targetTypeName} rows and attach them` };
+      if (filters) {
+        fields["connect"] = {
+          type: listOf(filters),
+          description: `Attach every existing ${targetTypeName} row these match`
+        };
+        if (forUpdate && plan.canDetach) {
+          fields["disconnect"] = {
+            type: listOf(filters),
+            description: `Detach every attached ${targetTypeName} row these match, leaving the rows in place`
+          };
+          fields["set"] = {
+            type: listOf(filters),
+            description: `Replace the whole set: detach everything attached, then attach every ${targetTypeName} row these match. Applied before \`disconnect\`, \`connect\` and \`create\`.`
+          };
+        }
+      }
+    }
+    const type = new GraphQLInputObjectType4({
+      name: `${typeName}${capitalize(plan.relationName)}Nested${forUpdate ? "Update" : "Create"}Input`,
+      description: `Writes through ${typeName}.${plan.relationName}`,
+      fields
+    });
+    wrapperCache.set(key, type);
+    return type;
+  };
+  const relationFields = (tableName, typeName, forUpdate) => {
+    const tablePlans = plans[tableName];
+    if (!tablePlans) {
+      return {};
+    }
+    return Object.fromEntries(
+      Object.values(tablePlans).flatMap((plan) => {
+        const wrapper = wrapperType(tableName, typeName, plan, forUpdate);
+        return wrapper ? [[plan.relationName, { type: wrapper, description: `Writes through ${typeName}.${plan.relationName}` }]] : [];
+      })
+    );
+  };
+  return {
+    createFields: (tableName, typeName) => relationFields(tableName, typeName, false),
+    updateFields: (tableName, typeName) => relationFields(tableName, typeName, true),
+    relaxedColumns: (tableName) => {
+      const tablePlans = plans[tableName];
+      if (!tablePlans) {
+        return NO_COLUMNS;
+      }
+      const relaxed = /* @__PURE__ */ new Set();
+      for (const plan of Object.values(tablePlans)) {
+        if (plan.fkSide === "parent" && !isOptionalOnInsert(plan.localCol)) {
+          relaxed.add(plan.localColPropName);
+        }
+      }
+      return relaxed.size ? relaxed : NO_COLUMNS;
+    }
+  };
+};
+var mergedOps = (entries) => Object.assign({}, ...entries.map((entry) => entry.ops));
+var asArray = (value) => Array.isArray(value) ? value : value === void 0 ? [] : [value];
+var createNestedWriteRuntime = (params) => {
+  const { plans, filterCtx } = params;
+  const conditionOf = (plan, filter, operation) => {
+    const condition = extractFilters(
+      plan.targetTable,
+      plan.targetTableName,
+      filter,
+      relationFilterCtx(filterCtx, plan.targetTableName)
+    );
+    if (!condition) {
+      throw new GraphQLError6(
+        `Drizzle-GraphQL Error: '${operation}' on '${plan.relationName}' needs a filter that selects rows \u2014 it was given one that matches everything.`
+      );
+    }
+    return condition;
+  };
+  const assertSingleOperation = (plan, op) => {
+    const supplied = ["create", "connect", "disconnect"].filter((key) => op[key] !== void 0 && op[key] !== null);
+    if (supplied.length > 1) {
+      throw new GraphQLError6(
+        `Drizzle-GraphQL Error: '${plan.relationName}' takes one of ${supplied.join(", ")} at a time \u2014 it holds a single row.`
+      );
+    }
+  };
+  const detachAll = async (executor, plan, key) => executor.update(plan.targetTable).set({ [plan.foreignColPropName]: null }).where(eq3(plan.foreignCol, key));
+  return {
+    enabled: (tableName) => !!plans[tableName],
+    split: (tableName, values) => {
+      const tablePlans = plans[tableName];
+      if (!tablePlans) {
+        return { columns: values, ops: {} };
+      }
+      const columns = {};
+      const ops = {};
+      for (const [key, value] of Object.entries(values)) {
+        if (tablePlans[key] && value !== void 0 && value !== null) {
+          ops[key] = value;
+        } else if (!tablePlans[key]) {
+          columns[key] = value;
+        }
+      }
+      return { columns, ops };
+    },
+    hasOps: (ops) => Object.keys(ops).length > 0,
+    withJoinColumns: (tableName, ops, columns, table) => {
+      const tablePlans = plans[tableName];
+      if (!tablePlans) {
+        return columns;
+      }
+      const allColumns = getColumns3(table);
+      for (const relationName of Object.keys(ops)) {
+        const plan = tablePlans[relationName];
+        if (plan?.fkSide === "child" && !(plan.localColPropName in columns) && allColumns[plan.localColPropName]) {
+          columns[plan.localColPropName] = allColumns[plan.localColPropName];
+        }
+      }
+      return columns;
+    },
+    applyParentSide: async (executor, tableName, ops) => {
+      const tablePlans = plans[tableName];
+      const patch = {};
+      if (!tablePlans) {
+        return patch;
+      }
+      for (const [relationName, op] of Object.entries(ops)) {
+        const plan = tablePlans[relationName];
+        if (!plan || plan.fkSide !== "parent") {
+          continue;
+        }
+        assertSingleOperation(plan, op);
+        if (op["create"] !== void 0) {
+          const values = remapFromGraphQLSingleInput({ ...op["create"] }, plan.targetTable);
+          const inserted = await executor.insert(plan.targetTable).values(values).returning();
+          const created = inserted[0];
+          if (!created) {
+            throw new GraphQLError6(
+              `Drizzle-GraphQL Error: 'create' on '${relationName}' inserted no row, so there is nothing to attach.`
+            );
+          }
+          patch[plan.localColPropName] = created[plan.foreignColPropName];
+        } else if (op["connect"] !== void 0) {
+          const rows = await executor.select().from(plan.targetTable).where(conditionOf(plan, op["connect"], "connect"));
+          if (rows.length !== 1) {
+            throw new GraphQLError6(
+              `Drizzle-GraphQL Error: 'connect' on '${relationName}' matched ${rows.length} rows \u2014 it attaches a single row, so its filter must match exactly one.`
+            );
+          }
+          patch[plan.localColPropName] = rows[0][plan.foreignColPropName];
+        } else if (op["disconnect"] === true) {
+          patch[plan.localColPropName] = null;
+        }
+      }
+      return patch;
+    },
+    applyChildSide: async (executor, tableName, ops, parentRows) => {
+      const tablePlans = plans[tableName];
+      if (!tablePlans) {
+        return;
+      }
+      for (const [relationName, op] of Object.entries(ops)) {
+        const plan = tablePlans[relationName];
+        if (!plan || plan.fkSide !== "child") {
+          continue;
+        }
+        if (plan.isOne) {
+          assertSingleOperation(plan, op);
+        }
+        for (const parentRow of parentRows) {
+          const key = parentRow?.[plan.localColPropName];
+          if (key === void 0 || key === null) {
+            throw new GraphQLError6(
+              `Drizzle-GraphQL Error: cannot write through '${relationName}': the ${tableName} row has no '${plan.localColPropName}' value to attach to.`
+            );
+          }
+          if (op["set"] !== void 0) {
+            await detachAll(executor, plan, key);
+            for (const filter of asArray(op["set"])) {
+              await executor.update(plan.targetTable).set({ [plan.foreignColPropName]: key }).where(conditionOf(plan, filter, "set"));
+            }
+          }
+          if (op["disconnect"] !== void 0) {
+            if (plan.isOne) {
+              if (op["disconnect"] === true) {
+                await detachAll(executor, plan, key);
+              }
+            } else {
+              for (const filter of asArray(op["disconnect"])) {
+                await executor.update(plan.targetTable).set({ [plan.foreignColPropName]: null }).where(and3(eq3(plan.foreignCol, key), conditionOf(plan, filter, "disconnect")));
+              }
+            }
+          }
+          const attaches = op["connect"] !== void 0 || op["create"] !== void 0;
+          if (plan.isOne && attaches && plan.canDetach && op["set"] === void 0) {
+            await detachAll(executor, plan, key);
+          }
+          if (op["connect"] !== void 0) {
+            for (const filter of asArray(op["connect"])) {
+              await executor.update(plan.targetTable).set({ [plan.foreignColPropName]: key }).where(conditionOf(plan, filter, "connect"));
+            }
+          }
+          if (op["create"] !== void 0) {
+            const rows = asArray(op["create"]).map((row) => ({
+              ...remapFromGraphQLSingleInput({ ...row }, plan.targetTable),
+              [plan.foreignColPropName]: key
+            }));
+            if (rows.length) {
+              await executor.insert(plan.targetTable).values(rows);
+            }
+          }
+        }
+      }
+    }
+  };
+};
+var writeWithNestedOps = async (params) => {
+  const { executor, runtime, tableName, entries, remapValues, write } = params;
+  return executor.transaction(async (tx) => {
+    const rows = [];
+    for (const entry of entries) {
+      const patch = await runtime.applyParentSide(tx, tableName, entry.ops);
+      const written = await write(tx, { ...remapValues(entry.columns), ...patch });
+      await runtime.applyChildSide(tx, tableName, entry.ops, written);
+      rows.push(...written);
+    }
+    return rows;
+  });
+};
+var updateWithNestedOps = async (params) => {
+  const { executor, runtime, tableName, columns, ops, remapValues, write } = params;
+  return executor.transaction(async (tx) => {
+    const patch = await runtime.applyParentSide(tx, tableName, ops);
+    const rows = await write(tx, { ...remapValues(columns), ...patch });
+    await runtime.applyChildSide(tx, tableName, ops, rows);
+    return rows;
+  });
+};
+
+// src/util/builders/pg.ts
 var generateSelectArray2 = (db, tableName, tables, relationMap, orderArgs, filterArgs, fieldName, typeName, typeNameMapper, filterCtx, distinctEnabled = true) => {
   const queryBase = db.query[tableName];
   const table = tables[tableName];
@@ -3910,24 +4377,24 @@ var generateSelectArray2 = (db, tableName, tables, relationMap, orderArgs, filte
         let cursorEntries;
         if (after != null || cursorSelected) {
           if (after != null && distinct?.length) {
-            throw new GraphQLError6("'after' cannot be combined with 'distinct'.");
+            throw new GraphQLError7("'after' cannot be combined with 'distinct'.");
           }
           if (orderByHasRelationEntry(orderBy)) {
             if (after != null) {
-              throw new GraphQLError6(
+              throw new GraphQLError7(
                 "'after' cannot be combined with an orderBy that orders through a relation \u2014 a related row's value cannot be encoded into a cursor."
               );
             }
           } else if (!pkNames.length) {
             if (after != null) {
-              throw new GraphQLError6(
+              throw new GraphQLError7(
                 `Table ${tableName} has no primary key, so cursor pagination cannot be used on it.`
               );
             }
           } else {
             cursorEntries = cursorOrderingEntries(orderBy, pkNames);
             if (cursorSelected) {
-              const allColumns = getColumns3(table);
+              const allColumns = getColumns4(table);
               for (const [column] of cursorEntries) {
                 selectedColumnsSql[column] ??= allColumns[column];
               }
@@ -3936,7 +4403,7 @@ var generateSelectArray2 = (db, tableName, tables, relationMap, orderArgs, filte
         }
         const cursorCondition = after != null && cursorEntries ? buildCursorCondition(table, cursorEntries, decodeCursor(after, cursorEntries), "nulls-largest") : void 0;
         const baseWhereSql = where ? extractFilters(table, tableName, where, relationFilterCtx(filterCtx, tableName)) : void 0;
-        const whereSql = cursorCondition ? and3(baseWhereSql, cursorCondition) : baseWhereSql;
+        const whereSql = cursorCondition ? and4(baseWhereSql, cursorCondition) : baseWhereSql;
         let distinctKeys;
         if (distinct?.length) {
           distinctKeys = await selectDistinctKeys({
@@ -4047,10 +4514,10 @@ var generateSelectSingle2 = (db, tableName, tables, relationMap, orderArgs, filt
   };
 };
 var pgPrimaryKeyPropNames = (table) => getPrimaryKeyPropNamesFromConfig(table, getTableConfig2);
-var generateInsertArray2 = (db, tableName, table, tables, relationMap, baseType, fieldName, typeName, typeNameMapper, conflictDoNothing = false, txCtx) => {
+var generateInsertArray2 = (db, tableName, table, tables, relationMap, baseType, fieldName, typeName, typeNameMapper, conflictDoNothing = false, txCtx, nested) => {
   const queryArgs = {
     values: {
-      type: new GraphQLNonNull5(new GraphQLList5(new GraphQLNonNull5(baseType)))
+      type: new GraphQLNonNull6(new GraphQLList6(new GraphQLNonNull6(baseType)))
     }
   };
   const pkNames = pgPrimaryKeyPropNames(table);
@@ -4059,10 +4526,12 @@ var generateInsertArray2 = (db, tableName, table, tables, relationMap, baseType,
     resolver: async (_source, args, context, info) => {
       try {
         return await runMutation(db, context, info, txCtx, async (executor) => {
-          const input = remapFromGraphQLArrayInput(args.values, table);
-          if (!input.length) {
-            throw new GraphQLError6("No values were provided!");
+          if (!args.values.length) {
+            throw new GraphQLError7("No values were provided!");
           }
+          const entries = nested?.enabled(tableName) ? args.values.map((values) => nested.split(tableName, values)) : void 0;
+          const nestedEntries = entries?.some((entry) => nested.hasOps(entry.ops)) ? entries : void 0;
+          const input = nestedEntries ? [] : remapFromGraphQLArrayInput(entries ? entries.map((entry) => entry.columns) : args.values, table);
           const parsedInfo = parseResolveInfo3(info, {
             deep: true
           });
@@ -4076,11 +4545,22 @@ var generateInsertArray2 = (db, tableName, table, tables, relationMap, baseType,
             pkNames,
             parsedInfo
           });
-          let query = executor.insert(table).values(input).returning(columns);
-          if (conflictDoNothing) {
-            query = query.onConflictDoNothing();
-          }
-          const result = await query;
+          const returning = nestedEntries ? nested.withJoinColumns(tableName, mergedOps(nestedEntries), { ...columns }, table) : columns;
+          const runInsert = async (target, values) => {
+            let query = target.insert(table).values(values).returning(returning);
+            if (conflictDoNothing) {
+              query = query.onConflictDoNothing();
+            }
+            return await query;
+          };
+          const result = nestedEntries ? await writeWithNestedOps({
+            executor,
+            runtime: nested,
+            tableName,
+            entries: nestedEntries,
+            remapValues: (values) => remapFromGraphQLSingleInput(values, table),
+            write: (tx, values) => runInsert(tx, [values])
+          }) : await runInsert(executor, input);
           const enriched = hasRelations ? await eagerLoadMutationRelations(executor, tableName, result, pkNames, withParams) : result;
           return remapToGraphQLArrayOutput(enriched, tableName, table, relationMap);
         });
@@ -4091,10 +4571,10 @@ var generateInsertArray2 = (db, tableName, table, tables, relationMap, baseType,
     args: queryArgs
   };
 };
-var generateInsertSingle2 = (db, tableName, table, tables, relationMap, baseType, fieldName, typeName, typeNameMapper, conflictDoNothing = false, txCtx) => {
+var generateInsertSingle2 = (db, tableName, table, tables, relationMap, baseType, fieldName, typeName, typeNameMapper, conflictDoNothing = false, txCtx, nested) => {
   const queryArgs = {
     values: {
-      type: new GraphQLNonNull5(baseType)
+      type: new GraphQLNonNull6(baseType)
     }
   };
   const pkNames = pgPrimaryKeyPropNames(table);
@@ -4103,7 +4583,9 @@ var generateInsertSingle2 = (db, tableName, table, tables, relationMap, baseType
     resolver: async (_source, args, context, info) => {
       try {
         return await runMutation(db, context, info, txCtx, async (executor) => {
-          const input = remapFromGraphQLSingleInput(args.values, table);
+          const entry = nested?.enabled(tableName) ? nested.split(tableName, args.values) : void 0;
+          const nestedEntry = entry && nested.hasOps(entry.ops) ? entry : void 0;
+          const input = nestedEntry ? {} : remapFromGraphQLSingleInput(entry ? entry.columns : args.values, table);
           const parsedInfo = parseResolveInfo3(info, {
             deep: true
           });
@@ -4117,11 +4599,22 @@ var generateInsertSingle2 = (db, tableName, table, tables, relationMap, baseType
             pkNames,
             parsedInfo
           });
-          let query = executor.insert(table).values(input).returning(columns);
-          if (conflictDoNothing) {
-            query = query.onConflictDoNothing();
-          }
-          const result = await query;
+          const returning = nestedEntry ? nested.withJoinColumns(tableName, nestedEntry.ops, { ...columns }, table) : columns;
+          const runInsert = async (target, values) => {
+            let query = target.insert(table).values(values).returning(returning);
+            if (conflictDoNothing) {
+              query = query.onConflictDoNothing();
+            }
+            return await query;
+          };
+          const result = nestedEntry ? await writeWithNestedOps({
+            executor,
+            runtime: nested,
+            tableName,
+            entries: [nestedEntry],
+            remapValues: (values) => remapFromGraphQLSingleInput(values, table),
+            write: runInsert
+          }) : await runInsert(executor, input);
           if (!result[0]) {
             return void 0;
           }
@@ -4135,10 +4628,10 @@ var generateInsertSingle2 = (db, tableName, table, tables, relationMap, baseType
     args: queryArgs
   };
 };
-var generateUpsert2 = (db, tableName, table, tables, relationMap, baseType, onConflictType, uniqueSets, fieldName, typeName, single, typeNameMapper, filterCtx, txCtx) => {
+var generateUpsert2 = (db, tableName, table, tables, relationMap, baseType, onConflictType, uniqueSets, fieldName, typeName, single, typeNameMapper, filterCtx, txCtx, nested) => {
   const queryArgs = {
     values: {
-      type: single ? new GraphQLNonNull5(baseType) : new GraphQLNonNull5(new GraphQLList5(new GraphQLNonNull5(baseType)))
+      type: single ? new GraphQLNonNull6(baseType) : new GraphQLNonNull6(new GraphQLList6(new GraphQLNonNull6(baseType)))
     },
     onConflict: {
       type: onConflictType,
@@ -4151,10 +4644,13 @@ var generateUpsert2 = (db, tableName, table, tables, relationMap, baseType, onCo
     resolver: async (_source, args, context, info) => {
       try {
         return await runMutation(db, context, info, txCtx, async (executor) => {
-          const input = single ? [remapFromGraphQLSingleInput(args.values, table)] : remapFromGraphQLArrayInput(args.values, table);
-          if (!input.length) {
-            throw new GraphQLError6("No values were provided!");
+          const supplied = single ? [args.values] : args.values;
+          if (!supplied.length) {
+            throw new GraphQLError7("No values were provided!");
           }
+          const entries = nested?.enabled(tableName) ? supplied.map((values) => nested.split(tableName, values)) : void 0;
+          const nestedEntries = entries?.some((entry) => nested.hasOps(entry.ops)) ? entries : void 0;
+          const input = nestedEntries ? [] : remapFromGraphQLArrayInput(entries ? entries.map((entry) => entry.columns) : supplied, table);
           const parsedInfo = parseResolveInfo3(info, { deep: true });
           const { columns, hasRelations, withParams } = prepareMutationRelationColumns({
             relationMap,
@@ -4166,19 +4662,30 @@ var generateUpsert2 = (db, tableName, table, tables, relationMap, baseType, onCo
             pkNames,
             parsedInfo
           });
-          const plan = resolveConflictPlan({
-            table,
-            values: input,
-            onConflict: args.onConflict,
-            pkNames,
-            uniqueSets,
-            excludedRef: excludedColumnRef,
-            withTarget: true,
-            buildWhere: (where) => extractFilters(table, tableName, where, relationFilterCtx(filterCtx, tableName))
-          });
-          let query = executor.insert(table).values(input).returning(columns);
-          query = plan.action === "NOTHING" ? query.onConflictDoNothing(plan.target ? { target: plan.target } : void 0) : query.onConflictDoUpdate({ target: plan.target, set: plan.set, setWhere: plan.setWhere });
-          const result = await query;
+          const returning = nestedEntries ? nested.withJoinColumns(tableName, mergedOps(nestedEntries), { ...columns }, table) : columns;
+          const runUpsert = async (target, values) => {
+            const plan = resolveConflictPlan({
+              table,
+              values,
+              onConflict: args.onConflict,
+              pkNames,
+              uniqueSets,
+              excludedRef: excludedColumnRef,
+              withTarget: true,
+              buildWhere: (where) => extractFilters(table, tableName, where, relationFilterCtx(filterCtx, tableName))
+            });
+            let query = target.insert(table).values(values).returning(returning);
+            query = plan.action === "NOTHING" ? query.onConflictDoNothing(plan.target ? { target: plan.target } : void 0) : query.onConflictDoUpdate({ target: plan.target, set: plan.set, setWhere: plan.setWhere });
+            return await query;
+          };
+          const result = nestedEntries ? await writeWithNestedOps({
+            executor,
+            runtime: nested,
+            tableName,
+            entries: nestedEntries,
+            remapValues: (values) => remapFromGraphQLSingleInput(values, table),
+            write: (tx, values) => runUpsert(tx, [values])
+          }) : await runUpsert(executor, input);
           if (single && !result[0]) {
             return void 0;
           }
@@ -4192,13 +4699,13 @@ var generateUpsert2 = (db, tableName, table, tables, relationMap, baseType, onCo
     args: queryArgs
   };
 };
-var generateUpdate2 = (db, tableName, table, tables, relationMap, setArgs, filterArgs, fieldName, typeName, single, requireWhere, typeNameMapper, filterCtx, txCtx) => {
+var generateUpdate2 = (db, tableName, table, tables, relationMap, setArgs, filterArgs, fieldName, typeName, single, requireWhere, typeNameMapper, filterCtx, txCtx, nested) => {
   const queryArgs = {
     set: {
-      type: new GraphQLNonNull5(setArgs)
+      type: new GraphQLNonNull6(setArgs)
     },
     where: {
-      type: single || requireWhere ? new GraphQLNonNull5(filterArgs) : filterArgs
+      type: single || requireWhere ? new GraphQLNonNull6(filterArgs) : filterArgs
     }
   };
   const pkNames = pgPrimaryKeyPropNames(table);
@@ -4221,23 +4728,37 @@ var generateUpdate2 = (db, tableName, table, tables, relationMap, setArgs, filte
             pkNames,
             parsedInfo
           });
-          const input = remapFromGraphQLSingleInput(set, table);
-          if (!Object.keys(input).length) {
-            throw new GraphQLError6("Unable to update with no values specified!");
+          const entry = nested?.enabled(tableName) ? nested.split(tableName, set) : void 0;
+          const nestedOps = entry && nested.hasOps(entry.ops) ? entry.ops : void 0;
+          const input = remapFromGraphQLSingleInput(entry ? entry.columns : set, table);
+          if (!Object.keys(input).length && !nestedOps) {
+            throw new GraphQLError7("Unable to update with no values specified!");
           }
           const relationCtx = relationFilterCtx(filterCtx, tableName);
           const filters = single || requireWhere ? extractRequiredFilters(table, tableName, where, fieldName, relationCtx) : where ? extractFilters(table, tableName, where, relationCtx) : void 0;
           if (single) {
             await assertSingleMatch(executor, table, filters, fieldName);
           }
-          let query = executor.update(table).set(input);
-          if (filters) {
-            query = query.where(filters);
-          }
-          query = query.returning(columns);
-          const result = await query;
+          const returning = nestedOps ? nested.withJoinColumns(tableName, nestedOps, { ...columns }, table) : columns;
+          const runUpdate = async (target, values) => {
+            const writes = Object.keys(values).length > 0;
+            let query = writes ? target.update(table).set(values) : target.select(returning).from(table);
+            if (filters) {
+              query = query.where(filters);
+            }
+            return await (writes ? query.returning(returning) : query);
+          };
+          const result = nestedOps ? await updateWithNestedOps({
+            executor,
+            runtime: nested,
+            tableName,
+            columns: input,
+            ops: nestedOps,
+            remapValues: (values) => values,
+            write: runUpdate
+          }) : await runUpdate(executor, input);
           if (single && result.length > 1) {
-            throw new GraphQLError6(`${fieldName}: 'where' matched more than one row!`);
+            throw new GraphQLError7(`${fieldName}: 'where' matched more than one row!`);
           }
           if (single && !result[0]) {
             return void 0;
@@ -4252,10 +4773,10 @@ var generateUpdate2 = (db, tableName, table, tables, relationMap, setArgs, filte
     args: queryArgs
   };
 };
-var generateUpdateMany2 = (db, tableName, table, tables, relationMap, updateManyInput, fieldName, typeName, typeNameMapper, filterCtx, txCtx) => {
+var generateUpdateMany2 = (db, tableName, table, tables, relationMap, updateManyInput, fieldName, typeName, typeNameMapper, filterCtx, txCtx, nested) => {
   const queryArgs = {
     updates: {
-      type: new GraphQLNonNull5(new GraphQLList5(new GraphQLNonNull5(updateManyInput)))
+      type: new GraphQLNonNull6(new GraphQLList6(new GraphQLNonNull6(updateManyInput)))
     }
   };
   const pkNames = pgPrimaryKeyPropNames(table);
@@ -4266,7 +4787,7 @@ var generateUpdateMany2 = (db, tableName, table, tables, relationMap, updateMany
         return await runMutation(db, context, info, txCtx, async (executor) => {
           const { updates } = args;
           if (!updates.length) {
-            throw new GraphQLError6("No updates were provided!");
+            throw new GraphQLError7("No updates were provided!");
           }
           const parsedInfo = parseResolveInfo3(info, {
             deep: true
@@ -4282,23 +4803,40 @@ var generateUpdateMany2 = (db, tableName, table, tables, relationMap, updateMany
             parsedInfo
           });
           const entries = updates.map(({ where, set }) => {
-            const input = remapFromGraphQLSingleInput(set, table);
-            if (!Object.keys(input).length) {
-              throw new GraphQLError6("Unable to update with no values specified!");
+            const split = nested?.enabled(tableName) ? nested.split(tableName, set) : void 0;
+            const ops = split && nested.hasOps(split.ops) ? split.ops : void 0;
+            const input = remapFromGraphQLSingleInput(split ? split.columns : set, table);
+            if (!Object.keys(input).length && !ops) {
+              throw new GraphQLError7("Unable to update with no values specified!");
             }
             return {
               set: input,
+              ops,
               filters: where ? extractFilters(table, tableName, where, relationFilterCtx(filterCtx, tableName)) : void 0
             };
           });
+          const returning = entries.some((entry) => entry.ops) ? nested.withJoinColumns(
+            tableName,
+            mergedOps(entries.map((entry) => ({ ops: entry.ops ?? {} }))),
+            {
+              ...columns
+            },
+            table
+          ) : columns;
           const perEntry = await executor.transaction(async (tx) => {
             const results = [];
             for (const entry of entries) {
-              let query = tx.update(table).set(entry.set);
+              const values = entry.ops ? { ...entry.set, ...await nested.applyParentSide(tx, tableName, entry.ops) } : entry.set;
+              const writes = Object.keys(values).length > 0;
+              let query = writes ? tx.update(table).set(values) : tx.select(returning).from(table);
               if (entry.filters) {
                 query = query.where(entry.filters);
               }
-              results.push(await query.returning(columns));
+              const rows = await (writes ? query.returning(returning) : query);
+              if (entry.ops) {
+                await nested.applyChildSide(tx, tableName, entry.ops, rows);
+              }
+              results.push(rows);
             }
             return results;
           });
@@ -4328,7 +4866,7 @@ var generateUpdateMany2 = (db, tableName, table, tables, relationMap, updateMany
 var generateDelete2 = (db, tableName, table, filterArgs, fieldName, typeName, single, requireWhere, filterCtx, selectionCtx, txCtx) => {
   const queryArgs = {
     where: {
-      type: single || requireWhere ? new GraphQLNonNull5(filterArgs) : filterArgs
+      type: single || requireWhere ? new GraphQLNonNull6(filterArgs) : filterArgs
     }
   };
   return {
@@ -4357,7 +4895,7 @@ var generateDelete2 = (db, tableName, table, filterArgs, fieldName, typeName, si
           query = query.returning(columns);
           const result = await query;
           if (single && result.length > 1) {
-            throw new GraphQLError6(`${fieldName}: 'where' matched more than one row!`);
+            throw new GraphQLError7(`${fieldName}: 'where' matched more than one row!`);
           }
           if (single) {
             return result[0] ? remapToGraphQLSingleOutput(result[0], tableName, table) : void 0;
@@ -4383,7 +4921,7 @@ function generateSchemaData2(db, schema, relations, options) {
     complexity
   } = options;
   const schemaEntries = Object.entries(schema);
-  const tableEntries = schemaEntries.filter(([_key, value]) => is5(value, PgTable));
+  const tableEntries = schemaEntries.filter(([_key, value]) => is6(value, PgTable));
   const tables = Object.fromEntries(tableEntries);
   if (!tableEntries.length) {
     throw new Error(
@@ -4391,6 +4929,7 @@ function generateSchemaData2(db, schema, relations, options) {
     );
   }
   registerScalarOverrides(tables, options);
+  registerEnumConfig(options);
   const namedRelations = buildNamedRelations(relations ?? {}, tableEntries);
   attachTargetPrimaryKeys(namedRelations, tables, pgPrimaryKeyPropNames);
   const eagerRelations = pruneNonEagerRelations(namedRelations, shouldEagerLoad);
@@ -4408,8 +4947,18 @@ function generateSchemaData2(db, schema, relations, options) {
     filterTypeCache: /* @__PURE__ */ new WeakMap(),
     listRelationFilterCache: /* @__PURE__ */ new Map(),
     aggregateTypeCache: /* @__PURE__ */ new Map(),
-    complexity
+    complexity,
+    docs: options.docs ?? {}
   };
+  const nestedPlans = features.nestedWrites ? buildNestedWritePlans(
+    tables,
+    namedRelations,
+    (target) => getUniqueColumnSets(target, getTableConfig2),
+    (target) => pgPrimaryKeyPropNames(target),
+    extractRelationJoinColumns
+  ) : void 0;
+  const nestedTypes = nestedPlans ? createNestedWriteTypes({ plans: nestedPlans, cacheCtx, typeNameMapper, insertPrefix: prefixes.insert }) : void 0;
+  const nestedRuntime = nestedPlans ? createNestedWriteRuntime({ plans: nestedPlans, filterCtx }) : void 0;
   const relationAggregateFactory = features.relationAggregates ? createRelationAggregateFactory(db, tables, cacheCtx, typeNameMapper, filterCtx) : void 0;
   const queries = {};
   const mutations = {};
@@ -4428,7 +4977,8 @@ function generateSchemaData2(db, schema, relations, options) {
         prefixes.insert,
         prefixes.update,
         resolverFactory,
-        relationAggregateFactory
+        relationAggregateFactory,
+        nestedTypes
       )
     ])
   );
@@ -4489,7 +5039,8 @@ function generateSchemaData2(db, schema, relations, options) {
       typeName,
       typeNameMapper,
       conflictDoNothing,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const insertSingleGenerated = features.insert ? generateInsertSingle2(
       db,
@@ -4502,7 +5053,8 @@ function generateSchemaData2(db, schema, relations, options) {
       typeName,
       typeNameMapper,
       conflictDoNothing,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const uniqueSets = features.upsert ? getUniqueColumnSets(schema[tableName], getTableConfig2) : [];
     const onConflictInput = features.upsert ? generateOnConflictInput({
@@ -4526,7 +5078,8 @@ function generateSchemaData2(db, schema, relations, options) {
       false,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const upsertSingleGenerated = onConflictInput ? generateUpsert2(
       db,
@@ -4542,7 +5095,8 @@ function generateSchemaData2(db, schema, relations, options) {
       true,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateGenerated = features.update ? generateUpdate2(
       db,
@@ -4558,7 +5112,8 @@ function generateSchemaData2(db, schema, relations, options) {
       features.requireWhere,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateSingleGenerated = features.update ? generateUpdate2(
       db,
@@ -4574,7 +5129,8 @@ function generateSchemaData2(db, schema, relations, options) {
       features.requireWhere,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateManyInput = features.update && features.updateMany ? generateUpdateManyInput({ typeName, updatePrefix: prefixes.update, updateInput, tableFilters }) : void 0;
     const updateManyGenerated = updateManyInput ? generateUpdateMany2(
@@ -4588,7 +5144,8 @@ function generateSchemaData2(db, schema, relations, options) {
       typeName,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const deleteGenerated = features.delete ? generateDelete2(
       db,
@@ -4653,7 +5210,7 @@ function generateSchemaData2(db, schema, relations, options) {
     };
     if (aggregateGenerated && aggregateType) {
       queries[aggregateGenerated.name] = {
-        type: new GraphQLNonNull5(aggregateType),
+        type: new GraphQLNonNull6(aggregateType),
         args: aggregateGenerated.args,
         resolve: aggregateGenerated.resolver,
         ...complexity ? { extensions: { complexity: aggregateFieldComplexity(complexity) } } : {}
@@ -4661,7 +5218,7 @@ function generateSchemaData2(db, schema, relations, options) {
     }
     if (groupByGenerated && groupByType) {
       queries[groupByGenerated.name] = {
-        type: new GraphQLNonNull5(new GraphQLList5(new GraphQLNonNull5(groupByType))),
+        type: new GraphQLNonNull6(new GraphQLList6(new GraphQLNonNull6(groupByType))),
         args: groupByGenerated.args,
         resolve: groupByGenerated.resolver,
         ...complexity ? { extensions: { complexity: aggregateFieldComplexity(complexity) } } : {}
@@ -4705,7 +5262,7 @@ function generateSchemaData2(db, schema, relations, options) {
     if (updateManyGenerated) {
       mutations[updateManyGenerated.name] = {
         // Nullable items: a no-match entry yields `null` in its slot.
-        type: new GraphQLNonNull5(new GraphQLList5(singleTableItemOutput)),
+        type: new GraphQLNonNull6(new GraphQLList6(singleTableItemOutput)),
         args: updateManyGenerated.args,
         resolve: updateManyGenerated.resolver
       };
@@ -4762,7 +5319,7 @@ function generateSchemaData2(db, schema, relations, options) {
   for (const [tableName, tableRelations] of Object.entries(namedRelations)) {
     const relResolvers = {};
     for (const [relName, relEntry] of Object.entries(tableRelations)) {
-      const isOne = is5(relEntry.relation ?? relEntry, One4);
+      const isOne = is6(relEntry.relation ?? relEntry, One5);
       const resolver = resolverFactory({ tableName, relationName: relName, relEntry, isOne });
       if (resolver) {
         relResolvers[relName] = resolver;
@@ -4776,12 +5333,12 @@ function generateSchemaData2(db, schema, relations, options) {
 }
 
 // src/util/builders/sqlite.ts
-import { is as is6, One as One5 } from "drizzle-orm";
+import { is as is7, One as One6 } from "drizzle-orm";
 import { getTableConfig as getTableConfig3, SQLiteTable } from "drizzle-orm/sqlite-core";
 import {
-  GraphQLError as GraphQLError7,
-  GraphQLList as GraphQLList6,
-  GraphQLNonNull as GraphQLNonNull6
+  GraphQLError as GraphQLError8,
+  GraphQLList as GraphQLList7,
+  GraphQLNonNull as GraphQLNonNull7
 } from "graphql";
 import { parseResolveInfo as parseResolveInfo4 } from "graphql-parse-resolve-info";
 var generateSelectArray3 = (db, tableName, tables, relationMap, orderArgs, filterArgs, fieldName, typeName, typeNameMapper, filterCtx, distinctEnabled = true) => {
@@ -4867,10 +5424,10 @@ var generateSelectSingle3 = (db, tableName, tables, relationMap, orderArgs, filt
   };
 };
 var sqlitePrimaryKeyPropNames = (table) => getPrimaryKeyPropNamesFromConfig(table, getTableConfig3);
-var generateInsertArray3 = (db, tableName, table, tables, relationMap, baseType, fieldName, typeName, typeNameMapper, conflictDoNothing = false, txCtx) => {
+var generateInsertArray3 = (db, tableName, table, tables, relationMap, baseType, fieldName, typeName, typeNameMapper, conflictDoNothing = false, txCtx, nested) => {
   const queryArgs = {
     values: {
-      type: new GraphQLNonNull6(new GraphQLList6(new GraphQLNonNull6(baseType)))
+      type: new GraphQLNonNull7(new GraphQLList7(new GraphQLNonNull7(baseType)))
     }
   };
   const pkNames = sqlitePrimaryKeyPropNames(table);
@@ -4879,10 +5436,12 @@ var generateInsertArray3 = (db, tableName, table, tables, relationMap, baseType,
     resolver: async (_source, args, context, info) => {
       try {
         return await runMutation(db, context, info, txCtx, async (executor) => {
-          const input = remapFromGraphQLArrayInput(args.values, table);
-          if (!input.length) {
-            throw new GraphQLError7("No values were provided!");
+          if (!args.values.length) {
+            throw new GraphQLError8("No values were provided!");
           }
+          const entries = nested?.enabled(tableName) ? args.values.map((values) => nested.split(tableName, values)) : void 0;
+          const nestedEntries = entries?.some((entry) => nested.hasOps(entry.ops)) ? entries : void 0;
+          const input = nestedEntries ? [] : remapFromGraphQLArrayInput(entries ? entries.map((entry) => entry.columns) : args.values, table);
           const parsedInfo = parseResolveInfo4(info, {
             deep: true
           });
@@ -4896,11 +5455,22 @@ var generateInsertArray3 = (db, tableName, table, tables, relationMap, baseType,
             pkNames,
             parsedInfo
           });
-          let query = executor.insert(table).values(input).returning(columns);
-          if (conflictDoNothing) {
-            query = query.onConflictDoNothing();
-          }
-          const result = await query;
+          const returning = nestedEntries ? nested.withJoinColumns(tableName, mergedOps(nestedEntries), { ...columns }, table) : columns;
+          const runInsert = async (target, values) => {
+            let query = target.insert(table).values(values).returning(returning);
+            if (conflictDoNothing) {
+              query = query.onConflictDoNothing();
+            }
+            return await query;
+          };
+          const result = nestedEntries ? await writeWithNestedOps({
+            executor,
+            runtime: nested,
+            tableName,
+            entries: nestedEntries,
+            remapValues: (values) => remapFromGraphQLSingleInput(values, table),
+            write: (tx, values) => runInsert(tx, [values])
+          }) : await runInsert(executor, input);
           const enriched = hasRelations ? await eagerLoadMutationRelations(executor, tableName, result, pkNames, withParams) : result;
           return remapToGraphQLArrayOutput(enriched, tableName, table, relationMap);
         });
@@ -4911,10 +5481,10 @@ var generateInsertArray3 = (db, tableName, table, tables, relationMap, baseType,
     args: queryArgs
   };
 };
-var generateInsertSingle3 = (db, tableName, table, tables, relationMap, baseType, fieldName, typeName, typeNameMapper, conflictDoNothing = false, txCtx) => {
+var generateInsertSingle3 = (db, tableName, table, tables, relationMap, baseType, fieldName, typeName, typeNameMapper, conflictDoNothing = false, txCtx, nested) => {
   const queryArgs = {
     values: {
-      type: new GraphQLNonNull6(baseType)
+      type: new GraphQLNonNull7(baseType)
     }
   };
   const pkNames = sqlitePrimaryKeyPropNames(table);
@@ -4923,7 +5493,9 @@ var generateInsertSingle3 = (db, tableName, table, tables, relationMap, baseType
     resolver: async (_source, args, context, info) => {
       try {
         return await runMutation(db, context, info, txCtx, async (executor) => {
-          const input = remapFromGraphQLSingleInput(args.values, table);
+          const entry = nested?.enabled(tableName) ? nested.split(tableName, args.values) : void 0;
+          const nestedEntry = entry && nested.hasOps(entry.ops) ? entry : void 0;
+          const input = nestedEntry ? {} : remapFromGraphQLSingleInput(entry ? entry.columns : args.values, table);
           const parsedInfo = parseResolveInfo4(info, {
             deep: true
           });
@@ -4937,11 +5509,22 @@ var generateInsertSingle3 = (db, tableName, table, tables, relationMap, baseType
             pkNames,
             parsedInfo
           });
-          let query = executor.insert(table).values(input).returning(columns);
-          if (conflictDoNothing) {
-            query = query.onConflictDoNothing();
-          }
-          const result = await query;
+          const returning = nestedEntry ? nested.withJoinColumns(tableName, nestedEntry.ops, { ...columns }, table) : columns;
+          const runInsert = async (target, values) => {
+            let query = target.insert(table).values(values).returning(returning);
+            if (conflictDoNothing) {
+              query = query.onConflictDoNothing();
+            }
+            return await query;
+          };
+          const result = nestedEntry ? await writeWithNestedOps({
+            executor,
+            runtime: nested,
+            tableName,
+            entries: [nestedEntry],
+            remapValues: (values) => remapFromGraphQLSingleInput(values, table),
+            write: runInsert
+          }) : await runInsert(executor, input);
           if (!result[0]) {
             return void 0;
           }
@@ -4955,10 +5538,10 @@ var generateInsertSingle3 = (db, tableName, table, tables, relationMap, baseType
     args: queryArgs
   };
 };
-var generateUpsert3 = (db, tableName, table, tables, relationMap, baseType, onConflictType, uniqueSets, fieldName, typeName, single, typeNameMapper, filterCtx, txCtx) => {
+var generateUpsert3 = (db, tableName, table, tables, relationMap, baseType, onConflictType, uniqueSets, fieldName, typeName, single, typeNameMapper, filterCtx, txCtx, nested) => {
   const queryArgs = {
     values: {
-      type: single ? new GraphQLNonNull6(baseType) : new GraphQLNonNull6(new GraphQLList6(new GraphQLNonNull6(baseType)))
+      type: single ? new GraphQLNonNull7(baseType) : new GraphQLNonNull7(new GraphQLList7(new GraphQLNonNull7(baseType)))
     },
     onConflict: {
       type: onConflictType,
@@ -4971,10 +5554,13 @@ var generateUpsert3 = (db, tableName, table, tables, relationMap, baseType, onCo
     resolver: async (_source, args, context, info) => {
       try {
         return await runMutation(db, context, info, txCtx, async (executor) => {
-          const input = single ? [remapFromGraphQLSingleInput(args.values, table)] : remapFromGraphQLArrayInput(args.values, table);
-          if (!input.length) {
-            throw new GraphQLError7("No values were provided!");
+          const supplied = single ? [args.values] : args.values;
+          if (!supplied.length) {
+            throw new GraphQLError8("No values were provided!");
           }
+          const entries = nested?.enabled(tableName) ? supplied.map((values) => nested.split(tableName, values)) : void 0;
+          const nestedEntries = entries?.some((entry) => nested.hasOps(entry.ops)) ? entries : void 0;
+          const input = nestedEntries ? [] : remapFromGraphQLArrayInput(entries ? entries.map((entry) => entry.columns) : supplied, table);
           const parsedInfo = parseResolveInfo4(info, { deep: true });
           const { columns, hasRelations, withParams } = prepareMutationRelationColumns({
             relationMap,
@@ -4986,19 +5572,30 @@ var generateUpsert3 = (db, tableName, table, tables, relationMap, baseType, onCo
             pkNames,
             parsedInfo
           });
-          const plan = resolveConflictPlan({
-            table,
-            values: input,
-            onConflict: args.onConflict,
-            pkNames,
-            uniqueSets,
-            excludedRef: excludedColumnRef,
-            withTarget: true,
-            buildWhere: (where) => extractFilters(table, tableName, where, relationFilterCtx(filterCtx, tableName))
-          });
-          let query = executor.insert(table).values(input).returning(columns);
-          query = plan.action === "NOTHING" ? query.onConflictDoNothing(plan.target ? { target: plan.target } : void 0) : query.onConflictDoUpdate({ target: plan.target, set: plan.set, setWhere: plan.setWhere });
-          const result = await query;
+          const returning = nestedEntries ? nested.withJoinColumns(tableName, mergedOps(nestedEntries), { ...columns }, table) : columns;
+          const runUpsert = async (target, values) => {
+            const plan = resolveConflictPlan({
+              table,
+              values,
+              onConflict: args.onConflict,
+              pkNames,
+              uniqueSets,
+              excludedRef: excludedColumnRef,
+              withTarget: true,
+              buildWhere: (where) => extractFilters(table, tableName, where, relationFilterCtx(filterCtx, tableName))
+            });
+            let query = target.insert(table).values(values).returning(returning);
+            query = plan.action === "NOTHING" ? query.onConflictDoNothing(plan.target ? { target: plan.target } : void 0) : query.onConflictDoUpdate({ target: plan.target, set: plan.set, setWhere: plan.setWhere });
+            return await query;
+          };
+          const result = nestedEntries ? await writeWithNestedOps({
+            executor,
+            runtime: nested,
+            tableName,
+            entries: nestedEntries,
+            remapValues: (values) => remapFromGraphQLSingleInput(values, table),
+            write: (tx, values) => runUpsert(tx, [values])
+          }) : await runUpsert(executor, input);
           if (single && !result[0]) {
             return void 0;
           }
@@ -5012,13 +5609,13 @@ var generateUpsert3 = (db, tableName, table, tables, relationMap, baseType, onCo
     args: queryArgs
   };
 };
-var generateUpdate3 = (db, tableName, table, tables, relationMap, setArgs, filterArgs, fieldName, typeName, single, requireWhere, typeNameMapper, filterCtx, txCtx) => {
+var generateUpdate3 = (db, tableName, table, tables, relationMap, setArgs, filterArgs, fieldName, typeName, single, requireWhere, typeNameMapper, filterCtx, txCtx, nested) => {
   const queryArgs = {
     set: {
-      type: new GraphQLNonNull6(setArgs)
+      type: new GraphQLNonNull7(setArgs)
     },
     where: {
-      type: single || requireWhere ? new GraphQLNonNull6(filterArgs) : filterArgs
+      type: single || requireWhere ? new GraphQLNonNull7(filterArgs) : filterArgs
     }
   };
   const pkNames = sqlitePrimaryKeyPropNames(table);
@@ -5041,23 +5638,37 @@ var generateUpdate3 = (db, tableName, table, tables, relationMap, setArgs, filte
             pkNames,
             parsedInfo
           });
-          const input = remapFromGraphQLSingleInput(set, table);
-          if (!Object.keys(input).length) {
-            throw new GraphQLError7("Unable to update with no values specified!");
+          const entry = nested?.enabled(tableName) ? nested.split(tableName, set) : void 0;
+          const nestedOps = entry && nested.hasOps(entry.ops) ? entry.ops : void 0;
+          const input = remapFromGraphQLSingleInput(entry ? entry.columns : set, table);
+          if (!Object.keys(input).length && !nestedOps) {
+            throw new GraphQLError8("Unable to update with no values specified!");
           }
           const relationCtx = relationFilterCtx(filterCtx, tableName);
           const filters = single || requireWhere ? extractRequiredFilters(table, tableName, where, fieldName, relationCtx) : where ? extractFilters(table, tableName, where, relationCtx) : void 0;
           if (single) {
             await assertSingleMatch(executor, table, filters, fieldName);
           }
-          let query = executor.update(table).set(input);
-          if (filters) {
-            query = query.where(filters);
-          }
-          query = query.returning(columns);
-          const result = await query;
+          const returning = nestedOps ? nested.withJoinColumns(tableName, nestedOps, { ...columns }, table) : columns;
+          const runUpdate = async (target, values) => {
+            const writes = Object.keys(values).length > 0;
+            let query = writes ? target.update(table).set(values) : target.select(returning).from(table);
+            if (filters) {
+              query = query.where(filters);
+            }
+            return await (writes ? query.returning(returning) : query);
+          };
+          const result = nestedOps ? await updateWithNestedOps({
+            executor,
+            runtime: nested,
+            tableName,
+            columns: input,
+            ops: nestedOps,
+            remapValues: (values) => values,
+            write: runUpdate
+          }) : await runUpdate(executor, input);
           if (single && result.length > 1) {
-            throw new GraphQLError7(`${fieldName}: 'where' matched more than one row!`);
+            throw new GraphQLError8(`${fieldName}: 'where' matched more than one row!`);
           }
           if (single && !result[0]) {
             return void 0;
@@ -5072,10 +5683,10 @@ var generateUpdate3 = (db, tableName, table, tables, relationMap, setArgs, filte
     args: queryArgs
   };
 };
-var generateUpdateMany3 = (db, tableName, table, tables, relationMap, updateManyInput, fieldName, typeName, typeNameMapper, filterCtx, txCtx) => {
+var generateUpdateMany3 = (db, tableName, table, tables, relationMap, updateManyInput, fieldName, typeName, typeNameMapper, filterCtx, txCtx, nested) => {
   const queryArgs = {
     updates: {
-      type: new GraphQLNonNull6(new GraphQLList6(new GraphQLNonNull6(updateManyInput)))
+      type: new GraphQLNonNull7(new GraphQLList7(new GraphQLNonNull7(updateManyInput)))
     }
   };
   const pkNames = sqlitePrimaryKeyPropNames(table);
@@ -5086,7 +5697,7 @@ var generateUpdateMany3 = (db, tableName, table, tables, relationMap, updateMany
         return await runMutation(db, context, info, txCtx, async (executor) => {
           const { updates } = args;
           if (!updates.length) {
-            throw new GraphQLError7("No updates were provided!");
+            throw new GraphQLError8("No updates were provided!");
           }
           const parsedInfo = parseResolveInfo4(info, {
             deep: true
@@ -5102,23 +5713,55 @@ var generateUpdateMany3 = (db, tableName, table, tables, relationMap, updateMany
             parsedInfo
           });
           const entries = updates.map(({ where, set }) => {
-            const input = remapFromGraphQLSingleInput(set, table);
-            if (!Object.keys(input).length) {
-              throw new GraphQLError7("Unable to update with no values specified!");
+            const split = nested?.enabled(tableName) ? nested.split(tableName, set) : void 0;
+            const ops = split && nested.hasOps(split.ops) ? split.ops : void 0;
+            const input = remapFromGraphQLSingleInput(split ? split.columns : set, table);
+            if (!Object.keys(input).length && !ops) {
+              throw new GraphQLError8("Unable to update with no values specified!");
             }
             return {
               set: input,
+              ops,
               filters: where ? extractFilters(table, tableName, where, relationFilterCtx(filterCtx, tableName)) : void 0
             };
           });
+          const anyNested = entries.some((entry) => entry.ops);
+          const returning = anyNested ? nested.withJoinColumns(
+            tableName,
+            mergedOps(entries.map((entry) => ({ ops: entry.ops ?? {} }))),
+            { ...columns },
+            table
+          ) : columns;
           const runEntry = (tx, entry) => {
             let query = tx.update(table).set(entry.set);
             if (entry.filters) {
               query = query.where(entry.filters);
             }
-            return query.returning(columns).all();
+            return query.returning(returning).all();
+          };
+          const runNestedEntry = async (tx, entry) => {
+            const values = entry.ops ? { ...entry.set, ...await nested.applyParentSide(tx, tableName, entry.ops) } : entry.set;
+            const writes = Object.keys(values).length > 0;
+            let query = writes ? tx.update(table).set(values) : tx.select(returning).from(table);
+            if (entry.filters) {
+              query = query.where(entry.filters);
+            }
+            const rows = await (writes ? query.returning(returning) : query);
+            if (entry.ops) {
+              await nested.applyChildSide(tx, tableName, entry.ops, rows);
+            }
+            return rows;
           };
           const perEntry = await executor.transaction((tx) => {
+            if (anyNested) {
+              return (async () => {
+                const results2 = [];
+                for (const entry of entries) {
+                  results2.push(await runNestedEntry(tx, entry));
+                }
+                return results2;
+              })();
+            }
             const first = runEntry(tx, entries[0]);
             if (typeof first?.then === "function") {
               return (async () => {
@@ -5161,7 +5804,7 @@ var generateUpdateMany3 = (db, tableName, table, tables, relationMap, updateMany
 var generateDelete3 = (db, tableName, table, filterArgs, fieldName, typeName, single, requireWhere, filterCtx, selectionCtx, txCtx) => {
   const queryArgs = {
     where: {
-      type: single || requireWhere ? new GraphQLNonNull6(filterArgs) : filterArgs
+      type: single || requireWhere ? new GraphQLNonNull7(filterArgs) : filterArgs
     }
   };
   return {
@@ -5190,7 +5833,7 @@ var generateDelete3 = (db, tableName, table, filterArgs, fieldName, typeName, si
           query = query.returning(columns);
           const result = await query;
           if (single && result.length > 1) {
-            throw new GraphQLError7(`${fieldName}: 'where' matched more than one row!`);
+            throw new GraphQLError8(`${fieldName}: 'where' matched more than one row!`);
           }
           if (single) {
             return result[0] ? remapToGraphQLSingleOutput(result[0], tableName, table) : void 0;
@@ -5217,7 +5860,7 @@ var generateSchemaData3 = (db, schema, relations, options) => {
   } = options;
   const rawSchema = schema;
   const schemaEntries = Object.entries(rawSchema);
-  const tableEntries = schemaEntries.filter(([_key, value]) => is6(value, SQLiteTable));
+  const tableEntries = schemaEntries.filter(([_key, value]) => is7(value, SQLiteTable));
   const tables = Object.fromEntries(tableEntries);
   if (!tableEntries.length) {
     throw new Error(
@@ -5225,6 +5868,7 @@ var generateSchemaData3 = (db, schema, relations, options) => {
     );
   }
   registerScalarOverrides(tables, options);
+  registerEnumConfig(options);
   const namedRelations = buildNamedRelations(relations ?? {}, tableEntries);
   attachTargetPrimaryKeys(namedRelations, tables, sqlitePrimaryKeyPropNames);
   const eagerRelations = pruneNonEagerRelations(namedRelations, shouldEagerLoad);
@@ -5242,8 +5886,23 @@ var generateSchemaData3 = (db, schema, relations, options) => {
     filterTypeCache: /* @__PURE__ */ new WeakMap(),
     listRelationFilterCache: /* @__PURE__ */ new Map(),
     aggregateTypeCache: /* @__PURE__ */ new Map(),
-    complexity
+    complexity,
+    docs: options.docs ?? {}
   };
+  if (features.nestedWrites && db.resultKind === "sync") {
+    throw new Error(
+      "Drizzle-GraphQL Error: features.nestedWrites requires an asynchronous SQLite driver (e.g. libsql). Synchronous drivers cannot run the multi-statement transaction a nested write needs."
+    );
+  }
+  const nestedPlans = features.nestedWrites ? buildNestedWritePlans(
+    tables,
+    namedRelations,
+    (target) => getUniqueColumnSets(target, getTableConfig3),
+    (target) => sqlitePrimaryKeyPropNames(target),
+    extractRelationJoinColumns
+  ) : void 0;
+  const nestedTypes = nestedPlans ? createNestedWriteTypes({ plans: nestedPlans, cacheCtx, typeNameMapper, insertPrefix: prefixes.insert }) : void 0;
+  const nestedRuntime = nestedPlans ? createNestedWriteRuntime({ plans: nestedPlans, filterCtx }) : void 0;
   const relationAggregateFactory = features.relationAggregates ? createRelationAggregateFactory(db, tables, cacheCtx, typeNameMapper, filterCtx) : void 0;
   const queries = {};
   const mutations = {};
@@ -5267,7 +5926,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
         prefixes.insert,
         prefixes.update,
         resolverFactory,
-        relationAggregateFactory
+        relationAggregateFactory,
+        nestedTypes
       )
     ])
   );
@@ -5328,7 +5988,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       typeName,
       typeNameMapper,
       conflictDoNothing,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const insertSingleGenerated = features.insert ? generateInsertSingle3(
       db,
@@ -5341,7 +6002,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       typeName,
       typeNameMapper,
       conflictDoNothing,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const uniqueSets = features.upsert ? getUniqueColumnSets(schema[tableName], getTableConfig3) : [];
     const onConflictInput = features.upsert ? generateOnConflictInput({
@@ -5365,7 +6027,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       false,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const upsertSingleGenerated = onConflictInput ? generateUpsert3(
       db,
@@ -5381,7 +6044,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       true,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateGenerated = features.update ? generateUpdate3(
       db,
@@ -5397,7 +6061,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       features.requireWhere,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateSingleGenerated = features.update ? generateUpdate3(
       db,
@@ -5413,7 +6078,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       features.requireWhere,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateManyInput = features.update && features.updateMany ? generateUpdateManyInput({ typeName, updatePrefix: prefixes.update, updateInput, tableFilters }) : void 0;
     const updateManyGenerated = updateManyInput ? generateUpdateMany3(
@@ -5427,7 +6093,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       typeName,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const deleteGenerated = features.delete ? generateDelete3(
       db,
@@ -5492,7 +6159,7 @@ var generateSchemaData3 = (db, schema, relations, options) => {
     };
     if (aggregateGenerated && aggregateType) {
       queries[aggregateGenerated.name] = {
-        type: new GraphQLNonNull6(aggregateType),
+        type: new GraphQLNonNull7(aggregateType),
         args: aggregateGenerated.args,
         resolve: aggregateGenerated.resolver,
         ...complexity ? { extensions: { complexity: aggregateFieldComplexity(complexity) } } : {}
@@ -5500,7 +6167,7 @@ var generateSchemaData3 = (db, schema, relations, options) => {
     }
     if (groupByGenerated && groupByType) {
       queries[groupByGenerated.name] = {
-        type: new GraphQLNonNull6(new GraphQLList6(new GraphQLNonNull6(groupByType))),
+        type: new GraphQLNonNull7(new GraphQLList7(new GraphQLNonNull7(groupByType))),
         args: groupByGenerated.args,
         resolve: groupByGenerated.resolver,
         ...complexity ? { extensions: { complexity: aggregateFieldComplexity(complexity) } } : {}
@@ -5544,7 +6211,7 @@ var generateSchemaData3 = (db, schema, relations, options) => {
     if (updateManyGenerated) {
       mutations[updateManyGenerated.name] = {
         // Nullable items: a no-match entry yields `null` in its slot.
-        type: new GraphQLNonNull6(new GraphQLList6(singleTableItemOutput)),
+        type: new GraphQLNonNull7(new GraphQLList7(singleTableItemOutput)),
         args: updateManyGenerated.args,
         resolve: updateManyGenerated.resolver
       };
@@ -5601,7 +6268,7 @@ var generateSchemaData3 = (db, schema, relations, options) => {
   for (const [tableName, tableRelations] of Object.entries(namedRelations)) {
     const relResolvers = {};
     for (const [relName, relEntry] of Object.entries(tableRelations)) {
-      const isOne = is6(relEntry.relation ?? relEntry, One5);
+      const isOne = is7(relEntry.relation ?? relEntry, One6);
       const resolver = resolverFactory({ tableName, relationName: relName, relEntry, isOne });
       if (resolver) {
         relResolvers[relName] = resolver;
@@ -5646,6 +6313,7 @@ var buildSchema = (db, config) => {
     updateMany: config?.features?.updateMany ?? true,
     delete: config?.features?.delete ?? true,
     upsert: config?.features?.upsert ?? false,
+    nestedWrites: config?.features?.nestedWrites ?? false,
     requireWhere: config?.features?.requireWhere ?? false
   };
   const complexityConfig = config?.complexity ?? true;
@@ -5685,14 +6353,21 @@ var buildSchema = (db, config) => {
     complexity,
     scalars: config?.scalars,
     mapColumnType: config?.mapColumnType,
-    transactions
+    enumNameMapper: config?.enumNameMapper,
+    transactions,
+    docs: {
+      describeColumn: config?.describeColumn,
+      describeTable: config?.describeTable,
+      describeRelation: config?.describeRelation,
+      deprecateColumn: config?.deprecateColumn
+    }
   };
   let generatorOutput;
-  if (is7(db, MySqlDatabase)) {
+  if (is8(db, MySqlDatabase)) {
     generatorOutput = generateSchemaData(db, schema, relations, generatorOptions);
-  } else if (is7(db, PgAsyncDatabase)) {
+  } else if (is8(db, PgAsyncDatabase)) {
     generatorOutput = generateSchemaData2(db, schema, relations, generatorOptions);
-  } else if (is7(db, BaseSQLiteDatabase)) {
+  } else if (is8(db, BaseSQLiteDatabase)) {
     generatorOutput = generateSchemaData3(db, schema, relations, generatorOptions);
   } else {
     throw new Error("Drizzle-GraphQL Error: Unknown database instance type");