@awsless/awsless 0.0.16 → 0.0.18

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) => {
@@ -1448,6 +1462,26 @@ var Table = class extends Resource {
       resources: [this.arn]
     };
   }
+  attributeDefinitions() {
+    const fields = this.props.fields || {};
+    const attributes = new Set([
+      this.props.hash,
+      this.props.sort,
+      ...Object.values(this.props.indexes || {}).map((index) => [
+        index.hash,
+        index.sort
+      ])
+    ].flat().filter(Boolean));
+    const types = {
+      string: "S",
+      number: "N",
+      binary: "B"
+    };
+    return [...attributes].map((name) => ({
+      AttributeName: name,
+      AttributeType: types[fields[name] || "string"]
+    }));
+  }
   properties() {
     return {
       TableName: this.name,
@@ -1460,10 +1494,7 @@ var Table = class extends Resource {
         { KeyType: "HASH", AttributeName: this.props.hash },
         ...this.props.sort ? [{ KeyType: "RANGE", AttributeName: this.props.sort }] : []
       ],
-      AttributeDefinitions: Object.entries(this.props.fields).map(([name, type]) => ({
-        AttributeName: name,
-        AttributeType: type[0].toUpperCase()
-      })),
+      AttributeDefinitions: this.attributeDefinitions(),
       ...this.props.stream ? {
         StreamSpecification: {
           StreamViewType: (0, import_change_case4.constantCase)(this.props.stream)
@@ -1505,7 +1536,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: [
@@ -1547,6 +1579,7 @@ var tablePlugin = definePlugin({
           /** Specifies the name of the range / sort key that makes up the primary key for the table. */
           sort: KeySchema.optional(),
           /** A list of attributes that describe the key schema for the table and indexes.
+           * If no attribute field is defined we default to 'string'.
            * @example
            * {
            *   fields: {
@@ -1554,7 +1587,10 @@ var tablePlugin = definePlugin({
            *   }
            * }
            */
-          fields: import_zod9.z.record(import_zod9.z.string(), import_zod9.z.enum(["string", "number", "binary"])),
+          fields: import_zod9.z.record(
+            import_zod9.z.string(),
+            import_zod9.z.enum(["string", "number", "binary"])
+          ).optional(),
           /** The table class of the table.
            * @default 'standard'
            */
@@ -1603,18 +1639,22 @@ var tablePlugin = definePlugin({
              */
             projection: import_zod9.z.enum(["all", "keys-only"]).default("all")
           })).optional()
-        }).refine((props) => {
-          return (
-            // Check the hash key
-            props.fields.hasOwnProperty(props.hash) && // Check the sort key
-            (!props.sort || props.fields.hasOwnProperty(props.sort)) && // Check all indexes
-            !Object.values(props.indexes || {}).map((index) => (
-              // Check the index hash key
-              props.fields.hasOwnProperty(index.hash) && // Check the index sort key
-              (!index.sort || props.fields.hasOwnProperty(index.sort))
-            )).includes(false)
-          );
-        }, "Hash & Sort keys must be defined inside the table fields")
+        })
+        // .refine(props => {
+        // 	return (
+        // 		// Check the hash key
+        // 		props.fields.hasOwnProperty(props.hash) &&
+        // 		// Check the sort key
+        // 		(!props.sort || props.fields.hasOwnProperty(props.sort)) &&
+        // 		// Check all indexes
+        // 		!Object.values(props.indexes || {}).map(index => (
+        // 			// Check the index hash key
+        // 			props.fields.hasOwnProperty(index.hash) &&
+        // 			// Check the index sort key
+        // 			(!index.sort || props.fields.hasOwnProperty(index.sort))
+        // 		)).includes(false)
+        // 	)
+        // }, 'Hash & Sort keys must be defined inside the table fields')
       ).optional()
     }).array()
   }),
@@ -1631,6 +1671,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 +2707,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 +2755,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) => {
@@ -1425,6 +1439,26 @@ var Table = class extends Resource {
       resources: [this.arn]
     };
   }
