@zukhruf/ssh 0.0.0-stage → 0.8.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +1123 -2
  3. package/dist/address.d.ts +8 -0
  4. package/dist/address.d.ts.map +1 -0
  5. package/dist/address.js +15 -0
  6. package/dist/address.js.map +1 -0
  7. package/dist/agent.d.ts +35 -0
  8. package/dist/agent.d.ts.map +1 -0
  9. package/dist/agent.js +288 -0
  10. package/dist/agent.js.map +1 -0
  11. package/dist/channel-stream.d.ts +16 -0
  12. package/dist/channel-stream.d.ts.map +1 -0
  13. package/dist/channel-stream.js +102 -0
  14. package/dist/channel-stream.js.map +1 -0
  15. package/dist/client.d.ts +114 -0
  16. package/dist/client.d.ts.map +1 -0
  17. package/dist/client.js +587 -0
  18. package/dist/client.js.map +1 -0
  19. package/dist/config.d.ts +82 -0
  20. package/dist/config.d.ts.map +1 -0
  21. package/dist/config.js +255 -0
  22. package/dist/config.js.map +1 -0
  23. package/dist/control/control-client.d.ts +12 -0
  24. package/dist/control/control-client.d.ts.map +1 -0
  25. package/dist/control/control-client.js +156 -0
  26. package/dist/control/control-client.js.map +1 -0
  27. package/dist/control/control-master.d.ts +12 -0
  28. package/dist/control/control-master.d.ts.map +1 -0
  29. package/dist/control/control-master.js +101 -0
  30. package/dist/control/control-master.js.map +1 -0
  31. package/dist/control/control-stream.d.ts +29 -0
  32. package/dist/control/control-stream.d.ts.map +1 -0
  33. package/dist/control/control-stream.js +54 -0
  34. package/dist/control/control-stream.js.map +1 -0
  35. package/dist/control/messages.d.ts +38 -0
  36. package/dist/control/messages.d.ts.map +1 -0
  37. package/dist/control/messages.js +92 -0
  38. package/dist/control/messages.js.map +1 -0
  39. package/dist/control/serve-dial.d.ts +11 -0
  40. package/dist/control/serve-dial.d.ts.map +1 -0
  41. package/dist/control/serve-dial.js +47 -0
  42. package/dist/control/serve-dial.js.map +1 -0
  43. package/dist/control/serve-session.d.ts +11 -0
  44. package/dist/control/serve-session.d.ts.map +1 -0
  45. package/dist/control/serve-session.js +78 -0
  46. package/dist/control/serve-session.js.map +1 -0
  47. package/dist/control/wire.d.ts +41 -0
  48. package/dist/control/wire.d.ts.map +1 -0
  49. package/dist/control/wire.js +100 -0
  50. package/dist/control/wire.js.map +1 -0
  51. package/dist/control.d.ts +4 -0
  52. package/dist/control.d.ts.map +1 -0
  53. package/dist/control.js +4 -0
  54. package/dist/control.js.map +1 -0
  55. package/dist/dial-route.d.ts +14 -0
  56. package/dist/dial-route.d.ts.map +1 -0
  57. package/dist/dial-route.js +87 -0
  58. package/dist/dial-route.js.map +1 -0
  59. package/dist/host-key-algorithms.d.ts +7 -0
  60. package/dist/host-key-algorithms.d.ts.map +1 -0
  61. package/dist/host-key-algorithms.js +16 -0
  62. package/dist/host-key-algorithms.js.map +1 -0
  63. package/dist/host-key-policy.d.ts +22 -0
  64. package/dist/host-key-policy.d.ts.map +1 -0
  65. package/dist/host-key-policy.js +72 -0
  66. package/dist/host-key-policy.js.map +1 -0
  67. package/dist/identities.d.ts +18 -0
  68. package/dist/identities.d.ts.map +1 -0
  69. package/dist/identities.js +81 -0
  70. package/dist/identities.js.map +1 -0
  71. package/dist/index.d.ts +9 -0
  72. package/dist/index.d.ts.map +1 -0
  73. package/dist/index.js +8 -0
  74. package/dist/index.js.map +1 -0
  75. package/dist/knownhosts.d.ts +33 -0
  76. package/dist/knownhosts.d.ts.map +1 -0
  77. package/dist/knownhosts.js +241 -0
  78. package/dist/knownhosts.js.map +1 -0
  79. package/dist/match-pattern.d.ts +3 -0
  80. package/dist/match-pattern.d.ts.map +1 -0
  81. package/dist/match-pattern.js +18 -0
  82. package/dist/match-pattern.js.map +1 -0
  83. package/dist/private-key.d.ts +42 -0
  84. package/dist/private-key.d.ts.map +1 -0
  85. package/dist/private-key.js +100 -0
  86. package/dist/private-key.js.map +1 -0
  87. package/dist/prompt.d.ts +6 -0
  88. package/dist/prompt.d.ts.map +1 -0
  89. package/dist/prompt.js +2 -0
  90. package/dist/prompt.js.map +1 -0
  91. package/dist/proxy-command.d.ts +33 -0
  92. package/dist/proxy-command.d.ts.map +1 -0
  93. package/dist/proxy-command.js +121 -0
  94. package/dist/proxy-command.js.map +1 -0
  95. package/dist/proxy-jump.d.ts +19 -0
  96. package/dist/proxy-jump.d.ts.map +1 -0
  97. package/dist/proxy-jump.js +63 -0
  98. package/dist/proxy-jump.js.map +1 -0
  99. package/dist/public-key.d.ts +22 -0
  100. package/dist/public-key.d.ts.map +1 -0
  101. package/dist/public-key.js +102 -0
  102. package/dist/public-key.js.map +1 -0
  103. package/dist/remote-listener.d.ts +14 -0
  104. package/dist/remote-listener.d.ts.map +1 -0
  105. package/dist/remote-listener.js +39 -0
  106. package/dist/remote-listener.js.map +1 -0
  107. package/dist/server-alive-check.d.ts +36 -0
  108. package/dist/server-alive-check.d.ts.map +1 -0
  109. package/dist/server-alive-check.js +103 -0
  110. package/dist/server-alive-check.js.map +1 -0
  111. package/dist/server.d.ts +114 -0
  112. package/dist/server.d.ts.map +1 -0
  113. package/dist/server.js +460 -0
  114. package/dist/server.js.map +1 -0
  115. package/dist/session.d.ts +97 -0
  116. package/dist/session.d.ts.map +1 -0
  117. package/dist/session.js +193 -0
  118. package/dist/session.js.map +1 -0
  119. package/dist/ssh-g.d.ts +19 -0
  120. package/dist/ssh-g.d.ts.map +1 -0
  121. package/dist/ssh-g.js +67 -0
  122. package/dist/ssh-g.js.map +1 -0
  123. package/dist/ssh2-agent-forwarding.d.ts +51 -0
  124. package/dist/ssh2-agent-forwarding.d.ts.map +1 -0
  125. package/dist/ssh2-agent-forwarding.js +56 -0
  126. package/dist/ssh2-agent-forwarding.js.map +1 -0
  127. package/dist/ssh2-channel-open-failure.d.ts +28 -0
  128. package/dist/ssh2-channel-open-failure.d.ts.map +1 -0
  129. package/dist/ssh2-channel-open-failure.js +35 -0
  130. package/dist/ssh2-channel-open-failure.js.map +1 -0
  131. package/dist/ssh2-keepalive-request.d.ts +31 -0
  132. package/dist/ssh2-keepalive-request.d.ts.map +1 -0
  133. package/dist/ssh2-keepalive-request.js +6 -0
  134. package/dist/ssh2-keepalive-request.js.map +1 -0
  135. package/dist/ssh2-server-channel.d.ts +63 -0
  136. package/dist/ssh2-server-channel.d.ts.map +1 -0
  137. package/dist/ssh2-server-channel.js +309 -0
  138. package/dist/ssh2-server-channel.js.map +1 -0
  139. package/package.json +75 -4
