@gradientedge/cdk-utils 4.6.5 → 4.7.1

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

@@ -1,4 +1,3 @@
-import * as apig from 'aws-cdk-lib/aws-apigateway';
 import * as secretsmanager from 'aws-cdk-lib/aws-secretsmanager';
 import { Construct } from 'constructs';
 import { CommonConstruct } from '../../common';
@@ -32,7 +31,6 @@ export declare class ApiToEventBridgeTarget extends CommonConstruct {
     apiDestinedLambda: types.ApiDestinedLambdaType;
     apiEvent: types.ApiDestinationEventType;
     apiDestinedRestApi: types.ApiDestinedRestApiType;
-    apiDestinedBasePathMappings: apig.BasePathMapping[];
     apiResource: string;
     constructor(parent: Construct, id: string, props: types.ApiToEventBridgeTargetProps);
     protected initResources(): void;
@@ -82,36 +80,100 @@ export declare class ApiToEventBridgeTarget extends CommonConstruct {
      * @protected
      */
     protected createApiDestinedLambdaFunction(): void;
+    /**
+     * @summary Method to create or use an existing eventbus for api destined payload deliveries
+     * @protected
+     */
     protected createApiDestinedEventBus(): void;
+    /**
+     * @summary Method to create a log group for successful api destined payload deliveries
+     * @protected
+     */
     protected createApiDestinationLogGroupSuccess(): void;
     /**
      * Method to create EventBridge rule with lambda target for success
      * @protected
      */
     protected createApiDestinationRuleSuccess(): void;
+    /**
+     * @summary Method to create a log group for failed api destined payload deliveries
+     * @protected
+     */
     protected createApiDestinationLogGroupFailure(): void;
     /**
      * Method to create EventBridge rule with lambda target for failure
      * @protected
      */
     protected createApiDestinationRuleFailure(): void;
+    /**
+     * @summary Method to create a role for sns topic
+     * @protected
+     */
     protected createApiDestinedTopicRole(): void;
+    /**
+     * @summary Method to create API destined SNS topic
+     * @protected
+     */
     protected createApiDestinedTopic(): void;
     /**
-     * @summary Method to create rest restApi for Api
+     * @summary Method to create api integration request parameters
      * @protected
      */
-    protected createApiDestinedRestApi(): void;
-    protected createApiDestinedResponseModel(): void;
-    protected createApiDestinedErrorResponseModel(): void;
-    protected createApiDestinedResource(): void;
     protected createApiDestinedIntegrationRequestParameters(): void;
+    /**
+     * @summary Method to create api integration request templates
+     * @protected
+     */
     protected createApiDestinedIntegrationRequestTemplates(): void;
+    /**
+     * @summary Method to create api integration response
+     * @protected
+     */
     protected createApiDestinedIntegrationResponse(): void;
+    /**
+     * @summary Method to create api integration error response
+     * @protected
+     */
     protected createApiDestinedIntegrationErrorResponse(): void;
+    /**
+     * @summary Method to create api integration
+     * @protected
+     */
     protected createApiDestinedIntegration(): void;
+    /**
+     * @summary Method to create api integration method response
+     * @protected
+     */
     protected createApiDestinedMethodResponse(): void;
+    /**
+     * @summary Method to create api integration method error response
+     * @protected
+     */
     protected createApiDestinedMethodErrorResponse(): void;
+    /**
+     * @summary Method to create rest restApi for Api
+     * @protected
+     */
+    protected createApiDestinedRestApi(): void;
+    /**
+     * @summary Method to create api integration response model
+     * @protected
+     */
+    protected createApiDestinedResponseModel(): void;
+    /**
+     * @summary Method to create api integration error response model
+     * @protected
+     */
+    protected createApiDestinedErrorResponseModel(): void;
+    /**
+     * @summary Method to create api integration resource
+     * @protected
+     */
+    protected createApiDestinedResource(): void;
+    /**
+     * @summary Method to create api integration resource method
+     * @protected
+     */
     protected createApiDestinedResourceMethod(): void;
     /**
      * @summary Method to create custom restApi domain for Api API

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

@@ -22,10 +22,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiToEventBridgeTarget = void 0;
 const cdk = __importStar(require("aws-cdk-lib"));
 const apig = __importStar(require("aws-cdk-lib/aws-apigateway"));
+const events = __importStar(require("aws-cdk-lib/aws-events"));
 const eventstargets = __importStar(require("aws-cdk-lib/aws-events-targets"));
 const iam = __importStar(require("aws-cdk-lib/aws-iam"));
 const destinations = __importStar(require("aws-cdk-lib/aws-lambda-destinations"));
-const sns = __importStar(require("aws-cdk-lib/aws-sns"));
 const common_1 = require("../../common");
 const api_destination_event_1 = require("./api-destination-event");
 const api_destined_lambda_1 = require("./api-destined-lambda");
@@ -63,7 +63,6 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
     apiEvent;
     /* rest restApi related resources */
     apiDestinedRestApi;
-    apiDestinedBasePathMappings = [];
     apiResource;
     constructor(parent, id, props) {
         super(parent, id, props);
@@ -97,15 +96,15 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
         /* restApi related resources */
         this.createApiDestinedTopicRole();
         this.createApiDestinedTopic();
-        this.createApiDestinedRestApi();
-        this.createApiDestinedResponseModel();
-        this.createApiDestinedErrorResponseModel();
-        this.createApiDestinedResource();
         this.createApiDestinedIntegrationRequestParameters();
         this.createApiDestinedIntegrationRequestTemplates();
         this.createApiDestinedIntegrationResponse();
         this.createApiDestinedIntegrationErrorResponse();
         this.createApiDestinedIntegration();
+        this.createApiDestinedRestApi();
+        this.createApiDestinedResource();
+        this.createApiDestinedResponseModel();
+        this.createApiDestinedErrorResponseModel();
         this.createApiDestinedMethodResponse();
         this.createApiDestinedMethodErrorResponse();
         this.createApiDestinedResourceMethod();
@@ -216,13 +215,23 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             },
         }, this.apiDestinedLambda.role, this.apiDestinedLambda.layers, this.props.lambda.source, this.props.lambda.handler ?? 'lambda.handler', this.apiDestinedLambda.environment);
     }
