@gradientedge/cdk-utils 4.4.7 → 4.5.1

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

@@ -0,0 +1,61 @@
+import * as ssm from 'aws-cdk-lib/aws-ssm';
+import * as cr from 'aws-cdk-lib/custom-resources';
+import * as common from '../../common';
+import * as types from '../../types';
+/**
+ * @stability stable
+ * @category cdk-utils.ssm-manager
+ * @subcategory Construct
+ * @classdesc Provides operations on AWS Systems Manager.
+ * - 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 { common.CommonConstruct } from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends common.CommonConstruct {
+ *   constructor(parent: cdk.Construct, id: string, props: common.CommonStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.acmManager.writeStringToParameters('MyParameter', this, ...props)
+ *   }
+ * }
+ *
+ * @see [CDK Systems Manager Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ssm-readme.html}
+ */
+export declare class SsmManager {
+    /**
+     * Method to write a string parameter to the parameters store
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {ssm.StringParameterProps} props parameter props
+     */
+    writeStringToParameters(id: string, scope: common.CommonConstruct, props: ssm.StringParameterProps): ssm.StringParameter;
+    /**
+     * Method to read a string parameter from the parameters store
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {string} parameterName parameter name to lookup
+     */
+    readStringParameter(id: string, scope: common.CommonConstruct, parameterName: string): string;
+    /**
+     * Method to read a string parameter from the parameters store in a given region
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {string} parameterName parameter name to lookup
+     * @param {string} region region name to lookup parameter
+     */
+    readStringParameterFromRegion(id: string, scope: common.CommonConstruct, parameterName: string, region: string): string;
+}
+/**
+ * @category cdk-utils.ssm-manager
+ * @subcategory Construct
+ * @classdesc Provides utilities to read same/cross region SSM parameters
+ */
+export declare class SSMParameterReader extends cr.AwsCustomResource {
+    constructor(scope: common.CommonConstruct, name: string, props: types.SSMParameterReaderProps);
+    /**
+     *
+     */
+    getParameterValue(): string;
+}
+//# sourceMappingURL=ssm-manager.d.ts.map

package/dist/src/lib/manager/aws/ssm-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssm-manager.d.ts","sourceRoot":"","sources":["../../../../../src/lib/manager/aws/ssm-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,8BAA8B,CAAA;AAClD,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAGpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAU;IACrB;;;;;OAKG;IACI,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,CAAC,oBAAoB;IAezG;;;;;OAKG;IACI,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,EAAE,MAAM;IAM3F;;;;;;OAMG;IACI,6BAA6B,CAClC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,CAAC,eAAe,EAC7B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM;CAUjB;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,EAAE,CAAC,iBAAiB;gBAC9C,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,uBAAuB;IAmB7F;;OAEG;IACI,iBAAiB,IAAI,MAAM;CAGnC"}

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

