fix(cli-graphql): add custom cdk resolver limitation (#5171)

* fix(graphql): add custom cdk resolver limitation

* updated comments

* Update custom-business-logic.mdx

* Update custom-business-logic.mdx

* Update custom-business-logic.mdx

* Update src/pages/cli/graphql/custom-business-logic.mdx

Co-authored-by: Kamil Sobol <[email protected]>

---------

Co-authored-by: Rene Brandel <[email protected]>
Co-authored-by: Kamil Sobol <[email protected]>

Author: 3 people

src/pages/cli/graphql/custom-business-logic.mdx

@@ -480,7 +480,8 @@ The `@http` transformer will create one HTTP datasource for each identified base
 
 ## VTL resolver
 
-You can use AWS Cloud Development Kit (CDK) to define custom VTL resolvers for your GraphQL API.
+You can use AWS Cloud Development Kit (CDK) to define custom VTL resolvers for your GraphQL API. `@auth` directives are not supported for custom queries or mutations that are connected to a VTL resolver. This is because you are replacing Amplify's auto-generated capabilities for that particular query or mutation with a custom-defined cloud resources. 
+
 ```bash
 amplify add custom
 ```
@@ -494,12 +495,13 @@ amplify add custom
 Next, install the AppSync dependencies for your custom resource:
 ```bash
 cd amplify/backend/custom/MyCustomResolvers
-npm i @aws-cdk/aws-appsync@~1.124.0
+npm i @aws-cdk/aws-appsync@~1.172.0
 ```
 > **Note:** Installations using the '\~' character do not modify the package.json. To use '\~' for default npm configurations, make sure your package.json reflects the right dependency to avoid compatibility errors in CDK.
 
 
 Finally, add your custom resolvers into the `cdk-stack.ts` file. You can either add the VTL inline into your `cdk-stack.ts` file or define them externally in another file. Review the [Resolver Mapping Template Programming Guide](https://docs.aws.amazon.com/appsync/latest/devguide/resolver-mapping-template-reference-programming-guide.html) to learn more about the VTL template.
+
 #### Unit Resolver
 ```ts
 import * as cdk from '@aws-cdk/core';
@@ -651,6 +653,9 @@ type Mutation {
 }
 ```
 
+> **Known limitation:** You can't combine the `@auth` directive with a custom query or mutation that is using a VTL resolver.
+
+
 ## Override Amplify-generated resolvers
 
 Amplify generates [AWS AppSync pipeline resolver](https://docs.aws.amazon.com/appsync/latest/devguide/pipeline-resolvers.html) for your queries and mutations. The resolvers are listed the following API resource's folder `amplify/backend/api/<resource_name>/build/resolvers/`.