@awsless/awsless 0.0.16 → 0.0.17

package/README.MD

@@ -1,6 +1,212 @@
 
 
-TODO:
+# TODO:
 - onFailure for lambda, sqs, dynamodb streams
 - add cache plugin & think about VPC lambda solutions
 - add fargate container stuff for long lived services
+
+
+---
+---
+---
+
+# Features
+
+- Domains
+- Functions
+- Database
+  - Tables
+  - Stores
+  - Caches
+  - Searchs
+- Queues
+- Topics
+- Pubsub
+- Crons
+- API
+  - HTTP
+  - GraphQL
+
+
+## Domains
+
+We use AWS Route53 to provide domain management.
+
+```js
+{
+	domains: {
+		'example.com': [{
+			name: 'sub',
+			type: 'A',
+			records: [ ... ],
+		}],
+	}
+}
+```
+
+## Functions
+
+We use AWS Lambda to provide serverless functions.
+
+```js
+{
+	defaults: {
+		function: {
+			// Setting default values for all functions...
+		}
+	},
+	stacks: [{
+		functions: {
+			FUNCTION_NAME: 'function.ts'
+		}
+	}]
+}
+```
+
+## Tables
+
+We use AWS DynamoDB to provide serverless tables.
+
+```js
+{
+	stacks: [{
+		tables: {
+			TABLE_NAME: {
+				hash: 'id',
+				fields: {
+					id: 'string',
+				}
+			}
+		}
+	}]
+}
+```
+
+## Stores
+
+We use AWS S3 to provide serverless key-value storage.
+
+```js
+{
+	stacks: [{
+		stores: [ 'STORE_NAME' ]
+	}]
+}
+```
+
+## Caches
+
+We use AWS MemoryDB to provide __redis compatible__ in-memory storage.
+
+_WORK IN PROGRESS..._
+
+## Searchs
+
+We use AWS Open Search Serverless to provide serverless search api.
+
+```js
+{
+	stacks: [{
+		searchs: [ 'SEARCH_NAME' ]
+	}]
+}
+```
+
+## Queues
+
+We use AWS SQS to provide serverless queues.
+
+```js
+{
+	stacks: [{
+		queues: {
+			QUEUE_NAME: 'queue-consumer.ts',
+		}
+	}]
+}
+```
+
+## Topics
+
+We use AWS SNS to provide serverless pubsub topics.
+
+```js
+{
+	stacks: [{
+		topics: {
+			TOPIC_NAME: 'topic-consumer.ts',
+		}
+	}]
+}
+```
+
+## Pubsub
+
+We use AWS IoT to provide a serverless mqtt pubsub channel.
+
+```js
+{
+	stacks: [{
+		pubsub: {
+			PUBSUB_NAME: {
+				sql: `SELECT * FROM '$aws/events/presence/connected/+'`,
+				consumer: 'pubsub-consumer.ts',
+			}
+		}
+	}]
+}
+```
+
+## Crons
+
+We use AWS Event Bridge to provide serverless cron jobs.
+
+```js
+{
+	stacks: [{
+		crons: {
+			CRON_NAME: {
+				schedule: 'rate(1 day)',
+				consumer: 'cron-consumer.ts',
+			}
+		}
+	}]
+}
+```
+
+## HTTP
+
+We use AWS ELB to provide a REST HTTP API.
+
+```js
+{
+	stacks: [{
+		http: {
+			HTTP_API_NAME: {
+				'GET /posts': 'list-posts.ts',
+				'POST /posts': 'create-post.ts',
+			}
+		}
+	}]
+}
+```
+
+## GraphQL
+
+We use AWS AppSync to provide a serverless GraphQL API.
+
+```js
+{
+	stacks: [{
+		graphql: {
+			GRAPHQL_API_NAME: {
+				schema: 'schema.gql',
+				resolvers: {
+					'Query posts': 'list-posts.ts',
+					'Mutation createPost': 'create-post.ts',
+				}
+			}
+		}
+	}]
+}
+```

package/dist/bin.cjs

@@ -932,6 +932,17 @@ var EventInvokeConfig = class extends Resource {
   }
 };
 
+// src/plugins/on-failure/util.ts
+var getGlobalOnFailure = ({ config, bootstrap: bootstrap2 }) => {
+  return hasOnFailure(config) ? bootstrap2.import("on-failure-queue-arn") : void 0;
+};
+var hasOnFailure = (config) => {
+  const onFailure = config.stacks.find((stack) => {
+    return typeof stack.onFailure !== "undefined";
+  });
+  return !!onFailure;
+};
+
 // src/plugins/function.ts
 var MemorySizeSchema = SizeSchema.refine(sizeMin(Size.megaBytes(128)), "Minimum memory size is 128 MB").refine(sizeMax(Size.gigaBytes(10)), "Minimum memory size is 10 GB");
 var TimeoutSchema = DurationSchema.refine(durationMin(Duration.seconds(10)), "Minimum timeout duration is 10 seconds").refine(durationMax(Duration.minutes(15)), "Maximum timeout duration is 15 minutes");
