@mavogel/cdk-vscode-server 0.0.60 → 0.0.61

package/.jsii

@@ -4101,7 +4101,7 @@
   },
   "name": "@mavogel/cdk-vscode-server",
   "readme": {
-    "markdown": "![Source](https://img.shields.io/github/stars/MV-Consulting/cdk-vscode-server?logo=github&label=GitHub%20Stars)\n[![Build Status](https://github.com/MV-Consulting/cdk-vscode-server/actions/workflows/build.yml/badge.svg)](https://github.com/MV-Consulting/cdk-vscode-server/actions/workflows/build.yml)\n[![ESLint Code Formatting](https://img.shields.io/badge/code_style-eslint-brightgreen.svg)](https://eslint.org)\n[![Latest release](https://img.shields.io/github/release/MV-Consulting/cdk-vscode-server.svg)](https://github.com/MV-Consulting/cdk-vscode-server/releases)\n![GitHub](https://img.shields.io/github/license/MV-Consulting/cdk-vscode-server)\n[![npm](https://img.shields.io/npm/dt/@mavogel/cdk-vscode-server?label=npm&color=orange)](https://www.npmjs.com/package/@mavogel/cdk-vscode-server)\n[![typescript](https://img.shields.io/badge/jsii-typescript-blueviolet.svg)](https://www.npmjs.com/package/@mavogel/cdk-vscode-server)\n\n# cdk-vscode-server\n\nRunning your dev IDE vscode on AWS for development and workshop purposes.\n\n> [!Note]\n> This construct is designed for workshop purposes and does not fulfill all security and authentication best practices.\n\n![EXPERIMENTAL](https://img.shields.io/badge/stability-experimantal-orange?style=for-the-badge)**<br>This is an early version of the package. The API will change while I\nwe implement new features. Therefore make sure you use an exact version in your `package.json` before it reaches 1.0.0.**\n\n## Table of Contents\n\n- [Features](#features)\n- [Usage](#usage)\n  - [Standard](#Standard)\n  - [Custom Domain Configuration](#custom-domain-configuration)\n- [Solution Design](#solution-design)\n- [Inspiration](#inspiration)\n\n## Features\n\n- ⚡ **Quick Setup**: Spin up and configure your [vscode](https://code.visualstudio.com/) server in under 10 minutes in your AWS account\n- 📏 **Best Practice Setup**: Set up with [projen](https://projen.io/) and a [single configuration file](./.projenrc.ts) to keep your changes centralized.\n- 🤹‍♂️ **Pre-installed packages**: Besides the [vscode](https://code.visualstudio.com/) server, other tools and software packages such as `git`, `docker`, `awscli` `nodejs` and `python` are pre-installed on the EC2 instance.\n- 🌐 **Custom Domain Support**: Use your own domain name with automatic ACM certificate creation and Route53 DNS configuration, or bring your existing certificate.\n- 🏗️ **Extensibility**: Pass in properties to the construct, which start with `additional*`. They allow you to extend the configuration to your needs. There are more to come...\n\n## Usage\nActually we supported 2 modes:\n\n### Standard\nThe following steps get you started:\n\n1. Create a new `awscdk-app` via\n```bash\nnpx projen new awscdk-app-ts --package-manager=npm\n```\n3. Add `@mavogel/cdk-vscode-server` as a dependency to your project in the `.projenrc.ts` file\n4. Run `npx projen` to install it\n5. Add the following to the `src/main.ts` file:\n```ts\nimport { App, Stack, StackProps } from 'aws-cdk-lib';\nimport * as ec2 from 'aws-cdk-lib/aws-ec2';\nimport * as iam from 'aws-cdk-lib/aws-iam';\nimport { Construct } from 'constructs';\nimport {\n  LinuxArchitectureType,\n  LinuxFlavorType,\n  VSCodeServer\n} from '@mavogel/cdk-vscode-server';\n\nexport class MyStack extends Stack {\n  constructor(scope: Construct, id: string, props: StackProps = {}) {\n    super(scope, id, props);\n\n    new VSCodeServer(this, 'vscode', {\n      // for example (or simply use the defaults by not setting the properties)\n      instanceVolumeSize: 8,\n      instanceClass: ec2.InstanceClass.M7G,\n      instanceSize: ec2.InstanceSize.LARGE,\n      instanceOperatingSystem: LinuxFlavorType.UBUNTU_22,\n      instanceCpuArchitecture: LinuxArchitectureType.ARM,\n\n      // 👇🏽 or if you want to give the InstanceRole more permissions\n      additionalInstanceRolePolicies: [\n        new iam.PolicyStatement({\n          effect: iam.Effect.ALLOW,\n          actions: [\n            'codebuild:*',\n          ],\n          resources: [\n            `arn:aws:codebuild:*:${Stack.of(this).account}:*/*`,\n          ],\n        }),\n      ]\n\n      // and more... 💡\n    });\n  }\n}\n\nconst env = {\n  account: '123456789912',\n  region: 'eu-central-1',\n};\n\nconst app = new App();\nnew MyStack(app, 'vscode-server', { env });\napp.synth();\n```\n\nand deploy it\n```bash\nnpx projen build\nnpx projen deploy\n```\n\nwith the output\n```console\n✨  Deployment time: 509.87s\n\nOutputs:\ndev.vscodedomainName6729AA39 = https://d1foo65bar4baz.cloudfront.net/?folder=/Workshop\ndev.vscodepassword64FBCA12 = foobarbaz\n```\n\nSee the [examples](./examples) folder for more inspiration.\n\n### Custom Domain Configuration\n\nYou can configure your VS Code Server with a custom domain name instead of using the default CloudFront domain. The construct supports three different configuration options:\n\n#### Option 1: Auto-create Certificate with DNS Validation\n```ts\nnew VSCodeServer(this, 'vscode', {\n  domainName: 'vscode.example.com',\n  hostedZoneId: 'Z123EXAMPLE456',  // optional - will auto-discover if not provided\n  autoCreateCertificate: true,\n});\n```\n\nThis will:\n- Create an ACM certificate in us-east-1 (required for CloudFront)\n- Validate the certificate using DNS validation\n- Create a Route53 A record pointing to the CloudFront distribution\n- Configure the CloudFront distribution with the custom domain\n\n#### Option 2: Use Existing Certificate\n```ts\nnew VSCodeServer(this, 'vscode', {\n  domainName: 'vscode.example.com',\n  hostedZoneId: 'Z123EXAMPLE456',\n  certificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012',\n});\n```\n\n**Requirements:**\n- Certificate must be in us-east-1 region\n- Certificate must be validated and ready to use\n- Certificate must include the domain name\n\n#### Option 3: Default (No Custom Domain)\n```ts\nnew VSCodeServer(this, 'vscode', {\n  // No domain configuration - uses CloudFront default domain\n});\n```\n\nFor complete examples, see [examples/custom-domain/main.ts](./examples/custom-domain/main.ts).\n\n6. Then open the domain name in your favorite browser and you'd see the following login screen:\n![vscode-server-ui-login](docs/img/vscode-server-ui-login-min.png)\n\n7. After entering the password, you are logged into VSCode and can start coding :tada:\n\n![vscode-server-ui](docs/img/vscode-server-ui-min.png)\n\n> [!Important]\n> There are issues with copy pasting into the VSCode terminal within the Firefox browser (2025-01-12)\n\n## Solution Design\n\n<details>\n  <summary>... if you're curious about click here for the details</summary>\n\n![vscode-server-solution-design](docs/img/vscode-server.drawio-min.png)\n\n</details>\n\n## Inspiration\nThis project was created based on the following inspiration\n\n- [vscode-on-ec2-for-prototyping](https://github.com/aws-samples/vscode-on-ec2-for-prototyping): as baseline, which unfortunately was outdated\n- [aws-terraform-dev-container](https://github.com/awslabs/aws-terraform-dev-container): as baseline for terraform, but unfortunately also outdated\n- [java-on-aws-workshop-ide-only.yaml](https://github.com/aws-samples/java-on-aws/blob/main/labs/unicorn-store/infrastructure/cfn/java-on-aws-workshop-ide-only.yaml): an already synthesized cloudformation stack, which used mostly python as the custom resources\n- [fleet-workshop-team-stack-self.json](https://static.us-east-1.prod.workshops.aws/public/cc4aa67e-5b7a-4df1-abf7-c42502899a25/assets/fleet-workshop-team-stack-self.json): also an already synthesized cloudformation stack, which did much more as I currently implemented here.\n- [eks-workshop-vscode-cfn.yaml](https://github.com/aws-samples/eks-workshop-v2/blob/main/lab/cfn/eks-workshop-vscode-cfn.yaml): another great baseline\n\n\n## 🚀 Unlock the Full Potential of Your AWS Cloud Infrastructure\n\nHi, I’m Manuel, an AWS expert passionate about empowering businesses with **scalable, resilient, and cost-optimized cloud solutions**. With **MV Consulting**, I specialize in crafting **tailored AWS architectures** and **DevOps-driven workflows** that not only meet your current needs but grow with you.\n\n---\n\n### 🌟 Why Work With Me?\n\n✔️ **Tailored AWS Solutions:** Every business is unique, so I design custom solutions that fit your goals and challenges.\n✔️ **Well-Architected Designs:** From scalability to security, my solutions align with AWS Well-Architected Framework.\n✔️ **Cloud-Native Focus:** I specialize in modern, cloud-native systems that embrace the full potential of AWS.\n✔️ **Business-Driven Tech:** Technology should serve your business, not the other way around.\n\n---\n\n### 🛠 What I Bring to the Table\n\n🔑 **12x AWS Certifications**\nI’m **AWS Certified Solutions Architect and DevOps – Professional** and hold numerous additional certifications, so you can trust I’ll bring industry best practices to your projects. Feel free to explose by [badges](https://www.credly.com/users/manuel-vogel)\n\n⚙️ **Infrastructure as Code (IaC)**\nWith deep expertise in **AWS CDK** and **Terraform**, I ensure your infrastructure is automated, maintainable, and scalable.\n\n📦 **DevOps Expertise**\nFrom CI/CD pipelines with **GitHub Actions** and **GitLab CI** to container orchestration **Kubernetes** and others, I deliver workflows that are smooth and efficient.\n\n🌐 **Hands-On Experience**\nWith over **7 years of AWS experience** and a decade in the tech world, I’ve delivered solutions for companies large and small. My open-source contributions showcase my commitment to transparency and innovation. Feel free to explore my [GitHub profile](https://github.com/mavogel)\n\n---\n\n### 💼 Let’s Build Something Great Together\n\nI know that choosing the right partner is critical to your success. When you work with me, you’re not just contracting an engineer – you’re gaining a trusted advisor and hands-on expert who cares about your business as much as you do.\n\n✔️ **Direct Collaboration**: No middlemen or red tape – you work with me directly.\n✔️ **Transparent Process**: Expect open communication, clear timelines, and visible results.\n✔️ **Real Value**: My solutions focus on delivering measurable impact for your business.\n\n\n<a href=\"https://tinyurl.com/mvc-15min\"><img alt=\"Schedule your call\" src=\"https://img.shields.io/badge/schedule%20your%20call-success.svg?style=for-the-badge\"/></a>\n\n---\n\n## 🙌 Acknowledgements\n\nBig shoutout to the amazing team behind [Projen](https://github.com/projen/projen)!\nTheir groundbreaking work simplifies cloud infrastructure projects and inspires us every day. 💡\n\n## Author\n\n[Manuel Vogel](https://manuel-vogel.de/about/)\n\n[![](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/manuel-vogel)\n[![](https://img.shields.io/badge/GitHub-2b3137?style=for-the-badge&logo=github&logoColor=white)](https://github.com/mavogel)"
+    "markdown": "![Source](https://img.shields.io/github/stars/MV-Consulting/cdk-vscode-server?logo=github&label=GitHub%20Stars)\n[![Build Status](https://github.com/MV-Consulting/cdk-vscode-server/actions/workflows/build.yml/badge.svg)](https://github.com/MV-Consulting/cdk-vscode-server/actions/workflows/build.yml)\n[![ESLint Code Formatting](https://img.shields.io/badge/code_style-eslint-brightgreen.svg)](https://eslint.org)\n[![Latest release](https://img.shields.io/github/release/MV-Consulting/cdk-vscode-server.svg)](https://github.com/MV-Consulting/cdk-vscode-server/releases)\n![GitHub](https://img.shields.io/github/license/MV-Consulting/cdk-vscode-server)\n[![npm](https://img.shields.io/npm/dt/@mavogel/cdk-vscode-server?label=npm&color=orange)](https://www.npmjs.com/package/@mavogel/cdk-vscode-server)\n[![typescript](https://img.shields.io/badge/jsii-typescript-blueviolet.svg)](https://www.npmjs.com/package/@mavogel/cdk-vscode-server)\n\n# cdk-vscode-server\n\nRunning your dev IDE vscode on AWS for development and workshop purposes.\n\n> [!Note]\n> This construct is designed for workshop purposes and does not fulfill all security and authentication best practices.\n\n![EXPERIMENTAL](https://img.shields.io/badge/stability-experimantal-orange?style=for-the-badge)**<br>This is an early version of the package. The API will change while I\nwe implement new features. Therefore make sure you use an exact version in your `package.json` before it reaches 1.0.0.**\n\n## Table of Contents\n\n- [Features](#features)\n- [Usage](#usage)\n  - [Standard](#Standard)\n  - [Custom Domain Configuration](#custom-domain-configuration)\n- [Solution Design](#solution-design)\n- [Inspiration](#inspiration)\n\n## Features\n\n- ⚡ **Quick Setup**: Spin up and configure your [vscode](https://code.visualstudio.com/) server in under 10 minutes in your AWS account\n- 📏 **Best Practice Setup**: Set up with [projen](https://projen.io/) and a [single configuration file](./.projenrc.ts) to keep your changes centralized.\n- 🤹‍♂️ **Pre-installed packages**: Besides the [vscode](https://code.visualstudio.com/) server, other tools and software packages such as `git`, `docker`, `awscli` `nodejs` and `python` are pre-installed on the EC2 instance.\n- 🌐 **Custom Domain Support**: Use your own domain name with automatic ACM certificate creation and Route53 DNS configuration, or bring your existing certificate.\n- 💰 **Auto-Stop**: Automatically stop EC2 instances after inactivity with Elastic IP retention - save up to 75% on costs for development environments\n- 🏗️ **Extensibility**: Pass in properties to the construct, which start with `additional*`. They allow you to extend the configuration to your needs. There are more to come...\n\n## Usage\nActually we supported 2 modes:\n\n### Standard\nThe following steps get you started:\n\n1. Create a new `awscdk-app` via\n```bash\nnpx projen new awscdk-app-ts --package-manager=npm\n```\n3. Add `@mavogel/cdk-vscode-server` as a dependency to your project in the `.projenrc.ts` file\n4. Run `npx projen` to install it\n5. Add the following to the `src/main.ts` file:\n```ts\nimport { App, Stack, StackProps } from 'aws-cdk-lib';\nimport * as ec2 from 'aws-cdk-lib/aws-ec2';\nimport * as iam from 'aws-cdk-lib/aws-iam';\nimport { Construct } from 'constructs';\nimport {\n  LinuxArchitectureType,\n  LinuxFlavorType,\n  VSCodeServer\n} from '@mavogel/cdk-vscode-server';\n\nexport class MyStack extends Stack {\n  constructor(scope: Construct, id: string, props: StackProps = {}) {\n    super(scope, id, props);\n\n    new VSCodeServer(this, 'vscode', {\n      // for example (or simply use the defaults by not setting the properties)\n      instanceVolumeSize: 8,\n      instanceClass: ec2.InstanceClass.M7G,\n      instanceSize: ec2.InstanceSize.LARGE,\n      instanceOperatingSystem: LinuxFlavorType.UBUNTU_22,\n      instanceCpuArchitecture: LinuxArchitectureType.ARM,\n\n      // 👇🏽 or if you want to give the InstanceRole more permissions\n      additionalInstanceRolePolicies: [\n        new iam.PolicyStatement({\n          effect: iam.Effect.ALLOW,\n          actions: [\n            'codebuild:*',\n          ],\n          resources: [\n            `arn:aws:codebuild:*:${Stack.of(this).account}:*/*`,\n          ],\n        }),\n      ]\n\n      // and more... 💡\n    });\n  }\n}\n\nconst env = {\n  account: '123456789912',\n  region: 'eu-central-1',\n};\n\nconst app = new App();\nnew MyStack(app, 'vscode-server', { env });\napp.synth();\n```\n\nand deploy it\n```bash\nnpx projen build\nnpx projen deploy\n```\n\nwith the output\n```console\n✨  Deployment time: 509.87s\n\nOutputs:\ndev.vscodedomainName6729AA39 = https://d1foo65bar4baz.cloudfront.net/?folder=/Workshop\ndev.vscodepassword64FBCA12 = foobarbaz\n```\n\nSee the [examples](./examples) folder for more inspiration.\n\n### Custom Domain Configuration\n\nYou can configure your VS Code Server with a custom domain name instead of using the default CloudFront domain. The construct supports three different configuration options:\n\n#### Option 1: Auto-create Certificate with DNS Validation\n```ts\nnew VSCodeServer(this, 'vscode', {\n  domainName: 'vscode.example.com',\n  hostedZoneId: 'Z123EXAMPLE456',  // optional - will auto-discover if not provided\n  autoCreateCertificate: true,\n});\n```\n\nThis will:\n- Create an ACM certificate in us-east-1 (required for CloudFront)\n- Validate the certificate using DNS validation\n- Create a Route53 A record pointing to the CloudFront distribution\n- Configure the CloudFront distribution with the custom domain\n\n#### Option 2: Use Existing Certificate\n```ts\nnew VSCodeServer(this, 'vscode', {\n  domainName: 'vscode.example.com',\n  hostedZoneId: 'Z123EXAMPLE456',\n  certificateArn: 'arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012',\n});\n```\n\n**Requirements:**\n- Certificate must be in us-east-1 region\n- Certificate must be validated and ready to use\n- Certificate must include the domain name\n\n#### Option 3: Default (No Custom Domain)\n```ts\nnew VSCodeServer(this, 'vscode', {\n  // No domain configuration - uses CloudFront default domain\n});\n```\n\nFor complete examples, see [examples/custom-domain/main.ts](./examples/custom-domain/main.ts).\n\n6. Then open the domain name in your favorite browser and you'd see the following login screen:\n![vscode-server-ui-login](docs/img/vscode-server-ui-login-min.png)\n\n7. After entering the password, you are logged into VSCode and can start coding :tada:\n\n![vscode-server-ui](docs/img/vscode-server-ui-min.png)\n\n> [!Important]\n> There are issues with copy pasting into the VSCode terminal within the Firefox browser (2025-01-12)\n\n### Auto-Stop Configuration\n\nSave up to 75% on costs by automatically stopping EC2 instances when idle:\n\n```ts\nnew VSCodeServer(this, 'vscode', {\n  enableAutoStop: true,              // Enable auto-stop feature\n  idleTimeoutMinutes: 30,            // Stop after 30 minutes of no activity (default)\n  idleCheckIntervalMinutes: 5,       // Check for idle activity every 5 minutes (default)\n});\n```\n\n**How it works:**\n1. **Idle Detection**: Monitors CloudFront request metrics at configured intervals (default: every 5 minutes)\n2. **Auto-Stop**: Stops the EC2 instance after the configured idle timeout when no requests are detected\n3. **Static IP**: Allocates an Elastic IP to maintain a consistent public IP address across stop/start cycles\n4. **Manual Resume**: Users can manually start the instance via AWS Console or CLI when needed\n\n**Cost Savings Example:**\n- **Without auto-stop**: m7g.xlarge running 24/7 = ~$120/month\n- **With auto-stop** (8 hours/day, 5 days/week): ~$30/month\n- **Savings**: ~$90/month (75% reduction)\n\n**Additional costs:**\n- Elastic IP (allocated): ~$3.65/month\n- Lambda function (IdleMonitor): ~$0.10/month\n- EventBridge rule: Negligible\n- **Net savings**: ~$86/month per instance\n\n**Architecture Components:**\n- Elastic IP for consistent public addressing\n- EventBridge rule triggering idle monitoring at configured intervals\n- IdleMonitor Lambda function checking CloudWatch metrics for request activity\n- CloudWatch metrics from CloudFront distribution\n\n**Integration Testing:**\n\nThe stop-on-idle functionality includes comprehensive integration tests (`integ-tests/integ.stop-on-idle.ts`) that verify the complete workflow:\n\n1. **Phase 1 - Verify Auto-Stop**: Waits for the instance to automatically stop after the configured idle timeout\n2. **Phase 2 - Disable IdleMonitor**: Disables the EventBridge rule to prevent the instance from being stopped again during testing\n3. **Phase 3 - Start Instance**: Starts the stopped instance and waits for it to reach the running state\n4. **Phase 4 - Verify Login**: Confirms that VS Code Server is accessible through CloudFront after the instance has been restarted\n\nThis 4-phase test ensures that:\n- Idle detection works correctly based on CloudWatch metrics\n- Instance stops automatically when no activity is detected\n- Instance can be successfully restarted after being stopped\n- VS Code Server remains accessible after stop/start cycles\n- Elastic IP maintains connectivity across state changes\n\nRun integration tests with:\n```bash\nnpm run integ-test\n```\n\n## Solution Design\n\n<details>\n  <summary>... if you're curious about click here for the details</summary>\n\n![vscode-server-solution-design](docs/img/vscode-server.drawio-min.png)\n\n</details>\n\n## Inspiration\nThis project was created based on the following inspiration\n\n- [vscode-on-ec2-for-prototyping](https://github.com/aws-samples/vscode-on-ec2-for-prototyping): as baseline, which unfortunately was outdated\n- [aws-terraform-dev-container](https://github.com/awslabs/aws-terraform-dev-container): as baseline for terraform, but unfortunately also outdated\n- [java-on-aws-workshop-ide-only.yaml](https://github.com/aws-samples/java-on-aws/blob/main/labs/unicorn-store/infrastructure/cfn/java-on-aws-workshop-ide-only.yaml): an already synthesized cloudformation stack, which used mostly python as the custom resources\n- [fleet-workshop-team-stack-self.json](https://static.us-east-1.prod.workshops.aws/public/cc4aa67e-5b7a-4df1-abf7-c42502899a25/assets/fleet-workshop-team-stack-self.json): also an already synthesized cloudformation stack, which did much more as I currently implemented here.\n- [eks-workshop-vscode-cfn.yaml](https://github.com/aws-samples/eks-workshop-v2/blob/main/lab/cfn/eks-workshop-vscode-cfn.yaml): another great baseline\n\n\n## 🚀 Unlock the Full Potential of Your AWS Cloud Infrastructure\n\nHi, I’m Manuel, an AWS expert passionate about empowering businesses with **scalable, resilient, and cost-optimized cloud solutions**. With **MV Consulting**, I specialize in crafting **tailored AWS architectures** and **DevOps-driven workflows** that not only meet your current needs but grow with you.\n\n---\n\n### 🌟 Why Work With Me?\n\n✔️ **Tailored AWS Solutions:** Every business is unique, so I design custom solutions that fit your goals and challenges.\n✔️ **Well-Architected Designs:** From scalability to security, my solutions align with AWS Well-Architected Framework.\n✔️ **Cloud-Native Focus:** I specialize in modern, cloud-native systems that embrace the full potential of AWS.\n✔️ **Business-Driven Tech:** Technology should serve your business, not the other way around.\n\n---\n\n### 🛠 What I Bring to the Table\n\n🔑 **12x AWS Certifications**\nI’m **AWS Certified Solutions Architect and DevOps – Professional** and hold numerous additional certifications, so you can trust I’ll bring industry best practices to your projects. Feel free to explose by [badges](https://www.credly.com/users/manuel-vogel)\n\n⚙️ **Infrastructure as Code (IaC)**\nWith deep expertise in **AWS CDK** and **Terraform**, I ensure your infrastructure is automated, maintainable, and scalable.\n\n📦 **DevOps Expertise**\nFrom CI/CD pipelines with **GitHub Actions** and **GitLab CI** to container orchestration **Kubernetes** and others, I deliver workflows that are smooth and efficient.\n\n🌐 **Hands-On Experience**\nWith over **7 years of AWS experience** and a decade in the tech world, I’ve delivered solutions for companies large and small. My open-source contributions showcase my commitment to transparency and innovation. Feel free to explore my [GitHub profile](https://github.com/mavogel)\n\n---\n\n### 💼 Let’s Build Something Great Together\n\nI know that choosing the right partner is critical to your success. When you work with me, you’re not just contracting an engineer – you’re gaining a trusted advisor and hands-on expert who cares about your business as much as you do.\n\n✔️ **Direct Collaboration**: No middlemen or red tape – you work with me directly.\n✔️ **Transparent Process**: Expect open communication, clear timelines, and visible results.\n✔️ **Real Value**: My solutions focus on delivering measurable impact for your business.\n\n\n<a href=\"https://tinyurl.com/mvc-15min\"><img alt=\"Schedule your call\" src=\"https://img.shields.io/badge/schedule%20your%20call-success.svg?style=for-the-badge\"/></a>\n\n---\n\n## 🙌 Acknowledgements\n\nBig shoutout to the amazing team behind [Projen](https://github.com/projen/projen)!\nTheir groundbreaking work simplifies cloud infrastructure projects and inspires us every day. 💡\n\n## Author\n\n[Manuel Vogel](https://manuel-vogel.de/about/)\n\n[![](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/manuel-vogel)\n[![](https://img.shields.io/badge/GitHub-2b3137?style=for-the-badge&logo=github&logoColor=white)](https://github.com/mavogel)"
   },
   "repository": {
     "type": "git",
@@ -4109,9 +4109,6 @@
   },
   "schema": "jsii/0.10.0",
   "targets": {
-    "go": {
-      "moduleName": "github.com/MV-Consulting/cdk-vscode-server"
-    },
     "js": {
       "npm": "@mavogel/cdk-vscode-server"
     },
@@ -4121,6 +4118,186 @@
     }
   },
   "types": {
+    "@mavogel/cdk-vscode-server.IdleMonitor": {
+      "assembly": "@mavogel/cdk-vscode-server",
+      "base": "constructs.Construct",
+      "docs": {
+        "stability": "experimental",
+        "summary": "Construct that monitors CloudFront request metrics and stops the EC2 instance when idle."
+      },
+      "fqn": "@mavogel/cdk-vscode-server.IdleMonitor",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/idle-monitor/idle-monitor.ts",
+          "line": 61
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@mavogel/cdk-vscode-server.IdleMonitorProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/idle-monitor/idle-monitor.ts",
+        "line": 50
+      },
+      "name": "IdleMonitor",
+      "properties": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The Lambda function that performs idle monitoring."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/idle-monitor/idle-monitor.ts",
+            "line": 54
+          },
+          "name": "function",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.Function"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The EventBridge rule that triggers idle monitoring checks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/idle-monitor/idle-monitor.ts",
+            "line": 59
+          },
+          "name": "scheduleRule",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_events.Rule"
+          }
+        }
+      ],
+      "symbolId": "src/idle-monitor/idle-monitor:IdleMonitor"
+    },
+    "@mavogel/cdk-vscode-server.IdleMonitorProps": {
+      "assembly": "@mavogel/cdk-vscode-server",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Props for IdleMonitor construct."
+      },
+      "fqn": "@mavogel/cdk-vscode-server.IdleMonitorProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/idle-monitor/idle-monitor.ts",
+        "line": 15
+      },
+      "name": "IdleMonitorProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The CloudFront distribution to monitor for activity."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/idle-monitor/idle-monitor.ts",
+            "line": 23
+          },
+          "name": "distribution",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_cloudfront.IDistribution"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Number of minutes of inactivity before stopping the instance."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/idle-monitor/idle-monitor.ts",
+            "line": 27
+          },
+          "name": "idleTimeoutMinutes",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The EC2 instance to monitor."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/idle-monitor/idle-monitor.ts",
+            "line": 19
+          },
+          "name": "instance",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_ec2.IInstance"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "5 - Check every 5 minutes",
+            "stability": "experimental",
+            "summary": "How often to check for idle activity (in minutes)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/idle-monitor/idle-monitor.ts",
+            "line": 32
+          },
+          "name": "checkIntervalMinutes",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "WARNING: For testing only - in production, you should wait for status checks\nto pass before stopping instances",
+            "stability": "experimental",
+            "summary": "Skip instance status checks before stopping When true, IdleMonitor will stop idle instances even if status checks haven't passed This is useful for integration tests where status check initialization time exceeds test timeout limits."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/idle-monitor/idle-monitor.ts",
+            "line": 44
+          },
+          "name": "skipStatusChecks",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/idle-monitor/idle-monitor:IdleMonitorProps"
+    },
     "@mavogel/cdk-vscode-server.LinuxArchitectureType": {
       "assembly": "@mavogel/cdk-vscode-server",
       "docs": {
@@ -4131,7 +4308,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/vscode-server.ts",
-        "line": 180
+        "line": 219
       },
       "members": [
         {
@@ -4162,7 +4339,7 @@
       "kind": "enum",
       "locationInModule": {
         "filename": "src/vscode-server.ts",
-        "line": 160
+        "line": 199
       },
       "members": [
         {
@@ -4190,6 +4367,148 @@
       "name": "LinuxFlavorType",
       "symbolId": "src/vscode-server:LinuxFlavorType"
     },
+    "@mavogel/cdk-vscode-server.StatusCheckApi": {
+      "assembly": "@mavogel/cdk-vscode-server",
+      "base": "constructs.Construct",
+      "docs": {
+        "stability": "experimental",
+        "summary": "API Gateway endpoint for checking instance status, used by resume page for polling."
+      },
+      "fqn": "@mavogel/cdk-vscode-server.StatusCheckApi",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "src/status-check/status-check.ts",
+          "line": 42
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@mavogel/cdk-vscode-server.StatusCheckApiProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/status-check/status-check.ts",
+        "line": 28
+      },
+      "name": "StatusCheckApi",
+      "properties": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The API Gateway REST API."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/status-check/status-check.ts",
+            "line": 32
+          },
+          "name": "api",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_apigateway.RestApi"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The URL of the status check API endpoint."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/status-check/status-check.ts",
+            "line": 36
+          },
+          "name": "apiUrl",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The Lambda function that handles status check requests."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/status-check/status-check.ts",
+            "line": 40
+          },
+          "name": "function",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.Function"
+          }
+        }
+      ],
+      "symbolId": "src/status-check/status-check:StatusCheckApi"
+    },
+    "@mavogel/cdk-vscode-server.StatusCheckApiProps": {
+      "assembly": "@mavogel/cdk-vscode-server",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Props for StatusCheckApi construct."
+      },
+      "fqn": "@mavogel/cdk-vscode-server.StatusCheckApiProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/status-check/status-check.ts",
+        "line": 14
+      },
+      "name": "StatusCheckApiProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The EC2 instance to check status for."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/status-check/status-check.ts",
+            "line": 18
+          },
+          "name": "instance",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_ec2.IInstance"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "DynamoDB table for tracking instance state."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/status-check/status-check.ts",
+            "line": 22
+          },
+          "name": "stateTable",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_dynamodb.ITable"
+          }
+        }
+      ],
+      "symbolId": "src/status-check/status-check:StatusCheckApiProps"
+    },
     "@mavogel/cdk-vscode-server.VSCodeServer": {
       "assembly": "@mavogel/cdk-vscode-server",
       "base": "constructs.Construct",
@@ -4204,7 +4523,7 @@
         },
         "locationInModule": {
           "filename": "src/vscode-server.ts",
-          "line": 206
+          "line": 255
         },
         "parameters": [
           {
@@ -4231,7 +4550,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/vscode-server.ts",
-        "line": 195
+        "line": 234
       },
       "name": "VSCodeServer",
       "properties": [
@@ -4243,13 +4562,28 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 199
+            "line": 238
           },
           "name": "domainName",
           "type": {
             "primitive": "string"
           }
         },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The EC2 instance running VS Code Server."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/vscode-server.ts",
