@yume-chan/adb 0.0.17 → 0.0.19

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 (177) hide show
  1. package/CHANGELOG.json +27 -0
  2. package/CHANGELOG.md +16 -1
  3. package/LICENSE +1 -1
  4. package/esm/adb.d.ts +63 -60
  5. package/esm/adb.d.ts.map +1 -1
  6. package/esm/adb.js +257 -229
  7. package/esm/adb.js.map +1 -1
  8. package/esm/auth.d.ts +51 -51
  9. package/esm/auth.d.ts.map +1 -1
  10. package/esm/auth.js +95 -96
  11. package/esm/auth.js.map +1 -1
  12. package/esm/backend.d.ts +8 -8
  13. package/esm/backend.d.ts.map +1 -1
  14. package/esm/backend.js +1 -1
  15. package/esm/commands/base.d.ts +6 -6
  16. package/esm/commands/base.js +8 -8
  17. package/esm/commands/framebuffer.d.ts +53 -53
  18. package/esm/commands/framebuffer.d.ts.map +1 -1
  19. package/esm/commands/framebuffer.js +46 -47
  20. package/esm/commands/framebuffer.js.map +1 -1
  21. package/esm/commands/index.d.ts +7 -8
  22. package/esm/commands/index.d.ts.map +1 -1
  23. package/esm/commands/index.js +7 -8
  24. package/esm/commands/index.js.map +1 -1
  25. package/esm/commands/install.d.ts +9 -3
  26. package/esm/commands/install.d.ts.map +1 -1
  27. package/esm/commands/install.js +27 -21
  28. package/esm/commands/install.js.map +1 -1
  29. package/esm/commands/power.d.ts +22 -22
  30. package/esm/commands/power.d.ts.map +1 -1
  31. package/esm/commands/power.js +48 -44
  32. package/esm/commands/power.js.map +1 -1
  33. package/esm/commands/reverse.d.ts +41 -28
  34. package/esm/commands/reverse.d.ts.map +1 -1
  35. package/esm/commands/reverse.js +125 -98
  36. package/esm/commands/reverse.js.map +1 -1
  37. package/esm/commands/subprocess/command.d.ts +57 -51
  38. package/esm/commands/subprocess/command.d.ts.map +1 -1
  39. package/esm/commands/subprocess/command.js +86 -82
  40. package/esm/commands/subprocess/command.js.map +1 -1
  41. package/esm/commands/subprocess/index.d.ts +3 -3
  42. package/esm/commands/subprocess/index.js +3 -3
  43. package/esm/commands/subprocess/protocols/index.d.ts +3 -3
  44. package/esm/commands/subprocess/protocols/index.js +3 -3
  45. package/esm/commands/subprocess/protocols/none.d.ts +35 -35
  46. package/esm/commands/subprocess/protocols/none.d.ts.map +1 -1
  47. package/esm/commands/subprocess/protocols/none.js +65 -55
  48. package/esm/commands/subprocess/protocols/none.js.map +1 -1
  49. package/esm/commands/subprocess/protocols/shell.d.ts +39 -38
  50. package/esm/commands/subprocess/protocols/shell.d.ts.map +1 -1
  51. package/esm/commands/subprocess/protocols/shell.js +166 -154
  52. package/esm/commands/subprocess/protocols/shell.js.map +1 -1
  53. package/esm/commands/subprocess/protocols/types.d.ts +49 -49
  54. package/esm/commands/subprocess/protocols/types.d.ts.map +1 -1
  55. package/esm/commands/subprocess/protocols/types.js +1 -1
  56. package/esm/commands/subprocess/utils.d.ts +1 -1
  57. package/esm/commands/subprocess/utils.js +18 -18
  58. package/esm/commands/sync/index.d.ts +8 -7
  59. package/esm/commands/sync/index.d.ts.map +1 -1
  60. package/esm/commands/sync/index.js +8 -7
  61. package/esm/commands/sync/index.js.map +1 -1
  62. package/esm/commands/sync/list.d.ts +42 -40
  63. package/esm/commands/sync/list.d.ts.map +1 -1
  64. package/esm/commands/sync/list.js +67 -35
  65. package/esm/commands/sync/list.js.map +1 -1
  66. package/esm/commands/sync/pull.d.ts +13 -11
  67. package/esm/commands/sync/pull.d.ts.map +1 -1
  68. package/esm/commands/sync/pull.js +35 -36
  69. package/esm/commands/sync/pull.js.map +1 -1
  70. package/esm/commands/sync/push.d.ts +46 -7
  71. package/esm/commands/sync/push.d.ts.map +1 -1
  72. package/esm/commands/sync/push.js +89 -23
  73. package/esm/commands/sync/push.js.map +1 -1
  74. package/esm/commands/sync/request.d.ts +26 -23
  75. package/esm/commands/sync/request.d.ts.map +1 -1
  76. package/esm/commands/sync/request.js +40 -42
  77. package/esm/commands/sync/request.js.map +1 -1
  78. package/esm/commands/sync/response.d.ts +19 -19
  79. package/esm/commands/sync/response.d.ts.map +1 -1
  80. package/esm/commands/sync/response.js +54 -54
  81. package/esm/commands/sync/response.js.map +1 -1
  82. package/esm/commands/sync/socket.d.ts +27 -0
  83. package/esm/commands/sync/socket.d.ts.map +1 -0
  84. package/esm/commands/sync/socket.js +66 -0
  85. package/esm/commands/sync/socket.js.map +1 -0
  86. package/esm/commands/sync/stat.d.ts +72 -72
  87. package/esm/commands/sync/stat.d.ts.map +1 -1
  88. package/esm/commands/sync/stat.js +116 -94
  89. package/esm/commands/sync/stat.js.map +1 -1
  90. package/esm/commands/sync/sync.d.ts +72 -60
  91. package/esm/commands/sync/sync.d.ts.map +1 -1
  92. package/esm/commands/sync/sync.js +127 -148
  93. package/esm/commands/sync/sync.js.map +1 -1
  94. package/esm/commands/tcpip.d.ts +5 -5
  95. package/esm/commands/tcpip.js +18 -18
  96. package/esm/crypto.d.ts +36 -36
  97. package/esm/crypto.d.ts.map +1 -1
  98. package/esm/crypto.js +248 -238
  99. package/esm/crypto.js.map +1 -1
  100. package/esm/features.d.ts +10 -7
  101. package/esm/features.d.ts.map +1 -1
  102. package/esm/features.js +13 -10
  103. package/esm/features.js.map +1 -1
  104. package/esm/index.d.ts +9 -9
  105. package/esm/index.d.ts.map +1 -1
  106. package/esm/index.js +9 -9
  107. package/esm/index.js.map +1 -1
  108. package/esm/packet.d.ts +45 -46
  109. package/esm/packet.d.ts.map +1 -1
  110. package/esm/packet.js +43 -46
  111. package/esm/packet.js.map +1 -1
  112. package/esm/socket/dispatcher.d.ts +59 -59
  113. package/esm/socket/dispatcher.d.ts.map +1 -1
  114. package/esm/socket/dispatcher.js +223 -231
  115. package/esm/socket/dispatcher.js.map +1 -1
  116. package/esm/socket/index.d.ts +2 -2
  117. package/esm/socket/index.js +2 -2
  118. package/esm/socket/socket.d.ts +59 -59
  119. package/esm/socket/socket.d.ts.map +1 -1
  120. package/esm/socket/socket.js +118 -98
  121. package/esm/socket/socket.js.map +1 -1
  122. package/esm/utils/auto-reset-event.d.ts +9 -9
  123. package/esm/utils/auto-reset-event.d.ts.map +1 -1
  124. package/esm/utils/auto-reset-event.js +33 -33
  125. package/esm/utils/auto-reset-event.js.map +1 -1
  126. package/esm/utils/base64.d.ts +27 -27
  127. package/esm/utils/base64.d.ts.map +1 -1
  128. package/esm/utils/base64.js +246 -245
  129. package/esm/utils/base64.js.map +1 -1
  130. package/esm/utils/conditional-variable.d.ts +9 -0
  131. package/esm/utils/conditional-variable.d.ts.map +1 -0
  132. package/esm/utils/conditional-variable.js +34 -0
  133. package/esm/utils/conditional-variable.js.map +1 -0
  134. package/esm/utils/index.d.ts +4 -3
  135. package/esm/utils/index.d.ts.map +1 -1
  136. package/esm/utils/index.js +4 -3
  137. package/esm/utils/index.js.map +1 -1
  138. package/package.json +17 -13
  139. package/src/adb.ts +160 -101
  140. package/src/auth.ts +31 -22
  141. package/src/backend.ts +6 -4
  142. package/src/commands/base.ts +2 -2
  143. package/src/commands/framebuffer.ts +37 -41
  144. package/src/commands/index.ts +7 -8
  145. package/src/commands/power.ts +15 -11
  146. package/src/commands/reverse.ts +74 -30
  147. package/src/commands/subprocess/command.ts +34 -23
  148. package/src/commands/subprocess/index.ts +3 -3
  149. package/src/commands/subprocess/protocols/index.ts +3 -3
  150. package/src/commands/subprocess/protocols/none.ts +26 -11
  151. package/src/commands/subprocess/protocols/shell.ts +110 -56
  152. package/src/commands/subprocess/protocols/types.ts +10 -6
  153. package/src/commands/subprocess/utils.ts +1 -1
  154. package/src/commands/sync/index.ts +8 -7
  155. package/src/commands/sync/list.ts +74 -28
  156. package/src/commands/sync/pull.ts +49 -37
  157. package/src/commands/sync/push.ts +153 -32
  158. package/src/commands/sync/request.ts +37 -34
  159. package/src/commands/sync/response.ts +34 -27
  160. package/src/commands/sync/socket.ts +97 -0
  161. package/src/commands/sync/stat.ts +98 -70
  162. package/src/commands/sync/sync.ts +78 -97
  163. package/src/commands/tcpip.ts +5 -5
  164. package/src/crypto.ts +60 -32
  165. package/src/features.ts +9 -6
  166. package/src/index.ts +9 -10
  167. package/src/packet.ts +41 -46
  168. package/src/socket/dispatcher.ts +130 -108
  169. package/src/socket/index.ts +2 -2
  170. package/src/socket/socket.ts +84 -34
  171. package/src/utils/auto-reset-event.ts +16 -17
  172. package/src/utils/base64.ts +51 -41
  173. package/src/utils/conditional-variable.ts +45 -0
  174. package/src/utils/index.ts +4 -3
  175. package/tsconfig.build.json +1 -1
  176. package/tsconfig.build.tsbuildinfo +1 -1
  177. package/src/commands/install.ts +0 -32
