feat: consistent naming for generators

Renamed generators to have consistent names:

`trpc#api` -> `ts#trpc-api`
`ts#lib` -> `ts#project`
`cloudscape-website#app` -> `ts#cloudscape-website`
`cloudscape-website#cognito-auth` -> `ts#cloudscape-website#auth`
`infra#app` -> `ts#infra`

Author: cogwirrel

README.md

@@ -23,7 +23,7 @@ pnpm nx serve docs
 ## Examples
 
 ```
-pnpm nx generate @aws/nx-plugin:cloudscape-website#app infra --name=infra --directory=lib --unitTestRunner=vitest
+pnpm nx generate @aws/nx-plugin:ts#infra infra --name=infra --directory=lib
 ```
 
 ## Security

docs/src/content/docs/guides/example.md

@@ -74,7 +74,7 @@ To add components to your project, you can use either the UI in your IDE (Nx Con
 
 1. Select the **Nx** console plugin on the left, and click **Generate (UI)**. The component generator selection list is displayed.
    ![VSCode Generate UI](/img/nx-generate-ui.png)
-2. Choose the generator for the component you want to add. For example, `infra#app`.
+2. Choose the generator for the component you want to add. For example, `ts#infra`.
    ![Component generator](/img/nx-component-generator.png)
 3. Fill in the details. The terminal window in the bottom runs a dry run and shows you what files will be created.
 4. To proceed, click **Generate**.
@@ -97,7 +97,7 @@ To add components to your project, you can use either the UI in your IDE (Nx Con
    For example for infra:
 
    ```
-   pnpm exec nx generate @aws/nx-plugin:infra#app
+   pnpm exec nx generate @aws/nx-plugin:ts#infra
    ```
 
 2. Follow the prompts to generate the component and add it to your project.

docs/src/content/docs/guides/tutorial.md

@@ -61,7 +61,7 @@ code .
 ## Step 3: Create the Backend REST API
 
 1. Open **Nx Console** in VS Code and select **Generate (UI)** under **Common NX Commands**.
-2. Choose `@aws/nx-plugin - trpc#backend`.
+2. Choose `@aws/nx-plugin - ts#trpc-api`.
 3. Set the `apiName` to `demo-api` and click **Generate**.
 
 This will create the API inside the `packages/demo-api` folder.
@@ -71,31 +71,31 @@ This will create the API inside the `packages/demo-api` folder.
 ### Generate the Website
 
 1. In **Nx Console**, select **Generate (UI)**.
-2. Choose `@aws/nx-plugin - cloudscape-website#app`.
+2. Choose `@aws/nx-plugin - ts#cloudscape-website`.
 3. Set the `name` to `demo-website` and click **Generate**.
 
 This scaffolds a new React package with CloudScape UI.
 
 ### Enable Cognito Authentication
 
 1. In **Nx Console**, select **Generate (UI)**.
-2. Choose `@aws-nx-plugin - cloudscape-website#cognito-auth`.
+2. Choose `@aws-nx-plugin - ts#cloudscape-website#cognito-auth`.
 3. Set a unique `cognitoDomain`, select `@demo/demo-website`, and check `allowSignup`.
 4. Click **Generate**.
 
 ### Connect Frontend to Backend
 
 1. In **Nx Console**, select **Generate (UI)**.
-2. Choose `@aws-nx-plugin - trpc#react`.
-3. Select `@demo/demo-website` for `frontendProjectName` and `@demo/demo-api-backend` for `backendProjectName`.
+2. Choose `@aws-nx-plugin - api#connection`.
+3. Select `@demo/demo-website` for `sourceProject` and `@demo/demo-api-backend` for `targetProject`.
 4. Click **Generate**.
 
 ## Step 5: Create CDK Infrastructure
 
 ### Generate the CDK App
 
 1. In **Nx Console**, select **Generate (UI)**.
-2. Choose `@aws/nx-plugin - infra#app`.
+2. Choose `@aws/nx-plugin - ts#infra`.
 3. Set `name` to `infra` and click **Generate**.
 
 ### Define Cloud Resources

docs/src/content/docs/reference/api_connection.md

@@ -0,0 +1,59 @@
+---
+title: API Connection
+description: Reference documentation for API connections
+---
+
+This generator is used to connect projects to APIs. Simply select the source project (the project that will call your API) and target project (your API project), and this generator will handle integrating the two.
+
+## Connecting an API
+
+You can connect a source and target project in two ways:
+
+### 1. Using VSCode IDE
+
+First, install the NX Console extension for VSCode:
+
+1. Open VSCode
+2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
+3. Search for "Nx Console"
+4. Install [Nx Console](https://marketplace.visualstudio.com/items?itemName=nrwl.angular-console)
+
+Then generate your API:
+
+1. Open the NX Console in VSCode
+2. Click on "Generate"
+3. Search for "api-connection"
+4. Fill in the required parameters in the form
+5. Click "Run"
+
+### 2. Using CLI
+
+Generate the API:
+
+```bash
+nx g @aws/nx-plugin:api-connection --sourceProject=my-client-project --targetProject=my-api-project --auth=IAM
+```
+
+You can also perform a dry-run to see what files would be generated without actually creating them:
+
+```bash
+nx g @aws/nx-plugin:api-connection --sourceProject=my-client-project --targetProject=my-api-project --auth=IAM --dry-run
+```
+
+Both methods will add the necessary code and configuration to integrate the source project with the target api project.
+
+### Input Parameters
+
+| Parameter       | Type   | Default | Description                                                  |
+| --------------- | ------ | ------- | ------------------------------------------------------------ |
+| sourceProject\* | string | -       | The name of the project which will call your API (required). |
+| targetProject\* | string | -       | The name of your API project (required).                     |
+| auth\*          | string | "IAM"   | Authentication strategy. Options: "IAM", "None"              |
+
+\*Required parameter
+
+## Supported Connections
+
+### tRPC
+
+You can connect a React website to a tRPC API. For details, please refer to the [API connection section of the tRPC reference documentation](/reference/trpc/#api-connection-trpc-react).

docs/src/content/docs/reference/trpc.md

@@ -7,16 +7,16 @@ description: Reference documentation for tRPC
 
 The AWS Plugin for Nx makes building APIs with tRPC on AWS easy by providing two main generators:
 
-- [`trpc#backend`](#trpc-backend) - Generates the backend code to implement a tRPC API as well as infrastructure to deploy it with API Gateway
-- [`trpc#react`](#trpc-react) - Integrates a tRPC API with a React website
+- [`ts#trpc-api`](#trpc-api) - Generates the backend code to implement a tRPC API as well as infrastructure to deploy it with API Gateway
+- [`api-connection`](#api-connection-trpc-react) - Supports integrating a tRPC API with a React website
 
-## tRPC Backend
+## tRPC API
 
-The tRPC Backend generator creates a new tRPC API with AWS CDK infrastructure setup. The generated backend uses AWS Lambda for serverless deployment and includes schema validation using [Zod](https://zod.dev/). It sets up [AWS Lambda Powertools](https://docs.powertools.aws.dev/lambda/typescript/latest/) for observability, including logging, AWS X-Ray tracing and Cloudwatch Metrics.
+The tRPC API generator creates a new tRPC API with AWS CDK infrastructure setup. The generated backend uses AWS Lambda for serverless deployment and includes schema validation using [Zod](https://zod.dev/). It sets up [AWS Lambda Powertools](https://docs.powertools.aws.dev/lambda/typescript/latest/) for observability, including logging, AWS X-Ray tracing and Cloudwatch Metrics.
 
-### Generating a new tRPC Backend
+### Generating a new tRPC API
 
-You can generate a new tRPC backend in two ways:
+You can generate a new tRPC API in two ways:
 
 #### 1. Using VSCode IDE
 
@@ -31,7 +31,7 @@ Then generate your API:
 
 1. Open the NX Console in VSCode
 2. Click on "Generate"
-3. Search for "trpc#backend"
+3. Search for "ts#trpc-api"
 4. Fill in the required parameters in the form
 5. Click "Run"
 
@@ -40,13 +40,13 @@ Then generate your API:
 Generate the API:
 
 ```bash
-nx g @aws/nx-plugin:trpc#backend my-api --directory=apps/api
+nx g @aws/nx-plugin:ts#trpc-api my-api --directory=apps/api
 ```
 
 You can also perform a dry-run to see what files would be generated without actually creating them:
 
 ```bash
-nx g @aws/nx-plugin:trpc#backend my-api --directory=apps/api --dry-run
+nx g @aws/nx-plugin:ts#trpc-api my-api --directory=apps/api --dry-run
 ```
 
 Both methods will create a new tRPC backend API in the specified directory with all the necessary configuration and infrastructure code.
@@ -395,9 +395,9 @@ const client = createMyApiClient({ url: 'https://my-api-url.example.com/' });
 await client.echo.query({ message: 'Hello world!' });
 ```
 
-If you are calling your API from a React website, consider using the [tRPC React](#trpc-react) generator to configure the client.
+If you are calling your API from a React website, consider using the [API Connection](#api-connection-trpc-react) generator to configure the client.
 
-## tRPC React
+## API Connection: tRPC React
 
 AWS Plugin for Nx provides a generator to quickly integrate your tRPC API with a React website. It sets up all necessary configuration for connecting to your tRPC backends, including AWS IAM authentication support and proper error handling. The integration provides full end-to-end type safety between your frontend and tRPC backend(s).
 
@@ -441,7 +441,7 @@ Then add tRPC to your React application:
 
 1. Open the NX Console in VSCode
 2. Click on "Generate"
-3. Search for "trpc#react"
+3. Search for "api-connection"
 4. Fill in the required parameters in the form
 5. Click "Run"
 
@@ -450,24 +450,24 @@ Then add tRPC to your React application:
 Add tRPC to your React application:
 
 ```bash
-nx g @aws/nx-plugin:trpc#react --frontendProjectName=my-app --backendProjectName=my-api --auth=IAM
+nx g @aws/nx-plugin:api-connection --sourceProject=my-app --targetProject=my-api --auth=IAM
 ```
 
 You can also perform a dry-run to see what files would be generated without actually creating them:
 
 ```bash
-nx g @aws/nx-plugin:trpc#react --frontendProjectName=my-app --backendProjectName=my-api --auth=IAM --dry-run
+nx g @aws/nx-plugin:api-connection --sourceProject=my-app --targetProject=my-api --auth=IAM --dry-run
 ```
 
 Both methods will add tRPC client integration to your React application with all the necessary configuration.
 
 ### Input Parameters
 
-| Parameter             | Type   | Default | Description                                            |
-| --------------------- | ------ | ------- | ------------------------------------------------------ |
-| frontendProjectName\* | string | -       | The name of your React application project (required). |
-| backendProjectName\*  | string | -       | The name of your tRPC backend project (required).      |
-| auth\*                | string | "IAM"   | Authentication strategy. Options: "IAM", "None"        |
+| Parameter       | Type   | Default | Description                                            |
+| --------------- | ------ | ------- | ------------------------------------------------------ |
+| sourceProject\* | string | -       | The name of your React application project (required). |
+| targetProject\* | string | -       | The name of your tRPC backend project (required).      |
+| auth\*          | string | "IAM"   | Authentication strategy. Options: "IAM", "None"        |
 
 \*Required parameter
 

e2e/src/smoke-tests/smoke-test.ts

@@ -40,33 +40,30 @@ export const smokeTest = (
         { ...opts, prefixWithPackageManagerCmd: false, retry: true },
       ); // This can sometimes fail intermittently so add retries
       await runCLI(
-        `generate @aws/nx-plugin:infra#app --name=infra --no-interactive`,
+        `generate @aws/nx-plugin:ts#infra --name=infra --no-interactive`,
         opts,
       );
       await runCLI(
-        `generate @aws/nx-plugin:cloudscape-website#app --name=website --no-interactive`,
+        `generate @aws/nx-plugin:ts#cloudscape-website --name=website --no-interactive`,
         opts,
       );
       await runCLI(
-        `generate @aws/nx-plugin:trpc#backend --apiName=my-api --no-interactive`,
+        `generate @aws/nx-plugin:ts#trpc-api --apiName=my-api --no-interactive`,
         opts,
       );
       await runCLI(
-        `generate @aws/nx-plugin:cloudscape-website#cognito-auth --project=@e2e-test/website --cognitoDomain=test --no-interactive`,
+        `generate @aws/nx-plugin:ts#cloudscape-website#auth --project=@e2e-test/website --cognitoDomain=test --no-interactive`,
         opts,
       );
       await runCLI(
-        `generate @aws/nx-plugin:trpc#react --frontendProjectName=@e2e-test/website --backendProjectName=@e2e-test/my-api-backend --no-interactive`,
+        `generate @aws/nx-plugin:api-connection --sourceProject=@e2e-test/website --targetProject=@e2e-test/my-api-backend --no-interactive`,
         opts,
       );
       await runCLI(
         `generate @aws/nx-plugin:py#fast-api --name=py-api --no-interactive`,
         opts,
       );
-      await runCLI(
-        `generate @aws/nx-plugin:license --no-interactive`,
-        opts,
-      );
+      await runCLI(`generate @aws/nx-plugin:license --no-interactive`, opts);
 
       // Wire up website, cognito and trpc api
       writeFileSync(

packages/nx-plugin/LICENSE-THIRD-PARTY

@@ -14541,6 +14541,59 @@ terms above.
 
 ---
 
+The following software may be included in this product: lodash.snakecase (4.1.1)
+This software contains the following license and notice below:
+
+Copyright jQuery Foundation and other contributors <https://jquery.org/>
+
+Based on Underscore.js, copyright Jeremy Ashkenas,
+DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
+
+This software consists of voluntary contributions made by many
+individuals. For exact contribution history, see the revision history
+available at https://github.com/lodash/lodash
+
+The following license applies to all parts of this software except as
+documented below:
+
+====
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+====
+
+Copyright and related rights for sample code are waived via CC0. Sample
+code is defined as all source code displayed within the prose of the
+documentation.
+
+CC0: http://creativecommons.org/publicdomain/zero/1.0/
+
+====
+
+Files located in the node_modules and vendor directories are externally
+maintained libraries used by this software which have their own
+licenses; we recommend you read them, as their terms may differ from the
+terms above.
+
+---
+
 The following software may be included in this product: log-symbols (4.1.0)
 This software contains the following license and notice below:
 

packages/nx-plugin/generators.json

@@ -3,10 +3,10 @@
   "name": "pace",
   "version": "0.0.1",
   "generators": {
-    "ts#lib": {
+    "ts#project": {
       "factory": "./src/ts/lib/generator",
       "schema": "./src/ts/lib/schema.json",
-      "description": "Generates a TypeScript library"
+      "description": "Generates a TypeScript project"
     },
     "py#project": {
       "factory": "./src/py/project/generator",
@@ -18,39 +18,39 @@
       "schema": "./src/py/fast-api/schema.json",
       "description": "Generates a FastAPI Python project"
     },
-    "cloudscape-website#app": {
+    "ts#cloudscape-website": {
       "factory": "./src/cloudscape-website/app/generator",
       "schema": "./src/cloudscape-website/app/schema.json",
       "description": "Generates a React static website based on Cloudscape"
     },
-    "cloudscape-website#cognito-auth": {
+    "ts#cloudscape-website#auth": {
       "factory": "./src/cloudscape-website/cognito-auth/generator",
       "schema": "./src/cloudscape-website/cognito-auth/schema.json",
-      "description": "Adds cognito auth to an existing cloudscape website"
+      "description": "Adds auth to an existing cloudscape website"
     },
-    "cloudscape-website#runtime-config": {
+    "ts#cloudscape-website#runtime-config": {
       "factory": "./src/cloudscape-website/runtime-config/generator",
       "schema": "./src/cloudscape-website/runtime-config/schema.json",
       "description": "Adds runtime config to an existing cloudscape website",
       "hidden": true
     },
-    "infra#app": {
+    "ts#infra": {
       "factory": "./src/infra/app/generator",
       "schema": "./src/infra/app/schema.json",
       "description": "Generates a cdk application"
     },
-    "trpc#api": {
+    "ts#trpc-api": {
       "factory": "./src/trpc/backend/generator",
       "schema": "./src/trpc/backend/schema.json",
       "description": "creates a trpc backend"
     },
-    "trpc#react": {
+    "ts#trpc-api#react-connection": {
       "factory": "./src/trpc/react/generator",
       "schema": "./src/trpc/react/schema.json",
       "description": "provides React integration to a React website",
       "hidden": true
     },
-    "api#connection": {
+    "api-connection": {
       "factory": "./src/api-connection/generator",
       "schema": "./src/api-connection/schema.json",
       "description": "Integrates a source project with a target API project"