@zenstackhq/runtime 3.0.0-alpha.17 → 3.0.0-alpha.19

package/dist/{contract-C6xcEG6Q.d.ts → contract-CxX20JtH.d.ts}

@@ -96,7 +96,7 @@ type BatchResult = {
     count: number;
 };
 type WhereInput<Schema extends SchemaDef, Model extends GetModels<Schema>, ScalarOnly extends boolean = false> = {
-    [Key in GetModelFields<Schema, Model> as ScalarOnly extends true ? Key extends RelationFields<Schema, Model> ? never : Key : Key]?: Key extends RelationFields<Schema, Model> ? RelationFilter<Schema, Model, Key> : GetModelFieldType<Schema, Model, Key> extends GetEnums<Schema> ? EnumFilter<Schema, GetModelFieldType<Schema, Model, Key>, ModelFieldIsOptional<Schema, Model, Key>> : FieldIsArray<Schema, Model, Key> extends true ? ArrayFilter<GetModelFieldType<Schema, Model, Key>> : PrimitiveFilter<GetModelFieldType<Schema, Model, Key>, ModelFieldIsOptional<Schema, Model, Key>>;
+    [Key in GetModelFields<Schema, Model> as ScalarOnly extends true ? Key extends RelationFields<Schema, Model> ? never : Key : Key]?: Key extends RelationFields<Schema, Model> ? RelationFilter<Schema, Model, Key> : GetModelFieldType<Schema, Model, Key> extends GetEnums<Schema> ? EnumFilter<Schema, GetModelFieldType<Schema, Model, Key>, ModelFieldIsOptional<Schema, Model, Key>> : FieldIsArray<Schema, Model, Key> extends true ? ArrayFilter<GetModelFieldType<Schema, Model, Key>> : PrimitiveFilter<Schema, GetModelFieldType<Schema, Model, Key>, ModelFieldIsOptional<Schema, Model, Key>>;
 } & {
     $expr?: (eb: ExpressionBuilder<ToKyselySchema<Schema>, Model>) => OperandExpression<SqlBool>;
 } & {
@@ -117,8 +117,8 @@ type ArrayFilter<T extends string> = {
     hasSome?: MapBaseType$1<T>[];
     isEmpty?: boolean;
 };
-type PrimitiveFilter<T extends string, Nullable extends boolean> = T extends 'String' ? StringFilter<Nullable> : T extends 'Int' | 'Float' | 'Decimal' | 'BigInt' ? NumberFilter<T, Nullable> : T extends 'Boolean' ? BooleanFilter<Nullable> : T extends 'DateTime' ? DateTimeFilter<Nullable> : T extends 'Bytes' ? BytesFilter<Nullable> : T extends 'Json' ? 'Not implemented yet' : never;
-type CommonPrimitiveFilter<DataType, T extends BuiltinType, Nullable extends boolean> = {
+type PrimitiveFilter<Schema extends SchemaDef, T extends string, Nullable extends boolean> = T extends 'String' ? StringFilter<Schema, Nullable> : T extends 'Int' | 'Float' | 'Decimal' | 'BigInt' ? NumberFilter<Schema, T, Nullable> : T extends 'Boolean' ? BooleanFilter<Nullable> : T extends 'DateTime' ? DateTimeFilter<Schema, Nullable> : T extends 'Bytes' ? BytesFilter<Nullable> : T extends 'Json' ? 'Not implemented yet' : never;
+type CommonPrimitiveFilter<Schema extends SchemaDef, DataType, T extends BuiltinType, Nullable extends boolean> = {
     equals?: NullableIf<DataType, Nullable>;
     in?: DataType[];
     notIn?: DataType[];
@@ -126,16 +126,17 @@ type CommonPrimitiveFilter<DataType, T extends BuiltinType, Nullable extends boo
     lte?: DataType;
     gt?: DataType;
     gte?: DataType;
-    not?: PrimitiveFilter<T, Nullable>;
+    not?: PrimitiveFilter<Schema, T, Nullable>;
 };
-type StringFilter<Nullable extends boolean> = NullableIf<string, Nullable> | (CommonPrimitiveFilter<string, 'String', Nullable> & {
+type StringFilter<Schema extends SchemaDef, Nullable extends boolean> = NullableIf<string, Nullable> | (CommonPrimitiveFilter<Schema, string, 'String', Nullable> & {
     contains?: string;
     startsWith?: string;
     endsWith?: string;
+} & (ProviderSupportsCaseSensitivity<Schema> extends true ? {
     mode?: 'default' | 'insensitive';
-});
-type NumberFilter<T extends 'Int' | 'Float' | 'Decimal' | 'BigInt', Nullable extends boolean> = NullableIf<number | bigint, Nullable> | CommonPrimitiveFilter<number, T, Nullable>;
-type DateTimeFilter<Nullable extends boolean> = NullableIf<Date | string, Nullable> | CommonPrimitiveFilter<Date | string, 'DateTime', Nullable>;
+} : {}));
+type NumberFilter<Schema extends SchemaDef, T extends 'Int' | 'Float' | 'Decimal' | 'BigInt', Nullable extends boolean> = NullableIf<number | bigint, Nullable> | CommonPrimitiveFilter<Schema, number, T, Nullable>;
+type DateTimeFilter<Schema extends SchemaDef, Nullable extends boolean> = NullableIf<Date | string, Nullable> | CommonPrimitiveFilter<Schema, Date | string, 'DateTime', Nullable>;
 type BytesFilter<Nullable extends boolean> = NullableIf<Uint8Array | Buffer, Nullable> | {
     equals?: NullableIf<Uint8Array, Nullable>;
     in?: Uint8Array[];
@@ -187,9 +188,9 @@ type Cursor<Schema extends SchemaDef, Model extends GetModels<Schema>> = {
 type SelectInput<Schema extends SchemaDef, Model extends GetModels<Schema>, AllowCount extends boolean = true, AllowRelation extends boolean = true> = {
     [Key in NonRelationFields<Schema, Model>]?: true;
 } & (AllowRelation extends true ? IncludeInput<Schema, Model> : {}) & // relation fields
-(AllowCount extends true ? {
+(AllowCount extends true ? HasToManyRelations<Schema, Model> extends true ? {
     _count?: SelectCount<Schema, Model>;
-} : {});
+} : {} : {});
 type SelectCount<Schema extends SchemaDef, Model extends GetModels<Schema>> = true | {
     select: {
         [Key in RelationFields<Schema, Model> as FieldIsArray<Schema, Model, Key> extends true ? Key : never]: true | {
@@ -486,6 +487,10 @@ type NonOwnedRelationFields<Schema extends SchemaDef, Model extends GetModels<Sc
         references: unknown[];
     } ? never : Key]: true;
 };
+type HasToManyRelations<Schema extends SchemaDef, Model extends GetModels<Schema>> = keyof {
+    [Key in RelationFields<Schema, Model> as FieldIsArray<Schema, Model, Key> extends true ? Key : never]: true;
+} extends never ? false : true;
+type ProviderSupportsCaseSensitivity<Schema extends SchemaDef> = Schema['provider'] extends 'postgresql' ? true : false;
 
 type AuthType<Schema extends SchemaDef> = string extends GetModels<Schema> ? Record<string, unknown> : Schema['authType'] extends GetModels<Schema> ? Partial<ModelResult<Schema, Schema['authType']>> : never;
 
@@ -520,6 +525,7 @@ declare abstract class BaseCrudDialect<Schema extends SchemaDef> {
     buildSelectAllFields(model: string, query: SelectQueryBuilder<any, any, any>, omit?: Record<string, boolean | undefined>): SelectQueryBuilder<any, any, any>;
     buildSelectField(query: SelectQueryBuilder<any, any, any>, model: string, modelAlias: string, field: string): SelectQueryBuilder<any, any, any>;
     buildDelegateJoin(thisModel: string, otherModel: string, query: SelectQueryBuilder<any, any, any>): SelectQueryBuilder<any, any, any>;
+    buildCountJson(model: string, eb: ExpressionBuilder<any, any>, parentAlias: string, payload: any): ExpressionWrapper<any, any, unknown>;
     private negateSort;
     true(eb: ExpressionBuilder<any, any>): Expression<SqlBool>;
     false(eb: ExpressionBuilder<any, any>): Expression<SqlBool>;
@@ -561,6 +567,10 @@ declare abstract class BaseCrudDialect<Schema extends SchemaDef> {
      * Whether the dialect supports DISTINCT ON.
      */
     abstract get supportsDistinctOn(): boolean;
+    /**
+     * Whether the dialect support inserting with `DEFAULT` as field value.
+     */
+    abstract get supportInsertWithDefault(): boolean;
 }
 
 type CrudOperation = 'findMany' | 'findUnique' | 'findFirst' | 'create' | 'createMany' | 'createManyAndReturn' | 'update' | 'updateMany' | 'updateManyAndReturn' | 'upsert' | 'delete' | 'deleteMany' | 'count' | 'aggregate' | 'groupBy';
@@ -796,7 +806,7 @@ type ClientContract<Schema extends SchemaDef> = {
      * Executes a prepared raw query and returns the number of affected rows.
      * @example
      * ```
-     * const result = await client.$executeRaw`UPDATE User SET cool = ${true} WHERE email = ${'user@email.com'};`
+     * const result = await db.$executeRaw`UPDATE User SET cool = ${true} WHERE email = ${'user@email.com'};`
      * ```
      */
     $executeRaw(query: TemplateStringsArray, ...values: any[]): ZenStackPromise<Schema, number>;
@@ -805,7 +815,7 @@ type ClientContract<Schema extends SchemaDef> = {
      * This method is susceptible to SQL injections.
      * @example
      * ```
-     * const result = await client.$executeRawUnsafe('UPDATE User SET cool = $1 WHERE email = $2 ;', true, 'user@email.com')
+     * const result = await db.$executeRawUnsafe('UPDATE User SET cool = $1 WHERE email = $2 ;', true, 'user@email.com')
      * ```
      */
     $executeRawUnsafe(query: string, ...values: any[]): ZenStackPromise<Schema, number>;
@@ -813,7 +823,7 @@ type ClientContract<Schema extends SchemaDef> = {
      * Performs a prepared raw query and returns the `SELECT` data.
      * @example
      * ```
-     * const result = await client.$queryRaw`SELECT * FROM User WHERE id = ${1} OR email = ${'user@email.com'};`
+     * const result = await db.$queryRaw`SELECT * FROM User WHERE id = ${1} OR email = ${'user@email.com'};`
      * ```
      */
     $queryRaw<T = unknown>(query: TemplateStringsArray, ...values: any[]): ZenStackPromise<Schema, T>;
@@ -822,7 +832,7 @@ type ClientContract<Schema extends SchemaDef> = {
      * This method is susceptible to SQL injections.
      * @example
      * ```
-     * const result = await client.$queryRawUnsafe('SELECT * FROM User WHERE id = $1 OR email = $2;', 1, 'user@email.com')
+     * const result = await db.$queryRawUnsafe('SELECT * FROM User WHERE id = $1 OR email = $2;', 1, 'user@email.com')
      * ```
      */
     $queryRawUnsafe<T = unknown>(query: string, ...values: any[]): ZenStackPromise<Schema, T>;
@@ -920,17 +930,17 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // find all users and return all scalar fields
-     * await client.user.findMany();
+     * await db.user.findMany();
      *
      * // find all users with name 'Alex'
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     where: {
      *         name: 'Alex'
      *     }
      * });
      *
      * // select fields
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     select: {
      *         name: true,
      *         email: true,
@@ -938,21 +948,21 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * }); // result: `Array<{ name: string, email: string }>`
      *
      * // omit fields
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     omit: {
      *         name: true,
      *     }
      * }); // result: `Array<{ id: number; email: string; ... }>`
      *
      * // include relations (and all scalar fields)
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     include: {
      *         posts: true,
      *     }
      * }); // result: `Array<{ ...; posts: Post[] }>`
      *
      * // include relations with filter
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     include: {
      *         posts: {
      *             where: {
@@ -963,14 +973,14 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // pagination and sorting
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     skip: 10,
      *     take: 10,
      *     orderBy: [{ name: 'asc' }, { email: 'desc' }],
      * });
      *
      * // pagination with cursor (https://www.prisma.io/docs/orm/prisma-client/queries/pagination#cursor-based-pagination)
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     cursor: { id: 10 },
      *     skip: 1,
      *     take: 10,
@@ -978,17 +988,17 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // distinct
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     distinct: ['name']
      * });
      *
      * // count all relations
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     _count: true,
      * }); // result: `{ _count: { posts: number; ... } }`
      *
      * // count selected relations