package/esm/adb.js CHANGED
@@ -1,230 +1,258 @@
1
- // cspell: ignore libusb
2
- import { PromiseResolver } from '@yume-chan/async';
3
- import { AbortController, DecodeUtf8Stream, GatherStringStream, WritableStream } from '@yume-chan/stream-extra';
4
- import { AdbAuthenticationProcessor, ADB_DEFAULT_AUTHENTICATORS } from './auth.js';
5
- import { AdbPower, AdbReverseCommand, AdbSubprocess, AdbSync, AdbTcpIpCommand, escapeArg, framebuffer, install } from './commands/index.js';
6
- import { AdbFeatures } from './features.js';
7
- import { AdbCommand, calculateChecksum } from './packet.js';
8
- import { AdbPacketDispatcher } from './socket/index.js';
9
- import { decodeUtf8, encodeUtf8 } from './utils/index.js';
10
- export var AdbPropKey;
11
- (function (AdbPropKey) {
12
- AdbPropKey["Product"] = "ro.product.name";
13
- AdbPropKey["Model"] = "ro.product.model";
14
- AdbPropKey["Device"] = "ro.product.device";
15
- AdbPropKey["Features"] = "features";
16
- })(AdbPropKey = AdbPropKey || (AdbPropKey = {}));
17
- export const VERSION_OMIT_CHECKSUM = 0x01000001;
18
- export class Adb {
19
- /**
20
- * It's possible to call `authenticate` multiple times on a single connection,
21
- * every time the device receives a `CNXN` packet, it resets its internal state,
22
- * and starts a new authentication process.
23
- */
24
- static async authenticate(connection, credentialStore, authenticators = ADB_DEFAULT_AUTHENTICATORS) {
25
- // Initially, set to highest-supported version and payload size.
26
- let version = 0x01000001;
27
- let maxPayloadSize = 0x100000;
28
- const resolver = new PromiseResolver();
29
- const authProcessor = new AdbAuthenticationProcessor(authenticators, credentialStore);
30
- // Here is similar to `AdbPacketDispatcher`,
31
- // But the received packet types and send packet processing are different.
32
- const abortController = new AbortController();
33
- const pipe = connection.readable
34
- .pipeTo(new WritableStream({
35
- async write(packet) {
36
- switch (packet.command) {
37
- case AdbCommand.Connect:
38
- version = Math.min(version, packet.arg0);
39
- maxPayloadSize = Math.min(maxPayloadSize, packet.arg1);
40
- resolver.resolve(decodeUtf8(packet.payload));
41
- break;
42
- case AdbCommand.Auth:
43
- const response = await authProcessor.process(packet);
44
- await sendPacket(response);
45
- break;
46
- default:
47
- // Maybe the previous ADB client exited without reading all packets,
48
- // so they are still waiting in OS internal buffer.
49
- // Just ignore them.
50
- // Because a `Connect` packet will reset the device,
51
- // Eventually there will be `Connect` and `Auth` response packets.
52
- break;
53
- }
54
- }
55
- }), {
56
- // Don't cancel the source ReadableStream on AbortSignal abort.
57
- preventCancel: true,
58
- signal: abortController.signal,
59
- })
60
- .catch((e) => {
61
- resolver.reject(e);
62
- });
63
- const writer = connection.writable.getWriter();
64
- async function sendPacket(init) {
65
- // Always send checksum in auth steps
66
- // Because we don't know if the device needs it or not.
67
- await writer.write(calculateChecksum(init));
68
- }
69
- let banner;
70
- try {
71
- // https://android.googlesource.com/platform/packages/modules/adb/+/79010dc6d5ca7490c493df800d4421730f5466ca/transport.cpp#1252
72
- // There are some other feature constants, but some of them are only used by ADB server, not devices (daemons).
73
- const features = [
74
- AdbFeatures.ShellV2,
75
- AdbFeatures.Cmd,
76
- AdbFeatures.StatV2,
77
- AdbFeatures.ListV2,
78
- AdbFeatures.FixedPushMkdir,
79
- 'apex',
80
- 'abb',
81
- // only tells the client the symlink timestamp issue in `adb push --sync` has been fixed.
82
- // No special handling required.
83
- 'fixed_push_symlink_timestamp',
84
- 'abb_exec',
85
- 'remount_shell',
86
- 'track_app',
87
- 'sendrecv_v2',
88
- 'sendrecv_v2_brotli',
89
- 'sendrecv_v2_lz4',
90
- 'sendrecv_v2_zstd',
91
- 'sendrecv_v2_dry_run_send',
92
- ].join(',');
93
- await sendPacket({
94
- command: AdbCommand.Connect,
95
- arg0: version,
96
- arg1: maxPayloadSize,
97
- // The terminating `;` is required in formal definition
98
- // But ADB daemon (all versions) can still work without it
99
- payload: encodeUtf8(`host::features=${features};`),
100
- });
101
- banner = await resolver.promise;
102
- }
103
- finally {
104
- // When failed, release locks on `connection` so the caller can try again.
105
- // When success, also release locks so `AdbPacketDispatcher` can use them.
106
- abortController.abort();
107
- writer.releaseLock();
108
- // Wait until pipe stops (`ReadableStream` lock released)
109
- await pipe;
110
- }
111
- return new Adb(connection, version, maxPayloadSize, banner);
112
- }
113
- dispatcher;
114
- get disconnected() { return this.dispatcher.disconnected; }
115
- _protocolVersion;
116
- get protocolVersion() { return this._protocolVersion; }
117
- _product;
118
- get product() { return this._product; }
119
- _model;
120
- get model() { return this._model; }
121
- _device;
122
- get device() { return this._device; }
123
- _features = [];
124
- get features() { return this._features; }
125
- subprocess;
126
- power;
127
- reverse;
128
- tcpip;
129
- constructor(connection, version, maxPayloadSize, banner) {
130
- this.parseBanner(banner);
131
- let calculateChecksum;
132
- let appendNullToServiceString;
133
- if (version >= VERSION_OMIT_CHECKSUM) {
134
- calculateChecksum = false;
135
- appendNullToServiceString = false;
136
- }
137
- else {
138
- calculateChecksum = true;
139
- appendNullToServiceString = true;
140
- }
141
- this.dispatcher = new AdbPacketDispatcher(connection, {
142
- calculateChecksum,
143
- appendNullToServiceString,
144
- maxPayloadSize,
145
- });
146
- this._protocolVersion = version;
147
- this.subprocess = new AdbSubprocess(this);
148
- this.power = new AdbPower(this);
149
- this.reverse = new AdbReverseCommand(this);
150
- this.tcpip = new AdbTcpIpCommand(this);
151
- }
152
- parseBanner(banner) {
153
- const pieces = banner.split('::');
154
- if (pieces.length > 1) {
155
- const props = pieces[1];
156
- for (const prop of props.split(';')) {
157
- if (!prop) {
158
- continue;
159
- }
160
- const keyValue = prop.split('=');
161
- if (keyValue.length !== 2) {
162
- continue;
163
- }
164
- const [key, value] = keyValue;
165
- switch (key) {
166
- case AdbPropKey.Product:
167
- this._product = value;
168
- break;
169
- case AdbPropKey.Model:
170
- this._model = value;
171
- break;
172
- case AdbPropKey.Device:
173
- this._device = value;
174
- break;
175
- case AdbPropKey.Features:
176
- this._features = value.split(',');
177
- break;
178
- }
179
- }
180
- }
181
- }
182
- /**
183
- * Add a handler for incoming socket.
184
- * @param handler A function to call with new incoming sockets. It must return `true` if it accepts the socket.
185
- * @returns A function to remove the handler.
186
- */
187
- onIncomingSocket(handler) {
188
- return this.dispatcher.onIncomingSocket(handler);
189
- }
190
- async createSocket(service) {
191
- return this.dispatcher.createSocket(service);
192
- }
193
- async createSocketAndWait(service) {
194
- const socket = await this.createSocket(service);
195
- const gatherStream = new GatherStringStream();
196
- await socket.readable
197
- .pipeThrough(new DecodeUtf8Stream())
198
- .pipeTo(gatherStream);
199
- return gatherStream.result;
200
- }
201
- async getProp(key) {
202
- const stdout = await this.subprocess.spawnAndWaitLegacy(['getprop', key]);
203
- return stdout.trim();
204
- }
205
- async rm(...filenames) {
206
- const stdout = await this.subprocess.spawnAndWaitLegacy(['rm', '-rf', ...filenames.map(arg => escapeArg(arg))]);
207
- return stdout;
208
- }
209
- install() {
210
- return install(this);
211
- }
212
- async sync() {
213
- const socket = await this.createSocket('sync:');
214
- return new AdbSync(this, socket);
215
- }
216
- async framebuffer() {
217
- return framebuffer(this);
218
- }
219
- /**
220
- * Close the ADB connection.
221
- *
222
- * Note that it won't close the streams from backends.
223
- * The streams are both physically and logically intact,
224
- * and can be reused.
225
- */
226
- async close() {
227
- await this.dispatcher.close();
228
- }
229
- }
1
+ import { PromiseResolver } from "@yume-chan/async";
2
+ import { AbortController, ConsumableWritableStream, DecodeUtf8Stream, GatherStringStream, WritableStream, } from "@yume-chan/stream-extra";
3
+ import { ADB_DEFAULT_AUTHENTICATORS, AdbAuthenticationProcessor, } from "./auth.js";
4
+ import { AdbPower, AdbReverseCommand, AdbSubprocess, AdbSync, AdbTcpIpCommand, escapeArg, framebuffer, } from "./commands/index.js";
5
+ import { AdbFeature } from "./features.js";
6
+ import { AdbCommand, calculateChecksum } from "./packet.js";
7
+ import { AdbPacketDispatcher } from "./socket/index.js";
8
+ import { decodeUtf8, encodeUtf8 } from "./utils/index.js";
9
+ export var AdbPropKey;
10
+ (function (AdbPropKey) {
11
+ AdbPropKey["Product"] = "ro.product.name";
12
+ AdbPropKey["Model"] = "ro.product.model";
13
+ AdbPropKey["Device"] = "ro.product.device";
14
+ AdbPropKey["Features"] = "features";
15
+ })(AdbPropKey = AdbPropKey || (AdbPropKey = {}));
16
+ export const VERSION_OMIT_CHECKSUM = 0x01000001;
17
+ export class Adb {
18
+ /**
19
+ * It's possible to call `authenticate` multiple times on a single connection,
20
+ * every time the device receives a `CNXN` packet, it resets its internal state,
21
+ * and starts a new authentication process.
22
+ */
23
+ static async authenticate(connection, credentialStore, authenticators = ADB_DEFAULT_AUTHENTICATORS) {
24
+ // Initially, set to highest-supported version and payload size.
25
+ let version = 0x01000001;
26
+ // Android 4: 4K, Android 7: 256K, Android 9: 1M
27
+ let maxPayloadSize = 1024 * 1024;
28
+ const resolver = new PromiseResolver();
29
+ const authProcessor = new AdbAuthenticationProcessor(authenticators, credentialStore);
30
+ // Here is similar to `AdbPacketDispatcher`,
31
+ // But the received packet types and send packet processing are different.
32
+ const abortController = new AbortController();
33
+ const pipe = connection.readable
34
+ .pipeTo(new WritableStream({
35
+ async write(packet) {
36
+ switch (packet.command) {
37
+ case AdbCommand.Connect:
38
+ version = Math.min(version, packet.arg0);
39
+ maxPayloadSize = Math.min(maxPayloadSize, packet.arg1);
40
+ resolver.resolve(decodeUtf8(packet.payload));
41
+ break;
42
+ case AdbCommand.Auth: {
43
+ const response = await authProcessor.process(packet);
44
+ await sendPacket(response);
45
+ break;
46
+ }
47
+ default:
48
+ // Maybe the previous ADB client exited without reading all packets,
49
+ // so they are still waiting in OS internal buffer.
50
+ // Just ignore them.
51
+ // Because a `Connect` packet will reset the device,
52
+ // Eventually there will be `Connect` and `Auth` response packets.
53
+ break;
54
+ }
55
+ },
56
+ }), {
57
+ // Don't cancel the source ReadableStream on AbortSignal abort.
58
+ preventCancel: true,
59
+ signal: abortController.signal,
60
+ })
61
+ .catch((e) => {
62
+ resolver.reject(e);
63
+ });
64
+ const writer = connection.writable.getWriter();
65
+ async function sendPacket(init) {
66
+ // Always send checksum in auth steps
67
+ // Because we don't know if the device needs it or not.
68
+ init.checksum = calculateChecksum(init.payload);
69
+ init.magic = init.command ^ 0xffffffff;
70
+ await ConsumableWritableStream.write(writer, init);
71
+ }
72
+ let banner;
73
+ try {
74
+ // https://android.googlesource.com/platform/packages/modules/adb/+/79010dc6d5ca7490c493df800d4421730f5466ca/transport.cpp#1252
75
+ // There are some other feature constants, but some of them are only used by ADB server, not devices (daemons).
76
+ const features = [
77
+ AdbFeature.ShellV2,
78
+ AdbFeature.Cmd,
79
+ AdbFeature.StatV2,
80
+ AdbFeature.ListV2,
81
+ AdbFeature.FixedPushMkdir,
82
+ "apex",
83
+ AdbFeature.Abb,
84
+ // only tells the client the symlink timestamp issue in `adb push --sync` has been fixed.
85
+ // No special handling required.
86
+ "fixed_push_symlink_timestamp",
87
+ AdbFeature.AbbExec,
88
+ "remount_shell",
89
+ "track_app",
90
+ "sendrecv_v2",
91
+ "sendrecv_v2_brotli",
92
+ "sendrecv_v2_lz4",
93
+ "sendrecv_v2_zstd",
94
+ "sendrecv_v2_dry_run_send",
95
+ ].join(",");
96
+ await sendPacket({
97
+ command: AdbCommand.Connect,
98
+ arg0: version,
99
+ arg1: maxPayloadSize,
100
+ // The terminating `;` is required in formal definition
101
+ // But ADB daemon (all versions) can still work without it
102
+ payload: encodeUtf8(`host::features=${features};`),
103
+ });
104
+ banner = await resolver.promise;
105
+ }
106
+ finally {
107
+ // When failed, release locks on `connection` so the caller can try again.
108
+ // When success, also release locks so `AdbPacketDispatcher` can use them.
109
+ abortController.abort();
110
+ writer.releaseLock();
111
+ // Wait until pipe stops (`ReadableStream` lock released)
112
+ await pipe;
113
+ }
114
+ return new Adb(connection, version, maxPayloadSize, banner);
115
+ }
116
+ dispatcher;
117
+ get disconnected() {
118
+ return this.dispatcher.disconnected;
119
+ }
120
+ _protocolVersion;
121
+ get protocolVersion() {
122
+ return this._protocolVersion;
123
+ }
124
+ _maxPayloadSize;
125
+ get maxPayloadSize() {
126
+ return this._maxPayloadSize;
127
+ }
128
+ _product;
129
+ get product() {
130
+ return this._product;
131
+ }
132
+ _model;
133
+ get model() {
134
+ return this._model;
135
+ }
136
+ _device;
137
+ get device() {
138
+ return this._device;
139
+ }
140
+ _features = [];
141
+ get features() {
142
+ return this._features;
143
+ }
144
+ subprocess;
145
+ power;
146
+ reverse;
147
+ tcpip;
148
+ constructor(connection, version, maxPayloadSize, banner) {
149
+ this.parseBanner(banner);
150
+ let calculateChecksum;
151
+ let appendNullToServiceString;
152
+ if (version >= VERSION_OMIT_CHECKSUM) {
153
+ calculateChecksum = false;
154
+ appendNullToServiceString = false;
155
+ }
156
+ else {
157
+ calculateChecksum = true;
158
+ appendNullToServiceString = true;
159
+ }
160
+ this.dispatcher = new AdbPacketDispatcher(connection, {
161
+ calculateChecksum,
162
+ appendNullToServiceString,
163
+ maxPayloadSize,
164
+ });
165
+ this._protocolVersion = version;
166
+ this._maxPayloadSize = maxPayloadSize;
167
+ this.subprocess = new AdbSubprocess(this);
168
+ this.power = new AdbPower(this);
169
+ this.reverse = new AdbReverseCommand(this);
170
+ this.tcpip = new AdbTcpIpCommand(this);
171
+ }
172
+ parseBanner(banner) {
173
+ const pieces = banner.split("::");
174
+ if (pieces.length > 1) {
175
+ const props = pieces[1];
176
+ for (const prop of props.split(";")) {
177
+ if (!prop) {
178
+ continue;
179
+ }
180
+ const keyValue = prop.split("=");
181
+ if (keyValue.length !== 2) {
182
+ continue;
183
+ }
184
+ const [key, value] = keyValue;
185
+ switch (key) {
186
+ case AdbPropKey.Product:
187
+ this._product = value;
188
+ break;
189
+ case AdbPropKey.Model:
190
+ this._model = value;
191
+ break;
192
+ case AdbPropKey.Device:
193
+ this._device = value;
194
+ break;
195
+ case AdbPropKey.Features:
196
+ this._features = value.split(",");
197
+ break;
198
+ }
199
+ }
200
+ }
201
+ }
202
+ supportsFeature(feature) {
203
+ return this._features.includes(feature);
204
+ }
205
+ /**
206
+ * Add a handler for incoming socket.
207
+ * @param handler A function to call with new incoming sockets. It must return `true` if it accepts the socket.
208
+ * @returns A function to remove the handler.
209
+ */
210
+ onIncomingSocket(handler) {
211
+ return this.dispatcher.onIncomingSocket(handler);
212
+ }
213
+ async createSocket(service) {
214
+ return this.dispatcher.createSocket(service);
215
+ }
216
+ async createSocketAndWait(service) {
217
+ const socket = await this.createSocket(service);
218
+ const gatherStream = new GatherStringStream();
219
+ await socket.readable
220
+ .pipeThrough(new DecodeUtf8Stream())
221
+ .pipeTo(gatherStream);
222
+ return gatherStream.result;
223
+ }
224
+ async getProp(key) {
225
+ const stdout = await this.subprocess.spawnAndWaitLegacy([
226
+ "getprop",
227
+ key,
228
+ ]);
229
+ return stdout.trim();
230
+ }
231
+ async rm(...filenames) {
232
+ // https://android.googlesource.com/platform/packages/modules/adb/+/1a0fb8846d4e6b671c8aa7f137a8c21d7b248716/client/adb_install.cpp#984
233
+ const stdout = await this.subprocess.spawnAndWaitLegacy([
234
+ "rm",
235
+ ...filenames.map((arg) => escapeArg(arg)),
236
+ "</dev/null",
237
+ ]);
238
+ return stdout;
239
+ }
240
+ async sync() {
241
+ const socket = await this.createSocket("sync:");
242
+ return new AdbSync(this, socket);
243
+ }
244
+ async framebuffer() {
245
+ return framebuffer(this);
246
+ }
247
+ /**
248
+ * Close the ADB connection.
249
+ *
250
+ * Note that it won't close the streams from backends.
251
+ * The streams are both physically and logically intact,
252
+ * and can be reused.
253
+ */
254
+ async close() {
255
+ await this.dispatcher.close();
256
+ }
257
+ }
230
258
  //# sourceMappingURL=adb.js.map
