@backstage/plugin-events-backend-module-aws-sqs 0.2.12-next.1 → 0.2.12

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @backstage/plugin-events-backend-module-aws-sqs
 
+## 0.2.12
+
+### Patch Changes
+
+- 7b8e551: Fix errors when deleting SQS messages:
+
+  - If zero messages were received, skip deletion to avoid `EmptyBatchRequest` error from the SQS client.
+  - If zero failures were returned from the SQS client during deletion, skip error logging.
+
+- d5ddc4e: Add documentation on how to install the plugins with the new backend system.
+- Updated dependencies
+  - @backstage/backend-common@0.20.1
+  - @backstage/backend-plugin-api@0.6.9
+  - @backstage/backend-tasks@0.5.14
+  - @backstage/config@1.1.1
+  - @backstage/types@1.1.1
+  - @backstage/plugin-events-node@0.2.18
+
+## 0.2.12-next.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/backend-plugin-api@0.6.9-next.2
+  - @backstage/backend-common@0.20.1-next.2
+  - @backstage/plugin-events-node@0.2.18-next.2
+  - @backstage/backend-tasks@0.5.14-next.2
+
 ## 0.2.12-next.1
 
 ### Patch Changes

package/README.md

@@ -40,3 +40,7 @@ events:
 # From your Backstage root directory
 yarn add --cwd packages/backend @backstage/plugin-events-backend-module-aws-sqs
 ```
+
+```ts title="packages/backend/src/index.ts"
+backend.add(import('@backstage/plugin-events-backend-module-aws-sqs/alpha'));
+```

package/alpha/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-events-backend-module-aws-sqs",
-  "version": "0.2.12-next.1",
+  "version": "0.2.12",
   "main": "../dist/alpha.cjs.js",
   "types": "../dist/alpha.d.ts"
 }

package/dist/alpha.cjs.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var backendPluginApi = require('@backstage/backend-plugin-api');
 var backendCommon = require('@backstage/backend-common');
 var alpha = require('@backstage/plugin-events-node/alpha');
-var AwsSqsConsumingEventPublisher = require('./cjs/AwsSqsConsumingEventPublisher-f9ac5258.cjs.js');
+var AwsSqsConsumingEventPublisher = require('./cjs/AwsSqsConsumingEventPublisher-034938f3.cjs.js');
 require('@aws-sdk/client-sqs');
 require('luxon');
 

package/dist/cjs/{AwsSqsConsumingEventPublisher-f9ac5258.cjs.js → AwsSqsConsumingEventPublisher-034938f3.cjs.js}

@@ -133,7 +133,7 @@ class AwsSqsConsumingEventPublisher {
     });
   }
   async deleteMessages(messages) {
-    if (!messages) {
+    if (!messages || messages.length === 0) {
       return;
     }
     const deleteParams = {
@@ -150,7 +150,7 @@ class AwsSqsConsumingEventPublisher {
       const result = await this.sqs.send(
         new clientSqs.DeleteMessageBatchCommand(deleteParams)
       );
-      if (result.Failed) {
+      if (result.Failed && result.Failed.length > 0) {
         this.logger.error(
           `Failed to delete ${result.Failed.length} of ${messages.length} messages from AWS SQS ${this.queueUrl}. First: ${result.Failed[0].Message}`
         );
@@ -205,4 +205,4 @@ class AwsSqsConsumingEventPublisher {
 }
 
 exports.AwsSqsConsumingEventPublisher = AwsSqsConsumingEventPublisher;
-//# sourceMappingURL=AwsSqsConsumingEventPublisher-f9ac5258.cjs.js.map
+//# sourceMappingURL=AwsSqsConsumingEventPublisher-034938f3.cjs.js.map

package/dist/cjs/AwsSqsConsumingEventPublisher-034938f3.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AwsSqsConsumingEventPublisher-034938f3.cjs.js","sources":["../../src/publisher/config.ts","../../src/publisher/AwsSqsConsumingEventPublisher.ts"],"sourcesContent":["/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Config } from '@backstage/config';\nimport { HumanDuration, JsonObject } from '@backstage/types';\nimport { Duration } from 'luxon';\n\nconst CONFIG_PREFIX_MODULE = 'events.modules.awsSqs.';\nconst CONFIG_PREFIX_PUBLISHER = `${CONFIG_PREFIX_MODULE}awsSqsConsumingEventPublisher.`;\nconst DEFAULT_WAIT_TIME_AFTER_EMPTY_RECEIVE = { minutes: 1 };\nconst MAX_WAIT_SECONDS = 20;\n\nexport interface AwsSqsEventSourceConfig {\n  pollingWaitTime: Duration;\n  queueUrl: string;\n  region: string;\n  timeout: Duration;\n  topic: string;\n  visibilityTimeout?: Duration;\n  waitTimeAfterEmptyReceive: Duration;\n  endpoint?: string;\n}\n\n// TODO(pjungermann): validation could be improved similar to `convertToHumanDuration` at @backstage/backend-tasks\nfunction readOptionalHumanDuration(\n  config: Config,\n  key: string,\n): HumanDuration | undefined {\n  return config.getOptional<JsonObject>(key) as HumanDuration;\n}\n\nfunction readOptionalDuration(\n  config: Config,\n  key: string,\n): Duration | undefined {\n  const duration = readOptionalHumanDuration(config, key);\n  return duration ? Duration.fromObject(duration) : undefined;\n}\n\nexport function readConfig(config: Config): AwsSqsEventSourceConfig[] {\n  const key = `${CONFIG_PREFIX_PUBLISHER}topics`;\n  const topics = config.getOptionalConfig(key);\n\n  return (\n    topics?.keys()?.map(topic => {\n      const topicConfig = topics.getConfig(topic);\n      const keyPrefix = `${key}.${topic}.`;\n\n      // queue config:\n      const pollingWaitTime = Duration.fromObject(\n        readOptionalHumanDuration(topicConfig, 'queue.waitTime') ?? {\n          seconds: MAX_WAIT_SECONDS,\n        },\n      );\n      if (\n        pollingWaitTime.valueOf() < 0 ||\n        pollingWaitTime.as('seconds') > MAX_WAIT_SECONDS\n      ) {\n        throw new Error(\n          `${keyPrefix}queue.waitTime must be within 0..${MAX_WAIT_SECONDS} seconds.`,\n        );\n      }\n      const queueUrl = topicConfig.getString('queue.url');\n      const region = topicConfig.getString('queue.region');\n      const endpoint = topicConfig.getOptionalString('queue.endpoint');\n      const visibilityTimeout = readOptionalDuration(\n        topicConfig,\n        'queue.visibilityTimeout',\n      );\n\n      // task:\n      const waitTimeAfterEmptyReceive = Duration.fromObject(\n        readOptionalHumanDuration(topicConfig, 'waitTimeAfterEmptyReceive') ??\n          DEFAULT_WAIT_TIME_AFTER_EMPTY_RECEIVE,\n      );\n      if (waitTimeAfterEmptyReceive.valueOf() < 0) {\n        throw new Error(\n          `The ${keyPrefix}waitTimeAfterEmptyReceive must not be negative.`,\n        );\n      }\n      const timeout =\n        readOptionalDuration(topicConfig, 'timeout') ??\n        pollingWaitTime\n          .plus(waitTimeAfterEmptyReceive)\n          .plus(Duration.fromObject({ seconds: 180 }));\n      if (\n        timeout.valueOf() <=\n        pollingWaitTime.valueOf() + waitTimeAfterEmptyReceive.valueOf()\n      ) {\n        throw new Error(\n          `The ${keyPrefix}timeout must be greater than ${keyPrefix}queue.waitTime + ${keyPrefix}waitTimeAfterEmptyReceive.`,\n        );\n      }\n\n      return {\n        pollingWaitTime,\n        queueUrl,\n        endpoint,\n        region,\n        timeout,\n        topic,\n        visibilityTimeout,\n        waitTimeAfterEmptyReceive,\n      };\n    }) ?? []\n  );\n}\n","/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  DeleteMessageBatchCommand,\n  Message,\n  ReceiveMessageCommand,\n  ReceiveMessageCommandInput,\n  SQSClient,\n} from '@aws-sdk/client-sqs';\nimport { PluginTaskScheduler } from '@backstage/backend-tasks';\nimport { Config } from '@backstage/config';\nimport { EventBroker, EventPublisher } from '@backstage/plugin-events-node';\nimport { Logger } from 'winston';\nimport { AwsSqsEventSourceConfig, readConfig } from './config';\n\n/**\n * Publishes events received from an AWS SQS queue.\n * The message payload will be used as event payload and passed to registered subscribers.\n *\n * @public\n */\n// TODO(pjungermann): add prom metrics? (see plugins/catalog-backend/src/util/metrics.ts, etc.)\nexport class AwsSqsConsumingEventPublisher implements EventPublisher {\n  private readonly topic: string;\n  private readonly receiveParams: ReceiveMessageCommandInput;\n  private readonly sqs: SQSClient;\n  private readonly queueUrl: string;\n  private readonly taskTimeoutSeconds: number;\n  private readonly waitTimeAfterEmptyReceiveMs;\n  private eventBroker?: EventBroker;\n\n  static fromConfig(env: {\n    config: Config;\n    logger: Logger;\n    scheduler: PluginTaskScheduler;\n  }): AwsSqsConsumingEventPublisher[] {\n    return readConfig(env.config).map(\n      config =>\n        new AwsSqsConsumingEventPublisher(env.logger, env.scheduler, config),\n    );\n  }\n\n  private constructor(\n    private readonly logger: Logger,\n    private readonly scheduler: PluginTaskScheduler,\n    config: AwsSqsEventSourceConfig,\n  ) {\n    this.topic = config.topic;\n\n    this.receiveParams = {\n      MaxNumberOfMessages: 10,\n      MessageAttributeNames: ['All'],\n      QueueUrl: config.queueUrl,\n      VisibilityTimeout: config.visibilityTimeout?.as('seconds'),\n      WaitTimeSeconds: config.pollingWaitTime.as('seconds'),\n    };\n\n    this.sqs = new SQSClient({\n      region: config.region,\n      endpoint: config.endpoint,\n    });\n    this.queueUrl = config.queueUrl;\n\n    this.taskTimeoutSeconds = config.timeout.as('seconds');\n    this.waitTimeAfterEmptyReceiveMs =\n      config.waitTimeAfterEmptyReceive.as('milliseconds');\n  }\n\n  async setEventBroker(eventBroker: EventBroker): Promise<void> {\n    this.eventBroker = eventBroker;\n    return this.start();\n  }\n\n  private async start(): Promise<void> {\n    const id = `events.awsSqs.publisher:${this.topic}`;\n    const logger = this.logger.child({\n      class: AwsSqsConsumingEventPublisher.prototype.constructor.name,\n      taskId: id,\n    });\n\n    await this.scheduler.scheduleTask({\n      id: id,\n      frequency: { seconds: 0 },\n      timeout: { seconds: this.taskTimeoutSeconds },\n      scope: 'local',\n      fn: async () => {\n        try {\n          const numMessages = await this.consumeMessages();\n          if (numMessages === 0) {\n            await this.sleep(this.waitTimeAfterEmptyReceiveMs);\n          }\n        } catch (error) {\n          logger.error('Failed to consume AWS SQS messages', error);\n        }\n      },\n    });\n  }\n\n  private async deleteMessages(messages?: Message[]): Promise<void> {\n    if (!messages || messages.length === 0) {\n      return;\n    }\n\n    const deleteParams = {\n      QueueUrl: this.queueUrl,\n      Entries: messages.map((message, index) => {\n        return {\n          Id: message.MessageId ?? `message-${index}`,\n          ReceiptHandle: message.ReceiptHandle,\n        };\n      }),\n    };\n\n    try {\n      const result = await this.sqs.send(\n        new DeleteMessageBatchCommand(deleteParams),\n      );\n      if (result.Failed && result.Failed.length > 0) {\n        this.logger.error(\n          `Failed to delete ${result.Failed!.length} of ${\n            messages.length\n          } messages from AWS SQS ${this.queueUrl}. First: ${\n            result.Failed[0].Message\n          }`,\n        );\n      }\n    } catch (error) {\n      this.logger.error(\n        `Failed to delete message from AWS SQS ${this.queueUrl}`,\n        error,\n      );\n    }\n  }\n\n  private async consumeMessages(): Promise<number> {\n    try {\n      const data = await this.sqs.send(\n        new ReceiveMessageCommand(this.receiveParams),\n      );\n\n      data.Messages?.forEach(message => {\n        const eventPayload = JSON.parse(message.Body!);\n\n        const metadata: Record<string, string | string[]> = {};\n        Object.keys(message.MessageAttributes ?? {}).forEach(key => {\n          const attrValue = message.MessageAttributes![key];\n          if (\n            !attrValue ||\n            !attrValue.DataType ||\n            !['String', 'Number'].includes(attrValue.DataType)\n          ) {\n            return;\n          }\n\n          const value = attrValue.StringListValues ?? attrValue.StringValue;\n          if (value !== undefined) {\n            metadata[key] = value;\n          }\n        });\n\n        this.eventBroker!.publish({\n          topic: this.topic,\n          eventPayload,\n          metadata,\n        });\n      });\n      await this.deleteMessages(data.Messages);\n      return data.Messages?.length ?? 0;\n    } catch (error) {\n      this.logger.error(\n        `Failed to receive events from AWS SQS ${this.queueUrl}`,\n        error,\n      );\n      return 0;\n    }\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise<void>(resolve => setTimeout(resolve, ms));\n  }\n}\n"],"names":["Duration","_a","_b","SQSClient","DeleteMessageBatchCommand","ReceiveMessageCommand"],"mappings":"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"}

package/dist/index.cjs.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var AwsSqsConsumingEventPublisher = require('./cjs/AwsSqsConsumingEventPublisher-f9ac5258.cjs.js');
+var AwsSqsConsumingEventPublisher = require('./cjs/AwsSqsConsumingEventPublisher-034938f3.cjs.js');
 require('@aws-sdk/client-sqs');
 require('luxon');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-events-backend-module-aws-sqs",
-  "version": "0.2.12-next.1",
+  "version": "0.2.12",
   "main": "./dist/index.cjs.js",
   "types": "./dist/index.d.ts",
   "license": "Apache-2.0",
@@ -40,21 +40,21 @@
   },
   "dependencies": {
     "@aws-sdk/client-sqs": "^3.350.0",
-    "@backstage/backend-common": "^0.20.1-next.1",
-    "@backstage/backend-plugin-api": "^0.6.9-next.1",
-    "@backstage/backend-tasks": "^0.5.14-next.1",
+    "@backstage/backend-common": "^0.20.1",
+    "@backstage/backend-plugin-api": "^0.6.9",
+    "@backstage/backend-tasks": "^0.5.14",
     "@backstage/config": "^1.1.1",
-    "@backstage/plugin-events-node": "^0.2.18-next.1",
+    "@backstage/plugin-events-node": "^0.2.18",
     "@backstage/types": "^1.1.1",
     "luxon": "^3.0.0",
     "winston": "^3.2.1"
   },
   "devDependencies": {
     "@aws-sdk/types": "^3.347.0",
-    "@backstage/backend-common": "^0.20.1-next.1",
-    "@backstage/backend-test-utils": "^0.2.10-next.1",
-    "@backstage/cli": "^0.25.1-next.1",
-    "@backstage/plugin-events-backend-test-utils": "^0.1.19-next.1",
+    "@backstage/backend-common": "^0.20.1",
+    "@backstage/backend-test-utils": "^0.2.10",
+    "@backstage/cli": "^0.25.1",
+    "@backstage/plugin-events-backend-test-utils": "^0.1.19",
     "aws-sdk-client-mock": "^3.0.0"
   },
   "files": [

package/dist/cjs/AwsSqsConsumingEventPublisher-f9ac5258.cjs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AwsSqsConsumingEventPublisher-f9ac5258.cjs.js","sources":["../../src/publisher/config.ts","../../src/publisher/AwsSqsConsumingEventPublisher.ts"],"sourcesContent":["/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Config } from '@backstage/config';\nimport { HumanDuration, JsonObject } from '@backstage/types';\nimport { Duration } from 'luxon';\n\nconst CONFIG_PREFIX_MODULE = 'events.modules.awsSqs.';\nconst CONFIG_PREFIX_PUBLISHER = `${CONFIG_PREFIX_MODULE}awsSqsConsumingEventPublisher.`;\nconst DEFAULT_WAIT_TIME_AFTER_EMPTY_RECEIVE = { minutes: 1 };\nconst MAX_WAIT_SECONDS = 20;\n\nexport interface AwsSqsEventSourceConfig {\n  pollingWaitTime: Duration;\n  queueUrl: string;\n  region: string;\n  timeout: Duration;\n  topic: string;\n  visibilityTimeout?: Duration;\n  waitTimeAfterEmptyReceive: Duration;\n  endpoint?: string;\n}\n\n// TODO(pjungermann): validation could be improved similar to `convertToHumanDuration` at @backstage/backend-tasks\nfunction readOptionalHumanDuration(\n  config: Config,\n  key: string,\n): HumanDuration | undefined {\n  return config.getOptional<JsonObject>(key) as HumanDuration;\n}\n\nfunction readOptionalDuration(\n  config: Config,\n  key: string,\n): Duration | undefined {\n  const duration = readOptionalHumanDuration(config, key);\n  return duration ? Duration.fromObject(duration) : undefined;\n}\n\nexport function readConfig(config: Config): AwsSqsEventSourceConfig[] {\n  const key = `${CONFIG_PREFIX_PUBLISHER}topics`;\n  const topics = config.getOptionalConfig(key);\n\n  return (\n    topics?.keys()?.map(topic => {\n      const topicConfig = topics.getConfig(topic);\n      const keyPrefix = `${key}.${topic}.`;\n\n      // queue config:\n      const pollingWaitTime = Duration.fromObject(\n        readOptionalHumanDuration(topicConfig, 'queue.waitTime') ?? {\n          seconds: MAX_WAIT_SECONDS,\n        },\n      );\n      if (\n        pollingWaitTime.valueOf() < 0 ||\n        pollingWaitTime.as('seconds') > MAX_WAIT_SECONDS\n      ) {\n        throw new Error(\n          `${keyPrefix}queue.waitTime must be within 0..${MAX_WAIT_SECONDS} seconds.`,\n        );\n      }\n      const queueUrl = topicConfig.getString('queue.url');\n      const region = topicConfig.getString('queue.region');\n      const endpoint = topicConfig.getOptionalString('queue.endpoint');\n      const visibilityTimeout = readOptionalDuration(\n        topicConfig,\n        'queue.visibilityTimeout',\n      );\n\n      // task:\n      const waitTimeAfterEmptyReceive = Duration.fromObject(\n        readOptionalHumanDuration(topicConfig, 'waitTimeAfterEmptyReceive') ??\n          DEFAULT_WAIT_TIME_AFTER_EMPTY_RECEIVE,\n      );\n      if (waitTimeAfterEmptyReceive.valueOf() < 0) {\n        throw new Error(\n          `The ${keyPrefix}waitTimeAfterEmptyReceive must not be negative.`,\n        );\n      }\n      const timeout =\n        readOptionalDuration(topicConfig, 'timeout') ??\n        pollingWaitTime\n          .plus(waitTimeAfterEmptyReceive)\n          .plus(Duration.fromObject({ seconds: 180 }));\n      if (\n        timeout.valueOf() <=\n        pollingWaitTime.valueOf() + waitTimeAfterEmptyReceive.valueOf()\n      ) {\n        throw new Error(\n          `The ${keyPrefix}timeout must be greater than ${keyPrefix}queue.waitTime + ${keyPrefix}waitTimeAfterEmptyReceive.`,\n        );\n      }\n\n      return {\n        pollingWaitTime,\n        queueUrl,\n        endpoint,\n        region,\n        timeout,\n        topic,\n        visibilityTimeout,\n        waitTimeAfterEmptyReceive,\n      };\n    }) ?? []\n  );\n}\n","/*\n * Copyright 2022 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  DeleteMessageBatchCommand,\n  Message,\n  ReceiveMessageCommand,\n  ReceiveMessageCommandInput,\n  SQSClient,\n} from '@aws-sdk/client-sqs';\nimport { PluginTaskScheduler } from '@backstage/backend-tasks';\nimport { Config } from '@backstage/config';\nimport { EventBroker, EventPublisher } from '@backstage/plugin-events-node';\nimport { Logger } from 'winston';\nimport { AwsSqsEventSourceConfig, readConfig } from './config';\n\n/**\n * Publishes events received from an AWS SQS queue.\n * The message payload will be used as event payload and passed to registered subscribers.\n *\n * @public\n */\n// TODO(pjungermann): add prom metrics? (see plugins/catalog-backend/src/util/metrics.ts, etc.)\nexport class AwsSqsConsumingEventPublisher implements EventPublisher {\n  private readonly topic: string;\n  private readonly receiveParams: ReceiveMessageCommandInput;\n  private readonly sqs: SQSClient;\n  private readonly queueUrl: string;\n  private readonly taskTimeoutSeconds: number;\n  private readonly waitTimeAfterEmptyReceiveMs;\n  private eventBroker?: EventBroker;\n\n  static fromConfig(env: {\n    config: Config;\n    logger: Logger;\n    scheduler: PluginTaskScheduler;\n  }): AwsSqsConsumingEventPublisher[] {\n    return readConfig(env.config).map(\n      config =>\n        new AwsSqsConsumingEventPublisher(env.logger, env.scheduler, config),\n    );\n  }\n\n  private constructor(\n    private readonly logger: Logger,\n    private readonly scheduler: PluginTaskScheduler,\n    config: AwsSqsEventSourceConfig,\n  ) {\n    this.topic = config.topic;\n\n    this.receiveParams = {\n      MaxNumberOfMessages: 10,\n      MessageAttributeNames: ['All'],\n      QueueUrl: config.queueUrl,\n      VisibilityTimeout: config.visibilityTimeout?.as('seconds'),\n      WaitTimeSeconds: config.pollingWaitTime.as('seconds'),\n    };\n\n    this.sqs = new SQSClient({\n      region: config.region,\n      endpoint: config.endpoint,\n    });\n    this.queueUrl = config.queueUrl;\n\n    this.taskTimeoutSeconds = config.timeout.as('seconds');\n    this.waitTimeAfterEmptyReceiveMs =\n      config.waitTimeAfterEmptyReceive.as('milliseconds');\n  }\n\n  async setEventBroker(eventBroker: EventBroker): Promise<void> {\n    this.eventBroker = eventBroker;\n    return this.start();\n  }\n\n  private async start(): Promise<void> {\n    const id = `events.awsSqs.publisher:${this.topic}`;\n    const logger = this.logger.child({\n      class: AwsSqsConsumingEventPublisher.prototype.constructor.name,\n      taskId: id,\n    });\n\n    await this.scheduler.scheduleTask({\n      id: id,\n      frequency: { seconds: 0 },\n      timeout: { seconds: this.taskTimeoutSeconds },\n      scope: 'local',\n      fn: async () => {\n        try {\n          const numMessages = await this.consumeMessages();\n          if (numMessages === 0) {\n            await this.sleep(this.waitTimeAfterEmptyReceiveMs);\n          }\n        } catch (error) {\n          logger.error('Failed to consume AWS SQS messages', error);\n        }\n      },\n    });\n  }\n\n  private async deleteMessages(messages?: Message[]): Promise<void> {\n    if (!messages) {\n      return;\n    }\n\n    const deleteParams = {\n      QueueUrl: this.queueUrl,\n      Entries: messages.map((message, index) => {\n        return {\n          Id: message.MessageId ?? `message-${index}`,\n          ReceiptHandle: message.ReceiptHandle,\n        };\n      }),\n    };\n\n    try {\n      const result = await this.sqs.send(\n        new DeleteMessageBatchCommand(deleteParams),\n      );\n      if (result.Failed) {\n        this.logger.error(\n          `Failed to delete ${result.Failed!.length} of ${\n            messages.length\n          } messages from AWS SQS ${this.queueUrl}. First: ${\n            result.Failed[0].Message\n          }`,\n        );\n      }\n    } catch (error) {\n      this.logger.error(\n        `Failed to delete message from AWS SQS ${this.queueUrl}`,\n        error,\n      );\n    }\n  }\n\n  private async consumeMessages(): Promise<number> {\n    try {\n      const data = await this.sqs.send(\n        new ReceiveMessageCommand(this.receiveParams),\n      );\n\n      data.Messages?.forEach(message => {\n        const eventPayload = JSON.parse(message.Body!);\n\n        const metadata: Record<string, string | string[]> = {};\n        Object.keys(message.MessageAttributes ?? {}).forEach(key => {\n          const attrValue = message.MessageAttributes![key];\n          if (\n            !attrValue ||\n            !attrValue.DataType ||\n            !['String', 'Number'].includes(attrValue.DataType)\n          ) {\n            return;\n          }\n\n          const value = attrValue.StringListValues ?? attrValue.StringValue;\n          if (value !== undefined) {\n            metadata[key] = value;\n          }\n        });\n\n        this.eventBroker!.publish({\n          topic: this.topic,\n          eventPayload,\n          metadata,\n        });\n      });\n      await this.deleteMessages(data.Messages);\n      return data.Messages?.length ?? 0;\n    } catch (error) {\n      this.logger.error(\n        `Failed to receive events from AWS SQS ${this.queueUrl}`,\n        error,\n      );\n      return 0;\n    }\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise<void>(resolve => setTimeout(resolve, ms));\n  }\n}\n"],"names":["Duration","_a","_b","SQSClient","DeleteMessageBatchCommand","ReceiveMessageCommand"],"mappings":"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"}