@aws-cdk/aws-iotevents-alpha 2.15.0-alpha.0 → 2.16.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.15.0",
+    "aws-cdk-lib": "^2.16.0",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
@@ -2955,7 +2955,7 @@
   },
   "name": "@aws-cdk/aws-iotevents-alpha",
   "readme": {
-    "markdown": "# AWS::IoTEvents Construct Library\n\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\nAWS IoT Events enables you to monitor your equipment or device fleets for\nfailures or changes in operation, and to trigger actions when such events\noccur.\n\n## Installation\n\nInstall the module:\n\n```console\n$ npm i @aws-cdk/aws-iotevents\n```\n\nImport it into your code:\n\n```ts nofixture\nimport * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n```\n\n## `DetectorModel`\n\nThe following example creates an AWS IoT Events detector model to your stack.\nThe detector model need a reference to at least one AWS IoT Events input.\nAWS IoT Events inputs enable the detector to get MQTT payload values from IoT Core rules.\n\n```ts\nimport * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});\n```\n\nTo grant permissions to put messages in the input,\nyou can use the `grantWrite()` method:\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\nimport * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\ndeclare const grantable: iam.IGrantable;\nconst input = iotevents.Input.fromInputName(this, 'MyInput', 'my_input');\n\ninput.grantWrite(grantable);\n```\n"
+    "markdown": "# AWS::IoTEvents Construct Library\n\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\nAWS IoT Events enables you to monitor your equipment or device fleets for\nfailures or changes in operation, and to trigger actions when such events\noccur.\n\n## Installation\n\nInstall the module:\n\n```console\n$ npm i @aws-cdk/aws-iotevents\n```\n\nImport it into your code:\n\n```ts nofixture\nimport * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n```\n\n## `DetectorModel`\n\nThe following example creates an AWS IoT Events detector model to your stack.\nThe detector model need a reference to at least one AWS IoT Events input.\nAWS IoT Events inputs enable the detector to get MQTT payload values from IoT Core rules.\n\nYou can define built-in actions to use a timer or set a variable, or send data to other AWS resources.\nSee also [@aws-cdk/aws-iotevents-actions](https://docs.aws.amazon.com/cdk/api/v1/docs/aws-iotevents-actions-readme.html) for other actions.\n\n```ts\nimport * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});\n```\n\nTo grant permissions to put messages in the input,\nyou can use the `grantWrite()` method:\n\n```ts\nimport * as iam from 'aws-cdk-lib/aws-iam';\nimport * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\ndeclare const grantable: iam.IGrantable;\nconst input = iotevents.Input.fromInputName(this, 'MyInput', 'my_input');\n\ninput.grantWrite(grantable);\n```\n"
   },
   "repository": {
     "directory": "packages/individual-packages/aws-iotevents",
@@ -2993,6 +2993,82 @@
     }
   },
   "types": {
+    "@aws-cdk/aws-iotevents-alpha.ActionBindOptions": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Options when binding a Action to a detector model.",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as iotevents_alpha from '@aws-cdk/aws-iotevents-alpha';\nimport { aws_iam as iam } from 'aws-cdk-lib';\n\ndeclare const role: iam.Role;\nconst actionBindOptions: iotevents_alpha.ActionBindOptions = {\n  role: role,\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.ActionBindOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/action.ts",
+        "line": 8
+      },
+      "name": "ActionBindOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The IAM role assumed by IoT Events to perform the action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/action.ts",
+            "line": 12
+          },
+          "name": "role",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_iam.IRole"
+          }
+        }
+      ],
+      "symbolId": "lib/action:ActionBindOptions"
+    },
+    "@aws-cdk/aws-iotevents-alpha.ActionConfig": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Properties for a AWS IoT Events action.",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as iotevents_alpha from '@aws-cdk/aws-iotevents-alpha';\nconst actionConfig: iotevents_alpha.ActionConfig = {\n  configuration: {\n    clearTimer: {\n      timerName: 'timerName',\n    },\n    dynamoDb: {\n      hashKeyField: 'hashKeyField',\n      hashKeyValue: 'hashKeyValue',\n      tableName: 'tableName',\n\n      // the properties below are optional\n      hashKeyType: 'hashKeyType',\n      operation: 'operation',\n      payload: {\n        contentExpression: 'contentExpression',\n        type: 'type',\n      },\n      payloadField: 'payloadField',\n      rangeKeyField: 'rangeKeyField',\n      rangeKeyType: 'rangeKeyType',\n      rangeKeyValue: 'rangeKeyValue',\n    },\n    dynamoDBv2: {\n      tableName: 'tableName',\n\n      // the properties below are optional\n      payload: {\n        contentExpression: 'contentExpression',\n        type: 'type',\n      },\n    },\n    firehose: {\n      deliveryStreamName: 'deliveryStreamName',\n\n      // the properties below are optional\n      payload: {\n        contentExpression: 'contentExpression',\n        type: 'type',\n      },\n      separator: 'separator',\n    },\n    iotEvents: {\n      inputName: 'inputName',\n\n      // the properties below are optional\n      payload: {\n        contentExpression: 'contentExpression',\n        type: 'type',\n      },\n    },\n    iotSiteWise: {\n      propertyValue: {\n        value: {\n          booleanValue: 'booleanValue',\n          doubleValue: 'doubleValue',\n          integerValue: 'integerValue',\n          stringValue: 'stringValue',\n        },\n\n        // the properties below are optional\n        quality: 'quality',\n        timestamp: {\n          timeInSeconds: 'timeInSeconds',\n\n          // the properties below are optional\n          offsetInNanos: 'offsetInNanos',\n        },\n      },\n\n      // the properties below are optional\n      assetId: 'assetId',\n      entryId: 'entryId',\n      propertyAlias: 'propertyAlias',\n      propertyId: 'propertyId',\n    },\n    iotTopicPublish: {\n      mqttTopic: 'mqttTopic',\n\n      // the properties below are optional\n      payload: {\n        contentExpression: 'contentExpression',\n        type: 'type',\n      },\n    },\n    lambda: {\n      functionArn: 'functionArn',\n\n      // the properties below are optional\n      payload: {\n        contentExpression: 'contentExpression',\n        type: 'type',\n      },\n    },\n    resetTimer: {\n      timerName: 'timerName',\n    },\n    setTimer: {\n      timerName: 'timerName',\n\n      // the properties below are optional\n      durationExpression: 'durationExpression',\n      seconds: 123,\n    },\n    setVariable: {\n      value: 'value',\n      variableName: 'variableName',\n    },\n    sns: {\n      targetArn: 'targetArn',\n\n      // the properties below are optional\n      payload: {\n        contentExpression: 'contentExpression',\n        type: 'type',\n      },\n    },\n    sqs: {\n      queueUrl: 'queueUrl',\n\n      // the properties below are optional\n      payload: {\n        contentExpression: 'contentExpression',\n        type: 'type',\n      },\n      useBase64: false,\n    },\n  },\n};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.ActionConfig",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/action.ts",
+        "line": 28
+      },
+      "name": "ActionConfig",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The configuration for this action."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/action.ts",
+            "line": 32
+          },
+          "name": "configuration",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_iotevents.CfnDetectorModel.ActionProperty"
+          }
+        }
+      ],
+      "symbolId": "lib/action:ActionConfig"
+    },
     "@aws-cdk/aws-iotevents-alpha.DetectorModel": {
       "assembly": "@aws-cdk/aws-iotevents-alpha",
       "base": "aws-cdk-lib.Resource",
@@ -3000,7 +3076,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
+        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
         "stability": "experimental",
         "summary": "Defines an AWS IoT Events detector model in this stack."
       },
