Further README update for getting properties

This includes updates to the serverless types so you can directly pull
out the provider and call methods on it like `getAccountId();`.

README.md

@@ -139,7 +139,6 @@ provider:
   cdkModulePath: ./cdk
   region: 'eu-west-1'
   stackName: '${self:provider.stage}-${self:service}'
-  cfnRole: 'arn:aws:iam::${self:custom.env.aws_account_id}:role/CfnRole'
 
 package:
     exclude:
@@ -289,6 +288,24 @@ After stack deployment, CDK by default prints out stack Outputs. We recommend us
     new cdk.CfnOutput(this, 'HelloApiUrl', { value: hello.url }).overrideLogicalId('HelloApiUrl');
 ```
 
+### Other Properties
+
+Other properties are accessible through the AWS CDK provider. You can get an instance of it with:
+
+``` typescript
+import { AwsCdkProvider } from "serverless-aws-cdk/provider"
+
+// And inside your stack definition...
+const provider = props.serverless.getProvider("aws-cdk") as AwsCdkProvider;
+```
+
+From there, you can call [any method on the class](https://github.com/snap40/serverless-aws-cdk/blob/master/provider/awsCdkProvider.ts). For example:
+
+``` typescript
+const accountId = provider.getAccountId();
+const region = provider.getRegion();
+```
+
 ## Usage
 
 ### Supported Commands

cdk/toolkitStack.ts

@@ -1,9 +1,9 @@
-import Serverless = require("serverless");
+import serverless = require("../types/serverless");
 
 import {Bootstrapper, ToolkitInfo} from "aws-cdk";
 import {AwsCdkDeploy} from "../deploy";
 
-function getToolkitStackName(serverless: Serverless) {
+function getToolkitStackName(serverless: serverless) {
   // DEFAULT_TOOLKIT_STACK_NAME from aws-cdk/deployment-target
   const DEFAULT_TOOLKIT_STACK_NAME = "CDKToolkit";
   return (

compile/awsCdkCompile.ts

@@ -1,5 +1,5 @@
 import BbPromise = require('bluebird');
-import serverless = require('serverless');
+import serverless = require("../types/serverless");
 import { AwsCdkProvider } from '../provider';
 
 import { compile, clean } from '../cdk/compile';

deploy/awsCdkDeploy.ts

@@ -1,5 +1,5 @@
 import BbPromise = require("bluebird");
-import serverless = require("serverless");
+import serverless = require("../types/serverless");
 import { AwsCdkProvider } from "../provider";
 
 import { bootstrapToolkitStack } from "../cdk/toolkitStack";

diff/awsCdkDiff.ts

@@ -1,5 +1,5 @@
 import BbPromise = require('bluebird');
-import serverless = require('serverless');
+import serverless = require("../types/serverless");
 import { AwsCdkProvider } from '../provider';
 
 import { diffStack } from '../cdk/diffStack';

provider/awsCdkProvider.ts

@@ -1,5 +1,5 @@
 import _ = require("lodash");
-import serverless = require("serverless");
+import serverless = require("../types/serverless");
 import {ISDK, SdkProvider, Mode} from "aws-cdk";
 import path = require("path");
 import cxapi = require("@aws-cdk/cx-api");

remove/awsCdkRemove.ts

@@ -1,5 +1,5 @@
 import BbPromise = require('bluebird');
-import serverless = require('serverless');
+import serverless = require("../types/serverless");
 import { AwsCdkProvider } from '../provider';
 
 import { removeStack, dummyArtifactsBeforeRemoveStack } from '../cdk/removeStack';

types/serverless.ts

@@ -0,0 +1,2 @@
+type Serverless = any;
+export = Serverless;