+            "line": 248
+          },
+          "name": "instance",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_ec2.IInstance"
+          }
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -4258,12 +4592,28 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 204
+            "line": 243
           },
           "name": "password",
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The IdleMonitor construct (only present if enableAutoStop is true)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/vscode-server.ts",
+            "line": 253
+          },
+          "name": "idleMonitor",
+          "optional": true,
+          "type": {
+            "fqn": "@mavogel/cdk-vscode-server.IdleMonitor"
+          }
         }
       ],
       "symbolId": "src/vscode-server:VSCodeServer"
@@ -4279,7 +4629,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/vscode-server.ts",
-        "line": 27
+        "line": 29
       },
       "name": "VSCodeServerProps",
       "properties": [
@@ -4293,7 +4643,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 110
+            "line": 112
           },
           "name": "additionalInstanceRolePolicies",
           "optional": true,
@@ -4316,7 +4666,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 117
+            "line": 119
           },
           "name": "additionalTags",
           "optional": true,
@@ -4339,7 +4689,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 154
+            "line": 156
           },
           "name": "autoCreateCertificate",
           "optional": true,
@@ -4357,7 +4707,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 144
+            "line": 146
           },
           "name": "certificateArn",
           "optional": true,
@@ -4375,7 +4725,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 96
+            "line": 98
           },
           "name": "devServerBasePath",
           "optional": true,