@@ -0,0 +1,125 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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.SSMParameterReader = exports.SsmManager = void 0;
+const ssm = __importStar(require("aws-cdk-lib/aws-ssm"));
+const cr = __importStar(require("aws-cdk-lib/custom-resources"));
+const utils = __importStar(require("../../utils"));
+/**
+ * @stability stable
+ * @category cdk-utils.ssm-manager
+ * @subcategory Construct
+ * @classdesc Provides operations on AWS Systems Manager.
+ * - 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 { common.CommonConstruct } from '@gradientedge/cdk-utils'
+ *
+ * class CustomConstruct extends common.CommonConstruct {
+ *   constructor(parent: cdk.Construct, id: string, props: common.CommonStackProps) {
+ *     super(parent, id, props)
+ *     this.props = props
+ *     this.acmManager.writeStringToParameters('MyParameter', this, ...props)
+ *   }
+ * }
+ *
+ * @see [CDK Systems Manager Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ssm-readme.html}
+ */
+class SsmManager {
+    /**
+     * Method to write a string parameter to the parameters store
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {ssm.StringParameterProps} props parameter props
+     */
+    writeStringToParameters(id, scope, props) {
+        if (!props)
+            throw `Parameter props undefined`;
+        const parameter = new ssm.StringParameter(scope, `${id}`, {
+            parameterName: `${props.parameterName}-${scope.props.stage}`,
+            description: `${props.description} - ${scope.props.stage} stage`,
+            stringValue: props.stringValue,
+        });
+        utils.createCfnOutput(`${id}-parameterArn`, scope, parameter.parameterArn);
+        utils.createCfnOutput(`${id}-parameterName`, scope, parameter.parameterName);
+        return parameter;
+    }
+    /**
+     * Method to read a string parameter from the parameters store
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {string} parameterName parameter name to lookup
+     */
+    readStringParameter(id, scope, parameterName) {
+        if (!parameterName || parameterName == '')
+            throw 'Invalid parameter name';
+        return ssm.StringParameter.fromStringParameterName(scope, `${id}`, parameterName).stringValue;
+    }
+    /**
+     * Method to read a string parameter from the parameters store in a given region
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {string} parameterName parameter name to lookup
+     * @param {string} region region name to lookup parameter
+     */
+    readStringParameterFromRegion(id, scope, parameterName, region) {
+        if (!parameterName || parameterName == '')
+            throw 'Invalid parameter name';
+        if (!region || region == '')
+            throw 'Invalid region';
+        return new SSMParameterReader(scope, `${id}`, {
+            parameterName: parameterName,
+            region: region,
+        }).getParameterValue();
+    }
+}
+exports.SsmManager = SsmManager;
+/**
+ * @category cdk-utils.ssm-manager
+ * @subcategory Construct
+ * @classdesc Provides utilities to read same/cross region SSM parameters
+ */
+class SSMParameterReader extends cr.AwsCustomResource {
+    constructor(scope, name, props) {
+        const { parameterName, region } = props;
+        const ssmAwsSdkCall = {
+            service: 'SSM',
+            action: 'getParameter',
+            parameters: {
+                Name: `${parameterName}-${scope.props.stage}`,
+            },
+            region,
+            physicalResourceId: cr.PhysicalResourceId.of(Date.now().toString()),
+        };
+        super(scope, name, {
+            onUpdate: ssmAwsSdkCall,
+            policy: cr.AwsCustomResourcePolicy.fromSdkCalls({ resources: cr.AwsCustomResourcePolicy.ANY_RESOURCE }),
+        });
+    }
+    /**
+     *
+     */
+    getParameterValue() {
+        return this.getResponseField('Parameter.Value');
+    }
+}
+exports.SSMParameterReader = SSMParameterReader;
+//# sourceMappingURL=ssm-manager.js.map

package/dist/src/lib/manager/aws/ssm-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssm-manager.js","sourceRoot":"","sources":["../../../../../src/lib/manager/aws/ssm-manager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,yDAA0C;AAC1C,iEAAkD;AAGlD,mDAAoC;AAEpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,UAAU;IACrB;;;;;OAKG;IACI,uBAAuB,CAAC,EAAU,EAAE,KAA6B,EAAE,KAA+B;QACvG,IAAI,CAAC,KAAK;YAAE,MAAM,2BAA2B,CAAA;QAE7C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;YACxD,aAAa,EAAE,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;YAC5D,WAAW,EAAE,GAAG,KAAK,CAAC,WAAW,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ;YAChE,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC,CAAA;QAEF,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,CAAC,YAAY,CAAC,CAAA;QAC1E,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,CAAC,aAAa,CAAC,CAAA;QAE5E,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;;;OAKG;IACI,mBAAmB,CAAC,EAAU,EAAE,KAA6B,EAAE,aAAqB;QACzF,IAAI,CAAC,aAAa,IAAI,aAAa,IAAI,EAAE;YAAE,MAAM,wBAAwB,CAAA;QAEzE,OAAO,GAAG,CAAC,eAAe,CAAC,uBAAuB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC,WAAW,CAAA;IAC/F,CAAC;IAED;;;;;;OAMG;IACI,6BAA6B,CAClC,EAAU,EACV,KAA6B,EAC7B,aAAqB,EACrB,MAAc;QAEd,IAAI,CAAC,aAAa,IAAI,aAAa,IAAI,EAAE;YAAE,MAAM,wBAAwB,CAAA;QACzE,IAAI,CAAC,MAAM,IAAI,MAAM,IAAI,EAAE;YAAE,MAAM,gBAAgB,CAAA;QAEnD,OAAO,IAAI,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;YAC5C,aAAa,EAAE,aAAa;YAC5B,MAAM,EAAE,MAAM;SACf,CAAC,CAAC,iBAAiB,EAAE,CAAA;IACxB,CAAC;CACF;AAvDD,gCAuDC;AAED;;;;GAIG;AACH,MAAa,kBAAmB,SAAQ,EAAE,CAAC,iBAAiB;IAC1D,YAAY,KAA6B,EAAE,IAAY,EAAE,KAAoC;QAC3F,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;QAEvC,MAAM,aAAa,GAAkB;YACnC,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,cAAc;YACtB,UAAU,EAAE;gBACV,IAAI,EAAE,GAAG,aAAa,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;aAC9C;YACD,MAAM;YACN,kBAAkB,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;SACpE,CAAA;QAED,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;YACjB,QAAQ,EAAE,aAAa;YACvB,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,uBAAuB,CAAC,YAAY,EAAE,CAAC;SACxG,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,CAAA;IACjD,CAAC;CACF;AA1BD,gDA0BC"}

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