+    /**
+     * @summary Method to create or use an existing eventbus for api destined payload deliveries
+     * @protected
+     */
     createApiDestinedEventBus() {
-        if (this.props.api.useExisting)
+        if (this.props.api.useExisting) {
+            this.apiEvent.eventBus = events.EventBus.fromEventBusName(this, `${this.id}-destined-event-bus`, `${this.props.event.eventBusName}-${this.props.stage}`);
             return;
+        }
         this.apiEvent.eventBus = this.eventManager.createEventBus(`${this.id}-destined-event-bus`, this, {
             eventBusName: `${this.props.event.eventBusName}`,
         });
     }
+    /**
+     * @summary Method to create a log group for successful api destined payload deliveries
+     * @protected
+     */
     createApiDestinationLogGroupSuccess() {
         if (this.props.api.useExisting)
             return;
@@ -259,6 +268,10 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
         };
         this.apiEvent.ruleSuccess = this.eventManager.createRule(`${this.id}-api-destination-rule-success`, this, this.props.event.ruleSuccess, this.apiEvent.eventBus, [new eventstargets.CloudWatchLogGroup(this.apiEvent.logGroupSuccess)]);
     }
+    /**
+     * @summary Method to create a log group for failed api destined payload deliveries
+     * @protected
+     */
     createApiDestinationLogGroupFailure() {
         if (this.props.api.useExisting)
             return;
@@ -291,95 +304,31 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
         };
         this.apiEvent.ruleFailure = this.eventManager.createRule(`${this.id}-api-destination-rule-failure`, this, this.props.event.ruleFailure, this.apiEvent.eventBus, [new eventstargets.CloudWatchLogGroup(this.apiEvent.logGroupFailure)]);
     }
+    /**
+     * @summary Method to create a role for sns topic
+     * @protected
+     */
     createApiDestinedTopicRole() {
-        if (this.props.api.useExisting)
-            return;
         this.apiDestinedRestApi.topicRole = new iam.Role(this, `${this.id}-sns-rest-api-role`, {
             assumedBy: new iam.ServicePrincipal('apigateway.amazonaws.com'),
         });
     }
+    /**
+     * @summary Method to create API destined SNS topic
+     * @protected
+     */
     createApiDestinedTopic() {
-        if (this.props.api.useExisting) {
-            this.apiDestinedRestApi.topic = sns.Topic.fromTopicArn(this, `${this.id}-destined-topic`, `arn:aws:sns:${this.props.region}:${cdk.Stack.of(this).account}:${this.id}-destined-topic-${this.props.stage}`);
-        }
+        if (!this.props.api.withResource)
+            return;
         this.apiDestinedRestApi.topic = this.snsManager.createLambdaNotificationService(`${this.id}-destined-topic`, this, {
             topicName: `${this.id}-destined-topic`,
         }, this.apiDestinedLambda.function);
         this.apiDestinedRestApi.topic.grantPublish(this.apiDestinedRestApi.topicRole);
     }
     /**
-     * @summary Method to create rest restApi for Api
+     * @summary Method to create api integration request parameters
      * @protected
      */
