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