@beesolve/sqs-handler 0.1.6 → 0.1.8

package/README.md

@@ -2,7 +2,7 @@
 
 ## Installation
 
-Install the latest version of package and its peer dependencies.
+Install the latest version of package:
 
 ```bash
 npm i @beesolve/sqs-handler
@@ -10,4 +10,38 @@ npm i @beesolve/sqs-handler
 
 ## Usage
 
-todo
+Create `tasks.ts` file in your server application, which defines your handlers.
+
+```ts
+import { createSqsHandlers } from "@beesolve/sqs-handler";
+import { SQSClient } from "@aws-sdk/client-sqs";
+
+export const [handler, tasks] = createSqsHandlers({
+  fifo: false, // you can create either fifo or standard queues
+  sqsClient: new SQSClient(), // provide SQS client
+  queueUrl: process.env.BEESOLVE_TASKS_QUEUE_URL!, // BEESOLVE_TASKS_QUEUE_URL env variable will be automatically injected to your Lambda function
+  functions: {
+    // here goes your functions
+    test: async (payload: any) => {
+      console.log({ payload });
+    },
+  },
+});
+```
+
+Create `SqsHandler` instance with CDK.
+
+```ts
+import { SqsHandler } from "@beesolve/sqs-handler/cdk";
+
+const sqsHandler = new SqsHandler(stack, "SqsHandler", {
+  entry: resolve(`src/lib/server/tasks.ts`), // path to your `tasks.ts` file
+  handlerProps: {
+    memorySize: 1024,
+    timeout: Duration.seconds(5),
+  },
+  alarms,
+});
+
+sqsHandler.grantAccess(handler);
+```

package/dist/cdk.d.ts

@@ -8,10 +8,18 @@ interface SqsHandlerProps {
 	*/
 	readonly entry: string;
 	/**
-	* @default false
+	* When you provide instance of EmailAlarms alarm for your SQS queues and Lambda handler will be set up automatically.
+	*/
+	readonly alarms?: EmailAlarms;
+	/**
+	* You can change default memorySize and timeout here.
+	*
+	* @default
+	* {
+	*    memorySize: 1024,
+	*    timeout: Duration.seconds(30)
+	* }
 	*/
-	readonly isProd?: boolean;
-	readonly alarms: EmailAlarms;
 	readonly handlerProps?: Pick<NodejsFunctionProps, "memorySize" | "timeout">;
 }
 declare class SqsHandler extends Construct {

package/dist/cdk.js

@@ -1,7 +1,9 @@
 // packages/sqs-handler/cdk.ts
-import { SqsWithDlq } from "@beesolve/cdk-constructs";
+import {
+  nodejsFunctionDefaultConfig,
+  SqsWithDlq
+} from "@beesolve/cdk-constructs";
 import { Duration } from "aws-cdk-lib";
-import { Architecture, Runtime } from "aws-cdk-lib/aws-lambda";
 import {
   NodejsFunction
 } from "aws-cdk-lib/aws-lambda-nodejs";
@@ -14,29 +16,23 @@ class SqsHandler extends Construct {
   handler;
   constructor(scope, id, props) {
     super(scope, id);
-    const { isProd = false, handlerProps = {} } = props;
+    const { handlerProps = {} } = props;
     this.handler = new NodejsFunction(this, "QueueHandler", {
-      description: "Tasks queue handler",
+      description: `${id} queue handler`,
       entry: resolve(__dirname, props.entry),
       handler: "handler",
-      bundling: {
-        minify: isProd,
-        sourceMap: isProd,
-        sourcesContent: false,
-        target: "es2022"
-      },
       memorySize: 1024,
       timeout: Duration.seconds(30),
-      runtime: Runtime.NODEJS_24_X,
-      architecture: Architecture.ARM_64,
-      depsLockFilePath: resolve(`${__dirname}/../../bun.lock`),
+      bundling: nodejsFunctionDefaultConfig.bundling,
+      ...nodejsFunctionDefaultConfig.runtime,
       ...handlerProps
     });
     this.queue = SqsWithDlq.asLambdaInput({
       lambda: this.handler
     });
     this.handler.addEnvironment("BEESOLVE_TASKS_QUEUE_URL", this.queue.queue.queueUrl);
-    props.alarms.reportSqsErrors(this.queue);
+    props.alarms?.reportSqsErrors(this.queue);
+    props.alarms?.reportLambdaErrors(this.handler);
   }
   grantAccess = (grantee) => {
     this.queue.queue.grantSendMessages(grantee);

package/dist/index.js

@@ -15,9 +15,9 @@ function createSqsHandlers(props) {
           args: v.array(v.any())
         })), body);
         if (!result.success)
-          throw new Error(`Wrong message format: ${prettyPrint(v.flatten(result.issues))}`);
+          throw new Error(`Wrong message format: ${JSON.stringify(v.flatten(result.issues))}`);
         const { fn, args } = result.output;
-        console.info(prettyPrint({ function: fn, arguments: args }));
+        console.info(JSON.stringify({ function: fn, arguments: args }));
         await props.functions[fn]?.(...args.map((args2) => decodeFromStringifiable(args2)));
       } catch (error) {
         console.error(error);
@@ -35,7 +35,7 @@ function createSqsHandlers(props) {
       const functionArgs = args.slice(0, originalFunction.length);
       const fifoOptions = args[originalFunction.length];
       if (props.localInvocation) {
-        await originalFunction(...functionArgs);
+        originalFunction(...functionArgs);
       } else {
         await props.sqsClient.send(new SendMessageCommand({
           QueueUrl: props.queueUrl,
@@ -51,9 +51,6 @@ function createSqsHandlers(props) {
   }), {});
   return [handler, functions];
 }
-function prettyPrint(value) {
-  return JSON.stringify(value, null, 2);
-}
 export {
   createSqsHandlers
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@beesolve/sqs-handler",
   "description": "",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "files": [
     "dist"
@@ -45,9 +45,9 @@
     "constructs": "^10.4.5",
     "@aws-sdk/client-sqs": "^3.978.0",
     "valibot": "^1.2.0",
-    "@beesolve/helpers": "0.1.3",
+    "@beesolve/helpers": "0.1.4",
     "@beesolve/cdk-email-alarms": "0.1.1",
-    "@beesolve/cdk-constructs": "0.1.1"
+    "@beesolve/cdk-constructs": "0.1.2"
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.160"