overdrive

library0.0.3jsnpmunverified

A CLI tool for redriving dead-letter messages from an SQS DLQ back onto the original SQS queue. Version 0.0.3, experimental and rarely updated. Key differentiators: lightweight, no configuration files, automatic DLQ detection via queue attributes. Alternative to AWS Console or SDK-based scripts.

devops

npm install overdrive

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · OVERDRIVE

overdrive

devopsjavascriptv0.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.

overdrive

✓ npx overdrive --queue-url https://sqs.region.amazonaws.com/123456789012/MyQueue

✗ npm install -g overdrive && overdrive --queue-url <url>

CLI-only tool; installed globally or run via npx. No programmatic API.

Redrives all dead-letter messages from the DLQ associated with the given queue URL, with a 2-minute timeout.

npx overdrive --queue-url https://sqs.eu-west-1.amazonaws.com/123456789012/MyQueue --timeout 120000

Debug

Known issues

gotchaNo update for 6+ years; may not work with newer Node.js or AWS SDK versions.

fix

Consider writing a custom script using the AWS SDK for your environment.

affects: *

gotchaRequires AWS_REGION environment variable set exactly; region is not inferred from queue URL.

fix

Export AWS_REGION in your shell before running overdrive.

affects: *

gotchaIAM permissions must include sqs:GetQueueUrl on the DLQ; missing it causes silent failure.

fix

Add sqs:GetQueueUrl to your DLQ IAM statement.

affects: *

Errors

Common errors & fixes

Error: connect ETIMEDOUT

Network issue or SQS endpoint unreachable (wrong region).

fix

Verify AWS_REGION and network connectivity to SQS.

Error: AccessDenied when calling GetQueueAttributes

IAM policy missing sqs:GetQueueAttributes on main queue or DLQ.

fix

Add sqs:GetQueueAttributes action for both queues in IAM.

Upgrade

Version history

0.0.3latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

7 hits · last 30 days

node

Resources

githubssh://git@github.com/articulate/overdrive ↗

packageoverdrive ↗

homepagehttps://github.com/articulate/overdrive#readme ↗