@vantreeseba/drizzle-graphql 5.3.0 → 5.5.0

package/dist/index.d.cts

@@ -233,6 +233,17 @@ type UpdateArgs<TTable extends Table> = Partial<{
     set: GetRemappedTableUpdateDataType<TTable>;
     where?: Filters<TTable>;
 }>;
+/**
+ * One entry of an `update<Table>Many` mutation: the rows `where` matches get this
+ * entry's `set` applied. An omitted `where` matches every row, same as `update<Table>`.
+ */
+type UpdateManyEntry<TTable extends Table> = {
+    where?: Filters<TTable>;
+    set: GetRemappedTableUpdateDataType<TTable>;
+};
+type UpdateManyArgs<TTable extends Table> = {
+    updates: Array<UpdateManyEntry<TTable>>;
+};
 /**
  * The `onConflict` argument of the generated upsert mutations.
  *
@@ -272,6 +283,13 @@ type InsertResolver<TTable extends Table, IsReturnless extends boolean> = (sourc
 /** Resolver for `create<Table>`: an array of rows in, an array of rows out. */
 type InsertArrResolver<TTable extends Table, IsReturnless extends boolean> = (source: any, args: Partial<InsertArgs<TTable, false>>, context: any, info: GraphQLResolveInfo) => Promise<IsReturnless extends false ? Array<GetRemappedTableDataType<TTable>> : MutationReturnlessResult>;
 type UpdateResolver<TTable extends Table, IsReturnless extends boolean> = (source: any, args: UpdateArgs<TTable>, context: any, info: GraphQLResolveInfo) => Promise<IsReturnless extends false ? GetRemappedTableDataType<TTable> | undefined : MutationReturnlessResult>;
+/**
+ * Resolver for `update<Table>Many`: per-entry `set`/`where` pairs applied in input order
+ * inside one transaction. Where the dialect returns rows, the result holds each entry's
+ * updated rows in entry order, with `null` standing in for an entry whose `where`
+ * matched no rows.
+ */
+type UpdateManyResolver<TTable extends Table, IsReturnless extends boolean> = (source: any, args: UpdateManyArgs<TTable>, context: any, info: GraphQLResolveInfo) => Promise<IsReturnless extends false ? Array<GetRemappedTableDataType<TTable> | null> : MutationReturnlessResult>;
 /**
  * Resolver for `update<Table>Single`: `where` required, the single (nullable) affected row
  * out. Throws before writing anything when `where` matches more than one row.
@@ -403,6 +421,16 @@ type MutationsCore<TSchemaTables extends Record<string, Table>, TInputs extends
         };
         resolve: UpdateResolver<TSchemaTables[TName], IsReturnless>;
     } : never;
+} & {
+    [TName in keyof TSchemaTables as TName extends string ? `update${Capitalize<TName>}Many` : never]: TName extends string ? {
+        type: IsReturnless extends true ? TOutputs['MutationReturn'] extends GraphQLObjectType ? TOutputs['MutationReturn'] : never : GraphQLNonNull<GraphQLList<TOutputs[`${Capitalize<TName>}Item`]>>;
+        args: {
+            updates: {
+                type: GraphQLNonNull<GraphQLList<GraphQLNonNull<TInputs[`${Capitalize<TName>}UpdateManyInput`]>>>;
+            };
+        };
+        resolve: UpdateManyResolver<TSchemaTables[TName], IsReturnless>;
+    } : never;
 } & {
     [TName in keyof TSchemaTables as TName extends string ? `update${Capitalize<TName>}Single` : never]: TName extends string ? {
         type: IsReturnless extends true ? TOutputs['MutationReturn'] extends GraphQLObjectType ? TOutputs['MutationReturn'] : never : TOutputs[`${Capitalize<TName>}Item`];
@@ -441,6 +469,8 @@ type GeneratedInputs<TSchema extends Record<string, Table>> = {
     [TName in keyof TSchema as TName extends string ? `${Capitalize<TName>}InsertInput` : never]: GraphQLInputObjectType;
 } & {
     [TName in keyof TSchema as TName extends string ? `${Capitalize<TName>}UpdateInput` : never]: GraphQLInputObjectType;
+} & {
+    [TName in keyof TSchema as TName extends string ? `${Capitalize<TName>}UpdateManyInput` : never]: GraphQLInputObjectType;
 } & {
     [TName in keyof TSchema as TName extends string ? `${Capitalize<TName>}OrderBy` : never]: GraphQLInputObjectType;
 } & {
@@ -496,6 +526,14 @@ type SchemaFeatures = {
     insert?: boolean;
     /** `update<Table>` / `update<Table>Single` mutations. @default true */
     update?: boolean;
