@aligent/nx-cdk 0.6.0 → 0.8.0

package/README.md

@@ -59,13 +59,17 @@ The service generator creates a new CDK service within the `services/` folder of
 
 ```bash
 yarn nx g @aligent/nx-cdk:service <service-name>
+
+# Or simply (since the generator name is unique):
+yarn nx g service <service-name>
 ```
 
 #### Options
 
-| Option | Type   | Required | Description                                                               |
-| ------ | ------ | -------- | ------------------------------------------------------------------------- |
-| `name` | string | Yes      | The name of the service (cannot contain 'Stack' or 'Service' in the name) |
+| Option    | Type    | Required | Default | Description                                                               |
+| --------- | ------- | -------- | ------- | ------------------------------------------------------------------------- |
+| `name`    | string  | Yes      | -       | The name of the service (cannot contain 'Stack' or 'Service' in the name) |
+| `example` | boolean | No       | `false` | Generate example code with sample resources                               |
 
 #### What it creates
 
@@ -89,11 +93,56 @@ The service generator creates a new service in `services/<service-name>/` with:
 #### Example
 
 ```bash
-# Create a new service named "user-management"
+# Create a new service named "user-management" (short form)
+yarn nx g service user-management
+
+# Or with the full plugin prefix
 yarn nx g @aligent/nx-cdk:service user-management
+```
+
+### Remove Service Generator
+
+The remove-service generator cleanly removes a service and all of its references from the project. It reverses the changes made by the service generator, ensuring no dangling imports or references are left behind.
+
+#### Usage
+
+```bash
+yarn nx g @aligent/nx-cdk:remove-service <service-name>
+
+# Or simply (since the generator name is unique):
+yarn nx g remove-service <service-name>
+```
+
+#### Options
+
+| Option        | Type    | Required | Default | Description                                     |
+| ------------- | ------- | -------- | ------- | ----------------------------------------------- |
+| `name`        | string  | Yes      | -       | The name of the service to remove               |
+| `forceRemove` | boolean | No       | `false` | Skip dependency check when removing the project |
+
+#### What it does
+
+The remove generator performs the following cleanup:
+
+- **Application updates**:
+  - Removes the service's import declaration from `application/lib/service-stacks.ts`
+  - Removes the stack instantiation from the `ApplicationStage` constructor
+
+- **Root updates**:
+  - Removes the service from the root `tsconfig.json` references
+  - Removes the service from the root `package.json` workspaces (if present)
+
+- **Service files**:
+  - Deletes the entire `services/<service-name>/` directory
+
+#### Example
+
+```bash
+# Remove the "user-management" service (short form)
+yarn nx g remove-service user-management
 
-# Create a new service named "payment-processing"
-yarn nx g @aligent/nx-cdk:service payment-processing
+# Or with the full plugin prefix
+yarn nx g @aligent/nx-cdk:remove-service user-management
 ```
 
 ## Project Structure

package/generators.json

@@ -10,6 +10,11 @@
             "factory": "./src/generators/service/generator",
             "schema": "./src/generators/service/schema.json",
             "description": "Generate a new service"