@@ -4393,7 +4743,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 103
+            "line": 105
           },
           "name": "devServerPort",
           "optional": true,
@@ -4411,7 +4761,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 126
+            "line": 128
           },
           "name": "domainName",
           "optional": true,
@@ -4419,6 +4769,24 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "stability": "experimental",
+            "summary": "Enable automatic instance stop when idle Monitors CloudFront metrics and stops the EC2 instance after specified idle time."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/vscode-server.ts",
+            "line": 164
+          },
+          "name": "enableAutoStop",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4429,7 +4797,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 89
+            "line": 91
           },
           "name": "homeFolder",
           "optional": true,
@@ -4447,7 +4815,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 135
+            "line": 137
           },
           "name": "hostedZoneId",
           "optional": true,
@@ -4455,6 +4823,42 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "5 - Check every 5 minutes",
+            "stability": "experimental",
+            "summary": "How often to check for idle activity (in minutes) Only applies when enableAutoStop is true."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/vscode-server.ts",
+            "line": 180
+          },
+          "name": "idleCheckIntervalMinutes",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "30",
+            "stability": "experimental",
+            "summary": "Minutes of inactivity before stopping the instance Only applies when enableAutoStop is true."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/vscode-server.ts",
+            "line": 172
+          },
+          "name": "idleTimeoutMinutes",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4465,7 +4869,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 61
+            "line": 63
           },
           "name": "instanceClass",
           "optional": true,
