chore: import upstream snapshot with attribution

2026-07-13 13:39:12 +08:00
commit d8dcd5f6d1
8604 changed files with 2479390 additions and 0 deletions
@@ -0,0 +1,26 @@
+/**
+ * resolveServerEntry.js — pure helper for selecting the Next.js server entrypoint.
+ *
+ * The WS-aware wrapper `server-ws.mjs` installs the trusted peer-IP stamp
+ * (peer-stamp.mjs) that the authz middleware needs to allow loopback/LAN access
+ * to LOCAL_ONLY routes (AgentBridge, MCP, services, etc.).  Without it every
+ * LOCAL_ONLY request returns 403.
+ *
+ * We prefer `server-ws.mjs` when it exists — mirroring run-standalone.mjs — and
+ * fall back to the bare `server.js` only when the wrapper is absent (e.g. an
+ * older build or a stripped bundle).
+ *
+ * Extracted as a pure helper so it can be unit-tested without importing the full
+ * Electron main process (which requires the Electron binary).
+ *
+ * @param {string}   serverDir   - directory that contains server.js / server-ws.mjs
+ * @param {Function} existsSyncFn - injectable fs.existsSync (for unit tests)
+ * @returns {string} filename ("server-ws.mjs" or "server.js")
+ */
+function resolveServerEntry(serverDir, existsSyncFn) {
+  const path = require("path");
+  const wsEntry = path.join(serverDir, "server-ws.mjs");
+  return existsSyncFn(wsEntry) ? "server-ws.mjs" : "server.js";
+}
+
+module.exports = { resolveServerEntry };