@othree.io/stethoscope 1.0.0 → 2.0.0

package/.gitlab-ci.yml

@@ -1,4 +1,4 @@
-image: node:14-alpine
+image: node:20
 
 cache:
   key: ${CI_PIPELINE_ID}
@@ -17,13 +17,13 @@ test:
     - npm test
 
 deploy:
-  image: node:20
+  image: node:22
   stage: deploy
   variables:
     NPM_CONFIG_USERCONFIG: '$CI_PROJECT_DIR/.npmrc'
   script:
     - cat $NPM > .npmrc
-    - npx semantic-release
+    - npx semantic-release@25
   only:
     refs:
       - main

package/README.md

@@ -1 +1,316 @@
-# stethoscope
+# @othree.io/stethoscope
+
+Structured SQS message processing for AWS Lambda handlers with error classification, exponential backoff, automatic DLQ routing, FIFO ordering support, and partial batch failure reporting.
+
+## Installation
+
+```bash
+npm install @othree.io/stethoscope
+```
+
+### Peer Dependencies
+
+```json
+{
+  "@othree.io/awsome": "^4.0.0",
+  "@othree.io/journal": "^2.0.0",
+  "@othree.io/optional": "^2.3.3",
+  "@aws-sdk/client-sqs": "^3.x"
+}
+```
+
+## Quick Start
+
+```typescript
+import { processSqs } from '@othree.io/stethoscope'
+import { SQSClient } from '@aws-sdk/client-sqs'
+import { TryAsync } from '@othree.io/optional'
+import { SQSRecord } from 'aws-lambda'
+
+type OrderInput = Readonly<{
+    orderId: string
+    amount: number
+}>
+
+type OrderResult = Readonly<{
+    orderId: string
+    status: string
+}>
+
+const sqsClient = new SQSClient({})
+
+export const handler = processSqs<OrderInput, OrderResult>({
+    sqsClient,
+    configuration: {
+        dlqUrl: process.env.DLQ_URL!,
+        exponentialTimeouts: [5, 10, 30],
+    },
+    didItFail: (error) => error.name !== 'RetryableError',
+    runProcess: async (input) => {
+        return TryAsync(async () => {
+            const result = await processOrder(input)
+            return result
+        })
+    },
+    getProcessInput: async (record) => {
+        return TryAsync(async () => JSON.parse(record.body))
+    },
+})
+```
+
+## API
+
+### `processSqs<Input, Output>(deps)`
+
+The main entry point. Wires up the full SQS processing pipeline and returns a Lambda handler function `(event: SQSEvent) => Promise<SQSBatchResponse>`.
+
+```typescript
+export const processSqs = <Input, Output>(deps: {
+    log?: Log
+    sqsClient: SQSClient
+    configuration: SQSProcessConfiguration
+    didItFail: (error: Error) => boolean
+    runProcess: (input: Input) => Promise<Optional<Output>>
+    getProcessInput: (record: SQSRecord) => Promise<Optional<Input>>
+}) => (event: SQSEvent) => Promise<SQSBatchResponse>
+```
+
+| Parameter | Description |
+|-----------|-------------|
+| `log` | Optional logging wrapper from `@othree.io/journal` (`logIOAsync`) |
+| `sqsClient` | AWS SDK v3 `SQSClient` instance |
+| `configuration` | DLQ URL and exponential backoff timeouts |
+| `didItFail` | Error classifier: return `true` for fatal errors (DLQ), `false` for retriable errors (retry with backoff) |
+| `runProcess` | Business logic handler. Return `Optional` with a value for success, `Empty()` for no-op, or throw for error classification |
+| `getProcessInput` | Extracts typed input from the raw `SQSRecord`. Return `Empty()` to mark the message as a failure. The original error from the Optional is preserved in the failure details |
+
+### `SQSProcessConfiguration`
+
+```typescript
+type SQSProcessConfiguration = Readonly<{
+    dlqUrl: string
+    exponentialTimeouts: Array<number>
+}>
+```
+
+- `dlqUrl` - The URL of the application-level Dead Letter Queue
+- `exponentialTimeouts` - Visibility timeout values (in seconds) indexed by receive count
+
+## Result Actions
+
+Every processed message is classified into one of four outcomes:
+
+| Action | Description | Behavior |
+|--------|-------------|----------|
+| `success` | `runProcess` returned a value | Message acknowledged (removed from queue) |
+| `none` | `runProcess` returned `Empty()` without an error | Message acknowledged |
+| `retry` | `didItFail` returned `false` for the error | Message returned to queue with exponential backoff |
+| `failure` | `didItFail` returned `true`, or `getProcessInput` returned `Empty()` | Error details sent to DLQ, message acknowledged |
+
+## Error Handling Flow
+
+```
+1. Message received from SQS
+2. getProcessInput extracts typed input
+   - Empty Optional -> failure (original error preserved, sent to DLQ)
+   - Valid input -> continue
+3. FIFO group check (if MessageGroupId is set)
+   - If a previous message in the same group is retrying
+     -> cascade retry (skip processing, return to queue)
+4. runProcess executes business logic
+   - Returns value -> success (acknowledged)
+   - Returns Empty() -> none (acknowledged)
+   - Throws error -> continue to classification
+5. didItFail classifies the error
+   - Returns true -> failure (sent to DLQ)
+   - Returns false -> retry (back to queue with backoff)
+6. SQSBatchResponse returned to Lambda runtime
+   - Only retry messages included in batchItemFailures (using messageId)
+```
+
+## Exponential Backoff
+
+The `exponentialTimeouts` array controls the SQS visibility timeout progression. The timeout is selected using the message's `ApproximateReceiveCount` attribute:
+
+```typescript
+exponentialTimeouts: [5, 10, 30]
+```
+
+| Receive Count | Visibility Timeout |
+|---------------|-------------------|
+| 1             | 5 seconds         |
+| 2             | 10 seconds        |
+| 3+            | 30 seconds (clamped to last value) |
+
+## FIFO Queue Support
+
+Stethoscope groups messages by `MessageGroupId` and processes them sequentially within each group:
+
+- Messages without a `MessageGroupId` are treated as ungrouped
+- Within a group, if a message is classified as `retry`, all subsequent messages in that group are also retried
+- Fatal failures (`failure`) do not cascade — since the message is sent to the DLQ and won't be retried, processing continues for the remaining messages in the group
+- This preserves message ordering guarantees required by FIFO queues
+
+## Using with Logging
+
+Pass `logIOAsync` from `@othree.io/journal` to automatically log inputs, outputs, and errors for each processing step:
+
+```typescript
+import { processSqs } from '@othree.io/stethoscope'
+import { logIOAsync } from '@othree.io/journal'
+
+const log = logIOAsync({
+    now: () => Date.now(),
+    log: logger.info.bind(logger),
+    logError: logger.error.bind(logger),
+})
+
+export const handler = processSqs<MyInput, MyOutput>({
+    log,
+    sqsClient,
+    configuration,
+    didItFail,
+    runProcess,
+    getProcessInput,
+})
+```
+
+## Common Patterns
+
+### Classifying Errors
+
+```typescript
+const didItFail = (error: Error): boolean => {
+    const retryableErrors = ['TimeoutError', 'ServiceUnavailableError', 'ThrottlingError']
+    return !retryableErrors.includes(error.name)
+}
+```
+
+### Parsing SNS-wrapped Messages
+
+When SQS is subscribed to an SNS topic, the record body contains an SNS envelope:
+
+```typescript
+const getProcessInput = async (record: SQSRecord): Promise<Optional<MyInput>> => {
+    return TryAsync(async () => {
+        const snsMessage = JSON.parse(record.body)
+        return JSON.parse(snsMessage.Message)
+    })
+}
+```
+
+## Infrastructure Requirements
+
+Stethoscope handles message processing logic, but the AWS infrastructure must be configured correctly for retry and failure handling to work.
+
+### Architecture
+
+```
+                                    +-----------------+
+                                    |   SNS Topic     |
+                                    | (event source)  |
+                                    +--------+--------+
+                                             |
+                                             v
++------------------+              +---------------------+
+|   Redrive DLQ    | <----------  |   Events Queue      |
+| (max receive     |   redrive    | (main processing)   |
+|  count exceeded) |   policy     |                     |
++------------------+              +----------+----------+
+                                             |
+                                             | SQS Event Source
+                                             v
+                                  +---------------------+
+                                  |  Lambda Handler     |
+                                  |  (stethoscope)      |
+                                  +----------+----------+
+                                             |
+                                             | explicit send on failure
+                                             v
+                                  +---------------------+
+                                  |   Application DLQ   |
+                                  | (business failures) |
+                                  +---------------------+
+```
+
+### Two DLQ Mechanisms
+
+You need **two separate dead letter queues**:
+
+1. **Application DLQ** - For messages that stethoscope explicitly marks as failures
+   - Receives messages when `didItFail` returns `true` or when `getProcessInput` returns `Empty()`
+   - Contains the original SQS record and serialized error details
+   - Lambda must have `sqs:SendMessage` permission to this queue
+
+2. **Redrive DLQ** - For messages that exceed the queue's max receive count
+   - Configured via the events queue's redrive policy
+   - Catches messages that keep timing out or causing Lambda crashes
+   - Acts as a safety net for infrastructure-level failures
+
+### CDK Example
+
+```typescript
+import { Queue } from 'aws-cdk-lib/aws-sqs'
+import { SqsEventSource } from 'aws-cdk-lib/aws-lambda-event-sources'
+import { Duration } from 'aws-cdk-lib'
+
+// Application-level DLQ (stethoscope sends failures here)
+const dlq = new Queue(this, 'DLQ', {
+    queueName: 'my-service-dlq',
+})
+
+// Infrastructure-level DLQ (max receive count exceeded)
+const redriveDlq = new Queue(this, 'RedriveDLQ', {
+    queueName: 'my-service-redrive-dlq',
+})
+
+// Main processing queue with redrive policy
+const eventsQueue = new Queue(this, 'EventsQueue', {
+    queueName: 'my-service-events',
+    visibilityTimeout: Duration.seconds(30),
+    deadLetterQueue: {
+        queue: redriveDlq,
+        maxReceiveCount: 4,
+    },
+})
+
+// Lambda handler
+const handler = new Function(this, 'Handler', {
+    // ... function configuration
+    environment: {
+        DLQ_URL: dlq.queueUrl,
+    },
+})
+
+// Grant permissions
+dlq.grantSendMessages(handler)
+eventsQueue.grantConsumeMessages(handler)
+
+// Configure SQS event source
+handler.addEventSource(new SqsEventSource(eventsQueue, {
+    batchSize: 10,
+    maxConcurrency: 10,
+    reportBatchItemFailures: true,
+    enabled: true,
+}))
+```
+
+### Critical: `reportBatchItemFailures`
+
+The SQS event source mapping **must** have `reportBatchItemFailures: true`. This setting enables partial batch failure reporting via `SQSBatchResponse`. Without it, any single failure causes the entire batch to be retried.
+
+### IAM Permissions
+
+The Lambda execution role needs:
+
+- `sqs:SendMessage` on the application DLQ (for sending failure details)
+- `sqs:ChangeMessageVisibility` on the events queue (for exponential backoff). This is included in `grantConsumeMessages`
+
+## Peer Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| `@othree.io/awsome` | SQS operations (send to DLQ, change message visibility, queue URL resolution) |
+| `@othree.io/journal` | Optional structured logging for processing steps |
+| `@othree.io/optional` | `Optional<T>` monad for safe error handling and result classification |
+| `@aws-sdk/client-sqs` | AWS SQS client |

