{"id":22109302,"url":"https://github.com/pruvonet/squiss-ts","last_synced_at":"2025-07-25T06:31:21.173Z","repository":{"id":34292150,"uuid":"174692968","full_name":"PruvoNet/squiss-ts","owner":"PruvoNet","description":"High-volume Amazon SQS Poller for Node.js","archived":false,"fork":false,"pushed_at":"2023-12-19T17:28:39.000Z","size":2274,"stargazers_count":39,"open_issues_count":9,"forks_count":14,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-12-20T12:19:43.610Z","etag":null,"topics":["amazon","aws","client","extended","poll","poller","polling","queue","s3","sdk","sns","sqs","typesciprt"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PruvoNet.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-03-09T12:41:03.000Z","updated_at":"2024-03-24T22:21:44.796Z","dependencies_parsed_at":"2023-10-20T10:54:49.790Z","dependency_job_id":"24d2fb4c-a376-417f-b556-1aedddb787f9","html_url":"https://github.com/PruvoNet/squiss-ts","commit_stats":{"total_commits":244,"total_committers":15,"mean_commits":"16.266666666666666","dds":0.5286885245901639,"last_synced_commit":"27744212790ec179bdee4cd324610f03f4257197"},"previous_names":[],"tags_count":39,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PruvoNet%2Fsquiss-ts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PruvoNet%2Fsquiss-ts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PruvoNet%2Fsquiss-ts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PruvoNet%2Fsquiss-ts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PruvoNet","download_url":"https://codeload.github.com/PruvoNet/squiss-ts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227529101,"owners_count":17783981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon","aws","client","extended","poll","poller","polling","queue","s3","sdk","sns","sqs","typesciprt"],"created_at":"2024-12-01T09:31:17.041Z","updated_at":"2024-12-01T09:31:17.594Z","avatar_url":"https://github.com/PruvoNet.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Npm Version](https://img.shields.io/npm/v/squiss-ts.svg?style=popout)](https://www.npmjs.com/package/squiss-ts)\n[![node](https://img.shields.io/node/v-lts/squiss-ts)](https://travis-ci.com/PruvoNet/squiss-ts)\n[![Build Status](https://github.com/PruvoNet/squiss-ts/actions/workflows/ci.yml/badge.svg?branch=master)](https://travis-ci.com/PruvoNet/squiss-ts)\n[![Test Coverage](https://api.codeclimate.com/v1/badges/177b18abdb55fdf90cf8/test_coverage)](https://codeclimate.com/github/PruvoNet/squiss-ts/test_coverage)\n[![Maintainability](https://api.codeclimate.com/v1/badges/177b18abdb55fdf90cf8/maintainability)](https://codeclimate.com/github/PruvoNet/squiss-ts/maintainability)\n[![Known Vulnerabilities](https://snyk.io/test/github/PruvoNet/squiss-ts/badge.svg?targetFile=package.json)](https://snyk.io/test/github/PruvoNet/squiss-ts?targetFile=package.json)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://squiss-ts.pruvo.com\"\u003e\u003cimg src=\"https://github.com/PruvoNet/squiss-ts/blob/docs/source/images/logo.png?raw=true\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Squiss-TS \nHigh-volume Amazon SQS Poller and single-queue client for Node.js 16 and up with full typescript support  \nThe library is production ready and is being stress used in a full blown production environment\n\n## Main features\n- Control how many messages can be handled at any given point\n- Efficiently auto pull new messages when concurrency is not fully utilized\n- Easy message lifecycle management\n- Options to auto renew messages visibility timeout for long message processing\n- Option to automatically gzip incoming and outgoing messages (based on message size) to decrease message sizes and save SQS costs\n- Option to auto upload large messages to s3 and retrieve the message from s3 upon receive, in order to decrease message sizes, save SQS costs and be able to send messages bigger than SQS size limit\n- Full typescript support\n\n## Documentation\n\nPlease see full documentation \u003ca href=\"https://squiss-ts.pruvo.com\"\u003ehere\u003c/a\u003e\n\n## Quick example\n```typescript\nimport {Squiss, Message} from 'squiss-ts';\n\nconst awsConfig = {\n  credentials: {\n    accessKeyId: 'accessKeyId',\n    secretAccessKey: 'secretAccessKey',\n  },\n  region: '\u003cregion\u003e',\n};\n\nconst squiss = new Squiss({\n  awsConfig,\n  queueName: 'my-sqs-queue',\n  bodyFormat: 'json',\n  maxInFlight: 15\n});\n\nsquiss.on('message', (message: Message) =\u003e {\n  console.log(`${message.body.name} says: ${JSON.stringify(message.body.message)} and has attripute p1 with value ${message.attributes.p1}`);\n  message.del();\n});\n\nsquiss.start();\n\nconst messageToSend = {\n    name: 'messageName',\n    message: {\n        a: 1,\n        b: 2,\n    },\n};\n\nconst propsToSend = {\n    p1: 1,\n    p2: 2,\n};\n\nsquiss.sendMessage(messageToSend, 0, propsToSend);\n```\n\n## Install\n```bash\nnpm install squiss-ts\n```\n\n## How it works\nSquiss processes as many messages simultaneously as possible.  \nSet the [maxInFlight](https://squiss-ts.pruvo.com/#squiss-class-constructor-options-polling-options-maxinflight) option to the number of messages your app can handle at one time without choking, and Squiss will keep\nthat many messages flowing through your app, grabbing more as you mark each message as handled or ready for deletion.  \nIf the queue is empty, Squiss will maintain an open connection to SQS, waiting for any messages that appear in real time.  \nSquiss can also handle renewing the visibility timeout for your messages until you handle the message, or message handling time \n(set up by you) has passed (see [autoExtendTimeout](https://squiss-ts.pruvo.com/#squiss-class-constructor-options-auto-extend-options-autoextendtimeout)).  \nBonus: Squiss will also automatically handle the message attributes formatting and parsing when receiving and sending messages. \n\n## Versions\nSquiss supports Node 6 LTS and higher.\n\n## Credits\nThis project is a typescript port (with better performance, bug fixes and new features) of the wonderful and unmaintnaed project [TomFrost/Squiss](https://www.github.com/TomFrost/Squiss)  \nSquiss was originally created at [TechnologyAdvice](http://www.technologyadvice.com) in Nashville, TN.\n\n## Contributing\n\nAll contributions are happily welcomed!  \nPlease make all pull requests to the `master` branch from your fork and ensure tests pass locally.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpruvonet%2Fsquiss-ts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpruvonet%2Fsquiss-ts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpruvonet%2Fsquiss-ts/lists"}