lambda-live-debugger 0.0.107 → 0.0.109

package/README.md

@@ -35,12 +35,17 @@ Serverless is amazing and solves many issues with traditional systems. However,
 
 ## How It Works
 
-Lambda Live Debugger connects to your deployed Lambda, routes requests to your computer, and sends responses back to the deployed Lambda. This allows you to debug locally, but the system behaves as if the code is running in the cloud with the same permissions.
+Lambda Live Debugger connects to your deployed Lambda, routes requests to your computer, and sends responses back to the deployed Lambda. This allows you to debug locally, but the system behaves as if the code is running in the cloud with the same permissions. In case of code changes, you do not have to redeploy. The code is reloaded automatically without deploying or even restarting the debugger.
 
 The tool attaches Lambda Extensions (via a Layer), intercepts, and relays calls to AWS IoT. AWS IoT transfers messages between your Lambda and local machine. If the Lambda is written in TypeScript, it's transpiled to JavaScript. The code is executed via the Node Worker Thread.
 
 ![Architecture](./architecture.drawio.png)
 
+AWS keys generated on the cloud for Lambda are transferred to the local environment, so the code has the same permissions as it would executed on the cloud. There could be a difference in packaging, mainly regarding static files, which are probably in different locations. You can use additional environment variables to adjust the code:
+
+- `IS_LOCAL = true` = Lambda is executed locally
+- `LOCAL_PROJECT_DIR` = directory of the project
+
 ### Infrastructure Changes
 
 Lambda Live Debugger makes the following changes to your AWS infrastructure:
@@ -172,6 +177,8 @@ You might want to configure your development tool for debugging. The wizard auto
 }
 ```
 
+Now, you have to press F5 or press Run -> Start Debugging, and you can set breakpoints, step through lines of code, inspect variables... For more information on how to [debug in VSCode, please refer to this link](https://code.visualstudio.com/docs/editor/debugging).
+
 For other tools, please send documentation to include here. WebStorm instructions are especially needed.
 
 ## Monorepo Setup
@@ -224,7 +231,7 @@ Check the [GitHub issues](https://github.com/ServerlessLife/lambda-live-debugger
 
 ## Reporting an Issue
 
-- Make sure the bug hasn't already been reported. If you fount if, add a "+1" comment so I know there are multiple users struggling with the same issue. If possible, add some additional info.
+- Make sure the bug hasn't already been reported. If you fount it has been, add a "+1" comment so I know there are multiple users struggling with the same issue. If possible, add some additional info.
 - Use descriptive titles with prefixes like "bug:", "help:", "feature:", or "discussion:".
 - Enable verbose logging and provide the full log.
 - Describe your setup in detail, or better yet, provide a sample project.

package/dist/configuration.mjs

@@ -43,7 +43,13 @@ async function readConfig() {
                 delete configFromCliArgs[key];
             }
         }
-        const configMerged = { ...configFromConfigFile, ...configFromCliArgs };
+        const configMerged = {
+            ...configFromConfigFile,
+            ...configFromCliArgs,
+            context: configFromCliArgs.context && configFromCliArgs.context?.length > 0
+                ? configFromCliArgs.context
+                : configFromConfigFile?.context,
+        };
         const debuggerId = await generateDebuggerId(!!configMerged.observable);
         setConfig({
             ...configMerged,

package/dist/infraDeploy.mjs

@@ -61,18 +61,26 @@ function getIAMClient() {
 /**
  * Find an existing layer
  * @param layerName
+ * @param description
  * @returns
  */
-async function findExistingLayer(layerName) {
-    const listLayerVersionsCommand = new ListLayerVersionsCommand({
-        LayerName: layerName,
-    });
-    const response = await getLambdaClient().send(listLayerVersionsCommand);
-    if (response.LayerVersions && response.LayerVersions.length > 0) {
-        const latestLayer = response.LayerVersions[0];
-        Logger.verbose(`Latest layer version: ${latestLayer.Version}, description: ${latestLayer.Description}`);
-        return latestLayer;
-    }
+async function findExistingLayerVersion(layerName, description) {
+    let nextMarker;
+    do {
+        const listLayerVersionsCommand = new ListLayerVersionsCommand({
+            LayerName: layerName,
+            Marker: nextMarker,
+        });
+        const response = await getLambdaClient().send(listLayerVersionsCommand);
+        if (response.LayerVersions && response.LayerVersions.length > 0) {
+            const matchingLayer = response.LayerVersions.find((layer) => layer.Description === description);
+            if (matchingLayer) {
+                Logger.verbose(`Matching layer version: ${matchingLayer.Version}, description: ${matchingLayer.Description}`);
+                return matchingLayer;
+            }
+        }
+        nextMarker = response.NextMarker;
+    } while (nextMarker);
     Logger.verbose("No existing layer found.");
     return undefined;
 }
@@ -82,24 +90,8 @@ async function findExistingLayer(layerName) {
  */
 async function deployLayer() {
     const layerDescription = `Lambda Live Debugger Layer version ${await getVersion()}`;
-    let layerZipPathFullPath = path.resolve(path.join(getModuleDirname(), "./extension/extension.zip"));
-    Logger.verbose(`Layer ZIP path: ${layerZipPathFullPath}`);
-    // check if file exists
-    try {
-        await fs.access(layerZipPathFullPath);
-    }
-    catch {
-        // if I am debugging
-        const layerZipPathFullPath2 = path.join(getModuleDirname(), "../dist/extension/extension.zip");
-        try {
-            await fs.access(layerZipPathFullPath2);
-            layerZipPathFullPath = layerZipPathFullPath2;
-        }
-        catch {
-            throw new Error(`File for the layer not found: ${layerZipPathFullPath}`);
-        }
-    }
-    const existingLayer = await findExistingLayer(layerName);
+    // Check if the layer already exists
+    const existingLayer = await findExistingLayerVersion(layerName, layerDescription);
     if (existingLayer &&
         existingLayer.LayerVersionArn &&
         existingLayer.Description === layerDescription // check if the layer version is already deployed
@@ -118,6 +110,24 @@ async function deployLayer() {
             return existingLayer.LayerVersionArn;
         }
     }
+    // check the ZIP
+    let layerZipPathFullPath = path.resolve(path.join(getModuleDirname(), "./extension/extension.zip"));
+    // get the full path to the ZIP file
+    try {
+        await fs.access(layerZipPathFullPath);
+    }
+    catch {
+        // if I am debugging
+        const layerZipPathFullPath2 = path.join(getModuleDirname(), "../dist/extension/extension.zip");
+        try {
+            await fs.access(layerZipPathFullPath2);
+            layerZipPathFullPath = layerZipPathFullPath2;
+        }
+        catch {
+            throw new Error(`File for the layer not found: ${layerZipPathFullPath}`);
+        }
+    }
+    Logger.verbose(`Layer ZIP path: ${layerZipPathFullPath}`);
     // Read the ZIP file containing your layer code
     const layerContent = await fs.readFile(layerZipPathFullPath);
     Logger.verbose(`Deploying ${layerDescription}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lambda-live-debugger",
-  "version": "0.0.107",
+  "version": "0.0.109",
   "type": "module",
   "description": "Debug Lambda functions locally like it is running in the cloud",
   "repository": {