-    createApiDestinedRestApi() {
-        if (this.props.api.useExisting) {
-            this.apiDestinedRestApi.api = apig.RestApi.fromRestApiId(this, `${this.id}-sns-rest-api`, cdk.Fn.importValue('importedRestApiRef'));
-        }
-        this.apiDestinedRestApi.api = new apig.RestApi(this, `${this.id}-sns-rest-api`, {
-            ...{
-                deployOptions: {
-                    dataTraceEnabled: true,
-                    description: `${this.id} - ${this.props.stage} stage`,
-                    loggingLevel: apig.MethodLoggingLevel.INFO,
-                    metricsEnabled: true,
-                    stageName: this.props.stage,
-                },
-                endpointConfiguration: {
-                    types: [apig.EndpointType.REGIONAL],
-                },
-                defaultCorsPreflightOptions: {
-                    allowOrigins: apig.Cors.ALL_ORIGINS,
-                    allowMethods: ['POST'],
-                    allowHeaders: apig.Cors.DEFAULT_HEADERS,
-                },
-                restApiName: `${this.id}-destined-rest-api-${this.props.stage}`,
-            },
-            ...this.props.api,
-        });
-        this.addCfnOutput(`${this.id}-restApiId`, this.apiDestinedRestApi.api.restApiId);
-    }
-    createApiDestinedResponseModel() {
-        if (this.props.api.useExisting)
-            return;
-        this.apiDestinedRestApi.responseModel = this.apiDestinedRestApi.api.addModel(`${this.id}-response-model`, {
-            ...{
-                contentType: 'application/json',
-                modelName: 'ResponseModel',
-                schema: {
-                    schema: apig.JsonSchemaVersion.DRAFT4,
-                    title: 'pollResponse',
-                    type: apig.JsonSchemaType.OBJECT,
-                    properties: { message: { type: apig.JsonSchemaType.STRING } },
-                },
-            },
-            ...this.props.api.responseModel,
-        });
-    }
-    createApiDestinedErrorResponseModel() {
-        if (this.props.api.useExisting)
-            return;
-        this.apiDestinedRestApi.errorResponseModel = this.apiDestinedRestApi.api.addModel(`${this.id}-error-response-model`, {
-            ...{
-                contentType: 'application/json',
-                modelName: 'ErrorResponseModel',
-                schema: {
-                    schema: apig.JsonSchemaVersion.DRAFT4,
-                    title: 'errorResponse',
-                    type: apig.JsonSchemaType.OBJECT,
-                    properties: {
-                        state: { type: apig.JsonSchemaType.STRING },
-                        message: { type: apig.JsonSchemaType.STRING },
-                    },
-                },
-            },
-            ...this.props.api.errorResponseModel,
-        });
-    }
-    createApiDestinedResource() {
-        if (!this.props.api.withResource)
-            return;
-        this.apiDestinedRestApi.resource = this.apiDestinedRestApi.api.root.addResource(this.props.api.resource ?? this.apiResource);
-    }
     createApiDestinedIntegrationRequestParameters() {
         if (!this.props.api.withResource)
             return;
@@ -387,6 +336,10 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             'integration.request.header.Content-Type': "'application/x-www-form-urlencoded'",
         };
     }
+    /**
+     * @summary Method to create api integration request templates
+     * @protected
+     */
     createApiDestinedIntegrationRequestTemplates() {
         if (!this.props.api.withResource)
             return;
@@ -399,6 +352,10 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             ].join('&'),
         };
     }
+    /**
+     * @summary Method to create api integration response
+     * @protected
+     */
     createApiDestinedIntegrationResponse() {
         if (!this.props.api.withResource)
             return;
@@ -412,6 +369,10 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             ...this.props.api.integrationResponse,
         };
     }
+    /**
+     * @summary Method to create api integration error response
+     * @protected
+     */
     createApiDestinedIntegrationErrorResponse() {
         if (!this.props.api.withResource)
             return;
@@ -434,6 +395,10 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             ...this.props.api.integrationErrorResponse,
         };
     }
+    /**
+     * @summary Method to create api integration
+     * @protected
+     */
     createApiDestinedIntegration() {
         if (!this.props.api.withResource)
             return;
@@ -456,6 +421,10 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             },
         });
     }
+    /**
+     * @summary Method to create api integration method response
+     * @protected
+     */
     createApiDestinedMethodResponse() {
         if (!this.props.api.withResource)
             return;
@@ -474,6 +443,10 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             ...this.props.api.methodResponse,
         };
     }
+    /**
+     * @summary Method to create api integration method error response
+     * @protected
+     */
     createApiDestinedMethodErrorResponse() {
         if (!this.props.api.withResource)
             return;
@@ -492,10 +465,119 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
             ...this.props.api.methodErrorResponse,
         };
     }
