@vantreeseba/drizzle-graphql 5.5.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";
@@ -17,6 +17,7 @@ import {
   asc,
   desc,
   eq,
+  extractExtendedColumnType as extractExtendedColumnType2,
   getColumns,
   getTableAsAliasSQL,
   gt,
@@ -104,200 +105,29 @@ var uncapitalize = (input) => input?.length ? `${input[0].toLocaleLowerCase()}${
 var capitalize = (input) => input?.length ? `${input[0].toLocaleUpperCase()}${input.length > 1 ? input.slice(1, input.length) : ""}` : input;
 
 // src/util/data-mappers/index.ts
-import { getTableColumns, is, One } from "drizzle-orm";
-import { GraphQLError } from "graphql";
-var isJsonColumn = (column) => (column.dataType ?? "").includes("json") && column.columnType !== "PgGeometryObject";
-var remapToGraphQLCore = (key, value, tableName, column, relationMap) => {
-  if (Array.isArray(value)) {
-    const relations = relationMap?.[tableName];
-    if (relations?.[key]) {
-      const rel = relations[key];
-      return remapToGraphQLArrayOutput(
-        value,
-        rel.targetTableName,
-        rel.relation?.targetTable ?? rel.relation?.referencedTable,
-        relationMap
-      );
-    }
-  }
-  if (typeof value === "object" && value !== null) {
-    const relations = relationMap?.[tableName];
-    if (relations?.[key]) {
-      const rel = relations[key];
-      const remapped = remapToGraphQLSingleOutput(
-        value,
-        rel.targetTableName,
-        rel.relation?.targetTable ?? rel.relation?.referencedTable,
-        relationMap
-      );
-      return remapped;
-    }
-  }
-  if (!column) {
-    return value;
-  }
-  if (isJsonColumn(column)) {
-    return value;
-  }
-  if (value instanceof Date) {
-    return value.toISOString();
-  }
-  if (value instanceof Buffer) {
-    return Array.from(value);
-  }
-  if (typeof value === "bigint") {
-    return value.toString();
-  }
-  if (Array.isArray(value)) {
-    if (column.columnType === "PgGeometry" || column.columnType === "PgVector") {
-      return value;
-    }
-    return value.map((arrVal) => remapToGraphQLCore(key, arrVal, tableName, column, relationMap));
-  }
-  if (typeof value === "object" && value !== null) {
-    if (column.columnType === "PgGeometryObject") {
-      return value;
-    }
-    return JSON.stringify(value);
-  }
-  return value;
-};
-var remapToGraphQLSingleOutput = (queryOutput, tableName, table, relationMap) => {
-  for (const [key, value] of Object.entries(queryOutput)) {
-    if (value === void 0 || value === null) {
-      const relEntry = value === null ? relationMap?.[tableName]?.[key] : void 0;
-      if (relEntry && is(relEntry.relation, One)) {
-        queryOutput[key] = null;
-        continue;
-      }
-      delete queryOutput[key];
-      continue;
-    }
-    const column = table[key];
-    if (value === 0n && column && column.columnType === "SQLiteBigInt" && !column.notNull) {
-      delete queryOutput[key];
-      continue;
-    }
-    queryOutput[key] = remapToGraphQLCore(key, value, tableName, column, relationMap);
-  }
-  return queryOutput;
-};
-var remapToGraphQLArrayOutput = (queryOutput, tableName, table, relationMap) => {
-  for (const entry of queryOutput) {
-    remapToGraphQLSingleOutput(entry, tableName, table, relationMap);
-  }
-  return queryOutput;
-};
-var remapFromGraphQLCore = (value, column, columnName) => {
-  const dataType = column.dataType ?? "";
-  const columnType = column.columnType ?? "";
-  const isTimestampColumn = columnType === "SQLiteTimestamp" || columnType === "SQLiteTimestampMs" || columnType === "MySqlTimestamp" || columnType === "MySqlDateTime" || columnType === "PgTimestamp" || columnType === "PgTimestampString";
-  if (isTimestampColumn) {
-    const formatted = new Date(value);
-    if (Number.isNaN(formatted.getTime())) {
-      throw new GraphQLError(`Field '${columnName}' is not a valid date!`);
-    }
-    return formatted;
-  }
-  const isDateOnlyColumn = columnType === "MySqlDate" || columnType === "PgDate";
-  if (isDateOnlyColumn && typeof value === "string") {
-    const dateOnly = value.includes("T") ? value.split("T")[0] : value;
-    const check = new Date(dateOnly);
-    if (Number.isNaN(check.getTime())) {
-      throw new GraphQLError(`Field '${columnName}' is not a valid date!`);
-    }
-    return dateOnly;
-  }
-  if (dataType.includes("bigint")) {
-    try {
-      return BigInt(value);
-    } catch {
-      throw new GraphQLError(`Field '${columnName}' is not a BigInt!`);
-    }
-  }
-  if (dataType.includes("json") && column.columnType !== "PgGeometryObject") {
-    return value;
-  }
-  switch (dataType) {
-    case "date": {
-      const formatted = new Date(value);
-      if (Number.isNaN(formatted.getTime())) {
-        throw new GraphQLError(`Field '${columnName}' is not a valid date!`);
-      }
-      return formatted;
-    }
-    case "buffer": {
-      if (!Array.isArray(value)) {
-        throw new GraphQLError(`Field '${columnName}' is not an array!`);
-      }
-      return Buffer.from(value);
-    }
-    case "json": {
-      if (column.columnType === "PgGeometryObject") {
-        return value;
-      }
-      try {
-        return JSON.parse(value);
-      } catch (e) {
-        throw new GraphQLError(
-          `Invalid JSON in field '${columnName}':
-${e instanceof Error ? e.message : "Unknown error"}`
-        );
-      }
-    }
-    case "array": {
-      if (!Array.isArray(value)) {
-        throw new GraphQLError(`Field '${columnName}' is not an array!`);
-      }
-      if (column.columnType === "PgGeometry" && value.length !== 2) {
-        throw new GraphQLError(
-          `Invalid float tuple in field '${columnName}': expected array with length of 2, received ${value.length}`
-        );
-      }
-      return value;
-    }
-    case "bigint": {
-      try {
-        return BigInt(value);
-      } catch (_error) {
-        throw new GraphQLError(`Field '${columnName}' is not a BigInt!`);
-      }
-    }
-    default: {
-      if (typeof value === "object" && value !== null && Object.getPrototypeOf(value) === null) {
-        return Object.assign({}, value);
-      }
-      return value;
-    }
-  }
-};
-var remapFromGraphQLSingleInput = (queryInput, table) => {
-  for (const [key, value] of Object.entries(queryInput)) {
-    if (value === void 0) {
-      delete queryInput[key];
-    } else {
-      const column = getTableColumns(table)[key];
-      if (!column) {
-        throw new GraphQLError(`Unknown column: ${key}`);
-      }
-      if (value === null && column.notNull) {
-        delete queryInput[key];
-        continue;
-      }
-      queryInput[key] = remapFromGraphQLCore(value, column, key);
-    }
-  }
-  return queryInput;
-};
-var remapFromGraphQLArrayInput = (queryInput, table) => {
-  for (const entry of queryInput) {
-    remapFromGraphQLSingleInput(entry, table);
-  }
-  return queryInput;
-};
+import { getTableColumns as getTableColumns2, is as is2, One } from "drizzle-orm";
+import { GraphQLError as GraphQLError2 } from "graphql";
+
+// src/util/type-converter/index.ts
+import { extractExtendedColumnType, getTableColumns, is } from "drizzle-orm";
+import { MySqlInt, MySqlSerial } from "drizzle-orm/mysql-core";
+import { PgDate, PgDateString, PgInteger, PgSerial, PgTimestamp, PgTimestampString, PgUUID } from "drizzle-orm/pg-core";
+import { SQLiteInteger } from "drizzle-orm/sqlite-core";
+import {
+  GraphQLBoolean,
+  GraphQLEnumType,
+  GraphQLFloat,
+  GraphQLInputObjectType,
+  GraphQLInt,
+  GraphQLList,
+  GraphQLNonNull,
+  GraphQLObjectType,
+  GraphQLScalarType as GraphQLScalarType2,
+  GraphQLString
+} from "graphql";
 
 // src/util/scalars/index.ts
-import { GraphQLError as GraphQLError2, GraphQLScalarType, Kind } from "graphql";
+import { GraphQLError, GraphQLScalarType, Kind } from "graphql";
 import { GraphQLDate, GraphQLDateTime, GraphQLJSON, GraphQLUUID } from "graphql-scalars";
 var asDecimalString = (value) => {
   if (typeof value === "bigint") {
@@ -305,10 +135,10 @@ var asDecimalString = (value) => {
   }
   if (typeof value === "number") {
     if (!Number.isInteger(value)) {
-      throw new GraphQLError2(`BigInt cannot represent non-integer value: ${value}`);
+      throw new GraphQLError(`BigInt cannot represent non-integer value: ${value}`);
     }
     if (!Number.isSafeInteger(value)) {
-      throw new GraphQLError2(
+      throw new GraphQLError(
         `BigInt cannot represent the number ${value} without precision loss \u2014 pass it as a string instead`
       );
     }
@@ -316,11 +146,11 @@ var asDecimalString = (value) => {
   }
   if (typeof value === "string") {
     if (!/^-?\d+$/.test(value)) {
-      throw new GraphQLError2(`BigInt cannot represent non-integer value: "${value}"`);
+      throw new GraphQLError(`BigInt cannot represent non-integer value: "${value}"`);
     }
     return value;
   }
-  throw new GraphQLError2(`BigInt cannot represent value: ${JSON.stringify(value)}`);
+  throw new GraphQLError(`BigInt cannot represent value: ${JSON.stringify(value)}`);
 };
 var GraphQLBigIntString = new GraphQLScalarType({
   name: "BigInt",
@@ -329,7 +159,7 @@ var GraphQLBigIntString = new GraphQLScalarType({
   parseValue: asDecimalString,
   parseLiteral: (ast) => {
     if (ast.kind !== Kind.STRING && ast.kind !== Kind.INT) {
-      throw new GraphQLError2(`BigInt cannot represent a ${ast.kind}`, { nodes: ast });
+      throw new GraphQLError(`BigInt cannot represent a ${ast.kind}`, { nodes: ast });
     }
     return asDecimalString(ast.value);
   }
@@ -341,17 +171,17 @@ var asNumericString = (value) => {
   }
   if (typeof value === "number") {
     if (!Number.isFinite(value)) {
-      throw new GraphQLError2(`Decimal cannot represent non-finite value: ${value}`);
+      throw new GraphQLError(`Decimal cannot represent non-finite value: ${value}`);
     }
     return String(value);
   }
   if (typeof value === "string") {
     if (!numericStringPattern.test(value)) {
-      throw new GraphQLError2(`Decimal cannot represent non-numeric value: "${value}"`);
+      throw new GraphQLError(`Decimal cannot represent non-numeric value: "${value}"`);
     }
     return value;
   }
-  throw new GraphQLError2(`Decimal cannot represent value: ${JSON.stringify(value)}`);
+  throw new GraphQLError(`Decimal cannot represent value: ${JSON.stringify(value)}`);
 };
 var GraphQLDecimalString = new GraphQLScalarType({
   name: "Decimal",
@@ -360,38 +190,50 @@ var GraphQLDecimalString = new GraphQLScalarType({
   parseValue: asNumericString,
   parseLiteral: (ast) => {
     if (ast.kind !== Kind.STRING && ast.kind !== Kind.INT && ast.kind !== Kind.FLOAT) {
-      throw new GraphQLError2(`Decimal cannot represent a ${ast.kind}`, { nodes: ast });
+      throw new GraphQLError(`Decimal cannot represent a ${ast.kind}`, { nodes: ast });
     }
     return asNumericString(ast.value);
   }
 });
 
 // src/util/type-converter/index.ts
-import { extractExtendedColumnType, is as is2 } from "drizzle-orm";
-import { MySqlInt, MySqlSerial } from "drizzle-orm/mysql-core";
-import { PgDate, PgDateString, PgInteger, PgSerial, PgTimestamp, PgTimestampString, PgUUID } from "drizzle-orm/pg-core";
-import { SQLiteInteger } from "drizzle-orm/sqlite-core";
-import {
-  GraphQLBoolean,
-  GraphQLEnumType,
-  GraphQLFloat,
-  GraphQLInputObjectType,
-  GraphQLInt,
-  GraphQLList,
-  GraphQLNonNull,
-  GraphQLObjectType,
-  GraphQLString
-} from "graphql";
 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,
@@ -400,7 +242,7 @@ var generateEnumCached = (column, columnName, tableName) => {
       ])
     )
   });
-  enumMap.set(column, gqlEnum);
+  enumNamesInUse.set(name, { type: gqlEnum, valuesKey });
   return gqlEnum;
 };
 var geoXyType = new GraphQLObjectType({
@@ -421,100 +263,343 @@ 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, typeLabel };
+  }
+  return columnBaseToGraphQLCore(column, columnName, tableName, isInput);
+};
+var columnBaseToGraphQLCore = (column, columnName, tableName, isInput) => {
+  const { type: baseType, constraint } = extractExtendedColumnType(column);
+  switch (baseType) {
+    case "boolean":
+      return { type: GraphQLBoolean, typeLabel: "Boolean" };
+    case "object":
+      if (column instanceof PgTimestamp || column instanceof PgDate) {
+        return { type: GraphQLDateTime, typeLabel: "DateTime" };
+      }
+      return column.columnType === "PgGeometryObject" ? {
+        type: isInput ? geoXyInputType : geoXyType,
+        typeLabel: "Geometry points XY"
+      } : column.columnType === "PgBytea" ? {
+        type: new GraphQLList(new GraphQLNonNull(GraphQLInt)),
+        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, typeLabel: "Decimal" };
+      }
+      if (column instanceof PgTimestamp || column instanceof PgTimestampString) {
+        return { type: GraphQLDateTime, typeLabel: "DateTime" };
+      }
+      if (column instanceof PgUUID) {
+        return { type: GraphQLUUID, typeLabel: "UUID" };
+      }
+      if (column instanceof PgDateString) {
+        return isInput ? { type: GraphQLString, typeLabel: "Date" } : { type: GraphQLDate, typeLabel: "Date" };
+      }
+      return { type: GraphQLString, typeLabel: "String" };
+    case "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, typeLabel: "Integer" } : { type: GraphQLFloat, typeLabel: "Float" };
+    }
+    case "array": {
+      if (column.columnType === "PgVector") {
+        return {
+          type: new GraphQLList(new GraphQLNonNull(GraphQLFloat)),
+          typeLabel: "Array<Float>"
+        };
+      }
+      if (column.columnType === "PgGeometry") {
+        return {
+          type: new GraphQLList(new GraphQLNonNull(GraphQLFloat)),
+          typeLabel: "Tuple<[Float, Float]>"
+        };
+      }
+      const innerType = columnToGraphQLCore(
+        column.baseColumn,
+        columnName,
+        tableName,
+        isInput
+      );
+      return {
+        type: new GraphQLList(new GraphQLNonNull(innerType.type)),
+        typeLabel: `Array<${innerType.typeLabel}>`
+      };
+    }
+    default:
+      throw new Error(`Drizzle-GraphQL Error: Type ${column.dataType} is not implemented!`);
+  }
+};
+var columnScalarOverrides = /* @__PURE__ */ new WeakMap();
+var getColumnScalarOverride = (column, isInput) => {
+  const override = columnScalarOverrides.get(column);
+  return override ? isInput ? override.input : override.output : void 0;
+};
+var normalizeScalarOverride = (override, tableName, columnName) => {
+  const pair = override instanceof GraphQLScalarType2 ? { output: override, input: override } : { output: override.output, input: override.input };
+  for (const scalar of [pair.output, pair.input]) {
+    if (scalar !== void 0 && !(scalar instanceof GraphQLScalarType2)) {
+      throw new Error(
+        `Drizzle-GraphQL Error: Scalar override for column '${tableName}.${columnName}' must be a GraphQLScalarType!`
+      );
+    }
+  }
+  return pair;
+};
+var registerScalarOverrides = (tables, config) => {
+  for (const [tableName, table] of Object.entries(tables)) {
+    for (const [columnName, column] of Object.entries(getTableColumns(table))) {
+      const declared = config.scalars?.[tableName]?.[columnName];
+      let resolved;
+      if (declared !== void 0) {
+        resolved = normalizeScalarOverride(declared, tableName, columnName);
+      } else if (config.mapColumnType) {
+        let defaultType;
+        let defaultInputType;
+        try {
+          defaultType = columnToGraphQLCore(column, columnName, tableName, false).type;
+        } catch {
+        }
+        try {
+          defaultInputType = columnToGraphQLCore(column, columnName, tableName, true).type;
+        } catch {
+        }
+        const mapped = config.mapColumnType(column, { tableName, columnName, defaultType, defaultInputType });
+        if (mapped !== void 0) {
+          resolved = normalizeScalarOverride(mapped, tableName, columnName);
+        }
+      }
+      if (resolved && (resolved.output !== void 0 || resolved.input !== void 0)) {
+        columnScalarOverrides.set(column, resolved);
+      } else {
+        columnScalarOverrides.delete(column);
+      }
+    }
+  }
+};
+var drizzleColumnToGraphQLType = (column, columnName, tableName, forceNullable = false, defaultIsNullable = false, isInput = false) => {
+  const override = getColumnScalarOverride(column, isInput);
+  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),
+      typeLabel: typeDesc.typeLabel
+    };
+  }
+  return typeDesc;
+};
+
+// src/util/data-mappers/index.ts
+var isJsonColumn = (column) => (column.dataType ?? "").includes("json") && column.columnType !== "PgGeometryObject";
+var remapToGraphQLCore = (key, value, tableName, column, relationMap) => {
+  if (Array.isArray(value)) {
+    const relations = relationMap?.[tableName];
+    if (relations?.[key]) {
+      const rel = relations[key];
+      return remapToGraphQLArrayOutput(
+        value,
+        rel.targetTableName,
+        rel.relation?.targetTable ?? rel.relation?.referencedTable,
+        relationMap
+      );
+    }
+  }
+  if (typeof value === "object" && value !== null) {
+    const relations = relationMap?.[tableName];
+    if (relations?.[key]) {
+      const rel = relations[key];
+      const remapped = remapToGraphQLSingleOutput(
+        value,
+        rel.targetTableName,
+        rel.relation?.targetTable ?? rel.relation?.referencedTable,
+        relationMap
+      );
+      return remapped;
+    }
+  }
+  if (!column) {
+    return value;
+  }
+  if (getColumnScalarOverride(column, false)) {
+    return value;
+  }
+  if (isJsonColumn(column)) {
+    return value;
+  }
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (value instanceof Buffer) {
+    return Array.from(value);
+  }
+  if (typeof value === "bigint") {
+    return value.toString();
+  }
+  if (Array.isArray(value)) {
+    if (column.columnType === "PgGeometry" || column.columnType === "PgVector") {
+      return value;
+    }
+    return value.map((arrVal) => remapToGraphQLCore(key, arrVal, tableName, column, relationMap));
+  }
+  if (typeof value === "object" && value !== null) {
+    if (column.columnType === "PgGeometryObject") {
+      return value;
+    }
+    return JSON.stringify(value);
+  }
+  return value;
+};
+var remapToGraphQLSingleOutput = (queryOutput, tableName, table, relationMap) => {
+  for (const [key, value] of Object.entries(queryOutput)) {
+    if (value === void 0 || value === null) {
+      const relEntry = value === null ? relationMap?.[tableName]?.[key] : void 0;
+      if (relEntry && is2(relEntry.relation, One)) {
+        queryOutput[key] = null;
+        continue;
+      }
+      delete queryOutput[key];
+      continue;
+    }
+    const column = table[key];
+    if (value === 0n && column && column.columnType === "SQLiteBigInt" && !column.notNull) {
+      delete queryOutput[key];
+      continue;
+    }
+    queryOutput[key] = remapToGraphQLCore(key, value, tableName, column, relationMap);
+  }
+  return queryOutput;
+};
+var remapToGraphQLArrayOutput = (queryOutput, tableName, table, relationMap) => {
+  for (const entry of queryOutput) {
+    remapToGraphQLSingleOutput(entry, tableName, table, relationMap);
+  }
+  return queryOutput;
+};
+var remapFromGraphQLCore = (value, column, columnName) => {
+  if (getColumnScalarOverride(column, true)) {
+    if (typeof value === "object" && value !== null && Object.getPrototypeOf(value) === null) {
+      return Object.assign({}, value);
+    }
+    return value;
+  }
+  const dataType = column.dataType ?? "";
+  const columnType = column.columnType ?? "";
+  const isTimestampColumn = columnType === "SQLiteTimestamp" || columnType === "SQLiteTimestampMs" || columnType === "MySqlTimestamp" || columnType === "MySqlDateTime" || columnType === "PgTimestamp" || columnType === "PgTimestampString";
+  if (isTimestampColumn) {
+    const formatted = new Date(value);
+    if (Number.isNaN(formatted.getTime())) {
+      throw new GraphQLError2(`Field '${columnName}' is not a valid date!`);
+    }
+    return formatted;
+  }
+  const isDateOnlyColumn = columnType === "MySqlDate" || columnType === "PgDate";
+  if (isDateOnlyColumn && typeof value === "string") {
+    const dateOnly = value.includes("T") ? value.split("T")[0] : value;
+    const check = new Date(dateOnly);
+    if (Number.isNaN(check.getTime())) {
+      throw new GraphQLError2(`Field '${columnName}' is not a valid date!`);
+    }
+    return dateOnly;
+  }
+  if (dataType.includes("bigint")) {
+    try {
+      return BigInt(value);
+    } catch {
+      throw new GraphQLError2(`Field '${columnName}' is not a BigInt!`);
     }
-    return { type, description };
   }
-  return columnBaseToGraphQLCore(column, columnName, tableName, isInput);
-};
-var columnBaseToGraphQLCore = (column, columnName, tableName, isInput) => {
-  const { type: baseType, constraint } = extractExtendedColumnType(column);
-  switch (baseType) {
-    case "boolean":
-      return { type: GraphQLBoolean, description: "Boolean" };
-    case "object":
-      if (column instanceof PgTimestamp || column instanceof PgDate) {
-        return { type: GraphQLDateTime, description: "DateTime" };
+  if (dataType.includes("json") && column.columnType !== "PgGeometryObject") {
+    return value;
+  }
+  switch (dataType) {
+    case "date": {
+      const formatted = new Date(value);
+      if (Number.isNaN(formatted.getTime())) {
+        throw new GraphQLError2(`Field '${columnName}' is not a valid date!`);
       }
-      return column.columnType === "PgGeometryObject" ? {
-        type: isInput ? geoXyInputType : geoXyType,
-        description: "Geometry points XY"
-      } : column.columnType === "PgBytea" ? {
-        type: new GraphQLList(new GraphQLNonNull(GraphQLInt)),
-        description: "Buffer"
-      } : { type: GraphQLJSON, description: "JSON" };
-    case "string":
-      if (column.enumValues?.length) {
-        return { type: generateEnumCached(column, columnName, tableName) };
+      return formatted;
+    }
+    case "buffer": {
+      if (!Array.isArray(value)) {
+        throw new GraphQLError2(`Field '${columnName}' is not an array!`);
       }
-      if (constraint === "numeric" && !column.dimensions) {
-        return { type: GraphQLDecimalString, description: "Decimal" };
+      return Buffer.from(value);
+    }
+    case "json": {
+      if (column.columnType === "PgGeometryObject") {
+        return value;
       }
-      if (column instanceof PgTimestamp || column instanceof PgTimestampString) {
-        return { type: GraphQLDateTime, description: "DateTime" };
+      try {
+        return JSON.parse(value);
+      } catch (e) {
+        throw new GraphQLError2(
+          `Invalid JSON in field '${columnName}':
+${e instanceof Error ? e.message : "Unknown error"}`
+        );
       }
-      if (column instanceof PgUUID) {
-        return { type: GraphQLUUID, description: "UUID" };
+    }
+    case "array": {
+      if (!Array.isArray(value)) {
+        throw new GraphQLError2(`Field '${columnName}' is not an array!`);
       }
-      if (column instanceof PgDateString) {
-        return isInput ? { type: GraphQLString, description: "Date" } : { type: GraphQLDate, description: "Date" };
+      if (column.columnType === "PgGeometry" && value.length !== 2) {
+        throw new GraphQLError2(
+          `Invalid float tuple in field '${columnName}': expected array with length of 2, received ${value.length}`
+        );
       }
-      return { type: GraphQLString, description: "String" };
-    case "bigint":
-      return { type: GraphQLBigIntString, description: "BigInt" };
-    case "number": {
-      return is2(column, PgInteger) || is2(column, PgSerial) || is2(column, MySqlInt) || is2(column, MySqlSerial) || is2(column, SQLiteInteger) ? { type: GraphQLInt, description: "Integer" } : { type: GraphQLFloat, description: "Float" };
+      return value;
     }
-    case "array": {
-      if (column.columnType === "PgVector") {
-        return {
-          type: new GraphQLList(new GraphQLNonNull(GraphQLFloat)),
-          description: "Array<Float>"
-        };
+    case "bigint": {
+      try {
+        return BigInt(value);
+      } catch (_error) {
+        throw new GraphQLError2(`Field '${columnName}' is not a BigInt!`);
       }
-      if (column.columnType === "PgGeometry") {
-        return {
-          type: new GraphQLList(new GraphQLNonNull(GraphQLFloat)),
-          description: "Tuple<[Float, Float]>"
-        };
+    }
+    default: {
+      if (typeof value === "object" && value !== null && Object.getPrototypeOf(value) === null) {
+        return Object.assign({}, value);
       }
-      const innerType = columnToGraphQLCore(
-        column.baseColumn,
-        columnName,
-        tableName,
-        isInput
-      );
-      return {
-        type: new GraphQLList(new GraphQLNonNull(innerType.type)),
-        description: `Array<${innerType.description}>`
-      };
+      return value;
     }
-    default:
-      throw new Error(`Drizzle-GraphQL Error: Type ${column.dataType} is not implemented!`);
   }
 };
-var drizzleColumnToGraphQLType = (column, columnName, tableName, forceNullable = false, defaultIsNullable = false, isInput = false) => {
-  const 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;
-  }
-  if (forceNullable) {
-    return typeDesc;
+var remapFromGraphQLSingleInput = (queryInput, table) => {
+  for (const [key, value] of Object.entries(queryInput)) {
+    if (value === void 0) {
+      delete queryInput[key];
+    } else {
+      const column = getTableColumns2(table)[key];
+      if (!column) {
+        throw new GraphQLError2(`Unknown column: ${key}`);
+      }
+      if (value === null && column.notNull) {
+        delete queryInput[key];
+        continue;
+      }
+      queryInput[key] = remapFromGraphQLCore(value, column, key);
+    }
   }
-  if (column.notNull && !(defaultIsNullable && (column.hasDefault || column.defaultFn))) {
-    return {
-      type: new GraphQLNonNull(typeDesc.type),
-      description: typeDesc.description
-    };
+  return queryInput;
+};
+var remapFromGraphQLArrayInput = (queryInput, table) => {
+  for (const entry of queryInput) {
+    remapFromGraphQLSingleInput(entry, table);
   }
-  return typeDesc;
+  return queryInput;
 };
 
 // src/util/builders/common.ts
@@ -894,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;
@@ -901,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;
@@ -934,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) {
@@ -954,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) {
@@ -1075,44 +1179,69 @@ 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 }
   };
 };
 var FILTERS_WITHOUT_STRING_OPS = /* @__PURE__ */ new Set(["Id", "Int", "Float", "BigInt", "Decimal"]);
+var BUILTIN_FILTER_SCALARS = /* @__PURE__ */ new Set([
+  GraphQLString2,
+  GraphQLInt2,
+  GraphQLFloat2,
+  GraphQLBoolean2,
+  GraphQLBigIntString,
+  GraphQLDecimalString,
+  GraphQLUUID,
+  GraphQLJSON,
+  GraphQLDate,
+  GraphQLDateTime
+]);
+var resolveOverrideFilterDescriptor = (scalar) => {
+  if (scalar === GraphQLJSON) {
+    return { name: "JSON", kind: "json" };
+  }
+  if (scalar === GraphQLUUID) {
+    return { name: "Id", kind: "scalar" };
+  }
+  return { name: scalar.name, kind: "scalar" };
+};
 var generateColumnFilterValues = (column, tableName, columnName, cacheCtx) => {
   const columnGraphQLType = drizzleColumnToGraphQLType(column, columnName, tableName, true, false, true);
-  const { name: genericName, kind } = resolveGenericFilterDescriptor(column, columnGraphQLType);
+  const inputOverride = getColumnScalarOverride(column, true);
+  const { name: genericName, kind } = inputOverride ? resolveOverrideFilterDescriptor(inputOverride) : resolveGenericFilterDescriptor(column, columnGraphQLType);
   const cached = cacheCtx.genericFilterCache.get(genericName);
   if (cached) {
     return cached;
   }
   const colType = columnGraphQLType.type;
-  const colDesc = columnGraphQLType.description;
   const colArr = new GraphQLList2(new GraphQLNonNull2(colType));
-  const omitStringOps = 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 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) : {
+    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 },
@@ -1143,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`,
@@ -1186,35 +1315,40 @@ var generateTableOrderCached = (table) => {
   }
   return remapped;
 };