+    /**
+     * `update<Table>Many` mutations — batch update with a per-entry `set` and `where`,
+     * executed inside one transaction. Only generated when `update` is also enabled,
+     * since the entries reuse the update `set` input.
+     *
+     * @default true
+     */
+    updateMany?: boolean;
     /** `delete<Table>` / `delete<Table>Single` mutations. @default true */
     delete?: boolean;
     /**
@@ -655,6 +693,40 @@ type BuildSchemaConfig = {
      * queries are always generated, so `Query` is never empty.
      */
     features?: SchemaFeatures;
+    /**
+     * Automatic transactions for GraphQL documents that fire more than one mutation.
+     *
+     * `'none'` (default) — every root mutation field runs on its own connection, so a failure
+     * mid-document leaves the earlier mutations committed (today's behavior).
+     *
+     * `'auto'` — when a request's document selects more than one root mutation field, the
+     * library opens `db.transaction()` once for the whole request and runs every mutation
+     * field (and the reads nested under them) inside it. The transaction commits when the
+     * last mutation field completes and rolls back when any of them fails; mutation fields
+     * after a failure are not executed against the rolled-back transaction — they fail fast.
+     * The object form additionally sets the safety timeout (default 30000ms) after which an
+     * abandoned transaction — e.g. the host server stopped calling resolvers because of a
+     * non-null completion error — is rolled back instead of leaking a connection.
+     *
+     * Never nests: a caller-supplied executor on the GraphQL context under
+     * `drizzleExecutorKey` always wins, and the library opens nothing of its own.
+     *
+     * Requirements and caveats:
+     * - The driver must support `db.transaction()` (e.g. `neon-http` does not). For SQLite
+     *   only asynchronous drivers (libsql, better-sqlite3 is synchronous) can hold a
+     *   transaction open across resolvers; `buildSchema` throws for synchronous ones.
+     * - The GraphQL context value must be a fresh object per request (every mainstream
+     *   server does this) — it keys the per-request transaction state.
+     * - Documents that mix in mutation fields not generated by this build (consumer
+     *   extensions) are left alone: their completion cannot be tracked, so no transaction
+     *   is opened.
+     *
+     * @default 'none'
+     */
+    transactions?: 'auto' | 'none' | {
+        mode: 'auto';
+        timeoutMs?: number;
+    };
     /**
      * Optional mapper from table key to singular/plural name pair.
      * When provided for a table, overrides the default (table key) naming for GraphQL type names,
@@ -745,4 +817,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 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 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 };

package/dist/index.d.ts

@@ -233,6 +233,17 @@ type UpdateArgs<TTable extends Table> = Partial<{
     set: GetRemappedTableUpdateDataType<TTable>;
     where?: Filters<TTable>;
 }>;
+/**
+ * One entry of an `update<Table>Many` mutation: the rows `where` matches get this
+ * entry's `set` applied. An omitted `where` matches every row, same as `update<Table>`.
+ */
+type UpdateManyEntry<TTable extends Table> = {
+    where?: Filters<TTable>;
+    set: GetRemappedTableUpdateDataType<TTable>;
+};
+type UpdateManyArgs<TTable extends Table> = {
+    updates: Array<UpdateManyEntry<TTable>>;
+};
 /**
  * The `onConflict` argument of the generated upsert mutations.
  *
@@ -272,6 +283,13 @@ type InsertResolver<TTable extends Table, IsReturnless extends boolean> = (sourc
 /** Resolver for `create<Table>`: an array of rows in, an array of rows out. */
 type InsertArrResolver<TTable extends Table, IsReturnless extends boolean> = (source: any, args: Partial<InsertArgs<TTable, false>>, context: any, info: GraphQLResolveInfo) => Promise<IsReturnless extends false ? Array<GetRemappedTableDataType<TTable>> : MutationReturnlessResult>;
 type UpdateResolver<TTable extends Table, IsReturnless extends boolean> = (source: any, args: UpdateArgs<TTable>, context: any, info: GraphQLResolveInfo) => Promise<IsReturnless extends false ? GetRemappedTableDataType<TTable> | undefined : MutationReturnlessResult>;
