aws-sdk-typescript

Intro

The AWS SDK for Javascript is quite large and evolves fairly quickly. Attempts to manually create typings for it (such as the Definitely Typed one) are incomplete and don't support promises.

This project approaches the challenge by using the information in the source JSON interface and Javascript files to generate the typings. Take a look inside the output/typings folder to see the results for yourself.

Installation

Using Typings

The simplest way to start using the generated typings is to install them directly from github using typings.

1. Make sure you have typings installed:

npm install typings --global

2. Make sure your project is set up to reference your typings typings/index.d.ts file in your tsconfig.json or as a /// reference.

3. Install the latest aws-sdk-typescript from github using:

typings i aws-sdk=github:ingenieux/aws-sdk-typescript#HEAD --save -G

Using Typescript 2.x (experimental)

Typescript 2 allows you to install type declarations with npm, this is how you can install the @djabry fork of aws-sdk-typescript:

1. Make sure you have Typescript 2 installed

   npm install --save-dev typescript@2

2. Install the @djabry fork of aws-sdk-typescript using npm

   npm install --save-dev @djabry/aws-sdk-typescript

3. Modify your tsconfig.json file to include the aws-sdk-typescript entry in the compiler.types section and optionally 'es6' in the compiler.lib for the Promise definition

   {
     "compilerOptions": {
       ...
       "lib": [
         "es6",
         ...
       ],
       ...
       ...
       "types": [
         "@djabry/aws-sdk-typescript/index",
         ...
       ]
     },
     ...
   }