@vantreeseba/drizzle-graphql 5.5.0 → 6.0.0

package/dist/index.d.cts

@@ -1,10 +1,103 @@
-import { Table, Column, Relation, SQL, One, Many } from 'drizzle-orm';
+import { Column, Table, Relation, SQL, One, Many } from 'drizzle-orm';
 import { MySqlDatabase } from 'drizzle-orm/mysql-core';
 import { PgAsyncDatabase } from 'drizzle-orm/pg-core';
 import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
-import { GraphQLFieldResolver, GraphQLResolveInfo, GraphQLSchema, GraphQLInputObjectType, GraphQLObjectType, GraphQLNonNull, GraphQLList, GraphQLScalarType, GraphQLEnumType } from 'graphql';
+import { GraphQLScalarType, GraphQLOutputType, GraphQLInputType, GraphQLFieldResolver, GraphQLResolveInfo, GraphQLSchema, GraphQLInputObjectType, GraphQLObjectType, GraphQLNonNull, GraphQLList, GraphQLEnumType } from 'graphql';
 export { GraphQLDate, GraphQLDateTime, GraphQLJSON, GraphQLUUID } from 'graphql-scalars';
 
+/**
+ * A scalar override for one column. A bare scalar applies to both directions; the object form
+ * lets output (object type, aggregate min/max) and input (create/update inputs, filter operands)
+ * use different scalars — or override only one side, leaving the other on built-in detection.
+ */
+type ScalarOverride = GraphQLScalarType | {
+    output?: GraphQLScalarType;
+    input?: GraphQLScalarType;
+};
+/**
+ * Declarative per-table, per-column scalar overrides. Keys are the Drizzle schema keys —
+ * the table's key in the schema object and the column's property name (not the SQL names).
+ */
+type ScalarOverridesConfig = Record<string, Record<string, ScalarOverride>>;
+/** Context handed to {@link ColumnTypeMapper} alongside the column itself. */
+type ColumnTypeMapperInfo = {
+    /** The table's key in the Drizzle schema object. */
+    tableName: string;
+    /** The column's property name on the table object. */
+    columnName: string;
+    /**
+     * The GraphQL type built-in detection would use for output positions (without nullability
+     * wrapping). `undefined` when detection has no mapping for the column's data type — the
+     * mapper is then the only way to give the column a type.
+     */
+    defaultType: GraphQLOutputType | undefined;
+    /** The input-position counterpart of `defaultType`. */
+    defaultInputType: GraphQLInputType | undefined;
+};
+/**
+ * Rule-based scalar mapping, called once per column at build time. Return a scalar (or
+ * `{ output, input }` pair) to override the column's GraphQL type, or `undefined` to keep
+ * the built-in detection.
+ */
+type ColumnTypeMapper = (column: Column, info: ColumnTypeMapperInfo) => ScalarOverride | undefined;
+/** Everything an {@link EnumNameMapper} needs to name — or opt a column out of — a generated enum type. */
+type EnumNameInfo = {
+    /**
+     * The name the enum type was declared with (`pgEnum('status', …)`), shared by every column
+     * that uses it. `undefined` for an inline value list (`text({ enum: [...] })`,
+     * `mysqlEnum(...)`), which belongs to the one column that declares it.
+     */
+    enumName: string | undefined;
+    /** The Postgres schema the named enum was declared in, when it declares one. */
+    schema: string | undefined;
+    /** The table's key in the Drizzle schema object. */
+    tableName: string;
+    /** The column's property name on the table object. */
+    columnName: string;
+    /** The enum's values, in declaration order. */
+    values: readonly string[];
+};
+/**
+ * Names a generated GraphQL enum type. Return `undefined` to keep the default name. See
+ * `BuildSchemaConfig.enumNameMapper`.
+ */
+type EnumNameMapper = (info: EnumNameInfo) => string | undefined;
+/** Context handed to the documentation and deprecation hooks alongside the column itself. */
+type ColumnDocInfo = {
+    /** The table's key in the Drizzle schema object. */
+    tableName: string;
+    /** The column's property name on the table object. */
+    columnName: string;
+};
+/**
+ * Supplies the GraphQL `description` for a generated column field. See
+ * `BuildSchemaConfig.describeColumn`.
+ */
+type ColumnDescriber = (column: Column, info: ColumnDocInfo) => string | undefined;
+/**
+ * Supplies the GraphQL `deprecationReason` for a generated column field. See
+ * `BuildSchemaConfig.deprecateColumn`.
+ */
+type ColumnDeprecator = (column: Column, info: ColumnDocInfo) => string | undefined;
+/** Supplies the GraphQL `description` for a table's object type. See `BuildSchemaConfig.describeTable`. */
+type TableDescriber = (tableName: string) => string | undefined;
+/**
+ * Supplies the GraphQL `description` for a relation field. See
+ * `BuildSchemaConfig.describeRelation`.
+ */
+type RelationDescriber = (tableName: string, relationName: string) => string | undefined;
+/**
+ * The documentation hooks a build was configured with, resolved once and threaded through
+ * type generation. Every member is optional; a build with no hooks generates fields with no
+ * descriptions at all.
+ */
+type SchemaDocs = {
+    describeColumn?: ColumnDescriber;
+    describeTable?: TableDescriber;
+    describeRelation?: RelationDescriber;
+    deprecateColumn?: ColumnDeprecator;
+};
+
 type TableNamedRelations = {
     relation: Relation;
     targetTableName: string;
@@ -544,6 +637,38 @@ type SchemaFeatures = {
      * @default false
      */
     upsert?: boolean;
+    /**
+     * Relation fields on `Create<Table>Input` and `Update<Table>Input`, so a parent row and
+     * the rows it is related to can be written in one mutation. Off unless asked for: it adds
+     * a field per writable relation to every create and update input.
+     *
+     * ```graphql
+     * createPostsSingle(values: {
+     *   title: "Hello"
+     *   author: { connect: { id: { eq: "a1" } } }
+     *   tags: { create: [{ name: "drizzle" }] }
+     * }) { id }
+     * ```
+     *
+     * Each relation field offers `create` and `connect`; the update input adds `disconnect`
+     * and, for a to-many relation, `set` (replace the whole set). `disconnect` and `set` are
+     * generated only when the foreign key is nullable — there is no way to detach a row whose
+     * key is NOT NULL — and many-to-many (`.through()`) relations are not written through at
+     * all. Nesting is one level deep: the row a nested `create` inserts takes columns only.
+     *
+     * The whole tree runs in one transaction (a savepoint when the request already carries
+     * one), and a column a relation fills in (`authorId`, when `author: { create: … }` is
+     * offered) becomes nullable on the create input, since the relation is the other way to
+     * supply it.
+     *
+     * PostgreSQL and SQLite only. MySQL cannot return the rows it just wrote, which is how a
+     * nested write learns the parent's key, so `buildSchema` rejects the flag there. On SQLite
+     * the driver must be asynchronous (libsql, D1, …): a synchronous one commits before an
+     * awaited statement runs, so `buildSchema` rejects the combination outright.
+     *
+     * @default false
+     */
+    nestedWrites?: boolean;
     /**
      * Makes `where` non-null on the plural `update<Table>` / `delete<Table>` mutations, and
      * rejects a `where` that collapses to no filters (e.g. `where: {}`), so a schema can rule
@@ -774,6 +899,56 @@ type BuildSchemaConfig = {
      * @default true
      */
     eagerLoadRelations?: boolean | ((tableName: string, relationName: string) => boolean);
+    /**
+     * Declarative per-table, per-column scalar overrides — replaces the GraphQL type built-in
+     * detection would pick for a column with the scalar you provide, everywhere that column's
+     * type surfaces: the object type, create/update inputs, filter operands (in a filter type
+     * named `${Scalar}Filter`), and aggregate min/max fields.
+     *
+     * Keys are the Drizzle schema keys: the table's key in your schema object and the column's
+     * property name. The value is either one scalar for both directions, or `{ output, input }`
+     * to type outputs and inputs differently (either side may be omitted to keep the default).
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   scalars: {
+     *     users: {
+     *       balance: GraphQLBigIntString,                      // both directions
+     *       settings: { output: PrettyJSON },                  // output only, input stays default
+     *     },
+     *   },
+     * });
+     * ```
+     *
+     * Validation and coercion become the scalar's job: for an overridden column the generated
+     * resolvers pass values through untouched — `parseValue`/`parseLiteral` results go to the
+     * database driver as-is, and raw driver values go to `serialize` as-is — so the scalar must
+     * accept what the driver produces and produce what the driver accepts.
+     *
+     * A declarative entry fully decides its column and wins over {@link mapColumnType}.
+     */
+    scalars?: ScalarOverridesConfig;
+    /**
+     * Rule-based scalar mapping, called once per column at build time — the tool for applying
+     * a convention across many columns (e.g. "every `numeric` column is `Money`") or for typing
+     * custom column types the built-in detection does not know.
+     *
+     * Return a scalar (or `{ output, input }` pair) to override the column, or `undefined` to
+     * keep the default. `info` carries the table/column schema keys and the types built-in
+     * detection would use (`defaultType` / `defaultInputType`), so rules can key off either the
+     * Drizzle column or the default GraphQL type.
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   mapColumnType: (column, { columnName }) =>
+     *     column.columnType === 'PgNumeric' ? MoneyScalar : undefined,
+     * });
+     * ```
+     *
+     * Same semantics as {@link scalars} otherwise; a column matched by both is decided by
+     * `scalars` alone.
+     */
+    mapColumnType?: ColumnTypeMapper;
     /**
      * Called for every error thrown by a generated resolver, before it reaches the client.
      *
@@ -798,6 +973,94 @@ type BuildSchemaConfig = {
      * ```
      */
     onError?: (error: unknown) => unknown;
+    /**
+     * Supplies the GraphQL `description` for a column, everywhere that column becomes a field:
+     * the object type, the create/update inputs, the filter input, and the aggregate
+     * `min`/`max`/`group` fields.
+     *
+     * Nothing is generated by default. The library used to emit the column's own type name
+     * ("DateTime", "JSON") as its description, which documented nothing a reader could not see
+     * from the type — that is gone, and this hook is what puts real prose in its place. Drizzle
+     * carries no column-comment metadata to read, so the text has to come from here.
+     *
+     * ```ts
+     * const columnDocs = { Users: { email: 'Primary contact address. Unique, case-insensitive.' } };
+     *
+     * buildSchema(db, {
+     *   describeColumn: (_column, { tableName, columnName }) => columnDocs[tableName]?.[columnName],
+     * });
+     * ```
+     *
+     * `tableName` and `columnName` are the Drizzle schema keys. Return `undefined` to leave the
+     * field undocumented.
+     */
+    describeColumn?: ColumnDescriber;
+    /**
+     * Supplies the GraphQL `description` for a table's object type.
+     *
+     * ```ts
+     * buildSchema(db, { describeTable: (tableName) => tableDocs[tableName] });
+     * ```
+     */
+    describeTable?: TableDescriber;
+    /**
+     * Supplies the GraphQL `description` for a relation field on a table's object type.
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   describeRelation: (tableName, relationName) =>
+     *     tableName === 'Users' && relationName === 'posts' ? 'Posts this user authored.' : undefined,
+     * });
+     * ```
+     *
+     * The generated `<relation>Aggregate` companion fields are not covered — they are derived
+     * fields rather than the relation itself.
+     */
+    describeRelation?: RelationDescriber;
+    /**
+     * Supplies the GraphQL `deprecationReason` for a column, marking it `@deprecated` on the
+     * object type and on the create/update inputs.
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   deprecateColumn: (_column, { columnName }) =>
+     *     columnName === 'legacyFlag' ? 'Use `status` instead.' : undefined,
+     * });
+     * ```
+     *
+     * A required input field cannot be deprecated — GraphQL rejects the schema, since a client
+     * has no way to stop sending it — so the reason is dropped on non-null input fields and
+     * kept everywhere else. Filter and orderBy fields are never deprecated either: filtering on
+     * a deprecated column is how a caller finds the rows that still use it.
+     */
+    deprecateColumn?: ColumnDeprecator;
+    /**
+     * Names the GraphQL enum types generated for enum columns.
+     *
+     * By default a column declared with a named `pgEnum` gets one shared type named after the
+     * enum (`pgEnum('status', …)` → `StatusEnum`), reused by every column declared with that
+     * same `pgEnum` — the database column is the same type, so a client variable typed
+     * `StatusEnum!` is passable to any of them. A column with an inline value list
+     * (`text({ enum: [...] })`, `mysqlEnum(...)`) keeps a per-column type named for its table
+     * and column (`UsersRoleTextEnum`), because its values are shared with nothing.
+     *
+     * This hook overrides the name either way — for lining the schema up with another schema it
+     * is stitched into, or for opting a specific column back into a type of its own:
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   enumNameMapper: (info) => (info.enumName === 'status' ? 'PublicationStatus' : undefined),
+     * });
+     * ```
+     *
+     * Two columns the mapper sends to the same name share one type when their values match —
+     * the way to unify inline enums declared separately that mean the same thing. Sending two
+     * *different* value lists to one name throws at build time rather than producing an
+     * invalid schema.
+     *
+     * Return `undefined` to keep the default name.
+     */
+    enumNameMapper?: EnumNameMapper;
 };
 
 /**
@@ -817,4 +1080,4 @@ declare const GraphQLDecimalString: GraphQLScalarType<string, string>;
 
 declare const buildSchema: <TDbClient extends AnyDrizzleDB<any>>(db: TDbClient, config?: BuildSchemaConfig) => GeneratedData<TDbClient>;
 
-export { type AggregateResolver, type AnyDrizzleDB, type BuildSchemaConfig, type ComplexityConfig, type DeleteResolver, type DeleteSingleResolver, type ExtractRelations, type ExtractTableByName, type ExtractTableRelations, type ExtractTables, type GeneratedData, type GeneratedEntities, type GeneratedInputs, type GeneratedOutputs, GraphQLBigIntString, GraphQLDecimalString, type InsertArrResolver, type InsertResolver, type MutationReturnlessResult, type MutationsCore, type QueriesCore, type RelationResolverFactory, type SchemaFeatures, type SelectResolver, type SelectSingleResolver, type TableNamedRelations, type UpdateManyArgs, type UpdateManyEntry, type UpdateManyResolver, type UpdateResolver, type UpdateSingleResolver, type UpsertArgs, type UpsertArrResolver, type UpsertConflictArgs, type UpsertResolver, buildSchema, createRelationResolverFactory, defaultErrorMapper, drizzleExecutorKey, extractFilters, extractOrderBy, extractRelationJoinColumns };
+export { type AggregateResolver, type AnyDrizzleDB, type BuildSchemaConfig, type ColumnDeprecator, type ColumnDescriber, type ColumnDocInfo, type ColumnTypeMapper, type ColumnTypeMapperInfo, type ComplexityConfig, type DeleteResolver, type DeleteSingleResolver, type EnumNameInfo, type EnumNameMapper, type ExtractRelations, type ExtractTableByName, type ExtractTableRelations, type ExtractTables, type GeneratedData, type GeneratedEntities, type GeneratedInputs, type GeneratedOutputs, GraphQLBigIntString, GraphQLDecimalString, type InsertArrResolver, type InsertResolver, type MutationReturnlessResult, type MutationsCore, type QueriesCore, type RelationDescriber, type RelationResolverFactory, type ScalarOverride, type ScalarOverridesConfig, type SchemaDocs, type SchemaFeatures, type SelectResolver, type SelectSingleResolver, type TableDescriber, type TableNamedRelations, type UpdateManyArgs, type UpdateManyEntry, type UpdateManyResolver, type UpdateResolver, type UpdateSingleResolver, type UpsertArgs, type UpsertArrResolver, type UpsertConflictArgs, type UpsertResolver, buildSchema, createRelationResolverFactory, defaultErrorMapper, drizzleExecutorKey, extractFilters, extractOrderBy, extractRelationJoinColumns };

package/dist/index.d.ts

@@ -1,10 +1,103 @@
-import { Table, Column, Relation, SQL, One, Many } from 'drizzle-orm';
+import { Column, Table, Relation, SQL, One, Many } from 'drizzle-orm';
 import { MySqlDatabase } from 'drizzle-orm/mysql-core';
 import { PgAsyncDatabase } from 'drizzle-orm/pg-core';
 import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
-import { GraphQLFieldResolver, GraphQLResolveInfo, GraphQLSchema, GraphQLInputObjectType, GraphQLObjectType, GraphQLNonNull, GraphQLList, GraphQLScalarType, GraphQLEnumType } from 'graphql';
+import { GraphQLScalarType, GraphQLOutputType, GraphQLInputType, GraphQLFieldResolver, GraphQLResolveInfo, GraphQLSchema, GraphQLInputObjectType, GraphQLObjectType, GraphQLNonNull, GraphQLList, GraphQLEnumType } from 'graphql';
 export { GraphQLDate, GraphQLDateTime, GraphQLJSON, GraphQLUUID } from 'graphql-scalars';
 
+/**
+ * A scalar override for one column. A bare scalar applies to both directions; the object form
+ * lets output (object type, aggregate min/max) and input (create/update inputs, filter operands)
+ * use different scalars — or override only one side, leaving the other on built-in detection.
+ */
+type ScalarOverride = GraphQLScalarType | {
+    output?: GraphQLScalarType;
+    input?: GraphQLScalarType;
+};
+/**
+ * Declarative per-table, per-column scalar overrides. Keys are the Drizzle schema keys —
+ * the table's key in the schema object and the column's property name (not the SQL names).
+ */
+type ScalarOverridesConfig = Record<string, Record<string, ScalarOverride>>;
+/** Context handed to {@link ColumnTypeMapper} alongside the column itself. */
+type ColumnTypeMapperInfo = {
+    /** The table's key in the Drizzle schema object. */
+    tableName: string;
+    /** The column's property name on the table object. */
+    columnName: string;
+    /**
+     * The GraphQL type built-in detection would use for output positions (without nullability
+     * wrapping). `undefined` when detection has no mapping for the column's data type — the
+     * mapper is then the only way to give the column a type.
+     */
+    defaultType: GraphQLOutputType | undefined;
+    /** The input-position counterpart of `defaultType`. */
+    defaultInputType: GraphQLInputType | undefined;
+};
+/**
+ * Rule-based scalar mapping, called once per column at build time. Return a scalar (or
+ * `{ output, input }` pair) to override the column's GraphQL type, or `undefined` to keep
+ * the built-in detection.
+ */
+type ColumnTypeMapper = (column: Column, info: ColumnTypeMapperInfo) => ScalarOverride | undefined;
+/** Everything an {@link EnumNameMapper} needs to name — or opt a column out of — a generated enum type. */
+type EnumNameInfo = {
+    /**
+     * The name the enum type was declared with (`pgEnum('status', …)`), shared by every column
+     * that uses it. `undefined` for an inline value list (`text({ enum: [...] })`,
+     * `mysqlEnum(...)`), which belongs to the one column that declares it.
+     */
+    enumName: string | undefined;
+    /** The Postgres schema the named enum was declared in, when it declares one. */
+    schema: string | undefined;
+    /** The table's key in the Drizzle schema object. */
+    tableName: string;
+    /** The column's property name on the table object. */
+    columnName: string;
+    /** The enum's values, in declaration order. */
+    values: readonly string[];
+};
+/**
+ * Names a generated GraphQL enum type. Return `undefined` to keep the default name. See
+ * `BuildSchemaConfig.enumNameMapper`.
+ */
+type EnumNameMapper = (info: EnumNameInfo) => string | undefined;
+/** Context handed to the documentation and deprecation hooks alongside the column itself. */
+type ColumnDocInfo = {
+    /** The table's key in the Drizzle schema object. */
+    tableName: string;
+    /** The column's property name on the table object. */
+    columnName: string;
+};
+/**
+ * Supplies the GraphQL `description` for a generated column field. See
+ * `BuildSchemaConfig.describeColumn`.
+ */
+type ColumnDescriber = (column: Column, info: ColumnDocInfo) => string | undefined;
+/**
+ * Supplies the GraphQL `deprecationReason` for a generated column field. See
+ * `BuildSchemaConfig.deprecateColumn`.
+ */
+type ColumnDeprecator = (column: Column, info: ColumnDocInfo) => string | undefined;
+/** Supplies the GraphQL `description` for a table's object type. See `BuildSchemaConfig.describeTable`. */
+type TableDescriber = (tableName: string) => string | undefined;
+/**
+ * Supplies the GraphQL `description` for a relation field. See
+ * `BuildSchemaConfig.describeRelation`.
+ */
+type RelationDescriber = (tableName: string, relationName: string) => string | undefined;
+/**
+ * The documentation hooks a build was configured with, resolved once and threaded through
+ * type generation. Every member is optional; a build with no hooks generates fields with no
+ * descriptions at all.
+ */
+type SchemaDocs = {
+    describeColumn?: ColumnDescriber;
+    describeTable?: TableDescriber;
+    describeRelation?: RelationDescriber;
+    deprecateColumn?: ColumnDeprecator;
+};
+
 type TableNamedRelations = {
     relation: Relation;
     targetTableName: string;
@@ -544,6 +637,38 @@ type SchemaFeatures = {
      * @default false
      */
     upsert?: boolean;
+    /**
+     * Relation fields on `Create<Table>Input` and `Update<Table>Input`, so a parent row and
+     * the rows it is related to can be written in one mutation. Off unless asked for: it adds
+     * a field per writable relation to every create and update input.
+     *
+     * ```graphql
+     * createPostsSingle(values: {
+     *   title: "Hello"
+     *   author: { connect: { id: { eq: "a1" } } }
+     *   tags: { create: [{ name: "drizzle" }] }
+     * }) { id }
+     * ```
+     *
+     * Each relation field offers `create` and `connect`; the update input adds `disconnect`
+     * and, for a to-many relation, `set` (replace the whole set). `disconnect` and `set` are
+     * generated only when the foreign key is nullable — there is no way to detach a row whose
+     * key is NOT NULL — and many-to-many (`.through()`) relations are not written through at
+     * all. Nesting is one level deep: the row a nested `create` inserts takes columns only.
+     *
+     * The whole tree runs in one transaction (a savepoint when the request already carries
+     * one), and a column a relation fills in (`authorId`, when `author: { create: … }` is
+     * offered) becomes nullable on the create input, since the relation is the other way to
+     * supply it.
+     *
+     * PostgreSQL and SQLite only. MySQL cannot return the rows it just wrote, which is how a
+     * nested write learns the parent's key, so `buildSchema` rejects the flag there. On SQLite
+     * the driver must be asynchronous (libsql, D1, …): a synchronous one commits before an
+     * awaited statement runs, so `buildSchema` rejects the combination outright.
+     *
+     * @default false
+     */
+    nestedWrites?: boolean;
     /**
      * Makes `where` non-null on the plural `update<Table>` / `delete<Table>` mutations, and
      * rejects a `where` that collapses to no filters (e.g. `where: {}`), so a schema can rule
@@ -774,6 +899,56 @@ type BuildSchemaConfig = {
      * @default true
      */
     eagerLoadRelations?: boolean | ((tableName: string, relationName: string) => boolean);
+    /**
+     * Declarative per-table, per-column scalar overrides — replaces the GraphQL type built-in
+     * detection would pick for a column with the scalar you provide, everywhere that column's
+     * type surfaces: the object type, create/update inputs, filter operands (in a filter type
+     * named `${Scalar}Filter`), and aggregate min/max fields.
+     *
+     * Keys are the Drizzle schema keys: the table's key in your schema object and the column's
+     * property name. The value is either one scalar for both directions, or `{ output, input }`
+     * to type outputs and inputs differently (either side may be omitted to keep the default).
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   scalars: {
+     *     users: {
+     *       balance: GraphQLBigIntString,                      // both directions
+     *       settings: { output: PrettyJSON },                  // output only, input stays default
+     *     },
+     *   },
+     * });
+     * ```
+     *
+     * Validation and coercion become the scalar's job: for an overridden column the generated
+     * resolvers pass values through untouched — `parseValue`/`parseLiteral` results go to the
+     * database driver as-is, and raw driver values go to `serialize` as-is — so the scalar must
+     * accept what the driver produces and produce what the driver accepts.
+     *
+     * A declarative entry fully decides its column and wins over {@link mapColumnType}.
+     */
+    scalars?: ScalarOverridesConfig;
+    /**
+     * Rule-based scalar mapping, called once per column at build time — the tool for applying
+     * a convention across many columns (e.g. "every `numeric` column is `Money`") or for typing
+     * custom column types the built-in detection does not know.
+     *
+     * Return a scalar (or `{ output, input }` pair) to override the column, or `undefined` to
+     * keep the default. `info` carries the table/column schema keys and the types built-in
+     * detection would use (`defaultType` / `defaultInputType`), so rules can key off either the
+     * Drizzle column or the default GraphQL type.
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   mapColumnType: (column, { columnName }) =>
+     *     column.columnType === 'PgNumeric' ? MoneyScalar : undefined,
+     * });
+     * ```
+     *
+     * Same semantics as {@link scalars} otherwise; a column matched by both is decided by
+     * `scalars` alone.
+     */
+    mapColumnType?: ColumnTypeMapper;
     /**
      * Called for every error thrown by a generated resolver, before it reaches the client.
      *
@@ -798,6 +973,94 @@ type BuildSchemaConfig = {
      * ```
      */
     onError?: (error: unknown) => unknown;
+    /**
+     * Supplies the GraphQL `description` for a column, everywhere that column becomes a field:
+     * the object type, the create/update inputs, the filter input, and the aggregate
+     * `min`/`max`/`group` fields.
+     *
+     * Nothing is generated by default. The library used to emit the column's own type name
+     * ("DateTime", "JSON") as its description, which documented nothing a reader could not see
+     * from the type — that is gone, and this hook is what puts real prose in its place. Drizzle
+     * carries no column-comment metadata to read, so the text has to come from here.
+     *
+     * ```ts
+     * const columnDocs = { Users: { email: 'Primary contact address. Unique, case-insensitive.' } };
+     *
+     * buildSchema(db, {
+     *   describeColumn: (_column, { tableName, columnName }) => columnDocs[tableName]?.[columnName],
+     * });
+     * ```
+     *
+     * `tableName` and `columnName` are the Drizzle schema keys. Return `undefined` to leave the
+     * field undocumented.
+     */
+    describeColumn?: ColumnDescriber;
+    /**
+     * Supplies the GraphQL `description` for a table's object type.
+     *
+     * ```ts
+     * buildSchema(db, { describeTable: (tableName) => tableDocs[tableName] });
+     * ```
+     */
+    describeTable?: TableDescriber;
+    /**
+     * Supplies the GraphQL `description` for a relation field on a table's object type.
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   describeRelation: (tableName, relationName) =>
+     *     tableName === 'Users' && relationName === 'posts' ? 'Posts this user authored.' : undefined,
+     * });
+     * ```
+     *
+     * The generated `<relation>Aggregate` companion fields are not covered — they are derived
+     * fields rather than the relation itself.
+     */
+    describeRelation?: RelationDescriber;
+    /**
+     * Supplies the GraphQL `deprecationReason` for a column, marking it `@deprecated` on the
+     * object type and on the create/update inputs.
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   deprecateColumn: (_column, { columnName }) =>
+     *     columnName === 'legacyFlag' ? 'Use `status` instead.' : undefined,
+     * });
+     * ```
+     *
+     * A required input field cannot be deprecated — GraphQL rejects the schema, since a client
+     * has no way to stop sending it — so the reason is dropped on non-null input fields and
+     * kept everywhere else. Filter and orderBy fields are never deprecated either: filtering on
+     * a deprecated column is how a caller finds the rows that still use it.
+     */
+    deprecateColumn?: ColumnDeprecator;
+    /**
+     * Names the GraphQL enum types generated for enum columns.
+     *
+     * By default a column declared with a named `pgEnum` gets one shared type named after the
+     * enum (`pgEnum('status', …)` → `StatusEnum`), reused by every column declared with that
+     * same `pgEnum` — the database column is the same type, so a client variable typed
+     * `StatusEnum!` is passable to any of them. A column with an inline value list
+     * (`text({ enum: [...] })`, `mysqlEnum(...)`) keeps a per-column type named for its table
+     * and column (`UsersRoleTextEnum`), because its values are shared with nothing.
+     *
+     * This hook overrides the name either way — for lining the schema up with another schema it
+     * is stitched into, or for opting a specific column back into a type of its own:
+     *
+     * ```ts
+     * buildSchema(db, {
+     *   enumNameMapper: (info) => (info.enumName === 'status' ? 'PublicationStatus' : undefined),
+     * });
+     * ```
+     *
+     * Two columns the mapper sends to the same name share one type when their values match —
+     * the way to unify inline enums declared separately that mean the same thing. Sending two
+     * *different* value lists to one name throws at build time rather than producing an
+     * invalid schema.
+     *
+     * Return `undefined` to keep the default name.
+     */
+    enumNameMapper?: EnumNameMapper;
 };
 
 /**
@@ -817,4 +1080,4 @@ declare const GraphQLDecimalString: GraphQLScalarType<string, string>;
 
 declare const buildSchema: <TDbClient extends AnyDrizzleDB<any>>(db: TDbClient, config?: BuildSchemaConfig) => GeneratedData<TDbClient>;
 
-export { type AggregateResolver, type AnyDrizzleDB, type BuildSchemaConfig, type ComplexityConfig, type DeleteResolver, type DeleteSingleResolver, type ExtractRelations, type ExtractTableByName, type ExtractTableRelations, type ExtractTables, type GeneratedData, type GeneratedEntities, type GeneratedInputs, type GeneratedOutputs, GraphQLBigIntString, GraphQLDecimalString, type InsertArrResolver, type InsertResolver, type MutationReturnlessResult, type MutationsCore, type QueriesCore, type RelationResolverFactory, type SchemaFeatures, type SelectResolver, type SelectSingleResolver, type TableNamedRelations, type UpdateManyArgs, type UpdateManyEntry, type UpdateManyResolver, type UpdateResolver, type UpdateSingleResolver, type UpsertArgs, type UpsertArrResolver, type UpsertConflictArgs, type UpsertResolver, buildSchema, createRelationResolverFactory, defaultErrorMapper, drizzleExecutorKey, extractFilters, extractOrderBy, extractRelationJoinColumns };
+export { type AggregateResolver, type AnyDrizzleDB, type BuildSchemaConfig, type ColumnDeprecator, type ColumnDescriber, type ColumnDocInfo, type ColumnTypeMapper, type ColumnTypeMapperInfo, type ComplexityConfig, type DeleteResolver, type DeleteSingleResolver, type EnumNameInfo, type EnumNameMapper, type ExtractRelations, type ExtractTableByName, type ExtractTableRelations, type ExtractTables, type GeneratedData, type GeneratedEntities, type GeneratedInputs, type GeneratedOutputs, GraphQLBigIntString, GraphQLDecimalString, type InsertArrResolver, type InsertResolver, type MutationReturnlessResult, type MutationsCore, type QueriesCore, type RelationDescriber, type RelationResolverFactory, type ScalarOverride, type ScalarOverridesConfig, type SchemaDocs, type SchemaFeatures, type SelectResolver, type SelectSingleResolver, type TableDescriber, type TableNamedRelations, type UpdateManyArgs, type UpdateManyEntry, type UpdateManyResolver, type UpdateResolver, type UpdateSingleResolver, type UpsertArgs, type UpsertArrResolver, type UpsertConflictArgs, type UpsertResolver, buildSchema, createRelationResolverFactory, defaultErrorMapper, drizzleExecutorKey, extractFilters, extractOrderBy, extractRelationJoinColumns };