@@ -0,0 +1,46 @@
+import * as cdk from 'aws-cdk-lib';
+import * as ec2 from 'aws-cdk-lib/aws-ec2';
+import * as common from '../../common';
+/**
+ * @category cdk-utils.vpc-manager
+ * @subcategory Construct
+ * @classdesc Provides operations on AWS VPC.
+ * - 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.vpcManager.createVpc('MyVPC', this)
+ *   }
+ * }
+ *
+ * @see [CDK VPC Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.@aws-cdk_aws-ec2.Vpc.html}
+ */
+export declare class VpcManager {
+    /**
+     * @summary Method to create a new vpc
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {ec2.VpcProps} props
+     */
+    createVpc(id: string, scope: common.CommonConstruct, props: ec2.VpcProps): cdk.aws_ec2.Vpc;
+    /**
+     * @summary Method to create a common vpc
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {ec2.VpcProps} props
+     * @param {string?} vpcIdentifier optional identifier for VPC
+     */
+    createCommonVpc(scope: common.CommonConstruct, props: ec2.VpcProps, vpcIdentifier?: string): cdk.aws_ec2.Vpc;
+    /**
+     * @summary Method to retrieve a common vpc
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {string?} vpcIdentifier optional identifier for VPC
+     */
+    retrieveCommonVpc(id: string, scope: common.CommonConstruct, vpcIdentifier?: string): cdk.aws_ec2.IVpc;
+}
+//# sourceMappingURL=vpc-manager.d.ts.map

package/dist/src/lib/manager/aws/vpc-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vpc-manager.d.ts","sourceRoot":"","sources":["../../../../../src/lib/manager/aws/vpc-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,aAAa,CAAA;AAClC,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAA;AAC1C,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AAUtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,UAAU;IACrB;;;;;OAKG;IACI,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ;IAyB/E;;;;;OAKG;IACI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,MAAM;IAOjG;;;;;OAKG;IACI,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,EAAE,MAAM;CAG3F"}

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

