@zukhruf/ssh 0.0.0-stage → 0.8.30

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,8 @@
1
+ /** Go's `net.SplitHostPort` for a `host:port` address. The brackets of an IPv6 host are removed. */
2
+ export declare function splitHostPort(address: string): {
3
+ host: string;
4
+ port: number;
5
+ };
6
+ /** Go's `net.JoinHostPort`: an IPv6 host gets brackets. */
7
+ export declare function joinHostPort(host: string, port: number): string;
8
+ //# sourceMappingURL=address.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAQ7E;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/D"}
@@ -0,0 +1,15 @@
1
+ /** Go's `net.SplitHostPort` for a `host:port` address. The brackets of an IPv6 host are removed. */
2
+ export function splitHostPort(address) {
3
+ const colon = address.lastIndexOf(':');
4
+ const port = Number(address.slice(colon + 1));
5
+ if (colon < 0 || !Number.isInteger(port) || port < 0 || port > 65_535) {
6
+ throw new TypeError(`ssh: the address ${address} is not host:port`);
7
+ }
8
+ const host = address.slice(0, colon).replace(/^\[(.*)\]$/, '$1');
9
+ return { host, port };
10
+ }
11
+ /** Go's `net.JoinHostPort`: an IPv6 host gets brackets. */
12
+ export function joinHostPort(host, port) {
13
+ return host.includes(':') ? `[${host}]:${port}` : `${host}:${port}`;
14
+ }
15
+ //# sourceMappingURL=address.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CAAC,oBAAoB,OAAO,mBAAmB,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACjE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IACrD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AACtE,CAAC"}
@@ -0,0 +1,35 @@
1
+ import type { Duplex } from 'node:stream';
2
+ import { type PrivateKey, type Signer } from './private-key.ts';
3
+ import { PublicKey } from './public-key.ts';
4
+ export interface AgentKey {
5
+ readonly key: PublicKey;
6
+ readonly comment: string;
7
+ }
8
+ /** A client of an agent over a socket that the caller connected. Go's agent.NewClient. draft-ietf-sshm-ssh-agent. */
9
+ export declare class AgentClient {
10
+ #private;
11
+ constructor(socket: Duplex);
12
+ /** The keys of the agent, in its order. A key that the package cannot parse, such as a certificate, is left out. Go's List. */
13
+ list(): Promise<AgentKey[]>;
14
+ /** One signer for each key; each signature is a request to the agent. Go's Signers. */
15
+ signers(): Promise<Signer[]>;
16
+ /** The signature blob. Without `algorithm`, an RSA key signs with ssh-rsa. Go's SignWithFlags. */
17
+ sign(key: PublicKey, data: Uint8Array, options?: {
18
+ readonly algorithm?: 'rsa-sha2-256' | 'rsa-sha2-512';
19
+ }): Promise<Uint8Array>;
20
+ /** lifetime in ms, as ssh-add -t (rounded up to whole seconds); confirm, as ssh-add -c. Go's Add. */
21
+ add(key: PrivateKey, options?: {
22
+ readonly comment?: string;
23
+ readonly lifetime?: number;
24
+ readonly confirm?: boolean;
25
+ }): Promise<void>;
26
+ /** Go's Remove. */
27
+ remove(key: PublicKey): Promise<void>;
28
+ /** Go's RemoveAll. */
29
+ removeAll(): Promise<void>;
30
+ /** The agent lists no key and signs nothing until unlock with the same passphrase. Go's Lock. */
31
+ lock(passphrase: string): Promise<void>;
32
+ /** Go's Unlock. */
33
+ unlock(passphrase: string): Promise<void>;
34
+ }
35
+ //# sourceMappingURL=agent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,MAAM,EAAiB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAgFD,qHAAqH;AACrH,qBAAa,WAAW;;gBAMV,MAAM,EAAE,MAAM;IAS1B,+HAA+H;IACzH,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgBjC,uFAAuF;IACjF,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYlC,kGAAkG;IAC5F,IAAI,CACR,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,cAAc,CAAA;KAAO,GACrE,OAAO,CAAC,UAAU,CAAC;IAiBtB,qGAAqG;IAC/F,GAAG,CACP,GAAG,EAAE,UAAU,EACf,OAAO,GAAE;QACP,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;KACvB,GACL,OAAO,CAAC,IAAI,CAAC;IAwBhB,mBAAmB;IACb,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,sBAAsB;IAChB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAQhC,iGAAiG;IAC3F,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,mBAAmB;IACb,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmDhD"}
package/dist/agent.js ADDED
@@ -0,0 +1,288 @@
1
+ /** @zukhruf/ssh/agent: a client of an SSH agent. */
2
+ import { createPrivateKey } from 'node:crypto';
3
+ import { protocolKeyOf } from "./private-key.js";
4
+ import { PublicKey } from "./public-key.js";
5
+ // The message numbers of draft-ietf-sshm-ssh-agent §6.1.
6
+ const SSH_AGENT_FAILURE = 5;
7
+ const SSH_AGENT_SUCCESS = 6;
8
+ const SSH_AGENTC_REQUEST_IDENTITIES = 11;
9
+ const SSH_AGENT_IDENTITIES_ANSWER = 12;
10
+ const SSH_AGENTC_SIGN_REQUEST = 13;
11
+ const SSH_AGENT_SIGN_RESPONSE = 14;
12
+ const SSH_AGENTC_ADD_IDENTITY = 17;
13
+ const SSH_AGENTC_REMOVE_IDENTITY = 18;
14
+ const SSH_AGENTC_REMOVE_ALL_IDENTITIES = 19;
15
+ const SSH_AGENTC_LOCK = 22;
16
+ const SSH_AGENTC_UNLOCK = 23;
17
+ const SSH_AGENTC_ADD_ID_CONSTRAINED = 25;
18
+ const SSH_AGENT_CONSTRAIN_LIFETIME = 1;
19
+ const SSH_AGENT_CONSTRAIN_CONFIRM = 2;
20
+ const signatureFlags = {
21
+ 'rsa-sha2-256': 2,
22
+ 'rsa-sha2-512': 4,
23
+ };
24
+ // OpenSSH's AGENT_MAX_LEN (authfd.h).
25
+ const maxMessageLength = 256 * 1024;
26
+ // The agent answers the requests of one connection in their order, so the
27
+ // requests go out at once and each answer settles the oldest one.
28
+ class Open {
29
+ #socket;
30
+ #pending;
31
+ constructor(socket, pending) {
32
+ this.#socket = socket;
33
+ this.#pending = pending;
34
+ }
35
+ request(frame) {
36
+ const answered = Promise.withResolvers();
37
+ this.#pending.push(answered);
38
+ this.#socket.write(frame);
39
+ return answered.promise;
40
+ }
41
+ close(cause) {
42
+ const error = new Error('ssh: the connection to the agent closed', {
43
+ ...(cause && { cause }),
44
+ });
45
+ for (const pending of this.#pending.splice(0))
46
+ pending.reject(error);
47
+ return new Closed(error);
48
+ }
49
+ }
50
+ class Closed {
51
+ #error;
52
+ constructor(error) {
53
+ this.#error = error;
54
+ }
55
+ request() {
56
+ return Promise.reject(this.#error);
57
+ }
58
+ close() {
59
+ return this;
60
+ }
61
+ }
62
+ /** A client of an agent over a socket that the caller connected. Go's agent.NewClient. draft-ietf-sshm-ssh-agent. */
63
+ export class AgentClient {
64
+ #socket;
65
+ #pending = [];
66
+ #received = Buffer.alloc(0);
67
+ #phase;
68
+ constructor(socket) {
69
+ this.#socket = socket;
70
+ this.#phase = new Open(socket, this.#pending);
71
+ socket.on('data', (chunk) => this.#receive(chunk));
72
+ socket.on('error', (error) => this.#close(error));
73
+ socket.once('end', () => this.#close(undefined));
74
+ socket.once('close', () => this.#close(undefined));
75
+ }
76
+ /** The keys of the agent, in its order. A key that the package cannot parse, such as a certificate, is left out. Go's List. */
77
+ async list() {
78
+ const answer = await this.#request(SSH_AGENTC_REQUEST_IDENTITIES, []);
79
+ const reader = new Reader(answer, 'the list of keys');
80
+ if (reader.byte() !== SSH_AGENT_IDENTITIES_ANSWER) {
81
+ throw new Error('ssh: the agent refused to list its keys');
82
+ }
83
+ const keys = [];
84
+ for (let count = reader.uint32(); count > 0; count--) {
85
+ const wire = reader.string();
86
+ const comment = reader.string().toString('utf8');
87
+ const key = parseOrUndefined(wire);
88
+ if (key !== undefined)
89
+ keys.push({ key, comment });
90
+ }
91
+ return keys;
92
+ }
93
+ /** One signer for each key; each signature is a request to the agent. Go's Signers. */
94
+ async signers() {
95
+ return (await this.list()).map(({ key }) => ({
96
+ publicKey: key,
97
+ sign: (data, algorithm) => this.sign(key, data, {
98
+ ...(algorithm === 'rsa-sha2-256' || algorithm === 'rsa-sha2-512'
99
+ ? { algorithm }
100
+ : {}),
101
+ }),
102
+ }));
103
+ }
104
+ /** The signature blob. Without `algorithm`, an RSA key signs with ssh-rsa. Go's SignWithFlags. */
105
+ async sign(key, data, options = {}) {
106
+ const flags = options.algorithm === undefined ? 0 : signatureFlags[options.algorithm];
107
+ const answer = await this.#request(SSH_AGENTC_SIGN_REQUEST, [
108
+ string(key.wire),
109
+ string(data),
110
+ uint32(flags ?? 0),
111
+ ]);
112
+ const reader = new Reader(answer, 'the signature');
113
+ if (reader.byte() !== SSH_AGENT_SIGN_RESPONSE) {
114
+ throw new Error(`ssh: the agent refused to sign with ${key.type} key`);
115
+ }
116
+ const signature = new Reader(reader.string(), 'the signature');
117
+ signature.string();
118
+ return new Uint8Array(signature.string());
119
+ }
120
+ /** lifetime in ms, as ssh-add -t (rounded up to whole seconds); confirm, as ssh-add -c. Go's Add. */
121
+ async add(key, options = {}) {
122
+ const constraints = [];
123
+ if (options.lifetime !== undefined) {
124
+ constraints.push(byte(SSH_AGENT_CONSTRAIN_LIFETIME), uint32(Math.ceil(options.lifetime / 1000)));
125
+ }
126
+ if (options.confirm === true) {
127
+ constraints.push(byte(SSH_AGENT_CONSTRAIN_CONFIRM));
128
+ }
129
+ await this.#expectSuccess(constraints.length === 0
130
+ ? SSH_AGENTC_ADD_IDENTITY
131
+ : SSH_AGENTC_ADD_ID_CONSTRAINED, [
132
+ ...privateKeyFields(key),
133
+ string(Buffer.from(options.comment ?? '', 'utf8')),
134
+ ...constraints,
135
+ ], `add the ${key.publicKey.type} key`);
136
+ }
137
+ /** Go's Remove. */
138
+ async remove(key) {
139
+ await this.#expectSuccess(SSH_AGENTC_REMOVE_IDENTITY, [string(key.wire)], `remove the ${key.type} key ${key.fingerprint()}`);
140
+ }
141
+ /** Go's RemoveAll. */
142
+ async removeAll() {
143
+ await this.#expectSuccess(SSH_AGENTC_REMOVE_ALL_IDENTITIES, [], 'remove its keys');
144
+ }
145
+ /** The agent lists no key and signs nothing until unlock with the same passphrase. Go's Lock. */
146
+ async lock(passphrase) {
147
+ await this.#expectSuccess(SSH_AGENTC_LOCK, [string(Buffer.from(passphrase, 'utf8'))], 'lock');
148
+ }
149
+ /** Go's Unlock. */
150
+ async unlock(passphrase) {
151
+ await this.#expectSuccess(SSH_AGENTC_UNLOCK, [string(Buffer.from(passphrase, 'utf8'))], 'unlock');
152
+ }
153
+ async #expectSuccess(type, fields, action) {
154
+ const answer = await this.#request(type, fields);
155
+ if (answer[0] === SSH_AGENT_SUCCESS)
156
+ return;
157
+ const reason = answer[0] === SSH_AGENT_FAILURE ? '' : ` (${answer[0]})`;
158
+ throw new Error(`ssh: the agent refused to ${action}${reason}`);
159
+ }
160
+ #request(type, fields) {
161
+ const body = Buffer.concat([byte(type), ...fields]);
162
+ return this.#phase.request(Buffer.concat([uint32(body.length), body]));
163
+ }
164
+ #receive(chunk) {
165
+ this.#received = Buffer.concat([this.#received, chunk]);
166
+ while (this.#received.length >= 4) {
167
+ const length = this.#received.readUInt32BE(0);
168
+ if (length === 0 || length > maxMessageLength) {
169
+ this.#socket.destroy(new Error(`ssh: the agent sent a message of ${length} bytes`));
170
+ return;
171
+ }
172
+ if (this.#received.length < 4 + length)
173
+ return;
174
+ const message = this.#received.subarray(4, 4 + length);
175
+ this.#received = this.#received.subarray(4 + length);
176
+ const pending = this.#pending.shift();
177
+ if (pending === undefined) {
178
+ this.#socket.destroy(new Error('ssh: the agent sent an unasked answer'));
179
+ return;
180
+ }
181
+ pending.resolve(message);
182
+ }
183
+ }
184
+ #close(cause) {
185
+ this.#phase = this.#phase.close(cause);
186
+ }
187
+ }
188
+ function parseOrUndefined(wire) {
189
+ try {
190
+ return PublicKey.parse(wire);
191
+ }
192
+ catch {
193
+ return undefined;
194
+ }
195
+ }
196
+ // The key fields of SSH_AGENTC_ADD_IDENTITY, draft-ietf-sshm-ssh-agent §4.2.
197
+ function privateKeyFields(key) {
198
+ const type = key.publicKey.type;
199
+ const jwk = createPrivateKey(protocolKeyOf(key).getPrivatePEM()).export({
200
+ format: 'jwk',
201
+ });
202
+ const field = (name) => {
203
+ const value = jwk[name];
204
+ if (value === undefined) {
205
+ throw new Error(`ssh: the ${type} key has no ${name}`);
206
+ }
207
+ return Buffer.from(value, 'base64url');
208
+ };
209
+ switch (type) {
210
+ case 'ssh-ed25519': {
211
+ const publicPart = field('x');
212
+ return [
213
+ string(Buffer.from(type)),
214
+ string(publicPart),
215
+ string(Buffer.concat([field('d'), publicPart])),
216
+ ];
217
+ }
218
+ case 'ssh-rsa':
219
+ return [
220
+ string(Buffer.from(type)),
221
+ mpint(field('n')),
222
+ mpint(field('e')),
223
+ mpint(field('d')),
224
+ mpint(field('qi')),
225
+ mpint(field('p')),
226
+ mpint(field('q')),
227
+ ];
228
+ case 'ecdsa-sha2-nistp256':
229
+ case 'ecdsa-sha2-nistp384':
230
+ case 'ecdsa-sha2-nistp521':
231
+ return [
232
+ string(Buffer.from(type)),
233
+ string(Buffer.from(type.slice('ecdsa-sha2-'.length))),
234
+ string(Buffer.concat([Buffer.of(4), field('x'), field('y')])),
235
+ mpint(field('d')),
236
+ ];
237
+ default:
238
+ throw new Error(`ssh: the agent client cannot add a ${type} key`);
239
+ }
240
+ }
241
+ function byte(value) {
242
+ return Buffer.of(value);
243
+ }
244
+ function uint32(value) {
245
+ const buffer = Buffer.alloc(4);
246
+ buffer.writeUInt32BE(value);
247
+ return buffer;
248
+ }
249
+ function string(value) {
250
+ return Buffer.concat([uint32(value.length), value]);
251
+ }
252
+ // RFC 4251 §5: an unsigned big-endian value, with no leading zero byte unless
253
+ // the high bit is set.
254
+ function mpint(unsigned) {
255
+ let start = 0;
256
+ while (start < unsigned.length && unsigned[start] === 0)
257
+ start++;
258
+ const value = unsigned.subarray(start);
259
+ const high = value.length > 0 && (value[0] ?? 0) & 0x80;
260
+ return string(high ? Buffer.concat([Buffer.of(0), value]) : value);
261
+ }
262
+ class Reader {
263
+ #buffer;
264
+ #what;
265
+ #offset = 0;
266
+ constructor(buffer, what) {
267
+ this.#buffer = buffer;
268
+ this.#what = what;
269
+ }
270
+ byte() {
271
+ return this.#take(1).readUInt8(0);
272
+ }
273
+ uint32() {
274
+ return this.#take(4).readUInt32BE(0);
275
+ }
276
+ string() {
277
+ return this.#take(this.uint32());
278
+ }
279
+ #take(length) {
280
+ if (this.#offset + length > this.#buffer.length) {
281
+ throw new Error(`ssh: the agent sent a short message for ${this.#what}`);
282
+ }
283
+ const value = this.#buffer.subarray(this.#offset, this.#offset + length);
284
+ this.#offset += length;
285
+ return value;
286
+ }
287
+ }
288
+ //# sourceMappingURL=agent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAgC,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO5C,yDAAyD;AACzD,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,6BAA6B,GAAG,EAAE,CAAC;AACzC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AACvC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AACtC,MAAM,gCAAgC,GAAG,EAAE,CAAC;AAC5C,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,6BAA6B,GAAG,EAAE,CAAC;AACzC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AACvC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAEtC,MAAM,cAAc,GAAqC;IACvD,cAAc,EAAE,CAAC;IACjB,cAAc,EAAE,CAAC;CAClB,CAAC;AAEF,sCAAsC;AACtC,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC;AAapC,0EAA0E;AAC1E,kEAAkE;AAClE,MAAM,IAAI;IACC,OAAO,CAAS;IAChB,QAAQ,CAAY;IAE7B,YAAY,MAAc,EAAE,OAAkB;QAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,KAAa;QACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAU,CAAC;QACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,KAAwB;QAC5B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,yCAAyC,EAAE;YACjE,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;SACxB,CAAC,CAAC;QACH,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,MAAM;IACD,MAAM,CAAQ;IAEvB,YAAY,KAAY;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,OAAO;QACL,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,qHAAqH;AACrH,MAAM,OAAO,WAAW;IACb,OAAO,CAAS;IAChB,QAAQ,GAAc,EAAE,CAAC;IAClC,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,CAAQ;IAEd,YAAY,MAAc;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,+HAA+H;IAC/H,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,2BAA2B,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,IAAI,GAAe,EAAE,CAAC;QAC5B,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjD,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,GAAG,KAAK,SAAS;gBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3C,SAAS,EAAE,GAAG;YACd,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CACxB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;gBACnB,GAAG,CAAC,SAAS,KAAK,cAAc,IAAI,SAAS,KAAK,cAAc;oBAC9D,CAAC,CAAC,EAAE,SAAS,EAAE;oBACf,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;SACL,CAAC,CAAC,CAAC;IACN,CAAC;IAED,kGAAkG;IAClG,KAAK,CAAC,IAAI,CACR,GAAc,EACd,IAAgB,EAChB,UAAoE,EAAE;QAEtE,MAAM,KAAK,GACT,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,uBAAuB,EAAE;YAC1D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC;YACZ,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;SACnB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,uBAAuB,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;QAC/D,SAAS,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,qGAAqG;IACrG,KAAK,CAAC,GAAG,CACP,GAAe,EACf,UAII,EAAE;QAEN,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,WAAW,CAAC,IAAI,CACd,IAAI,CAAC,4BAA4B,CAAC,EAClC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC7B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,IAAI,CAAC,cAAc,CACvB,WAAW,CAAC,MAAM,KAAK,CAAC;YACtB,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,6BAA6B,EACjC;YACE,GAAG,gBAAgB,CAAC,GAAG,CAAC;YACxB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YAClD,GAAG,WAAW;SACf,EACD,WAAW,GAAG,CAAC,SAAS,CAAC,IAAI,MAAM,CACpC,CAAC;IACJ,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,MAAM,CAAC,GAAc;QACzB,MAAM,IAAI,CAAC,cAAc,CACvB,0BAA0B,EAC1B,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAClB,cAAc,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,WAAW,EAAE,EAAE,CAClD,CAAC;IACJ,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,cAAc,CACvB,gCAAgC,EAChC,EAAE,EACF,iBAAiB,CAClB,CAAC;IACJ,CAAC;IAED,iGAAiG;IACjG,KAAK,CAAC,IAAI,CAAC,UAAkB;QAC3B,MAAM,IAAI,CAAC,cAAc,CACvB,eAAe,EACf,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EACzC,MAAM,CACP,CAAC;IACJ,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,MAAM,CAAC,UAAkB;QAC7B,MAAM,IAAI,CAAC,cAAc,CACvB,iBAAiB,EACjB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EACzC,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,IAAY,EACZ,MAAyB,EACzB,MAAc;QAEd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,iBAAiB;YAAE,OAAO;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,MAAyB;QAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,GAAG,gBAAgB,EAAE,CAAC;gBAC9C,IAAI,CAAC,OAAO,CAAC,OAAO,CAClB,IAAI,KAAK,CAAC,oCAAoC,MAAM,QAAQ,CAAC,CAC9D,CAAC;gBACF,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM;gBAAE,OAAO;YAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;YACvD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,CAClB,IAAI,KAAK,CAAC,uCAAuC,CAAC,CACnD,CAAC;gBACF,OAAO;YACT,CAAC;YACD,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAAwB;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,SAAS,gBAAgB,CAAC,GAAe;IACvC,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;IAChC,MAAM,GAAG,GAAG,gBAAgB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC;QACtE,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,CAAC,IAAoD,EAAE,EAAE;QACrE,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,eAAe,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACzC,CAAC,CAAC;IACF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,OAAO;gBACL,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzB,MAAM,CAAC,UAAU,CAAC;gBAClB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;aAChD,CAAC;QACJ,CAAC;QACD,KAAK,SAAS;YACZ,OAAO;gBACL,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACjB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACjB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACjB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACjB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;aAClB,CAAC;QACJ,KAAK,qBAAqB,CAAC;QAC3B,KAAK,qBAAqB,CAAC;QAC3B,KAAK,qBAAqB;YACxB,OAAO;gBACL,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;gBACrD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC7D,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;aAClB,CAAC;QACJ;YACE,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,MAAM,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,IAAI,CAAC,KAAa;IACzB,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,KAAiB;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,SAAS,KAAK,CAAC,QAAgB;IAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,CAAC;IACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACxD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,MAAM;IACD,OAAO,CAAS;IAChB,KAAK,CAAS;IACvB,OAAO,GAAG,CAAC,CAAC;IAEZ,YAAY,MAAc,EAAE,IAAY;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAc;QAClB,IAAI,IAAI,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}
@@ -0,0 +1,16 @@
1
+ import { Duplex } from 'node:stream';
2
+ type Channel = Duplex & {
3
+ close(): void;
4
+ };
5
+ type Callback = (error?: Error | null) => void;
6
+ export declare class ChannelStream extends Duplex {
7
+ #private;
8
+ /** `lost` gives the error that ended the connection, when it ended the channel. */
9
+ constructor(channel: Channel, lost: () => Error | undefined);
10
+ _read(): void;
11
+ _write(chunk: Buffer, _encoding: BufferEncoding, callback: Callback): void;
12
+ _final(callback: Callback): void;
13
+ _destroy(error: Error | null, callback: Callback): void;
14
+ }
15
+ export {};
16
+ //# sourceMappingURL=channel-stream.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel-stream.d.ts","sourceRoot":"","sources":["../src/channel-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,KAAK,OAAO,GAAG,MAAM,GAAG;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC;AAE1C,KAAK,QAAQ,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;AA8C/C,qBAAa,aAAc,SAAQ,MAAM;;IAKvC,mFAAmF;gBACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,SAAS;IAsClD,KAAK,IAAI,IAAI;IAIb,MAAM,CACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,cAAc,EACzB,QAAQ,EAAE,QAAQ,GACjB,IAAI;IAIE,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKhC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAIjE"}
@@ -0,0 +1,102 @@
1
+ import { Duplex } from 'node:stream';
2
+ // ssh2 1.17.0 keeps the callback of a write that waits for window
3
+ // (Channel.js:186-194) and calls it only at a window adjust
4
+ // (client.js:625-637), so on the close of the channel nothing calls it: the
5
+ // write stays in `waiting` until the stream fails it.
6
+ function openPhase(channel, waiting) {
7
+ return {
8
+ write(chunk, callback) {
9
+ waiting.add(callback);
10
+ // At CHANNEL_CLOSE, ssh2 ends the channel before it emits close
11
+ // (onCHANNEL_CLOSE in utils.js). A write after that end fails and
12
+ // destroys the channel, so the check comes first: the write waits for
13
+ // the close.
14
+ if (channel.writableEnded)
15
+ return;
16
+ channel.write(chunk, (error) => {
17
+ if (waiting.delete(callback))
18
+ callback(error);
19
+ });
20
+ },
21
+ end: () => channel.end(),
22
+ close: () => channel.close(),
23
+ };
24
+ }
25
+ // The server or the connection closed the channel: ssh2 sends nothing more on
26
+ // it. A write waits in `waiting` for the stream to fail it.
27
+ function closedPhase(waiting) {
28
+ return {
29
+ write: (_chunk, callback) => void waiting.add(callback),
30
+ end() { },
31
+ close() { },
32
+ };
33
+ }
34
+ // A channel of ssh2 as a Duplex with the semantics of node:stream. ssh2
35
+ // 1.17.0's Channel replaces destroy() with end() and close(), emits no error
36
+ // and never sets `destroyed` (Channel.js:212), and its _write drops the
37
+ // callback of a write on a closed channel (Channel.js:160), so a write would
38
+ // wait forever.
39
+ export class ChannelStream extends Duplex {
40
+ #channel;
41
+ #waiting = new Set();
42
+ #phase;
43
+ /** `lost` gives the error that ended the connection, when it ended the channel. */
44
+ constructor(channel, lost) {
45
+ super({ allowHalfOpen: true });
46
+ this.#channel = channel;
47
+ this.#phase = openPhase(channel, this.#waiting);
48
+ channel.on('data', (chunk) => {
49
+ if (!this.push(chunk))
50
+ channel.pause();
51
+ });
52
+ // ssh2 emits the close of the connection before it ends and closes its
53
+ // channels (client.js:813-829), so `lost` is known in both listeners.
54
+ const destroyIfLost = () => {
55
+ const cause = lost();
56
+ if (cause === undefined)
57
+ return false;
58
+ this.#phase = closedPhase(this.#waiting);
59
+ this.destroy(new Error('ssh: the connection was lost', { cause }));
60
+ return true;
61
+ };
62
+ channel.once('end', () => {
63
+ if (!destroyIfLost())
64
+ this.push(null);
65
+ });
66
+ channel.once('close', () => {
67
+ if (destroyIfLost())
68
+ return;
69
+ this.#phase = closedPhase(this.#waiting);
70
+ this.push(null);
71
+ // A write that fails destroys the stream, which drops what is left to
72
+ // read, so a write fails as a write to a closed socket does only at the
73
+ // end of the data.
74
+ const close = () => {
75
+ for (const callback of this.#waiting) {
76
+ this.#waiting.delete(callback);
77
+ callback(new Error('ssh: the channel is closed'));
78
+ }
79
+ this.destroy();
80
+ };
81
+ if (this.readableEnded)
82
+ close();
83
+ else
84
+ this.once('end', close);
85
+ });
86
+ }
87
+ _read() {
88
+ this.#channel.resume();
89
+ }
90
+ _write(chunk, _encoding, callback) {
91
+ this.#phase.write(chunk, callback);
92
+ }
93
+ _final(callback) {
94
+ this.#phase.end();
95
+ callback();
96
+ }
97
+ _destroy(error, callback) {
98
+ this.#phase.close();
99
+ callback(error);
100
+ }
101
+ }
102
+ //# sourceMappingURL=channel-stream.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"channel-stream.js","sourceRoot":"","sources":["../src/channel-stream.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,114 @@
1
+ import type { Duplex } from 'node:stream';
2
+ import { type Clock } from '@zukhruf/async';
3
+ import type { Signer } from './private-key.ts';
4
+ import type { Prompt } from './prompt.ts';
5
+ import { PublicKey } from './public-key.ts';
6
+ import { type RemoteListener } from './remote-listener.ts';
7
+ import { Session } from './session.ts';
8
+ /** Go's ssh.ClientConfig. */
9
+ export interface ClientConfig {
10
+ readonly user: string;
11
+ /** Tried in order. Go's ClientConfig.Auth. */
12
+ readonly auth: readonly AuthMethod[];
13
+ /** Throws to refuse the key. Required: no default trusts a key. Go's HostKeyCallback. */
14
+ readonly hostKey: HostKeyCallback;
15
+ /** The host key algorithms to offer, in order. Default: each one that the package supports. Go's HostKeyAlgorithms. */
16
+ readonly hostKeyAlgorithms?: readonly string[];
17
+ readonly clock: Clock;
18
+ /** OpenSSH's ConnectTimeout, in ms: the TCP connect, the banner exchange and the key exchange. Default: no limit. */
19
+ readonly connectTimeout?: number;
20
+ /** OpenSSH's ServerAliveInterval (ms) and ServerAliveCountMax. Default: no keepalive. */
21
+ readonly keepalive?: {
22
+ readonly interval: number;
23
+ readonly countMax: number;
24
+ };
25
+ /** When set, every session asks for agent forwarding (auth-agent-req@openssh.com) before its command, as OpenSSH's ForwardAgent yes, and each auth-agent@openssh.com channel gets a new connection from this function. In the root import path, because the protocol library takes the agent when it connects. Go's agent.ForwardToRemote with agent.RequestAgentForwarding. */
26
+ readonly agentForwarding?: () => Promise<Duplex>;
27
+ /** The env requests that each new session sends before its first other request, with no reply wanted. OpenSshConfig#dial fills it from SetEnv, and from the variables of the caller's environment that SendEnv names. OpenSSH's SetEnv and SendEnv. */
28
+ readonly sessionEnv?: Readonly<Record<string, string>>;
29
+ }
30
+ export type HostKeyCallback = (hostname: string, port: number, key: PublicKey) => void | Promise<void>;
31
+ /** Go's ssh.AuthMethod: PublicKeysCallback, Password, KeyboardInteractive. */
32
+ export type AuthMethod = {
33
+ readonly type: 'publickey';
34
+ readonly signers: () => Promise<readonly Signer[]>;
35
+ } | {
36
+ readonly type: 'password';
37
+ readonly password: string;
38
+ } | {
39
+ readonly type: 'keyboard-interactive';
40
+ readonly respond: (prompts: readonly Prompt[]) => Promise<readonly string[]>;
41
+ };
42
+ export declare class AuthenticationError extends Error {
43
+ readonly attempted: readonly string[];
44
+ readonly allowed: readonly string[];
45
+ constructor(attempted: readonly string[], allowed: readonly string[]);
46
+ }
47
+ /** The reason of the server for a channel open that it refused (RFC 4254 §5.1). A code outside the four of the RFC is the number. Go's RejectionReason. */
48
+ export type RejectionReason = 'administratively-prohibited' | 'connect-failed' | 'unknown-channel-type' | 'resource-shortage' | number;
49
+ /** The server refused to open the channel (SSH_MSG_CHANNEL_OPEN_FAILURE). Go's OpenChannelError. */
50
+ export declare class OpenChannelError extends Error {
51
+ readonly reason: RejectionReason;
52
+ /** The text of the server, such as sshd's "open failed". Go's Message. */
53
+ readonly description: string;
54
+ /** `code` is the reason code of the message. */
55
+ constructor(code: number, description: string);
56
+ }
57
+ /** What keeps the Node process alive until it is unref'd: a socket, a child process, a timer, a client. */
58
+ interface Handle {
59
+ ref(): void;
60
+ unref(): void;
61
+ }
62
+ /**
63
+ * OpenSSH's restricted mode after a changed or revoked host key under
64
+ * StrictHostKeyChecking no (ADR 0005): listen rejects with `error`, and no
65
+ * later session asks for agent forwarding. OpenSshConfig#dial calls it before
66
+ * it returns the client. Not exported from the package.
67
+ */
68
+ export declare function restrictClient(client: Client, error: Error): void;
69
+ /** Closes `owned`, a jump host's client, after `client` closes or its connection ends (ADR 0006), and refs and unrefs it with `client`. Not exported from the package. */
70
+ export declare function closeWithClient(client: Client, owned: Client): void;
71
+ /** Refs and unrefs `transport`, which `client` runs on and the package opened, such as the transport of a ProxyCommand, with `client`. Not exported from the package. */
72
+ export declare function ownTransport(client: Client, transport: Handle): void;
73
+ /** One SSH connection and its channels. Go's ssh.Client. */
74
+ export declare class Client implements AsyncDisposable {
75
+ #private;
76
+ readonly user: string;
77
+ /** The version line of the server, such as SSH-2.0-OpenSSH_10.3. Go's ServerVersion. */
78
+ readonly serverVersion: string;
79
+ private constructor();
80
+ /** Opens a TCP connection to `address` (host:port) with node:net, and runs the handshake on it. Go's ssh.Dial. */
81
+ static dial(address: string, config: ClientConfig, options?: {
82
+ readonly family?: 4 | 6;
83
+ readonly signal?: AbortSignal;
84
+ }): Promise<Client>;
85
+ /** Runs the handshake on a stream that the caller opened: a channel of a jump host, the pipes of a ProxyCommand. The stream stays the caller's: ref() and unref() leave it as it is. Go's ssh.NewClientConn with ssh.NewClient. */
86
+ static handshake(transport: Duplex, address: string, config: ClientConfig, options?: {
87
+ readonly signal?: AbortSignal;
88
+ }): Promise<Client>;
89
+ /** A session. Its channel opens at start(), run(), output(), combinedOutput() or shell(). Go's Client.NewSession. */
90
+ newSession(): Session;
91
+ /** 'tcp': a direct-tcpip channel to host:port. 'unix': a direct-streamlocal@openssh.com channel to a socket path. Go's Client.Dial. */
92
+ dial(network: 'tcp' | 'unix', address: string, options?: {
93
+ readonly signal?: AbortSignal;
94
+ }): Promise<Duplex>;
95
+ /** tcpip-forward. Each connection comes to connectionListener with its origin, host:port of the peer. Go's Client.Listen. */
96
+ listen(network: 'tcp', address: string, connectionListener: (stream: Duplex, origin: string) => void, options?: {
97
+ readonly signal?: AbortSignal;
98
+ }): Promise<RemoteListener>;
99
+ /** streamlocal-forward@openssh.com. A forwarded-streamlocal@openssh.com channel carries no origin. Go's Client.ListenUnix. */
100
+ listen(network: 'unix', path: string, connectionListener: (stream: Duplex) => void, options?: {
101
+ readonly signal?: AbortSignal;
102
+ }): Promise<RemoteListener>;
103
+ /** Lets the Node process exit while the client holds it alone: the socket of Client.dial, the ProxyCommand of OpenSshConfig#dial, the keepalive timer, and the client of each jump host before it stop keeping it alive. A new client is ref'd. Node's ClientHttp2Session#unref. */
104
+ unref(): void;
105
+ /** Undoes unref(): the client keeps the Node process alive again. Node's ClientHttp2Session#ref. */
106
+ ref(): void;
107
+ /** Resolves after close(). Rejects with the error that ended the connection. Go's Conn.Wait. */
108
+ wait(): Promise<void>;
109
+ /** Sends SSH_MSG_DISCONNECT and closes the transport, then the client of each jump host before it. A later call waits for the same close. */
110
+ close(): Promise<void>;
111
+ [Symbol.asyncDispose](): Promise<void>;
112
+ }
113
+ export {};
114
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}