@lafken/queue 0.11.15 → 0.11.17

package/lib/main/queue/queue.types.d.ts

@@ -8,6 +8,16 @@ import type { LambdaMetadata, LambdaProps, QueueNames, QueueReferenceNames, Reso
  * - `url`: Same as `id`: the URL for the created Amazon SQS queue.
  */
 export type QueueOutputAttributes = 'arn' | 'id' | 'url';
+export interface DlqProps {
+    /**
+     * Maximum number of times a message can be received before being moved to the DLQ.
+     */
+    maxReceiveCount: number;
+    /**
+     * Message retention period in seconds for the DLQ.
+     */
+    retentionPeriod?: number;
+}
 export interface StandardProps {
     /**
      * Delivery delay in seconds.
@@ -96,6 +106,14 @@ export interface StandardProps {
      * ref: 'order'
      */
     ref?: QueueReferenceNames;
+    /**
+     * Dead Letter Queue configuration.
+     *
+     * When specified, a DLQ is created and the main queue is configured
+     * with a redrive policy to move unprocessable messages after the defined
+     * number of receive attempts.
+     */
+    dlq?: DlqProps;
 }
 export interface FifoProps extends StandardProps {
     /**

package/lib/resolver/queue/queue.d.ts

@@ -11,6 +11,7 @@ declare const Queue_base: (new (...args: any[]) => {
 export declare class Queue extends Queue_base {
     private props;
     constructor(scope: AppModule, id: string, props: QueueProps);
+    private addDeadLetterQueue;
     private addEventSource;
     private validateEventParams;
     private getParams;

package/lib/resolver/queue/queue.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Queue = void 0;
 const lambda_event_source_mapping_1 = require("@cdktn/provider-aws/lib/lambda-event-source-mapping");
 const sqs_queue_1 = require("@cdktn/provider-aws/lib/sqs-queue");
+const sqs_queue_redrive_policy_1 = require("@cdktn/provider-aws/lib/sqs-queue-redrive-policy");
 const common_1 = require("@lafken/common");
 const resolver_1 = require("@lafken/resolver");
+const queue_utils_1 = require("./queue.utils");
 const attributeAllowedTypes = new Set(['String', 'Number']);
 const bodyParsedTypes = new Set(['String', 'Object', 'Array']);
 const bodyUnparsedTypes = new Set(['String']);
@@ -13,7 +15,7 @@ class Queue extends resolver_1.lafkenResource.make(sqs_queue_1.SqsQueue) {
     constructor(scope, id, props) {
         const { handler } = props;
         super(scope, `${id}-queue`, {
-            name: `${handler.queueName}${handler.isFifo ? '.fifo' : ''}`,
+            name: (0, queue_utils_1.sqsName)(handler.queueName, handler.isFifo ? '.fifo' : ''),
             fifoQueue: handler.isFifo,
             contentBasedDeduplication: handler.contentBasedDeduplication,
             visibilityTimeoutSeconds: handler.visibilityTimeout,
@@ -25,10 +27,29 @@ class Queue extends resolver_1.lafkenResource.make(sqs_queue_1.SqsQueue) {
         if (handler.ref) {
             this.register('queue', handler.ref);
         }
+        this.addDeadLetterQueue(id);
         this.validateEventParams();
         this.addEventSource(id);
         new resolver_1.ResourceOutput(this, handler.outputs);
     }
+    addDeadLetterQueue(id) {
+        const { handler } = this.props;
+        if (!handler.dlq)
+            return;
+        const dlqName = (0, queue_utils_1.sqsName)(handler.queueName, `-dlq${handler.isFifo ? '.fifo' : ''}`);
+        const dlq = new sqs_queue_1.SqsQueue(this, `${id}-dlq`, {
+            name: dlqName,
+            fifoQueue: handler.isFifo,
+            messageRetentionSeconds: handler.dlq.retentionPeriod,
+        });
+        new sqs_queue_redrive_policy_1.SqsQueueRedrivePolicy(this, `${id}-redrive-policy`, {
+            queueUrl: this.url,
+            redrivePolicy: JSON.stringify({
+                deadLetterTargetArn: dlq.arn,
+                maxReceiveCount: handler.dlq.maxReceiveCount,
+            }),
+        });
+    }
     addEventSource(id) {
         const { handler, resourceMetadata } = this.props;
         const lambdaHandler = new resolver_1.LambdaHandler(this, `${id}-handler`, {
@@ -77,9 +98,6 @@ class Queue extends resolver_1.lafkenResource.make(sqs_queue_1.SqsQueue) {
         if (param.source === 'attribute' && !attributeAllowedTypes.has(param.type)) {
             throw new Error(`Attribute params only support ${[...attributeAllowedTypes].join(', ')} values`);
         }
-        if (param.source === 'body' && param.parse && !bodyParsedTypes.has(param.type)) {
-            throw new Error(`Body params only support ${[...bodyParsedTypes].join(', ')} values`);
-        }
         if (param?.source === 'body' && !param.parse && !bodyUnparsedTypes.has(param.type)) {
             throw new Error(`Body params only support ${[...bodyUnparsedTypes].join(', ')} values`);
         }

package/lib/resolver/queue/queue.utils.d.ts

@@ -0,0 +1 @@
+export declare function sqsName(base: string, suffix: string): string;

package/lib/resolver/queue/queue.utils.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sqsName = sqsName;
+function sqsName(base, suffix) {
+    return base.slice(0, 80 - suffix.length) + suffix;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lafken/queue",
-  "version": "0.11.15",
+  "version": "0.11.17",
   "private": false,
   "description": "Define SQS queues and consumers using TypeScript decorators - automatic infrastructure generation with Lafken",
   "keywords": [
@@ -55,7 +55,7 @@
     "@aws-sdk/client-sqs": "^3.1037.0",
     "aws-lambda": "^1.0.7",
     "reflect-metadata": "^0.2.2",
-    "@lafken/resolver": "0.11.15"
+    "@lafken/resolver": "0.11.17"
   },
   "devDependencies": {
     "@cdktn/provider-aws": "^23.9.0",
@@ -69,13 +69,13 @@
     "typescript": "6.0.3",
     "unplugin-swc": "^1.5.9",
     "vitest": "^4.1.5",
-    "@lafken/common": "0.11.15"
+    "@lafken/common": "0.11.17"
   },
   "peerDependencies": {
     "@cdktn/provider-aws": ">=23.0.0",
     "cdktn": ">=0.22.0",
     "constructs": "^10.4.5",
-    "@lafken/common": "0.11.15"
+    "@lafken/common": "0.11.17"
   },
   "engines": {
     "node": ">=20.19"