@aws-cdk/aws-iotevents-alpha 2.9.0-alpha.0 → 2.10.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.9.0",
+    "aws-cdk-lib": "^2.10.0",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
@@ -2921,12 +2921,15 @@
       "compiledWithDeprecationWarnings": true,
       "pacmak": {
         "hasDefaultInterfaces": true
+      },
+      "rosetta": {
+        "strict": true
       }
     }
   },
   "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## `Input`\n\nAdd an AWS IoT Events input to your stack:\n\n```ts\nimport * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nnew iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input',\n  attributeJsonPaths: ['payload.temperature'],\n});\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\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 onlineState = new iotevents.State({\n  stateName: 'online',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\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: onlineState,\n});\n```\n"
   },
   "repository": {
     "directory": "packages/individual-packages/aws-iotevents",
@@ -2964,6 +2967,568 @@
     }
   },
   "types": {
+    "@aws-cdk/aws-iotevents-alpha.DetectorModel": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "base": "aws-cdk-lib.Resource",
+      "docs": {
+        "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 onlineState = new iotevents.State({\n  stateName: 'online',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\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: onlineState,\n});",
+        "stability": "experimental",
+        "summary": "Defines an AWS IoT Events detector model in this stack."
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.DetectorModel",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "lib/detector-model.ts",
+          "line": 106
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@aws-cdk/aws-iotevents-alpha.DetectorModelProps"
+            }
+          }
+        ]
+      },
+      "interfaces": [
+        "@aws-cdk/aws-iotevents-alpha.IDetectorModel"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "lib/detector-model.ts",
+        "line": 94
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Import an existing detector model."
+          },
+          "locationInModule": {
+            "filename": "lib/detector-model.ts",
+            "line": 98
+          },
+          "name": "fromDetectorModelName",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "detectorModelName",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-iotevents-alpha.IDetectorModel"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "DetectorModel",
+      "properties": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The name of the detector model."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/detector-model.ts",
+            "line": 104
+          },
+          "name": "detectorModelName",
+          "overrides": "@aws-cdk/aws-iotevents-alpha.IDetectorModel",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/detector-model:DetectorModel"
+    },
+    "@aws-cdk/aws-iotevents-alpha.DetectorModelProps": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "datatype": true,
+      "docs": {
+        "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 onlineState = new iotevents.State({\n  stateName: 'online',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\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: onlineState,\n});",
+        "stability": "experimental",
+        "summary": "Properties for defining an AWS IoT Events detector model."
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.DetectorModelProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/detector-model.ts",
+        "line": 38
+      },
+      "name": "DetectorModelProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The state that is entered at the creation of each detector."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/detector-model.ts",
+            "line": 81
+          },
+          "name": "initialState",
+          "type": {
+            "fqn": "@aws-cdk/aws-iotevents-alpha.State"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "none",
+            "stability": "experimental",
+            "summary": "A brief description of the detector model."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/detector-model.ts",
+            "line": 51
+          },
+          "name": "description",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- none (single detector instance will be created and all inputs will be routed to it)",
+            "remarks": "When a device or system sends input, a new\ndetector instance with a unique key value is created. AWS IoT Events can continue to route\ninput to its corresponding detector instance based on this identifying information.\n\nThis parameter uses a JSON-path expression to select the attribute-value pair in the message\npayload that is used for identification. To route the message to the correct detector instance,\nthe device must send a message payload that contains the same attribute-value.",
+            "stability": "experimental",
+            "summary": "The value used to identify a detector instance."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/detector-model.ts",
+            "line": 76
+          },
+          "name": "detectorKey",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- CloudFormation will generate a unique name of the detector model",
+            "stability": "experimental",
+            "summary": "The name of the detector model."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/detector-model.ts",
+            "line": 44
+          },
+          "name": "detectorModelName",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "EventEvaluation.BATCH",
+            "remarks": "When setting to SERIAL, variables are updated and event conditions are evaluated in the order\nthat the events are defined.\nWhen setting to BATCH, variables within a state are updated and events within a state are\nperformed only after all event conditions are evaluated.",
+            "stability": "experimental",
+            "summary": "Information about the order in which events are evaluated and how actions are executed."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/detector-model.ts",
+            "line": 63
+          },
+          "name": "evaluationMethod",
+          "optional": true,
+          "type": {
+            "fqn": "@aws-cdk/aws-iotevents-alpha.EventEvaluation"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- a role will be created with default permissions",
+            "stability": "experimental",
+            "summary": "The role that grants permission to AWS IoT Events to perform its operations."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/detector-model.ts",
+            "line": 88
+          },
+          "name": "role",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_iam.IRole"
+          }
+        }
+      ],
+      "symbolId": "lib/detector-model:DetectorModelProps"
+    },
+    "@aws-cdk/aws-iotevents-alpha.Event": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "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};",
+        "custom": {
+          "exampleMetadata": "fixture=_generated"
+        }
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.Event",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/event.ts",
+        "line": 6
+      },
+      "name": "Event",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The name of the event."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/event.ts",
+            "line": 10
+          },
+          "name": "eventName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "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."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/event.ts",
+            "line": 17
+          },
+          "name": "condition",
+          "optional": true,
+          "type": {
+            "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+          }
+        }
+      ],
+      "symbolId": "lib/event:Event"
+    },
+    "@aws-cdk/aws-iotevents-alpha.EventEvaluation": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "docs": {
+        "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 onlineState = new iotevents.State({\n  stateName: 'online',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\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: onlineState,\n});",
+        "stability": "experimental",
+        "summary": "Information about the order in which events are evaluated and how actions are executed."
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.EventEvaluation",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "lib/detector-model.ts",
+        "line": 22
+      },
+      "members": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "When setting to SERIAL, variables are updated and event conditions are evaluated in the order that the events are defined."
+          },
+          "name": "BATCH"
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "When setting to BATCH, variables within a state are updated and events within a state are performed only after all event conditions are evaluated."
+          },
+          "name": "SERIAL"
+        }
+      ],
+      "name": "EventEvaluation",
+      "symbolId": "lib/detector-model:EventEvaluation"
+    },
+    "@aws-cdk/aws-iotevents-alpha.Expression": {
+      "abstract": true,
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "docs": {
+        "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 onlineState = new iotevents.State({\n  stateName: 'online',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\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: onlineState,\n});",
+        "see": "https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-expressions.html",
+        "stability": "experimental",
+        "summary": "Expression for events in Detector Model state."
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.Expression",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "lib/expression.ts",
+          "line": 44
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "lib/expression.ts",
+        "line": 7
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Create a expression for the AND operator."
+          },
+          "locationInModule": {
+            "filename": "lib/expression.ts",
+            "line": 40
+          },
+          "name": "and",
+          "parameters": [
+            {
+              "name": "left",
+              "type": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+              }
+            },
+            {
+              "name": "right",
+              "type": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "remarks": "It is evaluated to true if the specified input message was received.",
+            "stability": "experimental",
+            "summary": "Create a expression for function `currentInput()`."
+          },
+          "locationInModule": {
+            "filename": "lib/expression.ts",
+            "line": 19
+          },
+          "name": "currentInput",
+          "parameters": [
+            {
+              "name": "input",
+              "type": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.IInput"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Create a expression for the Equal operator."
+          },
+          "locationInModule": {
+            "filename": "lib/expression.ts",
+            "line": 33
+          },
+          "name": "eq",
+          "parameters": [
+            {
+              "name": "left",
+              "type": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+              }
+            },
+            {
+              "name": "right",
+              "type": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Create a expression from the given string."
+          },
+          "locationInModule": {
+            "filename": "lib/expression.ts",
+            "line": 11
+          },
+          "name": "fromString",
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Create a expression for get an input attribute as `$input.TemperatureInput.temperatures[2]`."
+          },
+          "locationInModule": {
+            "filename": "lib/expression.ts",
+            "line": 26
+          },
+          "name": "inputAttribute",
+          "parameters": [
+            {
+              "name": "input",
+              "type": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.IInput"
+              }
+            },
+            {
+              "name": "path",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-iotevents-alpha.Expression"
+            }
+          },
+          "static": true
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "this is called to evaluate the expression."
+          },
+          "locationInModule": {
+            "filename": "lib/expression.ts",
+            "line": 50
+          },
+          "name": "evaluate",
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        }
+      ],
+      "name": "Expression",
+      "symbolId": "lib/expression:Expression"
+    },
+    "@aws-cdk/aws-iotevents-alpha.IDetectorModel": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Represents an AWS IoT Events detector model."
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.IDetectorModel",
+      "interfaces": [
+        "aws-cdk-lib.IResource"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/detector-model.ts",
+        "line": 10
+      },
+      "name": "IDetectorModel",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "attribute": "true"
+            },
+            "stability": "experimental",
+            "summary": "The name of the detector model."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/detector-model.ts",
+            "line": 16
+          },
+          "name": "detectorModelName",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/detector-model:IDetectorModel"
+    },
     "@aws-cdk/aws-iotevents-alpha.IInput": {
       "assembly": "@aws-cdk/aws-iotevents-alpha",
       "docs": {
@@ -3010,7 +3575,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nnew iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input',\n  attributeJsonPaths: ['payload.temperature'],\n});",
+        "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 onlineState = new iotevents.State({\n  stateName: 'online',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\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: onlineState,\n});",
         "stability": "experimental",
         "summary": "Defines an AWS IoT Events input in this stack."
       },
@@ -3119,7 +3684,7 @@
         "custom": {
           "exampleMetadata": "infused"
         },
-        "example": "import * as iotevents from '@aws-cdk/aws-iotevents-alpha';\n\nnew iotevents.Input(this, 'MyInput', {\n  inputName: 'my_input',\n  attributeJsonPaths: ['payload.temperature'],\n});",
+        "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 onlineState = new iotevents.State({\n  stateName: 'online',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\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: onlineState,\n});",
         "stability": "experimental",
         "summary": "Properties for defining an AWS IoT Events input."
       },
