Bundles TypeScript definition files and adds generation of d.ts files for service models. Closes #994

Author: chrisradek

.changes/next-release/feature-TypeScript-f7d30644.json

@@ -0,0 +1,5 @@
+{
+  "type": "feature",
+  "category": "TypeScript",
+  "description": "Adds typescript definition files to the SDK."
+}

.npmignore

@@ -15,4 +15,5 @@ features
 Rakefile
 test
 tasks
+ts
 vendor

README.md

@@ -60,6 +60,53 @@ You can find a getting started guide at:
 
 http://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide
 
+## Usage with TypeScript
+The AWS SDK for JavaScript bundles TypeScript definition files for use in TypeScript projects and to support tools that can read `.d.ts` files.
+Our goal is to keep these TypeScript definition files updated with each release for any public api.
+
+### Pre-requisites
+Before you can begin using these TypeScript definitions with your project, you need to make sure your project meets a few of these requirements:
+ * Use TypeScript v2.x
+ * Includes the TypeScript definitions for node. You can use npm to install this by typing the following into a terminal window:
+  ```sh
+    npm install --save-dev @types/node
+  ```
+ * Your `tsconfig.json` or `jsconfig.json` includes `'dom'` and `'es2015.promise'` under `compilerOptions.lib`.
+ See [tsconfig.json](./ts/tsconfig.json) for an example.
+
+### In the Browser
+To use the TypeScript definition files with the global `AWS` object in a front-end project, add the following line to the top of your JavaScript file:
+```javascript
+/// <reference types="aws-sdk" />
+```
+This will provide support for the global `AWS` object.
+
+### In Node.js
+To use the TypeScript definition files within a Node.js project, simply import `aws-sdk` as you normally would.
+In a TypeScript file:
+```javascript
+// import entire SDK
+import AWS = require('aws-sdk');
+// import AWS object without services
+import AWS = require('aws-sdk/global');
+// import individual service
+import S3 = require('aws-sdk/clients/s3');
+```
+In a JavaScript file:
+```javascript
+// import entire SDK
+var AWS = require('aws-sdk');
+// import AWS object without services
+var AWS = require('aws-sdk/global');
+// import individual service
+var S3 = require('aws-sdk/clients/s3');
+```
+
+### Known Limitations
+There are a few known limitations with the bundled TypeScript definitions at this time:
+ * Service client typings reflect the latest `apiVersion`, regardless of which `apiVersion` is specified when creating a client.
+ * Service-bound parameters use the `any` type.
+
 ## Supported Services
 
 <p class="note"><strong>Note</strong>:

clients/acm.d.ts

@@ -0,0 +1,76 @@
+export import ACM = require('./acm');
+export import APIGateway = require('./apigateway');
+export import ApplicationAutoScaling = require('./applicationautoscaling');
+export import AutoScaling = require('./autoscaling');
+export import Budgets = require('./budgets');
+export import CloudFormation = require('./cloudformation');
+export import CloudFront = require('./cloudfront');
+export import CloudHSM = require('./cloudhsm');
+export import CloudSearch = require('./cloudsearch');
+export import CloudSearchDomain = require('./cloudsearchdomain');
+export import CloudTrail = require('./cloudtrail');
+export import CloudWatch = require('./cloudwatch');
+export import CloudWatchEvents = require('./cloudwatchevents');
+export import CloudWatchLogs = require('./cloudwatchlogs');
+export import CodeCommit = require('./codecommit');
+export import CodeDeploy = require('./codedeploy');
+export import CodePipeline = require('./codepipeline');
+export import CognitoIdentity = require('./cognitoidentity');
+export import CognitoIdentityServiceProvider = require('./cognitoidentityserviceprovider');
+export import CognitoSync = require('./cognitosync');
+export import ConfigService = require('./configservice');
+export import DataPipeline = require('./datapipeline');
+export import DeviceFarm = require('./devicefarm');
+export import DirectConnect = require('./directconnect');
+export import DirectoryService = require('./directoryservice');
+export import Discovery = require('./discovery');
+export import DMS = require('./dms');
+export import DynamoDB = require('./dynamodb');
+export import DynamoDBStreams = require('./dynamodbstreams');
+export import EC2 = require('./ec2');
+export import ECR = require('./ecr');
+export import ECS = require('./ecs');
+export import EFS = require('./efs');
+export import ElastiCache = require('./elasticache');
+export import ElasticBeanstalk = require('./elasticbeanstalk');
+export import ELB = require('./elb');
+export import ELBv2 = require('./elbv2');
+export import EMR = require('./emr');
+export import ES = require('./es');
+export import ElasticTranscoder = require('./elastictranscoder');
+export import Firehose = require('./firehose');
+export import GameLift = require('./gamelift');
+export import Glacier = require('./glacier');
+export import IAM = require('./iam');
+export import ImportExport = require('./importexport');
+export import Inspector = require('./inspector');
+export import Iot = require('./iot');
+export import IotData = require('./iotdata');
+export import Kinesis = require('./kinesis');
+export import KinesisAnalytics = require('./kinesisanalytics');
+export import KMS = require('./kms');
+export import Lambda = require('./lambda');
+export import MachineLearning = require('./machinelearning');
+export import MarketplaceCommerceAnalytics = require('./marketplacecommerceanalytics');
+export import MarketplaceMetering = require('./marketplacemetering');
+export import MobileAnalytics = require('./mobileanalytics');
+export import OpsWorks = require('./opsworks');
+export import RDS = require('./rds');
+export import Redshift = require('./redshift');
+export import Route53 = require('./route53');
+export import Route53Domains = require('./route53domains');
+export import S3 = require('./s3');
+export import ServiceCatalog = require('./servicecatalog');
+export import SES = require('./ses');
+export import SimpleDB = require('./simpledb');
+export import SMS = require('./sms');
+export import Snowball = require('./snowball');
+export import SNS = require('./sns');
+export import SQS = require('./sqs');
+export import SSM = require('./ssm');
+export import StorageGateway = require('./storagegateway');
+export import STS = require('./sts');
+export import Support = require('./support');
+export import SWF = require('./swf');
+export import WAF = require('./waf');
+export import WorkSpaces = require('./workspaces');