Server.windows

import { strict as assert } from "node:assert";
import { mkdtemp, readdir, rm } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { Server, MultipleMatchesError } from "libtmux";

const directory = await mkdtemp(join(tmpdir(), "ltx-example-"));
const server = new Server({
  socketPath: join(directory, "tmux.sock"),
  configFile: "/dev/null",
  timeoutMs: 5_000,
});
const failures: unknown[] = [];
try {
  const session = await server.newSession({
    name: "home",
    windowName: "editor",
    shellCommand: "cat",
  });
  const guest = await server.newSession({
    name: "guest",
    windowName: "shell",
    shellCommand: "cat",
  });
  const window = await session.newWindow({ name: "logs", shellCommand: "cat" });
  await window.link({ session: guest });
  const windows = await server.windows();
  const logs = windows.where({ name: "logs" });
  assert.equal(logs.count(), 2);
  console.log("logs placements:", logs.count());
  try {
    logs.one();
    throw new Error("Expected a linked window lookup to be ambiguous");
  } catch (error) {
    if (!(error instanceof MultipleMatchesError)) throw error;
    console.log("ambiguous:", error.code);
  }
  const placed = logs.one({ session: { is: { name: "home" } } });
  assert.equal(placed.id, window.id);
  console.log("selected placement:", placed.session?.name);
  console.log(
    "linked sessions:",
    placed.linkedSessions
      .map((item) => item.name)
      .sort()
      .join(", "),
  );
} catch (error) {
  failures.push(error);
} finally {
  try {
    if ((await readdir(directory)).includes("tmux.sock")) await server.kill();
    await rm(directory, { recursive: true });
  } catch (error) {
    failures.push(new Error(`Cleanup failed; inspect ${directory}`, { cause: error }));
  }
}
if (failures.length > 0) throw new AggregateError(failures, "Example failed");