aws · Doug-AWS · Aug 9, 2018 · Aug 9, 2018 · Aug 13, 2018 · Aug 13, 2018
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,13 +1,57 @@
-[@rix0rrr]:      https://github.com/rix0rrr
-[@sam-goodwin]:  https://github.com/sam-goodwin
-[@RomainMuller]: https://github.com/RomainMuller
-[@eladb]:        https://github.com/eladb
-[@skinny85]:     https://github.com/skinny85
-[@moofish32]:    https://github.com/moofish32
-[@mpiroc]:       https://github.com/mpiroc
-[@Doug-AWS]:     https://github.com/Doug-AWS
-[@mindstorms6]:  https://github.com/mindstorms6
-[@Mortifera]:    https://github.com/Mortifera
+[@rix0rrr]:         https://github.com/rix0rrr
+[@sam-goodwin]:     https://github.com/sam-goodwin
+[@RomainMuller]:    https://github.com/RomainMuller
+[@eladb]:           https://github.com/eladb
+[@skinny85]:        https://github.com/skinny85
+[@moofish32]:       https://github.com/moofish32
+[@mpiroc]:          https://github.com/mpiroc
+[@Doug-AWS]:        https://github.com/Doug-AWS
+[@mindstorms6]:     https://github.com/mindstorms6
+[@Mortifera]:       https://github.com/Mortifera
+[@maciejwalkowiak]: https://github.com/maciejwalkowiak
+
+## 0.8.2 - 2018-08-15
+
+### Features
+
+* __@aws-cdk/cdk__: Tokens can now be transparently embedded into strings and encoded into JSON without losing their
+  semantics. This makes it possible to treat late-bound (deploy-time) values as if they were regular strings ([@rix0rrr]
+  in [#518](https://github.com/awslabs/aws-cdk/pull/518)).
+* __@aws-cdk/aws-s3__: add support for bucket notifications to Lambda, SNS, and SQS targets ([@eladb] in
+  [#201](https://github.com/awslabs/aws-cdk/pull/201), [#560](https://github.com/awslabs/aws-cdk/pull/560),
+  [#561](https://github.com/awslabs/aws-cdk/pull/561), [#564](https://github.com/awslabs/aws-cdk/pull/564))
+* __@aws-cdk/cdk__: non-alphanumeric characters can now be used as construct identifiers ([@eladb] in
+  [#556](https://github.com/awslabs/aws-cdk/pull/556))
+* __@aws-cdk/aws-iam__: add support for `maxSessionDuration` for Roles ([@eladb] in
+  [#545](https://github.com/awslabs/aws-cdk/pull/545)).
+
+### Changes
+
+* __@aws-cdk/aws-lambda__ (_**BREAKING**_): most classes renamed to be shorter and more in line with official service
+  naming (`Lambda` renamed to `Function` or ommitted) ([@eladb] in [#550](https://github.com/awslabs/aws-cdk/pull/550))
+* __@aws-cdk/aws-codepipeline__ (_**BREAKING**_): move all CodePipeline actions from `@aws-cdk/aws-xxx-codepipeline` packages
+  into the regular `@aws-cdk/aws-xxx` service packages ([@skinny85] in [#459](https://github.com/awslabs/aws-cdk/pull/459)).
+* __@aws-cdk/aws-custom-resources__ (_**BREAKING**_): package was removed, and the Custom Resource construct added to
+  the __@aws-cdk/aws-cloudformation__ package ([@rix0rrr] in [#513](https://github.com/awslabs/aws-cdk/pull/513))
+
+### Fixes
+
+* __@aws-cdk/aws-lambda__: Lambdas that are triggered by CloudWatch Events now show up in the console, and can only be
+  triggered the indicated Event Rule. _**BREAKING**_ for middleware writers (as this introduces an API change), but
+  transparent to regular consumers ([@eladb] in [#558](https://github.com/awslabs/aws-cdk/pull/558))
+* __@aws-cdk/aws-codecommit__: fix a bug where `pollForSourceChanges` could not be set to `false` ([@maciejwalkowiak] in
+  [#534](https://github.com/awslabs/aws-cdk/pull/534))
+* __aws-cdk__: don't fail if the `~/.aws/credentials` file is missing ([@RomainMuller] in
+  [#541](https://github.com/awslabs/aws-cdk/pull/541))
+* __@aws-cdk/aws-cloudformation__: fix a bug in the CodePipeline actions to correctly support TemplateConfiguration
+  ([@mindstorms6] in [#571](https://github.com/awslabs/aws-cdk/pull/571)).
+* __@aws-cdk/aws-cloudformation__: fix a bug in the CodePipeline actions to correctly support ParameterOverrides
+  ([@mindstorms6] in [#574](https://github.com/awslabs/aws-cdk/pull/574)).
+
+### Known Issues
+
+* `cdk init` will try to init a `git` repository and fail if no global `user.name` and `user.email` have been
+  configured.
 
 ## 0.8.1 - 2018-08-08
 

diff --git a/README.md b/README.md
@@ -45,7 +45,7 @@ on AWS.
 * For a detailed walkthrough, see [Getting Started] in the AWS CDK [User Guide]
 * See [Manual Installation](./MANUAL_INSTALLATION.md) for installing the CDK from a signed .zip file
 
-Install the [AWS CDK Toolkit] from npm (requires [Node.js ≥ 8.11.x](https://nodejs.org/en/download)):
+Install the [AWS CDK Toolkit] or update your installed version of the |cdk| to the latest version from npm (requires [Node.js ≥ 8.11.x](https://nodejs.org/en/download)):
 
 ```bash
 $ npm i -g aws-cdk

diff --git a/docs/src/aws-construct-lib.rst b/docs/src/aws-construct-lib.rst
@@ -31,7 +31,7 @@ Least-Privilege IAM policies
 
 IAM policies are automatically defined based on intent. For example, when
 subscribing an AWS SNS :py:class:`Topic <@aws-cdk/aws-sns.Topic>` to a AWS Lambda
-:py:class:`Function <@aws-cdk/aws-lambda.Lambda>`, the function's IAM permission
+:py:class:`Function <@aws-cdk/aws-lambda.Function>`, the function's IAM permission
 policy will automatically be modified to allow the specific topic to invoke the
 function.
 
@@ -76,7 +76,7 @@ Many AWS resources emit AWS CloudWatch metrics as part of their normal operation
 be used to setup :py:mod:`Alarms <@aws-cdk/aws-cloudwatch.Alarm>` or included in :py:mod:`Dashboards <@aws-cdk/aws-cloudwatch.Dashboard>`.
 
 :py:mod:`Metric <@aws-cdk/aws-cloudwatch.Metric>` objects for AWS Constructs can be obtained
-via ``metricXxx()`` methods. For example, the :py:meth:`metricDuration() <@aws-cdk/aws-lambda.LambdaRef.metricDuration>`
+via ``metricXxx()`` methods. For example, the :py:meth:`metricDuration() <@aws-cdk/aws-lambda.FunctionRef.metricDuration>`
 method reports the execution time of an AWS Lambda function.
 
 For more information see the :doc:`refs/_aws-cdk_aws-cloudwatch` documentation.

diff --git a/docs/src/cloudformation.rst b/docs/src/cloudformation.rst
@@ -28,7 +28,7 @@ other resources, depending on what bucket APIs are used).
 
 .. important::
 
-  Generally, when building CDK apps, you shouldn't need to interact
+  Generally, when building CDK apps, you shouldn't need to interact with
   CloudFormation directly. However, there might be advanced use cases and
   migration scenarios where this might be required. We are also aware that
   there might be gaps in capabilities in the AWS Construct Library over time.

diff --git a/docs/src/getting-started.rst b/docs/src/getting-started.rst
@@ -26,7 +26,9 @@ Prerequisites
 command-line toolkit and language bindings.
 
 `AWS CLI <https://aws.amazon.com/cli>`_ - recommended in general, and can be
-used to setup the :ref:`credentials <credentials>` for your AWS account.
+used to setup the credentials and region for your AWS account,
+which must be specified to use the toolkit.
+See :ref:`credentials <credentials>` for information on using the AWS CLI to set your credentials.
 
 Install the command-line toolkit
 --------------------------------

diff --git a/docs/src/index.rst b/docs/src/index.rst
@@ -26,6 +26,13 @@ Developers can use one of the supported programming languages to define reusable
 cloud components called :doc:`constructs`, which are composed together into
 :doc:`stacks` and :doc:`apps`.
 
+.. note::
+    Unless otherwise indicated,
+    the code examples in this guide are in TypeScript.
+
+    To aid you in porting a TypeScript example to a supported programming language,
+    take a look at the example code for your language in the :doc:`Reference section <reference>`.
+
 The :ref:`AWS CDK Toolkit <toolkit>` is a command-line tool for interacting with CDK
 apps. It allows developers to synthesize artifacts such as AWS CloudFormation
 Templates, deploy stacks to development AWS accounts and "diff" against a

diff --git a/examples/cdk-examples-java/package.json b/examples/cdk-examples-java/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cdk-examples-java",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "CDK examples in Java",
   "private": true,
   "repository": {
@@ -22,7 +22,7 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "aws-cdk": "^0.8.1",
-    "pkgtools": "^0.8.1"
+    "aws-cdk": "^0.8.2",
+    "pkgtools": "^0.8.2"
   }
 }
diff --git a/examples/cdk-examples-typescript/chat-app/index.ts b/examples/cdk-examples-typescript/chat-app/index.ts
@@ -76,11 +76,11 @@ interface ChatAppFuncProps {
 /*
  * Extend Function as all of the Chat app functions have these common props.
  */
-class ChatAppFunction extends lambda.Lambda {
+class ChatAppFunction extends lambda.Function {
     constructor(parent: cdk.Construct, name: string, props: ChatAppFuncProps) {
         super(parent, name, {
-            code: new lambda.LambdaS3Code(props.bucket, props.zipFile),
-            runtime: lambda.LambdaRuntime.NodeJS610,
+            code: new lambda.S3Code(props.bucket, props.zipFile),
+            runtime: lambda.Runtime.NodeJS610,
             handler: 'index.handler'
         });
     }

diff --git a/examples/cdk-examples-typescript/package.json b/examples/cdk-examples-typescript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cdk-examples-typescript",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "A bunch of CDK examples",
   "private": true,
   "scripts": {
@@ -18,24 +18,24 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "aws-cdk": "^0.8.1",
-    "cdk-build-tools": "^0.8.1",
-    "pkglint": "^0.8.1"
+    "aws-cdk": "^0.8.2",
+    "cdk-build-tools": "^0.8.2",
+    "pkglint": "^0.8.2"
   },
   "dependencies": {
-    "@aws-cdk/aws-cloudformation": "^0.8.1",
-    "@aws-cdk/aws-cognito": "^0.8.1",
-    "@aws-cdk/aws-dynamodb": "^0.8.1",
-    "@aws-cdk/aws-ec2": "^0.8.1",
-    "@aws-cdk/aws-iam": "^0.8.1",
-    "@aws-cdk/aws-lambda": "^0.8.1",
-    "@aws-cdk/aws-neptune": "^0.8.1",
-    "@aws-cdk/aws-rds": "^0.8.1",
-    "@aws-cdk/aws-s3": "^0.8.1",
-    "@aws-cdk/aws-sns": "^0.8.1",
-    "@aws-cdk/aws-sqs": "^0.8.1",
-    "@aws-cdk/cdk": "^0.8.1",
-    "@aws-cdk/runtime-values": "^0.8.1"
+    "@aws-cdk/aws-cloudformation": "^0.8.2",
+    "@aws-cdk/aws-cognito": "^0.8.2",
+    "@aws-cdk/aws-dynamodb": "^0.8.2",
+    "@aws-cdk/aws-ec2": "^0.8.2",
+    "@aws-cdk/aws-iam": "^0.8.2",
+    "@aws-cdk/aws-lambda": "^0.8.2",
+    "@aws-cdk/aws-neptune": "^0.8.2",
+    "@aws-cdk/aws-rds": "^0.8.2",
+    "@aws-cdk/aws-s3": "^0.8.2",
+    "@aws-cdk/aws-sns": "^0.8.2",
+    "@aws-cdk/aws-sqs": "^0.8.2",
+    "@aws-cdk/cdk": "^0.8.2",
+    "@aws-cdk/runtime-values": "^0.8.2"
   },
   "repository": {
     "url": "https://github.com/awslabs/aws-cdk.git",

diff --git a/lerna.json b/lerna.json
@@ -7,5 +7,5 @@
     "examples/*"
   ],
   "rejectCycles": "true",
-  "version": "0.8.1"
+  "version": "0.8.2"
 }
diff --git a/packages/@aws-cdk/applet-js/package.json b/packages/@aws-cdk/applet-js/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@aws-cdk/applet-js",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Javascript CDK applet host program",
   "main": "bin/cdk-applet-js.js",
   "types": "bin/cdk-applet-js.d.ts",
@@ -23,11 +23,11 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@types/yamljs": "^0.2.0",
-    "cdk-build-tools": "^0.8.1",
-    "pkglint": "^0.8.1"
+    "cdk-build-tools": "^0.8.2",
+    "pkglint": "^0.8.2"
   },
   "dependencies": {
-    "@aws-cdk/cdk": "^0.8.1",
+    "@aws-cdk/cdk": "^0.8.2",
     "source-map-support": "^0.5.6",
     "yamljs": "^0.2.0"
   },

diff --git a/packages/@aws-cdk/assert/package.json b/packages/@aws-cdk/assert/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@aws-cdk/assert",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "An assertion library for use with CDK Apps",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -23,13 +23,13 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "cdk-build-tools": "^0.8.1",
-    "pkglint": "^0.8.1"
+    "cdk-build-tools": "^0.8.2",
+    "pkglint": "^0.8.2"
   },
   "dependencies": {
-    "@aws-cdk/cdk": "^0.8.1",
-    "@aws-cdk/cloudformation-diff": "^0.8.1",
-    "@aws-cdk/cx-api": "^0.8.1",
+    "@aws-cdk/cdk": "^0.8.2",
+    "@aws-cdk/cloudformation-diff": "^0.8.2",
+    "@aws-cdk/cx-api": "^0.8.2",
     "source-map-support": "^0.5.6"
   },
   "repository": {

diff --git a/packages/@aws-cdk/assets/package.json b/packages/@aws-cdk/assets/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@aws-cdk/assets",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Integration of CDK apps with local assets",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -43,17 +43,17 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@aws-cdk/assert": "^0.8.1",
-    "aws-cdk": "^0.8.1",
-    "cdk-build-tools": "^0.8.1",
-    "cdk-integ-tools": "^0.8.1",
-    "pkglint": "^0.8.1"
+    "@aws-cdk/assert": "^0.8.2",
+    "aws-cdk": "^0.8.2",
+    "cdk-build-tools": "^0.8.2",
+    "cdk-integ-tools": "^0.8.2",
+    "pkglint": "^0.8.2"
   },
   "dependencies": {
-    "@aws-cdk/aws-iam": "^0.8.1",
-    "@aws-cdk/aws-s3": "^0.8.1",
-    "@aws-cdk/cdk": "^0.8.1",
-    "@aws-cdk/cx-api": "^0.8.1"
+    "@aws-cdk/aws-iam": "^0.8.2",
+    "@aws-cdk/aws-s3": "^0.8.2",
+    "@aws-cdk/cdk": "^0.8.2",
+    "@aws-cdk/cx-api": "^0.8.2"
   },
   "homepage": "https://github.com/awslabs/aws-cdk"
 }
diff --git a/packages/@aws-cdk/aws-apigateway/package.json b/packages/@aws-cdk/aws-apigateway/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@aws-cdk/aws-apigateway",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "The CDK Construct Library for AWS::ApiGateway",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -46,13 +46,13 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@aws-cdk/assert": "^0.8.1",
-    "cdk-build-tools": "^0.8.1",
-    "cfn2ts": "^0.8.1",
-    "pkglint": "^0.8.1"
+    "@aws-cdk/assert": "^0.8.2",
+    "cdk-build-tools": "^0.8.2",
+    "cfn2ts": "^0.8.2",
+    "pkglint": "^0.8.2"
   },
   "dependencies": {
-    "@aws-cdk/cdk": "^0.8.1"
+    "@aws-cdk/cdk": "^0.8.2"
   },
   "homepage": "https://github.com/awslabs/aws-cdk"
 }
diff --git a/packages/@aws-cdk/aws-applicationautoscaling/package.json b/packages/@aws-cdk/aws-applicationautoscaling/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@aws-cdk/aws-applicationautoscaling",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "The CDK Construct Library for AWS::ApplicationAutoScaling",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -46,13 +46,13 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@aws-cdk/assert": "^0.8.1",
-    "cdk-build-tools": "^0.8.1",
-    "cfn2ts": "^0.8.1",
-    "pkglint": "^0.8.1"
+    "@aws-cdk/assert": "^0.8.2",
+    "cdk-build-tools": "^0.8.2",
+    "cfn2ts": "^0.8.2",
+    "pkglint": "^0.8.2"
   },
   "dependencies": {
-    "@aws-cdk/cdk": "^0.8.1"
+    "@aws-cdk/cdk": "^0.8.2"
   },
   "homepage": "https://github.com/awslabs/aws-cdk"
 }
diff --git a/packages/@aws-cdk/aws-appsync/package.json b/packages/@aws-cdk/aws-appsync/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@aws-cdk/aws-appsync",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "The CDK Construct Library for AWS::AppSync",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -46,13 +46,13 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@aws-cdk/assert": "^0.8.1",
-    "cdk-build-tools": "^0.8.1",
-    "cfn2ts": "^0.8.1",
-    "pkglint": "^0.8.1"
+    "@aws-cdk/assert": "^0.8.2",
+    "cdk-build-tools": "^0.8.2",
+    "cfn2ts": "^0.8.2",
+    "pkglint": "^0.8.2"
   },
   "dependencies": {
-    "@aws-cdk/cdk": "^0.8.1"
+    "@aws-cdk/cdk": "^0.8.2"
   },
   "homepage": "https://github.com/awslabs/aws-cdk"
 }