sqs-consumer 8.2.0 → 9.0.0

package/.github/workflows/publish.yml

@@ -17,8 +17,6 @@ jobs:
           cache: 'npm'
           registry-url: 'https://registry.npmjs.org'
       - run: npm ci
-      - name: Verify the integrity of provenance attestations and registry signatures for installed dependencies
-        run: npm audit signatures
       - name: Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/CHANGELOG.md

@@ -1,12 +1,21 @@
-## [8.2.0](https://github.com/bbc/sqs-consumer/compare/v8.1.5...v8.2.0) (2024-02-06)
+## [9.0.0](https://github.com/bbc/sqs-consumer/compare/v8.2.0...v9.0.0) (2024-03-11)
 
 
+### ⚠ BREAKING CHANGES
+
+* removing handler_processing debugger in favour of status (#470)
+* replacing the isRunning method with status (#459)
+
 ### Features
 
-* Wait for msgs to be processed before emitting stopped ([#454](https://github.com/bbc/sqs-consumer/issues/454)) ([0fa5305](https://github.com/bbc/sqs-consumer/commit/0fa53055a4957dba7381307cdeb65aa99128c315))
+* removing handler_processing debugger in favour of status ([#470](https://github.com/bbc/sqs-consumer/issues/470)) ([b554da6](https://github.com/bbc/sqs-consumer/commit/b554da6e700bc0e69b77032352f250f19dba081b))
+* replacing the isRunning method with status ([#459](https://github.com/bbc/sqs-consumer/issues/459)) ([9f07383](https://github.com/bbc/sqs-consumer/commit/9f07383b0244fa0ce05238c45f27238cd3459ebf))
 
 
 ### Chores
 
-* removing semantic git ([b834205](https://github.com/bbc/sqs-consumer/commit/b834205bfe9183bc69141c4016831cdbb6e33d7a))
-* updating release config ([6b95edb](https://github.com/bbc/sqs-consumer/commit/6b95edbf894864e25a61a748ab0ac9d6ebf2a2f7))
+* adding a link to the documentation ([#471](https://github.com/bbc/sqs-consumer/issues/471)) ([bd7fbbb](https://github.com/bbc/sqs-consumer/commit/bd7fbbb78a7e1d10cb7eae1b7d8f595c48b3438e))
+* **deps:** upgrading dependencies - March 24 ([#468](https://github.com/bbc/sqs-consumer/issues/468)) ([2d342cd](https://github.com/bbc/sqs-consumer/commit/2d342cd63365bb42c095e2d4f56a7e2433f43f25))
+* handle breaking changes ([2924ca2](https://github.com/bbc/sqs-consumer/commit/2924ca24e9fda687bf47a5daf45d17618561dae1))
+* **release:** v9.0.0 ([bc5593c](https://github.com/bbc/sqs-consumer/commit/bc5593c4f9940e30c05e6463a1e7339bf14f1e50))
+* upgrading @semantic-release/npm ([bed4dc6](https://github.com/bbc/sqs-consumer/commit/bed4dc63e42344325de0be398952c2b99994e631))

package/README.md

@@ -26,6 +26,10 @@ npm install sqs-consumer
 
 We will only support Node versions that are actively or security supported by the Node team. If you are still using an Node 14, please use a version of this library before the v7 release, if you are using Node 16, please use a version before the v7.3.0 release.
 
+## Documentation
+
+Visit [https://bbc.github.io/sqs-consumer/](https://bbc.github.io/sqs-consumer/) for the full API documentation.
+
 ## Usage
 
 ```js
@@ -125,9 +129,15 @@ By default, the value of `abort` is set to `false` which means pre existing requ
 
 `consumer.stop({ abort: true })`
 
-### `consumer.isRunning`
+### `consumer.status`
+
+Returns the current status of the consumer.
+
+- `isRunning` - `true` if the consumer has been started and not stopped, `false` if was not started or if it was stopped.
+- `isPolling` - `true` if the consumer is actively polling, `false` if it is not.
 
-Returns the current polling state of the consumer: `true` if it is actively polling, `false` if it is not.
+> **Note:**
+> This method is not available in versions before v9.0.0 and replaced the method `isRunning` to supply both running and polling states.
 
 ### `consumer.updateOption(option, value)`
 

package/dist/consumer.d.ts

@@ -51,9 +51,13 @@ export declare class Consumer extends TypedEventEmitter {
      */
     private waitForPollingToComplete;
     /**
-     * Returns the current polling state of the consumer: `true` if it is actively polling, `false` if it is not.
+     * Returns the current status of the consumer.
+     * This includes whether it is running or currently polling.
      */
-    get isRunning(): boolean;
+    get status(): {
+        isRunning: boolean;
+        isPolling: boolean;
+    };
     /**
      * Validates and then updates the provided option to the provided value.
      * @param option The option to validate and then update

package/dist/consumer.js

@@ -16,6 +16,7 @@ class Consumer extends emitter_1.TypedEventEmitter {
         super();
         this.pollingTimeoutId = undefined;
         this.stopped = true;
+        this.isPolling = false;
         (0, validation_1.assertOptions)(options);
         this.queueUrl = options.queueUrl;
         this.handleMessage = options.handleMessage;
@@ -108,18 +109,22 @@ class Consumer extends emitter_1.TypedEventEmitter {
         const exceededTimeout = Date.now() - this.stopRequestedAtTimestamp >
             this.pollingCompleteWaitTimeMs;
         if (exceededTimeout) {
-            logger_1.logger.debug('waiting_for_polling_to_complete_timeout_exceeded');
+            this.emit('waiting_for_polling_to_complete_timeout_exceeded');
             this.emit('stopped');
             return;
         }
-        logger_1.logger.debug('waiting_for_polling_to_complete');
+        this.emit('waiting_for_polling_to_complete');
         setTimeout(this.waitForPollingToComplete, 1000);
     }
     /**
-     * Returns the current polling state of the consumer: `true` if it is actively polling, `false` if it is not.
+     * Returns the current status of the consumer.
+     * This includes whether it is running or currently polling.
      */
-    get isRunning() {
-        return !this.stopped;
+    get status() {
+        return {
+            isRunning: !this.stopped,
+            isPolling: this.isPolling
+        };
     }
     /**
      * Validates and then updates the provided option to the provided value.
@@ -221,18 +226,12 @@ class Consumer extends emitter_1.TypedEventEmitter {
      */
     async handleSqsResponse(response) {
         if ((0, validation_1.hasMessages)(response)) {
-            const handlerProcessingDebugger = setInterval(() => {
-                logger_1.logger.debug('handler_processing', {
-                    detail: 'The handler is still processing the message(s)...'
-                });
-            }, 1000);
             if (this.handleMessageBatch) {
                 await this.processMessageBatch(response.Messages);
             }
             else {
                 await Promise.all(response.Messages.map(this.processMessage));
             }
-            clearInterval(handlerProcessingDebugger);
             this.emit('response_processed');
         }
         else if (response) {

package/dist/types.d.ts

@@ -189,6 +189,14 @@ export interface Events {
      * Fired when an option is updated
      */
     option_updated: [UpdatableOptions, ConsumerOptions[UpdatableOptions]];
+    /**
+     * Fired when the Consumer is waiting for polling to complete before stopping.
+     */
+    waiting_for_polling_to_complete: [];
+    /**
+     * Fired when the Consumer has waited for polling to complete and is stopping due to a timeout.
+     */
+    waiting_for_polling_to_complete_timeout_exceeded: [];
 }
 export type AWSError = {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sqs-consumer",
-  "version": "8.2.0",
+  "version": "9.0.0",
   "description": "Build SQS-based Node applications without the boilerplate",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,7 +21,7 @@
     "lcov": "c8 mocha && c8 report --reporter=lcov",
     "lint": "eslint . --ext .ts",
     "lint:fix": "eslint . --fix",
-    "format": "prettier --loglevel warn --write \"**/*.{js,json,jsx,md,ts,tsx,html}\"",
+    "format": "prettier --log-level warn --write \"**/*.{js,json,jsx,md,ts,tsx,html}\"",
     "format:check": "prettier --check \"**/*.{js,json,jsx,md,ts,tsx,html}\"",
     "posttest": "npm run lint && npm run format:check",
     "generate-docs": "typedoc"
@@ -57,6 +57,10 @@
         {
           "preset": "conventionalcommits",
           "releaseRules": [
+            {
+              "type": "breaking",
+              "release": "major"
+            },
             {
               "type": "feat",
               "release": "minor"
@@ -124,39 +128,39 @@
     ]
   },
   "devDependencies": {
-    "@cucumber/cucumber": "10.0.1",
+    "@cucumber/cucumber": "10.3.1",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^11.1.0",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^9.2.6",
-    "@semantic-release/npm": "^11.0.2",
+    "@semantic-release/npm": "11.0.3",
     "@semantic-release/release-notes-generator": "^12.1.0",
-    "@types/chai": "^4.3.9",
-    "@types/mocha": "^10.0.3",
-    "@types/node": "^20.8.7",
-    "@types/sinon": "^10.0.20",
-    "c8": "^8.0.1",
+    "@types/chai": "^4.3.12",
+    "@types/mocha": "^10.0.6",
+    "@types/node": "^20.11.25",
+    "@types/sinon": "^17.0.3",
+    "c8": "^9.1.0",
     "chai": "^4.3.10",
     "conventional-changelog-conventionalcommits": "^7.0.2",
-    "eslint": "^8.52.0",
-    "eslint-config-iplayer": "^9.1.0",
-    "eslint-config-prettier": "^9.0.0",
-    "mocha": "^10.2.0",
+    "eslint": "^8.57.0",
+    "eslint-config-iplayer": "^9.2.0",
+    "eslint-config-prettier": "^9.1.0",
+    "mocha": "^10.3.0",
     "p-event": "^4.2.0",
-    "prettier": "^3.0.3",
-    "semantic-release": "^23.0.0",
-    "sinon": "^17.0.0",
-    "sqs-producer": "^4.0.0",
-    "ts-node": "^10.9.1",
-    "typedoc": "^0.25.2",
-    "typescript": "^5.2.2"
+    "prettier": "^3.2.5",
+    "semantic-release": "^23.0.2",
+    "sinon": "^17.0.1",
+    "sqs-producer": "^5.0.0",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.25.12",
+    "typescript": "^5.4.2"
   },
   "dependencies": {
-    "@aws-sdk/client-sqs": "^3.447.0",
+    "@aws-sdk/client-sqs": "^3.529.1",
     "debug": "^4.3.4"
   },
   "peerDependencies": {
-    "@aws-sdk/client-sqs": "^3.447.0"
+    "@aws-sdk/client-sqs": "^3.529.1"
   },
   "mocha": {
     "spec": "test/tests/**/**/*.test.ts",

package/src/consumer.ts

@@ -56,7 +56,7 @@ export class Consumer extends TypedEventEmitter {
   private pollingWaitTimeMs: number;
   private pollingCompleteWaitTimeMs: number;
   private heartbeatInterval: number;
-  private isPolling: boolean;
+  private isPolling = false;
   private stopRequestedAtTimestamp: number;
   public abortController: AbortController;
 
@@ -164,20 +164,27 @@ export class Consumer extends TypedEventEmitter {
       Date.now() - this.stopRequestedAtTimestamp >
       this.pollingCompleteWaitTimeMs;
     if (exceededTimeout) {
-      logger.debug('waiting_for_polling_to_complete_timeout_exceeded');
+      this.emit('waiting_for_polling_to_complete_timeout_exceeded');
       this.emit('stopped');
       return;
     }
 
-    logger.debug('waiting_for_polling_to_complete');
+    this.emit('waiting_for_polling_to_complete');
     setTimeout(this.waitForPollingToComplete, 1000);
   }
 
   /**
-   * Returns the current polling state of the consumer: `true` if it is actively polling, `false` if it is not.
+   * Returns the current status of the consumer.
+   * This includes whether it is running or currently polling.
    */
-  public get isRunning(): boolean {
-    return !this.stopped;
+  public get status(): {
+    isRunning: boolean;
+    isPolling: boolean;
+  } {
+    return {
+      isRunning: !this.stopped,
+      isPolling: this.isPolling
+    };
   }
 
   /**
@@ -297,20 +304,12 @@ export class Consumer extends TypedEventEmitter {
     response: ReceiveMessageCommandOutput
   ): Promise<void> {
     if (hasMessages(response)) {
-      const handlerProcessingDebugger = setInterval(() => {
-        logger.debug('handler_processing', {
-          detail: 'The handler is still processing the message(s)...'
-        });
-      }, 1000);
-
       if (this.handleMessageBatch) {
         await this.processMessageBatch(response.Messages);
       } else {
         await Promise.all(response.Messages.map(this.processMessage));
       }
 
-      clearInterval(handlerProcessingDebugger);
-
       this.emit('response_processed');
     } else if (response) {
       this.emit('empty');

package/src/types.ts

@@ -197,6 +197,14 @@ export interface Events {
    * Fired when an option is updated
    */
   option_updated: [UpdatableOptions, ConsumerOptions[UpdatableOptions]];
+  /**
+   * Fired when the Consumer is waiting for polling to complete before stopping.
+   */
+  waiting_for_polling_to_complete: [];
+  /**
+   * Fired when the Consumer has waited for polling to complete and is stopping due to a timeout.
+   */
+  waiting_for_polling_to_complete_timeout_exceeded: [];
 }
 
 export type AWSError = {