@aws/nx-plugin 0.0.0

package/src/gitlab/generator.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    default: function() {
+        return _default;
+    },
+    gitlabGenerator: function() {
+        return gitlabGenerator;
+    }
+});
+const _devkit = require("@nx/devkit");
+async function gitlabGenerator(tree, options) {
+    (0, _devkit.generateFiles)(tree, (0, _devkit.joinPathFragments)(__dirname, 'files'), '.', options);
+    await (0, _devkit.formatFiles)(tree);
+}
+const _default = gitlabGenerator;
+
+//# sourceMappingURL=generator.js.map

package/src/gitlab/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/gitlab/generator.ts"],"sourcesContent":["import { formatFiles, generateFiles, Tree, joinPathFragments } from '@nx/devkit';\nimport { GitlabGeneratorSchema } from './schema';\n\nexport async function gitlabGenerator(\n  tree: Tree,\n  options: GitlabGeneratorSchema\n) {\n  generateFiles(tree, joinPathFragments(__dirname, 'files'), '.', options);\n  await formatFiles(tree);\n}\n\nexport default gitlabGenerator;\n"],"names":["gitlabGenerator","tree","options","generateFiles","joinPathFragments","__dirname","formatFiles"],"rangeMappings":";;;;;;;;;;;;;;;;;;;;;;;","mappings":";;;;;;;;;;;IAWA,OAA+B;eAA/B;;IARsBA,eAAe;eAAfA;;;wBAH8C;AAG7D,eAAeA,gBACpBC,IAAU,EACVC,OAA8B;IAE9BC,IAAAA,qBAAa,EAACF,MAAMG,IAAAA,yBAAiB,EAACC,WAAW,UAAU,KAAKH;IAChE,MAAMI,IAAAA,mBAAW,EAACL;AACpB;MAEA,WAAeD"}

package/src/gitlab/schema.d.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+
+//# sourceMappingURL=schema.d.js.map

package/src/gitlab/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/gitlab/schema.d.ts"],"names":[],"rangeMappings":"","mappings":""}

package/src/gitlab/schema.d.ts

@@ -0,0 +1,5 @@
+export interface GitlabGeneratorSchema {
+  infraProject: string;
+  roleArn: string;
+  region: string;
+}

package/src/gitlab/schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "Gitlab",
+  "title": "",
+  "type": "object",
+  "properties": {
+    "infraProject": {
+      "description": "The infrastructure project.",
+      "type": "string",
+      "alias": "dir",
+      "x-priority": "important",
+      "x-prompt": "the infrastructure project",
+      "x-dropdown": "projects"
+    },
+    "roleArn": {
+      "description": "The role ARN to assume.",
+      "type": "string",
+      "x-priority": "important",
+      "x-prompt": "the role ARN to assume"
+    },
+    "region": {
+      "description": "The region to deploy into.",
+      "type": "string",
+      "x-priority": "important",
+      "x-prompt": {
+        "message": "Which region would you like to deploy into?",
+        "type": "list",
+        "items": [
+          { "value": "us-east-1", "label": "us-east-1" },
+          { "value": "us-east-2", "label": "us-east-2" },
+          { "value": "us-west-1", "label": "us-west-1" },
+          { "value": "us-west-2", "label": "us-west-2" },
+          { "value": "ca-central-1", "label": "ca-central-1" },
+          { "value": "eu-west-1", "label": "eu-west-1" },
+          { "value": "eu-central-1", "label": "eu-central-1" },
+          { "value": "eu-west-2", "label": "eu-west-2" },
+          { "value": "eu-west-3", "label": "eu-west-3" },
+          { "value": "eu-north-1", "label": "eu-north-1" },
+          { "value": "ap-northeast-1", "label": "ap-northeast-1" },
+          { "value": "ap-northeast-2", "label": "ap-northeast-2" },
+          { "value": "ap-southeast-1", "label": "ap-southeast-1" },
+          { "value": "ap-southeast-2", "label": "ap-southeast-2" },
+          { "value": "ap-south-1", "label": "ap-south-1" },
+          { "value": "sa-east-1", "label": "sa-east-1" },
+          { "value": "us-gov-west-1", "label": "us-gov-west-1" },
+          { "value": "us-gov-east-1", "label": "us-gov-east-1" }
+        ]
+      }
+    }
+  },
+  "required": ["infraProject", "roleArn", "region"]
+}

package/src/index.js

@@ -0,0 +1,3 @@
+"use strict";
+
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../packages/nx-plugin/src/index.ts"],"names":[],"rangeMappings":"","mappings":""}

package/src/infra/app/README.md