+        },
+        "remove-service": {
+            "factory": "./src/generators/remove-service/generator",
+            "schema": "./src/generators/remove-service/schema.json",
+            "description": "Remove a service and clean up its references"
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aligent/nx-cdk",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "type": "commonjs",
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",

package/src/generators/constants.d.ts

@@ -0,0 +1,5 @@
+export type ProjectType = 'application' | 'service';
+export declare const MAIN_APPLICATION_FOLDER = "application";
+export declare const MAIN_APPLICATION_NAME = "application";
+export declare const SERVICES_FOLDER = "services";
+export declare const SERVICES_SCOPE = "@services";

package/src/generators/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVICES_SCOPE = exports.SERVICES_FOLDER = exports.MAIN_APPLICATION_NAME = exports.MAIN_APPLICATION_FOLDER = void 0;
+exports.MAIN_APPLICATION_FOLDER = 'application';
+exports.MAIN_APPLICATION_NAME = 'application';
+exports.SERVICES_FOLDER = 'services';
+exports.SERVICES_SCOPE = '@services';

package/src/generators/helpers/configs/base-package/package.json

@@ -21,10 +21,11 @@
     "@aligent/microservice-util-lib": "^1.2.0"
   },
   "devDependencies": {
-    "@aligent/cdk-aspects": "^0.5.0",
-    "@aligent/cdk-step-function-from-file": "^0.3.2",
-    "@aligent/nx-openapi": "^1.0.0",
-    "@aligent/ts-code-standards": "^4.1.0",
+    "@aligent/cdk-aspects": "^0.5.5",
+    "@aligent/cdk-nodejs-function-from-entry": "^0.2.1",
+    "@aligent/cdk-step-function-from-file": "^0.5.1",
+    "@aligent/nx-openapi": "^2.1.1",
+    "@aligent/ts-code-standards": "^4.2.1",
     "@nx/eslint": "22.1.3",
     "@nx/eslint-plugin": "22.1.3",
     "@nx/js": "22.1.3",
@@ -39,10 +40,10 @@
     "@typescript-eslint/parser": "8.44.0",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/ui": "^3.2.4",
-    "aws-cdk": "^2.1033.0",
-    "aws-cdk-lib": "^2.235.1",
-    "cdk-nag": "^2.37.55",
-    "constructs": "^10.4.3",
+    "aws-cdk": "^2.1120.0",
+    "aws-cdk-lib": "^2.251.0",
+    "cdk-nag": "^2.38.2",
+    "constructs": "^10.6.0",
     "eslint": "^9.32.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
@@ -52,7 +53,6 @@
     "nx": "22.1.3",
     "prettier": "^3.6.2",
     "rolldown": "1.0.0-rc.1",
-    "store-parameters": "^1.1.3",
     "tslib": "^2.8.1",
     "tsx": "^4.21.0",
     "typescript": "~5.9.2",
@@ -60,24 +60,7 @@
     "vitest": "^3.2.4"
   },
   "nx": {
-    "includedScripts": [],
-    "targets": {
-      "parameters": {
-        "executor": "nx:run-commands",
-        "options": {
-          "color": true,
-          "cwd": "parameters"
-        },
-        "configurations": {
-          "import": {
-            "command": "store-parameters import {args.file} --delimiter=|"
-          },
-          "export": {
-            "command": "store-parameters export {args.file} --path={args.path} --delimiter=|"
-          }
-        }
-      }
-    }
+    "includedScripts": []
   },
   "workspaces": [
     "application",

package/src/generators/helpers/configs/nxJson.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NX_JSON = void 0;
+const constants_1 = require("../../constants");
 exports.NX_JSON = {
     $schema: './node_modules/nx/schemas/nx-schema.json',
     defaultBase: 'origin/staging',
@@ -37,7 +38,11 @@ exports.NX_JSON = {
             configurations: { coverage: { coverage: true } },
         },
         typecheck: { cache: true, inputs: ['default', '^production'] },
-        cdk: { dependsOn: [{ target: 'build', params: 'forward', projects: '@services/*' }] },
-        pg: { dependsOn: [{ target: 'build', params: 'forward', projects: '@services/*' }] },
+        cdk: {
+            dependsOn: [{ target: 'build', params: 'forward', projects: `${constants_1.SERVICES_SCOPE}/*` }],
+        },
+        pg: {
+            dependsOn: [{ target: 'build', params: 'forward', projects: `${constants_1.SERVICES_SCOPE}/*` }],
+        },
     },
 };

package/src/generators/helpers/utilities.d.ts

@@ -1,4 +1,5 @@
 import { Tree } from '@nx/devkit';
+import { ProjectType } from '../constants';
 interface PackageJsonInput {
     name: string;
     projectName: string;
@@ -20,7 +21,7 @@ export declare function constructPackageJsonFile(input: PackageJsonInput): {
         node?: never;
     };
 };
