@adobe/aem-cli 16.15.1 → 16.15.2

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [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)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/aem-cli",
-  "version": "16.15.1",
+  "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);