@gradientedge/cdk-utils 10.8.0 → 11.0.0

package/src/lib/aws/construct/rest-api-lambda/main.ts

@@ -1,246 +0,0 @@
-import { BasePathMapping, DomainName, RestApi } from 'aws-cdk-lib/aws-apigateway'
-import { ICertificate } from 'aws-cdk-lib/aws-certificatemanager'
-import { PolicyDocument, Role } from 'aws-cdk-lib/aws-iam'
-import { AssetCode, IFunction, ILayerVersion, LayerVersion } from 'aws-cdk-lib/aws-lambda'
-import { IHostedZone } from 'aws-cdk-lib/aws-route53'
-import { ISecret } from 'aws-cdk-lib/aws-secretsmanager'
-import { Construct } from 'constructs'
-import _ from 'lodash'
-import { CommonConstruct } from '../../common/index.js'
-import { RestApiLambdaEnvironment, RestApiLambdaProps } from './types.js'
-
-/**
- * @classdesc Provides a construct to create and deploy a RestApi as Lambda
- *
- * <b>Architecture</b><br/> ![Architecture](./RestApiLambda.jpg)
- * @example
- * import { RestApiLambda, RestApiLambdaProps } '@gradientedge/cdk-utils'
- * import { Construct } from 'constructs'
- *
- * class CustomConstruct extends RestApiLambda {
- *   constructor(parent: Construct, id: string, props: RestApiLambdaProps) {
- *     super(parent, id, props)
- *     this.props = props
- *     this.id = id
- *     this.initResources()
- *   }
- * }
- */
-export abstract class RestApiLambda extends CommonConstruct {
-  /* restApiLambda props */
-  props: RestApiLambdaProps
-  id: string
-
-  /* restApiLambda resources */
-  applicationSecrets: ISecret[]
-  restApiLambdaPolicy: PolicyDocument
-  restApiLambdaRole: Role
-  restApiLambdaEnvironment: RestApiLambdaEnvironment
-  restApiLambdaLayers: ILayerVersion[] = []
-  restApiLambdaFunction: IFunction
-  restApi: RestApi
-  restApiHostedZone: IHostedZone
-  restApiCertificate: ICertificate
-  restApiDomain: DomainName
-  restApiBasePathMappings: BasePathMapping[] = []
-
-  protected constructor(parent: Construct, id: string, props: RestApiLambdaProps) {
-    super(parent, id, props)
-
-    this.props = props
-    this.id = id
-  }
-
-  /**
-   * @summary Initialise and provision resources
-   */
-  public initResources() {
-    this.resolveSecrets()
-    this.resolveHostedZone()
-    this.resolveCertificate()
-    this.createLambdaPolicy()
-    this.createLambdaRole()
-    this.createLambdaEnvironment()
-    this.createLambdaLayers()
-    this.createLambdaFunction()
-    this.createRestApi()
-    this.createRestApiResources()
-    this.createApiDomain()
-    this.createApiBasePathMapping()
-    this.createApiRouteAssets()
-  }
-
-  /**
-   * @summary Method to resolve secrets from SecretsManager
-   * - To be implemented in the overriding method in the implementation class
-   */
-  protected resolveSecrets() {
-    this.applicationSecrets = []
-  }
-
-  /**
-   * @summary Method to resolve a hosted zone based on domain attributes
-   */
-  protected resolveHostedZone() {
-    this.restApiHostedZone = this.route53Manager.withHostedZoneFromFullyQualifiedDomainName(
-      `${this.id}-hosted-zone`,
-      this,
-      this.props.useExistingHostedZone
-    )
-  }
-
-  /**
-   * @summary Method to resolve a certificate based on attributes
-   */
-  protected resolveCertificate() {
-    if (
-      this.props.restApiCertificate.useExistingCertificate &&
-      this.props.restApiCertificate.certificateSsmName &&
-      this.props.restApiCertificate.certificateRegion
-    ) {
-      this.props.restApiCertificate.certificateArn = this.ssmManager.readStringParameterFromRegion(
-        `${this.id}-certificate-param`,
-        this,
-        this.props.restApiCertificate.certificateSsmName,
-        this.props.restApiCertificate.certificateRegion
-      )
-    }
-
-    this.restApiCertificate = this.acmManager.resolveCertificate(
-      `${this.id}-certificate`,
-      this,
-      this.props.restApiCertificate
-    )
-  }
-
-  /**
-   * @summary Method to create iam policy for RestApi Lambda function
-   */
-  protected createLambdaPolicy() {
-    this.restApiLambdaPolicy = new PolicyDocument({
-      statements: [this.iamManager.statementForCreateAnyLogStream()],
-    })
-  }
-
-  /**
-   * @summary Method to create iam role for RestApi Lambda function
-   */
-  protected createLambdaRole() {
-    this.restApiLambdaRole = this.iamManager.createRoleForLambda(
-      `${this.id}-lambda-role`,
-      this,
-      this.restApiLambdaPolicy
-    )
-  }
-
-  /**
-   * @summary Method to create environment variables for RestApi Lambda function
-   */
-  protected createLambdaEnvironment() {
-    this.restApiLambdaEnvironment = {
-      LOG_LEVEL: this.props.logLevel,
-      NODE_ENV: this.props.nodeEnv,
-      TZ: this.props.timezone,
-    }
-  }
-
-  /**
-   * @summary Method to create layers for RestApi Lambda function
-   */
-  protected createLambdaLayers() {
-    const layers: LayerVersion[] = []
-
-    if (!this.props.restApiLambdaLayerSources) return
-
-    _.forEach(this.props.restApiLambdaLayerSources, (source: AssetCode, index: number) => {
-      layers.push(this.lambdaManager.createLambdaLayer(`${this.id}-layer-${index}`, this, source))
-    })
-
-    this.restApiLambdaLayers = layers
-  }
-
-  /**
-   * @summary Method to create lambda function for RestApi
-   */
-  protected createLambdaFunction() {
-    this.restApiLambdaFunction = this.lambdaManager.createLambdaFunction(
-      `${this.id}-restapi-server`,
-      this,
-      this.props.restApiLambda,
-      this.restApiLambdaRole,
-      this.restApiLambdaLayers,
-      this.props.restApiSource,
-      this.props.restApiHandler || 'index.handler',
-      this.restApiLambdaEnvironment
-    )
-  }
-
-  /**
-   * @summary Method to create rest restApiLambda for RestApi
-   */
-  protected createRestApi() {
-    this.restApi = this.apiManager.createLambdaRestApi(
-      `${this.id}-lambda-rest-api`,
-      this,
-      this.props.restApi,
-      this.restApiLambdaFunction
-    )
-  }
-
-  protected abstract createRestApiResources(): void
-
-  /**
-   * @summary Method to create custom restApiLambda domain for RestApi
-   */
-  protected createApiDomain() {
-    this.restApiDomain = this.apiManager.createApiDomain(
-      `${this.id}-api-domain`,
-      this,
-      this.isProductionStage() || this.props.skipStageForARecords
-        ? `${this.props.apiSubDomain}.${this.fullyQualifiedDomainName}`
-        : `${this.props.apiSubDomain}-${this.props.stage}.${this.fullyQualifiedDomainName}`,
-      this.restApiCertificate
-    )
-  }
-
-  /**
-   * @summary Method to create base path mappings for RestApi
-   */
-  protected createApiBasePathMapping() {
-    const apiRootPaths = this.props.apiRootPaths
-    if (apiRootPaths && !_.isEmpty(apiRootPaths)) {
-      _.forEach(apiRootPaths, (apiRootPath: string) => {
-        this.restApiBasePathMappings.push(
-          new BasePathMapping(this, `${this.id}-base-bath-mapping-${apiRootPath}`, {
-            basePath: apiRootPath,
-            domainName: this.restApiDomain,
-            restApi: this.restApi,
-            stage: this.restApi.deploymentStage,
-          })
-        )
-      })
-      return
-    }
-
-    // add default mapping if apiRootPaths not set
-    new BasePathMapping(this, `${this.id}-base-bath-mapping`, {
-      domainName: this.restApiDomain,
-      restApi: this.restApi,
-      stage: this.restApi.deploymentStage,
-    })
-  }
-
-  /**
-   * @summary Method to create route53 records for RestApi
-   */
-  protected createApiRouteAssets() {
-    this.route53Manager.createApiGatewayARecord(
-      `${this.id}-custom-domain-a-record`,
-      this,
-      this.props.apiSubDomain,
-      this.restApiDomain,
-      this.restApiHostedZone,
-      this.props.skipStageForARecords
-    )
-  }
-}