@@ -3109,7 +3185,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
+        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
         "stability": "experimental",
         "summary": "Properties for defining an AWS IoT Events detector model."
       },
@@ -3237,8 +3313,8 @@
       "datatype": true,
       "docs": {
         "stability": "experimental",
-        "summary": "Specifies the actions to be performed when the condition evaluates to TRUE.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as iotevents_alpha from '@aws-cdk/aws-iotevents-alpha';\n\ndeclare const expression: iotevents_alpha.Expression;\nconst event: iotevents_alpha.Event = {\n  eventName: 'eventName',\n\n  // the properties below are optional\n  condition: expression,\n};",
+        "summary": "Specifies the actions to be performed when the condition evaluates to `true`.",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as iotevents_alpha from '@aws-cdk/aws-iotevents-alpha';\n\ndeclare const action: iotevents_alpha.IAction;\ndeclare const expression: iotevents_alpha.Expression;\nconst event: iotevents_alpha.Event = {\n  eventName: 'eventName',\n\n  // the properties below are optional\n  actions: [action],\n  condition: expression,\n};",
         "custom": {
           "exampleMetadata": "fixture=_generated"
         }
@@ -3247,7 +3323,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/event.ts",
-        "line": 6
+        "line": 7
       },
       "name": "Event",
       "properties": [
@@ -3260,24 +3336,47 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/event.ts",
-            "line": 10
+            "line": 11
           },
           "name": "eventName",
           "type": {
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no actions will be performed",
+            "stability": "experimental",
+            "summary": "The actions to be performed."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/event.ts",
+            "line": 25
+          },
+          "name": "actions",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.IAction"
+              },
+              "kind": "array"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
             "default": "- none (the actions are always executed)",
             "stability": "experimental",