-var filterMap = /* @__PURE__ */ new WeakMap();
 var generateTableFilterValuesCached = (table, tableName, cacheCtx) => {
-  if (filterMap.has(table)) {
-    return filterMap.get(table);
+  if (cacheCtx.filterFieldCache.has(table)) {
+    return cacheCtx.filterFieldCache.get(table);
   }
   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 }) } : {}
       }
     ])
   );
-  filterMap.set(table, remapped);
+  cacheCtx.filterFieldCache.set(table, remapped);
   return remapped;
 };
-var fieldMap = /* @__PURE__ */ new WeakMap();
-var generateTableSelectTypeFieldsCached = (table, tableName) => {
-  if (fieldMap.has(table)) {
-    return fieldMap.get(table);
+var generateTableSelectTypeFieldsCached = (table, tableName, cacheCtx) => {
+  if (cacheCtx.selectFieldCache.has(table)) {
+    return cacheCtx.selectFieldCache.get(table);
   }
   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]) {
@@ -1224,7 +1358,7 @@ var generateTableSelectTypeFieldsCached = (table, tableName) => {
       resolve: rowCursorResolver
     };
   }
-  fieldMap.set(table, remapped);
+  cacheCtx.selectFieldCache.set(table, remapped);
   return remapped;
 };
 var isFilterableRelation = (relation) => !relation.through;
