npm - @codeyam/codeyam-cli - Versions diffs - 0.1.31 → 0.1.33 - Mend

@codeyam/codeyam-cli 0.1.31 → 0.1.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/analyzer-template/.build-info.json CHANGED Viewed

@@ -1,10 +1,10 @@
 {
-  "buildTimestamp": "2026-04-04T16:37:04.184Z",
-  "buildTime": 1775320624184,
-  "gitCommit": "633ad0efb9f5d80434350c1d085083b4cf52b1fb",
+  "buildTimestamp": "2026-04-15T16:14:43.677Z",
+  "buildTime": 1776269683677,
+  "gitCommit": "d00016715e0b175acef32dfd210f767cabcfdd36",
   "nodeVersion": "v20.20.2",
   "contentHash": "c92230c027acb71cab56d2a696876a6a52206bfadd59fbc31a512b00a7ee8826",
-  "buildNumber": 1348,
-  "semanticVersion": "0.1.1348",
-  "version": "0.1.1348 (2026-04-04T16:37+c92230c)"
+  "buildNumber": 1353,
+  "semanticVersion": "0.1.1353",
+  "version": "0.1.1353 (2026-04-15T16:14+c92230c)"
 }

package/analyzer-template/log.txt CHANGED Viewed

@@ -1,7 +1,7 @@
-[4/4/2026, 4:37:04 PM] > codeyam-combo@1.0.0 mergeDependencies
-[4/4/2026, 4:37:04 PM] > node ./scripts/mergePackageJsonFiles.cjs
+[4/15/2026, 4:14:43 PM] > codeyam-combo@1.0.0 mergeDependencies
+[4/15/2026, 4:14:43 PM] > node ./scripts/mergePackageJsonFiles.cjs
-[4/4/2026, 4:37:04 PM] Merged dependencies into root package.json
+[4/15/2026, 4:14:43 PM] Merged dependencies into root package.json

package/codeyam-cli/src/utils/__tests__/devServerState.test.js CHANGED Viewed

@@ -1,4 +1,4 @@
-import { computeDevServerTransition, } from "../devServerState.js";
+import { computeDevServerTransition, shouldAutoRestartOnError, MAX_AUTO_RESTARTS, AUTO_RESTART_COOLDOWN_MS, } from "../devServerState.js";
 describe('computeDevServerTransition', () => {
     const baseState = {
         url: null,
@@ -131,4 +131,96 @@ describe('computeDevServerTransition', () => {
         });
     });
 });