+    /**
+     * @summary Method to create rest restApi for Api
+     * @protected
+     */
+    createApiDestinedRestApi() {
+        if (this.props.api.useExisting && this.props.api.importedRestApiRef) {
+            this.apiDestinedRestApi.api = apig.RestApi.fromRestApiId(this, `${this.id}-sns-rest-api`, cdk.Fn.importValue(this.props.api.importedRestApiRef));
+            return;
+        }
+        this.apiDestinedRestApi.api = new apig.RestApi(this, `${this.id}-sns-rest-api`, {
+            ...{
+                defaultIntegration: this.apiDestinedRestApi.integration,
+                defaultMethodOptions: {
+                    methodResponses: [this.apiDestinedRestApi.methodResponse, this.apiDestinedRestApi.methodErrorResponse],
+                },
+                deployOptions: {
+                    dataTraceEnabled: true,
+                    description: `${this.id} - ${this.props.stage} stage`,
+                    loggingLevel: apig.MethodLoggingLevel.INFO,
+                    metricsEnabled: true,
+                    stageName: this.props.stage,
+                },
+                endpointConfiguration: {
+                    types: [apig.EndpointType.REGIONAL],
+                },
+                defaultCorsPreflightOptions: {
+                    allowOrigins: apig.Cors.ALL_ORIGINS,
+                    allowMethods: ['POST'],
+                    allowHeaders: apig.Cors.DEFAULT_HEADERS,
+                },
+                restApiName: `${this.id}-destined-rest-api-${this.props.stage}`,
+            },
+            ...this.props.api,
+        });
+        this.addCfnOutput(`${this.id}-restApiId`, this.apiDestinedRestApi.api.restApiId);
+        this.addCfnOutput(`${this.id}-restApiRootResourceId`, this.apiDestinedRestApi.api.root.resourceId);
+    }
+    /**
+     * @summary Method to create api integration response model
+     * @protected
+     */
+    createApiDestinedResponseModel() {
+        if (!this.props.api.withResource)
+            return;
+        this.apiDestinedRestApi.responseModel = new apig.Model(this, `${this.id}-response-model`, {
+            restApi: this.apiDestinedRestApi.api,
+            ...{
+                contentType: 'application/json',
+                modelName: 'ResponseModel',
+                schema: {
+                    schema: apig.JsonSchemaVersion.DRAFT4,
+                    title: 'pollResponse',
+                    type: apig.JsonSchemaType.OBJECT,
+                    properties: { message: { type: apig.JsonSchemaType.STRING } },
+                },
+            },
+            ...this.props.api.responseModel,
+        });
+    }
+    /**
+     * @summary Method to create api integration error response model
+     * @protected
+     */
+    createApiDestinedErrorResponseModel() {
+        if (!this.props.api.withResource)
+            return;
+        this.apiDestinedRestApi.errorResponseModel = new apig.Model(this, `${this.id}-error-response-model`, {
+            restApi: this.apiDestinedRestApi.api,
+            ...{
+                contentType: 'application/json',
+                modelName: 'ErrorResponseModel',
+                schema: {
+                    schema: apig.JsonSchemaVersion.DRAFT4,
+                    title: 'errorResponse',
+                    type: apig.JsonSchemaType.OBJECT,
+                    properties: {
+                        state: { type: apig.JsonSchemaType.STRING },
+                        message: { type: apig.JsonSchemaType.STRING },
+                    },
+                },
+            },
+            ...this.props.api.errorResponseModel,
+        });
+    }
+    /**
+     * @summary Method to create api integration resource
+     * @protected
+     */
+    createApiDestinedResource() {
+        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.apiDestinedRestApi.api,
+                path: '/',
+            });
+        }
+        else {
+            rootResource = this.apiDestinedRestApi.api.root;
+        }
+        this.apiDestinedRestApi.resource = rootResource.addResource(this.props.api.resource ?? this.apiResource);
+    }
+    /**
+     * @summary Method to create api integration resource method
+     * @protected
+     */
     createApiDestinedResourceMethod() {
         if (!this.props.api.withResource)
             return;
         this.apiDestinedRestApi.method = this.apiDestinedRestApi.resource.addMethod('POST', this.apiDestinedRestApi.integration, {
+            authorizer: this.apiDestinedRestApi.authoriser,
             methodResponses: [this.apiDestinedRestApi.methodResponse, this.apiDestinedRestApi.methodErrorResponse],
         });
     }
@@ -515,23 +597,22 @@ class ApiToEventBridgeTarget extends common_1.CommonConstruct {
      * @protected
      */
     createApiBasePathMapping() {
-        const apiRootPaths = this.props.apiRootPaths;
-        if (apiRootPaths && apiRootPaths.length > 0) {
-            apiRootPaths.forEach((apiRootPath) => {
-                this.apiDestinedBasePathMappings.push(new apig.BasePathMapping(this, `${this.id}-base-bath-mapping-${apiRootPath}`, {
-                    basePath: this.props.api.resource,
-                    domainName: this.apiDestinedRestApi.domain,
-                    restApi: this.apiDestinedRestApi.api,
-                    stage: this.apiDestinedRestApi.api.deploymentStage,
-                }));
-            });
-        }
+        if (this.props.api.useExisting)
+            return;
+        new apig.BasePathMapping(this, `${this.id}-base-bath-mapping`, {
+            basePath: '',
+            domainName: this.apiDestinedRestApi.domain,
+            restApi: this.apiDestinedRestApi.api,
+            stage: this.apiDestinedRestApi.api.deploymentStage,
+        });
     }
     /**
      * @summary Method to create route53 records for Api API
      * @protected
      */
     createApiRouteAssets() {
+        if (this.props.api.useExisting)
+            return;
         this.route53Manager.createApiGatewayARecord(`${this.id}-custom-domain-a-record`, this, this.props.apiSubDomain, this.apiDestinedRestApi.domain, this.apiDestinedRestApi.hostedZone);
     }
 }