@@ -1374,7 +1508,7 @@ var generateSelectFields = (tables, tableName, relationMap, fromTableName, fromR
   const table = tables[tableName];
   const order = withOrder ? generateTableOrderTypeCached(table, tableName, typeNameMapper, cacheCtx, relationMap, tables) : void 0;
   const filters = generateTableFilterTypeCached(table, tableName, cacheCtx, typeNameMapper, relationMap, tables);
-  const tableFields = generateTableSelectTypeFieldsCached(table, tableName);
+  const tableFields = generateTableSelectTypeFieldsCached(table, tableName, cacheCtx);
   const relationsForTable = relationMap[tableName];
   const relationEntries = relationsForTable ? Object.entries(relationsForTable) : [];
   if (relationsDepthLimit !== void 0 && currentDepth >= relationsDepthLimit) {
@@ -1411,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);
@@ -1443,7 +1578,7 @@ var generateSelectFields = (tables, tableName, relationMap, fromTableName, fromR
       let relType = cacheCtx.objectTypeCache.get(targetTableName);
       if (!relType) {
         const targetTable = tables[targetTableName];
-        const targetTableFields = generateTableSelectTypeFieldsCached(targetTable, targetTableName);
+        const targetTableFields = generateTableSelectTypeFieldsCached(targetTable, targetTableName, cacheCtx);
         let targetContainer = cacheCtx.relationFieldContainers.get(targetTableName);
         if (!targetContainer) {
           targetContainer = { fields: {} };
@@ -1452,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([
@@ -1466,7 +1604,8 @@ var generateSelectFields = (tables, tableName, relationMap, fromTableName, fromR
             args: {
               where: { type: relSelectData.filters }
             },
-            resolve
+            resolve,
+            ...relationDocs
           }
         ]);
         continue;
@@ -1482,6 +1621,7 @@ var generateSelectFields = (tables, tableName, relationMap, fromTableName, fromR
             limit: { type: GraphQLInt2 }
           },
           resolve,
+          ...relationDocs,
           ...cacheCtx.complexity ? { extensions: { complexity: listFieldComplexity(cacheCtx.complexity) } } : {}
         }
       ]);
@@ -1529,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,
@@ -1550,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)));
@@ -1963,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) {
@@ -1971,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;
@@ -2577,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
@@ -2706,7 +2871,7 @@ import {
   count,
   countDistinct,
   eq as eq2,
-  extractExtendedColumnType as extractExtendedColumnType2,
+  extractExtendedColumnType as extractExtendedColumnType3,
   getColumns as getColumns2,
   gt as gt2,
   gte as gte2,
@@ -2750,7 +2915,7 @@ var classifyAggregateColumns = (table, tableName) => {
     if (gqlType instanceof GraphQLList3 || gqlType instanceof GraphQLObjectType3) {
       continue;
     }
-    const { type: dataType, constraint } = extractExtendedColumnType2(column);
+    const { type: dataType, constraint } = extractExtendedColumnType3(column);
     if (dataType === "boolean" || dataType === "array" || dataType === "custom") {
       continue;
     }
@@ -2789,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) }
             ])
           )
         })