+describe('shouldAutoRestartOnError', () => {
+    const freshState = {
+        lastAutoRestartAt: 0,
+        autoRestartCount: 0,
+    };
+    it('should allow restart on first error', () => {
+        const now = Date.now();
+        const result = shouldAutoRestartOnError(freshState, false, now);
+        expect(result.shouldRestart).toBe(true);
+        expect(result.nextState.autoRestartCount).toBe(1);
+        expect(result.nextState.lastAutoRestartAt).toBe(now);
+    });
+    it('should allow a second restart after cooldown expires', () => {
+        const firstRestartAt = 1000;
+        const state = {
+            lastAutoRestartAt: firstRestartAt,
+            autoRestartCount: 1,
+        };
+        const now = firstRestartAt + AUTO_RESTART_COOLDOWN_MS + 1;
+        const result = shouldAutoRestartOnError(state, false, now);
+        expect(result.shouldRestart).toBe(true);
+        expect(result.nextState.autoRestartCount).toBe(2);
+    });
+    it('should block restart when within cooldown window', () => {
+        const firstRestartAt = 1000;
+        const state = {
+            lastAutoRestartAt: firstRestartAt,
+            autoRestartCount: 1,
+        };
+        const now = firstRestartAt + AUTO_RESTART_COOLDOWN_MS - 1;
+        const result = shouldAutoRestartOnError(state, false, now);
+        expect(result.shouldRestart).toBe(false);
+        // State should not change
+        expect(result.nextState).toBe(state);
+    });
+    it('should block restart at exactly the cooldown boundary', () => {
+        const firstRestartAt = 1000;
+        const state = {
+            lastAutoRestartAt: firstRestartAt,
+            autoRestartCount: 0,
+        };
+        const now = firstRestartAt + AUTO_RESTART_COOLDOWN_MS - 1;
+        const result = shouldAutoRestartOnError(state, false, now);
+        expect(result.shouldRestart).toBe(false);
+    });
+    it('should block restart when max attempts reached', () => {
+        const state = {
+            lastAutoRestartAt: 0,
+            autoRestartCount: MAX_AUTO_RESTARTS,
+        };
+        const now = Date.now();
+        const result = shouldAutoRestartOnError(state, false, now);
+        expect(result.shouldRestart).toBe(false);
+        expect(result.nextState).toBe(state);
+    });
+    it('should block restart when server is already starting', () => {
+        const result = shouldAutoRestartOnError(freshState, true, Date.now());
+        expect(result.shouldRestart).toBe(false);
+        expect(result.nextState).toBe(freshState);
+    });
+    it('should block restart when starting even if count and cooldown are ok', () => {
+        const result = shouldAutoRestartOnError(freshState, true, Date.now());
+        expect(result.shouldRestart).toBe(false);
+    });
+    it('should allow restart after count is reset (simulating successful server run)', () => {
+        const state = {
+            lastAutoRestartAt: 0,
+            autoRestartCount: 0, // reset after successful run
+        };
+        const result = shouldAutoRestartOnError(state, false, Date.now());
+        expect(result.shouldRestart).toBe(true);
+    });
+    it('should track consecutive failures up to the max', () => {
+        let state = freshState;
+        const results = [];
+        // Simulate MAX_AUTO_RESTARTS + 1 rapid errors (well past cooldown each time)
+        for (let i = 0; i <= MAX_AUTO_RESTARTS; i++) {
+            const now = (i + 1) * (AUTO_RESTART_COOLDOWN_MS + 1000);
+            const result = shouldAutoRestartOnError(state, false, now);
+            results.push(result.shouldRestart);
+            state = result.nextState;
+        }
+        // First MAX_AUTO_RESTARTS should succeed, then blocked
+        expect(results.slice(0, MAX_AUTO_RESTARTS)).toEqual(Array(MAX_AUTO_RESTARTS).fill(true));
+        expect(results[MAX_AUTO_RESTARTS]).toBe(false);
+    });
+    it('should use exported constants for limits', () => {
+        // Sanity check the constants are reasonable
+        expect(MAX_AUTO_RESTARTS).toBe(2);
+        expect(AUTO_RESTART_COOLDOWN_MS).toBe(30000);
+    });
+});
 //# sourceMappingURL=devServerState.test.js.map

package/codeyam-cli/src/utils/__tests__/devServerState.test.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"devServerState.test.js","sourceRoot":"","sources":["../../../../../src/utils/__tests__/devServerState.test.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,~~GAG3B~~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"}
1	+ {"version":3,"file":"devServerState.test.js","sourceRoot":"","sources":["../../../../../src/utils/__tests__/devServerState.test.ts"],"names":[],"mappings":"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"}

package/codeyam-cli/src/utils/devServerState.js CHANGED Viewed

@@ -68,4 +68,36 @@ export function computeDevServerTransition(current, response) {
     // Unknown status — no changes
     return { ...current, shouldAutoStart: false };
 }
