@aligent/nx-cdk 0.0.1 → 0.1.0

package/README.md

@@ -42,7 +42,7 @@ The preset generator scaffolds:
   - `cdk.context.json` - CDK context
   - `bin/main.ts` - CDK app entry point
   - `lib/service-stacks.ts` - Service stacks definition
-  - TypeScript configurations (`tsconfig.json`, `tsconfig.lib.json`, `tsconfig.spec.json`)
+  - TypeScript configurations (`tsconfig.json`, `tsconfig.spec.json`)
 
 ### Service Generator
 
@@ -51,7 +51,7 @@ The service generator creates a new CDK service within the `services/` folder of
 #### Usage
 
 ```bash
-npx nx g @aligent/nx-cdk:service <service-name>
+yarn nx g @aligent/nx-cdk:service <service-name>
 ```
 
 #### Options
@@ -83,10 +83,10 @@ The service generator creates a new service in `services/<service-name>/` with:
 
 ```bash
 # Create a new service named "user-management"
-npx nx g @aligent/nx-cdk:service user-management
+yarn nx g @aligent/nx-cdk:service user-management
 
 # Create a new service named "payment-processing"
-npx nx g @aligent/nx-cdk:service payment-processing
+yarn nx g @aligent/nx-cdk:service payment-processing
 ```
 
 ## Project Structure

package/generators.json

@@ -3,7 +3,7 @@
         "preset": {
             "factory": "./src/generators/preset/preset",
             "schema": "./src/generators/preset/schema.json",
-            "description": "preset generator",
+            "description": "Generate a new workspace",
             "x-use-standalone-layout": true
         },
         "service": {

package/package.json

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

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

@@ -4,20 +4,20 @@ exports.NX_JSON = void 0;
 exports.NX_JSON = {
     $schema: './node_modules/nx/schemas/nx-schema.json',
     defaultBase: 'origin/staging',
+    sync: { applyChanges: true },
     plugins: [
         { plugin: '@nx/eslint/plugin', options: {} },
-        { plugin: '@nx/vite/plugin', options: {} },
         { plugin: '@nx/js/typescript', options: { build: false } },
+        { plugin: '@nx/vitest', options: { testMode: 'run' } },
     ],
     namedInputs: {
         default: ['{projectRoot}/**/*', 'sharedGlobals'],
         production: [
             'default',
-            '!{projectRoot}/.eslintrc.json',
             '!{projectRoot}/**/?(*.)+(spec|test).[jt]s?(x)?(.snap)',
+            '!{projectRoot}/tests/*',
             '!{projectRoot}/tsconfig.spec.json',
             '!{projectRoot}/vitest.config.m[jt]s',
-            '!{projectRoot}/src/test-setup.[jt]s',
         ],
         sharedGlobals: [],
     },
@@ -28,25 +28,15 @@ exports.NX_JSON = {
             inputs: ['production', '^production'],
             outputs: ['{projectRoot}/dist'],
         },
-        cdk: { dependsOn: ['^build', '^build:lambda'], inputs: ['production', '^production'] },
-        lint: { cache: true, inputs: ['default'] },
+        cdk: { dependsOn: ['^build'], inputs: ['production', '^production'] },
+        lint: { cache: true, inputs: ['default', '^production'] },
         test: {
             cache: true,
             inputs: ['default', '^production'],
             outputs: ['{projectRoot}/coverage'],
-            // Stack tests may require lambda handlers to be built first
-            dependsOn: ['^build', 'build:lambda'],
+            dependsOn: ['^build'], // Stack tests may require lambda handlers to be built first
             configurations: { coverage: { coverage: true } },
         },
-        typecheck: { cache: true, dependsOn: ['^build'], inputs: ['production', '^production'] },
-        parameters: {
-            executor: 'nx:run-commands',
-            options: { color: true, cwd: '{projectRoot}/parameters', file: '.env.csv' },
-            defaultConfiguration: 'export',
-            configurations: {
-                import: { command: 'store-parameters import {args.file}' },
-                export: { command: 'store-parameters export {args.file} --path={args.path}' },
-            },
-        },
+        typecheck: { cache: true, inputs: ['default', '^production'] },
     },
 };