@@ -3173,8 +3738,123 @@
         }
       ],
       "symbolId": "lib/input:InputProps"
+    },
+    "@aws-cdk/aws-iotevents-alpha.State": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "docs": {
+        "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 onlineState = new iotevents.State({\n  stateName: 'online',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\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: onlineState,\n});",
+        "stability": "experimental",
+        "summary": "Defines a state of a detector."
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.State",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "lib/state.ts",
+          "line": 31
+        },
+        "parameters": [
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@aws-cdk/aws-iotevents-alpha.StateProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "lib/state.ts",
+        "line": 25
+      },
+      "name": "State",
+      "properties": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The name of the state."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/state.ts",
+            "line": 29
+          },
+          "name": "stateName",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/state:State"
+    },
+    "@aws-cdk/aws-iotevents-alpha.StateProps": {
+      "assembly": "@aws-cdk/aws-iotevents-alpha",
+      "datatype": true,
+      "docs": {
+        "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 onlineState = new iotevents.State({\n  stateName: 'online',\n  onEnter: [{\n    eventName: 'test-event',\n    condition: iotevents.Expression.currentInput(input),\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: onlineState,\n});",
+        "stability": "experimental",
+        "summary": "Properties for defining a state of a detector."
+      },
+      "fqn": "@aws-cdk/aws-iotevents-alpha.StateProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/state.ts",
+        "line": 7
+      },
+      "name": "StateProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The name of the state."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/state.ts",
+            "line": 11
+          },
+          "name": "stateName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "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.",
+            "stability": "experimental",
+            "summary": "Specifies the events on enter."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/state.ts",
+            "line": 19
+          },
+          "name": "onEnter",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@aws-cdk/aws-iotevents-alpha.Event"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "lib/state:StateProps"
     }
   },
-  "version": "2.9.0-alpha.0",
+  "version": "2.10.0-alpha.0",
   "fingerprint": "**********"
 }