package/src/lib/aws/construct/rest-api-lambda/types.ts

@@ -1,24 +0,0 @@
-import { AcmProps, LambdaEnvironment, LambdaProps, LambdaRestApiProps } from '../../services/index.js'
-import { CommonStackProps } from '../../common/index.js'
-import { AssetCode } from 'aws-cdk-lib/aws-lambda'
-
-/**
- */
-export interface RestApiLambdaEnvironment extends LambdaEnvironment {}
-
-/**
- */
-export interface RestApiLambdaProps extends CommonStackProps {
-  apiRootPaths?: string[]
-  apiSubDomain: string
-  logLevel: string
-  nodeEnv: string
-  restApi: LambdaRestApiProps
-  restApiCertificate: AcmProps
-  restApiHandler: string
-  restApiLambda: LambdaProps
-  restApiLambdaLayerSources?: AssetCode[]
-  restApiSource: AssetCode
-  timezone: string
-  useExistingHostedZone: boolean
-}

package/src/lib/aws/construct/rest-api-lambda-with-cache/index.ts

@@ -1,2 +0,0 @@
-export * from './main.js'
-export * from './types.js'

package/src/lib/aws/construct/rest-api-lambda-with-cache/main.ts

@@ -1,166 +0,0 @@
-import { Fn } from 'aws-cdk-lib'
-import { ISecurityGroup, IVpc, Peer, Port, SecurityGroup } from 'aws-cdk-lib/aws-ec2'
-import { CfnReplicationGroup } from 'aws-cdk-lib/aws-elasticache'
-import { ManagedPolicy } from 'aws-cdk-lib/aws-iam'
-import { Construct } from 'constructs'
-import _ from 'lodash'
-import { createCfnOutput } from '../../utils/index.js'
-import { RestApiLambdaWithCacheProps } from './types.js'
-import { RestApiLambda } from '../rest-api-lambda/index.js'
-
-/**
- * @classdesc Provides a construct to create and deploy a RestApi API as Lambda with Caching
- *
- * <b>Architecture</b><br/> ![Architecture](./RestApiLambda.jpg)
- * @example
- * import { RestApiLambdaWithCacheProps } '@gradientedge/cdk-utils'
- * import { Construct } from 'constructs'
- *
- * class CustomConstruct extends RestApiLambdaWithCache {
- *   constructor(parent: Construct, id: string, props: RestApiLambdaWithCacheProps) {
- *     super(parent, id, props)
- *     this.props = props
- *     this.id = id
- *     this.initResources()
- *   }
- * }
- */
-export abstract class RestApiLambdaWithCache extends RestApiLambda {
-  /* restApiLambdaWithCache props */
-  props: RestApiLambdaWithCacheProps
-  id: string
-
-  /* restApiLambda resources */
-  restApivpc: IVpc
-  restApiCache: CfnReplicationGroup
-  restApiSecurityGroup: ISecurityGroup
-  restApiSecurityGroupExportName: string
-
-  protected constructor(parent: Construct, id: string, props: RestApiLambdaWithCacheProps) {
-    super(parent, id, props)
-
-    this.props = props
-    this.id = id
-  }
-
-  public initResources() {
-    this.resolveVpc()
-    this.resolveSecurityGroup()
-    this.createElastiCache()
-    super.initResources()
-  }
-
-  /**
-   * Create VPC
-   */
-  protected resolveVpc() {
-    if (this.props.useExistingVpc) {
-      this.restApivpc = this.vpcManager.retrieveCommonVpc(`${this.id}-vpc`, this, this.props.vpcName)
-    } else {
-      this.restApivpc = this.vpcManager.createCommonVpc(
-        `${this.id}-vpc`,
-        this,
-        this.props.restApiVpc,
-        this.props.restApiVpc.vpcName
-      )
-    }
-  }
-
-  /**
-   * Resolve Security Group
-   */
-  protected resolveSecurityGroup() {
-    if (this.props.securityGroupExportName) {
-      this.restApiSecurityGroup = SecurityGroup.fromSecurityGroupId(
-        this,
-        `${this.id}-security-group`,
-        Fn.importValue(this.props.securityGroupExportName)
-      )
-    } else {
-      this.restApiSecurityGroup = new SecurityGroup(this, `${this.id}-security-group-${this.props.stage}`, {
-        securityGroupName: `${this.id}-security-group-${this.props.stage}`,
-        vpc: this.restApivpc,
-      })
-
-      if (this.props.restApiVpc.isIPV6) {
-        this.restApiSecurityGroup.addIngressRule(Peer.anyIpv6(), Port.allTraffic(), 'All Traffic')
-      } else {
-        this.restApiSecurityGroup.addIngressRule(Peer.anyIpv4(), Port.allTraffic(), 'All Traffic')
-      }
-
-      createCfnOutput(`${this.id}-security-group-id`, this, this.restApiSecurityGroup.securityGroupId)
-    }
-  }
-
-  /**
-   * Create ElastiCache
-   */
-  protected createElastiCache() {
-    if (!this.props.restApiCache) {
-      return
-    }
-
-    this.restApiCache = this.elasticacheManager.createReplicatedElastiCache(
-      `${this.id}-elasticache`,
-      this,
-      this.props.restApiCache,
-      _.map(this.restApivpc.privateSubnets, subnet => subnet.subnetId),
-      [this.restApiSecurityGroup.securityGroupId]
-    )
-
-    this.ssmManager.writeStringToParameters(`${this.id}-elasticache-endpoint-address`, this, {
-      description: `Elasticache address to use by applications`,
-      parameterName: `${this.id}-elasticache-endpoint-address`,
-      stringValue: this.restApiCache.attrConfigurationEndPointAddress,
-    })
-
-    this.ssmManager.writeStringToParameters(`${this.id}-elasticache-endpoint-port`, this, {
-      description: `Elasticache port to use by applications`,
-      parameterName: `${this.id}-elasticache-endpoint-port`,
-      stringValue: this.restApiCache.attrConfigurationEndPointPort,
-    })
-  }
-
-  /**
-   * Create Lambda Role
-   */
-  protected createLambdaRole() {
-    super.createLambdaRole()
-
-    this.restApiLambdaRole.addManagedPolicy(
-      ManagedPolicy.fromAwsManagedPolicyName('service-role/AWSLambdaVPCAccessExecutionRole')
-    )
-  }
-
-  /**
-   * @summary Method to create environment variables for RestApi Lambda function
-   */
-  protected createLambdaEnvironment() {
-    this.restApiLambdaEnvironment = {
-      LOG_LEVEL: this.props.logLevel,
-      NODE_ENV: this.props.nodeEnv,
-      TZ: this.props.timezone,
-    }
-  }
-
-  /**
-   * @summary Method to create lambda function for RestApi API
-   */
-  protected createLambdaFunction() {
-    this.restApiLambdaFunction = this.lambdaManager.createLambdaFunction(
-      `${this.id}-restapi-server`,
-      this,
-      this.props.restApiLambda,
-      this.restApiLambdaRole,
-      this.restApiLambdaLayers,
-      this.props.restApiSource,
-      this.props.restApiHandler || 'index.handler',
-      this.restApiLambdaEnvironment,
-      this.restApivpc,
-      [this.restApiSecurityGroup],
-      undefined,
-      undefined,
-      this.restApivpc
-    )
-  }
-}

package/src/lib/aws/construct/rest-api-lambda-with-cache/types.ts

@@ -1,12 +0,0 @@
-import { RestApiLambdaProps } from '../rest-api-lambda/index.js'
-import { ReplicatedElastiCacheProps, VpcProps } from '../../services/index.js'
-
-/**
- */
-export interface RestApiLambdaWithCacheProps extends RestApiLambdaProps {
-  restApiCache: ReplicatedElastiCacheProps
-  restApiVpc: VpcProps
-  securityGroupExportName: string
-  useExistingVpc: boolean
-  vpcName?: string
-}

package/src/lib/aws/construct/site-with-ecs-backend/constants.ts

@@ -1,4 +0,0 @@
-export enum SiteResponseHeaderPolicyType {
-  ORIGIN = 'origin',
-  STATIC = 'static',
-}

package/src/lib/aws/construct/site-with-ecs-backend/index.ts

@@ -1,3 +0,0 @@
-export * from './constants.js'
-export * from './main.js'
-export * from './types.js'