-     * await client.user.findMany({
+     * await db.user.findMany({
      *     _count: { select: { posts: true } },
      * }); // result: `{ _count: { posts: number } }`
      * ```
@@ -1000,14 +1010,14 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @returns a single entity or null if not found
      * @see {@link findMany}
      */
-    findUnique<T extends FindUniqueArgs<Schema, Model>>(args?: SelectSubset<T, FindUniqueArgs<Schema, Model>>): ZenStackPromise<Schema, Simplify<ModelResult<Schema, Model, T>> | null>;
+    findUnique<T extends FindUniqueArgs<Schema, Model>>(args: SelectSubset<T, FindUniqueArgs<Schema, Model>>): ZenStackPromise<Schema, Simplify<ModelResult<Schema, Model, T>> | null>;
     /**
      * Returns a uniquely identified entity or throws `NotFoundError` if not found.
      * @param args - query args
      * @returns a single entity
      * @see {@link findMany}
      */
-    findUniqueOrThrow<T extends FindUniqueArgs<Schema, Model>>(args?: SelectSubset<T, FindUniqueArgs<Schema, Model>>): ZenStackPromise<Schema, Simplify<ModelResult<Schema, Model, T>>>;
+    findUniqueOrThrow<T extends FindUniqueArgs<Schema, Model>>(args: SelectSubset<T, FindUniqueArgs<Schema, Model>>): ZenStackPromise<Schema, Simplify<ModelResult<Schema, Model, T>>>;
     /**
      * Returns the first entity.
      * @param args - query args
@@ -1030,12 +1040,12 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // simple create
-     * await client.user.create({
+     * await db.user.create({
      *    data: { name: 'Alex', email: 'alex@zenstack.dev' }
      * });
      *
      * // nested create with relation
-     * await client.user.create({
+     * await db.user.create({
      *    data: {
      *        email: 'alex@zenstack.dev',
      *        posts: { create: { title: 'Hello World' } }
@@ -1044,7 +1054,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      *
      * // you can use `select`, `omit`, and `include` to control
      * // the fields returned by the query, as with `findMany`
-     * await client.user.create({
+     * await db.user.create({
      *    data: {
      *        email: 'alex@zenstack.dev',
      *        posts: { create: { title: 'Hello World' } }
@@ -1053,7 +1063,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * }); // result: `{ id: number; posts: Post[] }`
      *
      * // connect relations
-     * await client.user.create({
+     * await db.user.create({
      *    data: {
      *        email: 'alex@zenstack.dev',
      *        posts: { connect: { id: 1 } }
@@ -1061,7 +1071,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // connect relations, and create if not found
-     * await client.user.create({
+     * await db.user.create({
      *    data: {
      *        email: 'alex@zenstack.dev',
      *        posts: {
@@ -1083,7 +1093,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // create multiple entities
-     * await client.user.createMany({
+     * await db.user.createMany({
      *     data: [
      *         { name: 'Alex', email: 'alex@zenstack.dev' },
      *         { name: 'John', email: 'john@zenstack.dev' }
@@ -1091,7 +1101,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // skip items that cause unique constraint violation
-     * await client.user.createMany({
+     * await db.user.createMany({
      *     data: [
      *         { name: 'Alex', email: 'alex@zenstack.dev' },
      *         { name: 'John', email: 'john@zenstack.dev' }
@@ -1110,7 +1120,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // create multiple entities and return selected fields
-     * await client.user.createManyAndReturn({
+     * await db.user.createManyAndReturn({
      *     data: [
      *         { name: 'Alex', email: 'alex@zenstack.dev' },
      *         { name: 'John', email: 'john@zenstack.dev' }
@@ -1129,19 +1139,19 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // update fields
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: { name: 'Alex' }
      * });
      *
      * // connect a relation
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: { posts: { connect: { id: 1 } } }
      * });
      *
      * // connect relation, and create if not found
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: {
      *         posts: {
@@ -1154,7 +1164,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // create many related entities (only available for one-to-many relations)
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: {
      *         posts: {
@@ -1166,19 +1176,19 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // disconnect a one-to-many relation
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: { posts: { disconnect: { id: 1 } } }
      * });
      *
      * // disconnect a one-to-one relation
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: { profile: { disconnect: true } }
      * });
      *
      * // replace a relation (only available for one-to-many relations)
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: {
      *         posts: {
@@ -1188,7 +1198,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // update a relation
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: {
      *         posts: {
@@ -1198,7 +1208,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // upsert a relation
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: {
      *         posts: {
@@ -1212,7 +1222,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // update many related entities (only available for one-to-many relations)
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: {
      *         posts: {
@@ -1225,13 +1235,13 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * });
      *
      * // delete a one-to-many relation
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: { posts: { delete: { id: 1 } } }
      * });
      *
      * // delete a one-to-one relation
-     * await client.user.update({
+     * await db.user.update({
      *     where: { id: 1 },
      *     data: { profile: { delete: true } }
      * });
@@ -1246,13 +1256,13 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // update many entities
-     * await client.user.updateMany({
+     * await db.user.updateMany({
      *     where: { email: { endsWith: '@zenstack.dev' } },
      *     data: { role: 'ADMIN' }
      * });
      *
      * // limit the number of updated entities
-     * await client.user.updateMany({
+     * await db.user.updateMany({
      *     where: { email: { endsWith: '@zenstack.dev' } },
      *     data: { role: 'ADMIN' },
      *     limit: 10
@@ -1267,14 +1277,14 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // update many entities and return selected fields
-     * await client.user.updateManyAndReturn({
+     * await db.user.updateManyAndReturn({
      *     where: { email: { endsWith: '@zenstack.dev' } },
      *     data: { role: 'ADMIN' },
      *     select: { id: true, email: true }
      * }); // result: `Array<{ id: string; email: string }>`
      *
      * // limit the number of updated entities
-     * await client.user.updateManyAndReturn({
+     * await db.user.updateManyAndReturn({
      *     where: { email: { endsWith: '@zenstack.dev' } },
      *     data: { role: 'ADMIN' },
      *     limit: 10
@@ -1290,7 +1300,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // upsert an entity
-     * await client.user.upsert({
+     * await db.user.upsert({
      *     // `where` clause is used to find the entity
      *     where: { id: 1 },
      *     // `create` clause is used if the entity is not found
@@ -1311,12 +1321,12 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // delete an entity
-     * await client.user.delete({
+     * await db.user.delete({
      *     where: { id: 1 }
      * });
      *
      * // delete an entity and return selected fields
-     * await client.user.delete({
+     * await db.user.delete({
      *     where: { id: 1 },
      *     select: { id: true, email: true }
      * }); // result: `{ id: string; email: string }`
@@ -1331,12 +1341,12 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // delete many entities
-     * await client.user.deleteMany({
+     * await db.user.deleteMany({
      *     where: { email: { endsWith: '@zenstack.dev' } }
      * });
      *
      * // limit the number of deleted entities
-     * await client.user.deleteMany({
+     * await db.user.deleteMany({
      *     where: { email: { endsWith: '@zenstack.dev' } },
      *     limit: 10
      * });
@@ -1351,13 +1361,13 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // count all
-     * await client.user.count();
+     * await db.user.count();
      *
      * // count with a filter
-     * await client.user.count({ where: { email: { endsWith: '@zenstack.dev' } } });
+     * await db.user.count({ where: { email: { endsWith: '@zenstack.dev' } } });
      *
      * // count rows and field values
-     * await client.user.count({
+     * await db.user.count({
      *     select: { _all: true, email: true }
      * }); // result: `{ _all: number, email: number }`
      */
@@ -1370,7 +1380,7 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // aggregate rows
-     * await client.profile.aggregate({
+     * await db.profile.aggregate({
      *     where: { email: { endsWith: '@zenstack.dev' } },
      *     _count: true,
      *     _avg: { age: true },
@@ -1388,26 +1398,26 @@ type ModelOperations<Schema extends SchemaDef, Model extends GetModels<Schema>>
      * @example
      * ```ts
      * // group by a field
-     * await client.profile.groupBy({
+     * await db.profile.groupBy({
      *     by: 'country',
      *     _count: true
      * }); // result: `Array<{ country: string, _count: number }>`
      *
      * // group by multiple fields
-     * await client.profile.groupBy({
+     * await db.profile.groupBy({
      *     by: ['country', 'city'],
      *     _count: true
      * }); // result: `Array<{ country: string, city: string, _count: number }>`
      *
      * // group by with sorting, the `orderBy` fields must be in the `by` list
-     * await client.profile.groupBy({
+     * await db.profile.groupBy({
      *     by: 'country',
      *     orderBy: { country: 'desc' }
      * });
      *
      * // group by with having (post-aggregation filter), the `having` fields must
      * // be in the `by` list
-     * await client.profile.groupBy({
+     * await db.profile.groupBy({
      *     by: 'country',
      *     having: { country: 'US' }
      * });