+  attributeDefinitions() {
+    const fields = this.props.fields || {};
+    const attributes = new Set([
+      this.props.hash,
+      this.props.sort,
+      ...Object.values(this.props.indexes || {}).map((index) => [
+        index.hash,
+        index.sort
+      ])
+    ].flat().filter(Boolean));
+    const types = {
+      string: "S",
+      number: "N",
+      binary: "B"
+    };
+    return [...attributes].map((name) => ({
+      AttributeName: name,
+      AttributeType: types[fields[name] || "string"]
+    }));
+  }
   properties() {
     return {
       TableName: this.name,
@@ -1437,10 +1471,7 @@ var Table = class extends Resource {
         { KeyType: "HASH", AttributeName: this.props.hash },
         ...this.props.sort ? [{ KeyType: "RANGE", AttributeName: this.props.sort }] : []
       ],
-      AttributeDefinitions: Object.entries(this.props.fields).map(([name, type]) => ({
-        AttributeName: name,
-        AttributeType: type[0].toUpperCase()
-      })),
+      AttributeDefinitions: this.attributeDefinitions(),
       ...this.props.stream ? {
         StreamSpecification: {
           StreamViewType: constantCase2(this.props.stream)
@@ -1482,7 +1513,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: [
@@ -1524,6 +1556,7 @@ var tablePlugin = definePlugin({
           /** Specifies the name of the range / sort key that makes up the primary key for the table. */
           sort: KeySchema.optional(),
           /** A list of attributes that describe the key schema for the table and indexes.
+           * If no attribute field is defined we default to 'string'.
            * @example
            * {
            *   fields: {
@@ -1531,7 +1564,10 @@ var tablePlugin = definePlugin({
            *   }
            * }
            */
-          fields: z9.record(z9.string(), z9.enum(["string", "number", "binary"])),
+          fields: z9.record(
+            z9.string(),
+            z9.enum(["string", "number", "binary"])
+          ).optional(),
           /** The table class of the table.
            * @default 'standard'
            */
@@ -1580,18 +1616,22 @@ var tablePlugin = definePlugin({
              */
             projection: z9.enum(["all", "keys-only"]).default("all")
           })).optional()
-        }).refine((props) => {
-          return (
-            // Check the hash key
-            props.fields.hasOwnProperty(props.hash) && // Check the sort key
-            (!props.sort || props.fields.hasOwnProperty(props.sort)) && // Check all indexes
-            !Object.values(props.indexes || {}).map((index) => (
-              // Check the index hash key
-              props.fields.hasOwnProperty(index.hash) && // Check the index sort key
-              (!index.sort || props.fields.hasOwnProperty(index.sort))
-            )).includes(false)
-          );
-        }, "Hash & Sort keys must be defined inside the table fields")
+        })
+        // .refine(props => {
+        // 	return (
+        // 		// Check the hash key
+        // 		props.fields.hasOwnProperty(props.hash) &&
+        // 		// Check the sort key
+        // 		(!props.sort || props.fields.hasOwnProperty(props.sort)) &&
+        // 		// Check all indexes
+        // 		!Object.values(props.indexes || {}).map(index => (
+        // 			// Check the index hash key
+        // 			props.fields.hasOwnProperty(index.hash) &&
+        // 			// Check the index sort key
+        // 			(!index.sort || props.fields.hasOwnProperty(index.sort))
+        // 		)).includes(false)
+        // 	)
+        // }, 'Hash & Sort keys must be defined inside the table fields')
       ).optional()
     }).array()
   }),
@@ -1608,6 +1648,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 +2684,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 +2732,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/index.cjs

@@ -22,6 +22,7 @@ var src_exports = {};
 __export(src_exports, {
   defineAppConfig: () => defineAppConfig,
   definePlugin: () => definePlugin,
+  defineStackConfig: () => defineStackConfig,
   getFunctionName: () => getFunctionName,
   getGlobalResourceName: () => getGlobalResourceName,
   getLocalResourceName: () => getLocalResourceName,
@@ -51,6 +52,9 @@ var getQueueName = getLocalResourceName;
 var getTopicName = getGlobalResourceName;
 
 // src/index.ts
+var defineStackConfig = (config) => {
+  return config;
+};
 var defineAppConfig = (config) => {
   return config;
 };
@@ -58,6 +62,7 @@ var defineAppConfig = (config) => {
 0 && (module.exports = {
   defineAppConfig,
   definePlugin,
+  defineStackConfig,
   getFunctionName,
   getGlobalResourceName,
   getLocalResourceName,