package/lib/cjs/aws.d.ts

@@ -0,0 +1,50 @@
+import { SQSBatchResponse, SQSEvent, SQSRecord } from 'aws-lambda';
+import { Optional } from '@othree.io/optional';
+import { GetProcessResults, ProcessResultAction, ProcessResults } from './results-processor';
+import { sqs } from '@othree.io/awsome';
+export declare const NoGroupSymbol: unique symbol;
+export type RunProcess<Input, Output> = (input: Input) => Promise<Optional<Output>>;
+export type Key = string | symbol;
+export type MessageResult<Input, Output> = Readonly<{
+    message: SQSRecord;
+    result: ProcessResults<Input, Output>;
+}>;
+export type Results<Input, Output> = Readonly<{
+    [key in ProcessResultAction]: Array<MessageResult<Input, Output>>;
+}>;
+export type GroupResults<Input, Output> = Readonly<{
+    group: Key;
+    results: Results<Input, Output>;
+}>;
+export type GroupedRecords = Record<Key, Array<SQSRecord>>;
+export declare const groupRecords: (records: Array<SQSRecord>) => GroupedRecords;
+export declare const processSQSEvent: <Input, Output>(deps: {
+    process: RunProcess<Input, Output>;
+    groupRecords: (records: Array<SQSRecord>) => GroupedRecords;
+    getProcessInput: RunProcess<SQSRecord, Input>;
+    getProcessResults: GetProcessResults<Input, Output>;
+}) => (event: SQSEvent) => Promise<Array<GroupResults<Input, Output>>>;
+export declare const handleExponentialBackoff: <Input, Output>(deps: {
+    changeMessageVisibility: (request: sqs.ChangeMessageVisibilityTimeoutRequest) => Promise<Optional<true>>;
+    getQueueUrl: (input: sqs.GetQueueUrlInput) => Optional<sqs.QueueUrlOutput>;
+    timeouts: Array<number>;
+}) => (groupResults: Array<GroupResults<Input, Output>>) => Promise<Array<GroupResults<Input, Output>>>;
+export type ErrorMessage<Input> = Readonly<{
+    request: Input;
+    error: Readonly<{
+        name: string;
+        message: string;
+        stack?: string;
+    }>;
+}>;
+export declare const handleErrors: <Input, Output>(deps: {
+    notifyError: (payload: ErrorMessage<SQSRecord>) => Promise<Optional<boolean>>;
+}) => (groupResults: Array<GroupResults<Input, Output>>) => Promise<Array<GroupResults<Input, Output>>>;
+export declare const toSQSBatchResponse: <Input, Output>(groupResults: Array<GroupResults<Input, Output>>) => Promise<SQSBatchResponse>;
+export declare const processSQSEventAndHandleResults: <Input, Output>(deps: {
+    processSQSEvent: (event: SQSEvent) => Promise<Array<GroupResults<Input, Output>>>;
+    handleExponentialBackoff: (groupResults: Array<GroupResults<Input, Output>>) => Promise<Array<GroupResults<Input, Output>>>;
+    handleErrors: (groupResults: Array<GroupResults<Input, Output>>) => Promise<Array<GroupResults<Input, Output>>>;
+    toSQSBatchResponse: (groupResults: Array<GroupResults<Input, Output>>) => Promise<SQSBatchResponse>;
+}) => (event: SQSEvent) => Promise<SQSBatchResponse>;
+//# sourceMappingURL=aws.d.ts.map

