Skip to content
Source
Sign inSign up
Open History to see the last commit

sshHelper.ts

148 lines4.8 KB

1// @effect-diagnostics nodeBuiltinImport:off
2// @effect-diagnostics globalTimers:off
3// @effect-diagnostics globalDateInEffect:off
4import * as NodeFS from "node:fs";
5import * as NodeHttp from "node:http";
6import * as NodeNet from "node:net";
7​
8import * as Effect from "effect/Effect";
9import * as Option from "effect/Option";
10import { Argument, Command } from "effect/cli";
11​
12import * as DesktopUpdateMarker from "../desktopUpdate/DesktopUpdateMarker.ts";
13​
14const canBind = (port: number) =>
15 new Promise<boolean>((resolve) => {
16 const server = NodeNet.createServer();
17 server.unref();
18 server.once("error", () => resolve(false));
19 server.listen(port, "127.0.0.1", () => {
20 server.close((error) => resolve(!error));
21 });
22 });
23​
24// macOS permits this bind over a wildcard listener, so also check loopback connectivity.
25const answersOnLoopback = (port: number) =>
26 new Promise<boolean>((resolve) => {
27 const socket = NodeNet.connect({ port, host: "127.0.0.1" });
28 socket.setTimeout(1000);
29 socket.once("connect", () => {
30 socket.destroy();
31 resolve(true);
32 });
33 socket.once("timeout", () => {
34 socket.destroy();
35 resolve(true);
36 });
37 socket.once("error", () => resolve(false));
38 });
39​
40const pickPort = Command.make("pick-port", {
41 portFile: Argument.String("port-file"),
42 defaultPort: Argument.Int("default-port"),
43 scanWindow: Argument.Int("scan-window"),
44}).pipe(
45 Command.withHandler(({ portFile, defaultPort, scanWindow }) =>
46 Effect.promise(async () => {
47 const raw = NodeFS.existsSync(portFile) ? NodeFS.readFileSync(portFile, "utf8").trim() : "";
48 const preferred = Number.parseInt(raw, 10);
49 const start = Number.isInteger(preferred) ? preferred : defaultPort;
50 for (let port = start; port < start + scanWindow; port += 1) {
51 if ((await canBind(port)) && !(await answersOnLoopback(port))) {
52 process.stdout.write(String(port));
53 return;
54 }
55 }
56 process.exitCode = 1;
57 }),
58 ),
59);
60​
61const probe = (port: number, probeTimeoutMs: number) =>
62 new Promise<boolean>((resolve) => {
63 const request = NodeHttp.get(
64 { hostname: "127.0.0.1", port, path: "/", timeout: probeTimeoutMs },
65 (response) => {
66 response.resume();
67 response.once("end", () => {
68 const status = response.statusCode ?? 0;
69 resolve(status >= 200 && status < 300);
70 });
71 },
72 );
73 request.once("timeout", () => {
74 request.destroy();
75 resolve(false);
76 });
77 request.once("error", () => resolve(false));
78 });
79​
80const waitReady = Command.make("wait-ready", {
81 port: Argument.Int("port"),
82 timeoutMs: Argument.Int("timeout-ms"),
83 probeTimeoutMs: Argument.Int("probe-timeout-ms"),
84}).pipe(
85 Command.withHandler(({ port, timeoutMs, probeTimeoutMs }) =>
86 Effect.promise(async () => {
87 const deadline = Date.now() + timeoutMs;
88 while (Date.now() < deadline) {
89 if (await probe(port, probeTimeoutMs)) return;
90 await new Promise((resolve) => setTimeout(resolve, 100));
91 }
92 process.exitCode = 1;
93 }),
94 ),
95);
96​
97/** Prints `<pid> <port>` for a live default-home server, or exits 1. */
98const runtimePort = Command.make("runtime-port", {
99 runtimeFile: Argument.String("runtime-file"),
100}).pipe(
101 Command.withHandler(({ runtimeFile }) =>
102 Effect.sync(() => {
103 try {
104 // @effect-diagnostics-next-line globalJsonInEffect:off - mirrors the shell snippet's loose parse.
105 const runtime = JSON.parse(NodeFS.readFileSync(runtimeFile, "utf8")) as {
106 pid?: unknown;
107 port?: unknown;
108 origin?: unknown;
109 };
110 const pid = Number(runtime.pid);
111 const port = Number(runtime.port);
112 if (!Number.isInteger(pid) || pid <= 0 || !Number.isInteger(port)) {
113 process.exitCode = 1;
114 return;
115 }
116 const origin = new URL(String(runtime.origin ?? ""));
117 if (origin.protocol !== "http:" || !["127.0.0.1", "localhost"].includes(origin.hostname)) {
118 process.exitCode = 1;
119 return;
120 }
121 process.kill(pid, 0);
122 process.stdout.write(`${pid} ${port}`);
123 } catch {
124 process.exitCode = 1;
125 }
126 }),
127 ),
128);
129​
130const updateRemaining = Command.make("update-remaining", {
131 markerFile: Argument.String("marker-file"),
132}).pipe(
133 Command.withHandler(({ markerFile }) =>
134 DesktopUpdateMarker.DesktopUpdateMarker.use((marker) => marker.remainingWait(markerFile)).pipe(
135 Effect.flatMap((remaining) =>
136 Effect.sync(() => {
137 process.stdout.write(Option.match(remaining, { onNone: () => "", onSome: String }));
138 }),
139 ),
140 ),
141 ),
142 Command.provide(DesktopUpdateMarker.layer),
143);
144​
145export const sshHelperCommand = Command.make("__ssh-helper").pipe(
146 Command.unlisted,
147 Command.withSubcommands([pickPort, waitReady, runtimePort, updateRemaining]),
148);