@@ -1054,9 +1065,16 @@ var functionPlugin = definePlugin({
   name: "function",
   schema,
   onStack(ctx) {
-    for (const [id, props] of Object.entries(ctx.stackConfig.functions || {})) {
-      const lambda = toLambdaFunction(ctx, id, props);
-      ctx.stack.add(lambda);
+    const { config, stack } = ctx;
+    for (const [id, fileOrProps] of Object.entries(ctx.stackConfig.functions || {})) {
+      const props = typeof fileOrProps === "string" ? { ...config.defaults?.function, file: fileOrProps } : { ...config.defaults?.function, ...fileOrProps };
+      const lambda = toLambdaFunction(ctx, id, fileOrProps);
+      const invoke = new EventInvokeConfig(id, {
+        functionName: lambda.name,
+        retryAttempts: props.retryAttempts,
+        onFailure: getGlobalOnFailure(ctx)
+      }).dependsOn(lambda);
+      stack.add(invoke, lambda);
     }
   }
 });
@@ -1073,11 +1091,6 @@ var toLambdaFunction = (ctx, id, fileOrProps) => {
   if (props.runtime.startsWith("nodejs")) {
     lambda.addEnvironment("AWS_NODEJS_CONNECTION_REUSE_ENABLED", "1");
   }
-  const invoke = new EventInvokeConfig(id, {
-    functionName: lambda.name,
-    retryAttempts: props.retryAttempts
-  }).dependsOn(lambda);
-  ctx.stack.add(invoke);
   return lambda;
 };
 
@@ -1392,7 +1405,8 @@ var queuePlugin = definePlugin({
       });
       const lambda = toLambdaFunction(ctx, `queue-${id}`, props.consumer);
       const source = new SqsEventSource(id, lambda, {
-        queueArn: queue2.arn
+        queueArn: queue2.arn,
+        onFailure: getGlobalOnFailure(ctx)
       });
       stack.add(queue2, lambda, source);
       bind((lambda2) => {
@@ -1505,7 +1519,8 @@ var DynamoDBEventSource = class extends Group {
       parallelizationFactor: props.parallelizationFactor ?? 1,
       startingPosition: props.startingPosition,
       startingPositionTimestamp: props.startingPositionTimestamp,
-      tumblingWindow: props.tumblingWindow
+      tumblingWindow: props.tumblingWindow,
+      onFailure: props.onFailure
     });
     lambda.addPermissions({
       actions: [
@@ -1631,6 +1646,7 @@ var tablePlugin = definePlugin({
         const lambda = toLambdaFunction(ctx, `stream-${id}`, props.stream.consumer);
         const source = new DynamoDBEventSource(id, lambda, {
           tableArn: table.arn,
+          onFailure: getGlobalOnFailure(ctx),
           ...props.stream
         });
         stack.add(lambda, source);
@@ -2666,14 +2682,8 @@ var domainPlugin = definePlugin({
   }
 });
 
-// src/plugins/on-failure.ts
+// src/plugins/on-failure/index.ts
 var import_zod16 = require("zod");
-var hasOnFailure = (config) => {
-  const onFailure = config.stacks.find((stack) => {
-    return typeof stack.onFailure !== "undefined";
-  });
-  return !!onFailure;
-};
 var onFailurePlugin = definePlugin({
   name: "on-failure",
   schema: import_zod16.z.object({
@@ -2720,21 +2730,6 @@ var onFailurePlugin = definePlugin({
       resources: [queueArn]
     });
     stack.add(lambda, source);
-  },
-  onResource({ config, resource, bootstrap: bootstrap2 }) {
-    if (!hasOnFailure(config)) {
-      return;
-    }
-    const queueArn = bootstrap2.import("on-failure-queue-arn");
-    if (resource instanceof Queue) {
-      resource.setDeadLetter(queueArn);
-    }
-    if (resource instanceof EventInvokeConfig) {
-      resource.setOnFailure(queueArn);
-    }
-    if (resource instanceof EventSourceMapping) {
-      resource.setOnFailure(queueArn);
-    }
   }
 });
 

package/dist/bin.js

@@ -909,6 +909,17 @@ var EventInvokeConfig = class extends Resource {
   }
 };
 
+// src/plugins/on-failure/util.ts
+var getGlobalOnFailure = ({ config, bootstrap: bootstrap2 }) => {
+  return hasOnFailure(config) ? bootstrap2.import("on-failure-queue-arn") : void 0;
+};
+var hasOnFailure = (config) => {
+  const onFailure = config.stacks.find((stack) => {
+    return typeof stack.onFailure !== "undefined";
+  });
+  return !!onFailure;
+};
+
 // src/plugins/function.ts
 var MemorySizeSchema = SizeSchema.refine(sizeMin(Size.megaBytes(128)), "Minimum memory size is 128 MB").refine(sizeMax(Size.gigaBytes(10)), "Minimum memory size is 10 GB");
 var TimeoutSchema = DurationSchema.refine(durationMin(Duration.seconds(10)), "Minimum timeout duration is 10 seconds").refine(durationMax(Duration.minutes(15)), "Maximum timeout duration is 15 minutes");
@@ -1031,9 +1042,16 @@ var functionPlugin = definePlugin({
   name: "function",
   schema,
   onStack(ctx) {
-    for (const [id, props] of Object.entries(ctx.stackConfig.functions || {})) {
-      const lambda = toLambdaFunction(ctx, id, props);
-      ctx.stack.add(lambda);
+    const { config, stack } = ctx;
+    for (const [id, fileOrProps] of Object.entries(ctx.stackConfig.functions || {})) {
+      const props = typeof fileOrProps === "string" ? { ...config.defaults?.function, file: fileOrProps } : { ...config.defaults?.function, ...fileOrProps };
+      const lambda = toLambdaFunction(ctx, id, fileOrProps);
+      const invoke = new EventInvokeConfig(id, {
+        functionName: lambda.name,
+        retryAttempts: props.retryAttempts,
+        onFailure: getGlobalOnFailure(ctx)
+      }).dependsOn(lambda);
+      stack.add(invoke, lambda);
     }
   }
 });
@@ -1050,11 +1068,6 @@ var toLambdaFunction = (ctx, id, fileOrProps) => {
   if (props.runtime.startsWith("nodejs")) {
     lambda.addEnvironment("AWS_NODEJS_CONNECTION_REUSE_ENABLED", "1");
   }
-  const invoke = new EventInvokeConfig(id, {
-    functionName: lambda.name,
-    retryAttempts: props.retryAttempts
-  }).dependsOn(lambda);
-  ctx.stack.add(invoke);
   return lambda;
 };
 
@@ -1369,7 +1382,8 @@ var queuePlugin = definePlugin({
       });
       const lambda = toLambdaFunction(ctx, `queue-${id}`, props.consumer);
       const source = new SqsEventSource(id, lambda, {
-        queueArn: queue2.arn
+        queueArn: queue2.arn,
+        onFailure: getGlobalOnFailure(ctx)
       });
       stack.add(queue2, lambda, source);
       bind((lambda2) => {
@@ -1482,7 +1496,8 @@ var DynamoDBEventSource = class extends Group {
       parallelizationFactor: props.parallelizationFactor ?? 1,
       startingPosition: props.startingPosition,
       startingPositionTimestamp: props.startingPositionTimestamp,
-      tumblingWindow: props.tumblingWindow
+      tumblingWindow: props.tumblingWindow,
+      onFailure: props.onFailure
     });
     lambda.addPermissions({
       actions: [
@@ -1608,6 +1623,7 @@ var tablePlugin = definePlugin({
         const lambda = toLambdaFunction(ctx, `stream-${id}`, props.stream.consumer);
         const source = new DynamoDBEventSource(id, lambda, {
           tableArn: table.arn,
+          onFailure: getGlobalOnFailure(ctx),
           ...props.stream
         });
         stack.add(lambda, source);
@@ -2643,14 +2659,8 @@ var domainPlugin = definePlugin({
   }
 });
 
-// src/plugins/on-failure.ts
+// src/plugins/on-failure/index.ts
 import { z as z16 } from "zod";
-var hasOnFailure = (config) => {
-  const onFailure = config.stacks.find((stack) => {
-    return typeof stack.onFailure !== "undefined";
-  });
-  return !!onFailure;
-};
 var onFailurePlugin = definePlugin({
   name: "on-failure",
   schema: z16.object({
@@ -2697,21 +2707,6 @@ var onFailurePlugin = definePlugin({
       resources: [queueArn]
     });
     stack.add(lambda, source);
-  },
-  onResource({ config, resource, bootstrap: bootstrap2 }) {
-    if (!hasOnFailure(config)) {
-      return;
-    }
-    const queueArn = bootstrap2.import("on-failure-queue-arn");
-    if (resource instanceof Queue) {
-      resource.setDeadLetter(queueArn);
-    }
-    if (resource instanceof EventInvokeConfig) {
-      resource.setOnFailure(queueArn);
-    }
-    if (resource instanceof EventSourceMapping) {
-      resource.setOnFailure(queueArn);
-    }
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awsless/awsless",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "license": "MIT",
   "type": "module",
   "repository": {