package/lib/cjs/aws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws.d.ts","sourceRoot":"","sources":["../../src/aws.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAC,MAAM,YAAY,CAAA;AAChE,OAAO,EAAC,QAAQ,EAAC,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EACH,iBAAiB,EAEjB,mBAAmB,EACnB,cAAc,EACjB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAC,GAAG,EAAC,MAAM,mBAAmB,CAAA;AAErC,eAAO,MAAM,aAAa,EAAE,OAAO,MAAgC,CAAA;AAInE,MAAM,MAAM,UAAU,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;AAEnF,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,CAAA;AAEjC,MAAM,MAAM,aAAa,CAAC,KAAK,EAAE,MAAM,IAAI,QAAQ,CAAC;IAChD,OAAO,EAAE,SAAS,CAAA;IAClB,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CACxC,CAAC,CAAA;AAEF,MAAM,MAAM,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,QAAQ,CAAC;KACzC,GAAG,IAAI,mBAAmB,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;CACpE,CAAC,CAAA;AAEF,MAAM,MAAM,YAAY,CAAC,KAAK,EAAE,MAAM,IAAI,QAAQ,CAAC;IAC/C,KAAK,EAAE,GAAG,CAAA;IACV,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CAClC,CAAC,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;AAkB1D,eAAO,MAAM,YAAY,GAAI,SAAS,KAAK,CAAC,SAAS,CAAC,KAAG,cAexD,CAAA;AAYD,eAAO,MAAM,eAAe,GAAI,KAAK,EAAE,MAAM,EAAE,MAAM;IACjD,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAClC,YAAY,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,cAAc,CAAA;IAC3D,eAAe,EAAE,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IAC7C,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CACtD,MACU,OAAO,QAAQ,KAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CA4ElE,CAAA;AAEL,eAAO,MAAM,wBAAwB,GAAI,KAAK,EAAE,MAAM,EAAE,MAAM;IAC1D,uBAAuB,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,qCAAqC,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IACxG,WAAW,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,gBAAgB,KAAK,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IAC1E,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAC1B,MACU,cAAc,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAqBnG,CAAA;AAEL,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI,QAAQ,CAAC;IACvC,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE,QAAQ,CAAC;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;KACjB,CAAC,CAAA;CACL,CAAC,CAAA;AAEF,eAAO,MAAM,YAAY,GAAI,KAAK,EAAE,MAAM,EAAE,MAAM;IAC9C,WAAW,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;CAChF,MACU,cAAc,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAenG,CAAA;AAEL,eAAO,MAAM,kBAAkB,GAAU,KAAK,EAAE,MAAM,EAAE,cAAc,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAG,OAAO,CAAC,gBAAgB,CAUlI,CAAA;AAED,eAAO,MAAM,+BAA+B,GAAI,KAAK,EAAE,MAAM,EAAE,MAAM;IACjE,eAAe,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACjF,wBAAwB,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC3H,YAAY,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC/G,kBAAkB,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;CACtG,MACU,OAAO,QAAQ,KAAG,OAAO,CAAC,gBAAgB,CAKhD,CAAA"}