@@ -0,0 +1,175 @@
+# Infrastructure App Generator
+
+## Overview
+This generator creates a new AWS CDK infrastructure application. The generated application includes security best practices through PDK Nag checks and provides infrastructure visualization. The codebase is structured using TypeScript and ES Modules (ESM) for modern development practices.
+
+## Usage
+
+You can generate a new infrastructure application 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 application:
+1. Open the NX Console in VSCode
+2. Click on "Generate"
+3. Search for "infra#app"
+4. Fill in the required parameters in the form
+5. Click "Run"
+
+### 2. Using CLI
+
+Generate the application:
+```bash
+nx g @aws/nx-plugin:infra#app my-infra --directory=apps/infrastructure
+```
+
+You can also perform a dry-run to see what files would be generated without actually creating them:
+```bash
+nx g @aws/nx-plugin:infra#app my-infra --directory=apps/infrastructure --dry-run
+```
+
+## Input Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| name* | string | - | The name of the application (required). Must start with a letter and not contain colons. |
+| directory | string | "packages" | The directory to store the application in. |
+| unitTestRunner | string | "vitest" | Test runner for unit tests. Options: jest, vitest, none |
+
+*Required parameter
+
+## Expected Output
+
+The generator creates an infrastructure application with the following structure:
+
+```
+<directory>/<name>/
+├── src/
+│   ├── main.ts           # Application entry point with CDK and PDK setup
+│   └── stacks/          # CDK stack definitions
+│       └── application-stack.ts  # Main application stack
+├── cdk.json            # CDK configuration
+├── tsconfig.json       # TypeScript configuration
+└── project.json       # Project configuration and build targets
+```
+
+Additionally, it:
+1. Configures build settings for CDK synthesis and deployment
+2. Installs required dependencies:
+   - @aws/pdk
+   - aws-cdk-lib
+   - aws-cdk
+   - constructs
+   - esbuild
+   - source-map-support
+   - tsx (dev dependency)
+
+## Features
+
+### 1. PDK Integration
+The generated application includes PDK (Project Development Kit) integration which provides:
+- Security best practices through PDK Nag checks
+- Infrastructure visualization with CDK Graph
+- Threat modeling capabilities through Threat Composer
+
+### 2. Infrastructure Visualization
+The application automatically generates infrastructure diagrams using CDK Graph:
+```typescript
+const graph = new CdkGraph(app, {
+  plugins: [
+    new CdkGraphDiagramPlugin({
+      defaults: {
+        filterPlan: {
+          preset: FilterPreset.COMPACT,
+          filters: [{ store: Filters.pruneCustomResources() }],
+        },
+      },
+    }),
+    new CdkGraphThreatComposerPlugin(),
+  ],
+});
+```
+
+### 3. Security Checks
+PDK Nag is configured with AWS Prototyping Checks to ensure infrastructure security:
+```typescript
+const app = PDKNag.app({
+  nagPacks: [new AwsPrototypingChecks()],
+});
+```
+
+### 4. Build and Deploy Targets
+The generator configures two main targets in your project.json:
+
+1. **Build Target**
+   - Synthesizes CDK templates
+   - Caches results for faster subsequent builds
+   - Outputs to `dist/<directory>/cdk.out`
+
+2. **Deploy Target**
+   - Deploys infrastructure to AWS
+   - Configures automatic approval for CI/CD pipelines
+   - Uses synthesized templates from the build target
+
+## Working with the Generated Application
+
+### Adding Resources
+
+Add AWS resources to your stack in `src/stacks/application-stack.ts`:
+
+```typescript
+import * as cdk from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+import { UserIdentity, StaticWebsite, MyApi } from ':my-org/common-constructs'
+import { HttpIamAuthorizer } from 'aws-cdk-lib/aws-apigatewayv2-authorizers';
+
+export class ApplicationStack extends cdk.Stack {
+  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
+    super(scope, id, props);
+
+    const identity = new UserIdentity(this, 'UserIdentity');
+    const myapi = new MyApi(this, 'MyApi', {
+      defaultAuthorizer: new HttpIamAuthorizer(),
+    });
+    myapi.grantInvokeAccess(identity.identityPool.authenticatedRole);
+    new StaticWebsite(this, 'Website');
+  }
+}
+```
+
+The generated code serves as a starting point that you can adapt to your specific infrastructure requirements while maintaining security best practices.
+
+### Building the Application
+
+To create a production build:
+```bash
+nx build my-infra
+```
+
+All built code is located in the `dist` folder at the root of your workspace. For example, if your infrastructure application is in `apps/infrastructure/my-infra`, the built code will be in `dist/apps/infrastructure/my-infra`. This includes:
+- Compiled TypeScript files
+- CDK synthesized templates in `dist/apps/infrastructure/my-infra/cdk.out`
+- Generated infrastructure diagrams
+- Source maps for debugging
+
+### Deploying to AWS
+
+To deploy your infrastructure:
+
+```bash
+nx deploy my-infra
+```
+
+This command will deploy your infrastructure to AWS using the account and region configured in your AWS CLI.
+
+You can also perform a hotswap deployment if you are only making modifications to existing resources via the following command:
+
+```bash
+nx deploy my-infra --hotswap
+```