package/src/generators/helpers/configs/packageJson.d.ts

@@ -11,22 +11,24 @@ export declare const PACKAGE_JSON: {
         readonly typecheck: "nx affected -t typecheck";
         readonly 'typecheck:all': "nx run-many -t typecheck";
         readonly postinstall: "[ -d .git ] && git config core.hooksPath '.git-hooks' && chmod +x .git-hooks/* || true";
-        readonly 'pg:synth': "nx run application:cdk synth 'development/**' --exclusively --profile playground";
-        readonly 'pg:deploy': "nx run application:cdk deploy --method 'direct' 'development/**' --exclusively --require-approval never --profile playground";
-        readonly 'pg:destroy': "nx run application:cdk destroy 'development/**' --profile playground";
+        readonly 'pg:synth': "nx run application:cdk synth 'dev/**' --exclusively --profile playground";
+        readonly 'pg:deploy': "nx run application:cdk deploy --method 'direct' 'dev/**' --exclusively --require-approval never --profile playground";
+        readonly 'pg:destroy': "nx run application:cdk destroy 'dev/**' --profile playground";
         readonly audit: "nx run-many -t lint typecheck test --configuration coverage --skip-nx-cache";
     };
     readonly dependencies: {
         readonly '@aligent/microservice-util-lib': "^1.2.0";
     };
     readonly devDependencies: {
+        readonly '@aligent/cdk-aspects': "^0.2.0";
         readonly '@aligent/cdk-step-function-from-file': "^0.3.2";
         readonly '@aligent/nx-openapi': "^1.0.0";
         readonly '@aligent/ts-code-standards': "^4.1.0";
         readonly '@nx/eslint': "22.1.3";
         readonly '@nx/eslint-plugin': "22.1.3";
         readonly '@nx/js': "22.1.3";
-        readonly '@nx/vite': "22.1.3";
+        readonly '@nx/vitest': "22.1.3";
+        readonly '@nx/workspace': "22.1.3";
         readonly '@swc-node/register': "^1.10.10";
         readonly '@swc/core': "^1.13.3";
         readonly '@swc/helpers': "^0.5.17";
@@ -37,7 +39,7 @@ export declare const PACKAGE_JSON: {
         readonly '@vitest/coverage-v8': "^3.2.4";
         readonly '@vitest/ui': "^3.2.4";
         readonly 'aws-cdk': "^2.1033.0";
-        readonly 'aws-cdk-lib': "^2.230.0";
+        readonly 'aws-cdk-lib': "^2.235.1";
         readonly 'cdk-nag': "^2.37.55";
         readonly constructs: "^10.4.3";
         readonly eslint: "^9.32.0";
@@ -56,6 +58,26 @@ export declare const PACKAGE_JSON: {
         readonly vite: "^7.2.6";
         readonly vitest: "^3.2.4";
     };
+    readonly nx: {
+        readonly includedScripts: readonly [];
+        readonly targets: {
+            readonly parameters: {
+                readonly executor: "nx:run-commands";
+                readonly options: {
+                    readonly color: true;
+                    readonly cwd: "parameters";
+                };
+                readonly configurations: {
+                    readonly import: {
+                        readonly command: "store-parameters import {args.file} --delimiter=|";
+                    };
+                    readonly export: {
+                        readonly command: "store-parameters export {args.file} --path={args.path} --delimiter=|";
+                    };
+                };
+            };
+        };
+    };
     readonly workspaces: readonly ["application", "clients", "libs/*", "services/*"];
     readonly packageManager: "yarn@4.12.0+sha512.f45ab632439a67f8bc759bf32ead036a1f413287b9042726b7cc4818b7b49e14e9423ba49b18f9e06ea4941c1ad062385b1d8760a8d5091a1a31e5f6219afca8";
 };

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

@@ -14,22 +14,24 @@ exports.PACKAGE_JSON = {
         typecheck: 'nx affected -t typecheck',
         'typecheck:all': 'nx run-many -t typecheck',
         postinstall: `[ -d .git ] && git config core.hooksPath '.git-hooks' && chmod +x .git-hooks/* || true`,
-        'pg:synth': `nx run application:cdk synth 'development/**' --exclusively --profile playground`,
-        'pg:deploy': `nx run application:cdk deploy --method 'direct' 'development/**' --exclusively --require-approval never --profile playground`,
-        'pg:destroy': "nx run application:cdk destroy 'development/**' --profile playground",
+        'pg:synth': `nx run application:cdk synth 'dev/**' --exclusively --profile playground`,
+        'pg:deploy': `nx run application:cdk deploy --method 'direct' 'dev/**' --exclusively --require-approval never --profile playground`,
+        'pg:destroy': "nx run application:cdk destroy 'dev/**' --profile playground",
         audit: 'nx run-many -t lint typecheck test --configuration coverage --skip-nx-cache',
     },
     dependencies: {
         '@aligent/microservice-util-lib': '^1.2.0',
     },
     devDependencies: {
+        '@aligent/cdk-aspects': '^0.2.0',
         '@aligent/cdk-step-function-from-file': '^0.3.2',
         '@aligent/nx-openapi': '^1.0.0',
         '@aligent/ts-code-standards': '^4.1.0',
         '@nx/eslint': '22.1.3',
         '@nx/eslint-plugin': '22.1.3',
         '@nx/js': '22.1.3',
-        '@nx/vite': '22.1.3',
+        '@nx/vitest': '22.1.3',
+        '@nx/workspace': '22.1.3',
         '@swc-node/register': '^1.10.10',
         '@swc/core': '^1.13.3',
         '@swc/helpers': '^0.5.17',
@@ -40,7 +42,7 @@ exports.PACKAGE_JSON = {
         '@vitest/coverage-v8': '^3.2.4',
         '@vitest/ui': '^3.2.4',
         'aws-cdk': '^2.1033.0',
-        'aws-cdk-lib': '^2.230.0',
+        'aws-cdk-lib': '^2.235.1',
         'cdk-nag': '^2.37.55',
         constructs: '^10.4.3',
         eslint: '^9.32.0',
@@ -60,6 +62,21 @@ exports.PACKAGE_JSON = {
         vite: '^7.2.6',
         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=|',
+                    },
+                },
+            },
+        },
+    },
     workspaces: ['application', 'clients', 'libs/*', 'services/*'],
     packageManager: 'yarn@4.12.0+sha512.f45ab632439a67f8bc759bf32ead036a1f413287b9042726b7cc4818b7b49e14e9423ba49b18f9e06ea4941c1ad062385b1d8760a8d5091a1a31e5f6219afca8',
 };

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