package/lib/cjs/aws.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processSQSEventAndHandleResults = exports.toSQSBatchResponse = exports.handleErrors = exports.handleExponentialBackoff = exports.processSQSEvent = exports.groupRecords = exports.NoGroupSymbol = void 0;
+const optional_1 = require("@othree.io/optional");
+const results_processor_1 = require("./results-processor");
+exports.NoGroupSymbol = Symbol('NoGroupSymbol');
+const LIMIT = 10;
+const InitialValue = Object.freeze({});
+const appendToResults = (accumulated, action, messageResult) => {
+    return {
+        none: accumulated.none,
+        success: accumulated.success,
+        failure: accumulated.failure,
+        retry: accumulated.retry,
+        [action]: [].concat(accumulated[action], messageResult),
+    };
+};
+const groupRecords = (records) => {
+    const groupedRecords = records.reduce(((acum, current) => {
+        const key = (0, optional_1.Optional)(current.attributes.MessageGroupId).orElse(exports.NoGroupSymbol);
+        const existing = (0, optional_1.Optional)(acum[key]);
+        const updated = existing
+            .map(_ => [].concat(_, current))
+            .orElse([current]);
+        const result = {};
+        Reflect.ownKeys(acum).forEach(k => { result[k] = acum[k]; });
+        result[key] = updated;
+        return result;
+    }), InitialValue);
+    return groupedRecords;
+};
+exports.groupRecords = groupRecords;
+const processInBatches = async (items, limit, fn) => {
+    const results = [];
+    for (let i = 0; i < items.length; i += limit) {
+        const batch = items.slice(i, i + limit);
+        const batchResults = await Promise.all(batch.map(fn));
+        results.push(...batchResults);
+    }
+    return results;
+};
+const processSQSEvent = (deps) => async (event) => {
+    const groupedRecords = deps.groupRecords(event.Records);
+    const groupedResults = await processInBatches(Reflect.ownKeys(groupedRecords), LIMIT, async (key) => {
+        const values = groupedRecords[key];
+        let accumulated = {
+            [results_processor_1.ProcessResultAction.none]: [],
+            [results_processor_1.ProcessResultAction.failure]: [],
+            [results_processor_1.ProcessResultAction.success]: [],
+            [results_processor_1.ProcessResultAction.retry]: [],
+        };
+        for (const current of values) {
+            const maybeInput = await deps.getProcessInput(current);
+            if (maybeInput.isEmpty) {
+                const processResult = {
+                    request: undefined,
+                    action: results_processor_1.ProcessResultAction.failure,
+                    result: undefined,
+                    error: (0, optional_1.Optional)(maybeInput.getError()).orElse(new Error('Failed to get input')),
+                };
+                const messageResult = {
+                    message: current,
+                    result: processResult,
+                };
+                accumulated = appendToResults(accumulated, processResult.action, messageResult);
+                continue;
+            }
+            const input = maybeInput.get();
+            /*
+                if it is an actual grouped message it means it's a fifo queue and
+                if there's already a message for retry (retry action) on a previous message
+                then next messages need to be retried.
+                Return retry so that the message is placed back into the queue
+             */
+            if (key !== exports.NoGroupSymbol && accumulated.retry.length > 0) {
+                const messageResult = {
+                    message: current,
+                    result: {
+                        request: maybeInput.orElse(undefined),
+                        action: results_processor_1.ProcessResultAction.retry,
+                        result: undefined,
+                        error: undefined,
+                    },
+                };
+                accumulated = appendToResults(accumulated, messageResult.result.action, messageResult);
+                continue;
+            }
+            const processResult = await deps.process(input)
+                .then(maybeResult => deps.getProcessResults(input, maybeResult));
+            const messageResult = {
+                message: current,
+                result: processResult,
+            };
+            accumulated = appendToResults(accumulated, processResult.action, messageResult);
+        }
+        const groupResults = {
+            group: key,
+            results: accumulated,
+        };
+        return groupResults;
+    });
+    return groupedResults;
+};
+exports.processSQSEvent = processSQSEvent;
+const handleExponentialBackoff = (deps) => async (groupResults) => {
+    await Promise.allSettled(groupResults.map(async (results) => {
+        for (const messageResult of results.results.retry) {
+            const receiveCount = Number(messageResult.message.attributes.ApproximateReceiveCount);
+            const timeoutIndex = receiveCount - 1 >= deps.timeouts.length ? deps.timeouts.length - 1 : receiveCount - 1;
+            const visibilityTimeout = deps.timeouts[timeoutIndex];
+            await deps.getQueueUrl({
+                queueArn: messageResult.message.eventSourceARN
+            }).mapAsync(async (queueUrlOutput) => {
+                await deps.changeMessageVisibility({
+                    receiptHandle: messageResult.message.receiptHandle,
+                    queue: queueUrlOutput.queueUrl,
+                    timeout: visibilityTimeout,
+                });
+            });
+        }
+    }));
+    return groupResults;
+};
+exports.handleExponentialBackoff = handleExponentialBackoff;
+const handleErrors = (deps) => async (groupResults) => {
+    await Promise.allSettled(groupResults.map(async (results) => {
+        for (const messageResult of results.results.failure) {
+            await deps.notifyError({
+                request: messageResult.message,
+                error: {
+                    message: messageResult.result.error.message,
+                    name: messageResult.result.error.name,
+                    stack: messageResult.result.error.stack,
+                },
+            });
+        }
+    }));
+    return groupResults;
+};
+exports.handleErrors = handleErrors;
+const toSQSBatchResponse = async (groupResults) => {
+    return {
+        batchItemFailures: groupResults.map(_ => _.results.retry)
+            .flat()
+            .map(_ => {
+            return {
+                itemIdentifier: _.message.messageId,
+            };
+        }),
+    };
+};
+exports.toSQSBatchResponse = toSQSBatchResponse;
+const processSQSEventAndHandleResults = (deps) => async (event) => {
+    return deps.processSQSEvent(event)
+        .then(deps.handleErrors)
+        .then(deps.handleExponentialBackoff)
+        .then(deps.toSQSBatchResponse);
+};
+exports.processSQSEventAndHandleResults = processSQSEventAndHandleResults;
+//# sourceMappingURL=aws.js.map

