@gradientedge/cdk-utils 8.80.0 → 8.82.0

package/dist/src/lib/common/construct.d.ts

@@ -35,6 +35,7 @@ export declare class CommonConstruct extends Construct {
     elasticacheManager: aws.ElastiCacheManager;
     eventManager: aws.EventManager;
     eventTargetManager: aws.EventTargetManager;
+    evidentlyManager: aws.EvidentlyManager;
     iamManager: aws.IamManager;
     kmsManager: aws.KmsManager;
     lambdaManager: aws.LambdaManager;

package/dist/src/lib/common/construct.js

@@ -60,6 +60,7 @@ class CommonConstruct extends constructs_1.Construct {
     elasticacheManager;
     eventManager;
     eventTargetManager;
+    evidentlyManager;
     iamManager;
     kmsManager;
     lambdaManager;
@@ -92,6 +93,7 @@ class CommonConstruct extends constructs_1.Construct {
         this.elasticacheManager = new aws.ElastiCacheManager();
         this.eventManager = new aws.EventManager();
         this.eventTargetManager = new aws.EventTargetManager();
+        this.evidentlyManager = new aws.EvidentlyManager();
         this.iamManager = new aws.IamManager();
         this.kmsManager = new aws.KmsManager();
         this.lambdaManager = new aws.LambdaManager();

package/dist/src/lib/construct/index.d.ts

@@ -6,4 +6,5 @@ export * from './graphql-api-lambda-with-cache';
 export * from './rest-api-lambda';
 export * from './rest-api-lambda-with-cache';
 export * from './site-with-ecs-backend';
+export * from './static-asset-deployment';
 export * from './static-site';

package/dist/src/lib/construct/index.js

@@ -22,4 +22,5 @@ __exportStar(require("./graphql-api-lambda-with-cache"), exports);
 __exportStar(require("./rest-api-lambda"), exports);
 __exportStar(require("./rest-api-lambda-with-cache"), exports);
 __exportStar(require("./site-with-ecs-backend"), exports);
+__exportStar(require("./static-asset-deployment"), exports);
 __exportStar(require("./static-site"), exports);

package/dist/src/lib/construct/static-asset-deployment/index.d.ts

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

package/dist/src/lib/construct/static-asset-deployment/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./main"), exports);
+__exportStar(require("./types"), exports);

package/dist/src/lib/construct/static-asset-deployment/main.d.ts

@@ -0,0 +1,45 @@
+import { CommonConstruct } from '../../common';
+import { Construct } from 'constructs';
+import * as s3 from 'aws-cdk-lib/aws-s3';
+import { StaticAssetDeploymentProps } from './types';
+/**
+ * @stability stable
+ * @category cdk-utils.static-asset-deployment
+ * @subcategory construct
+ * @classdesc Provides a construct to create and deploy static assets into S3 bucket
+ *
+ * @example
+ * import { StaticAssetDeployment, StaticAssetDeploymentProps } '@gradientedge/cdk-utils'
+ * import { Construct } from 'constructs'
+ *
+ * class CustomConstruct extends StaticAssetDeployment {
+ *   constructor(parent: Construct, id: string, props: StaticAssetDeploymentProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.id = id
+ *     this.initResources()
+ *   }
+ * }
+ * @mixin
+ */
+export declare class StaticAssetDeployment extends CommonConstruct {
+    props: StaticAssetDeploymentProps;
+    id: string;
+    staticAssetBucket: s3.IBucket;
+    constructor(parent: Construct, id: string, props: StaticAssetDeploymentProps);
+    /**
+     * @summary Initialise and provision resources
+     * @protected
+     */
+    protected initResources(): void;
+    /**
+     * @summary Create the static asset bucket
+     * @protected
+     */
+    protected createAssetBucket(): void;
+    /**
+     * @summary Deploy the static assests into the static asset bucket
+     * @protected
+     */
+    protected deployStaticAssets(): void;
+}

package/dist/src/lib/construct/static-asset-deployment/main.js

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StaticAssetDeployment = void 0;
+const common_1 = require("../../common");
+const s3deploy = __importStar(require("aws-cdk-lib/aws-s3-deployment"));
+/**
+ * @stability stable
+ * @category cdk-utils.static-asset-deployment
+ * @subcategory construct
+ * @classdesc Provides a construct to create and deploy static assets into S3 bucket
+ *
+ * @example
+ * import { StaticAssetDeployment, StaticAssetDeploymentProps } '@gradientedge/cdk-utils'
+ * import { Construct } from 'constructs'
+ *
+ * class CustomConstruct extends StaticAssetDeployment {
+ *   constructor(parent: Construct, id: string, props: StaticAssetDeploymentProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.id = id
+ *     this.initResources()
+ *   }
+ * }
+ * @mixin
+ */
+class StaticAssetDeployment extends common_1.CommonConstruct {
+    /* construct properties */
+    props;
+    id;
+    /* construct resources */
+    staticAssetBucket;
+    constructor(parent, id, props) {
+        super(parent, id, props);
+        this.props = props;
+        this.id = id;
+    }
+    /**
+     * @summary Initialise and provision resources
+     * @protected
+     */
+    initResources() {
+        this.createAssetBucket();
+        this.deployStaticAssets();
+    }
+    /**
+     * @summary Create the static asset bucket
+     * @protected
+     */
+    createAssetBucket() {
+        this.staticAssetBucket = this.s3Manager.createS3Bucket(`${this.id}-sa-bucket`, this, this.props.staticAssetBucket);
+    }
+    /**
+     * @summary Deploy the static assests into the static asset bucket
+     * @protected
+     */
+    deployStaticAssets() {
+        new s3deploy.BucketDeployment(this, `${this.id}-static-deployment`, {
+            ...this.props.staticAssetDeployment,
+            destinationBucket: this.staticAssetBucket,
+            sources: this.props.staticAssetSources,
+        });
+        const staticAssetsForExport = this.props.staticAssetsForExport;
+        if (!staticAssetsForExport)
+            return;
+        /* optional additional exports needed for asset urls */
+        staticAssetsForExport.forEach(asset => {
+            this.addCfnOutput(asset.key, this.staticAssetBucket.s3UrlForObject(asset.value));
+        });
+    }
+}
+exports.StaticAssetDeployment = StaticAssetDeployment;

package/dist/src/lib/construct/static-asset-deployment/types.d.ts

@@ -0,0 +1,11 @@
+import { BucketDeploymentProps, CommonStackProps, S3BucketProps } from '../../types';
+export interface AssetExport {
+    key: string;
+    value: string;
+}
+export interface StaticAssetDeploymentProps extends CommonStackProps {
+    staticAssetDeployment: BucketDeploymentProps;
+    staticAssetSources: any[];
+    staticAssetBucket: S3BucketProps;
+    staticAssetsForExport?: AssetExport[];
+}

package/dist/src/lib/construct/static-asset-deployment/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,60 @@
+import * as evidently from 'aws-cdk-lib/aws-evidently';
+import * as common from '../../common';
+import * as types from '../../types/aws';
+/**
+ * @stability stable
+ * @category cdk-utils.evidently-manager
+ * @subcategory Construct
+ * @classdesc Provides operations on AWS Evidently.
+ * - A new instance of this class is injected into {@link common.CommonConstruct} constructor.
+ * - If a custom construct extends {@link common.CommonConstruct}, an instance is available within the context.
+ * @example
+ * import * as common from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends common.common.CommonConstruct {
+ *   constructor(parent: cdk.Construct, id: string, props: common.CommonStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.evidentlyManager.createProject('MyNewProhect', this, props)
+ *   }
+ * }
+ *
+ * @see [CDK Evidently Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_evidently-readme.html}
+ */
+export declare class EvidentlyManager {
+    /**
+     * @summary Method to create a project
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlyProjectProps} props the project properties
+     */
+    createProject(id: string, scope: common.CommonConstruct, props: types.EvidentlyProjectProps): evidently.CfnProject;
+    /**
+     * @summary Method to create a feature
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlyFeatureProps} props the feature properties
+     */
+    createFeature(id: string, scope: common.CommonConstruct, props: types.EvidentlyFeatureProps): evidently.CfnFeature;
+    /**
+     * @summary Method to create a launch
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlyLaunchProps} props the launch properties
+     */
+    createLaunch(id: string, scope: common.CommonConstruct, props: types.EvidentlyLaunchProps): evidently.CfnLaunch;
+    /**
+     * @summary Method to create an experiment
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlyExperimentProps} props the experiment properties
+     */
+    createExperiment(id: string, scope: common.CommonConstruct, props: types.EvidentlyExperimentProps): evidently.CfnExperiment;
+    /**
+     * @summary Method to create a segment
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlySegmentProps} props the segment properties
+     */
+    createSegment(id: string, scope: common.CommonConstruct, props: types.EvidentlySegmentProps): evidently.CfnSegment;
+}

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

@@ -0,0 +1,127 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvidentlyManager = void 0;
+const evidently = __importStar(require("aws-cdk-lib/aws-evidently"));
+const utils = __importStar(require("../../utils"));
+/**
+ * @stability stable
+ * @category cdk-utils.evidently-manager
+ * @subcategory Construct
+ * @classdesc Provides operations on AWS Evidently.
+ * - A new instance of this class is injected into {@link common.CommonConstruct} constructor.
+ * - If a custom construct extends {@link common.CommonConstruct}, an instance is available within the context.
+ * @example
+ * import * as common from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends common.common.CommonConstruct {
+ *   constructor(parent: cdk.Construct, id: string, props: common.CommonStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.evidentlyManager.createProject('MyNewProhect', this, props)
+ *   }
+ * }
+ *
+ * @see [CDK Evidently Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_evidently-readme.html}
+ */
+class EvidentlyManager {
+    /**
+     * @summary Method to create a project
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlyProjectProps} props the project properties
+     */
+    createProject(id, scope, props) {
+        const project = new evidently.CfnProject(scope, `${id}`, {
+            ...props,
+            name: `${props.name}-${scope.props.stage}`,
+            description: `${props.description} ${scope.props.stage}`,
+        });
+        utils.createCfnOutput(`${id}-projectArn`, scope, project.attrArn);
+        utils.createCfnOutput(`${id}-projectName`, scope, project.name);
+        return project;
+    }
+    /**
+     * @summary Method to create a feature
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlyFeatureProps} props the feature properties
+     */
+    createFeature(id, scope, props) {
+        const feature = new evidently.CfnFeature(scope, `${id}`, props);
+        utils.createCfnOutput(`${id}-featureArn`, scope, feature.attrArn);
+        utils.createCfnOutput(`${id}-featureName`, scope, feature.name);
+        return feature;
+    }
+    /**
+     * @summary Method to create a launch
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlyLaunchProps} props the launch properties
+     */
+    createLaunch(id, scope, props) {
+        const launch = new evidently.CfnLaunch(scope, `${id}`, {
+            ...props,
+            name: `${props.name}-${scope.props.stage}`,
+            description: `${props.description} ${scope.props.stage}`,
+        });
+        utils.createCfnOutput(`${id}-launchArn`, scope, launch.attrArn);
+        utils.createCfnOutput(`${id}-launchName`, scope, launch.name);
+        return launch;
+    }
+    /**
+     * @summary Method to create an experiment
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlyExperimentProps} props the experiment properties
+     */
+    createExperiment(id, scope, props) {
+        const experiment = new evidently.CfnExperiment(scope, `${id}`, {
+            ...props,
+            name: `${props.name}-${scope.props.stage}`,
+            description: `${props.description} ${scope.props.stage}`,
+        });
+        utils.createCfnOutput(`${id}-experimentArn`, scope, experiment.attrArn);
+        utils.createCfnOutput(`${id}-experimentName`, scope, experiment.name);
+        return experiment;
+    }
+    /**
+     * @summary Method to create a segment
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {EvidentlySegmentProps} props the segment properties
+     */
+    createSegment(id, scope, props) {
+        const segment = new evidently.CfnSegment(scope, `${id}`, {
+            ...props,
+            name: `${props.name}-${scope.props.stage}`,
+            description: `${props.description} ${scope.props.stage}`,
+        });
+        utils.createCfnOutput(`${id}-segmentArn`, scope, segment.attrArn);
+        utils.createCfnOutput(`${id}-segmentName`, scope, segment.name);
+        return segment;
+    }
+}
+exports.EvidentlyManager = EvidentlyManager;

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

@@ -13,6 +13,7 @@ export * from './eks-manager';
 export * from './elasticache-manager';
 export * from './event-manager';
 export * from './event-target-manager';
+export * from './evidently-manager';
 export * from './iam-manager';
 export * from './kms-manager';
 export * from './lambda-manager';

package/dist/src/lib/manager/aws/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./eks-manager"), exports);
 __exportStar(require("./elasticache-manager"), exports);
 __exportStar(require("./event-manager"), exports);
 __exportStar(require("./event-target-manager"), exports);
+__exportStar(require("./evidently-manager"), exports);
 __exportStar(require("./iam-manager"), exports);
 __exportStar(require("./kms-manager"), exports);
 __exportStar(require("./lambda-manager"), exports);

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

@@ -30,6 +30,7 @@ import * as wafv2 from 'aws-cdk-lib/aws-wafv2';
 import * as types from '../index';
 import * as appAutoscaling from 'aws-cdk-lib/aws-applicationautoscaling';
 import * as pipes from 'aws-cdk-lib/aws-pipes';
+import * as evidently from 'aws-cdk-lib/aws-evidently';
 /**
  * @category cdk-utils.app-config-manager
  * @subcategory Properties
@@ -716,7 +717,7 @@ export interface SfnStartExecutionProps extends tasks.StepFunctionsStartExecutio
     retries?: SfnRetryProps[];
 }
 /**
-   }
+ }
  * @category cdk-utils.event-manager
  * @subcategory Properties
  */
@@ -740,6 +741,36 @@ export interface EventRuleProps extends events.RuleProps {
  */
 export interface EventBusProps extends events.EventBusProps {
 }
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlyProjectProps extends evidently.CfnProjectProps {
+}
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlyFeatureProps extends evidently.CfnFeatureProps {
+}
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlyLaunchProps extends evidently.CfnLaunchProps {
+}
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlyExperimentProps extends evidently.CfnExperimentProps {
+}
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlySegmentProps extends evidently.CfnSegmentProps {
+}
 /**
  * @category cdk-utils.common-stack
  * @subcategory Properties
@@ -822,6 +853,14 @@ export interface LifecycleRule extends s3.LifecycleRule {
     expirationInDays?: number;
     noncurrentVersionExpirationInDays?: number;
 }
+/**
+ * @category cdk-utils.s3-manager
+ * @subcategory Properties
+ */
+export interface BucketDeploymentProps extends s3deploy.BucketDeploymentProps {
+    expirationInDays?: number;
+    noncurrentVersionExpirationInDays?: number;
+}
 /**
  * @category cdk-utils.dynamodb-manager
  * @subcategory Properties

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gradientedge/cdk-utils",
-  "version": "8.80.0",
+  "version": "8.82.0",
   "description": "Utilities for AWS CDK provisioning",
   "main": "dist/index.js",
   "engines": {
@@ -46,13 +46,13 @@
     }
   },
   "dependencies": {
-    "@aws-sdk/client-secrets-manager": "^3.348.0",
+    "@aws-sdk/client-secrets-manager": "^3.350.0",
     "@types/lodash": "^4.14.195",
-    "@types/node": "^20.2.5",
+    "@types/node": "^20.3.0",
     "@types/uuid": "^9.0.2",
     "app-root-path": "^3.1.0",
-    "aws-cdk-lib": "^2.83.0",
-    "constructs": "^10.2.47",
+    "aws-cdk-lib": "^2.83.1",
+    "constructs": "^10.2.50",
     "lodash": "^4.17.21",
     "moment": "^2.29.4",
     "nconf": "^0.12.0",
@@ -65,9 +65,9 @@
     "@babel/eslint-parser": "^7.22.5",
     "@babel/plugin-proposal-class-properties": "^7.18.6",
     "@types/jest": "^29.5.2",
-    "@typescript-eslint/eslint-plugin": "^5.59.9",
-    "@typescript-eslint/parser": "^5.59.9",
-    "aws-cdk": "^2.83.0",
+    "@typescript-eslint/eslint-plugin": "^5.59.11",
+    "@typescript-eslint/parser": "^5.59.11",
+    "aws-cdk": "^2.83.1",
     "better-docs": "^2.7.2",
     "codecov": "^3.8.3",
     "commitizen": "^4.3.0",
@@ -89,7 +89,7 @@
     "prettier": "^2.8.8",
     "prettier-plugin-organize-imports": "^3.2.2",
     "rimraf": "^5.0.1",
-    "semantic-release": "^21.0.3",
+    "semantic-release": "^21.0.5",
     "taffydb": "^2.7.3",
     "ts-jest": "^29.1.0",
     "ts-node": "^10.9.1",

package/src/lib/common/construct.ts

@@ -37,6 +37,7 @@ export class CommonConstruct extends Construct {
   elasticacheManager: aws.ElastiCacheManager
   eventManager: aws.EventManager
   eventTargetManager: aws.EventTargetManager
+  evidentlyManager: aws.EvidentlyManager
   iamManager: aws.IamManager
   kmsManager: aws.KmsManager
   lambdaManager: aws.LambdaManager
@@ -71,6 +72,7 @@ export class CommonConstruct extends Construct {
     this.elasticacheManager = new aws.ElastiCacheManager()
     this.eventManager = new aws.EventManager()
     this.eventTargetManager = new aws.EventTargetManager()
+    this.evidentlyManager = new aws.EvidentlyManager()
     this.iamManager = new aws.IamManager()
     this.kmsManager = new aws.KmsManager()
     this.lambdaManager = new aws.LambdaManager()

package/src/lib/construct/index.ts

@@ -6,4 +6,5 @@ export * from './graphql-api-lambda-with-cache'
 export * from './rest-api-lambda'
 export * from './rest-api-lambda-with-cache'
 export * from './site-with-ecs-backend'
+export * from './static-asset-deployment'
 export * from './static-site'

package/src/lib/construct/static-asset-deployment/index.ts

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

package/src/lib/construct/static-asset-deployment/main.ts

@@ -0,0 +1,78 @@
+import { CommonConstruct } from '../../common'
+import { Construct } from 'constructs'
+import * as s3 from 'aws-cdk-lib/aws-s3'
+import * as s3deploy from 'aws-cdk-lib/aws-s3-deployment'
+import { StaticAssetDeploymentProps } from './types'
+
+/**
+ * @stability stable
+ * @category cdk-utils.static-asset-deployment
+ * @subcategory construct
+ * @classdesc Provides a construct to create and deploy static assets into S3 bucket
+ *
+ * @example
+ * import { StaticAssetDeployment, StaticAssetDeploymentProps } '@gradientedge/cdk-utils'
+ * import { Construct } from 'constructs'
+ *
+ * class CustomConstruct extends StaticAssetDeployment {
+ *   constructor(parent: Construct, id: string, props: StaticAssetDeploymentProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.id = id
+ *     this.initResources()
+ *   }
+ * }
+ * @mixin
+ */
+export class StaticAssetDeployment extends CommonConstruct {
+  /* construct properties */
+  props: StaticAssetDeploymentProps
+  id: string
+
+  /* construct resources */
+  staticAssetBucket: s3.IBucket
+
+  constructor(parent: Construct, id: string, props: StaticAssetDeploymentProps) {
+    super(parent, id, props)
+
+    this.props = props
+    this.id = id
+  }
+
+  /**
+   * @summary Initialise and provision resources
+   * @protected
+   */
+  protected initResources() {
+    this.createAssetBucket()
+    this.deployStaticAssets()
+  }
+
+  /**
+   * @summary Create the static asset bucket
+   * @protected
+   */
+  protected createAssetBucket() {
+    this.staticAssetBucket = this.s3Manager.createS3Bucket(`${this.id}-sa-bucket`, this, this.props.staticAssetBucket)
+  }
+
+  /**
+   * @summary Deploy the static assests into the static asset bucket
+   * @protected
+   */
+  protected deployStaticAssets() {
+    new s3deploy.BucketDeployment(this, `${this.id}-static-deployment`, {
+      ...this.props.staticAssetDeployment,
+      destinationBucket: this.staticAssetBucket,
+      sources: this.props.staticAssetSources,
+    })
+
+    const staticAssetsForExport = this.props.staticAssetsForExport
+    if (!staticAssetsForExport) return
+
+    /* optional additional exports needed for asset urls */
+    staticAssetsForExport.forEach(asset => {
+      this.addCfnOutput(asset.key, this.staticAssetBucket.s3UrlForObject(asset.value))
+    })
+  }
+}

package/src/lib/construct/static-asset-deployment/types.ts

@@ -0,0 +1,13 @@
+import { BucketDeploymentProps, CommonStackProps, S3BucketProps } from '../../types'
+
+export interface AssetExport {
+  key: string
+  value: string
+}
+
+export interface StaticAssetDeploymentProps extends CommonStackProps {
+  staticAssetDeployment: BucketDeploymentProps
+  staticAssetSources: any[]
+  staticAssetBucket: S3BucketProps
+  staticAssetsForExport?: AssetExport[]
+}

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

@@ -0,0 +1,108 @@
+import * as evidently from 'aws-cdk-lib/aws-evidently'
+import * as common from '../../common'
+import * as types from '../../types/aws'
+import * as utils from '../../utils'
+import { EvidentlyExperimentProps, EvidentlySegmentProps } from '../../types'
+
+/**
+ * @stability stable
+ * @category cdk-utils.evidently-manager
+ * @subcategory Construct
+ * @classdesc Provides operations on AWS Evidently.
+ * - A new instance of this class is injected into {@link common.CommonConstruct} constructor.
+ * - If a custom construct extends {@link common.CommonConstruct}, an instance is available within the context.
+ * @example
+ * import * as common from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends common.common.CommonConstruct {
+ *   constructor(parent: cdk.Construct, id: string, props: common.CommonStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.evidentlyManager.createProject('MyNewProhect', this, props)
+ *   }
+ * }
+ *
+ * @see [CDK Evidently Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_evidently-readme.html}
+ */
+export class EvidentlyManager {
+  /**
+   * @summary Method to create a project
+   * @param {string} id scoped id of the resource
+   * @param {common.CommonConstruct} scope scope in which this resource is defined
+   * @param {EvidentlyProjectProps} props the project properties
+   */
+  public createProject(id: string, scope: common.CommonConstruct, props: types.EvidentlyProjectProps) {
+    const project = new evidently.CfnProject(scope, `${id}`, {
+      ...props,
+      name: `${props.name}-${scope.props.stage}`,
+      description: `${props.description} ${scope.props.stage}`,
+    })
+    utils.createCfnOutput(`${id}-projectArn`, scope, project.attrArn)
+    utils.createCfnOutput(`${id}-projectName`, scope, project.name)
+    return project
+  }
+
+  /**
+   * @summary Method to create a feature
+   * @param {string} id scoped id of the resource
+   * @param {common.CommonConstruct} scope scope in which this resource is defined
+   * @param {EvidentlyFeatureProps} props the feature properties
+   */
+  public createFeature(id: string, scope: common.CommonConstruct, props: types.EvidentlyFeatureProps) {
+    const feature = new evidently.CfnFeature(scope, `${id}`, props)
+    utils.createCfnOutput(`${id}-featureArn`, scope, feature.attrArn)
+    utils.createCfnOutput(`${id}-featureName`, scope, feature.name)
+    return feature
+  }
+
+  /**
+   * @summary Method to create a launch
+   * @param {string} id scoped id of the resource
+   * @param {common.CommonConstruct} scope scope in which this resource is defined
+   * @param {EvidentlyLaunchProps} props the launch properties
+   */
+  public createLaunch(id: string, scope: common.CommonConstruct, props: types.EvidentlyLaunchProps) {
+    const launch = new evidently.CfnLaunch(scope, `${id}`, {
+      ...props,
+      name: `${props.name}-${scope.props.stage}`,
+      description: `${props.description} ${scope.props.stage}`,
+    })
+    utils.createCfnOutput(`${id}-launchArn`, scope, launch.attrArn)
+    utils.createCfnOutput(`${id}-launchName`, scope, launch.name)
+    return launch
+  }
+
+  /**
+   * @summary Method to create an experiment
+   * @param {string} id scoped id of the resource
+   * @param {common.CommonConstruct} scope scope in which this resource is defined
+   * @param {EvidentlyExperimentProps} props the experiment properties
+   */
+  public createExperiment(id: string, scope: common.CommonConstruct, props: types.EvidentlyExperimentProps) {
+    const experiment = new evidently.CfnExperiment(scope, `${id}`, {
+      ...props,
+      name: `${props.name}-${scope.props.stage}`,
+      description: `${props.description} ${scope.props.stage}`,
+    })
+    utils.createCfnOutput(`${id}-experimentArn`, scope, experiment.attrArn)
+    utils.createCfnOutput(`${id}-experimentName`, scope, experiment.name)
+    return experiment
+  }
+
+  /**
+   * @summary Method to create a segment
+   * @param {string} id scoped id of the resource
+   * @param {common.CommonConstruct} scope scope in which this resource is defined
+   * @param {EvidentlySegmentProps} props the segment properties
+   */
+  public createSegment(id: string, scope: common.CommonConstruct, props: types.EvidentlySegmentProps) {
+    const segment = new evidently.CfnSegment(scope, `${id}`, {
+      ...props,
+      name: `${props.name}-${scope.props.stage}`,
+      description: `${props.description} ${scope.props.stage}`,
+    })
+    utils.createCfnOutput(`${id}-segmentArn`, scope, segment.attrArn)
+    utils.createCfnOutput(`${id}-segmentName`, scope, segment.name)
+    return segment
+  }
+}

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

@@ -13,6 +13,7 @@ export * from './eks-manager'
 export * from './elasticache-manager'
 export * from './event-manager'
 export * from './event-target-manager'
+export * from './evidently-manager'
 export * from './iam-manager'
 export * from './kms-manager'
 export * from './lambda-manager'

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

@@ -30,6 +30,7 @@ import * as wafv2 from 'aws-cdk-lib/aws-wafv2'
 import * as types from '../index'
 import * as appAutoscaling from 'aws-cdk-lib/aws-applicationautoscaling'
 import * as pipes from 'aws-cdk-lib/aws-pipes'
+import * as evidently from 'aws-cdk-lib/aws-evidently'
 
 /**
  * @category cdk-utils.app-config-manager
@@ -765,7 +766,7 @@ export interface SfnStartExecutionProps extends tasks.StepFunctionsStartExecutio
 }
 
 /**
-   }
+ }
  * @category cdk-utils.event-manager
  * @subcategory Properties
  */
@@ -791,6 +792,36 @@ export interface EventRuleProps extends events.RuleProps {
  */
 export interface EventBusProps extends events.EventBusProps {}
 
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlyProjectProps extends evidently.CfnProjectProps {}
+
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlyFeatureProps extends evidently.CfnFeatureProps {}
+
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlyLaunchProps extends evidently.CfnLaunchProps {}
+
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlyExperimentProps extends evidently.CfnExperimentProps {}
+
+/**
+ * @category cdk-utils.evidently-manager
+ * @subcategory Properties
+ */
+export interface EvidentlySegmentProps extends evidently.CfnSegmentProps {}
+
 /**
  * @category cdk-utils.common-stack
  * @subcategory Properties
@@ -883,6 +914,15 @@ export interface LifecycleRule extends s3.LifecycleRule {
   noncurrentVersionExpirationInDays?: number
 }
 
+/**
+ * @category cdk-utils.s3-manager
+ * @subcategory Properties
+ */
+export interface BucketDeploymentProps extends s3deploy.BucketDeploymentProps {
+  expirationInDays?: number
+  noncurrentVersionExpirationInDays?: number
+}
+
 /**
  * @category cdk-utils.dynamodb-manager
  * @subcategory Properties