Release: AWS SDK for Node.js v0.9.2-pre.3

Added support for Amazon Simple E-mail Service (AWS.SES). Example usage:

var ses = new AWS.SES({region: 'us-east-1'});
ses.getSendQuota(function(err, data) {
  console.log(err, data);
});

Added support for Amazon Simple Queue Service (AWS.SQS). Example usage:

var sqs = new AWS.SQS({region: 'us-west-2'});
sqs.client.createQueue({QueueName: 'myQueue'}, function(err, data) {
  if (!err) {
    console.log("Created queue", data.QueueUrl);
  }
});

Added support for Amazon Elastic Transcoder (AWS.ElasticTranscoder). Example usage:

var transcoder = new AWS.ElasticTranscoder();
transcoder.client.listPipelines(function(err, data) {
  console.log(err, data);
});

Changed behaviour of request and response objects to emit events instead of callbacks. This affects the use of the done, fail, always, and data callbacks inside of request calls. For instance, the following v0.9.1-pre.2 code:

dynamodb.client.listTables().
  done(function(resp) { ... }).
  fail(function(resp) { ... }).
  always(function(resp) { ... }).
  data(function(resp) { ... }).
  send();

Should now be written as:

dynamodb.client.listTables().
  on('success', function(resp) { ... }).
  on('error', function(error, resp) { ... }).
  on('complete', function(resp) { ... }).
  on('httpData', function(chunk, resp) { ... }).
  send();

See the documentation for information on the available events and their parameters. Note that the AWS.AWSRequest and AWS.AWSResponse have been renamed to AWS.Request and AWS.Response respectively.

The AWS.AWSRequest and AWS.AWSResponse have been renamed to AWS.Request and AWS.Response respectively.

Moved the AWS.Response.httpRequest property into AWS.Request.httpRequest

Added AWS.Request.createReadStream() to stream HTTP data from a request. For example:

var s3 = new AWS.S3();
var params = {Bucket: 'myBucket', Key: 'myImageFile.jpg'};
var file = require('fs').createWriteStream('/path/to/file.jpg');
s3.client.getObject(params).createReadStream().pipe(file);

You can now use the AWS_REGION environment variable to set a default region. For example:

$ AWS_REGION=us-west-2 node
> AWS = require('aws-sdk');
> AWS.config.region
'us-west-2'

Updated how AWS.S3.Client handles errors with no HTTP response body. Canned errors are no longer used if a response body is present. Support for 400 (BadRequest) responses was also added.

Added CRC checking to DynamoDB requests. You can disable CRC checking by setting dynamoDbCrc32 config setting to false:

var db = new AWS.DynamoDB({dynamoDbCrc32: false});

Added support Buffer & Stream payloads in REST services.

The "Body" payload property of REST-based services (like Amazon S3) will now return Buffer objects instead of Strings, which allows for the downloading of binary data:

s3.client.getObject({Bucket:'foo',Key:'bar'}, function(err, data) {
  console.log(data.Body); // data.Body is now a Buffer object
});

In addition, you can now assign a readable Stream object to the Body payload:

// Read the body from a stream
var writeParams = {Bucket:'bucket',Key:'image.jpg',Body:stream};
var stream = fs.createReadStream('/path/to/image.jpg');
s3.client.putObject(writeParams, function() {
  // Write the body Buffer object to a file
  var readParams = {Bucket:'bucket',Key:'image.jpg'};
  s3.client.getObject(readParams, function(err, data) {
    var out = fs.createWriteStream('/path/to/image2.jpg');
    out.write(data.Body);
    out.end();
  });
});

The SDK for Node.js will now return and throw proper Error objects in callbacks:

s3.listBuckets(function(err, data) {
  if (err) {
    console.log(err); // err is an Error object;
  }
});

Added missing headers for PUT, GET and HEAD (and other) object operations. Fixed a number of S3 operations with incorrect input nesting.

Resolve issue where XML parsing was causing off-by-one errors in Javascript dates.

Resolves an issue where some Amazon EC2 service calls were returning only a single element in the response.

Resolves an issue where AWS.util.uriEscape was incorrectly encoding utf8 characters.

Add validations for services that require credentials and validations. If credentials or validations are not provided, an appropriate error will be raised by the request.