fix(deprecation): announce deprecation of some constructs (#794)

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

apidocs/classes/WebCrawler.md

@@ -40,6 +40,11 @@ user provided props for the construct.
 
 0.0.0
 
+#### Deprecated
+
+This construct is deprecated and will be removed in a future major version.
+It will not receive security updates.
+
 #### Overrides
 
 [`BaseClass`](BaseClass.md).[`constructor`](BaseClass.md#constructors)

src/patterns/gen-ai/aws-rag-appsync-stepfn-kendra/index.ts

@@ -12,7 +12,7 @@
  */
 import * as path from 'path';
 import * as cdk from 'aws-cdk-lib';
-import { Duration, RemovalPolicy } from 'aws-cdk-lib';
+import { Duration, RemovalPolicy, Annotations } from 'aws-cdk-lib';
 import * as appsync from 'aws-cdk-lib/aws-appsync';
 import * as cognito from 'aws-cdk-lib/aws-cognito';
 import { Table } from 'aws-cdk-lib/aws-dynamodb';
@@ -176,10 +176,15 @@ export class RagAppsyncStepfnKendra extends BaseClass {
      * @param {RagAppsyncStepfnKendraProps} props - user provided props for the construct.
      * @since 0.0.0
      * @access public
+     * @deprecated This construct is deprecated and will be removed in a future major version.
+   * It will not receive security updates.
    */
   constructor(scope: Construct, id: string, props: RagAppsyncStepfnKendraProps) {
     super(scope, id);
 
+    Annotations.of(scope).addWarningV2('@cdklabs/generative-ai-cdk-constructs:RagAppsyncStepfnKendra.deprecation',
+      'This construct is deprecated and will not receive further support. It will be removed in the next release of the library.');
+
     const baseProps: BaseClassProps = {
       stage: props.stage,
       constructName: ConstructName.AWSRAGAPPSYNCSTEPFNKENDRA,

src/patterns/gen-ai/aws-web-crawler/index.ts

@@ -14,6 +14,7 @@ import * as crypto from 'crypto';
 import * as path from 'path';
 import * as url from 'url';
 import * as cdk from 'aws-cdk-lib';
+import { Annotations } from 'aws-cdk-lib';
 import * as batch from 'aws-cdk-lib/aws-batch';
 import * as dynamodb from 'aws-cdk-lib/aws-dynamodb';
 import * as ec2 from 'aws-cdk-lib/aws-ec2';
@@ -183,10 +184,15 @@ export class WebCrawler extends BaseClass {
    * @param {WebCrawlerProps} props - user provided props for the construct.
    * @since 0.0.0
    * @public
+   * @deprecated This construct is deprecated and will be removed in a future major version.
+   * It will not receive security updates.
    */
   constructor(scope: Construct, id: string, props: WebCrawlerProps) {
     super(scope, id);
 
+    Annotations.of(scope).addWarningV2('@cdklabs/generative-ai-cdk-constructs:WebCrawler.deprecation',
+      'This construct is deprecated and will not receive further support. It will be removed in the next release of the library.');
+
     vpc_helper.CheckVpcProps(props);
     s3_bucket_helper.CheckS3Props({
       existingBucketObj: props.existingOutputBucketObj,