bloody-simple-sqs

Bloody simple SQS

A bloody simple Amazon SQS client for Node.js, based on the official AWS SDK.

Features

• Simple interface to Amazon SQS;
• Exposes promise and callback API;
• Battle-tested under heavy load;
• Distributed under the MIT license.

Installation

$ npm install bloody-simple-sqs

Requirements

• Node.js 0.8+

Quick start

Create a new SQS instance

var SQS = require('bloody-simple-sqs');

var queue = new SQS({
 queueName: 'i-am-queue',
 accessKeyId: 'AKIA-access-key',
 secretAccessKey: 'secret-access-key',
 region: 'us-east-1'
});

Append message to queue

queue.add({a: 1, b: 2})
  .then(function (data) {
    console.log('Message sucessfully appended to queue with id ' + data.id);
  })
  .catch(function (err) {
    console.error(err);
  });

Pull message from queue

queue.pollOne()
  .then(function (message) {
    if (!message) {
      console.log('The queue has no messages');
      return;
    }

    console.log(message);
  })
  .catch(function (err) {
    console.error(err);
  });

API Docs

For further information on Bloody Simple SQS methods please refer to the API Docs.

About this project

Amazon Simple Queue Service is an excellent queue-as-a-service solution - simpler than the notorious RabbitMQ, yet powerfull, reliable and inexpensive.

AWS provides a Node.js SDK, but it's complex and repetitive. Bloody-simple-sqs aims to hide the complexity under a simple well-defined API, so that the developers focus on using the SQS, rather than understanding the internal mechanisms of AWS-SDK.

License

MIT

Changelog

1.2.0 - 2015-11-24

• Introduce #removeAll() method which accepts an array of messages or receipt handles.
• Extend #remove() to accept a message object as well as a receiptHandle.