package/esm/adb.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"adb.js","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"adb.js","sourceRoot":"","sources":["../src/adb.ts"],"names":[],"mappings":"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"}
package/esm/auth.d.ts CHANGED
@@ -1,52 +1,52 @@
1
- import type { Disposable } from '@yume-chan/event';
2
- import type { ValueOrPromise } from '@yume-chan/struct';
3
- import { type AdbPacketData } from './packet.js';
4
- export declare type AdbKeyIterable = Iterable<Uint8Array> | AsyncIterable<Uint8Array>;
5
- export interface AdbCredentialStore {
6
- /**
7
- * Generate and store a RSA private key with modulus length `2048` and public exponent `65537`.
8
- *
9
- * The returned `Uint8Array` is the private key in PKCS #8 format.
10
- */
11
- generateKey(): ValueOrPromise<Uint8Array>;
12
- /**
13
- * Synchronously or asynchronously iterate through all stored RSA private keys.
14
- *
15
- * Each call to `iterateKeys` must return a different iterator that iterate through all stored keys.
16
- */
17
- iterateKeys(): AdbKeyIterable;
18
- }
19
- export declare enum AdbAuthType {
20
- Token = 1,
21
- Signature = 2,
22
- PublicKey = 3
23
- }
24
- export interface AdbAuthenticator {
25
- /**
26
- * @param getNextRequest
27
- *
28
- * Call this function to get the next authentication request packet from device.
29
- *
30
- * After calling `getNextRequest`, authenticator can `yield` a packet as response, or `return` to indicate its incapability of handling the request.
31
- *
32
- * After `return`, the `AdbAuthenticatorHandler` will move on to next authenticator and never go back.
33
- *
34
- * Calling `getNextRequest` multiple times without `yield` or `return` will always return the same request.
35
- */
36
- (credentialStore: AdbCredentialStore, getNextRequest: () => Promise<AdbPacketData>): AsyncIterable<AdbPacketData>;
37
- }
38
- export declare const AdbSignatureAuthenticator: AdbAuthenticator;
39
- export declare const AdbPublicKeyAuthenticator: AdbAuthenticator;
40
- export declare const ADB_DEFAULT_AUTHENTICATORS: AdbAuthenticator[];
41
- export declare class AdbAuthenticationProcessor implements Disposable {
42
- readonly authenticators: readonly AdbAuthenticator[];
43
- private readonly credentialStore;
44
- private pendingRequest;
45
- private iterator;
46
- constructor(authenticators: readonly AdbAuthenticator[], credentialStore: AdbCredentialStore);
47
- private getNextRequest;
48
- private invokeAuthenticator;
49
- process(packet: AdbPacketData): Promise<AdbPacketData>;
50
- dispose(): void;
51
- }
1
+ import type { Disposable } from "@yume-chan/event";
2
+ import type { ValueOrPromise } from "@yume-chan/struct";
3
+ import type { AdbPacketData } from "./packet.js";
4
+ export type AdbKeyIterable = Iterable<Uint8Array> | AsyncIterable<Uint8Array>;
5
+ export interface AdbCredentialStore {
6
+ /**
7
+ * Generate and store a RSA private key with modulus length `2048` and public exponent `65537`.
8
+ *
9
+ * The returned `Uint8Array` is the private key in PKCS #8 format.
10
+ */
11
+ generateKey(): ValueOrPromise<Uint8Array>;
12
+ /**
13
+ * Synchronously or asynchronously iterate through all stored RSA private keys.
14
+ *
15
+ * Each call to `iterateKeys` must return a different iterator that iterate through all stored keys.
16
+ */
17
+ iterateKeys(): AdbKeyIterable;
18
+ }
19
+ export declare enum AdbAuthType {
20
+ Token = 1,
21
+ Signature = 2,
22
+ PublicKey = 3
23
+ }
24
+ export interface AdbAuthenticator {
25
+ /**
26
+ * @param getNextRequest
27
+ *
28
+ * Call this function to get the next authentication request packet from device.
29
+ *
30
+ * After calling `getNextRequest`, authenticator can `yield` a packet as response, or `return` to indicate its incapability of handling the request.
31
+ *
32
+ * After `return`, the `AdbAuthenticatorHandler` will move on to next authenticator and never go back.
33
+ *
34
+ * Calling `getNextRequest` multiple times without `yield` or `return` will always return the same request.
35
+ */
36
+ (credentialStore: AdbCredentialStore, getNextRequest: () => Promise<AdbPacketData>): AsyncIterable<AdbPacketData>;
37
+ }
38
+ export declare const AdbSignatureAuthenticator: AdbAuthenticator;
39
+ export declare const AdbPublicKeyAuthenticator: AdbAuthenticator;
40
+ export declare const ADB_DEFAULT_AUTHENTICATORS: AdbAuthenticator[];
41
+ export declare class AdbAuthenticationProcessor implements Disposable {
42
+ readonly authenticators: readonly AdbAuthenticator[];
43
+ private readonly credentialStore;
44
+ private pendingRequest;
45
+ private iterator;
46
+ constructor(authenticators: readonly AdbAuthenticator[], credentialStore: AdbCredentialStore);
47
+ private getNextRequest;
48
+ private invokeAuthenticator;
49
+ process(packet: AdbPacketData): Promise<AdbPacketData>;
50
+ dispose(): void;
51
+ }
52
52
  //# sourceMappingURL=auth.d.ts.map