-export declare function constructProjectTsConfigFiles(type: 'application' | 'service'): {
+export declare function constructProjectTsConfigFiles(type: ProjectType): {
     tsConfig: {
         extends: string;
         compilerOptions?: Record<string, unknown>;
@@ -61,6 +62,25 @@ export declare function getGeneratorVersion(): string;
  * @throws {Error} If the ApplicationStage constructor cannot be found in service-stacks.ts
  */
 export declare function addServiceStackToMainApplication(tree: Tree, service: Service, projectName: string): void;
+/**
+ * Removes a service stack registration from the main CDK application's ApplicationStage.
+ *
+ * This function modifies the service-stacks.ts file by:
+ * 1. Removing import statements that reference the service's module specifier
+ * 2. Removing statements in the ApplicationStage constructor that reference the service's stack class
+ *
+ * @param tree - The Nx virtual file system tree
+ * @param serviceName - The name of the service (e.g., "companies")
+ * @param projectName - The name of the main application project
+ */
+export declare function removeServiceFromMainApplication(tree: Tree, serviceName: string, projectName: string): void;
+/**
+ * Removes a project reference from the root tsconfig.json.
+ *
+ * @param tree - The Nx virtual file system tree
+ * @param referencePath - The path to remove from the references array
+ */
+export declare function removeTsConfigReference(tree: Tree, referencePath: string): void;
 /**
  * Splits a kebab-case name into an array of capitalized parts.
  *

package/src/generators/helpers/utilities.js

@@ -4,11 +4,14 @@ exports.constructPackageJsonFile = constructPackageJsonFile;
 exports.constructProjectTsConfigFiles = constructProjectTsConfigFiles;
 exports.getGeneratorVersion = getGeneratorVersion;
 exports.addServiceStackToMainApplication = addServiceStackToMainApplication;
+exports.removeServiceFromMainApplication = removeServiceFromMainApplication;
+exports.removeTsConfigReference = removeTsConfigReference;
 exports.splitInputName = splitInputName;
 /* v8 ignore start */
 const devkit_1 = require("@nx/devkit");
 const path_1 = require("path");
 const ts_morph_1 = require("ts-morph");
+const constants_1 = require("../constants");
 const tsConfigs_1 = require("./configs/tsConfigs");
 /**
  * Reads the base package.json configuration from a JSON file.
@@ -101,7 +104,7 @@ function addServiceStackToMainApplication(tree, service, projectName) {
         throw new Error('Unable to find main application stage constructor');
     }
     stackSource.addImportDeclaration({
-        moduleSpecifier: `@services/${service.name}`,
+        moduleSpecifier: `${constants_1.SERVICES_SCOPE}/${service.name}`,
         namedImports: [service.constant, service.stack],
     });
     const sharedInfra = stageConstructor.getVariableStatement('sharedInfra');
@@ -109,6 +112,69 @@ function addServiceStackToMainApplication(tree, service, projectName) {
     stageConstructor.addStatements(`new ${service.stack}(this, ${service.constant}.NAME, { ...props, ${sharedPropsStatement} description: ${service.constant}.DESCRIPTION });`);
     tree.write(stacksRelativePath, stackSource.getFullText());
 }
+/**
+ * Removes a service stack registration from the main CDK application's ApplicationStage.
+ *
+ * This function modifies the service-stacks.ts file by:
+ * 1. Removing import statements that reference the service's module specifier
+ * 2. Removing statements in the ApplicationStage constructor that reference the service's stack class
+ *
+ * @param tree - The Nx virtual file system tree
+ * @param serviceName - The name of the service (e.g., "companies")
+ * @param projectName - The name of the main application project
+ */
+function removeServiceFromMainApplication(tree, serviceName, projectName) {
+    const application = (0, devkit_1.readProjectConfiguration)(tree, projectName);
+    if (application.root.includes('..')) {
+        throw new Error('Invalid application root path');
+    }
+    const stacksRelativePath = (0, path_1.join)(application.root, 'lib/service-stacks.ts');
+    if (!tree.exists(stacksRelativePath)) {
+        console.log('Service Stacks does not exist, skipping service stacks cleanup.');
+        return;
+    }
+    const content = tree.read(stacksRelativePath, 'utf-8');
+    if (content === null) {
+        throw new Error(`Failed to read file: ${stacksRelativePath}`);
+    }
+    const fs = new ts_morph_1.InMemoryFileSystemHost();
+    fs.writeFileSync(stacksRelativePath, content);
+    const project = new ts_morph_1.Project({ fileSystem: fs });
+    const stackSource = project.addSourceFileAtPath(stacksRelativePath);
+    const imports = stackSource.getImportDeclarations();
+    for (const importDecl of imports) {
+        if (importDecl.getModuleSpecifierValue() === `${constants_1.SERVICES_SCOPE}/${serviceName}`) {
+            importDecl.remove();
+        }
+    }
+    const nameParts = splitInputName(serviceName);
+    const stackClassName = `${nameParts.join('')}Stack`;
+    const applicationStage = stackSource.getClass('ApplicationStage');
+    if (applicationStage) {
+        const stageConstructor = applicationStage.getConstructors()[0];
+        if (stageConstructor) {
+            const statements = stageConstructor.getStatements();
+            for (const statement of statements) {
+                if (statement.getText().includes(`new ${stackClassName}(`)) {
+                    statement.remove();
+                }
+            }
+        }
+    }
+    tree.write(stacksRelativePath, stackSource.getFullText());
+}
+/**
+ * Removes a project reference from the root tsconfig.json.
+ *
+ * @param tree - The Nx virtual file system tree
+ * @param referencePath - The path to remove from the references array
+ */
+function removeTsConfigReference(tree, referencePath) {
+    (0, devkit_1.updateJson)(tree, 'tsconfig.json', json => {
+        json.references = (json.references ?? []).filter((r) => r.path !== referencePath);
+        return json;
+    });
+}
 /**
  * Splits a kebab-case name into an array of capitalized parts.
  *

package/src/generators/preset/files/.gitignore.template

@@ -43,15 +43,15 @@
 !collection
 !collection/*
 !collection/**/*
+!clients
+!clients/*
+!clients/**/*
 !docs
 !docs/*
 !docs/**/*
 !libs
 !libs/*
 !libs/**/*
-!parameters
-!parameters/*
-!parameters/**/*
 !services
 !services/*
 !services/**/*

package/src/generators/preset/files/README.md.template

@@ -53,15 +53,6 @@ yarn install
 Before committing this repository, review and update the following generated defaults:
 
 - **`.github/CODEOWNERS`** — The default file references Aligent's GitHub teams (`@aligent/microservices`, `@aligent/devops`). Replace these with your own organisation's team handles.
-- **`package.json` `pg:*` scripts** — The playground scripts use `--profile playground`. Ensure you have a matching profile in your `~/.aws/config` file:
-
-    ```ini
-    [profile playground]
-    source_profile = default
-    role_arn = arn:aws:iam::11111111111:role/RoleName
-    ```
-
-    If your profile has a different name, update the `pg:*` scripts in the root `package.json` to match.
 
 ### Deployment
 
@@ -89,18 +80,7 @@ To add a new service to the monorepo:
     - `services/{service-name}/src/index.ts`
     - `services/{service-name}/src/infra/`
 3. Add Lambda handlers in `services/{service-name}/src/runtime/handlers/`
-
-## Environment Parameters Management
-
-Parameters are managed through the `parameters/{env}.csv` file by default
-
-```bash
-# Import values from `parameters/{env}.csv` to Parameter Store in AWS
-yarn nx run <%= name %>-int:parameters:import --file=dev.csv
-
-# Custom filename and parameter path can be passed in as arguments
-yarn nx run <%= name %>-int:parameters:export --file=dev.csv --path=/my/dev/path
-```
+4. Run `yarn install` again so Yarn Workspace get synced.
 
 ## License
 

package/src/generators/preset/files/application/README.md.template

@@ -6,11 +6,21 @@ This application manages the deployment of microservices and their shared infras
 
 ### Using yarn script from workspace root (Recommended)
 
+**The `pg:*` scripts** — The playground scripts use `--profile playground`. Ensure you have a matching profile in your `~/.aws/config` file:
+
+    ```ini
+    [profile playground]
+    source_profile = default
+    role_arn = arn:aws:iam::11111111111:role/RoleName
+    ```
+
+    If your profile has a different name, update the `pg:*` scripts in the root `package.json` to match.
+
 ##### Synthesize
 
 ```bash
 # Synthesize for default environment/stage (dev)
-yarn pg:synth
+yarn pg:synth --args="dev/**"
 
 # Synthesize for a custom environment/stage
 yarn pg:synth --args="plg/** -c environment=plg"
@@ -20,7 +30,7 @@ yarn pg:synth --args="plg/** -c environment=plg"
 
 ```bash
 # Deploy for default environment/stage (dev)
-yarn pg:deploy
+yarn pg:deploy --args="dev/**"
 
 # Deploy to a custom environment/stage
 yarn pg:deploy --args="plg/** -c environment=plg"
@@ -30,20 +40,20 @@ yarn pg:deploy --args="plg/** -c environment=plg"
 
 ```bash
 # Diff checking for default environment/stage (dev)
-yarn pg:diff
+yarn pg:diff --args="dev/**"
 
 # Diff checking for a custom environment/stage
-yarn pg:diff --args="-c environment=plg"
+yarn pg:diff --args="plg/** -c environment=plg"
 ```
 
 ##### Destroy
 
 ```bash
 # Destroy default environment/stage (dev)
-yarn pg:destroy
+yarn pg:destroy --args="dev/**"
 
 # Destroy a custom environment/stage
-yarn pg:destroy --args="-c environment=plg"
+yarn pg:destroy --args="plg/** -c environment=plg"
 ```
 
 ### Direct Nx Commands

package/src/generators/preset/files/libs/infra/src/index.ts.template

@@ -1,16 +1,12 @@
 import { Stack, Stage, StackProps, Tags } from 'aws-cdk-lib';
 import { Construct } from 'constructs';
-<% if (example) { %>import { Secret } from 'aws-cdk-lib/aws-secretsmanager';
-import { IStringParameter, StringParameter } from 'aws-cdk-lib/aws-ssm';<% } %>
 
 export interface SharedInfraProps {
-    <% if (example) { %>paramExample: IStringParameter;
-    secretExample: Secret;<% } %>
+    // TODO: Add shared infrastructure properties (e.g. SSM parameters, secrets)
 }
 
 export class SharedInfraStack extends Stack {
-    <% if (example) { %>readonly paramExample: IStringParameter;
-    readonly secretExample: Secret;<% } %>
+    // TODO: Add readonly properties for shared resources
 
     constructor(scope: Construct, id: string, props?: StackProps) {
         super(scope, id, props);
@@ -20,24 +16,9 @@ export class SharedInfraStack extends Stack {
         }
 
         Tags.of(this).add('SERVICE', id);
-        <% if (example) { %>
-        this.paramExample = StringParameter.fromStringParameterName(
-            this,
-            'ParamExample',
-            `/example/param`
-        );
-
-        this.secretExample = new Secret(this, 'SecretExample', {
-            description: 'Example secret shared across services',
-        });
-        <% } %>
     }
 
     getProps(): SharedInfraProps {
-        return {
-            <% if (example) { %>paramExample: this.paramExample,
-            secretExample: this.secretExample,
-            <% } %>
-        };
+        return {};
     }
 }

package/src/generators/preset/files-example/libs/infra/src/index.ts.template

@@ -0,0 +1,49 @@
+import { Stack, Stage, StackProps, Tags } from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+import { Secret } from 'aws-cdk-lib/aws-secretsmanager';
+import { IStringParameter, StringParameter } from 'aws-cdk-lib/aws-ssm';
+
+export interface SharedInfraProps {
+    paramExample: IStringParameter;
+    secretExample: Secret;
+}
+
+export class SharedInfraStack extends Stack {
+    readonly paramExample: IStringParameter;
+    readonly secretExample: Secret;
+
+    constructor(scope: Construct, id: string, props?: StackProps) {
+        super(scope, id, props);
+
+        if (!Stage.of(this)?.stageName) {
+            throw new Error('This construct must be used within a CDK Stage');
+        }
+
+        Tags.of(this).add('SERVICE', id);
+
+        this.paramExample = new StringParameter(this,'ParamExample',
+        {
+            parameterName: `/example/param`,
+            stringValue: 'example-value'
+        }
+        );
+
+        this.secretExample = new Secret(this, 'SecretExample', {
+            description: 'Example secret shared across services',
+            generateSecretString: {
+                secretStringTemplate: JSON.stringify({
+                    username: 'placeholder',
+                    password: 'placeholder',
+                }),
+                generateStringKey: '_generatedKey',
+            },
+        });
+    }
+
+    getProps(): SharedInfraProps {
+        return {
+            paramExample: this.paramExample,
+            secretExample: this.secretExample,
+        };
+    }
+}

package/src/generators/preset/preset.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.presetGenerator = presetGenerator;
 const devkit_1 = require("@nx/devkit");
 const path_1 = require("path");
+const constants_1 = require("../constants");
 const nxJson_1 = require("../helpers/configs/nxJson");
 const utilities_1 = require("../helpers/utilities");
 async function presetGenerator(tree, options) {
@@ -10,13 +11,17 @@ async function presetGenerator(tree, options) {
     const [nodeVersionMajor] = nodeVersion.split('.');
     const nameParts = (0, utilities_1.splitInputName)(name);
     const projectName = nameParts.join(' ');
-    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files'), '.', {
+    const templateVars = {
         ...options,
         projectName,
         folderName: destination || name,
         nodeRuntime: `${nodeVersionMajor}_X`,
         template: '',
-    });
+    };
+    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files'), '.', templateVars);
+    if (options.example) {
+        (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files-example'), '.', templateVars);
+    }
     (0, devkit_1.updateNxJson)(tree, { ...nxJson_1.NX_JSON });
     const packageJson = (0, utilities_1.constructPackageJsonFile)({
         name: options.name,
@@ -26,8 +31,8 @@ async function presetGenerator(tree, options) {
     });
     (0, devkit_1.writeJson)(tree, 'package.json', packageJson);
     // Generate application's tsconfigs
-    const { tsConfig } = (0, utilities_1.constructProjectTsConfigFiles)('application');
-    (0, devkit_1.writeJson)(tree, 'application/tsconfig.json', tsConfig);
+    const { tsConfig } = (0, utilities_1.constructProjectTsConfigFiles)(constants_1.MAIN_APPLICATION_NAME);
+    (0, devkit_1.writeJson)(tree, `${constants_1.MAIN_APPLICATION_FOLDER}/tsconfig.json`, tsConfig);
     await (0, devkit_1.formatFiles)(tree);
 }
 exports.default = presetGenerator;

package/src/generators/preset/schema.json

@@ -36,7 +36,8 @@
         "example": {
             "type": "boolean",
             "description": "Generate example code with sample resources",
-            "default": false
+            "default": false,
+            "x-prompt": "Would you like to generate example code with sample resources?"
         }
     },
     "required": ["name"]

package/src/generators/remove-service/generator.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import { RemoveGeneratorSchema } from './schema';
+export declare function removeGenerator(tree: Tree, options: RemoveGeneratorSchema): Promise<void>;
+export default removeGenerator;

package/src/generators/remove-service/generator.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeGenerator = removeGenerator;
+const devkit_1 = require("@nx/devkit");
+const constants_1 = require("../constants");
+const utilities_1 = require("../helpers/utilities");
+async function removeGenerator(tree, options) {
+    const { name, forceRemove } = options;
+    const projectRoot = `${constants_1.SERVICES_FOLDER}/${name}`;
+    const projectName = `${constants_1.SERVICES_SCOPE}/${name}`;
+    if (!tree.exists(projectRoot)) {
+        throw new Error(`Service "${name}" does not exist at "${projectRoot}".`);
+    }
+    if (!forceRemove) {
+        const graph = await (0, devkit_1.createProjectGraphAsync)();
+        const dependents = Object.entries(graph.dependencies)
+            .filter(([source]) => source !== projectName)
+            .filter(([, deps]) => deps.some(d => d.target === projectName))
+            .map(([source]) => source);
+        if (dependents.length > 0) {
+            throw new Error(`Cannot remove "${name}": it is depended on by ${dependents.join(', ')}. ` +
+                'Use --forceRemove to skip this check.');
+        }
+    }
+    (0, utilities_1.removeServiceFromMainApplication)(tree, name, constants_1.MAIN_APPLICATION_NAME);
+    (0, utilities_1.removeTsConfigReference)(tree, `./${projectRoot}`);
+    tree.delete(projectRoot);
+    if (tree.exists('package.json')) {
+        (0, devkit_1.updateJson)(tree, 'package.json', json => {
+            if (Array.isArray(json.workspaces)) {
+                json.workspaces = json.workspaces.filter((w) => w !== projectRoot);
+            }
+            return json;
+        });
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}
+exports.default = removeGenerator;

package/src/generators/remove-service/schema.d.ts

@@ -0,0 +1,4 @@
+export interface RemoveGeneratorSchema {
+    name: string;
+    forceRemove?: boolean;
+}

package/src/generators/remove-service/schema.json

@@ -0,0 +1,23 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "$id": "RemoveServiceGenerator",
+    "title": "Remove a service and clean up its references",
+    "type": "object",
+    "properties": {
+        "name": {
+            "type": "string",
+            "description": "The name of the service to remove",
+            "$default": {
+                "$source": "argv",
+                "index": 0
+            },
+            "x-prompt": "What is the name of the service to remove?"
+        },
+        "forceRemove": {
+            "type": "boolean",
+            "description": "Skip dependency check when removing the project",
+            "default": false
+        }
+    },
+    "required": ["name"]
+}

package/src/generators/service/files/src/index.ts.template

@@ -20,8 +20,6 @@ interface Props extends StackProps, SharedInfraProps {
 /**
  * Entrypoint for the <%= name %> service
  *
- * Instantiate in a CDK Application Stage to deploy to AWS.
- *
  * @note Aligent provides the following standard CDK constructs:
  * - {@link NodejsFunctionFromEntry} from '@aligent/cdk-nodejs-function-from-entry'
  * - {@link StepFunctionFromFile} from '@aligent/cdk-step-function-from-file'
@@ -34,7 +32,7 @@ interface Props extends StackProps, SharedInfraProps {
  *
  * new StepFunctionFromFile(this, 'ExampleStepFunction', {
  *     baseDir: import.meta.dirname,
- *     filepath: 'infra/stepfunctions/example.json',
+ *     filepath: 'infra/stepfunctions/example.yml',
  * });
  */
 export class <%= stack %> extends Stack {

package/src/generators/service/files-example/src/index.ts.template

@@ -0,0 +1,45 @@
+import { SharedInfraProps } from '@libs/infra';
+import { Stack, StackProps, Stage, Tags } from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+import { NodejsFunctionFromEntry } from '@aligent/cdk-nodejs-function-from-entry';
+import { StepFunctionFromFile } from '@aligent/cdk-step-function-from-file';
+
+/**
+* @important
+* Due to the immutable nature of CloudFormation,
+* CDK will generate new CloudFormation template and deploy if you change stack name
+*/
+export const <%= constant %> = {
+    NAME: '<%= name %>',
+    DESCRIPTION: '<%= name %> service description'
+} as const;
+
+type Id = typeof <%= constant %>.NAME | (string & {});
+interface Props extends StackProps, SharedInfraProps {
+    description: string;
+}
+
+/**
+ * Entrypoint for the <%= name %> service
+ */
+export class <%= stack %> extends Stack {
+    constructor(scope: Construct, id: Id, props: Props) {
+        super(scope, id, props);
+
+        if (!Stage.of(this)?.stageName) {
+            throw new Error('This construct must be used within a CDK Stage');
+        }
+
+        Tags.of(this).add('SERVICE', id);
+
+        new NodejsFunctionFromEntry(this, 'ExampleLambda', {
+            baseDir: import.meta.dirname,
+            entry: 'runtime/handlers/example.ts',
+        });
+
+        new StepFunctionFromFile(this, 'ExampleStepFunction', {
+            baseDir: import.meta.dirname,
+            filepath: 'infra/stepfunctions/example.yml',
+        });
+    }
+}

package/src/generators/service/files-example/src/infra/stepfunctions/example.yml.template

@@ -0,0 +1,7 @@
+Comment: Example Step Function for <%= name %>
+StartAt: Hello
+States:
+  Hello:
+    Type: Pass
+    Result: Hello from <%= name %>
+    End: true

package/src/generators/service/files-example/src/runtime/handlers/example.ts.template

@@ -0,0 +1,7 @@
+import type { Handler } from 'aws-lambda';
+
+export const handler: Handler = async (event) => {
+    // TODO: Implement your handler logic here
+
+    return;
+};

package/src/generators/service/generator.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.serviceGenerator = serviceGenerator;
 const devkit_1 = require("@nx/devkit");
 const path_1 = require("path");
+const constants_1 = require("../constants");
 const utilities_1 = require("../helpers/utilities");
-const SERVICES_FOLDER = 'services';
 function addTsConfigReference(tree, referencePath) {
     (0, devkit_1.updateJson)(tree, 'tsconfig.json', json => {
         json.references ??= [];
@@ -16,20 +16,24 @@ function addTsConfigReference(tree, referencePath) {
     });
 }
 async function serviceGenerator(tree, options) {
-    const projectRoot = `${SERVICES_FOLDER}/${options.name}`;
+    const projectRoot = `${constants_1.SERVICES_FOLDER}/${options.name}`;
     const nameParts = (0, utilities_1.splitInputName)(options.name);
     const constant = nameParts.map(name => name.toUpperCase()).join('_');
     const stack = `${nameParts.join('')}Stack`;
-    if (!tree.exists(SERVICES_FOLDER)) {
-        tree.write(`${SERVICES_FOLDER}/.gitkeep`, '');
+    if (!tree.exists(constants_1.SERVICES_FOLDER)) {
+        tree.write(`${constants_1.SERVICES_FOLDER}/.gitkeep`, '');
     }
-    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files'), projectRoot, {
+    const templateVars = {
         ...options,
         serviceName: nameParts.join(' '),
         constant,
         stack,
         template: '',
-    });
+    };
+    (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files'), projectRoot, templateVars);
+    if (options.example) {
+        (0, devkit_1.generateFiles)(tree, (0, path_1.join)(__dirname, 'files-example'), projectRoot, templateVars);
+    }
     // Generate service's tsconfigs
     const { tsConfig, tsConfigLib, tsConfigSpec } = (0, utilities_1.constructProjectTsConfigFiles)('service');
     (0, devkit_1.writeJson)(tree, `${projectRoot}/tsconfig.json`, tsConfig);
@@ -37,7 +41,7 @@ async function serviceGenerator(tree, options) {
     (0, devkit_1.writeJson)(tree, `${projectRoot}/tsconfig.spec.json`, tsConfigSpec);
     // Integrate the new service with the root application
     addTsConfigReference(tree, `./${projectRoot}`);
-    (0, utilities_1.addServiceStackToMainApplication)(tree, { name: options.name, constant, stack }, 'application');
+    (0, utilities_1.addServiceStackToMainApplication)(tree, { name: options.name, constant, stack }, constants_1.MAIN_APPLICATION_NAME);
     await (0, devkit_1.formatFiles)(tree);
 }
 exports.default = serviceGenerator;

package/src/generators/service/schema.d.ts

@@ -1,4 +1,5 @@
 /* v8 ignore start */
 export interface ServiceGeneratorSchema {
     name: string;
+    example?: boolean;
 }

package/src/generators/service/schema.json

@@ -14,6 +14,12 @@
             "x-prompt": "What is the name of the service?",
             "pattern": "^(?!.*[Ss]tack|.*[Ss]ervice).*$",
             "patternErrorMessage": "Service name cannot contain '[Ss]tack' or '[Ss]ervice'"
+        },
+        "example": {
+            "type": "boolean",
+            "description": "Generate example code with sample resources",
+            "default": false,
+            "x-prompt": "Would you like to generate example code with sample resources?"
         }
     },
     "required": ["name"]

package/src/generators/preset/files/.github/dependabot.yml.template

@@ -1,7 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: 'npm'
-    directory: '/'
-    schedule:
-      interval: 'monthly'
-    open-pull-requests-limit: 10

package/src/generators/preset/files/parameters/dev.csv.template

@@ -1,2 +0,0 @@
-Note|Name|Type|Value
-Collect from eCommerce|/<%= name %>-int/e-commerce/base-url|String|https://e-commerce.com/dev/api