package/dist/src/lib/manager/aws/sns-manager.d.ts

@@ -36,7 +36,7 @@ export declare class SnsManager {
      * @param {string} id scoped id of the resource
      * @param {common.CommonConstruct} scope scope in which this resource is defined
      * @param {types.SubscriptionProps} props
-     * @param {lambda.Function} lambdaFunction
+     * @param {lambda.IFunction} lambdaFunction
      */
-    createLambdaNotificationService(id: string, scope: common.CommonConstruct, props: types.SubscriptionProps, lambdaFunction: lambda.Function): sns.Topic;
+    createLambdaNotificationService(id: string, scope: common.CommonConstruct, props: types.SubscriptionProps, lambdaFunction: lambda.IFunction): sns.Topic;
 }

package/dist/src/lib/manager/aws/sns-manager.js

@@ -71,7 +71,7 @@ class SnsManager {
      * @param {string} id scoped id of the resource
      * @param {common.CommonConstruct} scope scope in which this resource is defined
      * @param {types.SubscriptionProps} props
-     * @param {lambda.Function} lambdaFunction
+     * @param {lambda.IFunction} lambdaFunction
      */
     createLambdaNotificationService(id, scope, props, lambdaFunction) {
         if (!props)

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

@@ -171,6 +171,7 @@ export interface ApiDestinationEventType {
  */
 export interface ApiDestinedRestApiType {
     api: apig.IRestApi;
+    authoriser?: apig.IAuthorizer;
     certificate: acm.ICertificate;
     domain: apig.DomainName;
     errorResponseModel: apig.Model;
@@ -200,7 +201,7 @@ export interface ApiDestinedLambdaType {
     destinationFailure: destinations.EventBridgeDestination;
     destinationSuccess: destinations.EventBridgeDestination;
     environment: types.ApiDestinedLambdaEnvironment;
-    function: lambda.Function;
+    function: lambda.IFunction;
     layers: lambda.LayerVersion[];
     layerSource?: lambda.AssetCode;
     policy: iam.PolicyDocument;
@@ -222,6 +223,8 @@ export interface ApiToEventBridgeTargetRestApiProps {
     errorResponseModel?: apig.ModelOptions;
     responseModel?: apig.ModelOptions;
     restApi?: apig.RestApiProps;
+    importedRestApiRef?: string;
+    importedRestApiRootResourceRef?: string;
     useExisting: boolean;
     withResource?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradientedge/cdk-utils",
-  "version": "4.6.5",
+  "version": "4.7.1",
   "description": "Utilities for AWS CDK provisioning",
   "main": "dist/index.js",
   "engines": {
@@ -50,7 +50,7 @@
     "app-root-path": "^3.0.0",
     "aws-cdk-lib": "^2.12.0",
     "aws-sdk": "^2.1074.0",
-    "constructs": "^10.0.62",
+    "constructs": "^10.0.63",
     "lodash": "^4.17.21",
     "moment": "^2.29.1",
     "nconf": "^0.11.3",

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

@@ -1,11 +1,11 @@
 import * as cdk from 'aws-cdk-lib'
 import * as apig from 'aws-cdk-lib/aws-apigateway'
+import * as events from 'aws-cdk-lib/aws-events'
 import * as eventstargets from 'aws-cdk-lib/aws-events-targets'
 import * as iam from 'aws-cdk-lib/aws-iam'
 import * as lambda from 'aws-cdk-lib/aws-lambda'
 import * as destinations from 'aws-cdk-lib/aws-lambda-destinations'
 import * as secretsmanager from 'aws-cdk-lib/aws-secretsmanager'
-import * as sns from 'aws-cdk-lib/aws-sns'
 import { Construct } from 'constructs'
 import { CommonConstruct } from '../../common'
 import * as types from '../../types'
@@ -50,7 +50,6 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
 
   /* rest restApi related resources */
   apiDestinedRestApi: types.ApiDestinedRestApiType
-  apiDestinedBasePathMappings: apig.BasePathMapping[] = []
   apiResource: string
 
   constructor(parent: Construct, id: string, props: types.ApiToEventBridgeTargetProps) {
@@ -93,15 +92,15 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     /* restApi related resources */
     this.createApiDestinedTopicRole()
     this.createApiDestinedTopic()
-    this.createApiDestinedRestApi()
-    this.createApiDestinedResponseModel()
-    this.createApiDestinedErrorResponseModel()
-    this.createApiDestinedResource()
     this.createApiDestinedIntegrationRequestParameters()
     this.createApiDestinedIntegrationRequestTemplates()
     this.createApiDestinedIntegrationResponse()
     this.createApiDestinedIntegrationErrorResponse()
     this.createApiDestinedIntegration()
+    this.createApiDestinedRestApi()
+    this.createApiDestinedResource()
+    this.createApiDestinedResponseModel()
+    this.createApiDestinedErrorResponseModel()
     this.createApiDestinedMethodResponse()
     this.createApiDestinedMethodErrorResponse()
     this.createApiDestinedResourceMethod()
@@ -247,13 +246,28 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     )
   }
 
+  /**
+   * @summary Method to create or use an existing eventbus for api destined payload deliveries
+   * @protected
+   */
   protected createApiDestinedEventBus() {
-    if (this.props.api.useExisting) return
+    if (this.props.api.useExisting) {
+      this.apiEvent.eventBus = events.EventBus.fromEventBusName(
+        this,
+        `${this.id}-destined-event-bus`,
+        `${this.props.event.eventBusName}-${this.props.stage}`
+      )
+      return
+    }
     this.apiEvent.eventBus = this.eventManager.createEventBus(`${this.id}-destined-event-bus`, this, {
       eventBusName: `${this.props.event.eventBusName}`,
     })
   }
 
+  /**
+   * @summary Method to create a log group for successful api destined payload deliveries
+   * @protected
+   */
   protected createApiDestinationLogGroupSuccess() {
     if (this.props.api.useExisting) return
     this.apiEvent.logGroupSuccess = this.logManager.createLogGroup(`${this.id}-destination-success-log`, this, {
@@ -296,6 +310,10 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     )
   }
 
+  /**
+   * @summary Method to create a log group for failed api destined payload deliveries
+   * @protected
+   */
   protected createApiDestinationLogGroupFailure() {
     if (this.props.api.useExisting) return
     this.apiEvent.logGroupFailure = this.logManager.createLogGroup(`${this.id}-destination-failure-log`, this, {
@@ -334,21 +352,22 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     )
   }
 
+  /**
+   * @summary Method to create a role for sns topic
+   * @protected
+   */
   protected createApiDestinedTopicRole() {
-    if (this.props.api.useExisting) return
     this.apiDestinedRestApi.topicRole = new iam.Role(this, `${this.id}-sns-rest-api-role`, {
       assumedBy: new iam.ServicePrincipal('apigateway.amazonaws.com'),
     })
   }
 
+  /**
+   * @summary Method to create API destined SNS topic
+   * @protected
+   */
   protected createApiDestinedTopic() {
-    if (this.props.api.useExisting) {
-      this.apiDestinedRestApi.topic = sns.Topic.fromTopicArn(
-        this,
-        `${this.id}-destined-topic`,
-        `arn:aws:sns:${this.props.region}:${cdk.Stack.of(this).account}:${this.id}-destined-topic-${this.props.stage}`
-      )
-    }
+    if (!this.props.api.withResource) return
     this.apiDestinedRestApi.topic = this.snsManager.createLambdaNotificationService(
       `${this.id}-destined-topic`,
       this,
@@ -362,91 +381,9 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
   }
 
   /**
-   * @summary Method to create rest restApi for Api
+   * @summary Method to create api integration request parameters
    * @protected
    */
-  protected createApiDestinedRestApi() {
-    if (this.props.api.useExisting) {
-      this.apiDestinedRestApi.api = apig.RestApi.fromRestApiId(
-        this,
-        `${this.id}-sns-rest-api`,
-        cdk.Fn.importValue('importedRestApiRef')
-      )
-    }
-    this.apiDestinedRestApi.api = new apig.RestApi(this, `${this.id}-sns-rest-api`, {
-      ...{
-        deployOptions: {
-          dataTraceEnabled: true,
-          description: `${this.id} - ${this.props.stage} stage`,
-          loggingLevel: apig.MethodLoggingLevel.INFO,
-          metricsEnabled: true,
-          stageName: this.props.stage,
-        },
-        endpointConfiguration: {
-          types: [apig.EndpointType.REGIONAL],
-        },
-        defaultCorsPreflightOptions: {
-          allowOrigins: apig.Cors.ALL_ORIGINS,
-          allowMethods: ['POST'],
-          allowHeaders: apig.Cors.DEFAULT_HEADERS,
-        },
-        restApiName: `${this.id}-destined-rest-api-${this.props.stage}`,
-      },
-      ...this.props.api,
-    })
-    this.addCfnOutput(`${this.id}-restApiId`, this.apiDestinedRestApi.api.restApiId)
-  }
-
-  protected createApiDestinedResponseModel() {
-    if (this.props.api.useExisting) return
-    this.apiDestinedRestApi.responseModel = (this.apiDestinedRestApi.api as apig.RestApi).addModel(
-      `${this.id}-response-model`,
-      {
-        ...{
-          contentType: 'application/json',
-          modelName: 'ResponseModel',
-          schema: {
-            schema: apig.JsonSchemaVersion.DRAFT4,
-            title: 'pollResponse',
-            type: apig.JsonSchemaType.OBJECT,
-            properties: { message: { type: apig.JsonSchemaType.STRING } },
-          },
-        },
-        ...this.props.api.responseModel,
-      }
-    )
-  }
-
-  protected createApiDestinedErrorResponseModel() {
-    if (this.props.api.useExisting) return
-    this.apiDestinedRestApi.errorResponseModel = (this.apiDestinedRestApi.api as apig.RestApi).addModel(
-      `${this.id}-error-response-model`,
-      {
-        ...{
-          contentType: 'application/json',
-          modelName: 'ErrorResponseModel',
-          schema: {
-            schema: apig.JsonSchemaVersion.DRAFT4,
-            title: 'errorResponse',
-            type: apig.JsonSchemaType.OBJECT,
-            properties: {
-              state: { type: apig.JsonSchemaType.STRING },
-              message: { type: apig.JsonSchemaType.STRING },
-            },
-          },
-        },
-        ...this.props.api.errorResponseModel,
-      }
-    )
-  }
-
-  protected createApiDestinedResource() {
-    if (!this.props.api.withResource) return
-    this.apiDestinedRestApi.resource = this.apiDestinedRestApi.api.root.addResource(
-      this.props.api.resource ?? this.apiResource
-    )
-  }
-
   protected createApiDestinedIntegrationRequestParameters() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.integrationRequestParameters = {
@@ -454,6 +391,10 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     }
   }
 
+  /**
+   * @summary Method to create api integration request templates
+   * @protected
+   */
   protected createApiDestinedIntegrationRequestTemplates() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.integrationRequestTemplates = {
@@ -466,6 +407,10 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     }
   }
 
+  /**
+   * @summary Method to create api integration response
+   * @protected
+   */
   protected createApiDestinedIntegrationResponse() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.integrationResponse = {
@@ -479,6 +424,10 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     }
   }
 
+  /**
+   * @summary Method to create api integration error response
+   * @protected
+   */
   protected createApiDestinedIntegrationErrorResponse() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.integrationErrorResponse = {
@@ -501,6 +450,10 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     }
   }
 
+  /**
+   * @summary Method to create api integration
+   * @protected
+   */
   protected createApiDestinedIntegration() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.integration = new apig.Integration({
@@ -523,6 +476,10 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     })
   }
 
+  /**
+   * @summary Method to create api integration method response
+   * @protected
+   */
   protected createApiDestinedMethodResponse() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.methodResponse = {
@@ -541,6 +498,10 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     }
   }
 
+  /**
+   * @summary Method to create api integration method error response
+   * @protected
+   */
   protected createApiDestinedMethodErrorResponse() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.methodErrorResponse = {
@@ -559,12 +520,127 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
     }
   }
 
+  /**
+   * @summary Method to create rest restApi for Api
+   * @protected
+   */
+  protected createApiDestinedRestApi() {
+    if (this.props.api.useExisting && this.props.api.importedRestApiRef) {
+      this.apiDestinedRestApi.api = apig.RestApi.fromRestApiId(
+        this,
+        `${this.id}-sns-rest-api`,
+        cdk.Fn.importValue(this.props.api.importedRestApiRef)
+      )
+      return
+    }
+    this.apiDestinedRestApi.api = new apig.RestApi(this, `${this.id}-sns-rest-api`, {
+      ...{
+        defaultIntegration: this.apiDestinedRestApi.integration,
+        defaultMethodOptions: {
+          methodResponses: [this.apiDestinedRestApi.methodResponse, this.apiDestinedRestApi.methodErrorResponse],
+        },
+        deployOptions: {
+          dataTraceEnabled: true,
+          description: `${this.id} - ${this.props.stage} stage`,
+          loggingLevel: apig.MethodLoggingLevel.INFO,
+          metricsEnabled: true,
+          stageName: this.props.stage,
+        },
+        endpointConfiguration: {
+          types: [apig.EndpointType.REGIONAL],
+        },
+        defaultCorsPreflightOptions: {
+          allowOrigins: apig.Cors.ALL_ORIGINS,
+          allowMethods: ['POST'],
+          allowHeaders: apig.Cors.DEFAULT_HEADERS,
+        },
+        restApiName: `${this.id}-destined-rest-api-${this.props.stage}`,
+      },
+      ...this.props.api,
+    })
+    this.addCfnOutput(`${this.id}-restApiId`, this.apiDestinedRestApi.api.restApiId)
+    this.addCfnOutput(`${this.id}-restApiRootResourceId`, this.apiDestinedRestApi.api.root.resourceId)
+  }
+
+  /**
+   * @summary Method to create api integration response model
+   * @protected
+   */
+  protected createApiDestinedResponseModel() {
+    if (!this.props.api.withResource) return
+    this.apiDestinedRestApi.responseModel = new apig.Model(this, `${this.id}-response-model`, {
+      restApi: this.apiDestinedRestApi.api,
+      ...{
+        contentType: 'application/json',
+        modelName: 'ResponseModel',
+        schema: {
+          schema: apig.JsonSchemaVersion.DRAFT4,
+          title: 'pollResponse',
+          type: apig.JsonSchemaType.OBJECT,
+          properties: { message: { type: apig.JsonSchemaType.STRING } },
+        },
+      },
+      ...this.props.api.responseModel,
+    })
+  }
+
+  /**
+   * @summary Method to create api integration error response model
+   * @protected
+   */
+  protected createApiDestinedErrorResponseModel() {
+    if (!this.props.api.withResource) return
+    this.apiDestinedRestApi.errorResponseModel = new apig.Model(this, `${this.id}-error-response-model`, {
+      restApi: this.apiDestinedRestApi.api,
+      ...{
+        contentType: 'application/json',
+        modelName: 'ErrorResponseModel',
+        schema: {
+          schema: apig.JsonSchemaVersion.DRAFT4,
+          title: 'errorResponse',
+          type: apig.JsonSchemaType.OBJECT,
+          properties: {
+            state: { type: apig.JsonSchemaType.STRING },
+            message: { type: apig.JsonSchemaType.STRING },
+          },
+        },
+      },
+      ...this.props.api.errorResponseModel,
+    })
+  }
+
+  /**
+   * @summary Method to create api integration resource
+   * @protected
+   */
+  protected createApiDestinedResource() {
+    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.apiDestinedRestApi.api,
+        path: '/',
+      })
+    } else {
+      rootResource = this.apiDestinedRestApi.api.root
+    }
+
+    this.apiDestinedRestApi.resource = rootResource.addResource(this.props.api.resource ?? this.apiResource)
+  }
+
+  /**
+   * @summary Method to create api integration resource method
+   * @protected
+   */
   protected createApiDestinedResourceMethod() {
     if (!this.props.api.withResource) return
     this.apiDestinedRestApi.method = this.apiDestinedRestApi.resource.addMethod(
       'POST',
       this.apiDestinedRestApi.integration,
       {
+        authorizer: this.apiDestinedRestApi.authoriser,
         methodResponses: [this.apiDestinedRestApi.methodResponse, this.apiDestinedRestApi.methodErrorResponse],
       }
     )
@@ -591,19 +667,13 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiBasePathMapping() {
-    const apiRootPaths = this.props.apiRootPaths
-    if (apiRootPaths && apiRootPaths.length > 0) {
-      apiRootPaths.forEach((apiRootPath: string) => {
-        this.apiDestinedBasePathMappings.push(
-          new apig.BasePathMapping(this, `${this.id}-base-bath-mapping-${apiRootPath}`, {
-            basePath: this.props.api.resource,
-            domainName: this.apiDestinedRestApi.domain,
-            restApi: this.apiDestinedRestApi.api,
-            stage: this.apiDestinedRestApi.api.deploymentStage,
-          })
-        )
-      })
-    }
+    if (this.props.api.useExisting) return
+    new apig.BasePathMapping(this, `${this.id}-base-bath-mapping`, {
+      basePath: '',
+      domainName: this.apiDestinedRestApi.domain,
+      restApi: this.apiDestinedRestApi.api,
+      stage: this.apiDestinedRestApi.api.deploymentStage,
+    })
   }
 
   /**
@@ -611,6 +681,7 @@ export class ApiToEventBridgeTarget extends CommonConstruct {
    * @protected
    */
   protected createApiRouteAssets() {
+    if (this.props.api.useExisting) return
     this.route53Manager.createApiGatewayARecord(
       `${this.id}-custom-domain-a-record`,
       this,

package/src/lib/manager/aws/sns-manager.ts

@@ -62,13 +62,13 @@ export class SnsManager {
    * @param {string} id scoped id of the resource
    * @param {common.CommonConstruct} scope scope in which this resource is defined
    * @param {types.SubscriptionProps} props
-   * @param {lambda.Function} lambdaFunction
+   * @param {lambda.IFunction} lambdaFunction
    */
   public createLambdaNotificationService(
     id: string,
     scope: common.CommonConstruct,
     props: types.SubscriptionProps,
-    lambdaFunction: lambda.Function
+    lambdaFunction: lambda.IFunction
   ) {
     if (!props) throw `Subscription props undefined`
 

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

@@ -182,6 +182,7 @@ export interface ApiDestinationEventType {
  */
 export interface ApiDestinedRestApiType {
   api: apig.IRestApi
+  authoriser?: apig.IAuthorizer
   certificate: acm.ICertificate
   domain: apig.DomainName
   errorResponseModel: apig.Model
@@ -208,7 +209,7 @@ export interface ApiDestinedLambdaType {
   destinationFailure: destinations.EventBridgeDestination
   destinationSuccess: destinations.EventBridgeDestination
   environment: types.ApiDestinedLambdaEnvironment
-  function: lambda.Function
+  function: lambda.IFunction
   layers: lambda.LayerVersion[]
   layerSource?: lambda.AssetCode
   policy: iam.PolicyDocument
@@ -231,6 +232,8 @@ export interface ApiToEventBridgeTargetRestApiProps {
   errorResponseModel?: apig.ModelOptions
   responseModel?: apig.ModelOptions
   restApi?: apig.RestApiProps
+  importedRestApiRef?: string
+  importedRestApiRootResourceRef?: string
   useExisting: boolean
   withResource?: boolean
 }