+// ─── Server Error Auto-Restart Logic ────────────────────────────────
+/** Max consecutive auto-restarts before requiring manual intervention. */
+export const MAX_AUTO_RESTARTS = 2;
+/** Minimum interval (ms) between auto-restart attempts. */
+export const AUTO_RESTART_COOLDOWN_MS = 30000;
+/**
+ * Decide whether to auto-restart the dev server after an error page
+ * is shown in the preview iframe. Pure function for testability.
+ *
+ * Prevents restart loops by enforcing:
+ * - A 30-second cooldown between auto-restarts
+ * - A maximum of 2 consecutive auto-restarts (reset when server comes up)
+ * - No restart if the server is already starting
+ */
+export function shouldAutoRestartOnError(state, isStarting, now) {
+    if (isStarting) {
+        return { shouldRestart: false, nextState: state };
+    }
+    if (now - state.lastAutoRestartAt < AUTO_RESTART_COOLDOWN_MS) {
+        return { shouldRestart: false, nextState: state };
+    }
+    if (state.autoRestartCount >= MAX_AUTO_RESTARTS) {
+        return { shouldRestart: false, nextState: state };
+    }
+    return {
+        shouldRestart: true,
+        nextState: {
+            lastAutoRestartAt: now,
+            autoRestartCount: state.autoRestartCount + 1,
+        },
+    };
+}
 //# sourceMappingURL=devServerState.js.map