@@ -0,0 +1,82 @@
1
+ import type { Clock } from '@zukhruf/async';
2
+ import type { Client } from './client.ts';
3
+ import { type Environment } from './ssh-g.ts';
4
+ export type { Environment } from './ssh-g.ts';
5
+ /** How dial reaches the host. OpenSSH uses one of the three: ProxyJump and ProxyCommand exclude each other. */
6
+ export type Route = {
7
+ readonly kind: 'direct';
8
+ }
9
+ /** ProxyCommand, with its tokens not yet expanded (ADR 0010). */
10
+ | {
11
+ readonly kind: 'proxy-command';
12
+ readonly command: string;
13
+ }
14
+ /** ProxyJump, in the order of the list. Only the first jump host has a route of its own (ADR 0006). */
15
+ | {
16
+ readonly kind: 'jump';
17
+ readonly jumpHosts: readonly [FirstJumpHost, ...JumpHost[]];
18
+ };
19
+ /** The resolved settings of a jump host, by its own ssh -G, with no route: OpenSSH reaches a jump host after the first through the one before it, and reads no ProxyJump or ProxyCommand of its config. A jump host opens no session, so it has no session env and no agent forwarding. */
20
+ export type JumpHost = Omit<OpenSshConfig, 'route' | 'setEnv' | 'sendEnv' | 'forwardAgent' | 'dial'>;
21
+ /** The first jump host: the one jump host that follows its own ProxyJump or ProxyCommand. */
22
+ export interface FirstJumpHost extends JumpHost {
23
+ readonly route: Route;
24
+ }
25
+ type ForwardAgent = {
26
+ readonly kind: 'off';
27
+ } | {
28
+ readonly kind: 'agent';
29
+ } | {
30
+ readonly kind: 'socket';
31
+ readonly path: string;
32
+ };
33
+ /** The settings of OpenSSH for one destination, as ssh -G prints them. */
34
+ export declare class OpenSshConfig {
35
+ #private;
36
+ readonly destination: string;
37
+ readonly hostname: string;
38
+ readonly port: number;
39
+ readonly user: string;
40
+ readonly hostKeyAlias: string | undefined;
41
+ readonly knownHostsFiles: {
42
+ readonly user: readonly string[];
43
+ readonly global: readonly string[];
44
+ };
45
+ /** ssh -G prints true, false, ask or accept-new: 'yes', 'no', 'ask', 'accept-new'. */
46
+ readonly strictHostKeyChecking: 'yes' | 'ask' | 'accept-new' | 'no';
47
+ readonly hashKnownHosts: boolean;
48
+ /** Without the algorithms that ssh2 does not have. */
49
+ readonly hostKeyAlgorithms: readonly string[];
50
+ /** The agent socket; undefined for IdentityAgent none, or no SSH_AUTH_SOCK. */
51
+ readonly identityAgent: string | undefined;
52
+ /** With ~ expanded from HOME of the environment. */
53
+ readonly identityFiles: readonly string[];
54
+ readonly identitiesOnly: boolean;
55
+ readonly route: Route;
56
+ /** ms; undefined for none. */
57
+ readonly connectTimeout: number | undefined;
58
+ /** undefined when ServerAliveInterval is 0. */
59
+ readonly keepalive: {
60
+ readonly interval: number;
61
+ readonly countMax: number;
62
+ } | undefined;
63
+ /** undefined for any. */
64
+ readonly addressFamily: 4 | 6 | undefined;
65
+ readonly setEnv: ReadonlyMap<string, string>;
66
+ readonly sendEnv: readonly string[];
67
+ /** ForwardAgent as OpenSSH resolves it: no, yes (the agent at SSH_AUTH_SOCK of the environment), or a socket path (a $NAME value is read from the environment). */
68
+ readonly forwardAgent: ForwardAgent;
69
+ private constructor();
70
+ /** Runs ssh -G <flags> -- <destination> with `environment`, and resolves each jump host of the route with its own ssh -G. */
71
+ static resolve(destination: string, options: {
72
+ readonly flags?: readonly string[];
73
+ readonly environment: Environment;
74
+ readonly signal?: AbortSignal;
75
+ }): Promise<OpenSshConfig>;
76
+ /** Connects by the route, checks the host key under the policy, authenticates with the agent, then the identity files, and sets sessionEnv from setEnv and sendEnv, and agentForwarding from forwardAgent. */
77
+ dial(options: {
78
+ readonly clock: Clock;
79
+ readonly signal?: AbortSignal;
80
+ }): Promise<Client>;
81
+ }
82
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
package/dist/config.js ADDED
@@ -0,0 +1,255 @@
1
+ /** @zukhruf/ssh/config: the settings of OpenSSH for a destination, through ssh -G. */
2
+ import { connect } from 'node:net';
3
+ import { dialHost } from "./dial-route.js";
4
+ import { ssh2HostKeyAlgorithms } from "./host-key-algorithms.js";
5
+ import { matchPattern } from "./match-pattern.js";
6
+ import { jumpHostFlags, parseProxyJump } from "./proxy-jump.js";
7
+ import { Settings } from "./ssh-g.js";
8
+ /** The settings of OpenSSH for one destination, as ssh -G prints them. */
9
+ export class OpenSshConfig {
10
+ destination;
11
+ hostname;
12
+ port;
13
+ user;
14
+ hostKeyAlias;
15
+ knownHostsFiles;
16
+ /** ssh -G prints true, false, ask or accept-new: 'yes', 'no', 'ask', 'accept-new'. */
17
+ strictHostKeyChecking;
18
+ hashKnownHosts;
19
+ /** Without the algorithms that ssh2 does not have. */
20
+ hostKeyAlgorithms;
21
+ /** The agent socket; undefined for IdentityAgent none, or no SSH_AUTH_SOCK. */
22
+ identityAgent;
23
+ /** With ~ expanded from HOME of the environment. */
24
+ identityFiles;
25
+ identitiesOnly;
26
+ route;
27
+ /** ms; undefined for none. */
28
+ connectTimeout;
29
+ /** undefined when ServerAliveInterval is 0. */
30
+ keepalive;
31
+ /** undefined for any. */
32
+ addressFamily;
33
+ setEnv;
34
+ sendEnv;
35
+ /** ForwardAgent as OpenSSH resolves it: no, yes (the agent at SSH_AUTH_SOCK of the environment), or a socket path (a $NAME value is read from the environment). */
36
+ forwardAgent;
37
+ #environment;
38
+ /** ProxyUseFdpass yes for a ProxyCommand on the route: dial fails (ADR 0010). */
39
+ #proxyUseFdpass;
40
+ constructor(host, route, settings, environment, proxyUseFdpass) {
41
+ this.destination = host.destination;
42
+ this.hostname = host.hostname;
43
+ this.port = host.port;
44
+ this.user = host.user;
45
+ this.hostKeyAlias = host.hostKeyAlias;
46
+ this.knownHostsFiles = host.knownHostsFiles;
47
+ this.strictHostKeyChecking = host.strictHostKeyChecking;
48
+ this.hashKnownHosts = host.hashKnownHosts;
49
+ this.hostKeyAlgorithms = host.hostKeyAlgorithms;
50
+ this.identityAgent = host.identityAgent;
51
+ this.identityFiles = host.identityFiles;
52
+ this.identitiesOnly = host.identitiesOnly;
53
+ this.route = route;
54
+ this.connectTimeout = host.connectTimeout;
55
+ this.keepalive = host.keepalive;
56
+ this.addressFamily = host.addressFamily;
57
+ this.setEnv = new Map(settings.getAll('setenv').map((each) => {
58
+ const equals = each.indexOf('=');
59
+ return [each.slice(0, equals), each.slice(equals + 1)];
60
+ }));
61
+ this.sendEnv = settings.getAll('sendenv');
62
+ this.forwardAgent = OpenSshConfig.#forwardAgent(settings.required('forwardagent'), environment);
63
+ this.#environment = environment;
64
+ this.#proxyUseFdpass = proxyUseFdpass;
65
+ }
66
+ /** Runs ssh -G <flags> -- <destination> with `environment`, and resolves each jump host of the route with its own ssh -G. */
67
+ static async resolve(destination, options) {
68
+ const { flags = [], environment, signal } = options;
69
+ const settings = await Settings.resolve(flags, destination, environment, signal);
70
+ const resolving = { flags, environment, signal, fdpass: [] };
71
+ const route = await resolveRoute(settings, resolving, []);
72
+ return new OpenSshConfig(readHost(destination, settings, environment), route, settings, environment, resolving.fdpass.length > 0);
73
+ }
74
+ /** Connects by the route, checks the host key under the policy, authenticates with the agent, then the identity files, and sets sessionEnv from setEnv and sendEnv, and agentForwarding from forwardAgent. */
75
+ async dial(options) {
76
+ if (this.#proxyUseFdpass) {
77
+ throw new Error('ssh: ProxyUseFdpass yes is not supported: node:net cannot receive the socket that the ProxyCommand passes back');
78
+ }
79
+ const agentForwarding = this.#agentForwarding();
80
+ return dialHost(this, this.route, {
81
+ sessionEnv: this.#sessionEnv(),
82
+ ...(agentForwarding && { agentForwarding }),
83
+ }, {
84
+ clock: options.clock,
85
+ signal: options.signal,
86
+ environment: this.#environment,
87
+ });
88
+ }
89
+ /** The variables of the environment that a SendEnv pattern names, then SetEnv, which wins for the same name: OpenSSH sends SetEnv after them (`client_session2_setup` in clientloop.c of OpenSSH 10.5p1). */
90
+ #sessionEnv() {
91
+ const env = {};
92
+ for (const [name, value] of Object.entries(this.#environment)) {
93
+ if (value !== undefined &&
94
+ this.sendEnv.some((pattern) => matchPattern(pattern, name))) {
95
+ env[name] = value;
96
+ }
97
+ }
98
+ for (const [name, value] of this.setEnv)
99
+ env[name] = value;
100
+ return env;
101
+ }
102
+ /** ForwardAgent yes with no SSH_AUTH_SOCK in the environment has no agent to forward. */
103
+ #agentForwarding() {
104
+ const path = this.#agentSocketPath();
105
+ if (path === undefined)
106
+ return undefined;
107
+ return async () => connect(path);
108
+ }
109
+ #agentSocketPath() {
110
+ const forwardAgent = this.forwardAgent;
111
+ switch (forwardAgent.kind) {
112
+ case 'socket':
113
+ return forwardAgent.path;
114
+ case 'agent':
115
+ return this.#environment['SSH_AUTH_SOCK'];
116
+ case 'off':
117
+ return undefined;
118
+ }
119
+ }
120
+ /** ssh.c of OpenSSH 10.5p1: a `$NAME` that the environment does not set turns forwarding off. */
121
+ static #forwardAgent(value, environment) {
122
+ if (value === 'no')
123
+ return { kind: 'off' };
124
+ if (value === 'yes')
125
+ return { kind: 'agent' };
126
+ if (!value.startsWith('$'))
127
+ return { kind: 'socket', path: value };
128
+ const path = environment[value.slice(1)];
129
+ return path === undefined ? { kind: 'off' } : { kind: 'socket', path };
130
+ }
131
+ }
132
+ /**
133
+ * The route of a host. Each jump host is resolved by its own ssh -G, with the
134
+ * flags that OpenSSH gives the ssh of a jump host. `chain` holds the jump
135
+ * hosts that the first jump hosts before this one were resolved for: one that
136
+ * comes back is a loop that never ends.
137
+ */
138
+ async function resolveRoute(settings, resolving, chain) {
139
+ const proxyJump = settings.get('proxyjump');
140
+ if (proxyJump !== undefined) {
141
+ const [first, ...later] = parseProxyJump(proxyJump);
142
+ if (first === undefined)
143
+ throw new Error('ssh -G printed no jump host');
144
+ const key = JSON.stringify(first);
145
+ if (chain.includes(key)) {
146
+ throw new Error(`jumphost loop via ${first.host}`);
147
+ }
148
+ const [firstJumpHost, ...laterJumpHosts] = await Promise.all([
149
+ resolveJumpHost(first, resolving).then(async ({ host, settings: firstSettings }) => ({
150
+ ...host,
151
+ route: await resolveRoute(firstSettings, resolving, [...chain, key]),
152
+ })),
153
+ ...later.map(async (hop) => (await resolveJumpHost(hop, resolving)).host),
154
+ ]);
155
+ return { kind: 'jump', jumpHosts: [firstJumpHost, ...laterJumpHosts] };
156
+ }
157
+ // ssh -G prints no proxycommand for ProxyCommand none (CLEAR_ON_NONE in
158
+ // fill_default_options of readconf.c, OpenSSH 9.6p1 and 10.5p1).
159
+ const command = settings.get('proxycommand');
160
+ if (command !== undefined) {
161
+ const route = { kind: 'proxy-command', command };
162
+ if (settings.get('proxyusefdpass') === 'yes')
163
+ resolving.fdpass.push(route);
164
+ return route;
165
+ }
166
+ return { kind: 'direct' };
167
+ }
168
+ /** A jump host by its own ssh -G; its settings stay for the route of the first one. */
169
+ async function resolveJumpHost(hop, resolving) {
170
+ const settings = await Settings.resolve(jumpHostFlags(hop, resolving.flags), hop.host, resolving.environment, resolving.signal);
171
+ return {
172
+ host: readHost(hop.host, settings, resolving.environment),
173
+ settings,
174
+ };
175
+ }
176
+ const strictHostKeyChecking = new Map([
177
+ ['true', 'yes'],
178
+ ['false', 'no'],
179
+ ['ask', 'ask'],
180
+ ['accept-new', 'accept-new'],
181
+ ]);
182
+ const addressFamily = new Map([
183
+ ['inet', 4],
184
+ ['inet6', 6],
185
+ ['any', undefined],
186
+ ]);
187
+ /** The settings of a host that a jump host has too. */
188
+ function readHost(destination, settings, environment) {
189
+ const offered = settings.required('hostkeyalgorithms').split(',');
190
+ const supported = ssh2HostKeyAlgorithms;
191
+ return {
192
+ destination,
193
+ hostname: settings.required('hostname'),
194
+ port: Number(settings.required('port')),
195
+ user: settings.required('user'),
196
+ hostKeyAlias: settings.get('hostkeyalias'),
197
+ knownHostsFiles: {
198
+ user: fileList(settings.required('userknownhostsfile')),
199
+ global: fileList(settings.required('globalknownhostsfile')).map((file) => expandTilde(file, environment)),
200
+ },
201
+ strictHostKeyChecking: known(strictHostKeyChecking, 'stricthostkeychecking', settings),
202
+ hashKnownHosts: settings.required('hashknownhosts') === 'yes',
203
+ hostKeyAlgorithms: offered.filter((name) => supported.includes(name)),
204
+ identityAgent: identityAgent(settings.get('identityagent'), environment),
205
+ identityFiles: settings
206
+ .getAll('identityfile')
207
+ .map((file) => expandTilde(file, environment)),
208
+ identitiesOnly: settings.required('identitiesonly') === 'yes',
209
+ connectTimeout: connectTimeout(settings.required('connecttimeout')),
210
+ keepalive: keepalive(Number(settings.required('serveraliveinterval')), Number(settings.required('serveralivecountmax'))),
211
+ addressFamily: known(addressFamily, 'addressfamily', settings),
212
+ };
213
+ }
214
+ /** A value of a setting that the package maps; a value that OpenSSH adds later fails, so the package never guesses its meaning. */
215
+ function known(values, key, settings) {
216
+ const value = settings.required(key);
217
+ for (const [name, mapped] of values) {
218
+ if (name === value)
219
+ return mapped;
220
+ }
221
+ throw new Error(`ssh -G printed ${key} ${value}, which is not known`);
222
+ }
223
+ /** UserKnownHostsFile and GlobalKnownHostsFile print their files on one line; `none` is no file. */
224
+ function fileList(value) {
225
+ return value === 'none' ? [] : value.split(' ');
226
+ }
227
+ /** ssh -G prints identityfile and globalknownhostsfile with the `~` that ssh expands only later. */
228
+ function expandTilde(file, environment) {
229
+ const home = environment['HOME'];
230
+ if (home === undefined || !file.startsWith('~/'))
231
+ return file;
232
+ return `${home}${file.slice(1)}`;
233
+ }
234
+ /** ssh_config(5), IdentityAgent; ssh.c of OpenSSH 10.5p1 reads a `$NAME` value from the environment. ssh -G has checked the name (`parse_agent_path` in readconf.c). */
235
+ function identityAgent(value, environment) {
236
+ if (value === undefined || value === 'SSH_AUTH_SOCK') {
237
+ return environment['SSH_AUTH_SOCK'];
238
+ }
239
+ if (value === 'none')
240
+ return undefined;
241
+ if (value.startsWith('$')) {
242
+ return environment[value.slice(1)];
243
+ }
244
+ return value;
245
+ }
246
+ /** ConnectTimeout in seconds; `none` and 0 set no limit (`timeout_connect` in OpenSSH's misc.c waits with no limit for 0). */
247
+ function connectTimeout(value) {
248
+ if (value === 'none' || value === '0')
249
+ return undefined;
250
+ return Number(value) * 1000;
251
+ }
252
+ function keepalive(interval, countMax) {
253
+ return interval === 0 ? undefined : { interval: interval * 1000, countMax };
254
+ }
255
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import { type Duplex } from 'node:stream';
2
+ import { type Session } from '../session.ts';
3
+ /** Opens channels through the master at `path`, one connection to the socket for each channel. */
4
+ export declare class ControlClient {
5
+ #private;
6
+ constructor(path: string);
7
+ /** As Client#dial. */
8
+ dial(network: 'tcp' | 'unix', address: string): Promise<Duplex>;
9
+ /** As Client#newSession. */
10
+ newSession(): Session;
11
+ }
12
+ //# sourceMappingURL=control-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"control-client.d.ts","sourceRoot":"","sources":["../../src/control/control-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAY,MAAM,aAAa,CAAC;AAEpD,OAAO,EACL,KAAK,OAAO,EAIb,MAAM,eAAe,CAAC;AAmBvB,kGAAkG;AAClG,qBAAa,aAAa;;gBAGZ,IAAI,EAAE,MAAM;IAIxB,sBAAsB;IAChB,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASrE,4BAA4B;IAC5B,UAAU,IAAI,OAAO;CAKtB"}
@@ -0,0 +1,156 @@
1
+ import { once } from 'node:events';
2
+ import { connect } from 'node:net';
3
+ import { Readable } from 'node:stream';
4
+ import { createSession, } from "../session.js";
5
+ import { ControlStream } from "./control-stream.js";
6
+ import { fromWire, isEnding, isReply, isWireError, } from "./messages.js";
7
+ import { FrameType, decodeJson, encode, encodeJson, readFirstFrame, readFrames, } from "./wire.js";
8
+ /** Opens channels through the master at `path`, one connection to the socket for each channel. */
9
+ export class ControlClient {
10
+ #path;
11
+ constructor(path) {
12
+ this.#path = path;
13
+ }
14
+ /** As Client#dial. */
15
+ async dial(network, address) {
16
+ const socket = await openChannel(this.#path, {
17
+ kind: 'dial',
18
+ network,
19
+ address,
20
+ });
21
+ return dialStream(socket);
22
+ }
23
+ /** As Client#newSession. */
24
+ newSession() {
25
+ return createSession(async (start) => sessionChannel(await openChannel(this.#path, { kind: 'session', start })));
26
+ }
27
+ }
28
+ function masterClosed() {
29
+ return new Error('ssh: the control master closed the connection');
30
+ }
31
+ function protocolError() {
32
+ return new Error('ssh: the control master broke the protocol');
33
+ }
34
+ /** Connects, sends the request, and resolves with the socket when the master opened the channel. */
35
+ async function openChannel(path, request) {
36
+ const socket = connect({ path });
37
+ await once(socket, 'connect');
38
+ // An error of the socket is followed by its close, which ends the channel.
39
+ socket.on('error', () => socket.destroy());
40
+ socket.write(encodeJson(FrameType.request, request));
41
+ try {
42
+ const frame = await readFirstFrame(socket, masterClosed());
43
+ const reply = decodeJson(frame);
44
+ if (frame.type !== FrameType.reply || !isReply(reply)) {
45
+ throw protocolError();
46
+ }
47
+ if (!reply.opened)
48
+ throw fromWire(reply.error);
49
+ return socket;
50
+ }
51
+ catch (error) {
52
+ socket.destroy();
53
+ throw error;
54
+ }
55
+ }
56
+ // The master sends an error frame when the channel failed. A close with no
57
+ // eof and no error is the death of the master.
58
+ function dialStream(socket) {
59
+ const stream = new ControlStream(socket, {
60
+ writeAfterClose: (callback) => callback(new Error('ssh: the channel is closed')),
61
+ destroyed: () => socket.destroy(),
62
+ });
63
+ let eof = false;
64
+ let failure;
65
+ readFrames(socket, (frame) => {
66
+ if (frame.type === FrameType.data) {
67
+ stream.receive(frame.payload);
68
+ return;
69
+ }
70
+ if (frame.type === FrameType.eof) {
71
+ eof = true;
72
+ stream.receiveEof();
73
+ return;
74
+ }
75
+ const error = decodeJson(frame);
76
+ failure =
77
+ frame.type === FrameType.error && isWireError(error)
78
+ ? fromWire(error)
79
+ : protocolError();
80
+ socket.destroy();
81
+ });
82
+ socket.once('close', () => {
83
+ stream.connectionClosed(failure ?? (eof ? undefined : masterClosed()));
84
+ });
85
+ return stream;
86
+ }
87
+ // The session's streams end at the eof frame, or at the close of the
88
+ // connection; the exit frame, or its absence, goes to onClose.
89
+ function sessionChannel(socket) {
90
+ // As ssh2 drops a write to a closed channel, a write to stdin after the end
91
+ // of the session is dropped.
92
+ const stream = new ControlStream(socket, {
93
+ writeAfterClose: (callback) => callback(),
94
+ destroyed: () => undefined,
95
+ });
96
+ const stderr = new Readable({ read: () => socket.resume() });
97
+ let eof = false;
98
+ let ending;
99
+ const receiveEof = () => {
100
+ eof = true;
101
+ stream.receiveEof();
102
+ stderr.push(null);
103
+ };
104
+ readFrames(socket, (frame) => {
105
+ switch (frame.type) {
106
+ case FrameType.data:
107
+ stream.receive(frame.payload);
108
+ return;
109
+ case FrameType.extendedData:
110
+ if (!stderr.push(frame.payload))
111
+ socket.pause();
112
+ return;
113
+ case FrameType.eof:
114
+ receiveEof();
115
+ return;
116
+ case FrameType.exit: {
117
+ const value = decodeJson(frame);
118
+ if (isEnding(value)) {
119
+ ending = value;
120
+ return;
121
+ }
122
+ }
123
+ }
124
+ socket.destroy();
125
+ });
126
+ const closed = new Promise((resolve) => {
127
+ socket.once('close', () => {
128
+ if (!eof)
129
+ receiveEof();
130
+ stream.connectionClosed(undefined);
131
+ resolve(ending);
132
+ });
133
+ });
134
+ const send = (frame) => {
135
+ if (!socket.destroyed && !socket.writableEnded)
136
+ socket.write(frame);
137
+ };
138
+ return {
139
+ stream,
140
+ stderr,
141
+ onClose: (listener) => {
142
+ void closed.then((end) => {
143
+ if (end === undefined)
144
+ listener(undefined, masterClosed());
145
+ else if (end.kind === 'exit')
146
+ listener(end.exit, undefined);
147
+ else
148
+ listener(undefined, end.cause && fromWire(end.cause));
149
+ });
150
+ },
151
+ windowChange: (size) => send(encodeJson(FrameType.windowChange, size)),
152
+ signal: (name) => send(encode(FrameType.signal, name)),
153
+ close: () => send(encode(FrameType.close)),
154
+ };
155
+ }
156
+ //# sourceMappingURL=control-client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"control-client.js","sourceRoot":"","sources":["../../src/control/control-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { Client } from '../client.ts';
2
+ /** Serves the channels of a client to other processes on a Unix socket. OpenSSH's ControlMaster and ControlPath. */
3
+ export declare class ControlMaster implements AsyncDisposable {
4
+ #private;
5
+ readonly path: string;
6
+ private constructor();
7
+ /** Listens on `path`. Disposal stops the listener and closes each channel that the master serves; it does not close `client`. */
8
+ static listen(client: Client, path: string): Promise<ControlMaster>;
9
+ /** node:net removes the socket file when the server closes. */
10
+ [Symbol.asyncDispose](): Promise<void>;
11
+ }
12
+ //# sourceMappingURL=control-master.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"control-master.d.ts","sourceRoot":"","sources":["../../src/control/control-master.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAY3C,oHAAoH;AACpH,qBAAa,aAAc,YAAW,eAAe;;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAItB,OAAO;IAMP,iIAAiI;WACpH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAYzE,+DAA+D;IACzD,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7C"}