cdk-booster 1.1.0-alpha.2 → 1.1.0

package/README.md

@@ -58,17 +58,112 @@ const functionTestJsEsModule = new lambda_nodejs.NodejsFunction(
 );
 ```
 
-### Verbose Logging
+### Command Line Parameters
+
+CDK Booster supports several command-line parameters to customize its behavior:
+
+#### Verbose Logging
 
 To enable verbose logging for debugging purposes, add the `-v` parameter:
 
 ```json
 {
-  "app": "npx cdk-booster bin/your_app.ts -v".
+  "app": "npx cdk-booster bin/your_app.ts -v",
+  ...
+}
+```
+
+#### Batch Size (`-b`, `--batch`)
+
+Controls the number of Lambda functions bundled together in a single ESBuild batch. This is particularly useful for large projects with many Lambda functions (100+).
+
+**Default:** No limit (all Lambdas with identical build settings are bundled together)
+
+**When to use:**
+
+- For projects with 100+ Lambda functions
+- To reduce memory usage during builds
+
+**Example:**
+
+```json
+{
+  "app": "npx cdk-booster bin/your_app.ts -b 20",
+  ...
+}
+```
+
+Setting `-b 20` limits each ESBuild batch to 20 Lambda functions. If ESBuild crashes, only that batch of 20 functions is affected rather than all functions. Functions in the failed batch will still be bundled by CDK's standard process.
+
+#### Parallel Builds (`-p`, `--parallel`)
+
+Controls the maximum number of parallel ESBuild processes running simultaneously.
+
+**Default:** Unlimited (all batches run in parallel)
+
+**When to use:**
+
+- To limit resource usage (CPU/memory) on constrained environments
+- For CI/CD pipelines with limited resources
+- When experiencing ESBuild crashes due to too many concurrent processes
+
+**Example:**
+
+```json
+{
+  "app": "npx cdk-booster bin/your_app.ts -p 1",
   ...
 }
 ```
 
+Setting `-p 1` ensures only one ESBuild process runs at a time, which can help prevent crashes on resource-constrained systems.
+
+#### Combining Parameters
+
+You can combine multiple parameters for fine-tuned control:
+
+```json
+{
+  "app": "npx cdk-booster bin/your_app.ts -b 20 -p 2 -v",
+  ...
+}
+```
+
+### Skipping Specific Lambda Functions
+
+You can exclude individual Lambda functions from CDK Booster processing by setting the `SKIP_CDK_BOOSTER` environment variable in the `bundling` property. This is useful when:
+
+- A specific Lambda consistently causes bundling errors
+- You want to use custom bundling settings for particular functions
+- You need to debug issues with specific Lambda functions
+
+**Important:** This is a bundling-time environment variable (set in `bundling.environment`), not a runtime environment variable for your Lambda function.
+
+**Example:**
+
+```typescript
+import * as lambda_nodejs from 'aws-cdk-lib/aws-lambda-nodejs';
+
+// This Lambda will be skipped by CDK Booster
+new lambda_nodejs.NodejsFunction(this, 'ProblematicFunction', {
+  entry: 'services/problematic/handler.ts',
+  environment: {
+    // Runtime environment variables for your Lambda
+    API_ENDPOINT: 'https://api.example.com',
+  },
+  bundling: {
+    environment: {
+      // Bundling-time environment variable - tells CDK Booster to skip this function
+      SKIP_CDK_BOOSTER: 'true',
+    },
+    minify: false,
+    sourceMap: true,
+  },
+});
+```
+
+When a Lambda is skipped, CDK Booster ignores it during the pre-bundling phase, and AWS CDK will bundle it using its standard (slower) sequential process. The function will still work normally - it just won't benefit from CDK Booster's speed improvements.
+
 ## How It Works
 
 CDK Booster operates through a multi-phase process:
@@ -98,6 +193,15 @@ If CDK needs to run synthesis again due to unresolved resources requiring lookup
 - AWS CDK v2.x with TypeScript
 - TypeScript or JavaScript Lambda handlers using `NodejsFunction` construct
 
+## Troubleshooting
+
+For large projects, if you encounter ESBuild crashes:
+
+- **Upgrade ESBuild:** Try upgrading ESBuild to the latest version.
+- **Start with:** `-b 5 -p 1` (batch size 5, sequential processing)
+- **Then adjust:** Increase batch size or parallelism based on your system resources
+- **Skip specific functions:** Add `SKIP_CDK_BOOSTER: 'true'` to `bundling.environment` for problematic Lambdas
+
 ## Authors
 
 - [Marko (ServerlessLife)](https://www.serverlesslife.com/)

package/dist/cdk-booster.mjs

@@ -53,7 +53,9 @@ async function run() {
             compileCodeFile,
         });
         Logger.verbose(`Found ${lambdas.length} Lambda functions in the CDK code:`, JSON.stringify(lambdas, null, 2));
-        const lambdasEsBuildCommands = lambdas;
+        let lambdasEsBuildCommands = lambdas;
+        // skip all lambdas that have SKIP_CDK_BOOSTER env var set to true in their bundling environment
+        lambdasEsBuildCommands = lambdasEsBuildCommands.filter((lambda) => lambda.environment?.SKIP_CDK_BOOSTER !== 'true');
         // Prepare bundling temp folders for each Lambda function
         await recreateBundlingTempFolders(lambdasEsBuildCommands);
         // Execute pre-bundling commands
@@ -97,9 +99,9 @@ async function bundle(lambdasEsBuildCommands) {
     for (const buildBatch of buildBatches) {
         const build = async () => {
             parallelCount++;
+            const buildOptions = buildBatch.buildOptions;
+            const entryPoints = buildBatch.entryPoints;
             try {
-                const buildOptions = buildBatch.buildOptions;
-                const entryPoints = buildBatch.entryPoints;
                 const normalizedEsbuildArgs = normalizeEsbuildArgs(buildOptions.esbuildArgs);
                 const esBuildOpt = {
                     entryPoints,
@@ -142,6 +144,9 @@ async function bundle(lambdasEsBuildCommands) {
                     ...buildingResults.metafile?.outputs,
                 };
             }
+            catch (error) {
+                Logger.error(`The following functions failed to bundle:\n - ${entryPoints.join('\n - ')}. Set batch parameter (-b) to a smaller number, like 5, to lower the chance of this error, and in case of error, a smaller batch would be affected.`, error);
+            }
             finally {
                 parallelCount--;
             }

package/node_modules/chalk/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "chalk",
-	"version": "5.6.0",
+	"version": "5.6.2",
 	"description": "Terminal string styling done right",
 	"license": "MIT",
 	"repository": "chalk/chalk",

package/node_modules/commander/Readme.md

@@ -943,7 +943,7 @@ You can configure the help by modifying data properties and methods using `.conf
 
 Simple properties include `sortSubcommands`, `sortOptions`, and `showGlobalOptions`. You can add color using the style methods like `styleTitle()`.
 
