[Init] Initial commit - NetMesh terminal manager

domain/sftpLocatePathInTerminal.test.ts

@@ -0,0 +1,115 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+
+import {
+  canLocateSftpPathInTerminal,
+  resolveLocateSftpPathInTerminalAction,
+  resolveLocateSftpPathSessionId,
+} from "./sftpLocatePathInTerminal.ts";
+
+const base = {
+  path: "/home/user/project",
+  sessionId: "sess-1",
+  sessionStatus: "connected" as const,
+  sessionHostId: "host-1",
+  sftpHostId: "host-1",
+  sftpIsLocal: false,
+  protocol: "ssh" as const,
+  shellType: "posix" as const,
+  isNetworkDevice: false,
+};
+
+test("canLocateSftpPathInTerminal allows connected SSH sessions on the same host", () => {
+  assert.equal(canLocateSftpPathInTerminal(base), true);
+});
+
+test("canLocateSftpPathInTerminal allows mosh/et interactive cd (unlike silent restore)", () => {
+  assert.equal(canLocateSftpPathInTerminal({ ...base, moshEnabled: true }), true);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, etEnabled: true }), true);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, protocol: "mosh" }), true);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, protocol: "et" }), true);
+});
+
+test("canLocateSftpPathInTerminal rejects missing session, disconnected session, or host mismatch", () => {
+  assert.equal(canLocateSftpPathInTerminal({ ...base, sessionId: null }), false);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, sessionStatus: "disconnected" }), false);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, sftpHostId: "other-host" }), false);
+});
+
+test("canLocateSftpPathInTerminal rejects same hostId with different live endpoints", () => {
+  assert.equal(
+    canLocateSftpPathInTerminal({
+      ...base,
+      sessionHostname: "a.example.test",
+      sessionUsername: "root",
+      sessionPort: 22,
+      sftpHostname: "b.example.test",
+      sftpUsername: "root",
+      sftpPort: 22,
+    }),
+    false,
+  );
+});
+
+test("resolveLocateSftpPathSessionId prefers reusable active session then focused fallback", () => {
+  assert.equal(
+    resolveLocateSftpPathSessionId({ activeSessionId: "ssh-reuse", focusedSessionId: "focused" }),
+    "ssh-reuse",
+  );
+  assert.equal(
+    resolveLocateSftpPathSessionId({ activeSessionId: null, focusedSessionId: "mosh-1" }),
+    "mosh-1",
+  );
+  assert.equal(
+    resolveLocateSftpPathSessionId({ activeSessionId: null, focusedSessionId: null }),
+    null,
+  );
+});
+
+test("canLocateSftpPathInTerminal rejects network devices, telnet/serial, and Windows local shells", () => {
+  assert.equal(canLocateSftpPathInTerminal({ ...base, isNetworkDevice: true }), false);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, protocol: "telnet" }), false);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, protocol: "serial" }), false);
+  assert.equal(
+    canLocateSftpPathInTerminal({
+      ...base,
+      protocol: "local",
+      shellType: "powershell",
+      sftpIsLocal: true,
+      sessionHostId: "local-1",
+      sftpHostId: "local-1",
+    }),
+    false,
+  );
+});
+
+test("canLocateSftpPathInTerminal rejects ineligible paths", () => {
+  assert.equal(canLocateSftpPathInTerminal({ ...base, path: "" }), false);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, path: "C:\\Users\\alice" }), false);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, path: "relative/path" }), false);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, path: "/srv/app\tdir" }), false);
+  assert.equal(canLocateSftpPathInTerminal({ ...base, path: "/srv/app\u001bdir" }), false);
+});
+
+test("resolveLocateSftpPathInTerminalAction builds a quoted cd payload", () => {
+  assert.deepEqual(
+    resolveLocateSftpPathInTerminalAction({
+      ...base,
+      path: "/srv/app dir",
+    }),
+    {
+      sessionId: "sess-1",
+      data: "cd -- '/srv/app dir'\r",
+    },
+  );
+});
+
+test("resolveLocateSftpPathInTerminalAction returns null when locate is unavailable", () => {
+  assert.equal(
+    resolveLocateSftpPathInTerminalAction({
+      ...base,
+      sessionStatus: "connecting",
+    }),
+    null,
+  );
+});