MAPSAPI-2426: Allow stream lambdas to have FilterCriteria defined

changelog.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 8.1.0
+
+- Allow `FilterCriteria` property to be defined for Lambda shortcuts
+
 ## 8.0.0
 
 - Updates `cf.shortcuts.ScheduledLambda` to use EventBridge Scheduler instead of EventBridge Rules to schedule lambda invocations. When using this version your template will have the following changes per scheduled lambda instance,

lib/shortcuts/api.md

@@ -394,6 +394,7 @@ Log Group, a Role, an Alarm on function errors, and the Lambda Function itself.
 | [options.DeadLetterConfig] | <code>Object</code> |  | See [AWS documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-deadletterconfig). |
 | [options.Description] | <code>String</code> | <code>&#x27;${logical name} in the ${stack name} stack&#x27;</code> | See [AWS documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-description). |
 | [options.Environment] | <code>Object</code> |  | See [AWS documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-environment). |
+| [options.FilterCriteria] | <code>Object</code> |  | See [AWS documentation](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html) |
 | [options.FunctionName] | <code>String</code> | <code>&#x27;${stack name}-${logical name}&#x27;</code> | See [AWS documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-functionname). |
 | [options.Handler] | <code>String</code> | <code>&#x27;index.handler&#x27;</code> | See [AWS documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-handler). |
 | [options.KmsKeyArn] | <code>String</code> |  | See [AWS documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html#cfn-lambda-function-kmskeyarn). |

lib/shortcuts/stream-lambda.js

@@ -13,6 +13,7 @@ const Lambda = require('./lambda');
  * @param {Number} [options.MaximumBatchingWindowInSeconds=undefined] - See [AWS documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-maximumbatchingwindowinseconds).
  * @param {Boolean} [options.Enabled=true] - See [AWS documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-enabled).
  * @param {String} [options.StartingPosition='LATEST'] - See [AWS documentation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html#cfn-lambda-eventsourcemapping-startingposition).
+ * @param {Object} [options.FilterCriteria] - See [AWS documentation](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html).
  *
  * @example
  * const cf = require('@mapbox/cloudfriend');
@@ -40,7 +41,8 @@ class StreamLambda extends Lambda {
       BatchSize = 1,
       MaximumBatchingWindowInSeconds,
       Enabled = true,
-      StartingPosition = 'LATEST'
+      StartingPosition = 'LATEST',
+      FilterCriteria = undefined
     } = options;
 
     const required = [EventSourceArn];
@@ -60,6 +62,10 @@ class StreamLambda extends Lambda {
       }
     };
 
+    if (FilterCriteria) {
+      this.Resources[`${this.LogicalName}EventSource`].Properties.FilterCriteria = FilterCriteria;
+    }
+
     const generatedRoleRef = this.Resources[`${this.LogicalName}Role`];
     const streamStatement = {
       Effect: 'Allow',

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapbox/cloudfriend",
-  "version": "8.0.0",
+  "version": "8.1.0-dev",
   "description": "Helper functions for assembling CloudFormation templates in JavaScript",
   "main": "index.js",
   "engines": {