[Init] Initial commit - NetMesh terminal manager

components/terminal/runtime/terminalCloseCapture.test.ts

@@ -0,0 +1,116 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { readFileSync } from "node:fs";
+
+import {
+  isTerminalCloseGenerationCurrent,
+  resolveConnectionLogCapturePayload,
+  resolveHibernateSnapshotCapturePayload,
+  scheduleTerminalCloseTeardown,
+} from "./terminalCloseCapture.ts";
+
+test("resolveConnectionLogCapturePayload returns null when finalize produces empty data", () => {
+  assert.equal(
+    resolveConnectionLogCapturePayload(() => ""),
+    null,
+  );
+});
+
+test("resolveConnectionLogCapturePayload returns buffered connection log data", () => {
+  assert.deepEqual(
+    resolveConnectionLogCapturePayload(() => "line one\r\nline two"),
+    { data: "line one\r\nline two", source: "connection-log" },
+  );
+});
+
+test("resolveHibernateSnapshotCapturePayload prefers combined snapshot fields", () => {
+  assert.deepEqual(
+    resolveHibernateSnapshotCapturePayload({
+      snapshot: "full snapshot",
+      viewportSnapshot: "viewport",
+      scrollbackSnapshot: "scrollback",
+      alternateScreen: false,
+    }),
+    { data: "full snapshot", source: "hibernate-serialize" },
+  );
+
+  assert.deepEqual(
+    resolveHibernateSnapshotCapturePayload({
+      snapshot: "",
+      viewportSnapshot: "viewport",
+      scrollbackSnapshot: "scrollback",
+      alternateScreen: false,
+    }),
+    { data: "scrollbackviewport", source: "hibernate-serialize" },
+  );
+});
+
+test("scheduleTerminalCloseTeardown runs teardown asynchronously", async () => {
+  let ran = false;
+  scheduleTerminalCloseTeardown(() => {
+    ran = true;
+  });
+  assert.equal(ran, false);
+  await new Promise<void>((resolve) => {
+    setTimeout(resolve, 0);
+  });
+  assert.equal(ran, true);
+});
+
+test("isTerminalCloseGenerationCurrent rejects stale close generations", () => {
+  assert.equal(isTerminalCloseGenerationCurrent(1, 1), true);
+  assert.equal(isTerminalCloseGenerationCurrent(1, 2), false);
+});
+
+test("terminal close fully drains pending output before finalizing capture", () => {
+  const source = readFileSync(
+    new URL("../useTerminalEffects.ts", import.meta.url),
+    "utf8",
+  );
+  const cleanupStart = source.indexOf("return () => {", source.indexOf("void boot();"));
+  const flushIndex = source.indexOf("await flushPendingTerminalWritesBeforeHibernate(term)", cleanupStart);
+  const incompleteIndex = source.indexOf("if (!flushed)", flushIndex);
+  const finalizeIndex = source.indexOf("resolveConnectionLogCapturePayload(finalizeTerminalLogData)", cleanupStart);
+
+  assert.ok(cleanupStart >= 0);
+  assert.ok(flushIndex > cleanupStart);
+  assert.ok(incompleteIndex > flushIndex);
+  assert.ok(finalizeIndex > flushIndex);
+});
+
+test("never-connected StrictMode cleanup sync-disposes its owned xterm runtime", () => {
+  const source = readFileSync(
+    new URL("../useTerminalEffects.ts", import.meta.url),
+    "utf8",
+  );
+  const cleanupStart = source.indexOf("return () => {", source.indexOf("void boot();"));
+  assert.ok(cleanupStart >= 0);
+  const neverConnectedClose = source.indexOf(
+    "if (!hasConnectedRef.current)",
+    cleanupStart,
+  );
+  assert.ok(neverConnectedClose > cleanupStart);
+  const branch = source.slice(
+    neverConnectedClose,
+    source.indexOf("const persistCloseCapture", neverConnectedClose),
+  );
+  assert.match(branch, /if \(!attachExistingSession\)/);
+  assert.match(branch, /disposeOwnedRuntime\(\);/);
+  assert.match(branch, /return;/);
+  assert.ok(
+    branch.indexOf("disposeOwnedRuntime();") < branch.indexOf("return;"),
+    "orphaned StrictMode xterm must be disposed before leaving cleanup",
+  );
+});
+
+test("createXTermRuntime clears orphaned .xterm children before open", () => {
+  const source = readFileSync(
+    new URL("./createXTermRuntime.ts", import.meta.url),
+    "utf8",
+  );
+  const openAt = source.indexOf("term.open(ctx.container);");
+  assert.ok(openAt > 0);
+  const beforeOpen = source.slice(Math.max(0, openAt - 350), openAt);
+  assert.match(beforeOpen, /querySelectorAll\(":scope > \.xterm"\)/);
+  assert.match(beforeOpen, /orphan\.remove\(\)/);
+});