@aws/nx-plugin 1.0.0-rc.6 → 1.0.0-rc.60

package/README.md

@@ -137,16 +137,16 @@ pnpm create @aws/nx-workspace my-project
 cd my-project
 
 # Add a tRPC API
-pnpm nx g @aws/nx-plugin:ts#trpc-api
+pnpm nx g @aws/nx-plugin:ts#api --framework=trpc
 
 # Add a Strands AI agent (Python)
 pnpm nx g @aws/nx-plugin:py#agent
 
 # Add a React website
-pnpm nx g @aws/nx-plugin:ts#react-website
+pnpm nx g @aws/nx-plugin:ts#website --framework=react
 
 # Add authentication to your website
-pnpm nx g @aws/nx-plugin:ts#react-website#auth
+pnpm nx g @aws/nx-plugin:ts#website#auth
 
 # Connect your website to your API and agent
 pnpm nx g @aws/nx-plugin:connection
@@ -162,17 +162,18 @@ pnpm nx g @aws/nx-plugin:ts#infra
 | Generator               | Description                                                                                                       |
 | ----------------------- | ----------------------------------------------------------------------------------------------------------------- |
 | `ts#project`            | TypeScript library                                                                                                |
-| `ts#trpc-api`           | tRPC API with API Gateway + Lambda + [Powertools](https://github.com/aws-powertools/powertools-lambda-typescript) |
+| `ts#api`                | TypeScript API (tRPC or Smithy) with API Gateway + Lambda + [Powertools](https://github.com/aws-powertools/powertools-lambda-typescript) |
 | `ts#rdb`                | Relational databases with Aurora RDS                                                                              |
-| `ts#react-website`      | React app (Vite)                                                                                                  |
-| `ts#react-website#auth` | Add Cognito auth to a React website                                                                               |
+| `ts#website`            | React app (Vite)                                                                                                  |
+| `ts#website#auth`       | Add Cognito auth to a website                                                                                     |
 | `ts#infra`              | AWS CDK infrastructure project                                                                                    |
 | `ts#lambda-function`    | TypeScript Lambda with type-safe event sources                                                                    |
 | `ts#mcp-server`         | MCP server (TypeScript)                                                                                           |
 | `ts#agent`              | [Strands Agent](https://strandsagents.com/) (TypeScript)                                                          |
 | `ts#nx-generator`       | Nx generator scaffold                                                                                             |
+| `smithy#project`        | Smithy model project — a service model, or a shape library shared between Smithy projects                          |
 | `py#project`            | Python project (uv)                                                                                               |
-| `py#fast-api`           | FastAPI with API Gateway + Lambda + [Powertools](https://github.com/aws-powertools/powertools-lambda-python)      |
+| `py#api`                | Python API (FastAPI) with API Gateway + Lambda + [Powertools](https://github.com/aws-powertools/powertools-lambda-python)      |
 | `py#lambda-function`    | Python Lambda with type-safe event sources                                                                        |
 | `py#mcp-server`         | MCP server (Python)                                                                                               |
 | `py#agent`              | [Strands Agent](https://strandsagents.com/) (Python)                                                              |

package/generators.json

@@ -3,6 +3,47 @@
   "name": "@aws/nx-plugin",
   "version": "0.0.1",
   "generators": {
+    "init": {
+      "factory": "./src/init/generator",
+      "schema": "./src/init/schema.json",
+      "description": "Configure an existing Nx workspace to use the @aws/nx-plugin",
+      "metric": "g66",
+      "guidePages": ["existing-project"]
+    },
+    "agentcore-gateway": {
+      "factory": "./src/agentcore-gateway/generator",
+      "schema": "./src/agentcore-gateway/schema.json",
+      "description": "Generate an AgentCore Gateway project",
+      "metric": "g48"
+    },
+    "agentcore-gateway#mcp-connection": {
+      "factory": "./src/agentcore-gateway/mcp-connection/generator",
+      "schema": "./src/agentcore-gateway/mcp-connection/schema.json",
+      "description": "Connect an AgentCore Gateway to an MCP server",
+      "metric": "g49",
+      "hidden": true
+    },
+    "agentcore-gateway#gateway-connection": {
+      "factory": "./src/agentcore-gateway/gateway-connection/generator",
+      "schema": "./src/agentcore-gateway/gateway-connection/schema.json",
+      "description": "Connect an AgentCore Gateway to another AgentCore Gateway",
+      "metric": "g65",
+      "hidden": true
+    },
+    "agentcore-gateway#agent-connection": {
+      "factory": "./src/agentcore-gateway/agent-connection/generator",
+      "schema": "./src/agentcore-gateway/agent-connection/schema.json",
+      "description": "Connect an AgentCore Gateway to an agent, adding the agent as a gateway target",
+      "metric": "g69",
+      "hidden": true
+    },
+    "agentcore-gateway#react-connection": {
+      "factory": "./src/agentcore-gateway/react-connection/generator",
+      "schema": "./src/agentcore-gateway/react-connection/schema.json",
+      "description": "Connect a React website to an AgentCore Gateway fronting agents",
+      "metric": "g70",
+      "hidden": true
+    },
     "connection": {
       "factory": "./src/connection/generator",
       "schema": "./src/connection/schema.json",
@@ -23,7 +64,13 @@
         "connection/trpc-rdb",
         "connection/smithy-rdb",
         "connection/ts-mcp-server-rdb",
-        "connection/ts-agent-rdb"
+        "connection/ts-agent-rdb",
+        "connection/ts-agent-gateway",
+        "connection/py-agent-gateway",
+        "connection/agentcore-gateway-mcp",
+        "connection/agentcore-gateway-gateway",
+        "connection/agentcore-gateway-agent",
+        "connection/react-agentcore-gateway"
       ]
     },
     "license": {
@@ -134,9 +181,9 @@
     "smithy#project": {
       "factory": "./src/smithy/project/generator",
       "schema": "./src/smithy/project/schema.json",
-      "description": "Generate a Smithy model project",
+      "description": "Generate a Smithy model project, either defining a service or a library of reusable shapes",
       "metric": "g27",
-      "hidden": true
+      "guidePages": ["smithy-project"]
     },
     "smithy#react-connection": {
       "factory": "./src/smithy/react-connection/generator",
@@ -180,6 +227,12 @@
       "description": "Generate a TypeScript lambda function",
       "metric": "g21"
     },
+    "ts#dcr-proxy": {
+      "factory": "./src/ts/dcr-proxy/generator",
+      "schema": "./src/ts/dcr-proxy/schema.json",
+      "description": "Generate an OAuth Dynamic Client Registration (DCR) proxy construct for Cognito-authenticated MCP servers",
+      "metric": "g67"
+    },
     "ts#mcp-server": {
       "factory": "./src/ts/mcp-server/generator",
       "schema": "./src/ts/mcp-server/schema.json",
@@ -194,6 +247,13 @@
       "metric": "g17",
       "guidePages": ["nx-generator"]
     },
+    "ts#nx-migration": {
+      "factory": "./src/ts/nx-migration/generator",
+      "schema": "./src/ts/nx-migration/schema.json",
+      "description": "Generator for adding an Nx Migration to an Nx Plugin, applied by nx migrate when users upgrade",
+      "metric": "g68",
+      "guidePages": ["nx-migration"]
+    },
     "ts#nx-plugin": {
       "factory": "./src/ts/nx-plugin/generator",
       "schema": "./src/ts/nx-plugin/schema.json",
@@ -211,7 +271,7 @@
       "factory": "./src/ts/website/app/generator",
       "schema": "./src/ts/website/app/schema.json",
       "description": "Generates a website application",
-      "metric": "g43",
+      "metric": "g60",
       "guidePages": ["website", "react-website"]
     },
     "ts#website#auth": {
@@ -279,6 +339,13 @@
       "metric": "g35",
       "hidden": true
     },
+    "ts#agent#gateway-connection": {
+      "factory": "./src/ts/agent/gateway-connection/generator",
+      "schema": "./src/ts/agent/gateway-connection/schema.json",
+      "description": "Connect a TypeScript Agent to an AgentCore Gateway",
+      "metric": "g50",
+      "hidden": true
+    },
     "py#agent#a2a-connection": {
       "factory": "./src/py/agent/a2a-connection/generator",
       "schema": "./src/py/agent/a2a-connection/schema.json",
@@ -286,10 +353,17 @@
       "metric": "g36",
       "hidden": true
     },
+    "py#agent#gateway-connection": {
+      "factory": "./src/py/agent/gateway-connection/generator",
+      "schema": "./src/py/agent/gateway-connection/schema.json",
+      "description": "Connect a Python Agent to an AgentCore Gateway",
+      "metric": "g51",
+      "hidden": true
+    },
     "ts#sync": {
       "factory": "./src/ts/sync/generator",
       "schema": "./src/ts/sync/schema.json",
-      "description": "TypeScript path alias sync generator",
+      "description": "TypeScript path alias and local workspace dependency sync generator",
       "metric": "g29",
       "hidden": true
     },
@@ -353,28 +427,28 @@
     "ts#dynamodb": {
       "factory": "./src/ts/dynamodb/generator",
       "schema": "./src/ts/dynamodb/schema.json",
-      "description": "Create a DynamoDB project",
-      "metric": "g43"
+      "description": "Create a TypeScript DynamoDB project",
+      "metric": "g61"
     },
     "ts#dynamodb#trpc-connection": {
       "factory": "./src/ts/dynamodb/trpc-connection/generator",
       "schema": "./src/ts/dynamodb/trpc-connection/schema.json",
       "description": "Connect a ts#trpc-api project to a ts#dynamodb project",
-      "metric": "g44",
+      "metric": "g62",
       "hidden": true
     },
     "ts#dynamodb#smithy-connection": {
       "factory": "./src/ts/dynamodb/smithy-connection/generator",
       "schema": "./src/ts/dynamodb/smithy-connection/schema.json",
       "description": "Connect a Smithy backend to a ts#dynamodb project",
-      "metric": "g45",
+      "metric": "g63",
       "hidden": true
     },
     "ts#dynamodb#agent-connection": {
       "factory": "./src/ts/dynamodb/agent-connection/generator",
       "schema": "./src/ts/dynamodb/agent-connection/schema.json",
       "description": "Connect a ts#agent to a ts#dynamodb project",
-      "metric": "g46",
+      "metric": "g64",
       "hidden": true
     },
     "ts#dynamodb#mcp-server-connection": {
@@ -383,6 +457,67 @@
       "description": "Connect a ts#mcp-server to a ts#dynamodb project",
       "metric": "g47",
       "hidden": true
+    },
+    "py#dynamodb": {
+      "factory": "./src/py/dynamodb/generator",
+      "schema": "./src/py/dynamodb/schema.json",
+      "description": "Create a Python DynamoDB project",
+      "metric": "g52"
+    },
+    "py#dynamodb#fast-api-connection": {
+      "factory": "./src/py/dynamodb/fast-api-connection/generator",
+      "schema": "./src/py/dynamodb/fast-api-connection/schema.json",
+      "description": "Connect a py#fast-api project to a py#dynamodb project",
+      "metric": "g53",
+      "hidden": true
+    },
+    "py#dynamodb#agent-connection": {
+      "factory": "./src/py/dynamodb/agent-connection/generator",
+      "schema": "./src/py/dynamodb/agent-connection/schema.json",
+      "description": "Connect a py#agent to a py#dynamodb project",
+      "metric": "g54",
+      "hidden": true
+    },
+    "py#dynamodb#mcp-server-connection": {
+      "factory": "./src/py/dynamodb/mcp-server-connection/generator",
+      "schema": "./src/py/dynamodb/mcp-server-connection/schema.json",
+      "description": "Connect a py#mcp-server to a py#dynamodb project",
+      "metric": "g55",
+      "hidden": true
+    },
+    "py#rdb": {
+      "factory": "./src/py/rdb/generator",
+      "schema": "./src/py/rdb/schema.json",
+      "description": "Create a Python relational database project",
+      "metric": "g56"
+    },
+    "py#rdb#fast-api-connection": {
+      "factory": "./src/py/rdb/fast-api-connection/generator",
+      "schema": "./src/py/rdb/fast-api-connection/schema.json",
+      "description": "Connect a py#fast-api project to a py#rdb project",
+      "metric": "g57",
+      "hidden": true
+    },
+    "py#rdb#agent-connection": {
+      "factory": "./src/py/rdb/agent-connection/generator",
+      "schema": "./src/py/rdb/agent-connection/schema.json",
+      "description": "Connect a py#agent to a py#rdb project",
+      "metric": "g58",
+      "hidden": true
+    },
+    "py#rdb#mcp-server-connection": {
+      "factory": "./src/py/rdb/mcp-server-connection/generator",
+      "schema": "./src/py/rdb/mcp-server-connection/schema.json",
+      "description": "Connect a py#mcp-server to a py#rdb project",
+      "metric": "g59",
+      "hidden": true
+    },
+    "internal#test-matrix": {
+      "factory": "./src/internal/test-matrix/generator",
+      "schema": "./src/internal/test-matrix/schema.json",
+      "description": "Scaffold every generator permutation for end to end tests",
+      "metric": "t1",
+      "hidden": true
     }
   }
 }

package/migrations.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "name": "@aws/nx-plugin",
+  "generators": {
+    "latest-gateway-agent-targets": {
+      "version": "1.0.0-rc.59",
+      "description": "Add agent runtime target support to the vended AgentCoreGateway construct and an agentName member to vended agent constructs",
+      "implementation": "./src/migrations/latest/gateway-agent-targets/migration"
+    },
+    "latest-gateway-cognito-passthrough": {
+      "version": "1.0.0-rc.60",
+      "description": "Front Cognito agents with an AgentCore Gateway via JWT passthrough: addAgent picks the target credential from the agent's auth, agent constructs gain an auth member, and Cognito runtimes allowlist the Authorization header",
+      "implementation": "./src/migrations/latest/gateway-cognito-passthrough/migration"
+    },
+    "latest-smithy-ssdk-bundle-pins": {
+      "version": "1.0.0-rc.58",
+      "description": "Bump the rolldown and dts plugin pins in the Smithy build.Dockerfile so the bundled SSDK type declaration resolves",
+      "implementation": "./src/migrations/latest/smithy-ssdk-bundle-pins/migration"
+    },
+    "latest-strip-pip-from-python-images": {
+      "version": "1.0.0-rc.60",
+      "description": "Remove pip from vended Python agent / MCP server images so its vulnerable vendored packages are not present at runtime",
+      "implementation": "./src/migrations/latest/strip-pip-from-python-images/migration"
+    },
+    "latest-waf-log-group-removal": {
+      "version": "1.0.0-rc.60",
+      "description": "Set RemovalPolicy.DESTROY on WAF log groups in the vended AgentCoreGateway and REST API constructs so a rolled-back deploy does not orphan them",
+      "implementation": "./src/migrations/latest/waf-log-group-removal/migration"
+    },
+    "v1.0.0-rc.50-modernize-function-props-cast": {
+      "version": "1.0.0-rc.50",
+      "description": "Replace the legacy angle-bracket FunctionProps type assertion with the modern as syntax in generated API constructs",
+      "implementation": "./src/migrations/v1.0.0-rc.50/modernize-function-props-cast/migration"
+    },
+    "v1.0.0-rc.50-restrict-cors-to-custom-domains": {
+      "version": "1.0.0-rc.50",
+      "description": "Include CloudFront custom domain aliases in restrictCorsTo and UserIdentity callback URLs",
+      "implementation": "./src/migrations/v1.0.0-rc.50/restrict-cors-to-custom-domains/migration"
+    },
+    "v1.0.0-rc.50-terraform-bootstrap-adopt-existing-bucket": {
+      "version": "1.0.0-rc.50",
+      "description": "Adopt an existing Terraform state bucket in the vended bootstrap script when its state object is missing",
+      "implementation": "./src/migrations/v1.0.0-rc.50/terraform-bootstrap-adopt-existing-bucket/migration"
+    },
+    "v1.0.0-rc.52-user-identity-waf-allow-localhost-callback": {
+      "version": "1.0.0-rc.52",
+      "description": "Count the EC2MetaDataSSRF_QUERYARGUMENTS WAF rule on the UserIdentity Web ACL so sign-in from a local dev server is not blocked",
+      "implementation": "./src/migrations/v1.0.0-rc.52/user-identity-waf-allow-localhost-callback/migration"
+    },
+    "v1.0.0-rc.54-order-access-log-delivery-after-bucket-policy": {
+      "version": "1.0.0-rc.54",
+      "description": "Order the S3 server access log delivery source after the bucket policy to avoid a 409 from concurrent bucket configuration writes",
+      "implementation": "./src/migrations/v1.0.0-rc.54/order-access-log-delivery-after-bucket-policy/migration"
+    },
+    "v1.0.0-rc.55-backfill-generator-metadata": {
+      "version": "1.0.0-rc.55",
+      "description": "Backfill the project metadata the version sync reads, recovered from the files the generators left behind",
+      "implementation": "./src/migrations/v1.0.0-rc.55/backfill-generator-metadata/migration"
+    },
+    "v1.0.0-rc.56-dynamodb-local-remove-optimize-flag": {
+      "version": "1.0.0-rc.56",
+      "description": "Drop -optimizeDbBeforeStartup from the vended DynamoDB Local container script, which can corrupt shared-local-instance.db",
+      "implementation": "./src/migrations/v1.0.0-rc.56/dynamodb-local-remove-optimize-flag/migration"
+    },
+    "v1.0.0-rc.57-ts-agent-session-management-support": {
+      "version": "1.0.0-rc.57",
+      "description": "Add session management support to ts#agent",
+      "implementation": "./src/migrations/v1.0.0-rc.57/ts-agent-session-management-support/migration"
+    },
+    "sync-vended-versions": {
+      "version": "1.0.0-rc.60",
+      "description": "Sync vended dependency versions and the tracked plugin version to those vended by this release",
+      "implementation": "./src/utils/version-upgrade-migration/migration"
+    }
+  },
+  "packageJsonUpdates": {
+    "nx-23.1.1-nx-packages": {
+      "version": "1.0.0-rc.60",
+      "packages": {
+        "nx": {
+          "version": "23.1.1",
+          "alwaysAddToPackageJson": false
+        },
+        "@nx/devkit": {
+          "version": "23.1.1",
+          "alwaysAddToPackageJson": false
+        },
+        "@nx/js": {
+          "version": "23.1.1",
+          "alwaysAddToPackageJson": false
+        },
+        "@nx/react": {
+          "version": "23.1.1",
+          "alwaysAddToPackageJson": false
+        },
+        "@nx/vite": {
+          "version": "23.1.1",
+          "alwaysAddToPackageJson": false
+        },
+        "@nx/vitest": {
+          "version": "23.1.1",
+          "alwaysAddToPackageJson": false
+        },
+        "@nx/workspace": {
+          "version": "23.1.1",
+          "alwaysAddToPackageJson": false
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,48 +1,64 @@
 {
   "name": "@aws/nx-plugin",
-  "version": "1.0.0-rc.6",
+  "version": "1.0.0-rc.60",
   "repository": {
     "type": "git",
     "url": "https://github.com/awslabs/nx-plugin-for-aws.git",
     "directory": "packages/nx-plugin"
   },
   "private": false,
-  "type": "commonjs",
+  "type": "module",
   "license": "Apache-2.0",
   "main": "./src/index.js",
+  "module": "./src/index.js",
+  "types": "./src/index.d.ts",
   "typings": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./sdk/*": {
+      "types": "./src/sdk/*.d.ts",
+      "default": "./src/sdk/*.js"
+    },
+    "./package.json": "./package.json"
+  },
   "publishConfig": {
     "access": "public"
   },
-  "bin": {
-    "aws-nx-mcp": "./bin/aws-nx-mcp.js"
-  },
   "generators": "./generators.json",
   "executors": "./executors.json",
+  "nx-migrations": {
+    "migrations": "./migrations.json"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
   "peerDependencies": {
-    "nx": "22.7.5"
+    "nx": "23.1.1"
   },
   "dependencies": {
     "@apidevtools/swagger-parser": "12.1.0",
-    "@biomejs/js-api": "4.0.0",
-    "@biomejs/wasm-nodejs": "2.4.16",
+    "@astral-sh/ruff-wasm-nodejs": "0.16.1",
+    "@biomejs/js-api": "6.0.0",
+    "@biomejs/wasm-nodejs": "2.5.6",
     "@getgrit/gritql": "0.0.3",
-    "@hey-api/openapi-ts": "0.64.13",
     "@iarna/toml": "2.2.5",
-    "@modelcontextprotocol/sdk": "1.29.0",
-    "@nx/devkit": "22.7.5",
-    "@nx/js": "22.7.5",
-    "@nx/react": "22.7.5",
-    "@nx/vite": "22.7.5",
+    "@modelcontextprotocol/sdk": "1.30.0",
+    "@nx/devkit": "23.1.1",
+    "@nx/js": "23.1.1",
+    "@nx/react": "23.1.1",
+    "@nx/vite": "23.1.1",
+    "@nxlv/python": "22.2.2",
+    "@phenomnomnominal/tsquery": "6.2.0",
     "@types/estree": "1.0.9",
     "@types/js-yaml": "4.0.9",
     "@types/mdast": "4.0.4",
-    "@nxlv/python": "22.1.4",
-    "@phenomnomnominal/tsquery": "6.2.0",
     "enquirer": "2.4.1",
     "fast-glob": "3.3.3",
-    "jiti": "2.6.1",
-    "js-yaml": "4.2.0",
+    "jiti": "2.7.0",
+    "js-yaml": "4.3.1",
     "license-checker-rseidelsohn": "4.4.2",
     "lodash.camelcase": "4.3.0",
     "lodash.clonedeepwith": "4.5.0",
@@ -51,20 +67,23 @@
     "lodash.trim": "4.18.0",
     "lodash.uniqby": "4.7.0",
     "mdast-util-mdx-jsx": "3.2.0",
-    "minimatch": "10.2.5",
+    "minimatch": "10.2.6",
     "openapi-types": "12.1.3",
     "pip-requirements-js": "1.0.3",
     "remark-frontmatter": "5.0.0",
     "remark-mdx": "3.1.1",
     "remark-parse": "11.0.0",
     "remark-stringify": "11.0.0",
+    "semver": "7.8.5",
     "spdx-satisfies": "6.0.0",
     "typescript": "6.0.3",
     "unified": "11.0.5",
     "unist-util-visit": "5.1.0",
-    "vite": "8.0.14",
-    "vitest": "4.1.7",
+    "vite": "8.2.0",
+    "vitest": "4.1.10",
     "zod": "4.4.3"
   },
-  "types": "./src/index.d.ts"
+  "devDependencies": {
+    "@types/semver": "7.8.0"
+  }
 }