@@ -2838,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)
     )
   };
 };
@@ -2991,7 +3156,7 @@ var groupableColumns = (table, tableName) => {
     if (groupable[columnName]) {
       continue;
     }
-    const { type: dataType } = extractExtendedColumnType2(column);
+    const { type: dataType } = extractExtendedColumnType3(column);
     if (dataType !== "boolean") {
       continue;
     }
@@ -3056,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) }
       ])
     )
   });
@@ -3458,6 +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);
@@ -3469,11 +3641,14 @@ var generateSchemaData = (db, schema, relations, options) => {
     relationFieldContainers: /* @__PURE__ */ new Map(),
     fullyBuiltTables: /* @__PURE__ */ new Set(),
     relationTypeCache: /* @__PURE__ */ new Map(),
+    selectFieldCache: /* @__PURE__ */ new WeakMap(),
+    filterFieldCache: /* @__PURE__ */ new WeakMap(),
     orderTypeCache: /* @__PURE__ */ new WeakMap(),
     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 = {};
@@ -3721,58 +3896,443 @@ var generateSchemaData = (db, schema, relations, options) => {
         };
       }
     }
-    const activeInputs = [
-      // The insert input types the upsert mutations too, so either feature keeps it.
-      ...features.insert || onConflictInput ? [insertInput] : [],
-      ...onConflictInput ? [onConflictInput] : [],
-      ...features.update ? [updateInput] : [],
-      ...updateManyInput ? [updateManyInput] : [],
-      tableFilters,
-      tableOrder
-    ];
-    activeInputs.forEach((e) => {
-      inputs[e.name] = e;
+    const activeInputs = [
+      // The insert input types the upsert mutations too, so either feature keeps it.
+      ...features.insert || onConflictInput ? [insertInput] : [],
+      ...onConflictInput ? [onConflictInput] : [],
+      ...features.update ? [updateInput] : [],
+      ...updateManyInput ? [updateManyInput] : [],
+      tableFilters,
+      tableOrder
+    ];
+    activeInputs.forEach((e) => {
+      inputs[e.name] = e;
+    });
+    outputs[selectSingleOutput.name] = selectSingleOutput;
+    if (aggregateType) {
+      outputs[aggregateType.name] = aggregateType;
+    }
+    if (groupByType && havingInput) {
+      outputs[groupByType.name] = groupByType;
+      inputs[havingInput.name] = havingInput;
+    }
+  }
+  if (mutationTxCtx) {
+    for (const name of Object.keys(mutations)) {
+      mutationTxCtx.fieldNames.add(name);
+    }
+  }
+  const fieldResolvers = {};
+  for (const [tableName, tableRelations] of Object.entries(namedRelations)) {
+    const relResolvers = {};
+    for (const [relName, relEntry] of Object.entries(tableRelations)) {
+      const isOne = is4(relEntry.relation ?? relEntry, One3);
+      const resolver = resolverFactory({ tableName, relationName: relName, relEntry, isOne });
+      if (resolver) {
+        relResolvers[relName] = resolver;
+      }
+    }
+    if (Object.keys(relResolvers).length > 0) {
+      fieldResolvers[tableName] = relResolvers;
+    }
+  }
+  return { queries, mutations, inputs, types: outputs, fieldResolvers };
+};
+
+// src/util/builders/pg.ts
+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";
+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
     });