@@ -0,0 +1,95 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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.VpcManager = void 0;
+const cdk = __importStar(require("aws-cdk-lib"));
+const ec2 = __importStar(require("aws-cdk-lib/aws-ec2"));
+const utils = __importStar(require("../../utils"));
+/**
+ * @stability stable
+ * @category cdk-utils.vpc-manager
+ * @subcategory Construct
+ */
+const CommonVpcIdentifier = 'CommonVpc';
+/**
+ * @category cdk-utils.vpc-manager
+ * @subcategory Construct
+ * @classdesc Provides operations on AWS VPC.
+ * - 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.vpcManager.createVpc('MyVPC', this)
+ *   }
+ * }
+ *
+ * @see [CDK VPC Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.@aws-cdk_aws-ec2.Vpc.html}
+ */
+class VpcManager {
+    /**
+     * @summary Method to create a new vpc
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {ec2.VpcProps} props
+     */
+    createVpc(id, scope, props) {
+        if (!props)
+            throw 'Vpc props undefined';
+        const vpc = new ec2.Vpc(scope, `${id}`, {
+            maxAzs: props.maxAzs,
+            cidr: props.cidr,
+        });
+        utils.createCfnOutput(`${id}Id`, scope, vpc.vpcId);
+        utils.createCfnOutput(`${id}PublicSubnetIds`, scope, vpc.publicSubnets.map(subnet => subnet.subnetId).toString());
+        utils.createCfnOutput(`${id}PrivateSubnetIds`, scope, vpc.privateSubnets.map(subnet => subnet.subnetId).toString());
+        utils.createCfnOutput(`${id}PublicSubnetRouteTableIds`, scope, vpc.publicSubnets.map(subnet => subnet.routeTable.routeTableId).toString());
+        utils.createCfnOutput(`${id}PrivateSubnetRouteTableIds`, scope, vpc.privateSubnets.map(subnet => subnet.routeTable.routeTableId).toString());
+        utils.createCfnOutput(`${id}AvailabilityZones`, scope, vpc.availabilityZones.toString());
+        return vpc;
+    }
+    /**
+     * @summary Method to create a common vpc
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {ec2.VpcProps} props
+     * @param {string?} vpcIdentifier optional identifier for VPC
+     */
+    createCommonVpc(scope, props, vpcIdentifier) {
+        const vpc = this.createVpc(CommonVpcIdentifier, scope, props);
+        cdk.Tags.of(vpc).add('Name', vpcIdentifier ?? CommonVpcIdentifier);
+        return vpc;
+    }
+    /**
+     * @summary Method to retrieve a common vpc
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {string?} vpcIdentifier optional identifier for VPC
+     */
+    retrieveCommonVpc(id, scope, vpcIdentifier) {
+        return ec2.Vpc.fromLookup(scope, `${id}`, { vpcName: vpcIdentifier ?? CommonVpcIdentifier });
+    }
+}
+exports.VpcManager = VpcManager;
+//# sourceMappingURL=vpc-manager.js.map

package/dist/src/lib/manager/aws/vpc-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vpc-manager.js","sourceRoot":"","sources":["../../../../../src/lib/manager/aws/vpc-manager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,iDAAkC;AAClC,yDAA0C;AAE1C,mDAAoC;AAEpC;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,WAAW,CAAA;AAEvC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,UAAU;IACrB;;;;;OAKG;IACI,SAAS,CAAC,EAAU,EAAE,KAA6B,EAAE,KAAmB;QAC7E,IAAI,CAAC,KAAK;YAAE,MAAM,qBAAqB,CAAA;QACvC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;YACtC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAA;QAEF,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAA;QAClD,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;QACjH,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;QACnH,KAAK,CAAC,eAAe,CACnB,GAAG,EAAE,2BAA2B,EAChC,KAAK,EACL,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAC3E,CAAA;QACD,KAAK,CAAC,eAAe,CACnB,GAAG,EAAE,4BAA4B,EACjC,KAAK,EACL,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAC5E,CAAA;QACD,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,EAAE,GAAG,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAA;QAExF,OAAO,GAAG,CAAA;IACZ,CAAC;IAED;;;;;OAKG;IACI,eAAe,CAAC,KAA6B,EAAE,KAAmB,EAAE,aAAsB;QAC/F,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;QAC7D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,IAAI,mBAAmB,CAAC,CAAA;QAElE,OAAO,GAAG,CAAA;IACZ,CAAC;IAED;;;;;OAKG;IACI,iBAAiB,CAAC,EAAU,EAAE,KAA6B,EAAE,aAAsB;QACxF,OAAO,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,aAAa,IAAI,mBAAmB,EAAE,CAAC,CAAA;IAC9F,CAAC;CACF;AAtDD,gCAsDC"}

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

@@ -0,0 +1,40 @@
+import * as wafv2 from 'aws-cdk-lib/aws-wafv2';
+import * as common from '../../common';
+import * as types from '../../types';
+/**
+ * @stability stable
+ * @category cdk-utils.waf-manager
+ * @subcategory Construct
+ * @classdesc Provides operations on AWS WAF.
+ * - 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.wafManager.createWebAcl('MyWebAcl', this)
+ *   }
+ * }
+ *
+ * @see [CDK WAF Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_waf-readme.html}
+ */
+export declare class WafManager {
+    /**
+     * @summary Method to create an ip set
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {types.WafIPSetProps} props
+     */
+    createIpSet(id: string, scope: common.CommonConstruct, props: types.WafIPSetProps): wafv2.CfnIPSet;
+    /**
+     * @summary Method to create a web acl
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {types.WafWebACLProps} props
+     */
+    createWebAcl(id: string, scope: common.CommonConstruct, props: types.WafWebACLProps): wafv2.CfnWebACL;
+}
+//# sourceMappingURL=waf-manager.d.ts.map