+/**
+ * Resolver for `update<Table>Many`: per-entry `set`/`where` pairs applied in input order
+ * inside one transaction. Where the dialect returns rows, the result holds each entry's
+ * updated rows in entry order, with `null` standing in for an entry whose `where`
+ * matched no rows.
+ */
+type UpdateManyResolver<TTable extends Table, IsReturnless extends boolean> = (source: any, args: UpdateManyArgs<TTable>, context: any, info: GraphQLResolveInfo) => Promise<IsReturnless extends false ? Array<GetRemappedTableDataType<TTable> | null> : MutationReturnlessResult>;
 /**
  * Resolver for `update<Table>Single`: `where` required, the single (nullable) affected row
  * out. Throws before writing anything when `where` matches more than one row.
@@ -403,6 +421,16 @@ type MutationsCore<TSchemaTables extends Record<string, Table>, TInputs extends
         };
         resolve: UpdateResolver<TSchemaTables[TName], IsReturnless>;
     } : never;
+} & {
+    [TName in keyof TSchemaTables as TName extends string ? `update${Capitalize<TName>}Many` : never]: TName extends string ? {
+        type: IsReturnless extends true ? TOutputs['MutationReturn'] extends GraphQLObjectType ? TOutputs['MutationReturn'] : never : GraphQLNonNull<GraphQLList<TOutputs[`${Capitalize<TName>}Item`]>>;
+        args: {
+            updates: {
+                type: GraphQLNonNull<GraphQLList<GraphQLNonNull<TInputs[`${Capitalize<TName>}UpdateManyInput`]>>>;
+            };
+        };
+        resolve: UpdateManyResolver<TSchemaTables[TName], IsReturnless>;
+    } : never;
 } & {
     [TName in keyof TSchemaTables as TName extends string ? `update${Capitalize<TName>}Single` : never]: TName extends string ? {
         type: IsReturnless extends true ? TOutputs['MutationReturn'] extends GraphQLObjectType ? TOutputs['MutationReturn'] : never : TOutputs[`${Capitalize<TName>}Item`];
@@ -441,6 +469,8 @@ type GeneratedInputs<TSchema extends Record<string, Table>> = {
     [TName in keyof TSchema as TName extends string ? `${Capitalize<TName>}InsertInput` : never]: GraphQLInputObjectType;
 } & {
     [TName in keyof TSchema as TName extends string ? `${Capitalize<TName>}UpdateInput` : never]: GraphQLInputObjectType;
+} & {
+    [TName in keyof TSchema as TName extends string ? `${Capitalize<TName>}UpdateManyInput` : never]: GraphQLInputObjectType;
 } & {
     [TName in keyof TSchema as TName extends string ? `${Capitalize<TName>}OrderBy` : never]: GraphQLInputObjectType;
 } & {
@@ -496,6 +526,14 @@ type SchemaFeatures = {
     insert?: boolean;
     /** `update<Table>` / `update<Table>Single` mutations. @default true */
     update?: boolean;
+    /**
+     * `update<Table>Many` mutations — batch update with a per-entry `set` and `where`,
+     * executed inside one transaction. Only generated when `update` is also enabled,
+     * since the entries reuse the update `set` input.
+     *
+     * @default true
+     */
+    updateMany?: boolean;
     /** `delete<Table>` / `delete<Table>Single` mutations. @default true */
     delete?: boolean;
     /**
@@ -655,6 +693,40 @@ type BuildSchemaConfig = {
      * queries are always generated, so `Query` is never empty.
      */
     features?: SchemaFeatures;
+    /**
+     * Automatic transactions for GraphQL documents that fire more than one mutation.
+     *
+     * `'none'` (default) — every root mutation field runs on its own connection, so a failure
+     * mid-document leaves the earlier mutations committed (today's behavior).
+     *
+     * `'auto'` — when a request's document selects more than one root mutation field, the
+     * library opens `db.transaction()` once for the whole request and runs every mutation
+     * field (and the reads nested under them) inside it. The transaction commits when the
+     * last mutation field completes and rolls back when any of them fails; mutation fields
+     * after a failure are not executed against the rolled-back transaction — they fail fast.
+     * The object form additionally sets the safety timeout (default 30000ms) after which an
+     * abandoned transaction — e.g. the host server stopped calling resolvers because of a
+     * non-null completion error — is rolled back instead of leaking a connection.
+     *
+     * Never nests: a caller-supplied executor on the GraphQL context under
+     * `drizzleExecutorKey` always wins, and the library opens nothing of its own.
+     *
+     * Requirements and caveats:
+     * - The driver must support `db.transaction()` (e.g. `neon-http` does not). For SQLite
+     *   only asynchronous drivers (libsql, better-sqlite3 is synchronous) can hold a
+     *   transaction open across resolvers; `buildSchema` throws for synchronous ones.
+     * - The GraphQL context value must be a fresh object per request (every mainstream
+     *   server does this) — it keys the per-request transaction state.
+     * - Documents that mix in mutation fields not generated by this build (consumer
+     *   extensions) are left alone: their completion cannot be tracked, so no transaction
+     *   is opened.
+     *
+     * @default 'none'
+     */
+    transactions?: 'auto' | 'none' | {
+        mode: 'auto';
+        timeoutMs?: number;
+    };
     /**
      * Optional mapper from table key to singular/plural name pair.
      * When provided for a table, overrides the default (table key) naming for GraphQL type names,
@@ -745,4 +817,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 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 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 };