-            "summary": "The Boolean expression that, when TRUE, causes the actions to be performed."
+            "summary": "The Boolean expression that, when `true`, causes the actions to be performed."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/event.ts",
-            "line": 17
+            "line": 18
           },
           "name": "condition",
           "optional": true,
@@ -3294,7 +3393,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
+        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
         "stability": "experimental",
         "summary": "Information about the order in which events are evaluated and how actions are executed."
       },
@@ -3330,7 +3429,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
+        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
         "see": "https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-expressions.html",
         "stability": "experimental",
         "summary": "Expression for events in Detector Model state."
@@ -3516,6 +3615,54 @@
       "name": "Expression",
       "symbolId": "lib/expression:Expression"
     },
+    "@aws-cdk/aws-iotevents-alpha.IAction": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "docs": {
+        "stability": "experimental",
+        "summary": "An abstract action for DetectorModel."
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.IAction",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/action.ts",
+        "line": 18
+      },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Returns the AWS IoT Events action specification."
+          },
+          "locationInModule": {
+            "filename": "lib/action.ts",
+            "line": 22
+          },
+          "name": "bind",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "options",
+              "type": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.ActionBindOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-iotevents-alpha.ActionConfig"
+            }
+          }
+        }
+      ],
+      "name": "IAction",
+      "symbolId": "lib/action:IAction"
+    },
     "@aws-cdk/aws-iotevents-alpha.IDetectorModel": {
       "assembly": "@aws-cdk/aws-iotevents-alpha",
       "docs": {
@@ -3689,7 +3836,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
+        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
         "stability": "experimental",
         "summary": "Defines an AWS IoT Events input in this stack."
       },
@@ -3872,7 +4019,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
+        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
         "stability": "experimental",
         "summary": "Properties for defining an AWS IoT Events input."
       },
@@ -3933,7 +4080,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
+        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
         "stability": "experimental",
         "summary": "Defines a state of a detector."
       },
@@ -3944,7 +4091,7 @@
         },
         "locationInModule": {
           "filename": "lib/state.ts",
-          "line": 72
+          "line": 104
         },
         "parameters": [
           {
@@ -3958,18 +4105,18 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/state.ts",
-        "line": 64
+        "line": 96
       },
       "methods": [
         {
           "docs": {
-            "remarks": "The transition event will be triggered if condition is evaluated to TRUE.",
+            "remarks": "The transition event will be triggered if condition is evaluated to `true`.",
             "stability": "experimental",
             "summary": "Add a transition event to the state."
           },
           "locationInModule": {
             "filename": "lib/state.ts",
-            "line": 83
+            "line": 115
           },
           "name": "transitionTo",
           "parameters": [
@@ -4004,7 +4151,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/state.ts",
-            "line": 68
+            "line": 100
           },
           "name": "stateName",
           "type": {
@@ -4021,7 +4168,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
+        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
         "stability": "experimental",
         "summary": "Properties for defining a state of a detector."
       },
@@ -4029,7 +4176,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/state.ts",
-        "line": 46
+        "line": 62
       },
       "name": "StateProps",
       "properties": [
@@ -4042,7 +4189,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/state.ts",
-            "line": 50
+            "line": 66
           },
           "name": "stateName",
           "type": {
@@ -4052,15 +4199,15 @@
         {
           "abstract": true,
           "docs": {
-            "default": "- events on enter will not be set",
-            "remarks": "the conditions of the events are evaluated when the state is entered.\nIf the condition is `TRUE`, the actions of the event are performed.",
+            "default": "- no events will trigger on entering this state",
+            "remarks": "The conditions of the events will be evaluated when entering this state.\nIf the condition of the event evaluates to `true`, the actions of the event will be executed.",
             "stability": "experimental",
             "summary": "Specifies the events on enter."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/state.ts",
-            "line": 58
+            "line": 74
           },
           "name": "onEnter",
           "optional": true,
@@ -4072,6 +4219,54 @@
               "kind": "array"
             }
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no events will trigger on exiting this state",
+            "remarks": "The conditions of the events are evaluated when an exiting this state.\nIf the condition evaluates to `true`, the actions of the event will be executed.",
+            "stability": "experimental",
+            "summary": "Specifies the events on exit."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/state.ts",
+            "line": 90
+          },
+          "name": "onExit",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.Event"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no events will trigger on input in this state",
+            "remarks": "The conditions of the events will be evaluated when any input is received.\nIf the condition of the event evaluates to `true`, the actions of the event will be executed.",
+            "stability": "experimental",
+            "summary": "Specifies the events on input."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/state.ts",
+            "line": 82
+          },
+          "name": "onInput",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.Event"
+              },
+              "kind": "array"
+            }
+          }
         }
       ],
       "symbolId": "lib/state:StateProps"
