@adobe/aem-cli 16.15.0 → 16.15.2

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [16.15.2](https://github.com/adobe/helix-cli/compare/v16.15.1...v16.15.2) (2025-09-24)
+
+
+### Bug Fixes
+
+* hlx proxy now respects .hlxignore and warns for ignored files ([#2086](https://github.com/adobe/helix-cli/issues/2086)) ([a413938](https://github.com/adobe/helix-cli/commit/a413938bdcbdc8987306c82f90242d110979ea51))
+
+## [16.15.1](https://github.com/adobe/helix-cli/compare/v16.15.0...v16.15.1) (2025-09-22)
+
+
+### Bug Fixes
+
+* inject hlx:proxyUrl meta tag for 401 and 403 HTML responses ([ff4f2e8](https://github.com/adobe/helix-cli/commit/ff4f2e84e897676141601fccb165d678715b3ac8)), closes [#2414](https://github.com/adobe/helix-cli/issues/2414)
+
 # [16.15.0](https://github.com/adobe/helix-cli/compare/v16.14.0...v16.15.0) (2025-09-22)
 
 

package/package.json

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

package/src/server/HelixProject.js

@@ -11,6 +11,7 @@
  */
 import path, { resolve } from 'path';
 import { lstat } from 'fs/promises';
+import { IgnoreConfig } from '@adobe/helix-shared-config';
 import { HelixServer } from './HelixServer.js';
 import { BaseProject } from './BaseProject.js';
 import HeadHtmlSupport from './HeadHtmlSupport.js';
@@ -25,6 +26,7 @@ export class HelixProject extends BaseProject {
     this._printIndex = false;
     this._allowInsecure = false;
     this._file404html = null;
+    this._hlxIgnore = null;
   }
 
   withLiveReload(value) {
@@ -135,12 +137,28 @@ export class HelixProject extends BaseProject {
     return this._htmlFolder;
   }
 
+  get hlxIgnore() {
+    return this._hlxIgnore;
+  }
+
   async init() {
     await super.init();
     this._indexer = new Indexer()
       .withLogger(this._logger)
       .withCwd(this._cwd)
       .withPrintIndex(this._printIndex);
+
+    // Initialize IgnoreConfig for .hlxignore support
+    this._hlxIgnore = new IgnoreConfig()
+      .withDirectory(this._cwd);
+
+    try {
+      await this._hlxIgnore.init();
+    } catch (e) {
+      // .hlxignore file doesn't exist or couldn't be loaded, which is fine
+      this._hlxIgnore = null;
+    }
+
     return this;
   }
 
@@ -196,12 +214,40 @@ export class HelixProject extends BaseProject {
     }
   }
 
+  async initHlxIgnore() {
+    if (this._hlxIgnore && this.liveReload) {
+      const hlxIgnorePath = resolve(this.directory, '.hlxignore');
+      try {
+        await lstat(hlxIgnorePath);
+        this.log.debug('detected .hlxignore file');
+        if (this.liveReload) {
+          this.liveReload.registerFiles([hlxIgnorePath], '/');
+          this.liveReload.on('modified', async (modified) => {
+            if (modified.includes('.hlxignore')) {
+              this.log.debug('Reloading .hlxignore file');
+              // Re-initialize the IgnoreConfig to reload the file
+              try {
+                await this._hlxIgnore.init();
+              } catch (e) {
+                // If reload fails, just continue without ignore support
+                this._hlxIgnore = null;
+              }
+            }
+          });
+        }
+      } catch (e) {
+        // .hlxignore doesn't exist, which is fine
+      }
+    }
+  }
+
   async start() {
     this.log.debug('Launching AEM dev server...');
     await super.start();
     await this.initHeadHtml();
     await this.init404Html();
     await this.initHtmlFolder();
+    await this.initHlxIgnore();
     if (this._indexer) {
       await this._indexer.init();
     }

package/src/server/HelixServer.js

@@ -253,6 +253,16 @@ export class HelixServer extends BaseServer {
       return;
     }
 
+    // Check if the file is ignored by .hlxignore
+    if (this._project.hlxIgnore) {
+      // IgnoreConfig expects relative paths from project root
+      const relativePath = path.relative(this._project.directory, filePath);
+      const isIgnored = this._project.hlxIgnore.ignores(relativePath);
+      if (isIgnored) {
+        log.warn(`Warning: Proxying ignored file: ${ctx.path} (matched by .hlxignore)`);
+      }
+    }
+
     const liveReload = this._liveReload;
     if (liveReload) {
       liveReload.startRequest(ctx.requestId, ctx.path);

package/src/server/utils.js

@@ -325,6 +325,7 @@ window.LiveReloadOptions = {
     }
 
     const isHTML = ret.status === 200 && contentType.indexOf('text/html') === 0;
+    const isHTMLWithAuthError = (ret.status === 401 || ret.status === 403) && contentType.indexOf('text/html') === 0;
     const livereload = isHTML && opts.injectLiveReload;
     const replaceHead = isHTML && opts.headHtml;
     const doIndex = isHTML && opts.indexer && url.indexOf('.plain.html') < 0;
@@ -380,6 +381,24 @@ window.LiveReloadOptions = {
         .send(textBody);
       return;
     }
+    if (isHTMLWithAuthError) {
+      // Handle HTML responses with 401/403 status - inject meta tag
+      let textBody = await ret.text();
+      if (ctx.log.level === 'silly') {
+        ctx.log.trace(textBody);
+        ctx.log.trace(`[${id}] <<<--------------------------`);
+      }
+      textBody = utils.injectMeta(textBody, {
+        'hlx:proxyUrl': url,
+      });
+
+      res
+        .set(respHeaders)
+        .status(ret.status)
+        .send(textBody);
+      return;
+    }
+
     if (ret.status === 401 || ret.status === 403) {
       const reqHeaders = req.headers;
       if (opts.autoLogin && opts.loginPath