package/lib/cjs/aws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws.js","sourceRoot":"","sources":["../../src/aws.ts"],"names":[],"mappings":"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"}

package/lib/cjs/index.d.ts

@@ -0,0 +1,20 @@
+import { RunProcess } from './aws';
+import { SQSRecord } from 'aws-lambda';
+import { SQSClient } from '@aws-sdk/client-sqs';
+import { LoggingProps } from '@othree.io/journal';
+export * from './results-processor';
+export * as aws from './aws';
+export type SQSProcessConfiguration = Readonly<{
+    dlqUrl: string;
+    exponentialTimeouts: Array<number>;
+}>;
+type Log = <Input, Output>(fn: (...args: Array<Input>) => Promise<Output>) => (context: string, loggingProps?: LoggingProps) => (...args: Array<Input>) => Promise<Output>;
+export declare const processSqs: <Input, Output>(deps: {
+    log?: Log;
+    sqsClient: SQSClient;
+    configuration: SQSProcessConfiguration;
+    didItFail: (error: Error) => boolean;
+    runProcess: RunProcess<Input, Output>;
+    getProcessInput: RunProcess<SQSRecord, Input>;
+}) => (event: import("aws-lambda").SQSEvent) => Promise<import("aws-lambda").SQSBatchResponse>;
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAOH,UAAU,EAEb,MAAM,OAAO,CAAA;AACd,OAAO,EAAC,SAAS,EAAC,MAAM,YAAY,CAAA;AAEpC,OAAO,EAAC,SAAS,EAAC,MAAM,qBAAqB,CAAA;AAE7C,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAA;AAG/C,cAAc,qBAAqB,CAAA;AACnC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAA;AAE5B,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CACrC,CAAC,CAAA;AAEF,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAQ1K,eAAO,MAAM,UAAU,GAAI,KAAK,EAAE,MAAM,EAAE,MAAM;IAC5C,GAAG,CAAC,EAAE,GAAG,CAAA;IACT,SAAS,EAAE,SAAS,CAAA;IACpB,aAAa,EAAE,uBAAuB,CAAA;IACtC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACpC,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACrC,eAAe,EAAE,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;CAChD,6FAqDA,CAAA"}