@@ -4083,7 +4278,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
+        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\nimport * as actions from '@aws-cdk/aws-iotevents-actions-alpha';\nimport * as lambda from 'aws-cdk-lib/aws-lambda';\n\ndeclare const func: lambda.IFunction;\n\nconst input = new iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input', // optional\n  attributeJsonPaths: ['payload.deviceId', 'payload.temperature'],\n});\n\nconst warmState = new iotevents.State({\n  stateName: 'warm',\n  onEnter: [{\n    eventName: 'test-enter-event',\n    condition: iotevents.Expression.currentInput(input),\n    actions: [new actions.LambdaInvokeAction(func)], // optional\n  }],\n  onInput: [{ // optional\n    eventName: 'test-input-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n  onExit: [{ // optional\n    eventName: 'test-exit-event',\n    actions: [new actions.LambdaInvokeAction(func)],\n  }],\n});\nconst coldState = new iotevents.State({\n  stateName: 'cold',\n});\n\n// transit to coldState when temperature is 10\nwarmState.transitionTo(coldState, {\n  eventName: 'to_coldState', // optional property, default by combining the names of the States\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('10'),\n  ),\n  executing: [new actions.LambdaInvokeAction(func)], // optional\n});\n// transit to warmState when temperature is 20\ncoldState.transitionTo(warmState, {\n  when: iotevents.Expression.eq(\n    iotevents.Expression.inputAttribute(input, 'payload.temperature'),\n    iotevents.Expression.fromString('20'),\n  ),\n});\n\nnew iotevents.DetectorModel(this, 'MyDetectorModel', {\n  detectorModelName: 'test-detector-model', // optional\n  description: 'test-detector-model-description', // optional property, default is none\n  evaluationMethod: iotevents.EventEvaluation.SERIAL, // optional property, default is iotevents.EventEvaluation.BATCH\n  detectorKey: 'payload.deviceId', // optional property, default is none and single detector instance will be created and all inputs will be routed to it\n  initialState: warmState,\n});",
         "stability": "experimental",
         "summary": "Properties for options of state transition."
       },
@@ -4091,21 +4286,21 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/state.ts",
-        "line": 8
+        "line": 10
       },
       "name": "TransitionOptions",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "remarks": "When this was evaluated to TRUE, the state transition and the actions are triggered.",
+            "remarks": "When this was evaluated to `true`, the state transition and the actions are triggered.",
             "stability": "experimental",
             "summary": "The condition that is used to determine to cause the state transition and the actions."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "lib/state.ts",
-            "line": 20
+            "line": 22
           },
           "name": "when",
           "type": {
@@ -4122,18 +4317,41 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/state.ts",
-            "line": 14
+            "line": 16
           },
           "name": "eventName",
           "optional": true,
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- no actions will be performed",
+            "stability": "experimental",
+            "summary": "The actions to be performed with the transition."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/state.ts",
+            "line": 29
+          },
+          "name": "executing",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.IAction"
+              },
+              "kind": "array"
+            }
+          }
         }
       ],
       "symbolId": "lib/state:TransitionOptions"
     }
   },
-  "version": "2.15.0-alpha.0",
+  "version": "2.16.0-alpha.0",
   "fingerprint": "**********"
 }