package/codeyam-cli/src/utils/devServerState.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"devServerState.js","sourceRoot":"","sources":["../../../../src/utils/devServerState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAuB,EACvB,QAA8B;IAE9B,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO;YACL,GAAG,EAAE,IAAI;YACT,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,QAAQ,CAAC,YAAY,IAAI,oBAAoB;YACpD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjB,OAAO;YACL,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;YACnC,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,IAAI;YACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO;YACL,GAAG,OAAO;YACV,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,kDAAkD;YAClD,OAAO;gBACL,GAAG,OAAO;gBACV,GAAG,EAAE,IAAI;gBACT,UAAU,EAAE,KAAK;gBACjB,eAAe,EAAE,KAAK;aACvB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAChC,wDAAwD;YACxD,OAAO;gBACL,GAAG,OAAO;gBACV,kBAAkB,EAAE,IAAI;gBACxB,eAAe,EAAE,IAAI;aACtB,CAAC;QACJ,CAAC;QAED,4CAA4C;QAC5C,OAAO;YACL,GAAG,OAAO;YACV,UAAU,EAAE,KAAK;YACjB,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,OAAO,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC"}
1	+ {"version":3,"file":"devServerState.js","sourceRoot":"","sources":["../../../../src/utils/devServerState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAuB,EACvB,QAA8B;IAE9B,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO;YACL,GAAG,EAAE,IAAI;YACT,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,QAAQ,CAAC,YAAY,IAAI,oBAAoB;YACpD,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjB,OAAO;YACL,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;YACnC,UAAU,EAAE,KAAK;YACjB,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,IAAI;YACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO;YACL,GAAG,OAAO;YACV,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE,IAAI;YACX,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,kDAAkD;YAClD,OAAO;gBACL,GAAG,OAAO;gBACV,GAAG,EAAE,IAAI;gBACT,UAAU,EAAE,KAAK;gBACjB,eAAe,EAAE,KAAK;aACvB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;YAChC,wDAAwD;YACxD,OAAO;gBACL,GAAG,OAAO;gBACV,kBAAkB,EAAE,IAAI;gBACxB,eAAe,EAAE,IAAI;aACtB,CAAC;QACJ,CAAC;QAED,4CAA4C;QAC5C,OAAO;YACL,GAAG,OAAO;YACV,UAAU,EAAE,KAAK;YACjB,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,OAAO,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,uEAAuE;AAEvE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAM,CAAC;AAY/C;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAA8B,EAC9B,UAAmB,EACnB,GAAW;IAEX,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,GAAG,GAAG,KAAK,CAAC,iBAAiB,GAAG,wBAAwB,EAAE,CAAC;QAC7D,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,IAAI,iBAAiB,EAAE,CAAC;QAChD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpD,CAAC;IAED,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE;YACT,iBAAiB,EAAE,GAAG;YACtB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,GAAG,CAAC;SAC7C;KACF,CAAC;AACJ,CAAC"}

package/codeyam-cli/src/webserver/__tests__/editorProxy.test.js CHANGED Viewed

@@ -1,6 +1,6 @@
 import http from 'http';
 import zlib from 'zlib';
-import { injectHealthScript, PREVIEW_HEALTH_SCRIPT, getPreviewHealthReport, resetPreviewHealth, } from "../editorProxy.js";
+import { injectHealthScript, PREVIEW_HEALTH_SCRIPT, getPreviewHealthReport, resetPreviewHealth, buildErrorPage, escapeHtml, } from "../editorProxy.js";
 describe('editorProxy', () => {
     describe('normalizeTargetUrl', () => {
         it('should leave localhost as-is (no longer normalizes to 127.0.0.1)', () => {
@@ -758,5 +758,243 @@ describe('editorProxy', () => {
             expect(response.headers.get('cache-control')).toBeNull();
         });
     });
+    describe('escapeHtml', () => {
+        it('should escape ampersands, angle brackets, and quotes', () => {
+            expect(escapeHtml('<script>alert("xss")</script>')).toBe('&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;');
+        });
+        it('should escape single quotes', () => {
+            expect(escapeHtml("it's")).toBe('it&#39;s');
+        });
+        it('should return empty string for empty input', () => {
+            expect(escapeHtml('')).toBe('');
+        });
+        it('should leave safe text unchanged', () => {
+            expect(escapeHtml('Hello world 123')).toBe('Hello world 123');
+        });
+    });
+    describe('buildErrorPage', () => {
+        it('should generate a complete HTML document', () => {
+            const page = buildErrorPage(500, 'Internal Server Error', 'something broke');
+            expect(page).toContain('<!DOCTYPE html>');
+            expect(page).toContain('<html');
+            expect(page).toContain('</html>');
+        });
+        it('should include the status code and title', () => {
+            const page = buildErrorPage(502, 'Dev Server Unreachable', 'details here');
+            expect(page).toContain('502');
+            expect(page).toContain('Dev Server Unreachable');
+        });
+        it('should include the error detail text', () => {
+            const page = buildErrorPage(500, 'Error', 'Connection refused on port 3000');
+            expect(page).toContain('Connection refused on port 3000');
+        });
+        it('should escape HTML in the detail to prevent XSS', () => {
+            const page = buildErrorPage(500, 'Error', '<script>alert("xss")</script>');
+            expect(page).not.toContain('<script>alert("xss")</script>');
+            expect(page).toContain('&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;');
+        });
+        it('should include codeyam-server-error postMessage', () => {
+            const page = buildErrorPage(500, 'Error', 'detail');
+            expect(page).toContain('codeyam-server-error');
+            expect(page).toContain('postMessage');
+        });
+        it('should NOT include codeyam-preview-ready postMessage', () => {
+            const page = buildErrorPage(500, 'Error', 'detail');
+            expect(page).not.toContain('codeyam-preview-ready');
+        });
+        it('should include a retry button that sends codeyam-server-error-retry', () => {
+            const page = buildErrorPage(500, 'Error', 'detail');
+            expect(page).toContain('codeyam-server-error-retry');
+            // Should have a button element
+            expect(page).toMatch(/<button[^>]*>/i);
+        });
+        it('should include the status code in the postMessage data', () => {
+            const page = buildErrorPage(502, 'Unreachable', 'detail');
+            // The postMessage should include statusCode: 502
+            expect(page).toContain('502');
+        });
+        it('should escape HTML in the title to prevent XSS', () => {
+            const page = buildErrorPage(500, '<img onerror=alert(1)>', 'detail');
+            expect(page).not.toContain('<img onerror=alert(1)>');
+            expect(page).toContain('&lt;img onerror=alert(1)&gt;');
+        });
+        it('should handle multiline error detail', () => {
+            const detail = 'Error on line 1\nStack trace line 2\nStack trace line 3';
+            const page = buildErrorPage(500, 'Error', detail);
+            expect(page).toContain('Error on line 1');
+            expect(page).toContain('Stack trace line 3');
+        });
+        it('should handle empty detail', () => {
+            const page = buildErrorPage(500, 'Error', '');
+            expect(page).toContain('<!DOCTYPE html>');
+            expect(page).toContain('codeyam-server-error');
+        });
+    });
+    describe('5xx error page serving', () => {
+        let targetServer;
+        let targetPort;
+        afterEach(async () => {
+            const { stopEditorProxy } = require('../editorProxy');
+            await stopEditorProxy();
+            if (targetServer?.listening) {
+                await new Promise((resolve) => targetServer.close(() => resolve()));
+            }
+        });
+        it('should serve an error page instead of raw HTML for 500 responses', async () => {
+            const { startEditorProxy } = require('../editorProxy');
+            targetServer = http.createServer((_req, res) => {
+                res.writeHead(500, { 'Content-Type': 'text/html' });
+                res.end('<html><body>Internal Server Error</body></html>');
+            });
+            await new Promise((resolve) => targetServer.listen(0, '127.0.0.1', () => resolve()));
+            targetPort = targetServer.address().port;
+            const result = await startEditorProxy({
+                port: 0,
+                targetUrl: `http://localhost:${targetPort}`,
+            });
+            expect(result).not.toBeNull();
+            const response = await fetch(`http://127.0.0.1:${result.port}/`);
+            expect(response.status).toBe(500);
+            const body = await response.text();
+            // Should contain the friendly error page, not the raw error
+            expect(body).toContain('codeyam-server-error');
+            expect(body).toContain('Internal Server Error');
+        });
+        it('should NOT replace non-HTML 500 responses', async () => {
+            const { startEditorProxy } = require('../editorProxy');
+            targetServer = http.createServer((_req, res) => {
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'server error' }));
+            });
+            await new Promise((resolve) => targetServer.listen(0, '127.0.0.1', () => resolve()));
+            targetPort = targetServer.address().port;
+            const result = await startEditorProxy({
+                port: 0,
+                targetUrl: `http://localhost:${targetPort}`,
+            });
+            expect(result).not.toBeNull();
+            const response = await fetch(`http://127.0.0.1:${result.port}/api/data`);
+            expect(response.status).toBe(500);
+            const body = await response.text();
+            // JSON responses should pass through unchanged
+            expect(body).toContain('"error":"server error"');
+            expect(body).not.toContain('codeyam-server-error');
+        });
+        it('should serve an error page for 500 responses with no content type', async () => {
+            const { startEditorProxy } = require('../editorProxy');
+            // Simulates Next.js returning bare "Internal Server Error" with no Content-Type
+            targetServer = http.createServer((_req, res) => {
+                res.writeHead(500);
+                res.end('Internal Server Error');
+            });
+            await new Promise((resolve) => targetServer.listen(0, '127.0.0.1', () => resolve()));
+            targetPort = targetServer.address().port;
+            const result = await startEditorProxy({
+                port: 0,
+                targetUrl: `http://localhost:${targetPort}`,
+            });
+            expect(result).not.toBeNull();
+            const response = await fetch(`http://127.0.0.1:${result.port}/`);
+            expect(response.status).toBe(500);
+            const body = await response.text();
+            expect(body).toContain('codeyam-server-error');
+            expect(body).toContain('<!DOCTYPE html>');
+            expect(body).toContain('Internal Server Error');
+        });
+        it('should serve an error page for 500 text/plain responses', async () => {
+            const { startEditorProxy } = require('../editorProxy');
+            targetServer = http.createServer((_req, res) => {
+                res.writeHead(500, { 'Content-Type': 'text/plain' });
+                res.end('Something went wrong');
+            });
+            await new Promise((resolve) => targetServer.listen(0, '127.0.0.1', () => resolve()));
+            targetPort = targetServer.address().port;
+            const result = await startEditorProxy({
+                port: 0,
+                targetUrl: `http://localhost:${targetPort}`,
+            });
+            expect(result).not.toBeNull();
+            const response = await fetch(`http://127.0.0.1:${result.port}/`);
+            expect(response.status).toBe(500);
+            const body = await response.text();
+            expect(body).toContain('codeyam-server-error');
+            expect(body).toContain('Something went wrong');
+        });
+        it('should serve an error page for 503 responses', async () => {
+            const { startEditorProxy } = require('../editorProxy');
+            targetServer = http.createServer((_req, res) => {
+                res.writeHead(503, { 'Content-Type': 'text/html' });
+                res.end('<html><body>Service Unavailable</body></html>');
+            });
+            await new Promise((resolve) => targetServer.listen(0, '127.0.0.1', () => resolve()));
+            targetPort = targetServer.address().port;
+            const result = await startEditorProxy({
+                port: 0,
+                targetUrl: `http://localhost:${targetPort}`,
+            });
+            expect(result).not.toBeNull();
+            const response = await fetch(`http://127.0.0.1:${result.port}/`);
+            expect(response.status).toBe(503);
+            const body = await response.text();
+            expect(body).toContain('codeyam-server-error');
+        });
+        it('should serve an error page for POST requests returning 500', async () => {
+            const { startEditorProxy } = require('../editorProxy');
+            targetServer = http.createServer((_req, res) => {
+                res.writeHead(500, { 'Content-Type': 'text/html' });
+                res.end('<html><body>POST Error</body></html>');
+            });
+            await new Promise((resolve) => targetServer.listen(0, '127.0.0.1', () => resolve()));
+            targetPort = targetServer.address().port;
+            const result = await startEditorProxy({
+                port: 0,
+                targetUrl: `http://localhost:${targetPort}`,
+            });
+            expect(result).not.toBeNull();
+            const response = await fetch(`http://127.0.0.1:${result.port}/api/action`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ test: true }),
+            });
+            expect(response.status).toBe(500);
+            const body = await response.text();
+            expect(body).toContain('codeyam-server-error');
+            expect(body).toContain('POST Error');
+        });
+        it('should NOT serve an error page for 4xx responses', async () => {
+            const { startEditorProxy } = require('../editorProxy');
+            targetServer = http.createServer((_req, res) => {
+                res.writeHead(404, { 'Content-Type': 'text/html' });
+                res.end('<html><body>Not Found</body></html>');
+            });
+            await new Promise((resolve) => targetServer.listen(0, '127.0.0.1', () => resolve()));
+            targetPort = targetServer.address().port;
+            const result = await startEditorProxy({
+                port: 0,
+                targetUrl: `http://localhost:${targetPort}`,
+            });
+            expect(result).not.toBeNull();
+            const response = await fetch(`http://127.0.0.1:${result.port}/missing`);
+            expect(response.status).toBe(404);
+            const body = await response.text();
+            // 4xx should pass through normally (with health script injected, not error page)
+            expect(body).not.toContain('codeyam-server-error');
+            expect(body).toContain('Not Found');
+        });
+        it('should serve an HTML error page for 502 connection failures', async () => {
+            const { startEditorProxy } = require('../editorProxy');
+            // No target server — connection will fail
+            const result = await startEditorProxy({
+                port: 0,
+                targetUrl: 'http://127.0.0.1:19999',
+            });
+            expect(result).not.toBeNull();
+            const response = await fetch(`http://127.0.0.1:${result.port}/`);
+            expect(response.status).toBe(502);
+            const body = await response.text();
+            expect(body).toContain('codeyam-server-error');
+            expect(body).toContain('<!DOCTYPE html>');
+        });
+    });
 });
 //# sourceMappingURL=editorProxy.test.js.map