@@ -18,17 +18,17 @@ exports.TS_CONFIG_LIB_JSON = {
         types: ['node'],
     },
     include: ['src/**/*.ts'],
-    exclude: ['vite.config.mjs', 'src/**/*.spec.ts', 'src/**/*.test.ts'],
+    exclude: ['vitest.config.mjs', 'src/**/*.spec.ts', 'src/**/*.test.ts'],
     references: [],
 };
 exports.TS_CONFIG_SPEC_JSON = {
     extends: BASE_CONFIG,
     compilerOptions: {
         outDir: './out-tsc/vitest',
-        types: ['vitest/globals', 'vitest/importMeta', 'vite/client', 'node', 'vitest'],
+        types: ['vitest/globals', 'vitest/importMeta', 'node', 'vitest'],
     },
     include: [
-        'vite.config.mjs',
+        'vitest.config.mjs',
         'src/**/*.test.ts',
         'src/**/*.spec.ts',
         'src/**/*.d.ts',

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

@@ -19,9 +19,9 @@ export declare function constructPackageJsonFile(input: PackageJsonInput): {
         readonly typecheck: "nx affected -t typecheck";
         readonly 'typecheck:all': "nx run-many -t typecheck";
         readonly postinstall: "[ -d .git ] && git config core.hooksPath '.git-hooks' && chmod +x .git-hooks/* || true";
-        readonly 'pg:synth': "nx run application:cdk synth 'development/**' --exclusively --profile playground";
-        readonly 'pg:deploy': "nx run application:cdk deploy --method 'direct' 'development/**' --exclusively --require-approval never --profile playground";
-        readonly 'pg:destroy': "nx run application:cdk destroy 'development/**' --profile playground";
+        readonly 'pg:synth': "nx run application:cdk synth 'dev/**' --exclusively --profile playground";
+        readonly 'pg:deploy': "nx run application:cdk deploy --method 'direct' 'dev/**' --exclusively --require-approval never --profile playground";
+        readonly 'pg:destroy': "nx run application:cdk destroy 'dev/**' --profile playground";
         readonly audit: "nx run-many -t lint typecheck test --configuration coverage --skip-nx-cache";
     } | {
         readonly '@aligent/microservice-util-lib': "^1.2.0";
@@ -29,6 +29,27 @@ export declare function constructPackageJsonFile(input: PackageJsonInput): {
         [k: string]: string;
     } | {
         node: string;
+    } | {
+        includedScripts: readonly [];
+        targets: {
+            readonly parameters: {
+                readonly executor: "nx:run-commands";
+                readonly options: {
+                    readonly color: true;
+                    readonly cwd: "parameters";
+                };
+                readonly configurations: {
+                    readonly import: {
+                        readonly command: "store-parameters import {args.file} --delimiter=|";
+                    };
+                    readonly export: {
+                        readonly command: "store-parameters export {args.file} --path={args.path} --delimiter=|";
+                    };
+                };
+            };
+        };
+        name: string;
+        node?: undefined;
     };
 };
 export declare function constructProjectTsConfigFiles(type: 'application' | 'service'): {

package/src/generators/helpers/utilities.js

@@ -24,6 +24,7 @@ function constructPackageJsonFile(input) {
         ...packageJson_1.PACKAGE_JSON,
         devDependencies,
         engines: { node: `^${input.nodeVersion}` },
+        nx: { name: `${input.name}-int`, ...packageJson_1.PACKAGE_JSON.nx },
     }));
     return packageJson;
 }