package/lib/cjs/index.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processSqs = exports.aws = void 0;
+const aws_1 = require("./aws");
+const results_processor_1 = require("./results-processor");
+const optional_1 = require("@othree.io/optional");
+const awsome_1 = require("@othree.io/awsome");
+__exportStar(require("./results-processor"), exports);
+exports.aws = require("./aws");
+const wrapWithLog = (maybeLog, fn, name) => {
+    return maybeLog
+        .map(_ => _(fn)(name))
+        .orElse(fn);
+};
+const processSqs = (deps) => {
+    const maybeLog = (0, optional_1.Optional)(deps.log);
+    const processSQSEventFn = wrapWithLog(maybeLog, (0, aws_1.processSQSEvent)({
+        process: deps.runProcess,
+        groupRecords: aws_1.groupRecords,
+        getProcessInput: deps.getProcessInput,
+        getProcessResults: (0, results_processor_1.getProcessResults)({ didItFail: deps.didItFail }),
+    }), 'processSQSEvent');
+    const changeMessageVisibilityTimeout = wrapWithLog(maybeLog, awsome_1.sqs.changeMessageVisibilityTimeout({ client: deps.sqsClient }), 'changeMessageVisibilityTimeout');
+    const handleExponentialBackoffFn = wrapWithLog(maybeLog, (0, aws_1.handleExponentialBackoff)({
+        changeMessageVisibility: changeMessageVisibilityTimeout,
+        getQueueUrl: awsome_1.sqs.getQueueUrl,
+        timeouts: deps.configuration.exponentialTimeouts,
+    }), 'handleExponentialBackoff');
+    const sendDLQMessage = awsome_1.sqs.send({
+        client: deps.sqsClient,
+        configuration: { QueueUrl: deps.configuration.dlqUrl },
+    });
+    const handleErrorsFn = wrapWithLog(maybeLog, (0, aws_1.handleErrors)({
+        notifyError: sendDLQMessage,
+    }), 'handleErrors');
+    return wrapWithLog(maybeLog, (0, aws_1.processSQSEventAndHandleResults)({
+        processSQSEvent: processSQSEventFn,
+        handleExponentialBackoff: handleExponentialBackoffFn,
+        handleErrors: handleErrorsFn,
+        toSQSBatchResponse: aws_1.toSQSBatchResponse,
+    }), 'processSQSEventAndHandleResults');
+};
+exports.processSqs = processSqs;
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+BASc;AAEd,2DAAqD;AAErD,kDAA4C;AAE5C,8CAAqC;AAErC,sDAAmC;AACnC,+BAA4B;AAS5B,MAAM,WAAW,GAAG,CAAI,QAAuB,EAAE,EAAK,EAAE,IAAY,EAAK,EAAE;IACvE,OAAO,QAAQ;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAS,CAAC,CAAC,IAAI,CAAM,CAAC;SACjC,MAAM,CAAC,EAAE,CAAC,CAAA;AACnB,CAAC,CAAA;AAEM,MAAM,UAAU,GAAG,CAAgB,IAOzC,EAAE,EAAE;IACD,MAAM,QAAQ,GAAG,IAAA,mBAAQ,EAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEnC,MAAM,iBAAiB,GAAG,WAAW,CACjC,QAAQ,EACR,IAAA,qBAAe,EAAgB;QAC3B,OAAO,EAAE,IAAI,CAAC,UAAU;QACxB,YAAY,EAAZ,kBAAY;QACZ,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,iBAAiB,EAAE,IAAA,qCAAiB,EAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACtE,CAAC,EACF,iBAAiB,CACpB,CAAA;IAED,MAAM,8BAA8B,GAAG,WAAW,CAC9C,QAAQ,EACR,YAAG,CAAC,8BAA8B,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,EAC9D,gCAAgC,CACnC,CAAA;IAED,MAAM,0BAA0B,GAAG,WAAW,CAC1C,QAAQ,EACR,IAAA,8BAAwB,EAAgB;QACpC,uBAAuB,EAAE,8BAA8B;QACvD,WAAW,EAAE,YAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,mBAAmB;KACnD,CAAC,EACF,0BAA0B,CAC7B,CAAA;IAED,MAAM,cAAc,GAAG,YAAG,CAAC,IAAI,CAA0B;QACrD,MAAM,EAAE,IAAI,CAAC,SAAS;QACtB,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE;KACzD,CAAC,CAAA;IAEF,MAAM,cAAc,GAAG,WAAW,CAC9B,QAAQ,EACR,IAAA,kBAAY,EAAgB;QACxB,WAAW,EAAE,cAAc;KAC9B,CAAC,EACF,cAAc,CACjB,CAAA;IAED,OAAO,WAAW,CACd,QAAQ,EACR,IAAA,qCAA+B,EAAgB;QAC3C,eAAe,EAAE,iBAAiB;QAClC,wBAAwB,EAAE,0BAA0B;QACpD,YAAY,EAAE,cAAc;QAC5B,kBAAkB,EAAlB,wBAAkB;KACrB,CAAC,EACF,iCAAiC,CACpC,CAAA;AACL,CAAC,CAAA;AA5DY,QAAA,UAAU,cA4DtB"}