@adobe/aem-cli 16.10.45 → 16.10.46

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [16.10.46](https://github.com/adobe/helix-cli/compare/v16.10.45...v16.10.46) (2025-08-30)
+
+
+### Bug Fixes
+
+* **2576:** provide a way to dump all headers ([#2577](https://github.com/adobe/helix-cli/issues/2577)) ([38c2275](https://github.com/adobe/helix-cli/commit/38c2275a8ceec531aa9f4abb4d3cafe66c15a222))
+
 ## [16.10.45](https://github.com/adobe/helix-cli/compare/v16.10.44...v16.10.45) (2025-08-26)
 
 

package/README.md

@@ -17,22 +17,7 @@ Install `aem` as a global command. You need Node 12.11 or newer.
 npm install -g @adobe/aem-cli
 ```
 
-### Migrating from older version
-
-Starting with version 15.0.0, this tool is named `aem` and published as `@adobe/aem-cli`. If you previously had installed this tool under its old name `hlx` aka `@adobe/helix-cli` you might get an error like:
-
-```
-npm error EEXIST: file already exists
-npm error File exists: /opt/homebrew/bin/hlx
-npm error Remove the existing file and try again, or run npm
-```
-
-To solve, first uninstall the old version, then try again:
-
-```
-npm uninstall -g @adobe/helix-cli
-npm install -g @adobe/aem-cli
-```
+If this fails with `File exists: /opt/homebrew/bin/hlx`, please [see here](#npm-install-fails-with-file-exists-opthomebrewbinhlx).
 
 ## Quick Start
 
@@ -204,3 +189,25 @@ aem up
 ```
 
 This will make Node.js trust the server certificate and `aem up` should work.
+
+## `npm install` fails with `File exists: /opt/homebrew/bin/hlx`
+
+If you try to install `@adobe/aem-cli`: 
+
+```
+> npm install -g @adobe/aem-cli
+...
+npm error EEXIST: file already exists
+npm error File exists: /opt/homebrew/bin/hlx
+npm error Remove the existing file and try again, or run npm
+```
+
+This can happen when you previously had installed this tool under its old package name [@adobe/helix-cli](https://www.npmjs.com/package/@adobe/helix-cli). Starting with version 15.0.0, this tool was renamed `aem` and published as `@adobe/aem-cli`. The previous `@adobe/helix-cli` has been deprecated. However, the new package still provides the command line binary under the old name `hlx` in addition to `aem`, for backwards compatibility, which can lead to the npm install error.
+
+To solve, first uninstall the old version, then install again with the new name:
+
+```
+npm uninstall -g @adobe/helix-cli
+npm install -g @adobe/aem-cli
+```
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/aem-cli",
-  "version": "16.10.45",
+  "version": "16.10.46",
   "description": "AEM CLI",
   "main": "index.js",
   "type": "module",

package/src/import.cmd.js

@@ -24,6 +24,7 @@ export default class ImportCommand extends AbstractServerCommand {
     super(logger);
     this._importerSubPath = 'tools/importer';
     this._allowInsecure = true;
+    this._dumpHeaders = false;
   }
 
   withAllowInsecure(value) {
@@ -59,6 +60,11 @@ export default class ImportCommand extends AbstractServerCommand {
     return this;
   }
 
+  withDumpHeaders(value) {
+    this._dumpHeaders = value;
+    return this;
+  }
+
   /**
    * Ensure the UI branch the caller specified (or defaulted to) is the one being used.
    * @param uiFolder
@@ -136,7 +142,8 @@ export default class ImportCommand extends AbstractServerCommand {
       .withLogger(this._logger)
       .withKill(this._kill)
       .withAllowInsecure(this._allowInsecure)
-      .withHeadersFile(this._headersFile);
+      .withHeadersFile(this._headersFile)
+      .withDumpHeaders(this._dumpHeaders);
     this.log.info(chalk`{yellow     ___    ________  ___                                __}`);
     this.log.info(chalk`{yellow    /   |  / ____/  |/  /  (_)___ ___  ____  ____  _____/ /____  _____}`);
     this.log.info(chalk`{yellow   / /| | / __/ / /|_/ /  / / __ \`__ \\/ __ \\/ __ \\/ ___/ __/ _ \\/ ___/}`);

package/src/import.js

@@ -80,6 +80,12 @@ export default function up() {
           type: 'string',
           default: undefined,
         })
+        .option('dump-headers', {
+          alias: 'dumpHeaders',
+          describe: 'Dump request headers to console for debugging',
+          type: 'boolean',
+          default: false,
+        })
         .group(['port', 'addr', 'stop-other', 'tls-cert', 'tls-key'], 'Server options')
         .option('cache', {
           describe: 'Path to local folder to cache the responses',
@@ -118,6 +124,7 @@ export default function up() {
         .withSkipUI(argv.skipUI)
         .withUIRepo(argv.uiRepo)
         .withHeadersFile(argv.headersFile)
+        .withDumpHeaders(argv.dumpHeaders)
         .run();
     },
   };

package/src/server/HelixImportProject.js

@@ -18,6 +18,7 @@ export class HelixImportProject extends BaseProject {
     super(HelixImportServer);
 
     this._allowInsecure = true;
+    this._dumpHeaders = false;
   }
 
   withAllowInsecure(value) {
@@ -42,6 +43,15 @@ export class HelixImportProject extends BaseProject {
     return this._cliHeaders;
   }
 
+  withDumpHeaders(value) {
+    this._dumpHeaders = value;
+    return this;
+  }
+
+  get dumpHeaders() {
+    return this._dumpHeaders;
+  }
+
   async start() {
     this.log.debug('Launching AEM import server for importing content...');
     await super.start();

package/src/server/HelixImportServer.js

@@ -108,6 +108,17 @@ export class HelixImportServer extends BaseServer {
     delete headers['accept-encoding'];
     await this._updateHeaders(headers);
 
+    // Dump headers if dump mode is enabled
+    if (this._project.dumpHeaders) {
+      ctx.log.info('=== REQUEST HEADERS ===');
+      ctx.log.info(`Request URL: ${url}`);
+      ctx.log.info(`Request Method: ${req.method}`);
+      Object.entries(headers).forEach(([key, value]) => {
+        ctx.log.info(`${key}: ${value}`);
+      });
+      ctx.log.info('=======================');
+    }
+
     const ret = await getFetch(ctx.config.allowInsecure)(url, {
       method: req.method,
       headers,
@@ -186,8 +197,8 @@ export class HelixImportServer extends BaseServer {
         host = new URL(host).origin;
         const url = this._makeProxyURL(ctx.url, host);
         await this._doProxyRequest(ctx, url, host, req, res);
-      // codecov:ignore:start
-      /* c8 ignore start */
+        // codecov:ignore:start
+        /* c8 ignore start */
       } catch (err) {
         log.error(`Failed to proxy AEM request ${ctx.path}: ${err.message}`);
         res.status(502).send(`Failed to proxy AEM request: ${err.message}`);