Registry / devops / simple-queue-service

simple-queue-service

JSON →
library1.0.3jsnpmunverified

A minimalistic wrapper around Amazon SQS providing a clean Promise-based API for creating, listing, and interacting with queues. v1.0.3 is the only release (2014) and appears unmaintained: no updates, no TypeScript types, no AWS SDK v3 support. It directly uses the deprecated AWS SDK v2 or raw HTTP calls. Unlike aws-sdk or @aws-sdk/client-sqs, it offers a simplified Queue object with send/nextMessage/delete, but lacks features like batch operations, FIFO queues, or IAM role support. Poorly suited for production use without major rework.

devops
npm install simple-queue-service
github ↗package ↗homepage ↗
INSTALL
IMPORT
SIG · SIMPLE-QUEUE-SERVI
S
simple-queue-service
devopsjavascriptv1.0.3
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

default
✓ const sqs = require('simple-queue-service');
✗ import sqs from 'simple-queue-service';
CJS-only, no ESM export
Client
✓ const client = sqs('KEY', 'SECRET', 'REGION');
✗ const client = new sqs.Client('KEY', 'SECRET', 'REGION');
sqs() returns a client directly, no constructor
Queue
✓ const queue = sqs('KEY', 'SECRET', 'REGION').getQueue('name');
✗ const queue = new sqs.Queue('name', 'KEY', 'SECRET', 'REGION');
Queue is accessible via Client.Queue but .getQueue() is preferred

Shows creating a client, getting a queue, sending a message, and receiving/deleting a message.

const sqs = require('simple-queue-service'); const client = sqs('AKIAIOSFODNN7EXAMPLE', 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY', 'us-west-2'); const queue = client.getQueue('my-queue'); queue.send({ message: 'Hello SQS!' }).then(() => { console.log('Message sent'); }).catch(err => { console.error('Send failed:', err); }); queue.nextMessage().then(msg => { console.log('Received:', msg.body); msg.delete().then(() => console.log('Deleted')); });
Debug
Known issues
breakingNo AWS SDK v3 support: this package uses outdated HTTP requests and will not work with IAM roles, STS, or modern authentication.
fix
Migrate to @aws-sdk/client-sqs with official AWS SDK v3.
affects: >=0.0.0
breakingUnmaintained for 10+ years: security vulnerabilities in dependencies (ms, bytes) are not patched.
fix
Do not use in production; switch to aws-sdk or @aws-sdk/client-sqs.
affects: >=0.0.0
gotchanextMessage() polls indefinitely if queue is empty: no timeout option, can hang forever.
fix
Implement manual polling with timeout using a wrapper.
affects: >=0.0.0
gotchaQueues from createQueue() are Promises but also return a Queue object synchronously; errors from AWS are deferred.
fix
Always await or .then() on the result of createQueue to catch creation errors.
affects: >=0.0.0
Errors
Common errors & fixes
Error: connect ETIMEDOUT
SQS endpoint not reachable (wrong region or network issue)
fix
Verify AWS region is correct and network allows outbound HTTPS to sqs.<region>.amazonaws.com
TypeError: sqs is not a function
Using ESM import (import) instead of CommonJS require
fix
Use const sqs = require('simple-queue-service');
AccessDeniedException: 403
Invalid or insufficient AWS credentials
fix
Check SQS_ACCESS_KEY, SQS_SECRET_KEY, and ensure IAM policy allows sqs:SendMessage / sqs:ReceiveMessage
AWS.SimpleQueueService.NonExistentQueue
Queue does not exist or wrong name
fix
Use createQueue if queue does not exist, or correct queue name passed to getQueue
Upgrade
Version history
1.0.3latest on npm
Audit
Dependencies
msrequiredTime span parsing
bytesrequiredMessage size parsing
Agent activity
6 hits · last 30 days
node
6
Resources
githubhttps://github.com/ForbesLindesay/simple-queue-service ↗
packagesimple-queue-service ↗
homepagehttps://github.com/ForbesLindesay/simple-queue-service ↗
simple-queue-service — npm install simple-queue-service · libregistry