@@ -4483,7 +4887,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 82
+            "line": 84
           },
           "name": "instanceCpuArchitecture",
           "optional": true,
@@ -4501,7 +4905,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 47
+            "line": 49
           },
           "name": "instanceName",
           "optional": true,
@@ -4519,7 +4923,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 75
+            "line": 77
           },
           "name": "instanceOperatingSystem",
           "optional": true,
@@ -4537,7 +4941,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 68
+            "line": 70
           },
           "name": "instanceSize",
           "optional": true,
@@ -4555,7 +4959,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 54
+            "line": 56
           },
           "name": "instanceVolumeSize",
           "optional": true,
@@ -4563,6 +4967,25 @@
             "primitive": "number"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "WARNING: For testing only - in production, you should wait for status checks\nto pass before stopping instances to avoid stopping unhealthy instances",
+            "stability": "experimental",
+            "summary": "Skip instance status checks in IdleMonitor When true, IdleMonitor will stop idle instances even if status checks haven't passed This is useful for integration tests where status check initialization time exceeds the test timeout limits."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/vscode-server.ts",
+            "line": 193
+          },
+          "name": "skipStatusChecks",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4573,7 +4996,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 40
+            "line": 42
           },
           "name": "vscodePassword",
           "optional": true,
@@ -4591,7 +5014,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/vscode-server.ts",
-            "line": 33
+            "line": 35
           },
           "name": "vscodeUser",
           "optional": true,
@@ -4603,6 +5026,6 @@
       "symbolId": "src/vscode-server:VSCodeServerProps"
     }
   },
-  "version": "0.0.60",
-  "fingerprint": "KALG9BRQbEbg6W5HIa8LnU78Xd+kyM0I4M1IzhCDdy8="
+  "version": "0.0.61",
+  "fingerprint": "qfD9LmqMEXJBJyPLrEX6GfeGzezT9TOhGVGOpIUkwYo="
 }