@certenza/aws-cdk-infrastructure-commons 2.0.5 → 2.2.0

package/dist/src/dynamodb.d.ts

@@ -23,11 +23,19 @@ type DynamoDBIndex = {
  * Creates a DynamoDB table
  * @param scope - The scope of the DynamoDB table
  * @param tableName - The name of the DynamoDB table
+ * @param environment - The environment of the DynamoDB table
  * @param keys - The keys of the DynamoDB table
  * @param indexes - The indexes of the DynamoDB table
  * @param options - The options of the DynamoDB table
  * @returns The DynamoDB table
  */
-declare const createDynamoDBTable: (scope: Construct, tableName: string, keys: DynamoDBKeys, indexes: DynamoDBIndex[], options?: Partial<dynamodb.TableProps>) => cdk.aws_dynamodb.Table;
-export { createDynamoDBTable };
+declare const createDynamoDBTable: (scope: Construct, tableName: string, environment: string, keys: DynamoDBKeys, indexes: DynamoDBIndex[], options?: Partial<dynamodb.TableProps>) => cdk.aws_dynamodb.Table;
+/**
+ * Import a DynamoDB table from the infrastructure dynamodb stack
+ * @param scope - The scope of the stack
+ * @param tableName - The name of the table to import
+ * @returns The imported DynamoDB table
+ */
+declare const importDynamoDBTable: (scope: Construct, tableName: string) => cdk.aws_dynamodb.ITable;
+export { createDynamoDBTable, importDynamoDBTable };
 export type { DynamoDBIndex, DynamoDBKeys };

package/dist/src/dynamodb.js

@@ -33,19 +33,20 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDynamoDBTable = void 0;
+exports.importDynamoDBTable = exports.createDynamoDBTable = void 0;
 const cdk = __importStar(require("aws-cdk-lib"));
 const dynamodb = __importStar(require("aws-cdk-lib/aws-dynamodb"));
 /**
  * Creates a DynamoDB table
  * @param scope - The scope of the DynamoDB table
  * @param tableName - The name of the DynamoDB table
+ * @param environment - The environment of the DynamoDB table
  * @param keys - The keys of the DynamoDB table
  * @param indexes - The indexes of the DynamoDB table
  * @param options - The options of the DynamoDB table
  * @returns The DynamoDB table
  */
-const createDynamoDBTable = (scope, tableName, keys, indexes, options = {}) => {
+const createDynamoDBTable = (scope, tableName, environment, keys, indexes, options = {}) => {
     // Create the table props
     let tableProps = {
         tableName,
@@ -54,7 +55,10 @@ const createDynamoDBTable = (scope, tableName, keys, indexes, options = {}) => {
             type: dynamodb.AttributeType.STRING,
         },
         billingMode: dynamodb.BillingMode.PAY_PER_REQUEST, // On-demand
-        removalPolicy: cdk.RemovalPolicy.DESTROY, // For testing; use RETAIN in production
+        removalPolicy: environment === "production"
+            ? cdk.RemovalPolicy.RETAIN
+            : cdk.RemovalPolicy.DESTROY,
+        deletionProtection: environment === "production",
         ...options,
     };
     // If a sort key is provided, add it to the table props
@@ -97,3 +101,17 @@ const createDynamoDBTable = (scope, tableName, keys, indexes, options = {}) => {
     return table;
 };
 exports.createDynamoDBTable = createDynamoDBTable;
+/**
+ * Import a DynamoDB table from the infrastructure dynamodb stack
+ * @param scope - The scope of the stack
+ * @param tableName - The name of the table to import
+ * @returns The imported DynamoDB table
+ */
+const importDynamoDBTable = (scope, tableName) => {
+    return cdk.aws_dynamodb.Table.fromTableAttributes(scope, `Imported${tableName}Table`, {
+        tableName: cdk.Fn.importValue(`CertenzaInfrastructureDynamoDBStack-${tableName}TableName`),
+        tableArn: cdk.Fn.importValue(`CertenzaInfrastructureDynamoDBStack-${tableName}TableArn`),
+        tableStreamArn: cdk.Fn.importValue(`CertenzaInfrastructureDynamoDBStack-${tableName}TableStreamArn`),
+    });
+};
+exports.importDynamoDBTable = importDynamoDBTable;

package/dist/src/lambda.d.ts

@@ -31,5 +31,17 @@ declare const createLambdaFunction: (scope: Construct, functionName: string, env
  * @returns The lambda integration
  */
 declare const createLambdaApiGatewayIntegration: (lambdaFunction: lambda.Function) => cdk.aws_apigateway.LambdaIntegration;
-export { createLambdaFunction, createLambdaApiGatewayIntegration };
+/**
+ * Creates a lambda DynamoDB stream event source
+ * @param table - The table to create the event source for
+ * @returns The lambda DynamoDB stream event source
+ */
+declare const createLambdaDynamoDBStreamEventSource: (table: cdk.aws_dynamodb.Table) => cdk.aws_lambda_event_sources.DynamoEventSource;
+/**
+ * Creates a lambda SQS event source
+ * @param queue - The queue to create the event source for
+ * @returns The lambda SQS event source
+ */
+declare const createLambdaSQSEventSource: (queue: cdk.aws_sqs.Queue) => cdk.aws_lambda_event_sources.SqsEventSource;
+export { createLambdaFunction, createLambdaApiGatewayIntegration, createLambdaDynamoDBStreamEventSource, createLambdaSQSEventSource, };
 export type { CreateLambdaFunctionProps };

package/dist/src/lambda.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createLambdaApiGatewayIntegration = exports.createLambdaFunction = void 0;
+exports.createLambdaSQSEventSource = exports.createLambdaDynamoDBStreamEventSource = exports.createLambdaApiGatewayIntegration = exports.createLambdaFunction = void 0;
 /**
  * Lambda functions and integrations
  */
@@ -119,3 +119,29 @@ const createLambdaApiGatewayIntegration = (lambdaFunction) => {
     });
 };
 exports.createLambdaApiGatewayIntegration = createLambdaApiGatewayIntegration;
+/**
+ * Creates a lambda DynamoDB stream event source
+ * @param table - The table to create the event source for
+ * @returns The lambda DynamoDB stream event source
+ */
+const createLambdaDynamoDBStreamEventSource = (table) => {
+    return new cdk.aws_lambda_event_sources.DynamoEventSource(table, {
+        startingPosition: cdk.aws_lambda.StartingPosition.LATEST,
+        batchSize: 1,
+        retryAttempts: -1, // Retry indefinitely
+        maxRecordAge: cdk.Duration.days(7), // Keep records for 7 days
+    });
+};
+exports.createLambdaDynamoDBStreamEventSource = createLambdaDynamoDBStreamEventSource;
+/**
+ * Creates a lambda SQS event source
+ * @param queue - The queue to create the event source for
+ * @returns The lambda SQS event source
+ */
+const createLambdaSQSEventSource = (queue) => {
+    return new cdk.aws_lambda_event_sources.SqsEventSource(queue, {
+        batchSize: 1,
+        maxConcurrency: 10,
+    });
+};
+exports.createLambdaSQSEventSource = createLambdaSQSEventSource;

package/dist/src/sqs.d.ts

@@ -20,4 +20,15 @@ declare const createSqsQueue: (scope: Construct, id: string, props: Partial<sqs.
  * @returns The SQS API Gateway integration
  */
 declare const createSQSApiGatewayIntegration: (scope: Construct, queue: sqs.Queue) => apigateway.AwsIntegration;
-export { createSqsQueue, createSQSApiGatewayIntegration };
+/**
+ * Creates an EventBridge rule to suscribe an SQS queue to an EventBridge event bus
+ * @param scope - The scope of the construct
+ * @param id - The id of the rule
+ * @param eventBus - The event bus to suscribe to
+ * @param suscriberQueue - The queue to suscribe to the event bus
+ * @param eventBridgeDeadLetterQueue - The dead letter queue for the event bus
+ * @param eventPattern - The event pattern to suscribe to
+ * @returns The event bridge rule
+ */
+declare const createSQSToEventBridgeRule: (scope: Construct, id: string, eventBus: cdk.aws_events.EventBus, suscriberQueue: sqs.Queue, eventBridgeDeadLetterQueue: sqs.Queue, eventPattern: cdk.aws_events.EventPattern) => cdk.aws_events.Rule;
+export { createSqsQueue, createSQSApiGatewayIntegration, createSQSToEventBridgeRule, };

package/dist/src/sqs.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSQSApiGatewayIntegration = exports.createSqsQueue = void 0;
+exports.createSQSToEventBridgeRule = exports.createSQSApiGatewayIntegration = exports.createSqsQueue = void 0;
 /**
  * Library to create SQS queues
  */
@@ -111,3 +111,26 @@ const createSQSApiGatewayIntegration = (scope, queue) => {
     });
 };
 exports.createSQSApiGatewayIntegration = createSQSApiGatewayIntegration;
+/**
+ * Creates an EventBridge rule to suscribe an SQS queue to an EventBridge event bus
+ * @param scope - The scope of the construct
+ * @param id - The id of the rule
+ * @param eventBus - The event bus to suscribe to
+ * @param suscriberQueue - The queue to suscribe to the event bus
+ * @param eventBridgeDeadLetterQueue - The dead letter queue for the event bus
+ * @param eventPattern - The event pattern to suscribe to
+ * @returns The event bridge rule
+ */
+const createSQSToEventBridgeRule = (scope, id, eventBus, suscriberQueue, eventBridgeDeadLetterQueue, eventPattern) => {
+    return new cdk.aws_events.Rule(scope, id, {
+        eventBus: eventBus,
+        eventPattern: eventPattern,
+        targets: [
+            new cdk.aws_events_targets.SqsQueue(suscriberQueue, {
+                retryAttempts: 5,
+                deadLetterQueue: eventBridgeDeadLetterQueue,
+            }),
+        ],
+    });
+};
+exports.createSQSToEventBridgeRule = createSQSToEventBridgeRule;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@certenza/aws-cdk-infrastructure-commons",
-    "version": "2.0.5",
+    "version": "2.2.0",
     "description": "Common infrastructure reusable utilities and resources for Certenza projects",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",