package/dist/src/lib/manager/aws/waf-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waf-manager.d.ts","sourceRoot":"","sources":["../../../../../src/lib/manager/aws/waf-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,uBAAuB,CAAA;AAC9C,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAGpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAU;IACrB;;;;;OAKG;IACI,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,aAAa;IAiBxF;;;;;OAKG;IACI,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,cAAc;CAkB3F"}

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

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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.WafManager = void 0;
+const wafv2 = __importStar(require("aws-cdk-lib/aws-wafv2"));
+const utils = __importStar(require("../../utils"));
+/**
+ * @stability stable
+ * @category cdk-utils.waf-manager
+ * @subcategory Construct
+ * @classdesc Provides operations on AWS WAF.
+ * - 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.wafManager.createWebAcl('MyWebAcl', this)
+ *   }
+ * }
+ *
+ * @see [CDK WAF Module]{@link https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_waf-readme.html}
+ */
+class WafManager {
+    /**
+     * @summary Method to create an ip set
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {types.WafIPSetProps} props
+     */
+    createIpSet(id, scope, props) {
+        if (!props)
+            throw `WAF Ip Set props undefined`;
+        const ipSet = new wafv2.CfnIPSet(scope, `${id}`, {
+            name: scope.isProductionStage() ? props.name : `${props.name}-${scope.props.stage}`,
+            description: `IP Set for ${id} - ${scope.props.stage} stage`,
+            addresses: props.addresses,
+            ipAddressVersion: props.ipAddressVersion,
+            scope: props.scope,
+        });
+        utils.createCfnOutput(`${id}-ipSetId`, scope, ipSet.attrId);
+        utils.createCfnOutput(`${id}-ipSetArn`, scope, ipSet.attrArn);
+        return ipSet;
+    }
+    /**
+     * @summary Method to create a web acl
+     * @param {string} id scoped id of the resource
+     * @param {common.CommonConstruct} scope scope in which this resource is defined
+     * @param {types.WafWebACLProps} props
+     */
+    createWebAcl(id, scope, props) {
+        if (!props)
+            throw `WAF WebACL props undefined`;
+        const webAcl = new wafv2.CfnWebACL(scope, `${id}`, {
+            name: scope.isProductionStage() ? props.name : `${props.name}-${scope.props.stage}`,
+            description: `Web Acl for ${id} - ${scope.props.stage} stage`,
+            defaultAction: props.defaultAction,
+            scope: props.scope,
+            visibilityConfig: props.visibilityConfig,
+            rules: props.rules,
+            tags: [{ key: 'service', value: scope.props.name }],
+        });
+        utils.createCfnOutput(`${id}-webAclId`, scope, webAcl.attrId);
+        utils.createCfnOutput(`${id}-webAclArn`, scope, webAcl.attrArn);
+        return webAcl;
+    }
+}
+exports.WafManager = WafManager;
+//# sourceMappingURL=waf-manager.js.map

package/dist/src/lib/manager/aws/waf-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waf-manager.js","sourceRoot":"","sources":["../../../../../src/lib/manager/aws/waf-manager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,6DAA8C;AAG9C,mDAAoC;AAEpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAa,UAAU;IACrB;;;;;OAKG;IACI,WAAW,CAAC,EAAU,EAAE,KAA6B,EAAE,KAA0B;QACtF,IAAI,CAAC,KAAK;YAAE,MAAM,4BAA4B,CAAA;QAE9C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;YAC/C,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;YACnF,WAAW,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ;YAC5D,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAA;QAEF,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QAC3D,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAE7D,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;;OAKG;IACI,YAAY,CAAC,EAAU,EAAE,KAA6B,EAAE,KAA2B;QACxF,IAAI,CAAC,KAAK;YAAE,MAAM,4BAA4B,CAAA;QAE9C,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;YACjD,IAAI,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;YACnF,WAAW,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ;YAC7D,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SACpD,CAAC,CAAA;QAEF,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7D,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QAE/D,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAhDD,gCAgDC"}

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

@@ -0,0 +1,2 @@
+export * from './aws';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA"}

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

@@ -0,0 +1,14 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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("./aws"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/manager/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,wCAAqB"}