defineRestApi construct

.changeset/blue-carpets-create.md

@@ -0,0 +1,2 @@
+---
+---

.changeset/lucky-terms-vanish.md

@@ -0,0 +1,5 @@
+---
+'@aws-amplify/rest-api-construct': major
+---
+
+This construct enables developers to configure API Gateway REST endpoints with Lambda integration and path/method-level auth (including Cognito User Pools and user groups). Supports route definition via a simple props interface.

.changeset/moody-bushes-heal.md

@@ -0,0 +1,5 @@
+---
+'@aws-amplify/rest-api-construct': patch
+---
+
+Adds error handling and a unit test for invalid REST API paths

.eslint_dictionary.json

@@ -18,6 +18,7 @@
   "argv",
   "arn",
   "arns",
+  "authorizer",
   "aws",
   "backends",
   "birthdate",

packages/create-amplify/src/default_packages.json

@@ -2,7 +2,7 @@
   "defaultDevPackages": [
     "@aws-amplify/backend",
     "@aws-amplify/backend-cli",
-    "aws-cdk-lib@2.207.0",
+    "aws-cdk-lib@2.204.0",
     "constructs@^10.0.0",
     "typescript@^5.0.0",
     "tsx",

packages/rest-api-construct/.npmignore

@@ -0,0 +1,14 @@
+# Be very careful editing this file. It is crafted to work around [this issue](https://github.com/npm/npm/issues/4479)
+
+# First ignore everything
+**/*
+
+# Then add back in transpiled js and ts declaration files
+!lib/**/*.js
+!lib/**/*.d.ts
+
+# Then ignore test js and ts declaration files
+*.test.js
+*.test.d.ts
+
+# This leaves us with including only js and ts declaration files of functional code

packages/rest-api-construct/API.md

@@ -0,0 +1,52 @@
+## API Report File for "@aws-amplify/rest-api-construct"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+import * as apiGateway from 'aws-cdk-lib/aws-apigateway';
+import { Construct } from 'constructs';
+import { FunctionResources } from '@aws-amplify/backend/types/platform';
+import { IUserPool } from 'aws-cdk-lib/aws-cognito';
+import { ResourceProvider } from '@aws-amplify/backend/types/platform';
+
+// @public (undocumented)
+export type AuthorizerConfig = {
+    type: 'none';
+} | {
+    type: 'userPool';
+};
+
+// @public (undocumented)
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
+
+// @public (undocumented)
+export type MethodsProps = {
+    method: HttpMethod;
+    authorizer?: AuthorizerConfig;
+};
+
+// @public (undocumented)
+export class RestApiConstruct extends Construct {
+    constructor(scope: Construct, id: string, props: RestApiConstructProps, userPool?: IUserPool);
+    // (undocumented)
+    readonly api: apiGateway.RestApi;
+}
+
+// @public (undocumented)
+export type RestApiConstructProps = {
+    apiName: string;
+    apiProps: RestApiPathConfig[];
+    defaultAuthorizer?: AuthorizerConfig;
+};
+
+// @public (undocumented)
+export type RestApiPathConfig = {
+    path: string;
+    methods: MethodsProps[];
+    lambdaEntry: ResourceProvider<FunctionResources>;
+};
+
+// (No @packageDocumentation comment for this package)
+
+```

packages/rest-api-construct/README.md

@@ -0,0 +1,3 @@
+# Description
+
+Replace with a description of this package

packages/rest-api-construct/api-extractor.json

@@ -0,0 +1,3 @@
+{
+  "extends": "../../api-extractor.base.json"
+}

packages/rest-api-construct/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@aws-amplify/rest-api-construct",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.js"
+    }
+  },
+  "types": "lib/index.d.ts",
+  "scripts": {
+    "update:api": "api-extractor run --local"
+  },
+  "license": "Apache-2.0",
+  "peerDependencies": {
+    "aws-cdk-lib": "^2.189.1",
+    "constructs": "^10.0.0"
+  },
+  "dependencies": {
+    "@aws-amplify/backend": "^1.16.1",
+    "@aws-amplify/backend-output-storage": "^1.3.1",
+    "@aws-amplify/platform-core": "^1.10.0",
+    "aws-lambda": "^1.0.7"
+  }
+}