@gradientedge/cdk-utils 6.10.3 → 6.11.0

package/dist/src/lib/construct/api-to-eventbridge-target/main.d.ts

@@ -131,17 +131,17 @@ export declare class ApiToEventBridgeTarget extends CommonConstruct {
      */
     protected createApiToEventBridgeTargetResourceMethod(): void;
     /**
-     * @summary Method to create custom restApi domain for Api API
+     * @summary Method to create custom restApi domain for Api
      * @protected
      */
     protected createApiDomain(): void;
     /**
-     * @summary Method to create base path mappings for Api API
+     * @summary Method to create base path mappings for Api
      * @protected
      */
     protected createApiBasePathMapping(): void;
     /**
-     * @summary Method to create route53 records for Api API
+     * @summary Method to create route53 records for Api
      * @protected
      */
     protected createApiRouteAssets(): void;

package/dist/src/lib/construct/api-to-eventbridge-target/main.js

@@ -364,6 +364,7 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
                         this.apiToEventBridgeTargetRestApi.methodErrorResponse,
                     ],
                 },
+                deploy: this.props.api.restApi?.deploy ?? true,
                 deployOptions: {
                     tracingEnabled: this.props.api.restApi?.deployOptions?.tracingEnabled,
                     dataTraceEnabled: this.props.api.restApi?.deployOptions?.dataTraceEnabled,
@@ -472,7 +473,7 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
         });
     }
     /**
-     * @summary Method to create custom restApi domain for Api API
+     * @summary Method to create custom restApi domain for Api
      * @protected
      */
     createApiDomain() {
@@ -483,7 +484,7 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             : `${this.props.apiSubDomain}-${this.props.stage}.${this.fullyQualifiedDomainName}`, this.apiToEventBridgeTargetRestApi.certificate);
     }
     /**
-     * @summary Method to create base path mappings for Api API
+     * @summary Method to create base path mappings for Api
      * @protected
      */
     createApiBasePathMapping() {
@@ -497,7 +498,7 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
         });
     }
     /**
-     * @summary Method to create route53 records for Api API
+     * @summary Method to create route53 records for Api
      * @protected
      */
     createApiRouteAssets() {

package/dist/src/lib/construct/api-to-lambda-target/main.d.ts

@@ -7,6 +7,7 @@ export declare class ApiToLambdaTarget extends CommonConstruct {
     id: string;
     applicationSecrets: secretsmanager.ISecret[];
     apiToLambdaTargetRestApi: types.ApiToLambdaTargetRestApiType;
+    apiResource: string;
     constructor(parent: Construct, id: string, props: types.ApiToLambdaTargetProps);
     protected initResources(): void;
     /**
@@ -25,18 +26,50 @@ export declare class ApiToLambdaTarget extends CommonConstruct {
      * @protected
      */
     protected resolveCertificate(): void;
+    /**
+     * @summary Method to create api integration method response
+     * @protected
+     */
+    protected createApiToLambdaTargetMethodResponse(): void;
+    /**
+     * @summary Method to create api integration method error response
+     * @protected
+     */
+    protected createApiToLambdaTargetMethodErrorResponse(): void;
+    protected resolveApiToLambdaTargetFunction(): void;
     /**
      * @summary Method to create rest restApi for Api
      * @protected
      */
     protected createApiToLambdaTargetRestApi(): void;
     /**
-     * @summary Method to create custom restApi domain for Api API
+     * @summary Method to create api integration resource
+     * @protected
+     */
+    protected createApiToLambdaTargetResource(): void;
+    protected createApiToLambdaTargetPolicy(): void;
+    /**
+     * @summary Method to create a role for api integration
+     * @protected
+     */
+    protected createApiToLambdaTargetRole(): void;
+    /**
+     * @summary Method to create api integration resource method
+     * @protected
+     */
+    protected createApiToLambdaTargetIntegration(): void;
+    /**
+     * @summary Method to create api integration resource method
+     * @protected
+     */
+    protected createApiToLambdaTargetResourceMethod(): void;
+    /**
+     * @summary Method to create custom restApi domain for Api
      * @protected
      */
     protected createApiDomain(): void;
     /**
-     * @summary Method to create base path mappings for GraphQL API
+     * @summary Method to create base path mappings for Api
      * @protected
      */
     protected createApiBasePathMapping(): void;

package/dist/src/lib/construct/api-to-lambda-target/main.js

@@ -26,6 +26,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiToLambdaTarget = void 0;
 const cdk = __importStar(require("aws-cdk-lib"));
 const apig = __importStar(require("aws-cdk-lib/aws-apigateway"));
+const iam = __importStar(require("aws-cdk-lib/aws-iam"));
 const lambda = __importStar(require("aws-cdk-lib/aws-lambda"));
 const common_1 = require("../../common");
 const helper = __importStar(require("../../helper"));
@@ -36,6 +37,7 @@ class ApiToLambdaTarget extends common_1.CommonConstruct {
     applicationSecrets;
     /* rest restApi related resources */
     apiToLambdaTargetRestApi;
+    apiResource;
     constructor(parent, id, props) {
         super(parent, id, props);
         this.props = props;
@@ -49,7 +51,15 @@ class ApiToLambdaTarget extends common_1.CommonConstruct {
         this.resolveHostedZone();
         this.resolveCertificate();
         /* restApi related resources */
+        this.createApiToLambdaTargetMethodResponse();
+        this.createApiToLambdaTargetMethodErrorResponse();
+        this.resolveApiToLambdaTargetFunction();
         this.createApiToLambdaTargetRestApi();
+        this.createApiToLambdaTargetResource();
+        this.createApiToLambdaTargetPolicy();
+        this.createApiToLambdaTargetRole();
+        this.createApiToLambdaTargetIntegration();
+        this.createApiToLambdaTargetResourceMethod();
         this.createApiDomain();
         this.createApiBasePathMapping();
         this.createApiRouteAssets();
@@ -83,6 +93,47 @@ class ApiToLambdaTarget extends common_1.CommonConstruct {
         }
         this.apiToLambdaTargetRestApi.certificate = this.acmManager.resolveCertificate(`${this.id}-certificate`, this, this.props.api.certificate);
     }
+    /**
+     * @summary Method to create api integration method response
+     * @protected
+     */
+    createApiToLambdaTargetMethodResponse() {
+        if (!this.props.api.withResource)
+            return;
+        this.apiToLambdaTargetRestApi.methodResponse = {
+            ...{
+                statusCode: '200',
+                responseParameters: {
+                    'method.response.header.Content-Type': true,
+                    'method.response.header.Access-Control-Allow-Origin': true,
+                    'method.response.header.Access-Control-Allow-Credentials': true,
+                },
+            },
+            ...this.props.api.methodResponse,
+        };
+    }
+    /**
+     * @summary Method to create api integration method error response
+     * @protected
+     */
+    createApiToLambdaTargetMethodErrorResponse() {
+        if (!this.props.api.withResource)
+            return;
+        this.apiToLambdaTargetRestApi.methodErrorResponse = {
+            ...{
+                statusCode: '400',
+                responseParameters: {
+                    'method.response.header.Content-Type': true,
+                    'method.response.header.Access-Control-Allow-Origin': true,
+                    'method.response.header.Access-Control-Allow-Credentials': true,
+                },
+            },
+            ...this.props.api.methodErrorResponse,
+        };
+    }
+    resolveApiToLambdaTargetFunction() {
+        this.apiToLambdaTargetRestApi.lambda = lambda.Function.fromFunctionName(this, `${this.id}-lambda`, this.props.lambdaFunctionName);
+    }
     /**
      * @summary Method to create rest restApi for Api
      * @protected
@@ -99,17 +150,88 @@ class ApiToLambdaTarget extends common_1.CommonConstruct {
         this.props.api.restApi = {
             ...this.props.api.restApi,
             ...{
+                defaultMethodOptions: {
+                    methodResponses: [
+                        this.apiToLambdaTargetRestApi.methodResponse,
+                        this.apiToLambdaTargetRestApi.methodErrorResponse,
+                    ],
+                },
                 deployOptions: {
                     accessLogDestination: new apig.LogGroupLogDestination(accessLogGroup),
                 },
             },
         };
-        this.apiToLambdaTargetRestApi.api = this.apiManager.createLambdaRestApi(`${this.id}-lambda-rest-api`, this, this.props.api.restApi, lambda.Function.fromFunctionName(this, `${this.id}-lambda`, this.props.lambdaFunctionName));
+        this.apiToLambdaTargetRestApi.api = this.apiManager.createLambdaRestApi(`${this.id}-lambda-rest-api`, this, this.props.api.restApi, this.apiToLambdaTargetRestApi.lambda);
         this.addCfnOutput(`${this.id}-restApiId`, this.apiToLambdaTargetRestApi.api.restApiId);
         this.addCfnOutput(`${this.id}-restApiRootResourceId`, this.apiToLambdaTargetRestApi.api.root.resourceId);
     }
     /**
-     * @summary Method to create custom restApi domain for Api API
+     * @summary Method to create api integration resource
+     * @protected
+     */
+    createApiToLambdaTargetResource() {
+        if (!this.props.api.withResource)
+            return;
+        let rootResource;
+        if (this.props.api.withResource && this.props.api.importedRestApiRootResourceRef) {
+            rootResource = apig.Resource.fromResourceAttributes(this, `${this.id}-root-resource`, {
+                resourceId: cdk.Fn.importValue(this.props.api.importedRestApiRootResourceRef),
+                restApi: this.apiToLambdaTargetRestApi.api,
+                path: '/',
+            });
+        }
+        else {
+            rootResource = this.apiToLambdaTargetRestApi.api.root;
+        }
+        this.apiToLambdaTargetRestApi.resource = rootResource.addResource(this.props.api.resource ?? this.apiResource);
+    }
+    createApiToLambdaTargetPolicy() {
+        this.apiToLambdaTargetRestApi.policy = new iam.PolicyDocument({
+            statements: [
+                this.iamManager.statementForPutEvents(),
+                this.iamManager.statementForInvokeLambda([this.apiToLambdaTargetRestApi.lambda.functionArn]),
+            ],
+        });
+    }
+    /**
+     * @summary Method to create a role for api integration
+     * @protected
+     */
+    createApiToLambdaTargetRole() {
+        if (!this.apiToLambdaTargetRestApi.policy)
+            throw 'Policy undefined';
+        this.apiToLambdaTargetRestApi.role = new iam.Role(this, `${this.id}-rest-api-role`, {
+            assumedBy: new iam.ServicePrincipal('apigateway.amazonaws.com'),
+            inlinePolicies: { policy: this.apiToLambdaTargetRestApi.policy },
+        });
+    }
+    /**
+     * @summary Method to create api integration resource method
+     * @protected
+     */
+    createApiToLambdaTargetIntegration() {
+        this.apiToLambdaTargetRestApi.integration = new apig.LambdaIntegration(this.apiToLambdaTargetRestApi.lambda, {
+            allowTestInvoke: true,
+            credentialsRole: this.apiToLambdaTargetRestApi.role,
+        });
+    }
+    /**
+     * @summary Method to create api integration resource method
+     * @protected
+     */
+    createApiToLambdaTargetResourceMethod() {
+        if (!this.props.api.withResource)
+            return;
+        this.apiToLambdaTargetRestApi.method = this.apiToLambdaTargetRestApi.resource.addMethod('POST', this.apiToLambdaTargetRestApi.integration, {
+            authorizer: this.apiToLambdaTargetRestApi.authoriser,
+            methodResponses: [
+                this.apiToLambdaTargetRestApi.methodResponse,
+                this.apiToLambdaTargetRestApi.methodErrorResponse,
+            ],
+        });
+    }
+    /**
+     * @summary Method to create custom restApi domain for Api
      * @protected
      */
     createApiDomain() {
@@ -120,24 +242,14 @@ class ApiToLambdaTarget extends common_1.CommonConstruct {
             : `${this.props.apiSubDomain}-${this.props.stage}.${this.fullyQualifiedDomainName}`, this.apiToLambdaTargetRestApi.certificate);
     }
     /**
-     * @summary Method to create base path mappings for GraphQL API
+     * @summary Method to create base path mappings for Api
      * @protected
      */
     createApiBasePathMapping() {
-        const apiRootPaths = this.props.apiRootPaths;
-        if (apiRootPaths && apiRootPaths.length > 0) {
-            apiRootPaths.forEach((apiRootPath) => {
-                this.apiToLambdaTargetRestApi.basePathMappings.push(new apig.BasePathMapping(this, `${this.id}-base-bath-mapping-${apiRootPath}`, {
-                    basePath: apiRootPath,
-                    domainName: this.apiToLambdaTargetRestApi.domain,
-                    restApi: this.apiToLambdaTargetRestApi.api,
-                    stage: this.apiToLambdaTargetRestApi.api.deploymentStage,
-                }));
-            });
+        if (this.props.api.useExisting)
             return;
-        }
-        // add default mapping if apiRootPaths not set
         new apig.BasePathMapping(this, `${this.id}-base-bath-mapping`, {
+            basePath: '',
             domainName: this.apiToLambdaTargetRestApi.domain,
             restApi: this.apiToLambdaTargetRestApi.api,
             stage: this.apiToLambdaTargetRestApi.api.deploymentStage,

package/dist/src/lib/helper/api-to-lambda-target-rest-api.d.ts

@@ -1,6 +1,7 @@
 import * as apig from 'aws-cdk-lib/aws-apigateway';
 import * as acm from 'aws-cdk-lib/aws-certificatemanager';
 import * as iam from 'aws-cdk-lib/aws-iam';
+import * as lambda from 'aws-cdk-lib/aws-lambda';
 import * as route53 from 'aws-cdk-lib/aws-route53';
 import * as sns from 'aws-cdk-lib/aws-sns';
 import * as types from '../types/aws';
@@ -26,6 +27,7 @@ export declare class ApiToLambdaTargetRestApi implements types.ApiToLambdaTarget
         [p: string]: string;
     };
     integrationResponse: apig.IntegrationResponse;
+    lambda: lambda.IFunction;
     method: apig.Method;
     methodErrorResponse: apig.MethodResponse;
     methodResponse: apig.MethodResponse;

package/dist/src/lib/helper/api-to-lambda-target-rest-api.js

@@ -19,6 +19,7 @@ class ApiToLambdaTargetRestApi {
     integrationRequestParameters;
     integrationRequestTemplates;
     integrationResponse;
+    lambda;
     method;
     methodErrorResponse;
     methodResponse;

package/dist/src/lib/types/aws/index.d.ts

@@ -293,6 +293,7 @@ export interface ApiToLambdaTargetRestApiType {
         [p: string]: string;
     };
     integrationResponse: apig.IntegrationResponse;
+    lambda: lambda.IFunction;
     method: apig.Method;
     methodErrorResponse: apig.MethodResponse;
     methodResponse: apig.MethodResponse;
@@ -380,11 +381,15 @@ export interface ApiToEventBridgeTargetProps extends CommonStackProps {
  * @subcategory Properties
  */
 export interface ApiToLambdaTargetRestApiProps {
+    resource: string;
     certificate: AcmProps;
     restApi: apig.LambdaRestApiProps;
     importedRestApiRef?: string;
     importedRestApiRootResourceRef?: string;
     useExisting: boolean;
+    withResource?: boolean;
+    methodErrorResponse: apig.MethodResponse;
+    methodResponse: apig.MethodResponse;
 }
 /**
  * @category cdk-utils.api-to-lambda-target

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradientedge/cdk-utils",
-  "version": "6.10.3",
+  "version": "6.11.0",
   "description": "Utilities for AWS CDK provisioning",
   "main": "dist/index.js",
   "engines": {

package/src/lib/construct/api-to-eventbridge-target/main.ts

@@ -391,6 +391,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
             this.apiToEventBridgeTargetRestApi.methodErrorResponse,
           ],
         },
+        deploy: this.props.api.restApi?.deploy ?? true,
         deployOptions: {
           tracingEnabled: this.props.api.restApi?.deployOptions?.tracingEnabled,
           dataTraceEnabled: this.props.api.restApi?.deployOptions?.dataTraceEnabled,
@@ -505,7 +506,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
   }
 
   /**
-   * @summary Method to create custom restApi domain for Api API
+   * @summary Method to create custom restApi domain for Api
    * @protected
    */
   protected createApiDomain() {
@@ -521,7 +522,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
   }
 
   /**
-   * @summary Method to create base path mappings for Api API
+   * @summary Method to create base path mappings for Api
    * @protected
    */
   protected createApiBasePathMapping() {
@@ -535,7 +536,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
   }
 
   /**
-   * @summary Method to create route53 records for Api API
+   * @summary Method to create route53 records for Api
    * @protected
    */
   protected createApiRouteAssets() {

package/src/lib/construct/api-to-lambda-target/main.ts

@@ -1,5 +1,6 @@
 import * as cdk from 'aws-cdk-lib'
 import * as apig from 'aws-cdk-lib/aws-apigateway'
+import * as iam from 'aws-cdk-lib/aws-iam'
 import * as lambda from 'aws-cdk-lib/aws-lambda'
 import * as secretsmanager from 'aws-cdk-lib/aws-secretsmanager'
 import { Construct } from 'constructs'
@@ -16,6 +17,7 @@ export class ApiToLambdaTarget extends CommonConstruct {
 
   /* rest restApi related resources */
   apiToLambdaTargetRestApi: types.ApiToLambdaTargetRestApiType
+  apiResource: string
 
   constructor(parent: Construct, id: string, props: types.ApiToLambdaTargetProps) {
     super(parent, id, props)
@@ -35,7 +37,15 @@ export class ApiToLambdaTarget extends CommonConstruct {
     this.resolveCertificate()
 
     /* restApi related resources */
+    this.createApiToLambdaTargetMethodResponse()
+    this.createApiToLambdaTargetMethodErrorResponse()
+    this.resolveApiToLambdaTargetFunction()
     this.createApiToLambdaTargetRestApi()
+    this.createApiToLambdaTargetResource()
+    this.createApiToLambdaTargetPolicy()
+    this.createApiToLambdaTargetRole()
+    this.createApiToLambdaTargetIntegration()
+    this.createApiToLambdaTargetResourceMethod()
     this.createApiDomain()
     this.createApiBasePathMapping()
     this.createApiRouteAssets()
@@ -88,6 +98,52 @@ export class ApiToLambdaTarget extends CommonConstruct {
     )
   }
 
+  /**
+   * @summary Method to create api integration method response
+   * @protected
+   */
+  protected createApiToLambdaTargetMethodResponse() {
+    if (!this.props.api.withResource) return
+    this.apiToLambdaTargetRestApi.methodResponse = {
+      ...{
+        statusCode: '200',
+        responseParameters: {
+          'method.response.header.Content-Type': true,
+          'method.response.header.Access-Control-Allow-Origin': true,
+          'method.response.header.Access-Control-Allow-Credentials': true,
+        },
+      },
+      ...this.props.api.methodResponse,
+    }
+  }
+
+  /**
+   * @summary Method to create api integration method error response
+   * @protected
+   */
+  protected createApiToLambdaTargetMethodErrorResponse() {
+    if (!this.props.api.withResource) return
+    this.apiToLambdaTargetRestApi.methodErrorResponse = {
+      ...{
+        statusCode: '400',
+        responseParameters: {
+          'method.response.header.Content-Type': true,
+          'method.response.header.Access-Control-Allow-Origin': true,
+          'method.response.header.Access-Control-Allow-Credentials': true,
+        },
+      },
+      ...this.props.api.methodErrorResponse,
+    }
+  }
+
+  protected resolveApiToLambdaTargetFunction() {
+    this.apiToLambdaTargetRestApi.lambda = lambda.Function.fromFunctionName(
+      this,
+      `${this.id}-lambda`,
+      this.props.lambdaFunctionName
+    )
+  }
+
   /**
    * @summary Method to create rest restApi for Api
    * @protected
@@ -110,6 +166,12 @@ export class ApiToLambdaTarget extends CommonConstruct {
     this.props.api.restApi = {
       ...this.props.api.restApi,
       ...{
+        defaultMethodOptions: {
+          methodResponses: [
+            this.apiToLambdaTargetRestApi.methodResponse,
+            this.apiToLambdaTargetRestApi.methodErrorResponse,
+          ],
+        },
         deployOptions: {
           accessLogDestination: new apig.LogGroupLogDestination(accessLogGroup),
         },
@@ -120,7 +182,7 @@ export class ApiToLambdaTarget extends CommonConstruct {
       `${this.id}-lambda-rest-api`,
       this,
       this.props.api.restApi,
-      lambda.Function.fromFunctionName(this, `${this.id}-lambda`, this.props.lambdaFunctionName)
+      this.apiToLambdaTargetRestApi.lambda
     )
 
     this.addCfnOutput(`${this.id}-restApiId`, this.apiToLambdaTargetRestApi.api.restApiId)
@@ -128,7 +190,80 @@ export class ApiToLambdaTarget extends CommonConstruct {
   }
 
   /**
-   * @summary Method to create custom restApi domain for Api API
+   * @summary Method to create api integration resource
+   * @protected
+   */
+  protected createApiToLambdaTargetResource() {
+    if (!this.props.api.withResource) return
+
+    let rootResource
+    if (this.props.api.withResource && this.props.api.importedRestApiRootResourceRef) {
+      rootResource = apig.Resource.fromResourceAttributes(this, `${this.id}-root-resource`, {
+        resourceId: cdk.Fn.importValue(this.props.api.importedRestApiRootResourceRef),
+        restApi: this.apiToLambdaTargetRestApi.api,
+        path: '/',
+      })
+    } else {
+      rootResource = this.apiToLambdaTargetRestApi.api.root
+    }
+
+    this.apiToLambdaTargetRestApi.resource = rootResource.addResource(this.props.api.resource ?? this.apiResource)
+  }
+
+  protected createApiToLambdaTargetPolicy() {
+    this.apiToLambdaTargetRestApi.policy = new iam.PolicyDocument({
+      statements: [
+        this.iamManager.statementForPutEvents(),
+        this.iamManager.statementForInvokeLambda([this.apiToLambdaTargetRestApi.lambda.functionArn]),
+      ],
+    })
+  }
+
+  /**
+   * @summary Method to create a role for api integration
+   * @protected
+   */
+  protected createApiToLambdaTargetRole() {
+    if (!this.apiToLambdaTargetRestApi.policy) throw 'Policy undefined'
+
+    this.apiToLambdaTargetRestApi.role = new iam.Role(this, `${this.id}-rest-api-role`, {
+      assumedBy: new iam.ServicePrincipal('apigateway.amazonaws.com'),
+      inlinePolicies: { policy: this.apiToLambdaTargetRestApi.policy },
+    })
+  }
+
+  /**
+   * @summary Method to create api integration resource method
+   * @protected
+   */
+  protected createApiToLambdaTargetIntegration() {
+    this.apiToLambdaTargetRestApi.integration = new apig.LambdaIntegration(this.apiToLambdaTargetRestApi.lambda, {
+      allowTestInvoke: true,
+      credentialsRole: this.apiToLambdaTargetRestApi.role,
+    })
+  }
+
+  /**
+   * @summary Method to create api integration resource method
+   * @protected
+   */
+  protected createApiToLambdaTargetResourceMethod() {
+    if (!this.props.api.withResource) return
+    this.apiToLambdaTargetRestApi.method = this.apiToLambdaTargetRestApi.resource.addMethod(
+      'POST',
+      this.apiToLambdaTargetRestApi.integration,
+      {
+        authorizer: this.apiToLambdaTargetRestApi.authoriser,
+        methodResponses: [
+          this.apiToLambdaTargetRestApi.methodResponse,
+          this.apiToLambdaTargetRestApi.methodErrorResponse,
+        ],
+      }
+    )
+  }
+
+  /**
+   * @summary Method to create custom restApi domain for Api
    * @protected
    */
   protected createApiDomain() {
@@ -144,27 +279,13 @@ export class ApiToLambdaTarget extends CommonConstruct {
   }
 
   /**
-   * @summary Method to create base path mappings for GraphQL API
+   * @summary Method to create base path mappings for Api
    * @protected
    */
   protected createApiBasePathMapping() {
-    const apiRootPaths = this.props.apiRootPaths
-    if (apiRootPaths && apiRootPaths.length > 0) {
-      apiRootPaths.forEach((apiRootPath: string) => {
-        this.apiToLambdaTargetRestApi.basePathMappings.push(
-          new apig.BasePathMapping(this, `${this.id}-base-bath-mapping-${apiRootPath}`, {
-            basePath: apiRootPath,
-            domainName: this.apiToLambdaTargetRestApi.domain,
-            restApi: this.apiToLambdaTargetRestApi.api,
-            stage: this.apiToLambdaTargetRestApi.api.deploymentStage,
-          })
-        )
-      })
-      return
-    }
-
-    // add default mapping if apiRootPaths not set
+    if (this.props.api.useExisting) return
     new apig.BasePathMapping(this, `${this.id}-base-bath-mapping`, {
+      basePath: '',
       domainName: this.apiToLambdaTargetRestApi.domain,
       restApi: this.apiToLambdaTargetRestApi.api,
       stage: this.apiToLambdaTargetRestApi.api.deploymentStage,

package/src/lib/helper/api-to-lambda-target-rest-api.ts

@@ -1,6 +1,7 @@
 import * as apig from 'aws-cdk-lib/aws-apigateway'
 import * as acm from 'aws-cdk-lib/aws-certificatemanager'
 import * as iam from 'aws-cdk-lib/aws-iam'
+import * as lambda from 'aws-cdk-lib/aws-lambda'
 import * as route53 from 'aws-cdk-lib/aws-route53'
 import * as sns from 'aws-cdk-lib/aws-sns'
 import * as types from '../types/aws'
@@ -23,6 +24,7 @@ export class ApiToLambdaTargetRestApi implements types.ApiToLambdaTargetRestApiT
   integrationRequestParameters: { [p: string]: string }
   integrationRequestTemplates: { [p: string]: string }
   integrationResponse: apig.IntegrationResponse
+  lambda: lambda.IFunction
   method: apig.Method
   methodErrorResponse: apig.MethodResponse
   methodResponse: apig.MethodResponse

package/src/lib/types/aws/index.ts

@@ -305,6 +305,7 @@ export interface ApiToLambdaTargetRestApiType {
   integrationRequestParameters: { [p: string]: string }
   integrationRequestTemplates: { [p: string]: string }
   integrationResponse: apig.IntegrationResponse
+  lambda: lambda.IFunction
   method: apig.Method
   methodErrorResponse: apig.MethodResponse
   methodResponse: apig.MethodResponse
@@ -398,11 +399,15 @@ export interface ApiToEventBridgeTargetProps extends CommonStackProps {
  * @subcategory Properties
  */
 export interface ApiToLambdaTargetRestApiProps {
+  resource: string
   certificate: AcmProps
   restApi: apig.LambdaRestApiProps
   importedRestApiRef?: string
   importedRestApiRootResourceRef?: string
   useExisting: boolean
+  withResource?: boolean
+  methodErrorResponse: apig.MethodResponse
+  methodResponse: apig.MethodResponse
 }
 
 /**