-    outputs[selectSingleOutput.name] = selectSingleOutput;
-    if (aggregateType) {
-      outputs[aggregateType.name] = aggregateType;
+    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;
     }
-    if (groupByType && havingInput) {
-      outputs[groupByType.name] = groupByType;
-      inputs[havingInput.name] = havingInput;
+  };
+};
+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.`
+      );
     }
-  }
-  if (mutationTxCtx) {
-    for (const name of Object.keys(mutations)) {
-      mutationTxCtx.fieldNames.add(name);
+    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 fieldResolvers = {};
-  for (const [tableName, tableRelations] of Object.entries(namedRelations)) {
-    const relResolvers = {};
-    for (const [relName, relEntry] of Object.entries(tableRelations)) {
-      const isOne = is4(relEntry.relation ?? relEntry, One3);
-      const resolver = resolverFactory({ tableName, relationName: relName, relEntry, isOne });
-      if (resolver) {
-        relResolvers[relName] = resolver;
+  };
+  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);
+            }
+          }
+        }
       }
     }
-    if (Object.keys(relResolvers).length > 0) {
-      fieldResolvers[tableName] = relResolvers;
+  };
+};
+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 { queries, mutations, inputs, types: outputs, fieldResolvers };
+    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
-import { and as and3, getColumns as getColumns3, is as is5, One as One4 } from "drizzle-orm";
-import { getTableConfig as getTableConfig2, PgTable } from "drizzle-orm/pg-core";
-import {
-  GraphQLError as GraphQLError6,
-  GraphQLList as GraphQLList5,
-  GraphQLNonNull as GraphQLNonNull5
-} from "graphql";
-import { parseResolveInfo as parseResolveInfo3 } from "graphql-parse-resolve-info";
 var generateSelectArray2 = (db, tableName, tables, relationMap, orderArgs, filterArgs, fieldName, typeName, typeNameMapper, filterCtx, distinctEnabled = true) => {
   const queryBase = db.query[tableName];
   const table = tables[tableName];
@@ -3817,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];
               }
@@ -3843,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({
@@ -3954,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);
@@ -3966,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
           });
@@ -3983,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);
         });
@@ -3998,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);
@@ -4010,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
           });
@@ -4024,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;
           }
@@ -4042,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,
@@ -4058,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,
@@ -4073,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;
           }
@@ -4099,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);
@@ -4128,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;
@@ -4159,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);
@@ -4173,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
@@ -4189,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;
           });
@@ -4235,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 {
@@ -4264,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;
@@ -4290,13 +4921,15 @@ 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(
       "Drizzle-GraphQL Error: No tables detected in Drizzle-ORM's database instance. Did you forget to pass schema to drizzle constructor?"
     );
   }
+  registerScalarOverrides(tables, options);
+  registerEnumConfig(options);
   const namedRelations = buildNamedRelations(relations ?? {}, tableEntries);
   attachTargetPrimaryKeys(namedRelations, tables, pgPrimaryKeyPropNames);
   const eagerRelations = pruneNonEagerRelations(namedRelations, shouldEagerLoad);
@@ -4308,12 +4941,24 @@ function generateSchemaData2(db, schema, relations, options) {
     relationFieldContainers: /* @__PURE__ */ new Map(),
     fullyBuiltTables: /* @__PURE__ */ new Set(),
     relationTypeCache: /* @__PURE__ */ new Map(),
+    selectFieldCache: /* @__PURE__ */ new WeakMap(),
+    filterFieldCache: /* @__PURE__ */ new WeakMap(),
     orderTypeCache: /* @__PURE__ */ new WeakMap(),
     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 = {};
@@ -4332,7 +4977,8 @@ function generateSchemaData2(db, schema, relations, options) {
         prefixes.insert,
         prefixes.update,
         resolverFactory,
-        relationAggregateFactory
+        relationAggregateFactory,
+        nestedTypes
       )
     ])
   );
@@ -4393,7 +5039,8 @@ function generateSchemaData2(db, schema, relations, options) {
       typeName,
       typeNameMapper,
       conflictDoNothing,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const insertSingleGenerated = features.insert ? generateInsertSingle2(
       db,
@@ -4406,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({
@@ -4430,7 +5078,8 @@ function generateSchemaData2(db, schema, relations, options) {
       false,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const upsertSingleGenerated = onConflictInput ? generateUpsert2(
       db,
@@ -4446,7 +5095,8 @@ function generateSchemaData2(db, schema, relations, options) {
       true,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateGenerated = features.update ? generateUpdate2(
       db,
@@ -4462,7 +5112,8 @@ function generateSchemaData2(db, schema, relations, options) {
       features.requireWhere,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateSingleGenerated = features.update ? generateUpdate2(
       db,
@@ -4478,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(
@@ -4492,7 +5144,8 @@ function generateSchemaData2(db, schema, relations, options) {
       typeName,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const deleteGenerated = features.delete ? generateDelete2(
       db,
@@ -4557,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) } } : {}
@@ -4565,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) } } : {}
@@ -4609,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
       };
@@ -4666,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;
@@ -4680,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) => {
@@ -4771,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);
@@ -4783,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
           });
@@ -4800,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);
         });
@@ -4815,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);
@@ -4827,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
           });
@@ -4841,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;
           }
@@ -4859,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,
@@ -4875,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,
@@ -4890,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;
           }
@@ -4916,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);
@@ -4945,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;
@@ -4976,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);
@@ -4990,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
@@ -5006,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 () => {
@@ -5065,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 {
@@ -5094,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;
@@ -5121,13 +5860,15 @@ 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(
       "Drizzle-GraphQL Error: No tables detected in Drizzle-ORM's database instance. Did you forget to pass schema to drizzle constructor?"
     );
   }
+  registerScalarOverrides(tables, options);
+  registerEnumConfig(options);
   const namedRelations = buildNamedRelations(relations ?? {}, tableEntries);
   attachTargetPrimaryKeys(namedRelations, tables, sqlitePrimaryKeyPropNames);
   const eagerRelations = pruneNonEagerRelations(namedRelations, shouldEagerLoad);
@@ -5139,12 +5880,29 @@ var generateSchemaData3 = (db, schema, relations, options) => {
     relationFieldContainers: /* @__PURE__ */ new Map(),
     fullyBuiltTables: /* @__PURE__ */ new Set(),
     relationTypeCache: /* @__PURE__ */ new Map(),
+    selectFieldCache: /* @__PURE__ */ new WeakMap(),
+    filterFieldCache: /* @__PURE__ */ new WeakMap(),
     orderTypeCache: /* @__PURE__ */ new WeakMap(),
     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 = {};
@@ -5168,7 +5926,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
         prefixes.insert,
         prefixes.update,
         resolverFactory,
-        relationAggregateFactory
+        relationAggregateFactory,
+        nestedTypes
       )
     ])
   );
@@ -5229,7 +5988,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       typeName,
       typeNameMapper,
       conflictDoNothing,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const insertSingleGenerated = features.insert ? generateInsertSingle3(
       db,
@@ -5242,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({
@@ -5266,7 +6027,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       false,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const upsertSingleGenerated = onConflictInput ? generateUpsert3(
       db,
@@ -5282,7 +6044,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       true,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateGenerated = features.update ? generateUpdate3(
       db,
@@ -5298,7 +6061,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       features.requireWhere,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const updateSingleGenerated = features.update ? generateUpdate3(
       db,
@@ -5314,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(
@@ -5328,7 +6093,8 @@ var generateSchemaData3 = (db, schema, relations, options) => {
       typeName,
       typeNameMapper,
       filterCtx,
-      mutationTxCtx
+      mutationTxCtx,
+      nestedRuntime
     ) : void 0;
     const deleteGenerated = features.delete ? generateDelete3(
       db,
@@ -5393,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) } } : {}
@@ -5401,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) } } : {}
@@ -5445,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
       };
@@ -5502,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;
@@ -5547,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;
@@ -5584,14 +6351,23 @@ var buildSchema = (db, config) => {
     shouldEagerLoad,
     features,
     complexity,
-    transactions
+    scalars: config?.scalars,
+    mapColumnType: config?.mapColumnType,
+    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");