-For more detail and examples of changing the displayed text, color, and layout see (./docs/help-in-depth.md).
+For more detail and examples of changing the displayed text, color, and layout see [help in depth](./docs/help-in-depth.md).
 
 ## Custom event listeners
 
@@ -1063,7 +1063,7 @@ customise the new subcommand (example file [custom-command-class.js](./examples/
 You can enable `--harmony` option in two ways:
 
 - Use `#! /usr/bin/env node --harmony` in the subcommands scripts. (Note Windows does not support this pattern.)
-- Use the `--harmony` option when call the command, like `node --harmony examples/pm publish`. The `--harmony` option will be preserved when spawning subcommand process.
+- Use the `--harmony` option when calling the command, like `node --harmony examples/pm publish`. The `--harmony` option will be preserved when spawning subcommand processes.
 
 ### Debugging stand-alone executable subcommands
 

package/node_modules/commander/lib/argument.js

@@ -33,7 +33,7 @@ class Argument {
         break;
     }
 
-    if (this._name.length > 3 && this._name.slice(-3) === '...') {
+    if (this._name.endsWith('...')) {
       this.variadic = true;
       this._name = this._name.slice(0, -3);
     }
@@ -53,12 +53,13 @@ class Argument {
    * @package
    */
 
-  _concatValue(value, previous) {
+  _collectValue(value, previous) {
     if (previous === this.defaultValue || !Array.isArray(previous)) {
       return [value];
     }
 
-    return previous.concat(value);
+    previous.push(value);
+    return previous;
   }
 
   /**
@@ -103,7 +104,7 @@ class Argument {
         );
       }
       if (this.variadic) {
-        return this._concatValue(arg, previous);
+        return this._collectValue(arg, previous);
       }
       return arg;
     };

package/node_modules/commander/lib/command.js

@@ -245,11 +245,10 @@ class Command extends EventEmitter {
   configureOutput(configuration) {
     if (configuration === undefined) return this._outputConfiguration;
 
-    this._outputConfiguration = Object.assign(
-      {},
-      this._outputConfiguration,
-      configuration,
-    );
+    this._outputConfiguration = {
+      ...this._outputConfiguration,
+      ...configuration,
+    };
     return this;
   }
 
@@ -375,7 +374,7 @@ class Command extends EventEmitter {
    */
   addArgument(argument) {
     const previousArgument = this.registeredArguments.slice(-1)[0];
-    if (previousArgument && previousArgument.variadic) {
+    if (previousArgument?.variadic) {
       throw new Error(
         `only the last argument can be variadic '${previousArgument.name()}'`,
       );
@@ -702,7 +701,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       if (val !== null && option.parseArg) {
         val = this._callParseArg(option, val, oldValue, invalidValueMessage);
       } else if (val !== null && option.variadic) {
-        val = option._concatValue(val, oldValue);
+        val = option._collectValue(val, oldValue);
       }
 
       // Fill-in appropriate missing values. Long winded but easy to follow.
@@ -1481,7 +1480,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
 
   _chainOrCall(promise, fn) {
     // thenable
-    if (promise && promise.then && typeof promise.then === 'function') {
+    if (promise?.then && typeof promise.then === 'function') {
       // already have a promise, chain callback
       return promise.then(() => fn());
     }
@@ -1612,7 +1611,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       promiseChain = this._chainOrCallHooks(promiseChain, 'postAction');
       return promiseChain;
     }
-    if (this.parent && this.parent.listenerCount(commandEvent)) {
+    if (this.parent?.listenerCount(commandEvent)) {
       checkForUnknownOptions();
       this._processArguments();
       this.parent.emit(commandEvent, operands, unknown); // legacy
@@ -1742,15 +1741,14 @@ Expecting one of '${allowedValues.join("', '")}'`);
    *     sub --unknown uuu op => [sub], [--unknown uuu op]
    *     sub -- --unknown uuu op => [sub --unknown uuu op], []
    *
-   * @param {string[]} argv
+   * @param {string[]} args
    * @return {{operands: string[], unknown: string[]}}
    */
 
-  parseOptions(argv) {
+  parseOptions(args) {
     const operands = []; // operands, not options or values
     const unknown = []; // first unknown option and remaining unknown args
     let dest = operands;
-    const args = argv.slice();
 
     function maybeOption(arg) {
       return arg.length > 1 && arg[0] === '-';
@@ -1769,13 +1767,16 @@ Expecting one of '${allowedValues.join("', '")}'`);
 
     // parse options
     let activeVariadicOption = null;
-    while (args.length) {
-      const arg = args.shift();
+    let activeGroup = null; // working through group of short options, like -abc
+    let i = 0;
+    while (i < args.length || activeGroup) {
+      const arg = activeGroup ?? args[i++];
+      activeGroup = null;
 
       // literal
       if (arg === '--') {
         if (dest === unknown) dest.push(arg);
-        dest.push(...args);
+        dest.push(...args.slice(i));
         break;
       }
 
@@ -1793,17 +1794,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
         // recognised option, call listener to assign value with possible custom processing
         if (option) {
           if (option.required) {
-            const value = args.shift();
+            const value = args[i++];
             if (value === undefined) this.optionMissingArgument(option);
             this.emit(`option:${option.name()}`, value);
           } else if (option.optional) {
             let value = null;
             // historical behaviour is optional value is following arg unless an option
             if (
-              args.length > 0 &&
-              (!maybeOption(args[0]) || negativeNumberArg(args[0]))
+              i < args.length &&
+              (!maybeOption(args[i]) || negativeNumberArg(args[i]))
             ) {
-              value = args.shift();
+              value = args[i++];
             }
             this.emit(`option:${option.name()}`, value);
           } else {
@@ -1826,9 +1827,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
             // option with value following in same argument
             this.emit(`option:${option.name()}`, arg.slice(2));
           } else {
-            // boolean option, emit and put back remainder of arg for further processing
+            // boolean option
             this.emit(`option:${option.name()}`);
-            args.unshift(`-${arg.slice(2)}`);
+            // remove the processed option and keep processing group
+            activeGroup = `-${arg.slice(2)}`;
           }
           continue;
         }
@@ -1865,26 +1867,23 @@ Expecting one of '${allowedValues.join("', '")}'`);
       ) {
         if (this._findCommand(arg)) {
           operands.push(arg);
-          if (args.length > 0) unknown.push(...args);
+          unknown.push(...args.slice(i));
           break;
         } else if (
           this._getHelpCommand() &&
           arg === this._getHelpCommand().name()
         ) {
-          operands.push(arg);
-          if (args.length > 0) operands.push(...args);
+          operands.push(arg, ...args.slice(i));
           break;
         } else if (this._defaultCommandName) {
-          unknown.push(arg);
-          if (args.length > 0) unknown.push(...args);
+          unknown.push(arg, ...args.slice(i));
           break;
         }
       }
 
       // If using passThroughOptions, stop processing options at first command-argument.
       if (this._passThroughOptions) {
-        dest.push(arg);
-        if (args.length > 0) dest.push(...args);
+        dest.push(arg, ...args.slice(i));
         break;
       }
 

package/node_modules/commander/lib/option.js

@@ -162,12 +162,13 @@ class Option {
    * @package
    */
 
-  _concatValue(value, previous) {
+  _collectValue(value, previous) {
     if (previous === this.defaultValue || !Array.isArray(previous)) {
       return [value];
     }
 
-    return previous.concat(value);
+    previous.push(value);
+    return previous;
   }
 
   /**
@@ -186,7 +187,7 @@ class Option {
         );
       }
       if (this.variadic) {
-        return this._concatValue(arg, previous);
+        return this._collectValue(arg, previous);
       }
       return arg;
     };

package/node_modules/commander/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commander",
-  "version": "14.0.0",
+  "version": "14.0.1",
   "description": "the complete solution for node.js command-line programs",
   "keywords": [
     "commander",
@@ -61,16 +61,16 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.4.0",
-    "@types/jest": "^29.2.4",
+    "@types/jest": "^30.0.0",
     "@types/node": "^22.7.4",
     "eslint": "^9.17.0",
     "eslint-config-prettier": "^10.0.1",
-    "eslint-plugin-jest": "^28.3.0",
+    "eslint-plugin-jest": "^29.0.1",
     "globals": "^16.0.0",
-    "jest": "^29.3.1",
+    "jest": "^30.0.3",
     "prettier": "^3.2.5",
     "ts-jest": "^29.0.3",
-    "tsd": "^0.31.0",
+    "tsd": "^0.33.0",
     "typescript": "^5.0.4",
     "typescript-eslint": "^8.12.2"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdk-booster",
-  "version": "1.1.0-alpha.2",
+  "version": "1.1.0",
   "type": "module",
   "description": "Speed up AWS CDK's bundling of TypeScript/JavaScript Lambda handlers",
   "homepage": "https://www.cdkbooster.com",
@@ -60,30 +60,30 @@
     "docs:preview": "vitepress preview"
   },
   "devDependencies": {
-    "@eslint/js": "^9.34.0",
+    "@eslint/js": "^9.37.0",
     "@tsconfig/node22": "^22.0.2",
     "@types/eslint-config-prettier": "^6.11.3",
-    "@types/node": "^24.3.0",
-    "aws-cdk": "2.1027.0",
-    "aws-cdk-lib": "2.213.0",
+    "@types/node": "^24.7.2",
+    "aws-cdk": "2.1030.0",
+    "aws-cdk-lib": "2.219.0",
     "constructs": "^10.4.2",
-    "eslint": "^9.34.0",
+    "eslint": "^9.37.0",
     "eslint-config-prettier": "^10.1.8",
-    "globals": "^16.3.0",
+    "globals": "^16.4.0",
     "husky": "^9.1.7",
     "prettier": "^3.6.2",
-    "semantic-release": "^24.2.7",
-    "tsx": "^4.20.5",
-    "typescript-eslint": "^8.41.0",
+    "semantic-release": "^24.2.9",
+    "tsx": "^4.20.6",
+    "typescript-eslint": "^8.46.1",
     "vitepress": "^1.6.4",
-    "@aws-sdk/client-lambda": "^3.879.0",
+    "@aws-sdk/client-lambda": "^3.908.0",
     "adm-zip": "^0.5.16",
     "@types/adm-zip": "^0.5.7"
   },
   "dependencies": {
-    "chalk": "^5.6.0",
-    "commander": "^14.0.0",
-    "typescript": "~5.9.2"
+    "chalk": "^5.6.2",
+    "commander": "^14.0.1",
+    "typescript": "~5.9.3"
   },
   "peerDependencies": {
     "esbuild": "^0"