@@ -78,16 +79,18 @@ async function addServiceStackToMainApplication(tree, service, projectName) {
     const project = new ts_morph_1.Project();
     const stackSource = project.addSourceFileAtPath(stacksPath);
     const applicationStage = stackSource.getClassOrThrow('ApplicationStage');
-    const stageConstructors = applicationStage?.getConstructors();
-    if (!stageConstructors?.length) {
+    const stageConstructor = applicationStage.getConstructors()[0];
+    if (!stageConstructor) {
         throw new Error('Unable to find main application stage constructor');
     }
     stackSource.addImportDeclaration({
         moduleSpecifier: `@services/${service.name}`,
         namedImports: [service.constant, service.stack],
     });
-    stageConstructors[0]?.addStatements(`new ${service.stack}(this, ${service.constant}.NAME, { ...props, description: ${service.constant}.DESCRIPTION });`);
-    await stackSource?.save();
+    const sharedInfra = stageConstructor.getVariableStatement('sharedInfra');
+    const sharedPropsStatement = sharedInfra ? `...sharedInfra.getProps(),` : '';
+    stageConstructor.addStatements(`new ${service.stack}(this, ${service.constant}.NAME, { ...props, ${sharedPropsStatement} description: ${service.constant}.DESCRIPTION });`);
+    await stackSource.save();
 }
 /**
  * Splits a kebab-case name into an array of capitalized parts.

package/src/generators/preset/files/.github/workflows/pull-request.yml.template

@@ -0,0 +1,11 @@
+name: Pull Request
+
+on:
+  pull_request:
+    branches:
+      - '**'
+
+jobs:
+  code-quality:
+    name: 🕵️‍♀️ Code Quality Check
+    uses: aligent/workflows/.github/workflows/node-pr.yml@main

package/src/generators/preset/files/.github/workflows/release.yml.template

@@ -0,0 +1,17 @@
+name: Release
+
+on:
+  release:
+    types:
+      - published
+
+jobs:
+  deploy:
+    name: Deploy to AWS
+    uses: aligent/workflows/.github/workflows/aws-cdk.yml@main
+    with:
+      deploy: true
+      deploy-command: yarn nx run application:cdk deploy
+      extra-arguments: --exclusively
+      github-environment: production
+    secrets: inherit

package/src/generators/preset/files/.github/workflows/stg-deployment.yml.template

@@ -0,0 +1,17 @@
+name: Staging Deployment
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    name: Deploy to AWS
+    uses: aligent/workflows/.github/workflows/aws-cdk.yml@main
+    with:
+      deploy: true
+      deploy-command: yarn nx run application:cdk deploy
+      extra-arguments: --exclusively
+      github-environment: staging
+    secrets: inherit

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

@@ -49,6 +49,9 @@
 !libs
 !libs/*
 !libs/**/*
+!parameters
+!parameters/*
+!parameters/**/*
 !services
 !services/*
 !services/**/*
@@ -58,5 +61,6 @@
 **/dist
 **/coverage
 
-# Environment files
+# Misc files
 *.env
+.DS_Store

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

@@ -55,19 +55,34 @@ We follow [trunk-based development framework](https://trunkbaseddevelopment.com/
 1. Create new branch from `main`
 2. Make your changes following code standards
 3. Ensure your changes pass linting, type checks and testes
-4. Submit a pull request back to `main`
-5. For deployment, submit a pull request from `main` to `staging` or `production`
+4. Submit a pull request back to `main`. A merge to `main` will deploy to `staging` environment.
+5. For `production` deployment, create a release from `main`.
 
 ## Adding New Services
 
 To add a new service to the monorepo:
 
 1. Use the Aligent CDK generator `@aligent/nx-cdk`
+    ```bash
+    yarn nx g @aligent/nx-cdk:service <service-name>
+    ```
 2. Add service infrastructure in
     - `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
+```
+
 ## License
 
 MIT

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

@@ -2,23 +2,6 @@
 
 This application manages the deployment of microservices and their shared infrastructure.
 
-## Configuration
-
-### Environment Parameters
-
-Parameters are managed through the `parameters/.env.csv` file by default
-
-```bash
-# Pull down parameters from the playground environment to .env.csv
-yarn nx run application:parameters
-
-# Update parameters from .env.csv
-yarn nx run application:parameters:import
-
-# Custom filename and parameter path can be passed in as arguments
-yarn nx run application:parameters --file .env.dev.csv --path /my/dev/path
-```
-
 ## Deployment
 
 ### Using yarn script from workspace root (Recommended)

package/src/generators/preset/files/application/_internal/log-group-defaults-aspect.ts.template

@@ -0,0 +1,83 @@
+import { RemovalPolicy, type IAspect } from 'aws-cdk-lib';
+import { CfnLogGroup, LogGroup, RetentionDays, type LogGroupProps } from 'aws-cdk-lib/aws-logs';
+import { IConstruct } from 'constructs';
+
+interface Config {
+    duration: 'SHORT' | 'MEDIUM' | 'LONG';
+}
+
+/**
+ * Aspect that automatically applies configuration-aware defaults to CloudWatch Log Groups
+ *
+ * Visits all constructs in the scope and automatically applies configuration-specific to log groups.
+ * Different configurations balance between cost optimization and data retention needs.
+ *
+ * @example
+ * ```typescript
+ * // Apply configuration-specific defaults to all log groups
+ * Aspects.of(app).add(new LogGroupDefaultsAspect({ duration: 'SHORT' }));
+ *
+ * // Log groups automatically inherit configuration defaults
+ * new LogGroup(stack, 'MyLogGroup', {
+ *   // retention and removal policy applied automatically
+ * });
+ * ```
+ *
+ * @see https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_logs.LogGroup.html
+ */
+export class LogGroupDefaultsAspect implements IAspect {
+    private readonly defaultProps: LogGroupProps;
+
+    /**
+     * Creates a new LogGroupDefaultsAspect
+     *
+     * @param config - Configuration identifier used to select appropriate defaults.
+     */
+    constructor(config: Config) {
+        const props = this.retentionProperties(config.duration);
+        this.defaultProps = { ...props };
+    }
+
+    /**
+     * Get duration-specific log group properties
+     *
+     * @param duration - The duration to get the log group properties for
+     * @returns The log group properties for the duration
+     */
+    private retentionProperties(duration: 'SHORT' | 'MEDIUM' | 'LONG') {
+        switch (duration) {
+            case 'SHORT':
+                return { retention: RetentionDays.ONE_WEEK, removalPolicy: RemovalPolicy.DESTROY };
+            case 'MEDIUM':
+                return {
+                    retention: RetentionDays.SIX_MONTHS,
+                    removalPolicy: RemovalPolicy.DESTROY,
+                };
+            default:
+                return { retention: RetentionDays.TWO_YEARS, removalPolicy: RemovalPolicy.RETAIN };
+        }
+    }
+
+    /**
+     * Visits a construct and applies configuration-appropriate defaults
+     *
+     * Applies configuration-specific retention and removal policies to log groups
+     * that don't already have these properties explicitly set.
+     *
+     * @param node - The construct to potentially modify
+     */
+    visit(node: IConstruct): void {
+        if (node instanceof LogGroup) {
+            if (this.defaultProps.removalPolicy) {
+                node.applyRemovalPolicy(this.defaultProps.removalPolicy);
+            }
+
+            if (this.defaultProps.retention) {
+                const cfnLogGroup = node.node.defaultChild as CfnLogGroup;
+                if (cfnLogGroup && cfnLogGroup.retentionInDays === undefined) {
+                    cfnLogGroup.retentionInDays = this.defaultProps.retention;
+                }
+            }
+        }
+    }
+}

package/src/generators/preset/files/application/_internal/nodejs-function-defaults-aspect.ts.template

@@ -0,0 +1,72 @@
+import { type IAspect } from 'aws-cdk-lib';
+import { CfnFunction, Runtime, Tracing } from 'aws-cdk-lib/aws-lambda';
+import { NodejsFunction } from 'aws-cdk-lib/aws-lambda-nodejs';
+import { IConstruct } from 'constructs';
+
+interface Config {
+    runtime: Runtime;
+    sourceMap?: boolean;
+}
+
+/**
+ * Aspect that automatically applies configuration-aware defaults to Node.js Lambda functions
+ *
+ * Visits all constructs in the scope and automatically applies configuration-specific runtime, tracing, and environment settings to Node.js Lambda functions.
+ * Different configurations can optimize for different priorities such as build speed, bundle size, or debugging capabilities.
+ *
+ * @example
+ * ```typescript
+ * // Apply configuration-specific defaults to all Node.js functions
+ * Aspects.of(app).add(new NodeJsFunctionDefaultsAspect({
+ *   runtime: Runtime.NODEJS_24_X,
+ *   sourceMap: true,
+ * }));
+ *
+ * // Functions automatically inherit configuration defaults
+ * new NodejsFunction(stack, 'MyFunction', {
+ *   code: Code.fromAsset('src/lambda'),
+ *   handler: 'index.handler',
+ *   // runtime, tracing, and source map support applied automatically
+ * });
+ * ```
+ *
+ * @see https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda_nodejs.NodejsFunction.html
+ */
+export class NodeJsFunctionDefaultsAspect implements IAspect {
+    private readonly config: Required<Config>;
+
+    /**
+     * Creates a new NodeJsFunctionDefaultsAspect
+     *
+     * @param config - Configuration identifier used to select appropriate defaults.
+     */
+    constructor(config: Config) {
+        this.config = { ...config, sourceMap: config.sourceMap ?? true };
+    }
+
+    /**
+     * Visits a construct and applies runtime and tracing settings if it's a NodejsFunction
+     *
+     * Applies configuration-specific runtime, tracing, and environment settings to Node.js
+     * Lambda functions that don't already have these properties explicitly set.
+     *
+     * @param node - The construct to potentially modify
+     */
+    visit(node: IConstruct): void {
+        if (node instanceof NodejsFunction) {
+            const cfnFunction = node.node.defaultChild as CfnFunction;
+
+            if (cfnFunction) {
+                cfnFunction.runtime = this.config.runtime.name;
+            }
+
+            if (cfnFunction && cfnFunction.tracingConfig === undefined) {
+                cfnFunction.tracingConfig = { mode: Tracing.ACTIVE };
+            }
+
+            if (this.config.sourceMap) {
+                node.addEnvironment('NODE_OPTIONS', '--enable-source-maps');
+            }
+        }
+    }
+}