@cldmv/droidsock 1.2.0 → 2.0.0

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.
package/README.md CHANGED
@@ -15,27 +15,30 @@ A complete, from-scratch implementation of the Android Debug Bridge (ADB) protoc
15
15
  >
16
16
  > - **Shell + streaming**: Stable - command execution, interactive shells, and log/process streaming all work over the real ADB protocol.
17
17
  > - **File transfer**: `mkdir` / `remove` / `move` / `copy` / `chmod` / `diskUsage` / `find` / `stat` work today via shell commands. `list` prefers a binary-safe SYNC-based implementation with automatic shell fallback.
18
- > - **Experimental**: `push` / `pull` / `listSync` (real ADB SYNC sub-protocol usage), `device.reboot()`, `device.forward()`, and `device.install()` are all implemented - built from the ADB protocol spec and covered by mocked unit tests - but **none of them have been run against a real device yet**. See [#1](https://github.com/CLDMV/droidsock/issues/1). Forwarding is host → device only; install is push-then-install only - see the [v1.1.0 changelog](./docs/changelog/v1/v1.1.0.md) for what's tracked separately.
18
+ > - **Experimental**: `push` / `pull` / `pushV2` / `pullV2` / `listSync` / `listV2` / `statV2` (real ADB SYNC sub-protocol usage, both the legacy 32-bit and newer 64-bit variants), `device.reboot()`, `device.forward()` / `device.reverse()`, `device.install()` (both the classic push-then-install and modern streaming install paths), and `pairing.pair()` (Wi-Fi pairing) are all implemented - built from the ADB protocol spec and covered by unit tests (several exercised against real loopback TCP/TLS servers, not purely mocks) - but **none of them have been run against a real device yet**. See [#1](https://github.com/CLDMV/droidsock/issues/1).
19
19
 
20
20
  ---
21
21
 
22
22
  ## ✨ What's New
23
23
 
24
- ### Latest: v1.2.0 (September 2026)
24
+ ### Latest: v2.0.0 (September 2026)
25
25
 
26
- - **Device discovery** - `discover.subnet()` sweeps a CIDR range for a reachable ADB TCP port; `discover.mdns()` is a hand-written mDNS client (no dependency) for wireless-debugging-advertised devices. Both **experimental** - see [#1](https://github.com/CLDMV/droidsock/issues/1).
27
- - **Shell-injection fix** - every `files.*` shell-based method now single-quote-escapes remote paths before interpolation; `mkdir`/`chmod`'s mode and `find`'s `maxDepth`/`type` are validated too.
28
- - [View full v1.2.0 Changelog](./docs/changelog/v1/v1.2.0.md)
26
+ - **🚨 Breaking**: the `device` module is now split into `device` (single-target `connect(host, port)` / `disconnect(host, port)` / `remove(host, port)`) and `devices` (collection-wide `list()` / `disconnect()` (all) / `remove()` (all) / `get(idOrLeaf)`) - connected devices are still mounted as composed API leaves at `api.devices.<host_port>`. A device leaf now persists across a disconnect - `disconnect()` only tears down the socket (and stays synchronous), `connect()` on the same host:port later reconnects that same leaf without re-supplying options, and `remove()` is the new, separate "forget this device" operation (the one that's actually `async`).
27
+ - **IPv6 support** - `device.connect()`, `discover.subnet()`, and `discover.mdns()` all accept IPv6 addresses/CIDRs now, not just IPv4.
28
+ - **`devices.get(idOrLeaf)`** (new) - looks up a connected device leaf by `"host:port"` string or by the leaf object itself; the safe way to re-resolve a leaf reference instead of holding onto a stale one.
29
+ - **`device.reverse()`** (experimental) - completes port forwarding with the device → host direction.
30
+ - **`pairing.pair()`** (experimental) - Wi-Fi pairing (SPAKE2-over-Ed25519 + TLS 1.3) for Android 11+ wireless debugging.
31
+ - **Streaming APK install** (experimental) - `device.install()` now tries `exec:cmd`-based streaming install first, falling back to the classic push-then-install flow.
32
+ - **SYNC V2 (64-bit)** - `pushV2` / `pullV2` / `statV2` / `listV2` lift the legacy 32-bit size ceiling, with optional brotli compression.
33
+ - **Hardening** - closed a shell-injection gap in `devices.mjs`'s and `shell.mjs`'s convenience shortcuts, capped several unbounded device-controlled memory allocations in the SYNC V2 paths, and fixed a handful of mid-transfer disconnect/failure edge cases.
34
+ - [View full v2.0.0 Changelog](./docs/changelog/v2/v2.0.0.md)
29
35
 
30
- ### Previous: v1.1.0 (September 2026)
36
+ ### Recent Releases
31
37
 
32
- - **`list` / `stat` fixed** - v1.0.0 shipped both throwing due to a dangling reference to a module that never existed in the repo.
33
- - **Binary-safe `list()`** - prefers the ADB SYNC `LIST` command, falls back to shell `ls -la` parsing only when SYNC isn't usable.
34
- - **`push` / `pull` implemented (experimental)** - real binary file transfer via the ADB SYNC sub-protocol.
35
- - **`device.reboot()`** (experimental) - the real ADB `reboot:` service, including bootloader/recovery/sideload modes.
36
- - **`device.forward()`** (experimental) - TCP port forwarding (host → device direction).
37
- - **`device.install()`** (experimental) - local APK install via the classic push-then-install flow.
38
- - [View full v1.1.0 Changelog](./docs/changelog/v1/v1.1.0.md)
38
+ - **v1.2.0** (September 2026) - Device discovery (`discover.subnet()` CIDR sweep, `discover.mdns()` for wireless-debugging-advertised devices, both experimental) and a shell-injection fix across every `files.*` shell-based method ([Changelog](./docs/changelog/v1/v1.2.0.md))
39
+ - **v1.1.1** (September 2026) - Documentation formatting fix (padded slashes between adjacent code spans) - no code changes ([PR #16](https://github.com/CLDMV/droidsock/pull/16))
40
+ - **v1.1.0** (September 2026) - Fixed the `list()`/`stat()` regression from v1.0.0, and added a binary-safe SYNC-based `list()` with shell fallback, real ADB `reboot:` support, TCP port forwarding, and local APK install ([Changelog](./docs/changelog/v1/v1.1.0.md))
41
+ - **v1.0.0** (September 2026) - First tagged release - a callable quick-path default export (dropping `connect()`/`listDevices()`), a real test suite with measured coverage, and a full CI/release pipeline ([Changelog](./docs/changelog/v1/v1.0.0.md))
39
42
 
40
43
  📚 **For complete version history and detailed release notes, see [docs/changelog/](./docs/changelog/) folder.**
41
44
 
@@ -47,10 +50,11 @@ A complete, from-scratch implementation of the Android Debug Bridge (ADB) protoc
47
50
  - ✅ **RSA Authentication**: Automatic key generation and ADB-specific signature/public-key formatting
48
51
  - ✅ **Stream Multiplexing**: Multiple concurrent operations over a single connection
49
52
  - ✅ **Shell Commands**: Execute commands, stream output, interactive sessions
50
- - ✅ **File Operations**: Shell-based `mkdir` / `remove` / `move` / `copy` / `chmod` / `diskUsage` / `find`, plus binary-safe SYNC-based `list`, and experimental `push` / `pull`
53
+ - ✅ **File Operations**: Shell-based `mkdir` / `remove` / `move` / `copy` / `chmod` / `diskUsage` / `find`, plus binary-safe SYNC-based `list`, and experimental `push` / `pull` (legacy 32-bit) / `pushV2` / `pullV2` / `listV2` / `statV2` (64-bit)
51
54
  - ✅ **Reboot** (experimental): Real `reboot:` service, including bootloader/recovery/sideload modes
52
- - ✅ **Port Forwarding** (experimental): `adb forward`-equivalent TCP tunneling (host → device)
53
- - ✅ **APK Install** (experimental): `adb install`-equivalent local APK installation
55
+ - ✅ **Port Forwarding** (experimental): `adb forward`/`adb reverse`-equivalent TCP tunneling, both directions
56
+ - ✅ **APK Install** (experimental): `adb install`-equivalent local APK installation - classic push-then-install and modern streaming (`exec:cmd package install`) paths
57
+ - ✅ **Wi-Fi Pairing** (experimental): `adb pair`-equivalent PIN-based pairing (SPAKE2-over-Ed25519 + TLS 1.3) for Android 11+ wireless debugging
54
58
  - ✅ **Device Discovery**: Support for multiple devices via configuration
55
59
  - ✅ **Error Handling**: Robust error handling and connection recovery
56
60
 
@@ -85,7 +89,7 @@ const logcat = device.logcat({
85
89
  });
86
90
 
87
91
  // Clean up
88
- device.disconnect();
92
+ await device.disconnect();
89
93
  ```
90
94
 
91
95
  ## Device Configuration
@@ -112,9 +116,9 @@ Use the `references/devices.json` file to configure your devices:
112
116
 
113
117
  ## API Reference
114
118
 
115
- `droidsock(options)` (also `createDroidSock`) creates the API instance; `api.device.connect(host, port, options)` returns a device object exposing connection state, shell execution/streaming, file operations (`push` / `pull` / `list` / `stat`), reboot, port forwarding, and APK install.
119
+ `droidsock(options)` (also `createDroidSock`) creates the API instance; `api.device.connect(host, port, options)` connects to a device (IPv4 or IPv6) and returns its live leaf - also reachable afterward at `api.devices["<host>_<port>"]` (a `.` becomes `_`, a `:` becomes `__`) - exposing connection state, shell execution/streaming, file operations (`push` / `pull` / `list` / `stat`), reboot, port forwarding, and APK install. `api.device.disconnect(host, port)` tears down one device's connection without forgetting it - reconnect later with `connect()` on the same host:port, no need to re-supply options; `api.device.remove(host, port)` forgets it entirely. `api.devices.list()` / `disconnect()` (all) / `remove()` (all) / `get(idOrLeaf)` manage the set of known devices as a whole.
116
120
 
117
- 📚 **See [docs/API.md](./docs/API.md) for the full method reference**, including every option and the experimental/scope caveats on `push` / `pull` / `list` / `forward` / `install`.
121
+ 📚 **See [docs/API.md](./docs/API.md) for the full method reference**, including every option and the experimental/scope caveats on `push` / `pull` / `list` / `forward` / `reverse` / `install`.
118
122
 
119
123
  ## Examples
120
124
 
@@ -152,9 +156,11 @@ node examples/streaming-example.mjs files
152
156
  5. **Files Layer** (`src/api/files.mjs`): Shell-based file operations, a binary-safe SYNC `LIST` implementation with automatic shell fallback, and an experimental ADB SYNC sub-protocol implementation for real binary transfer (`push` / `pull`) - not yet validated against a real device
153
157
  6. **Reboot Layer** (`src/api/reboot.mjs`): Real ADB `reboot:` service
154
158
  7. **Forward Layer** (`src/api/forward.mjs`): TCP port forwarding (host → device) via the `tcp:` service
155
- 8. **Install Layer** (`src/api/install.mjs`): Local APK install, composed from the Files and Shell layers
156
- 9. **Device Layer** (`src/api/device.mjs`): High-level per-device API composing the layers above
157
- 10. **Config / Log Layers** (`src/api/config.mjs`, `src/api/log.mjs`): Shared configuration and logging
159
+ 8. **Reverse Layer** (`src/api/reverse.mjs`): TCP port forwarding (device → host) via `reverse:forward:`/`reverse:killforward:` and the Stream layer's device-initiated stream handling
160
+ 9. **Install Layer** (`src/api/install.mjs`): Local APK install, composed from the Files and Shell layers
161
+ 10. **Pairing Layer** (`src/api/pairing.mjs`): Wi-Fi pairing (`adb pair` equivalent) - a separate TLS 1.3 + SPAKE2 protocol reusing the Authentication layer's persistent RSA identity, not composed with any of the layers above
162
+ 11. **Device / Devices Layers** (`src/api/device.mjs`, `src/api/devices.mjs`): High-level per-device API composing the layers above, split by single-target (`device.connect`/`disconnect`/`remove`) vs. collection-wide (`devices.list`/`disconnect`/`remove`/`get`) operations. Each device is a real, persistent slothlet leaf at `api.devices.<sanitized host_port>`, assigned there by `connect()` rather than held in a private module variable, so its methods keep working `self`/context access exactly like any other leaf - the leaf outlives any one connection, and only `remove()` unmounts it
163
+ 12. **Config / Log Layers** (`src/api/config.mjs`, `src/api/log.mjs`): Shared configuration and logging
158
164
 
159
165
  📚 **See [docs/PROTOCOL.md](./docs/PROTOCOL.md) for wire-level protocol details** (packet structure, auth flow, SYNC sub-protocol framing, reboot/forward service usage).
160
166
 
@@ -14,4 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import{self}from"@cldmv/slothlet/runtime";import net from"node:net";const ADB_PROTOCOL_VERSION=16777216;const ADB_MAX_PAYLOAD=4096;const MSG_CNXN=1314410051;const MSG_AUTH=1213486401;const MSG_OKAY=1497451343;async function create(options){const{host,port,privateKey,adbPublicKey}=options;const socket=new net.Socket;const connection={socket,host,port,authorized:false,connected:false,onUnhandledPacket:null,disconnect:()=>{if(socket&&!socket.destroyed){self.log.debug(`Disconnecting from ${host}:${port}`);socket.destroy()}connection.connected=false;connection.authorized=false}};return new Promise((resolve,reject)=>{const timeout=setTimeout(()=>{socket.destroy();reject(new Error("Connection timeout"))},1e4);socket.connect(port,host,async()=>{try{self.log.debug(`Connected to ${host}:${port}, sending CNXN message...`);const systemIdentity="device::";const cnxnPayload=Buffer.from(systemIdentity);await sendMessage(socket,MSG_CNXN,ADB_PROTOCOL_VERSION,ADB_MAX_PAYLOAD,cnxnPayload);self.log.debug(`${self.config.get("debugArrowSent")} CNXN message sent, waiting for AUTH response...`);const authMessage=await receiveMessage(socket);self.log.debug(`${self.config.get("debugArrowReceived")} Received AUTH message, command:`,authMessage.command.toString(16));if(authMessage.command!==MSG_AUTH){throw new Error(`Expected AUTH message (0x${MSG_AUTH.toString(16)}), got 0x${authMessage.command.toString(16)}`)}self.log.debug(`${self.config.get("debugArrowReceived")} AUTH message received, token length:`,authMessage.data.length);const token=authMessage.data;const signature=await self.auth.sign(token,privateKey);await sendMessage(socket,MSG_AUTH,2,0,signature);const pubKeyBuffer=Buffer.from(adbPublicKey);await sendMessage(socket,MSG_AUTH,3,0,pubKeyBuffer);const okayMessage=await receiveMessage(socket);self.log.debug(`${self.config.get("debugArrowReceived")} After auth, received command:`,okayMessage.command.toString(16));self.log.debug("Expected CNXN:",MSG_CNXN.toString(16),"or OKAY:",MSG_OKAY.toString(16));if(okayMessage.command===MSG_CNXN){const cnxnPayload2=okayMessage.data.toString().replace(/\0/g,"");self.log.debug(`${self.config.get("debugArrowReceived")} Device sent CNXN response - authentication successful!`);self.log.debug(`${self.config.get("debugArrowReceived")} CNXN payload:`,cnxnPayload2);const featuresMatch=cnxnPayload2.match(/features=([^;]+)/);connection.deviceFeatures=featuresMatch?featuresMatch[1].split(","):[];connection.authorized=true;connection.connected=true;self.log.debug("Authentication successful!")}else if(okayMessage.command===MSG_OKAY){self.log.debug(`${self.config.get("debugArrowReceived")} Device sent OKAY response - authentication successful!`);connection.authorized=true;connection.connected=true}else{throw new Error(`Authentication failed - expected CNXN (${MSG_CNXN.toString(16)}) or OKAY (${MSG_OKAY.toString(16)}), got ${okayMessage.command.toString(16)}`)}clearTimeout(timeout);socket.on("data",data=>{if(connection.onUnhandledPacket){connection.onUnhandledPacket(data)}});resolve(connection)}catch(error){clearTimeout(timeout);self.log.debug("Connection error:",error.message);reject(error)}});socket.on("error",error=>{clearTimeout(timeout);self.log.debug("Socket error:",error.message);reject(error)})})}async function sendMessage(socket,command,arg0,arg1,data=Buffer.alloc(0)){const header=Buffer.alloc(24);let offset=0;header.writeUInt32LE(command,offset);offset+=4;header.writeUInt32LE(arg0,offset);offset+=4;header.writeUInt32LE(arg1,offset);offset+=4;header.writeUInt32LE(data.length,offset);offset+=4;header.writeUInt32LE(checksum(data),offset);offset+=4;header.writeUInt32LE((command^4294967295)>>>0,offset);socket.write(header);if(data.length>0){socket.write(data)}}function receiveMessage(socket){return new Promise((resolve,reject)=>{let headerReceived=false;let expectedDataLength=0;let receivedHeader=null;let receivedData=Buffer.alloc(0);const onData=chunk=>{if(!headerReceived){if(chunk.length>=24){receivedHeader=chunk.slice(0,24);self.log.debug("Header bytes:",Array.from(receivedHeader).map(b=>b.toString(16).padStart(2,"0")).join(" "));try{expectedDataLength=receivedHeader.readUInt32LE(12);self.log.debug("Raw data length from header:",expectedDataLength)}catch(readError){reject(new Error(`Failed to read data length from header: ${readError.message}`));return}if(isNaN(expectedDataLength)||expectedDataLength<0||expectedDataLength>1024*1024){reject(new Error(`Invalid data length: ${expectedDataLength} (header: ${receivedHeader.toString("hex")})`));return}headerReceived=true;if(chunk.length>24){receivedData=Buffer.concat([receivedData,chunk.slice(24)])}}}else{receivedData=Buffer.concat([receivedData,chunk])}if(headerReceived&&receivedData.length>=expectedDataLength){socket.removeListener("data",onData);try{const command=receivedHeader.readUInt32LE(0);const arg0=receivedHeader.readUInt32LE(4);const arg1=receivedHeader.readUInt32LE(8);const dataLength=receivedHeader.readUInt32LE(12);const headerChecksum=receivedHeader.readUInt32LE(16);const magic=receivedHeader.readUInt32LE(20);self.log.debug("Parsed header - command:",command.toString(16),"arg0:",arg0,"arg1:",arg1,"length:",dataLength,"checksum:",headerChecksum,"magic:",magic.toString(16));const expectedMagic=(command^4294967295)>>>0;if(magic!==expectedMagic){self.log.debug("Magic mismatch - expected:",expectedMagic.toString(16),"got:",magic.toString(16))}const data=receivedData.slice(0,expectedDataLength);if(data.length>0){const calculatedChecksum=checksum(data);self.log.debug("Data checksum - expected:",headerChecksum,"calculated:",calculatedChecksum)}resolve({command,arg0,arg1,data})}catch(parseError){reject(new Error(`Failed to parse message header: ${parseError.message}`))}}};socket.on("data",onData);socket.on("error",reject)})}function checksum(data){let sum=0;for(let i=0;i<data.length;i++){sum=sum+data[i]>>>0}return sum}export{create};
17
+ import{self}from"@cldmv/slothlet/runtime";import net from"node:net";const ADB_PROTOCOL_VERSION=16777216;const ADB_MAX_PAYLOAD=4096;const MSG_CNXN=1314410051;const MSG_AUTH=1213486401;const MSG_OKAY=1497451343;const SUPPORTED_FEATURES=["shell_v2","cmd","stat_v2","ls_v2","sendrecv_v2","sendrecv_v2_brotli"];async function create(options){const{host,port,privateKey,adbPublicKey}=options;const socket=new net.Socket;const connection={socket,host,port,authorized:false,connected:false,onUnhandledPacket:null,disconnect:()=>{if(socket&&!socket.destroyed){self.log.debug(`Disconnecting from ${host}:${port}`);socket.destroy()}connection.connected=false;connection.authorized=false}};return new Promise((resolve,reject)=>{const timeout=setTimeout(()=>{socket.destroy();reject(new Error("Connection timeout"))},1e4);socket.connect(port,host,async()=>{try{self.log.debug(`Connected to ${host}:${port}, sending CNXN message...`);const systemIdentity=`device::features=${SUPPORTED_FEATURES.join(",")}`;const cnxnPayload=Buffer.from(systemIdentity);await sendMessage(socket,MSG_CNXN,ADB_PROTOCOL_VERSION,ADB_MAX_PAYLOAD,cnxnPayload);self.log.debug(`${self.config.get("debugArrowSent")} CNXN message sent, waiting for AUTH response...`);const authMessage=await receiveMessage(socket);self.log.debug(`${self.config.get("debugArrowReceived")} Received AUTH message, command:`,authMessage.command.toString(16));if(authMessage.command!==MSG_AUTH){throw new Error(`Expected AUTH message (0x${MSG_AUTH.toString(16)}), got 0x${authMessage.command.toString(16)}`)}self.log.debug(`${self.config.get("debugArrowReceived")} AUTH message received, token length:`,authMessage.data.length);const token=authMessage.data;const signature=await self.auth.sign(token,privateKey);await sendMessage(socket,MSG_AUTH,2,0,signature);const pubKeyBuffer=Buffer.from(adbPublicKey);await sendMessage(socket,MSG_AUTH,3,0,pubKeyBuffer);const okayMessage=await receiveMessage(socket);self.log.debug(`${self.config.get("debugArrowReceived")} After auth, received command:`,okayMessage.command.toString(16));self.log.debug("Expected CNXN:",MSG_CNXN.toString(16),"or OKAY:",MSG_OKAY.toString(16));if(okayMessage.command===MSG_CNXN){const cnxnPayload2=okayMessage.data.toString().replace(/\0/g,"");self.log.debug(`${self.config.get("debugArrowReceived")} Device sent CNXN response - authentication successful!`);self.log.debug(`${self.config.get("debugArrowReceived")} CNXN payload:`,cnxnPayload2);const featuresMatch=cnxnPayload2.match(/features=([^;]+)/);connection.deviceFeatures=featuresMatch?featuresMatch[1].split(","):[];connection.authorized=true;connection.connected=true;self.log.debug("Authentication successful!")}else if(okayMessage.command===MSG_OKAY){self.log.debug(`${self.config.get("debugArrowReceived")} Device sent OKAY response - authentication successful!`);connection.authorized=true;connection.connected=true}else{throw new Error(`Authentication failed - expected CNXN (${MSG_CNXN.toString(16)}) or OKAY (${MSG_OKAY.toString(16)}), got ${okayMessage.command.toString(16)}`)}clearTimeout(timeout);socket.on("data",data=>{if(connection.onUnhandledPacket){connection.onUnhandledPacket(data)}});resolve(connection)}catch(error){clearTimeout(timeout);self.log.debug("Connection error:",error.message);reject(error)}});socket.on("error",error=>{clearTimeout(timeout);self.log.debug("Socket error:",error.message);reject(error)})})}async function sendMessage(socket,command,arg0,arg1,data=Buffer.alloc(0)){const header=Buffer.alloc(24);let offset=0;header.writeUInt32LE(command,offset);offset+=4;header.writeUInt32LE(arg0,offset);offset+=4;header.writeUInt32LE(arg1,offset);offset+=4;header.writeUInt32LE(data.length,offset);offset+=4;header.writeUInt32LE(checksum(data),offset);offset+=4;header.writeUInt32LE((command^4294967295)>>>0,offset);socket.write(header);if(data.length>0){socket.write(data)}}function receiveMessage(socket){return new Promise((resolve,reject)=>{let headerReceived=false;let expectedDataLength=0;let receivedHeader=null;let receivedData=Buffer.alloc(0);const onData=chunk=>{if(!headerReceived){if(chunk.length>=24){receivedHeader=chunk.slice(0,24);self.log.debug("Header bytes:",Array.from(receivedHeader).map(b=>b.toString(16).padStart(2,"0")).join(" "));try{expectedDataLength=receivedHeader.readUInt32LE(12);self.log.debug("Raw data length from header:",expectedDataLength)}catch(readError){reject(new Error(`Failed to read data length from header: ${readError.message}`));return}if(isNaN(expectedDataLength)||expectedDataLength<0||expectedDataLength>1024*1024){reject(new Error(`Invalid data length: ${expectedDataLength} (header: ${receivedHeader.toString("hex")})`));return}headerReceived=true;if(chunk.length>24){receivedData=Buffer.concat([receivedData,chunk.slice(24)])}}}else{receivedData=Buffer.concat([receivedData,chunk])}if(headerReceived&&receivedData.length>=expectedDataLength){socket.removeListener("data",onData);try{const command=receivedHeader.readUInt32LE(0);const arg0=receivedHeader.readUInt32LE(4);const arg1=receivedHeader.readUInt32LE(8);const dataLength=receivedHeader.readUInt32LE(12);const headerChecksum=receivedHeader.readUInt32LE(16);const magic=receivedHeader.readUInt32LE(20);self.log.debug("Parsed header - command:",command.toString(16),"arg0:",arg0,"arg1:",arg1,"length:",dataLength,"checksum:",headerChecksum,"magic:",magic.toString(16));const expectedMagic=(command^4294967295)>>>0;if(magic!==expectedMagic){self.log.debug("Magic mismatch - expected:",expectedMagic.toString(16),"got:",magic.toString(16))}const data=receivedData.slice(0,expectedDataLength);if(data.length>0){const calculatedChecksum=checksum(data);self.log.debug("Data checksum - expected:",headerChecksum,"calculated:",calculatedChecksum)}resolve({command,arg0,arg1,data})}catch(parseError){reject(new Error(`Failed to parse message header: ${parseError.message}`))}}};socket.on("data",onData);socket.on("error",reject)})}function checksum(data){let sum=0;for(let i=0;i<data.length;i++){sum=sum+data[i]>>>0}return sum}export{create};
@@ -14,4 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import{self}from"@cldmv/slothlet/runtime";const connections=new Map;async function connect(host,port=5555,options={}){const deviceId=`${host}:${port}`;if(connections.has(deviceId)){const existing=connections.get(deviceId);if(existing.isConnected()){return existing}else{connections.delete(deviceId)}}const keys=await self.auth.getKeys(options.keyDir);const connection=await self.connection.create({host,port,publicKey:keys.publicKey,privateKey:keys.privateKey,adbPublicKey:keys.adbPublicKey});const streamManager=await self.stream.create(connection.socket);connection.onUnhandledPacket=packet=>streamManager.handlePacket(packet);const device={host,port,deviceId,connection,streamManager,isConnected:()=>connection&&connection.connected,disconnect:()=>{if(connection){connection.disconnect();connections.delete(deviceId)}},shell:async(command,shellOptions={})=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return await self.shell.execute(connection.socket,streamManager,command,{...shellOptions,deviceFeatures:connection.deviceFeatures||[]})},startStreamingShell:(command,shellOptions={})=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return self.shell.startStreaming(connection.socket,streamManager,command,shellOptions)},startInteractiveShell:(command,shellOptions={})=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return self.shell.startInteractive(connection.socket,streamManager,command,shellOptions)},push:async(localPath,remotePath,transferOptions={})=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return await self.files.push(connection.socket,streamManager,localPath,remotePath,transferOptions)},pull:async(remotePath,localPath,transferOptions={})=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return await self.files.pull(connection.socket,streamManager,remotePath,localPath,transferOptions)},list:async remotePath=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return await self.files.list(connection.socket,streamManager,remotePath)},stat:async remotePath=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return await self.files.stat(connection.socket,streamManager,remotePath)},reboot:async(mode="")=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return await self.reboot.execute(connection.socket,streamManager,mode)},forward:async(devicePort,forwardOptions={})=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return await self.forward.start(connection.socket,streamManager,devicePort,forwardOptions)},install:async(localPath,installOptions={})=>{if(!device.isConnected()){throw new Error("Device not connected")}if(!connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}return await self.install.classic(connection.socket,streamManager,localPath,installOptions)},get ls(){return(path=".")=>device.shell(`ls -la "${path}"`)},get pwd(){return()=>device.shell("pwd")},get getprop(){return(prop=null)=>device.shell(prop?`getprop "${prop}"`:"getprop")},get getModel(){return()=>device.shell("getprop ro.product.model")},get getAndroidVersion(){return()=>device.shell("getprop ro.build.version.release")},get getBattery(){return()=>device.shell("dumpsys battery")},get screenshot(){return(filename="/sdcard/screenshot.png")=>device.shell(`screencap -p "${filename}"`)},get logcat(){return(logOptions={})=>device.startStreamingShell("logcat",logOptions)},get top(){return(topOptions={})=>device.startStreamingShell("top -m 10",topOptions)},get keypress(){return key=>device.shell(`input keyevent ${key}`)},get launchApp(){return(packageName,activity="")=>{const activityArg=activity?`/${activity}`:"";return device.shell(`am start -n ${packageName}${activityArg}`)}},get rebootBootloader(){return()=>device.reboot("bootloader")},get rebootRecovery(){return()=>device.reboot("recovery")},get rebootSideload(){return()=>device.reboot("sideload")}};connections.set(deviceId,device);return device}function list(){return Array.from(connections.values()).filter(device=>device.isConnected())}function disconnect(host,port=5555){const deviceId=`${host}:${port}`;const device=connections.get(deviceId);if(device){device.disconnect();return true}return false}function disconnectAll(){let count=0;for(const device of connections.values()){device.disconnect();count++}connections.clear();return count}export{connect,disconnect,disconnectAll,list};
17
+ import{self}from"@cldmv/slothlet/runtime";import{quoteShellArg,sanitizeKey}from"./utils.mjs";async function openSession(host,port,options){const keys=await self.auth.getKeys(options.keyDir);const connection=await self.connection.create({host,port,publicKey:keys.publicKey,privateKey:keys.privateKey,adbPublicKey:keys.adbPublicKey});const streamManager=await self.stream.create(connection.socket);connection.onUnhandledPacket=packet=>streamManager.handlePacket(packet);return{connection,streamManager}}function buildDeviceLeaf(host,port,deviceId,deviceKey,options){const session={connection:null,streamManager:null};function assertReady(){if(!leaf.isConnected()){throw new Error("Device not connected")}if(!session.connection.authorized){throw new Error("Device not authorized. Please accept authorization dialog.")}}const leaf={host,port,deviceId,options,connection:null,streamManager:null,isConnected:()=>Boolean(session.connection&&session.connection.connected&&session.connection.socket&&!session.connection.socket.destroyed),disconnect:()=>{if(session.connection)session.connection.disconnect()},reconnect:async(reconnectOptions={})=>{leaf.options={...leaf.options,...reconnectOptions};if(leaf.isConnected())return self.devices[deviceKey];const{connection,streamManager}=await openSession(host,port,leaf.options);session.connection=connection;session.streamManager=streamManager;self.devices[deviceKey].connection=connection;self.devices[deviceKey].streamManager=streamManager;return self.devices[deviceKey]},remove:async()=>{leaf.disconnect();await self.slothlet.api.remove(`devices.${deviceKey}`).catch(()=>{})},shell:async(command,shellOptions={})=>{assertReady();return await self.shell.execute(session.connection.socket,session.streamManager,command,{...shellOptions,deviceFeatures:session.connection.deviceFeatures||[]})},startStreamingShell:(command,shellOptions={})=>{assertReady();return self.shell.startStreaming(session.connection.socket,session.streamManager,command,shellOptions)},startInteractiveShell:(command,shellOptions={})=>{assertReady();return self.shell.startInteractive(session.connection.socket,session.streamManager,command,shellOptions)},push:async(localPath,remotePath,transferOptions={})=>{assertReady();return await self.files.push(session.connection.socket,session.streamManager,localPath,remotePath,transferOptions)},pull:async(remotePath,localPath,transferOptions={})=>{assertReady();return await self.files.pull(session.connection.socket,session.streamManager,remotePath,localPath,transferOptions)},pushV2:async(localPath,remotePath,transferOptions={})=>{assertReady();return await self.files.pushV2(session.connection.socket,session.streamManager,localPath,remotePath,transferOptions)},pullV2:async(remotePath,localPath,transferOptions={})=>{assertReady();return await self.files.pullV2(session.connection.socket,session.streamManager,remotePath,localPath,transferOptions)},list:async remotePath=>{assertReady();return await self.files.list(session.connection.socket,session.streamManager,remotePath)},stat:async remotePath=>{assertReady();return await self.files.stat(session.connection.socket,session.streamManager,remotePath)},listV2:async remotePath=>{assertReady();return await self.files.listV2(session.connection.socket,session.streamManager,remotePath)},statV2:async remotePath=>{assertReady();return await self.files.statV2(session.connection.socket,session.streamManager,remotePath)},reboot:async(mode="")=>{assertReady();return await self.reboot.execute(session.connection.socket,session.streamManager,mode)},forward:async(devicePort,forwardOptions={})=>{assertReady();return await self.forward.start(session.connection.socket,session.streamManager,devicePort,forwardOptions)},reverse:async(devicePort,hostPort,reverseOptions={})=>{assertReady();return await self.reverse.start(session.connection.socket,session.streamManager,devicePort,hostPort,reverseOptions)},install:async(localPath,installOptions={})=>{assertReady();if((session.connection.deviceFeatures||[]).includes("cmd")){try{return await self.install.streaming(session.connection.socket,session.streamManager,localPath,installOptions)}catch(streamingError){try{return await self.install.classic(session.connection.socket,session.streamManager,localPath,installOptions)}catch(classicError){throw new Error(`Streaming install failed (${streamingError.message}), and the classic fallback also failed: ${classicError.message}`,{cause:classicError})}}}return await self.install.classic(session.connection.socket,session.streamManager,localPath,installOptions)},ls:(path=".")=>leaf.shell(`ls -la ${quoteShellArg(path)}`),pwd:()=>leaf.shell("pwd"),getprop:(prop=null)=>leaf.shell(prop?`getprop ${quoteShellArg(prop)}`:"getprop"),getModel:()=>leaf.shell("getprop ro.product.model"),getAndroidVersion:()=>leaf.shell("getprop ro.build.version.release"),getBattery:()=>leaf.shell("dumpsys battery"),screenshot:(filename="/sdcard/screenshot.png")=>leaf.shell(`screencap -p ${quoteShellArg(filename)}`),logcat:(logOptions={})=>leaf.startStreamingShell("logcat",logOptions),top:(topOptions={})=>leaf.startStreamingShell("top -m 10",topOptions),keypress:key=>leaf.shell(`input keyevent ${quoteShellArg(key)}`),launchApp:(packageName,activity="")=>{const target=activity?`${packageName}/${activity}`:packageName;return leaf.shell(`am start -n ${quoteShellArg(target)}`)},rebootBootloader:()=>leaf.reboot("bootloader"),rebootRecovery:()=>leaf.reboot("recovery"),rebootSideload:()=>leaf.reboot("sideload")};return leaf}async function connect(host,port=5555,options={}){const deviceId=`${host}:${port}`;const deviceKey=sanitizeKey(deviceId);const existing=self.devices&&self.devices[deviceKey];if(existing){return await existing.reconnect(options)}const leaf=buildDeviceLeaf(host,port,deviceId,deviceKey,options);await self.slothlet.api.add(`devices.${deviceKey}`,leaf,{moduleID:`device:${deviceId}`});await self.devices[deviceKey].reconnect(options);return self.devices[deviceKey]}function disconnect(host,port=5555){const deviceKey=sanitizeKey(`${host}:${port}`);const entry=self.devices&&self.devices[deviceKey];if(!entry){return false}entry.disconnect();return true}async function remove(host,port=5555){const deviceKey=sanitizeKey(`${host}:${port}`);const entry=self.devices&&self.devices[deviceKey];if(!entry){return false}await entry.remove();return true}export{connect,disconnect,remove};
@@ -0,0 +1,17 @@
1
+ /*
2
+ Copyright 2026 CLDMV/Shinrai
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import{self}from"@cldmv/slothlet/runtime";import{parseHostPort,sanitizeKey}from"./utils.mjs";function deviceEntries(){const registry=self.devices||{};return Object.keys(registry).map(key=>registry[key]).filter(entry=>entry&&typeof entry==="object"&&typeof entry.isConnected==="function")}function list(){return deviceEntries().filter(entry=>entry.isConnected())}function get(idOrLeaf){let host,port;if(idOrLeaf&&typeof idOrLeaf==="object"){({host,port}=idOrLeaf)}else{({host,port}=parseHostPort(String(idOrLeaf)))}const key=sanitizeKey(`${host}:${port}`);return self.devices&&self.devices[key]||void 0}function disconnect(){if(arguments.length>0){throw new Error("devices.disconnect() takes no arguments - it disconnects ALL devices. Use device.disconnect(host, port) for one.")}let count=0;for(const entry of deviceEntries()){if(!entry.isConnected())continue;entry.disconnect();count++}return count}async function remove(){if(arguments.length>0){throw new Error("devices.remove() takes no arguments - it removes ALL devices. Use device.remove(host, port) for one.")}const entries=deviceEntries();let count=0;for(const entry of entries){await entry.remove();count++}return count}export{disconnect,get,list,remove};
@@ -14,4 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import{self}from"@cldmv/slothlet/runtime";import net from"node:net";import dgram from"node:dgram";import{isValidIP,isValidPort}from"./utils.mjs";const DNS_TYPE_A=1;const DNS_TYPE_PTR=12;const DNS_TYPE_TXT=16;const DNS_TYPE_SRV=33;const DNS_CLASS_IN=1;function ipToInt(ip){const parts=ip.split(".").map(Number);return(parts[0]<<24|parts[1]<<16|parts[2]<<8|parts[3])>>>0}function intToIp(int){return[24,16,8,0].map(shift=>int>>>shift&255).join(".")}function parseCidr(cidr){const parts=String(cidr).split("/");if(parts.length!==2||!isValidIP(parts[0])||!/^\d+$/.test(parts[1])){throw new Error(`Invalid CIDR: ${cidr}`)}const[ip,prefixStr]=parts;const prefix=Number(prefixStr);if(prefix>32){throw new Error(`Invalid CIDR prefix (must be 0-32): ${cidr}`)}const base=ipToInt(ip);const hostBits=32-prefix;if(hostBits===0){return{firstHostInt:base,lastHostInt:base,sweepCount:1}}if(hostBits===32){return{firstHostInt:1,lastHostInt:4294967294,sweepCount:4294967294}}const mask=~0<<hostBits>>>0;const network=(base&mask)>>>0;const broadcast=(network|~mask>>>0)>>>0;if(hostBits===1){return{firstHostInt:network,lastHostInt:broadcast,sweepCount:2}}return{firstHostInt:network+1,lastHostInt:broadcast-1,sweepCount:broadcast-network-1}}function attemptConnect(host,port,timeoutMs){return new Promise(resolve=>{const socket=new net.Socket;let settled=false;const finish=reachable=>{if(settled)return;settled=true;socket.removeAllListeners();socket.destroy();resolve(reachable)};socket.setTimeout(timeoutMs);socket.once("connect",()=>finish(true));socket.once("error",()=>finish(false));socket.once("timeout",()=>finish(false));socket.connect(port,host)})}async function sweepPool(hosts,port,{timeoutMs,concurrency}){const reachable=[];let nextIndex=0;async function worker(){for(;;){const i=nextIndex++;if(i>=hosts.length)return;const host=hosts[i];if(await attemptConnect(host,port,timeoutMs)){reachable.push({host,port})}}}const workers=Array.from({length:Math.min(concurrency,hosts.length)},()=>worker());await Promise.all(workers);return reachable.sort((a,b)=>ipToInt(a.host)-ipToInt(b.host))}async function subnet(cidr,port=5555,options={}){const{timeoutMs=500,concurrency=32,maxHosts=1024}=options;if(!isValidPort(port)){throw new Error(`Invalid port: ${port}`)}if(!Number.isInteger(timeoutMs)||timeoutMs<=0){throw new Error(`Invalid timeoutMs: ${timeoutMs} (must be a positive integer)`)}if(!Number.isInteger(concurrency)||concurrency<=0){throw new Error(`Invalid concurrency: ${concurrency} (must be a positive integer)`)}if(!Number.isInteger(maxHosts)||maxHosts<=0){throw new Error(`Invalid maxHosts: ${maxHosts} (must be a positive integer)`)}const range=parseCidr(cidr);if(range.sweepCount>maxHosts){throw new Error(`CIDR ${cidr} has ${range.sweepCount} sweepable host(s), exceeding maxHosts (${maxHosts}). Use a narrower CIDR or raise maxHosts.`)}const hosts=[];for(let ip=range.firstHostInt;ip<=range.lastHostInt;ip++){hosts.push(intToIp(ip))}self.log.debug(`discover.subnet: sweeping ${hosts.length} host(s) in ${cidr} on port ${port}`);return await sweepPool(hosts,port,{timeoutMs,concurrency})}function encodeDnsName(name){const labels=name.replace(/\.$/,"").split(".").filter(Boolean);const parts=labels.map(label=>{const labelBuf=Buffer.from(label,"utf8");if(labelBuf.length>63){throw new Error(`DNS label too long (max 63 bytes): "${label}"`)}return Buffer.concat([Buffer.from([labelBuf.length]),labelBuf])});const encoded=Buffer.concat([...parts,Buffer.from([0])]);if(encoded.length>255){throw new Error(`DNS name too long (max 255 bytes): "${name}"`)}return encoded}function decodeDnsName(buffer,offset){const labels=[];let pos=offset;let next=-1;let guard=0;for(;;){if(guard++>128)throw new Error("DNS name decoding exceeded compression-pointer guard");const len=buffer.readUInt8(pos);if(len===0){pos+=1;if(next===-1)next=pos;break}if((len&192)===192){const pointer=(len&63)<<8|buffer.readUInt8(pos+1);if(next===-1)next=pos+2;pos=pointer;continue}labels.push(buffer.toString("utf8",pos+1,pos+1+len));pos+=1+len}return{name:labels.join("."),next}}function readDnsRecord(buffer,offset){const{name,next:afterName}=decodeDnsName(buffer,offset);let pos=afterName;const type=buffer.readUInt16BE(pos);pos+=2;pos+=2;const ttl=buffer.readUInt32BE(pos);pos+=4;const rdlength=buffer.readUInt16BE(pos);pos+=2;const rdataStart=pos;const rdataEnd=pos+rdlength;let data;switch(type){case DNS_TYPE_PTR:{const ptr=decodeDnsName(buffer,rdataStart);data=ptr.next<=rdataEnd?{target:ptr.name}:null;break}case DNS_TYPE_SRV:{if(rdlength<6){data=null;break}const srv=decodeDnsName(buffer,rdataStart+6);data=srv.next<=rdataEnd?{priority:buffer.readUInt16BE(rdataStart),weight:buffer.readUInt16BE(rdataStart+2),port:buffer.readUInt16BE(rdataStart+4),target:srv.name}:null;break}case DNS_TYPE_TXT:{const txt=Object.create(null);let p=rdataStart;while(p<rdataEnd){const len=buffer.readUInt8(p);p+=1;if(len===0)continue;if(p+len>rdataEnd)break;const entry=buffer.toString("utf8",p,p+len);p+=len;const eq=entry.indexOf("=");if(eq===-1)txt[entry]=true;else txt[entry.slice(0,eq)]=entry.slice(eq+1)}data=txt;break}case DNS_TYPE_A:data=Array.from(buffer.subarray(rdataStart,rdataEnd)).join(".");break;default:data=buffer.subarray(rdataStart,rdataEnd)}return{name,type,ttl,data,next:rdataEnd}}function parseDnsMessage(buffer){const qdcount=buffer.readUInt16BE(4);const ancount=buffer.readUInt16BE(6);const nscount=buffer.readUInt16BE(8);const arcount=buffer.readUInt16BE(10);let offset=12;for(let i=0;i<qdcount;i++){const{next}=decodeDnsName(buffer,offset);offset=next+4}const records=[];for(let i=0;i<ancount+nscount+arcount;i++){const record=readDnsRecord(buffer,offset);records.push(record);offset=record.next}return records}function buildPtrQuery(serviceType){const header=Buffer.alloc(12);header.writeUInt16BE(1,4);const question=Buffer.alloc(4);question.writeUInt16BE(DNS_TYPE_PTR,0);question.writeUInt16BE(DNS_CLASS_IN,2);return Buffer.concat([header,encodeDnsName(serviceType),question])}function isMulticastAddress(address){const firstOctet=Number(address.split(".",1)[0]);return Number.isInteger(firstOctet)&&firstOctet>=224&&firstOctet<=239}function ingestDnsRecords(records,results,addresses){for(const record of records){if(record.type===DNS_TYPE_A&&isValidIP(record.data))addresses.set(record.name,record.data)}for(const record of records){if(record.type!==DNS_TYPE_PTR||!record.data)continue;const instanceName=record.data.target;if(!results.has(instanceName)){results.set(instanceName,{name:instanceName,txt:Object.create(null)})}}for(const record of records){if(record.type===DNS_TYPE_SRV){if(!record.data)continue;const entry=results.get(record.name);if(!entry)continue;entry.port=record.data.port;entry._target=record.data.target;entry.host=addresses.get(record.data.target)||entry.host}else if(record.type===DNS_TYPE_TXT){const entry=results.get(record.name);if(!entry)continue;Object.assign(entry.txt,record.data)}}for(const entry of results.values()){if(!entry.host&&entry._target&&addresses.has(entry._target)){entry.host=addresses.get(entry._target)}}}async function mdns(options={}){const{serviceType="_adb-tls-connect._tcp.local",address="224.0.0.251",port=5353,timeoutMs=3e3}=options;if(!isValidPort(port)){throw new Error(`Invalid port: ${port}`)}if(!Number.isInteger(timeoutMs)||timeoutMs<=0){throw new Error(`Invalid timeoutMs: ${timeoutMs} (must be a positive integer)`)}const query=buildPtrQuery(serviceType);const isMulticast=isMulticastAddress(address);const socket=dgram.createSocket({type:"udp4",reuseAddr:true});const results=new Map;const addresses=new Map;let settled=false;return new Promise((resolve,reject)=>{const finish=(fn,value)=>{if(settled)return;settled=true;clearTimeout(timer);socket.removeAllListeners();socket.close();fn(value)};socket.on("error",error=>finish(reject,error));socket.on("message",message=>{try{ingestDnsRecords(parseDnsMessage(message),results,addresses)}catch(error){self.log.debug(`discover.mdns: ignoring unparseable response - ${error.message}`)}});const timer=setTimeout(()=>{finish(resolve,Array.from(results.values()).filter(entry=>entry.host&&entry.port).map(entry=>({name:entry.name,host:entry.host,port:entry.port,txt:entry.txt})))},timeoutMs);socket.bind(isMulticast?port:0,()=>{if(isMulticast){try{socket.addMembership(address)}catch(error){self.log.debug(`discover.mdns: couldn't join multicast group ${address} - ${error.message}`)}}try{socket.setMulticastTTL(255)}catch(error){self.log.debug(`discover.mdns: couldn't set multicast TTL - ${error.message}`)}self.log.debug(`discover.mdns: querying ${serviceType} via ${address}:${port}`);socket.send(query,port,address,error=>{if(error)finish(reject,error)})})})}export{mdns,subnet};
17
+ import{self}from"@cldmv/slothlet/runtime";import net from"node:net";import dgram from"node:dgram";import{isValidPort,ipv6ToBigInt,bigIntToIpv6}from"./utils.mjs";const DNS_TYPE_A=1;const DNS_TYPE_PTR=12;const DNS_TYPE_TXT=16;const DNS_TYPE_AAAA=28;const DNS_TYPE_SRV=33;const DNS_CLASS_IN=1;function ipv4ToBigInt(ip){return ip.split(".").reduce((acc,octet)=>acc<<8n|BigInt(octet),0n)}function bigIntToIpv4(value){return[24n,16n,8n,0n].map(shift=>Number(value>>shift&0xffn)).join(".")}function parseCidr(cidr){const parts=String(cidr).split("/");const family=parts.length===2?net.isIP(parts[0]):0;if(family===0||!/^\d+$/.test(parts[1])){throw new Error(`Invalid CIDR: ${cidr}`)}const[address,prefixStr]=parts;const addressBits=family===6?128:32;const prefix=Number(prefixStr);if(prefix>addressBits){throw new Error(`Invalid CIDR prefix (must be 0-${addressBits}): ${cidr}`)}const format=family===6?bigIntToIpv6:bigIntToIpv4;const base=family===6?ipv6ToBigInt(address):ipv4ToBigInt(address);const hostBits=BigInt(addressBits-prefix);const size=1n<<hostBits;const network=base>>hostBits<<hostBits;const lastAddress=network+size-1n;if(family===6||hostBits<=1n){return{family,firstHost:network,lastHost:lastAddress,sweepCount:size,format}}return{family,firstHost:network+1n,lastHost:lastAddress-1n,sweepCount:size-2n,format}}function attemptConnect(host,port,timeoutMs){return new Promise(resolve=>{const socket=new net.Socket;let settled=false;const finish=reachable=>{if(settled)return;settled=true;socket.removeAllListeners();socket.destroy();resolve(reachable)};socket.setTimeout(timeoutMs);socket.once("connect",()=>finish(true));socket.once("error",()=>finish(false));socket.once("timeout",()=>finish(false));socket.connect(port,host)})}async function sweepPool(hosts,port,{timeoutMs,concurrency}){const reachable=[];let nextIndex=0;async function worker(){for(;;){const i=nextIndex++;if(i>=hosts.length)return;const host=hosts[i];if(await attemptConnect(host,port,timeoutMs)){reachable.push({index:i,host,port})}}}const workers=Array.from({length:Math.min(concurrency,hosts.length)},()=>worker());await Promise.all(workers);return reachable.sort((a,b)=>a.index-b.index).map(({host,port:p})=>({host,port:p}))}async function subnet(cidr,port=5555,options={}){const{timeoutMs=500,concurrency=32,maxHosts=1024}=options;if(!isValidPort(port)){throw new Error(`Invalid port: ${port}`)}if(!Number.isInteger(timeoutMs)||timeoutMs<=0){throw new Error(`Invalid timeoutMs: ${timeoutMs} (must be a positive integer)`)}if(!Number.isInteger(concurrency)||concurrency<=0){throw new Error(`Invalid concurrency: ${concurrency} (must be a positive integer)`)}if(!Number.isInteger(maxHosts)||maxHosts<=0){throw new Error(`Invalid maxHosts: ${maxHosts} (must be a positive integer)`)}const range=parseCidr(cidr);if(range.sweepCount>maxHosts){throw new Error(`CIDR ${cidr} has ${range.sweepCount} sweepable host(s), exceeding maxHosts (${maxHosts}). Use a narrower CIDR or raise maxHosts.`)}const hosts=[];for(let value=range.firstHost;value<=range.lastHost;value++){hosts.push(range.format(value))}self.log.debug(`discover.subnet: sweeping ${hosts.length} host(s) in ${cidr} on port ${port}`);return await sweepPool(hosts,port,{timeoutMs,concurrency})}function encodeDnsName(name){const labels=name.replace(/\.$/,"").split(".").filter(Boolean);const parts=labels.map(label=>{const labelBuf=Buffer.from(label,"utf8");if(labelBuf.length>63){throw new Error(`DNS label too long (max 63 bytes): "${label}"`)}return Buffer.concat([Buffer.from([labelBuf.length]),labelBuf])});const encoded=Buffer.concat([...parts,Buffer.from([0])]);if(encoded.length>255){throw new Error(`DNS name too long (max 255 bytes): "${name}"`)}return encoded}function decodeDnsName(buffer,offset){const labels=[];let pos=offset;let next=-1;let guard=0;for(;;){if(guard++>128)throw new Error("DNS name decoding exceeded compression-pointer guard");const len=buffer.readUInt8(pos);if(len===0){pos+=1;if(next===-1)next=pos;break}if((len&192)===192){const pointer=(len&63)<<8|buffer.readUInt8(pos+1);if(next===-1)next=pos+2;pos=pointer;continue}labels.push(buffer.toString("utf8",pos+1,pos+1+len));pos+=1+len}return{name:labels.join("."),next}}function readDnsRecord(buffer,offset){const{name,next:afterName}=decodeDnsName(buffer,offset);let pos=afterName;const type=buffer.readUInt16BE(pos);pos+=2;pos+=2;const ttl=buffer.readUInt32BE(pos);pos+=4;const rdlength=buffer.readUInt16BE(pos);pos+=2;const rdataStart=pos;const rdataEnd=pos+rdlength;let data;switch(type){case DNS_TYPE_PTR:{const ptr=decodeDnsName(buffer,rdataStart);data=ptr.next<=rdataEnd?{target:ptr.name}:null;break}case DNS_TYPE_SRV:{if(rdlength<6){data=null;break}const srv=decodeDnsName(buffer,rdataStart+6);data=srv.next<=rdataEnd?{priority:buffer.readUInt16BE(rdataStart),weight:buffer.readUInt16BE(rdataStart+2),port:buffer.readUInt16BE(rdataStart+4),target:srv.name}:null;break}case DNS_TYPE_TXT:{const txt=Object.create(null);let p=rdataStart;while(p<rdataEnd){const len=buffer.readUInt8(p);p+=1;if(len===0)continue;if(p+len>rdataEnd)break;const entry=buffer.toString("utf8",p,p+len);p+=len;const eq=entry.indexOf("=");if(eq===-1)txt[entry]=true;else txt[entry.slice(0,eq)]=entry.slice(eq+1)}data=txt;break}case DNS_TYPE_A:data=Array.from(buffer.subarray(rdataStart,rdataEnd)).join(".");break;case DNS_TYPE_AAAA:data=rdlength===16?bigIntToIpv6(buffer.readBigUInt64BE(rdataStart)<<64n|buffer.readBigUInt64BE(rdataStart+8)):null;break;default:data=buffer.subarray(rdataStart,rdataEnd)}return{name,type,ttl,data,next:rdataEnd}}function parseDnsMessage(buffer){const qdcount=buffer.readUInt16BE(4);const ancount=buffer.readUInt16BE(6);const nscount=buffer.readUInt16BE(8);const arcount=buffer.readUInt16BE(10);let offset=12;for(let i=0;i<qdcount;i++){const{next}=decodeDnsName(buffer,offset);offset=next+4}const records=[];for(let i=0;i<ancount+nscount+arcount;i++){const record=readDnsRecord(buffer,offset);records.push(record);offset=record.next}return records}function buildPtrQuery(serviceType){const header=Buffer.alloc(12);header.writeUInt16BE(1,4);const question=Buffer.alloc(4);question.writeUInt16BE(DNS_TYPE_PTR,0);question.writeUInt16BE(DNS_CLASS_IN,2);return Buffer.concat([header,encodeDnsName(serviceType),question])}function isMulticastAddress(address){const bare=address.split("%",1)[0];if(net.isIPv6(bare)){return ipv6ToBigInt(bare)>>120n===0xffn}const firstOctet=Number(bare.split(".",1)[0]);return Number.isInteger(firstOctet)&&firstOctet>=224&&firstOctet<=239}function addressRank(address,queryFamily){const isSix=net.isIPv6(address);const isLinkLocal=isSix?/^fe[89ab]/i.test(address):address.startsWith("169.254.");if(isLinkLocal)return 1;return(isSix?6:4)===queryFamily?3:2}function ingestDnsRecords(records,results,addresses,queryFamily){for(const record of records){if(record.type!==DNS_TYPE_A&&record.type!==DNS_TYPE_AAAA||typeof record.data!=="string"||net.isIP(record.data)===0){continue}const existing=addresses.get(record.name);if(!existing||addressRank(record.data,queryFamily)>=addressRank(existing,queryFamily)){addresses.set(record.name,record.data)}}for(const record of records){if(record.type!==DNS_TYPE_PTR||!record.data)continue;const instanceName=record.data.target;if(!results.has(instanceName)){results.set(instanceName,{name:instanceName,txt:Object.create(null)})}}for(const record of records){if(record.type===DNS_TYPE_SRV){if(!record.data)continue;const entry=results.get(record.name);if(!entry)continue;entry.port=record.data.port;entry._target=record.data.target;entry.host=addresses.get(record.data.target)||entry.host}else if(record.type===DNS_TYPE_TXT){const entry=results.get(record.name);if(!entry)continue;Object.assign(entry.txt,record.data)}}for(const entry of results.values()){if(!entry.host&&entry._target&&addresses.has(entry._target)){entry.host=addresses.get(entry._target)}}}async function mdns(options={}){const{serviceType="_adb-tls-connect._tcp.local",address,family,port=5353,timeoutMs=3e3,multicastInterface}=options;if(family!==void 0&&family!==4&&family!==6){throw new Error(`Invalid family: ${family} (must be 4 or 6)`)}if(!isValidPort(port)){throw new Error(`Invalid port: ${port}`)}if(!Number.isInteger(timeoutMs)||timeoutMs<=0){throw new Error(`Invalid timeoutMs: ${timeoutMs} (must be a positive integer)`)}if(address!==void 0&&typeof address!=="string"){throw new Error(`Invalid address: ${address} (must be a string)`)}if(multicastInterface!==void 0&&typeof multicastInterface!=="string"){throw new Error(`Invalid multicastInterface: ${multicastInterface} (must be a string)`)}const detectedFamily=typeof address==="string"?net.isIP(address):0;if(family!==void 0&&detectedFamily!==0&&detectedFamily!==family){throw new Error(`Invalid address: ${address} (not an IPv${family} address)`)}const queryFamily=family??(detectedFamily===6?6:4);const target=address??(queryFamily===6?"ff02::fb":"224.0.0.251");const query=buildPtrQuery(serviceType);const isMulticast=isMulticastAddress(target);const socket=dgram.createSocket({type:queryFamily===6?"udp6":"udp4",reuseAddr:true});const results=new Map;const addresses=new Map;let settled=false;return new Promise((resolve,reject)=>{const finish=(fn,value)=>{if(settled)return;settled=true;clearTimeout(timer);socket.removeAllListeners();socket.close();fn(value)};socket.on("error",error=>finish(reject,error));socket.on("message",message=>{try{ingestDnsRecords(parseDnsMessage(message),results,addresses,queryFamily)}catch(error){self.log.debug(`discover.mdns: ignoring unparseable response - ${error.message}`)}});const timer=setTimeout(()=>{finish(resolve,Array.from(results.values()).filter(entry=>entry.host&&entry.port).map(entry=>({name:entry.name,host:entry.host,port:entry.port,txt:entry.txt})))},timeoutMs);socket.bind(isMulticast?port:0,()=>{if(isMulticast){try{if(multicastInterface)socket.setMulticastInterface(multicastInterface);socket.addMembership(target,multicastInterface)}catch(error){self.log.debug(`discover.mdns: couldn't join multicast group ${target} - ${error.message}`)}}try{socket.setMulticastTTL(255)}catch(error){self.log.debug(`discover.mdns: couldn't set multicast TTL - ${error.message}`)}self.log.debug(`discover.mdns: querying ${serviceType} via ${target}:${port}`);socket.send(query,port,target,error=>{if(error)finish(reject,error)})})})}export{mdns,subnet};
@@ -14,4 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import{self}from"@cldmv/slothlet/runtime";import{parseListing,quoteShellArg}from"./utils.mjs";import{readFile,writeFile}from"node:fs/promises";function assertValidMode(mode){if(!Number.isInteger(mode)||mode<0||mode>4095){throw new Error(`Invalid mode: ${mode} (must be an integer between 0 and 0o7777)`)}return mode}const SYNC_ID_SEND="SEND";const SYNC_ID_RECV="RECV";const SYNC_ID_LIST="LIST";const SYNC_ID_DENT="DENT";const SYNC_ID_DATA="DATA";const SYNC_ID_DONE="DONE";const SYNC_ID_OKAY="OKAY";const SYNC_ID_FAIL="FAIL";const SYNC_ID_QUIT="QUIT";const SYNC_DATA_MAX=64*1024;const SYNC_DENT_HEADER_SIZE=20;const S_IFMT=61440;const S_IFDIR=16384;const S_IFREG=32768;const S_IFLNK=40960;function buildSyncFrame(id,valueOrPayload){const payload=Buffer.isBuffer(valueOrPayload)?valueOrPayload:Buffer.alloc(0);const value=Buffer.isBuffer(valueOrPayload)?valueOrPayload.length:valueOrPayload;const header=Buffer.alloc(8);header.write(id,0,4,"ascii");header.writeUInt32LE(value>>>0,4);return Buffer.concat([header,payload])}function createSyncFrameReader(stream){let buffer=Buffer.alloc(0);const pending=[];let waiter=null;function drain(){while(buffer.length>=8){const id=buffer.toString("ascii",0,4);const value=buffer.readUInt32LE(4);if(buffer.length<8+value)return;const payload=Buffer.from(buffer.subarray(8,8+value));buffer=buffer.subarray(8+value);pending.push({id,value,payload})}if(pending.length>0&&waiter){const resolve=waiter;waiter=null;resolve()}}stream.on("data",chunk=>{buffer=Buffer.concat([buffer,Buffer.isBuffer(chunk)?chunk:Buffer.from(chunk)]);drain()});return{async next(){while(pending.length===0){await new Promise(resolve=>{waiter=resolve})}return pending.shift()}}}function createListFrameReader(stream){let buffer=Buffer.alloc(0);const pending=[];let waiter=null;let endError=null;function drain(){for(;;){if(buffer.length<4)break;const id=buffer.toString("ascii",0,4);if(id===SYNC_ID_DENT){if(buffer.length<SYNC_DENT_HEADER_SIZE)break;const mode=buffer.readUInt32LE(4);const size=buffer.readUInt32LE(8);const mtime=buffer.readUInt32LE(12);const namelen=buffer.readUInt32LE(16);if(buffer.length<SYNC_DENT_HEADER_SIZE+namelen)break;const name=buffer.toString("utf8",SYNC_DENT_HEADER_SIZE,SYNC_DENT_HEADER_SIZE+namelen);buffer=buffer.subarray(SYNC_DENT_HEADER_SIZE+namelen);pending.push({id,mode,size,mtime,name});continue}if(buffer.length<8)break;const value=buffer.readUInt32LE(4);if(buffer.length<8+value)break;const payload=Buffer.from(buffer.subarray(8,8+value));buffer=buffer.subarray(8+value);pending.push({id,value,payload})}if(pending.length>0&&waiter){const resolve=waiter.resolve;waiter=null;resolve()}}function endWith(error){if(endError)return;endError=error||new Error("Sync stream ended before a DONE/FAIL frame arrived");if(waiter){const reject=waiter.reject;waiter=null;reject(endError)}}stream.on("data",chunk=>{buffer=Buffer.concat([buffer,Buffer.isBuffer(chunk)?chunk:Buffer.from(chunk)]);drain()});stream.on("close",()=>endWith());stream.on("error",error=>endWith(error));return{async next(){while(pending.length===0){if(endError)throw endError;await new Promise((resolve,reject)=>{waiter={resolve,reject}})}return pending.shift()}}}async function quitSyncStream(stream){try{await stream.write(buildSyncFrame(SYNC_ID_QUIT,Buffer.alloc(0)))}catch{}stream.close()}async function push(___socket,streamManager,localPath,remotePath,options={}){const{onProgress,mode=420}=options;const data=await readFile(localPath);const stream=await streamManager.openStream("sync:");const reader=createSyncFrameReader(stream);try{const pathAndMode=Buffer.from(`${remotePath},${mode.toString(10)}`,"utf8");await stream.write(buildSyncFrame(SYNC_ID_SEND,pathAndMode));let offset=0;while(offset<data.length){const chunk=data.subarray(offset,Math.min(offset+SYNC_DATA_MAX,data.length));await stream.write(buildSyncFrame(SYNC_ID_DATA,chunk));offset+=chunk.length;if(onProgress)onProgress({bytesTransferred:offset,totalBytes:data.length})}await stream.write(buildSyncFrame(SYNC_ID_DONE,Math.floor(Date.now()/1e3)));const frame=await reader.next();if(frame.id===SYNC_ID_FAIL){throw new Error(`SYNC push failed: ${frame.payload.toString("utf8")}`)}if(frame.id!==SYNC_ID_OKAY){throw new Error(`Unexpected SYNC frame during push: ${frame.id}`)}}finally{await quitSyncStream(stream)}}async function pull(___socket,streamManager,remotePath,localPath,options={}){const{onProgress}=options;const stream=await streamManager.openStream("sync:");const reader=createSyncFrameReader(stream);try{await stream.write(buildSyncFrame(SYNC_ID_RECV,Buffer.from(remotePath,"utf8")));const chunks=[];let totalBytes=0;for(;;){const frame=await reader.next();if(frame.id===SYNC_ID_DATA){chunks.push(frame.payload);totalBytes+=frame.payload.length;if(onProgress)onProgress({bytesTransferred:totalBytes})}else if(frame.id===SYNC_ID_DONE){break}else if(frame.id===SYNC_ID_FAIL){throw new Error(`SYNC pull failed: ${frame.payload.toString("utf8")}`)}else{throw new Error(`Unexpected SYNC frame during pull: ${frame.id}`)}}await writeFile(localPath,Buffer.concat(chunks))}finally{await quitSyncStream(stream)}}async function listOverStream(stream,remotePath){const reader=createListFrameReader(stream);try{await stream.write(buildSyncFrame(SYNC_ID_LIST,Buffer.from(remotePath,"utf8")));const entries=[];for(;;){const frame=await reader.next();if(frame.id===SYNC_ID_DENT){entries.push({name:frame.name,size:frame.size,mtime:frame.mtime,mode:frame.mode,isDirectory:(frame.mode&S_IFMT)===S_IFDIR,isFile:(frame.mode&S_IFMT)===S_IFREG,isSymlink:(frame.mode&S_IFMT)===S_IFLNK})}else if(frame.id===SYNC_ID_DONE){break}else if(frame.id===SYNC_ID_FAIL){throw new Error(`SYNC list failed: ${frame.payload.toString("utf8")}`)}else{throw new Error(`Unexpected SYNC frame during list: ${frame.id}`)}}return entries}finally{await quitSyncStream(stream)}}async function listSync(___socket,streamManager,remotePath){const stream=await streamManager.openStream("sync:");return await listOverStream(stream,remotePath)}async function listShell(socket,streamManager,remotePath){const output=await self.shell.execute(socket,streamManager,`ls -la ${quoteShellArg(remotePath)}`);return parseListing(output)}async function list(socket,streamManager,remotePath){let stream;try{stream=await streamManager.openStream("sync:")}catch{return await listShell(socket,streamManager,remotePath)}return await listOverStream(stream,remotePath)}async function stat(socket,streamManager,remotePath){return await self.shell.execute(socket,streamManager,`stat ${quoteShellArg(remotePath)}`)}async function mkdir(socket,streamManager,remotePath,mode=493){assertValidMode(mode);const command=`mkdir -p ${quoteShellArg(remotePath)} && chmod ${mode.toString(8)} ${quoteShellArg(remotePath)}`;return await self.shell.execute(socket,streamManager,command)}async function remove(socket,streamManager,remotePath,recursive=false){const flag=recursive?"-rf":"-f";const command=`rm ${flag} ${quoteShellArg(remotePath)}`;return await self.shell.execute(socket,streamManager,command)}async function move(socket,streamManager,sourcePath,destPath){const command=`mv ${quoteShellArg(sourcePath)} ${quoteShellArg(destPath)}`;return await self.shell.execute(socket,streamManager,command)}async function copy(socket,streamManager,sourcePath,destPath,recursive=false){const flag=recursive?"-r":"";const command=`cp ${flag} ${quoteShellArg(sourcePath)} ${quoteShellArg(destPath)}`;return await self.shell.execute(socket,streamManager,command)}async function chmod(socket,streamManager,remotePath,mode,recursive=false){assertValidMode(mode);const flag=recursive?"-R":"";const command=`chmod ${flag} ${mode.toString(8)} ${quoteShellArg(remotePath)}`;return await self.shell.execute(socket,streamManager,command)}async function diskUsage(socket,streamManager,path="/"){const command=`df -h ${quoteShellArg(path)}`;return await self.shell.execute(socket,streamManager,command)}async function find(socket,streamManager,path,pattern,options={}){let command=`find ${quoteShellArg(path)}`;if(options.maxDepth!==void 0){if(!Number.isInteger(options.maxDepth)||options.maxDepth<0){throw new Error(`Invalid maxDepth: ${options.maxDepth} (must be a non-negative integer)`)}command+=` -maxdepth ${options.maxDepth}`}if(options.type!==void 0){if(!/^[bcdpfls]$/.test(options.type)){throw new Error(`Invalid type: ${options.type} (must be one of b, c, d, p, f, l, s)`)}command+=` -type ${options.type}`}command+=` -name ${quoteShellArg(pattern)}`;return await self.shell.execute(socket,streamManager,command)}export{chmod,copy,diskUsage,find,list,listShell,listSync,mkdir,move,pull,push,remove,stat};
17
+ import{self}from"@cldmv/slothlet/runtime";import{parseListing,quoteShellArg}from"./utils.mjs";import{readFile,writeFile,open,rename,unlink}from"node:fs/promises";import{brotliCompress,brotliDecompress}from"node:zlib";import{promisify}from"node:util";import path from"node:path";import{randomUUID}from"node:crypto";const brotliCompressAsync=promisify(brotliCompress);const brotliDecompressAsync=promisify(brotliDecompress);function assertValidMode(mode){if(!Number.isInteger(mode)||mode<0||mode>4095){throw new Error(`Invalid mode: ${mode} (must be an integer between 0 and 0o7777)`)}return mode}const SYNC_ID_SEND="SEND";const SYNC_ID_RECV="RECV";const SYNC_ID_LIST="LIST";const SYNC_ID_DENT="DENT";const SYNC_ID_DATA="DATA";const SYNC_ID_DONE="DONE";const SYNC_ID_OKAY="OKAY";const SYNC_ID_FAIL="FAIL";const SYNC_ID_QUIT="QUIT";const SYNC_DATA_MAX=64*1024;const SYNC_DENT_HEADER_SIZE=20;const SYNC_ID_SEND_V2="SND2";const SYNC_ID_RECV_V2="RCV2";const SYNC_ID_STAT_V2="STA2";const SYNC_ID_LIST_V2="LIS2";const SYNC_ID_DENT_V2="DNT2";const SYNC_FLAG_NONE=0;const SYNC_FLAG_BROTLI=1;const SYNC_BROTLI_INPUT_MAX=48*1024;const SYNC_SEND_V2_SETUP_SIZE=12;const SYNC_RECV_V2_SETUP_SIZE=8;const SYNC_STAT_V2_SIZE=72;const SYNC_DENT_V2_TAIL_SIZE=72;const SYNC_MAX_NAME_LEN=4096;const SYNC_BROTLI_OUTPUT_MAX=SYNC_DATA_MAX;const S_IFMT=61440;const S_IFDIR=16384;const S_IFREG=32768;const S_IFLNK=40960;function buildSyncFrame(id,valueOrPayload){const payload=Buffer.isBuffer(valueOrPayload)?valueOrPayload:Buffer.alloc(0);const value=Buffer.isBuffer(valueOrPayload)?valueOrPayload.length:valueOrPayload;const header=Buffer.alloc(8);header.write(id,0,4,"ascii");header.writeUInt32LE(value>>>0,4);return Buffer.concat([header,payload])}function createSyncFrameReader(stream){let buffer=Buffer.alloc(0);const pending=[];let waiter=null;let endError=null;function drain(){while(buffer.length>=8){const id=buffer.toString("ascii",0,4);const value=buffer.readUInt32LE(4);if(buffer.length<8+value)return;const payload=Buffer.from(buffer.subarray(8,8+value));buffer=buffer.subarray(8+value);pending.push({id,value,payload})}if(pending.length>0&&waiter){const resolve=waiter.resolve;waiter=null;resolve()}}function endWith(error){if(endError)return;endError=error||new Error("Sync stream ended before a terminal frame arrived");if(waiter){const reject=waiter.reject;waiter=null;reject(endError)}}stream.on("data",chunk=>{buffer=Buffer.concat([buffer,Buffer.isBuffer(chunk)?chunk:Buffer.from(chunk)]);drain()});stream.on("close",()=>endWith());stream.on("error",error=>endWith(error));return{async next(){while(pending.length===0){if(endError)throw endError;await new Promise((resolve,reject)=>{waiter={resolve,reject}})}return pending.shift()}}}function createListFrameReader(stream){let buffer=Buffer.alloc(0);const pending=[];let waiter=null;let endError=null;function drain(){for(;;){if(buffer.length<4)break;const id=buffer.toString("ascii",0,4);if(id===SYNC_ID_DENT){if(buffer.length<SYNC_DENT_HEADER_SIZE)break;const mode=buffer.readUInt32LE(4);const size=buffer.readUInt32LE(8);const mtime=buffer.readUInt32LE(12);const namelen=buffer.readUInt32LE(16);if(buffer.length<SYNC_DENT_HEADER_SIZE+namelen)break;const name=buffer.toString("utf8",SYNC_DENT_HEADER_SIZE,SYNC_DENT_HEADER_SIZE+namelen);buffer=buffer.subarray(SYNC_DENT_HEADER_SIZE+namelen);pending.push({id,mode,size,mtime,name});continue}if(buffer.length<8)break;const value=buffer.readUInt32LE(4);if(buffer.length<8+value)break;const payload=Buffer.from(buffer.subarray(8,8+value));buffer=buffer.subarray(8+value);pending.push({id,value,payload})}if(pending.length>0&&waiter){const resolve=waiter.resolve;waiter=null;resolve()}}function endWith(error){if(endError)return;endError=error||new Error("Sync stream ended before a DONE/FAIL frame arrived");if(waiter){const reject=waiter.reject;waiter=null;reject(endError)}}stream.on("data",chunk=>{buffer=Buffer.concat([buffer,Buffer.isBuffer(chunk)?chunk:Buffer.from(chunk)]);drain()});stream.on("close",()=>endWith());stream.on("error",error=>endWith(error));return{async next(){while(pending.length===0){if(endError)throw endError;await new Promise((resolve,reject)=>{waiter={resolve,reject}})}return pending.shift()}}}function createRawByteReader(stream){let buffer=Buffer.alloc(0);const waiters=[];let endError=null;function drain(){while(waiters.length>0&&buffer.length>=waiters[0].size){const{size,resolve}=waiters.shift();resolve(Buffer.from(buffer.subarray(0,size)));buffer=buffer.subarray(size)}}function endWith(error){if(endError)return;endError=error||new Error("Sync stream ended before enough bytes arrived");while(waiters.length>0){waiters.shift().reject(endError)}}stream.on("data",chunk=>{buffer=Buffer.concat([buffer,Buffer.isBuffer(chunk)?chunk:Buffer.from(chunk)]);drain()});stream.on("close",()=>endWith());stream.on("error",error=>endWith(error));return{readBytes(size){if(endError&&buffer.length<size)return Promise.reject(endError);return new Promise((resolve,reject)=>{waiters.push({size,resolve,reject});drain()})}}}function parseStatV2Record(buf){return{id:buf.toString("ascii",0,4),error:buf.readUInt32LE(4),dev:buf.readBigUInt64LE(8),ino:buf.readBigUInt64LE(16),mode:buf.readUInt32LE(24),nlink:buf.readUInt32LE(28),uid:buf.readUInt32LE(32),gid:buf.readUInt32LE(36),size:buf.readBigUInt64LE(40),atime:buf.readBigInt64LE(48),mtime:buf.readBigInt64LE(56),ctime:buf.readBigInt64LE(64)}}function parseDentV2Tail(buf){return{error:buf.readUInt32LE(0),dev:buf.readBigUInt64LE(4),ino:buf.readBigUInt64LE(12),mode:buf.readUInt32LE(20),nlink:buf.readUInt32LE(24),uid:buf.readUInt32LE(28),gid:buf.readUInt32LE(32),size:buf.readBigUInt64LE(36),atime:buf.readBigInt64LE(44),mtime:buf.readBigInt64LE(52),ctime:buf.readBigInt64LE(60),namelen:buf.readUInt32LE(68)}}function createListV2FrameReader(stream){const raw=createRawByteReader(stream);return{async next(){const idBuf=await raw.readBytes(4);const id=idBuf.toString("ascii");if(id===SYNC_ID_DENT_V2){const tail=parseDentV2Tail(await raw.readBytes(SYNC_DENT_V2_TAIL_SIZE));if(tail.namelen>SYNC_MAX_NAME_LEN){throw new Error(`list_v2 entry name length ${tail.namelen} exceeds the maximum of ${SYNC_MAX_NAME_LEN}`)}const name=(await raw.readBytes(tail.namelen)).toString("utf8");return{id,...tail,name}}if(id===SYNC_ID_DONE){await raw.readBytes(4);return{id}}if(id===SYNC_ID_FAIL){const value=(await raw.readBytes(4)).readUInt32LE(0);if(value>SYNC_DATA_MAX){throw new Error(`list_v2 FAIL payload length ${value} exceeds the maximum of ${SYNC_DATA_MAX}`)}const payload=await raw.readBytes(value);return{id,payload}}throw new Error(`Unexpected SYNC frame during list_v2: ${id}`)}}}async function quitSyncStream(stream){try{await stream.write(buildSyncFrame(SYNC_ID_QUIT,Buffer.alloc(0)))}catch{}stream.close()}async function writeFully(fileHandle,buffer){let offset=0;while(offset<buffer.length){const{bytesWritten}=await fileHandle.write(buffer,offset,buffer.length-offset);if(bytesWritten===0){throw new Error("fileHandle.write() returned 0 bytes written - refusing to loop forever")}offset+=bytesWritten}}async function push(___socket,streamManager,localPath,remotePath,options={}){const{onProgress,mode=420}=options;const data=await readFile(localPath);const stream=await streamManager.openStream("sync:");const reader=createSyncFrameReader(stream);try{const pathAndMode=Buffer.from(`${remotePath},${mode.toString(10)}`,"utf8");await stream.write(buildSyncFrame(SYNC_ID_SEND,pathAndMode));let offset=0;while(offset<data.length){const chunk=data.subarray(offset,Math.min(offset+SYNC_DATA_MAX,data.length));await stream.write(buildSyncFrame(SYNC_ID_DATA,chunk));offset+=chunk.length;if(onProgress)onProgress({bytesTransferred:offset,totalBytes:data.length})}await stream.write(buildSyncFrame(SYNC_ID_DONE,Math.floor(Date.now()/1e3)));const frame=await reader.next();if(frame.id===SYNC_ID_FAIL){throw new Error(`SYNC push failed: ${frame.payload.toString("utf8")}`)}if(frame.id!==SYNC_ID_OKAY){throw new Error(`Unexpected SYNC frame during push: ${frame.id}`)}}finally{await quitSyncStream(stream)}}async function pushV2(___socket,streamManager,localPath,remotePath,options={}){const{onProgress,mode=420,compression="none"}=options;assertValidMode(mode);if(compression!=="none"&&compression!=="brotli"){throw new Error(`Invalid compression: ${compression} (must be "none" or "brotli")`)}const flag=compression==="brotli"?SYNC_FLAG_BROTLI:SYNC_FLAG_NONE;const fileHandle=await open(localPath,"r");try{const{size:totalBytes}=await fileHandle.stat();const stream=await streamManager.openStream("sync:");const reader=createSyncFrameReader(stream);try{await stream.write(buildSyncFrame(SYNC_ID_SEND_V2,Buffer.from(remotePath,"utf8")));const setup=Buffer.alloc(SYNC_SEND_V2_SETUP_SIZE);setup.write(SYNC_ID_SEND_V2,0,4,"ascii");setup.writeUInt32LE(mode>>>0,4);setup.writeUInt32LE(flag,8);await stream.write(setup);const inputChunkMax=flag===SYNC_FLAG_BROTLI?SYNC_BROTLI_INPUT_MAX:SYNC_DATA_MAX;let bytesTransferred=0;for(;;){const buffer=Buffer.alloc(inputChunkMax);const{bytesRead}=await fileHandle.read(buffer,0,inputChunkMax,null);if(bytesRead===0)break;const chunk=bytesRead===inputChunkMax?buffer:buffer.subarray(0,bytesRead);const wireChunk=flag===SYNC_FLAG_BROTLI?await brotliCompressAsync(chunk):chunk;if(wireChunk.length>SYNC_DATA_MAX){throw new Error(`Compressed SYNC DATA chunk exceeds the protocol ceiling: ${wireChunk.length} bytes (max ${SYNC_DATA_MAX})`)}await stream.write(buildSyncFrame(SYNC_ID_DATA,wireChunk));bytesTransferred+=bytesRead;if(onProgress)onProgress({bytesTransferred,totalBytes})}await stream.write(buildSyncFrame(SYNC_ID_DONE,Math.floor(Date.now()/1e3)));const frame=await reader.next();if(frame.id===SYNC_ID_FAIL){throw new Error(`SYNC send_v2 failed: ${frame.payload.toString("utf8")}`)}if(frame.id!==SYNC_ID_OKAY){throw new Error(`Unexpected SYNC frame during send_v2: ${frame.id}`)}}finally{await quitSyncStream(stream)}}finally{await fileHandle.close()}}async function pull(___socket,streamManager,remotePath,localPath,options={}){const{onProgress}=options;const stream=await streamManager.openStream("sync:");const reader=createSyncFrameReader(stream);try{await stream.write(buildSyncFrame(SYNC_ID_RECV,Buffer.from(remotePath,"utf8")));const chunks=[];let totalBytes=0;for(;;){const frame=await reader.next();if(frame.id===SYNC_ID_DATA){chunks.push(frame.payload);totalBytes+=frame.payload.length;if(onProgress)onProgress({bytesTransferred:totalBytes})}else if(frame.id===SYNC_ID_DONE){break}else if(frame.id===SYNC_ID_FAIL){throw new Error(`SYNC pull failed: ${frame.payload.toString("utf8")}`)}else{throw new Error(`Unexpected SYNC frame during pull: ${frame.id}`)}}await writeFile(localPath,Buffer.concat(chunks))}finally{await quitSyncStream(stream)}}async function pullV2(___socket,streamManager,remotePath,localPath,options={}){const{onProgress,compression="none"}=options;if(compression!=="none"&&compression!=="brotli"){throw new Error(`Invalid compression: ${compression} (must be "none" or "brotli")`)}const flag=compression==="brotli"?SYNC_FLAG_BROTLI:SYNC_FLAG_NONE;const stream=await streamManager.openStream("sync:");const reader=createSyncFrameReader(stream);try{await stream.write(buildSyncFrame(SYNC_ID_RECV_V2,Buffer.from(remotePath,"utf8")));const setup=Buffer.alloc(SYNC_RECV_V2_SETUP_SIZE);setup.write(SYNC_ID_RECV_V2,0,4,"ascii");setup.writeUInt32LE(flag,4);await stream.write(setup);const tempPath=path.join(path.dirname(localPath),`.${path.basename(localPath)}.${randomUUID()}.part`);try{const fileHandle=await open(tempPath,"w");try{let bytesTransferred=0;for(;;){const frame=await reader.next();if(frame.id===SYNC_ID_DATA){let chunk=frame.payload;if(flag===SYNC_FLAG_BROTLI){try{chunk=await brotliDecompressAsync(frame.payload,{maxOutputLength:SYNC_BROTLI_OUTPUT_MAX})}catch(decompressError){if(decompressError.code==="ERR_BUFFER_TOO_LARGE"){throw new Error(`recv_v2 brotli chunk decompressed past the ${SYNC_BROTLI_OUTPUT_MAX}-byte cap - rejecting as a likely decompression bomb`,{cause:decompressError})}throw decompressError}}await writeFully(fileHandle,chunk);bytesTransferred+=frame.payload.length;if(onProgress)onProgress({bytesTransferred})}else if(frame.id===SYNC_ID_DONE){break}else if(frame.id===SYNC_ID_FAIL){throw new Error(`SYNC recv_v2 failed: ${frame.payload.toString("utf8")}`)}else{throw new Error(`Unexpected SYNC frame during recv_v2: ${frame.id}`)}}}finally{await fileHandle.close()}await rename(tempPath,localPath)}catch(error){await unlink(tempPath).catch(()=>{});throw error}}finally{await quitSyncStream(stream)}}async function listOverStream(stream,remotePath){const reader=createListFrameReader(stream);try{await stream.write(buildSyncFrame(SYNC_ID_LIST,Buffer.from(remotePath,"utf8")));const entries=[];for(;;){const frame=await reader.next();if(frame.id===SYNC_ID_DENT){entries.push({name:frame.name,size:frame.size,mtime:frame.mtime,mode:frame.mode,isDirectory:(frame.mode&S_IFMT)===S_IFDIR,isFile:(frame.mode&S_IFMT)===S_IFREG,isSymlink:(frame.mode&S_IFMT)===S_IFLNK})}else if(frame.id===SYNC_ID_DONE){break}else if(frame.id===SYNC_ID_FAIL){throw new Error(`SYNC list failed: ${frame.payload.toString("utf8")}`)}else{throw new Error(`Unexpected SYNC frame during list: ${frame.id}`)}}return entries}finally{await quitSyncStream(stream)}}async function listSync(___socket,streamManager,remotePath){const stream=await streamManager.openStream("sync:");return await listOverStream(stream,remotePath)}async function listV2(___socket,streamManager,remotePath){const stream=await streamManager.openStream("sync:");const reader=createListV2FrameReader(stream);try{await stream.write(buildSyncFrame(SYNC_ID_LIST_V2,Buffer.from(remotePath,"utf8")));const entries=[];for(;;){const frame=await reader.next();if(frame.id===SYNC_ID_DENT_V2){entries.push({name:frame.name,mode:frame.mode,size:frame.size,atime:frame.atime,mtime:frame.mtime,ctime:frame.ctime,uid:frame.uid,gid:frame.gid,nlink:frame.nlink,dev:frame.dev,ino:frame.ino,isDirectory:(frame.mode&S_IFMT)===S_IFDIR,isFile:(frame.mode&S_IFMT)===S_IFREG,isSymlink:(frame.mode&S_IFMT)===S_IFLNK})}else if(frame.id===SYNC_ID_DONE){break}else if(frame.id===SYNC_ID_FAIL){throw new Error(`SYNC list_v2 failed: ${frame.payload.toString("utf8")}`)}}return entries}finally{await quitSyncStream(stream)}}async function listShell(socket,streamManager,remotePath){const output=await self.shell.execute(socket,streamManager,`ls -la ${quoteShellArg(remotePath)}`);return parseListing(output)}async function list(socket,streamManager,remotePath){let stream;try{stream=await streamManager.openStream("sync:")}catch{return await listShell(socket,streamManager,remotePath)}return await listOverStream(stream,remotePath)}async function stat(socket,streamManager,remotePath){return await self.shell.execute(socket,streamManager,`stat ${quoteShellArg(remotePath)}`)}async function statV2(___socket,streamManager,remotePath){const stream=await streamManager.openStream("sync:");const raw=createRawByteReader(stream);try{await stream.write(buildSyncFrame(SYNC_ID_STAT_V2,Buffer.from(remotePath,"utf8")));const record=parseStatV2Record(await raw.readBytes(SYNC_STAT_V2_SIZE));if(record.id!==SYNC_ID_STAT_V2){throw new Error(`Unexpected SYNC frame during stat_v2: ${record.id}`)}if(record.error!==0){throw new Error(`SYNC stat_v2 failed for ${remotePath}: errno ${record.error}`)}return{mode:record.mode,size:record.size,atime:record.atime,mtime:record.mtime,ctime:record.ctime,uid:record.uid,gid:record.gid,nlink:record.nlink,dev:record.dev,ino:record.ino,isDirectory:(record.mode&S_IFMT)===S_IFDIR,isFile:(record.mode&S_IFMT)===S_IFREG,isSymlink:(record.mode&S_IFMT)===S_IFLNK}}finally{await quitSyncStream(stream)}}async function mkdir(socket,streamManager,remotePath,mode=493){assertValidMode(mode);const command=`mkdir -p ${quoteShellArg(remotePath)} && chmod ${mode.toString(8)} ${quoteShellArg(remotePath)}`;return await self.shell.execute(socket,streamManager,command)}async function remove(socket,streamManager,remotePath,recursive=false){const flag=recursive?"-rf":"-f";const command=`rm ${flag} ${quoteShellArg(remotePath)}`;return await self.shell.execute(socket,streamManager,command)}async function move(socket,streamManager,sourcePath,destPath){const command=`mv ${quoteShellArg(sourcePath)} ${quoteShellArg(destPath)}`;return await self.shell.execute(socket,streamManager,command)}async function copy(socket,streamManager,sourcePath,destPath,recursive=false){const flag=recursive?"-r":"";const command=`cp ${flag} ${quoteShellArg(sourcePath)} ${quoteShellArg(destPath)}`;return await self.shell.execute(socket,streamManager,command)}async function chmod(socket,streamManager,remotePath,mode,recursive=false){assertValidMode(mode);const flag=recursive?"-R":"";const command=`chmod ${flag} ${mode.toString(8)} ${quoteShellArg(remotePath)}`;return await self.shell.execute(socket,streamManager,command)}async function diskUsage(socket,streamManager,path2="/"){const command=`df -h ${quoteShellArg(path2)}`;return await self.shell.execute(socket,streamManager,command)}async function find(socket,streamManager,path2,pattern,options={}){let command=`find ${quoteShellArg(path2)}`;if(options.maxDepth!==void 0){if(!Number.isInteger(options.maxDepth)||options.maxDepth<0){throw new Error(`Invalid maxDepth: ${options.maxDepth} (must be a non-negative integer)`)}command+=` -maxdepth ${options.maxDepth}`}if(options.type!==void 0){if(!/^[bcdpfls]$/.test(options.type)){throw new Error(`Invalid type: ${options.type} (must be one of b, c, d, p, f, l, s)`)}command+=` -type ${options.type}`}command+=` -name ${quoteShellArg(pattern)}`;return await self.shell.execute(socket,streamManager,command)}export{chmod,copy,diskUsage,find,list,listShell,listSync,listV2,mkdir,move,pull,pullV2,push,pushV2,remove,stat,statV2};
@@ -14,4 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import{self}from"@cldmv/slothlet/runtime";import path from"node:path";async function classic(socket,streamManager,localPath,options={}){const{flags=[],remoteDir="/data/local/tmp",onProgress}=options;const remotePath=path.posix.join(remoteDir,path.basename(localPath));try{await self.files.push(socket,streamManager,localPath,remotePath,{onProgress});return await self.shell.commands.installApk(socket,streamManager,remotePath,flags)}finally{await self.files.remove(socket,streamManager,remotePath).catch(()=>{})}}export{classic};
17
+ import{self}from"@cldmv/slothlet/runtime";import path from"node:path";import{open}from"node:fs/promises";import{assertValidFlags}from"./utils.mjs";const EXEC_WRITE_CHUNK=64*1024;async function classic(socket,streamManager,localPath,options={}){const{flags=[],remoteDir="/data/local/tmp",onProgress}=options;const remotePath=path.posix.join(remoteDir,path.basename(localPath));try{await self.files.push(socket,streamManager,localPath,remotePath,{onProgress});return await self.shell.commands.installApk(socket,streamManager,remotePath,flags)}finally{await self.files.remove(socket,streamManager,remotePath).catch(()=>{})}}async function streaming(___socket,streamManager,localPath,options={}){const{flags=[],onProgress}=options;assertValidFlags(flags);const fileHandle=await open(localPath,"r");try{const{size:totalBytes}=await fileHandle.stat();const flagsStr=flags.length>0?` ${flags.join(" ")}`:"";const destination=`exec:cmd package install -S ${totalBytes}${flagsStr}`;const stream=await streamManager.openStream(destination);try{const outputChunks=[];let stopped=false;const closed=new Promise((resolve,reject)=>{stream.on("data",chunk=>{outputChunks.push(Buffer.isBuffer(chunk)?chunk:Buffer.from(chunk))});stream.once("close",()=>{stopped=true;resolve()});stream.once("error",error=>{stopped=true;reject(error)})});closed.catch(()=>{});let bytesTransferred=0;while(!stopped){const buffer=Buffer.alloc(EXEC_WRITE_CHUNK);const{bytesRead}=await fileHandle.read(buffer,0,EXEC_WRITE_CHUNK,null);if(bytesRead===0)break;if(stopped)break;await stream.write(bytesRead===EXEC_WRITE_CHUNK?buffer:buffer.subarray(0,bytesRead));bytesTransferred+=bytesRead;if(onProgress)onProgress({bytesTransferred,totalBytes})}await closed;if(bytesTransferred<totalBytes){throw new Error(`Exec stream closed before the full APK was sent (${bytesTransferred} of ${totalBytes} bytes transferred)`)}return Buffer.concat(outputChunks).toString("utf8")}finally{stream.close()}}finally{await fileHandle.close()}}export{classic,streaming};
@@ -0,0 +1,17 @@
1
+ /*
2
+ Copyright 2026 CLDMV/Shinrai
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import tls from"node:tls";import crypto from"node:crypto";import fs from"node:fs";import path from"node:path";import os from"node:os";import{self}from"@cldmv/slothlet/runtime";import{ed25519}from"@noble/curves/ed25519.js";import selfsigned from"selfsigned";const Point=ed25519.Point;const Fn=Point.Fn;const M_POINT=Point.fromHex("5ada7e4bf6ddd9adb6626d32131c6b5c51a1e347a3478f53cfcf441b88eed12e");const N_POINT=Point.fromHex("10e3df0ae37d8e7a99b5fe74b44672103dbddcbd06af680d71329a11693bc778");const CLIENT_NAME=Buffer.from("adb pair client","utf8");const SERVER_NAME=Buffer.from("adb pair server","utf8");function randomScalar(){return Fn.create(bytesToBigIntLE(crypto.randomBytes(64)))}function bytesToBigIntLE(bytes){let result=0n;for(let i=bytes.length-1;i>=0;i--){result=result<<8n|BigInt(bytes[i])}return result}function hashPassword(password){return crypto.createHash("sha512").update(password).digest()}function passwordToScalar(passwordHash){return Fn.create(bytesToBigIntLE(passwordHash))}function generateSpakeMessage(ephemeralScalar,passwordScalar){const ephemeralPublic=Point.BASE.multiply(ephemeralScalar);const mask=M_POINT.multiply(passwordScalar);return Buffer.from(ephemeralPublic.add(mask).toBytes())}function computeSharedSecret(ephemeralScalar,passwordScalar,theirMessage){const theirMasked=Point.fromBytes(theirMessage);const theirMask=N_POINT.multiply(passwordScalar);const theirEphemeralPublic=theirMasked.subtract(theirMask);const shared=theirEphemeralPublic.multiply(ephemeralScalar);return Buffer.from(shared.toBytes())}function updateLengthPrefixed(hash,value){const len=Buffer.alloc(8);len.writeBigUInt64LE(BigInt(value.length));hash.update(len);hash.update(value)}function deriveSessionKey({clientMsg,serverMsg,dhShared,passwordHash},keyLength){const hash=crypto.createHash("sha512");updateLengthPrefixed(hash,CLIENT_NAME);updateLengthPrefixed(hash,SERVER_NAME);updateLengthPrefixed(hash,clientMsg);updateLengthPrefixed(hash,serverMsg);updateLengthPrefixed(hash,dhShared);updateLengthPrefixed(hash,passwordHash);return hash.digest().subarray(0,keyLength)}const PAIRING_PACKET_VERSION=1;const PACKET_TYPE_SPAKE2_MSG=0;const PACKET_TYPE_PEER_INFO=1;function encodePairingPacket(type,payload){const header=Buffer.alloc(6);header.writeUInt8(PAIRING_PACKET_VERSION,0);header.writeUInt8(type,1);header.writeUInt32BE(payload.length,2);return Buffer.concat([header,payload])}const MAX_PACKET_PAYLOAD=16*1024;function createPacketReader(){let buffered=Buffer.alloc(0);return{push(chunk){buffered=Buffer.concat([buffered,chunk]);const packets=[];for(;;){if(buffered.length<6)break;const version=buffered.readUInt8(0);if(version!==PAIRING_PACKET_VERSION){throw new Error(`Unsupported pairing packet version: ${version} (expected ${PAIRING_PACKET_VERSION})`)}const payloadLength=buffered.readUInt32BE(2);if(payloadLength>MAX_PACKET_PAYLOAD){throw new Error(`Pairing packet payload too large: ${payloadLength} bytes (max ${MAX_PACKET_PAYLOAD})`)}if(buffered.length<6+payloadLength)break;packets.push({version,type:buffered.readUInt8(1),payload:buffered.subarray(6,6+payloadLength)});buffered=buffered.subarray(6+payloadLength)}return packets}}}const PEER_INFO_TYPE_RSA_PUB_KEY=0;function encodePeerInfo(type,data){return Buffer.concat([Buffer.from([type]),data])}function decodePeerInfo(buf){if(buf.length<1){throw new Error("PeerInfo payload is empty (expected at least a 1-byte type)")}return{type:buf.readUInt8(0),data:buf.subarray(1)}}const AES_KEY_INFO=Buffer.from("adb pairing_auth aes-128-gcm key","utf8");function deriveAesKey(keyMaterial){return Buffer.from(crypto.hkdfSync("sha256",keyMaterial,Buffer.alloc(0),AES_KEY_INFO,16))}function createMessageCipher(keyMaterial){const key=deriveAesKey(keyMaterial);let encSequence=0n;let decSequence=0n;const nonceFor=sequence=>{const nonce=Buffer.alloc(12);nonce.writeBigUInt64LE(sequence,0);return nonce};return{encrypt(plaintext){const nonce=nonceFor(encSequence++);const cipher=crypto.createCipheriv("aes-128-gcm",key,nonce);const ciphertext=Buffer.concat([cipher.update(plaintext),cipher.final()]);return Buffer.concat([ciphertext,cipher.getAuthTag()])},decrypt(ciphertextAndTag){if(ciphertextAndTag.length<16){throw new Error(`Encrypted PeerInfo payload is too short to contain a 16-byte GCM tag: ${ciphertextAndTag.length} bytes`)}const nonce=nonceFor(decSequence++);const tag=ciphertextAndTag.subarray(ciphertextAndTag.length-16);const ciphertext=ciphertextAndTag.subarray(0,ciphertextAndTag.length-16);const decipher=crypto.createDecipheriv("aes-128-gcm",key,nonce);decipher.setAuthTag(tag);return Buffer.concat([decipher.update(ciphertext),decipher.final()])}}}function certMatchesKey(certPem,publicKeyPem){const certPublicKey=new crypto.X509Certificate(certPem).publicKey;const currentPublicKey=crypto.createPublicKey(publicKeyPem);return certPublicKey.export({type:"pkcs1",format:"der"}).equals(currentPublicKey.export({type:"pkcs1",format:"der"}))}async function getOrCreatePairingCert(keys,certPath){let cert;try{cert=fs.readFileSync(certPath,"utf8")}catch(error){if(error.code!=="ENOENT")throw error}if(cert!==void 0){let matches=false;try{matches=certMatchesKey(cert,keys.publicKey)}catch{}if(matches){return{cert,key:keys.privateKey}}}const pems=await selfsigned.generate(null,{keyPair:{publicKey:keys.publicKey,privateKey:keys.privateKey},days:3650});fs.writeFileSync(certPath,pems.cert);return{cert:pems.cert,key:keys.privateKey}}async function pair(host,port,pairingCode,options={}){const{keyDir,timeoutMs=1e4}=options;if(!Number.isInteger(timeoutMs)||timeoutMs<=0){throw new Error(`Invalid timeoutMs: ${timeoutMs} (must be a positive integer)`)}if(typeof pairingCode!=="string"||pairingCode.length===0){throw new Error("pairingCode must be a non-empty string")}const adbDir=keyDir||path.join(os.homedir(),".adb");const keys=self.auth.getKeys(adbDir);const certPath=path.join(adbDir,"adbkey.cert.pem");const{cert,key}=await getOrCreatePairingCert(keys,certPath);return new Promise((resolve,reject)=>{let settled=false;let socket;const finish=(fn,value)=>{if(settled)return;settled=true;clearTimeout(timer);if(socket){socket.removeAllListeners();socket.destroy()}fn(value)};const timer=setTimeout(()=>finish(reject,new Error("Pairing timed out")),timeoutMs);try{socket=tls.connect({host,port,cert,key,minVersion:"TLSv1.3",maxVersion:"TLSv1.3",rejectUnauthorized:false})}catch(error){finish(reject,error);return}const reader=createPacketReader();let stage="spake2";let ephemeralScalar;let passwordScalar;let passwordHash;let clientMsg;let cipher;socket.on("error",error=>finish(reject,error));socket.on("secureConnect",()=>{const exportedKeyMaterial=Buffer.from(socket.exportKeyingMaterial(64,"adb-label\0"));const password=Buffer.concat([Buffer.from(pairingCode,"utf8"),exportedKeyMaterial]);passwordHash=hashPassword(password);passwordScalar=passwordToScalar(passwordHash);ephemeralScalar=randomScalar();clientMsg=generateSpakeMessage(ephemeralScalar,passwordScalar);socket.write(encodePairingPacket(PACKET_TYPE_SPAKE2_MSG,clientMsg))});socket.on("data",chunk=>{try{for(const packet of reader.push(chunk)){if(stage==="spake2"){if(packet.type!==PACKET_TYPE_SPAKE2_MSG){throw new Error(`Expected SPAKE2_MSG, got packet type ${packet.type}`)}const serverMsg=packet.payload;const dhShared=computeSharedSecret(ephemeralScalar,passwordScalar,serverMsg);const keyMaterial=deriveSessionKey({clientMsg,serverMsg,dhShared,passwordHash},64);cipher=createMessageCipher(keyMaterial);const peerInfo=encodePeerInfo(PEER_INFO_TYPE_RSA_PUB_KEY,Buffer.from(keys.adbPublicKey,"utf8"));socket.write(encodePairingPacket(PACKET_TYPE_PEER_INFO,cipher.encrypt(peerInfo)));stage="peerInfo"}else if(stage==="peerInfo"){if(packet.type!==PACKET_TYPE_PEER_INFO){throw new Error(`Expected PEER_INFO, got packet type ${packet.type}`)}decodePeerInfo(cipher.decrypt(packet.payload));finish(resolve,{success:true})}}}catch(error){finish(reject,error)}})})}export{pair};
@@ -0,0 +1,17 @@
1
+ /*
2
+ Copyright 2026 CLDMV/Shinrai
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import net from"node:net";const MAX_PENDING_DEVICE_DATA=1024*1024;function assertOkayAck(ack,action){const id=ack.toString("ascii",0,4);if(id==="OKAY")return;if(id==="FAIL"){const lengthField=ack.toString("ascii",4,8);if(!/^[0-9a-fA-F]{4}$/.test(lengthField)){throw new Error(`Unexpected response to ${action}: ${ack.toString("utf8")}`)}const messageLength=parseInt(lengthField,16);const message=ack.subarray(8,8+messageLength).toString("utf8");throw new Error(`Failed to ${action}: ${message}`)}throw new Error(`Unexpected response to ${action}: ${ack.toString("utf8")}`)}async function start(___socket,streamManager,devicePort,hostPort,options={}){const{host="127.0.0.1",onError}=options;const destination=`tcp:${hostPort}`;const onRemoteOpen=(deviceStream,streamDestination)=>{if(streamDestination!==destination)return;const localSocket=net.connect(hostPort,host);let localSocketFailed=false;let localSocketConnected=false;const pendingDeviceData=[];let pendingDeviceDataBytes=0;const closeDeviceStream=()=>streamManager.closeStream(deviceStream.localId);deviceStream.on("data",data=>{if(localSocketFailed)return;if(localSocketConnected){localSocket.write(data);return}pendingDeviceDataBytes+=data.length;if(pendingDeviceDataBytes>MAX_PENDING_DEVICE_DATA){const error=new Error(`Local connect for reverse bridge tcp:${devicePort} -> tcp:${hostPort} stalled while buffering ${pendingDeviceDataBytes} bytes of device data (max ${MAX_PENDING_DEVICE_DATA})`);localSocketFailed=true;localSocket.destroy();closeDeviceStream();if(onError)onError(error,deviceStream);return}pendingDeviceData.push(data)});deviceStream.on("close",()=>{closeDeviceStream();if(localSocketConnected)localSocket.end();else localSocket.destroy()});deviceStream.on("error",error=>{closeDeviceStream();localSocket.destroy();if(onError)onError(error,deviceStream)});localSocket.on("error",error=>{localSocketFailed=true;localSocket.destroy();closeDeviceStream();if(onError)onError(error,deviceStream)});localSocket.on("connect",()=>{if(localSocketFailed||deviceStream.closed){localSocket.destroy();return}localSocketConnected=true;for(const data of pendingDeviceData)localSocket.write(data);pendingDeviceData.length=0;localSocket.on("data",data=>{deviceStream.write(data).catch(error=>{closeDeviceStream();localSocket.destroy();if(onError)onError(error,deviceStream)})});localSocket.on("close",()=>closeDeviceStream())})};streamManager.on("remoteOpen",onRemoteOpen);let registerStream;try{registerStream=await streamManager.openStream(`reverse:forward:tcp:${devicePort};tcp:${hostPort}`);const ack=await new Promise((resolve,reject)=>{registerStream.once("data",resolve);registerStream.once("error",reject);registerStream.once("close",()=>reject(new Error("reverse registration stream closed with no ack")))});assertOkayAck(ack,`register reverse tunnel tcp:${devicePort} -> tcp:${hostPort}`)}catch(error){streamManager.off("remoteOpen",onRemoteOpen);throw error}finally{if(registerStream)streamManager.closeStream(registerStream.localId)}return{devicePort,hostPort,async close(){streamManager.off("remoteOpen",onRemoteOpen);let killStream;try{killStream=await streamManager.openStream(`reverse:killforward:tcp:${devicePort}`);const ack=await new Promise((resolve,reject)=>{killStream.once("data",resolve);killStream.once("error",reject);killStream.once("close",()=>reject(new Error("reverse killforward stream closed with no ack")))});assertOkayAck(ack,`unregister reverse tunnel tcp:${devicePort}`)}catch{}finally{if(killStream)streamManager.closeStream(killStream.localId)}}}}export{start};
@@ -14,4 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import{self}from"@cldmv/slothlet/runtime";async function execute(socket,streamManager,command,options={}){const{timeout=3e4,encoding="utf8",deviceFeatures=[]}=options;return new Promise((resolve,reject)=>{try{let output=Buffer.alloc(0);let streamId=null;let commandTimeout;let commandCompleted=false;let protocolUsed;const supportsShellV2=deviceFeatures.includes("shell_v2");if(supportsShellV2){protocolUsed=`shell,v2:${command}`}else{protocolUsed=`shell:${command}`}if(self.config.get("debug")){self.log.debug(`Executing shell command: ${protocolUsed}`)}const destBuffer=Buffer.from(protocolUsed);const openPacket=Buffer.alloc(24+destBuffer.length);openPacket.writeUInt32LE(1313165391,0);openPacket.writeUInt32LE(12345,4);openPacket.writeUInt32LE(0,8);openPacket.writeUInt32LE(destBuffer.length,12);let checksum=0;for(let i=0;i<destBuffer.length;i++){checksum+=destBuffer[i]}openPacket.writeUInt32LE(checksum&4294967295,16);openPacket.writeUInt32LE(~1313165391>>>0,20);destBuffer.copy(openPacket,24);socket.write(openPacket);commandTimeout=setTimeout(()=>{if(!commandCompleted){commandCompleted=true;socket.removeAllListeners("data");reject(new Error(`Command timeout: ${command}`))}},timeout);let responseBuffer=Buffer.alloc(0);let originalHandlers=[];const existingHandlers=socket.listeners("data");existingHandlers.forEach(handler=>{socket.removeListener("data",handler);originalHandlers.push(handler)});const dataHandler=chunk=>{if(commandCompleted)return;responseBuffer=Buffer.concat([responseBuffer,chunk]);while(responseBuffer.length>=24){const cmd=responseBuffer.readUInt32LE(0);const arg0=responseBuffer.readUInt32LE(4);const arg1=responseBuffer.readUInt32LE(8);const dataLength=responseBuffer.readUInt32LE(12);if(responseBuffer.length<24+dataLength)break;const packetData=dataLength>0?responseBuffer.slice(24,24+dataLength):null;responseBuffer=responseBuffer.slice(24+dataLength);if(self.config.get("debug")){const commandName=cmd===1497451343?"OKAY":cmd===1163154007?"WRTE":cmd===1163086915?"CLSE":`0x${cmd.toString(16)}`;self.log.debug(`${self.config.get("debugArrowReceived")} ${commandName} arg0:${arg0} arg1:${arg1} len:${dataLength}`)}if(cmd===1497451343&&!streamId){streamId=arg1;if(self.config.get("debug")){self.log.debug(`Shell stream opened with ID: ${streamId}`)}}else if(cmd===1163154007&&arg1===12345){if(packetData){output=Buffer.concat([output,packetData]);if(self.config.get("debug")){self.log.debug(`Received ${packetData.length} bytes of output`)}}}else if(cmd===1163086915&&arg1===12345){if(self.config.get("debug")){self.log.debug("Shell stream closed by device")}commandCompleted=true;clearTimeout(commandTimeout);socket.removeListener("data",dataHandler);originalHandlers.forEach(handler=>{socket.on("data",handler)});resolve(output.toString(encoding));return}}};socket.on("data",dataHandler)}catch(error){reject(error)}})}function startStreaming(socket,streamManager,command,options={}){const{onData,onError,onEnd}=options;let stream=null;const control={stop(){if(stream){stream.close();stream=null}}};(async()=>{try{stream=await streamManager.openStream(`shell:${command}`);stream.on("data",data=>{if(onData)onData(data.toString())});stream.on("close",()=>{if(onEnd)onEnd()});stream.on("error",error=>{if(onError)onError(error)})}catch(error){if(onError)onError(error)}})();return control}function startInteractive(socket,streamManager,command,options={}){const{onData,onError,onEnd}=options;let stream=null;const control={async sendInput(input){if(stream){await stream.write(input)}},stop(){if(stream){stream.close();stream=null}}};(async()=>{try{stream=await streamManager.openStream(`shell:${command}`);stream.on("data",data=>{if(onData)onData(data.toString())});stream.on("close",()=>{if(onEnd)onEnd()});stream.on("error",error=>{if(onError)onError(error)})}catch(error){if(onError)onError(error)}})();return control}const commands={ls:async(socket,streamManager,path=".")=>{return await execute(socket,streamManager,`ls -la "${path}"`)},pwd:async(socket,streamManager)=>{return await execute(socket,streamManager,"pwd")},getprop:async(socket,streamManager,prop=null)=>{const cmd=prop?`getprop "${prop}"`:"getprop";return await execute(socket,streamManager,cmd)},getModel:async(socket,streamManager)=>{return await execute(socket,streamManager,"getprop ro.product.model")},getAndroidVersion:async(socket,streamManager)=>{return await execute(socket,streamManager,"getprop ro.build.version.release")},getBattery:async(socket,streamManager)=>{return await execute(socket,streamManager,"dumpsys battery")},screenshot:async(socket,streamManager,filename="/sdcard/screenshot.png")=>{return await execute(socket,streamManager,`screencap -p "${filename}"`)},logcat:(socket,streamManager,options={})=>{return startStreaming(socket,streamManager,"logcat",options)},top:(socket,streamManager,options={})=>{return startStreaming(socket,streamManager,"top -m 10",options)},keypress:async(socket,streamManager,key)=>{return await execute(socket,streamManager,`input keyevent ${key}`)},launchApp:async(socket,streamManager,packageName,activity="")=>{const activityArg=activity?`/${activity}`:"";return await execute(socket,streamManager,`am start -n ${packageName}${activityArg}`)},killApp:async(socket,streamManager,packageName)=>{return await execute(socket,streamManager,`am force-stop ${packageName}`)},installApk:async(socket,streamManager,apkPath,flags=[])=>{const flagsStr=flags.length>0?` ${flags.join(" ")}`:"";return await execute(socket,streamManager,`pm install${flagsStr} "${apkPath}"`)},uninstallApp:async(socket,streamManager,packageName)=>{return await execute(socket,streamManager,`pm uninstall ${packageName}`)}};export{commands,execute,startInteractive,startStreaming};
17
+ import{self}from"@cldmv/slothlet/runtime";import{quoteShellArg,assertValidFlags}from"./utils.mjs";async function execute(socket,streamManager,command,options={}){const{timeout=3e4,encoding="utf8",deviceFeatures=[]}=options;return new Promise((resolve,reject)=>{try{let output=Buffer.alloc(0);let streamId=null;let commandTimeout;let commandCompleted=false;let protocolUsed;const supportsShellV2=deviceFeatures.includes("shell_v2");if(supportsShellV2){protocolUsed=`shell,v2:${command}`}else{protocolUsed=`shell:${command}`}if(self.config.get("debug")){self.log.debug(`Executing shell command: ${protocolUsed}`)}const destBuffer=Buffer.from(protocolUsed);const openPacket=Buffer.alloc(24+destBuffer.length);openPacket.writeUInt32LE(1313165391,0);openPacket.writeUInt32LE(12345,4);openPacket.writeUInt32LE(0,8);openPacket.writeUInt32LE(destBuffer.length,12);let checksum=0;for(let i=0;i<destBuffer.length;i++){checksum+=destBuffer[i]}openPacket.writeUInt32LE(checksum&4294967295,16);openPacket.writeUInt32LE(~1313165391>>>0,20);destBuffer.copy(openPacket,24);socket.write(openPacket);commandTimeout=setTimeout(()=>{if(!commandCompleted){commandCompleted=true;socket.removeAllListeners("data");reject(new Error(`Command timeout: ${command}`))}},timeout);let responseBuffer=Buffer.alloc(0);let originalHandlers=[];const existingHandlers=socket.listeners("data");existingHandlers.forEach(handler=>{socket.removeListener("data",handler);originalHandlers.push(handler)});const dataHandler=chunk=>{if(commandCompleted)return;responseBuffer=Buffer.concat([responseBuffer,chunk]);while(responseBuffer.length>=24){const cmd=responseBuffer.readUInt32LE(0);const arg0=responseBuffer.readUInt32LE(4);const arg1=responseBuffer.readUInt32LE(8);const dataLength=responseBuffer.readUInt32LE(12);if(responseBuffer.length<24+dataLength)break;const packetData=dataLength>0?responseBuffer.slice(24,24+dataLength):null;responseBuffer=responseBuffer.slice(24+dataLength);if(self.config.get("debug")){const commandName=cmd===1497451343?"OKAY":cmd===1163154007?"WRTE":cmd===1163086915?"CLSE":`0x${cmd.toString(16)}`;self.log.debug(`${self.config.get("debugArrowReceived")} ${commandName} arg0:${arg0} arg1:${arg1} len:${dataLength}`)}if(cmd===1497451343&&!streamId){streamId=arg1;if(self.config.get("debug")){self.log.debug(`Shell stream opened with ID: ${streamId}`)}}else if(cmd===1163154007&&arg1===12345){if(packetData){output=Buffer.concat([output,packetData]);if(self.config.get("debug")){self.log.debug(`Received ${packetData.length} bytes of output`)}}}else if(cmd===1163086915&&arg1===12345){if(self.config.get("debug")){self.log.debug("Shell stream closed by device")}commandCompleted=true;clearTimeout(commandTimeout);socket.removeListener("data",dataHandler);originalHandlers.forEach(handler=>{socket.on("data",handler)});resolve(output.toString(encoding));return}}};socket.on("data",dataHandler)}catch(error){reject(error)}})}function startStreaming(socket,streamManager,command,options={}){const{onData,onError,onEnd}=options;let stream=null;const control={stop(){if(stream){stream.close();stream=null}}};(async()=>{try{stream=await streamManager.openStream(`shell:${command}`);stream.on("data",data=>{if(onData)onData(data.toString())});stream.on("close",()=>{if(onEnd)onEnd()});stream.on("error",error=>{if(onError)onError(error)})}catch(error){if(onError)onError(error)}})();return control}function startInteractive(socket,streamManager,command,options={}){const{onData,onError,onEnd}=options;let stream=null;const control={async sendInput(input){if(stream){await stream.write(input)}},stop(){if(stream){stream.close();stream=null}}};(async()=>{try{stream=await streamManager.openStream(`shell:${command}`);stream.on("data",data=>{if(onData)onData(data.toString())});stream.on("close",()=>{if(onEnd)onEnd()});stream.on("error",error=>{if(onError)onError(error)})}catch(error){if(onError)onError(error)}})();return control}const commands={ls:async(socket,streamManager,path=".")=>{return await execute(socket,streamManager,`ls -la ${quoteShellArg(path)}`)},pwd:async(socket,streamManager)=>{return await execute(socket,streamManager,"pwd")},getprop:async(socket,streamManager,prop=null)=>{const cmd=prop?`getprop ${quoteShellArg(prop)}`:"getprop";return await execute(socket,streamManager,cmd)},getModel:async(socket,streamManager)=>{return await execute(socket,streamManager,"getprop ro.product.model")},getAndroidVersion:async(socket,streamManager)=>{return await execute(socket,streamManager,"getprop ro.build.version.release")},getBattery:async(socket,streamManager)=>{return await execute(socket,streamManager,"dumpsys battery")},screenshot:async(socket,streamManager,filename="/sdcard/screenshot.png")=>{return await execute(socket,streamManager,`screencap -p ${quoteShellArg(filename)}`)},logcat:(socket,streamManager,options={})=>{return startStreaming(socket,streamManager,"logcat",options)},top:(socket,streamManager,options={})=>{return startStreaming(socket,streamManager,"top -m 10",options)},keypress:async(socket,streamManager,key)=>{return await execute(socket,streamManager,`input keyevent ${quoteShellArg(key)}`)},launchApp:async(socket,streamManager,packageName,activity="")=>{const target=activity?`${packageName}/${activity}`:packageName;return await execute(socket,streamManager,`am start -n ${quoteShellArg(target)}`)},killApp:async(socket,streamManager,packageName)=>{return await execute(socket,streamManager,`am force-stop ${quoteShellArg(packageName)}`)},installApk:async(socket,streamManager,apkPath,flags=[])=>{assertValidFlags(flags);const flagsStr=flags.length>0?` ${flags.map(quoteShellArg).join(" ")}`:"";return await execute(socket,streamManager,`pm install${flagsStr} ${quoteShellArg(apkPath)}`)},uninstallApp:async(socket,streamManager,packageName)=>{return await execute(socket,streamManager,`pm uninstall ${quoteShellArg(packageName)}`)}};export{commands,execute,startInteractive,startStreaming};
@@ -14,4 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import{self}from"@cldmv/slothlet/runtime";import{EventEmitter}from"node:events";const MSG_OPEN=1313165391;const MSG_WRTE=1163154007;const MSG_CLSE=1163086915;const MSG_OKAY=1497451343;function getCommandName(command){switch(command){case MSG_OPEN:return"OPEN";case MSG_WRTE:return"WRTE";case MSG_CLSE:return"CLSE";case MSG_OKAY:return"OKAY";default:return`0x${command.toString(16).toUpperCase()}`}}function create(socket){const streams=new Map;let nextStreamId=1;const manager={socket,streams,nextStreamId,async openStream(destination){const localId=nextStreamId++;const stream=new AdbStream(localId,0,socket,manager);streams.set(localId,stream);const destBuffer=Buffer.from(destination);await sendMessage(socket,MSG_OPEN,localId,0,destBuffer);return new Promise((resolve,reject)=>{stream.once("ready",()=>resolve(stream));stream.once("error",reject);setTimeout(()=>{if(!stream.ready){streams.delete(localId);reject(new Error("Stream open timeout"))}},5e3)})},handlePacket(data){let offset=0;while(offset<data.length){if(data.length-offset<24)break;const command=data.readUInt32LE(offset);const arg0=data.readUInt32LE(offset+4);const arg1=data.readUInt32LE(offset+8);const dataLength=data.readUInt32LE(offset+12);if(data.length-offset<24+dataLength)break;const packetData=data.slice(offset+24,offset+24+dataLength);offset+=24+dataLength;const commandName=getCommandName(command);if(self.config.get("debug")){self.log.debug(`${self.config.get("debugArrowReceived")} ${commandName} arg0:${arg0} arg1:${arg1} len:${dataLength}`)}const stream=streams.get(arg1);if(stream){stream.handleMessage(command,arg0,arg1,packetData)}}},closeStream(streamId){const stream=streams.get(streamId);if(stream){try{stream.close()}finally{streams.delete(streamId)}}}};return manager}class AdbStream extends EventEmitter{constructor(localId,remoteId,socket,manager){super();this.localId=localId;this.remoteId=remoteId;this.socket=socket;this.manager=manager;this.ready=false;this.closed=false}handleMessage(command,arg0,arg1,data){switch(command){case MSG_OKAY:if(!this.ready){this.remoteId=arg0;this.ready=true;this.emit("ready")}else{this.emit("ack")}break;case MSG_WRTE:this.emit("data",data);sendMessage(this.socket,MSG_OKAY,this.localId,this.remoteId);break;case MSG_CLSE:this.closed=true;this.emit("close");break}}async write(data){if(this.closed||!this.ready){throw new Error("Stream not ready or closed")}const buffer=Buffer.isBuffer(data)?data:Buffer.from(data);await sendMessage(this.socket,MSG_WRTE,this.remoteId,this.localId,buffer)}close(){if(!this.closed){this.closed=true;sendMessage(this.socket,MSG_CLSE,this.remoteId,this.localId);this.emit("close")}}}async function sendMessage(socket,command,arg0,arg1,data=Buffer.alloc(0)){const header=Buffer.alloc(24);let offset=0;header.writeUInt32LE(command,offset);offset+=4;header.writeUInt32LE(arg0,offset);offset+=4;header.writeUInt32LE(arg1,offset);offset+=4;header.writeUInt32LE(data.length,offset);offset+=4;header.writeUInt32LE(checksum(data),offset);offset+=4;header.writeUInt32LE((command^4294967295)>>>0,offset);const commandName=getCommandName(command);if(self.config.get("debug")){self.log.debug(`${self.config.get("debugArrowSent")} ${commandName} arg0:${arg0} arg1:${arg1} len:${data.length}`)}socket.write(header);if(data.length>0){socket.write(data)}}function checksum(data){let sum=0;for(let i=0;i<data.length;i++){sum+=data[i]}return sum&4294967295}export{create};
17
+ import{self}from"@cldmv/slothlet/runtime";import{EventEmitter}from"node:events";const MSG_OPEN=1313165391;const MSG_WRTE=1163154007;const MSG_CLSE=1163086915;const MSG_OKAY=1497451343;function getCommandName(command){switch(command){case MSG_OPEN:return"OPEN";case MSG_WRTE:return"WRTE";case MSG_CLSE:return"CLSE";case MSG_OKAY:return"OKAY";default:return`0x${command.toString(16).toUpperCase()}`}}function create(socket){const streams=new Map;let nextStreamId=1;const emitter=new EventEmitter;const manager={socket,streams,on:(...args)=>emitter.on(...args),once:(...args)=>emitter.once(...args),off:(...args)=>emitter.off(...args),async openStream(destination){const localId=nextStreamId++;const stream=new AdbStream(localId,0,socket,manager);streams.set(localId,stream);const destBuffer=Buffer.from(destination);await sendMessage(socket,MSG_OPEN,localId,0,destBuffer);return new Promise((resolve,reject)=>{stream.once("ready",()=>resolve(stream));stream.once("error",reject);setTimeout(()=>{if(!stream.ready){streams.delete(localId);reject(new Error("Stream open timeout"))}},5e3)})},handlePacket(data){let offset=0;while(offset<data.length){if(data.length-offset<24)break;const command=data.readUInt32LE(offset);const arg0=data.readUInt32LE(offset+4);const arg1=data.readUInt32LE(offset+8);const dataLength=data.readUInt32LE(offset+12);if(data.length-offset<24+dataLength)break;const packetData=data.slice(offset+24,offset+24+dataLength);offset+=24+dataLength;const commandName=getCommandName(command);if(self.config.get("debug")){self.log.debug(`${self.config.get("debugArrowReceived")} ${commandName} arg0:${arg0} arg1:${arg1} len:${dataLength}`)}if(command===MSG_OPEN&&arg1===0){const remoteId=arg0;const destination=packetData.toString("utf8").replace(/\0/g,"");const localId=nextStreamId++;const stream2=new AdbStream(localId,remoteId,socket,manager);stream2.ready=true;streams.set(localId,stream2);sendMessage(socket,MSG_OKAY,localId,remoteId);emitter.emit("remoteOpen",stream2,destination);continue}const stream=streams.get(arg1);if(stream){stream.handleMessage(command,arg0,arg1,packetData)}}},closeStream(streamId){const stream=streams.get(streamId);if(stream){try{stream.close()}finally{streams.delete(streamId)}}}};return manager}class AdbStream extends EventEmitter{constructor(localId,remoteId,socket,manager){super();this.localId=localId;this.remoteId=remoteId;this.socket=socket;this.manager=manager;this.ready=false;this.closed=false}handleMessage(command,arg0,arg1,data){switch(command){case MSG_OKAY:if(!this.ready){this.remoteId=arg0;this.ready=true;this.emit("ready")}else{this.emit("ack")}break;case MSG_WRTE:this.emit("data",data);sendMessage(this.socket,MSG_OKAY,this.localId,this.remoteId);break;case MSG_CLSE:this.closed=true;this.emit("close");break}}async write(data){if(this.closed||!this.ready){throw new Error("Stream not ready or closed")}const buffer=Buffer.isBuffer(data)?data:Buffer.from(data);await sendMessage(this.socket,MSG_WRTE,this.remoteId,this.localId,buffer)}close(){if(!this.closed){this.closed=true;sendMessage(this.socket,MSG_CLSE,this.remoteId,this.localId);this.emit("close")}}}async function sendMessage(socket,command,arg0,arg1,data=Buffer.alloc(0)){const header=Buffer.alloc(24);let offset=0;header.writeUInt32LE(command,offset);offset+=4;header.writeUInt32LE(arg0,offset);offset+=4;header.writeUInt32LE(arg1,offset);offset+=4;header.writeUInt32LE(data.length,offset);offset+=4;header.writeUInt32LE(checksum(data),offset);offset+=4;header.writeUInt32LE((command^4294967295)>>>0,offset);const commandName=getCommandName(command);if(self.config.get("debug")){self.log.debug(`${self.config.get("debugArrowSent")} ${commandName} arg0:${arg0} arg1:${arg1} len:${data.length}`)}socket.write(header);if(data.length>0){socket.write(data)}}function checksum(data){let sum=0;for(let i=0;i<data.length;i++){sum+=data[i]}return sum&4294967295}export{create};
@@ -14,4 +14,4 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- function parseProperties(propOutput){const props={};const lines=propOutput.split("\n");for(const line of lines){const match=line.match(/^\[([^\]]+)\]:\s*\[([^\]]*)\]$/);if(match){const[,key,value]=match;props[key]=value}}return props}function parseListing(lsOutput){const entries=[];const lines=lsOutput.split("\n").filter(line=>line.trim());const startIdx=lines[0]?.startsWith("total")?1:0;for(let i=startIdx;i<lines.length;i++){const line=lines[i];const match=line.match(/^([drwx-]+)\s+(\d+)\s+(\w+)\s+(\w+)\s+(\d+)\s+(.+?)\s+(.+)$/);if(match){const[,permissions,links,owner,group,size,dateTime,name]=match;entries.push({name,permissions,links:parseInt(links),owner,group,size:parseInt(size),dateTime,isDirectory:permissions.startsWith("d"),isFile:permissions.startsWith("-"),isSymlink:permissions.startsWith("l")})}}return entries}function parseBattery(batteryOutput){const battery={};const lines=batteryOutput.split("\n");for(const line of lines){const match=line.match(/^\s*([^:]+):\s*(.+)$/);if(match){let[,key,value]=match;key=key.trim();value=value.trim();if(/^\d+$/.test(value)){value=parseInt(value)}battery[key]=value}}return battery}function formatBytes(bytes,decimals=2){if(bytes===0)return"0 Bytes";const k=1024;const dm=decimals<0?0:decimals;const sizes=["Bytes","KB","MB","GB","TB"];const i=Math.floor(Math.log(bytes)/Math.log(k));return parseFloat((bytes/Math.pow(k,i)).toFixed(dm))+" "+sizes[i]}function delay(ms){return new Promise(resolve=>setTimeout(resolve,ms))}async function retry(fn,options={}){const{baseDelay=1e3,maxDelay=1e4,shouldRetry=()=>true}=options;let{maxRetries=3}=options;if(maxRetries<0){console.warn(`retry: maxRetries must be >= 0, got ${maxRetries} - clamping to 0`);maxRetries=0}let lastError;for(let attempt=0;attempt<=maxRetries;attempt++){try{return await fn()}catch(error){lastError=error;if(attempt===maxRetries||!shouldRetry(error)){throw error}const delayMs=Math.min(baseDelay*Math.pow(2,attempt),maxDelay);await delay(delayMs)}}throw lastError}function isValidIP(ip){const parts=ip.split(".");if(parts.length!==4)return false;return parts.every(part=>{const num=parseInt(part,10);return num>=0&&num<=255&&part===num.toString()})}function isValidPort(port){return Number.isInteger(port)&&port>=1&&port<=65535}function parseHostPort(hostPort,defaultPort=5555){const colonIndex=hostPort.lastIndexOf(":");if(colonIndex===-1){return{host:hostPort,port:defaultPort}}const host=hostPort.substring(0,colonIndex);const portStr=hostPort.substring(colonIndex+1);const port=parseInt(portStr,10);if(!isValidPort(port)){throw new Error(`Invalid port: ${portStr}`)}return{host,port}}function escapeShell(str){return str.replace(/[\\$`"]/g,"\\$&")}function quoteShellArg(str){return`'${String(str).replace(/'/g,`'\\''`)}'`}function timeout(ms,message="Operation timed out"){return new Promise((_,reject)=>{setTimeout(()=>reject(new Error(message)),ms)})}function withTimeout(promise,ms,message){return Promise.race([promise,timeout(ms,message)])}export{delay,escapeShell,formatBytes,isValidIP,isValidPort,parseBattery,parseHostPort,parseListing,parseProperties,quoteShellArg,retry,timeout,withTimeout};
17
+ import net from"node:net";function parseProperties(propOutput){const props={};const lines=propOutput.split("\n");for(const line of lines){const match=line.match(/^\[([^\]]+)\]:\s*\[([^\]]*)\]$/);if(match){const[,key,value]=match;props[key]=value}}return props}function parseListing(lsOutput){const entries=[];const lines=lsOutput.split("\n").filter(line=>line.trim());const startIdx=lines[0]?.startsWith("total")?1:0;for(let i=startIdx;i<lines.length;i++){const line=lines[i];const match=line.match(/^([drwx-]+)\s+(\d+)\s+(\w+)\s+(\w+)\s+(\d+)\s+(.+?)\s+(.+)$/);if(match){const[,permissions,links,owner,group,size,dateTime,name]=match;entries.push({name,permissions,links:parseInt(links),owner,group,size:parseInt(size),dateTime,isDirectory:permissions.startsWith("d"),isFile:permissions.startsWith("-"),isSymlink:permissions.startsWith("l")})}}return entries}function parseBattery(batteryOutput){const battery={};const lines=batteryOutput.split("\n");for(const line of lines){const match=line.match(/^\s*([^:]+):\s*(.+)$/);if(match){let[,key,value]=match;key=key.trim();value=value.trim();if(/^\d+$/.test(value)){value=parseInt(value)}battery[key]=value}}return battery}function formatBytes(bytes,decimals=2){if(bytes===0)return"0 Bytes";const k=1024;const dm=decimals<0?0:decimals;const sizes=["Bytes","KB","MB","GB","TB"];const i=Math.floor(Math.log(bytes)/Math.log(k));return parseFloat((bytes/Math.pow(k,i)).toFixed(dm))+" "+sizes[i]}function delay(ms){return new Promise(resolve=>setTimeout(resolve,ms))}async function retry(fn,options={}){const{baseDelay=1e3,maxDelay=1e4,shouldRetry=()=>true}=options;let{maxRetries=3}=options;if(maxRetries<0){console.warn(`retry: maxRetries must be >= 0, got ${maxRetries} - clamping to 0`);maxRetries=0}let lastError;for(let attempt=0;attempt<=maxRetries;attempt++){try{return await fn()}catch(error){lastError=error;if(attempt===maxRetries||!shouldRetry(error)){throw error}const delayMs=Math.min(baseDelay*Math.pow(2,attempt),maxDelay);await delay(delayMs)}}throw lastError}function isValidIP(ip){const parts=ip.split(".");if(parts.length!==4)return false;return parts.every(part=>{const num=parseInt(part,10);return num>=0&&num<=255&&part===num.toString()})}function isValidPort(port){return Number.isInteger(port)&&port>=1&&port<=65535}function parseHostPort(hostPort,defaultPort=5555){const str=String(hostPort);if(str.startsWith("[")){const closeIdx=str.indexOf("]");if(closeIdx===-1){throw new Error(`Invalid host:port (unterminated '[': ${hostPort})`)}const host2=str.slice(1,closeIdx);if(!net.isIPv6(host2)){throw new Error(`Invalid host:port (bracketed host is not a valid IPv6 address: ${hostPort})`)}const rest=str.slice(closeIdx+1);if(rest===""){return{host:host2,port:defaultPort}}if(!rest.startsWith(":")){throw new Error(`Invalid host:port (expected ':' after ']': ${hostPort})`)}const portStr2=rest.slice(1);const port2=parseInt(portStr2,10);if(!isValidPort(port2)){throw new Error(`Invalid port: ${portStr2}`)}return{host:host2,port:port2}}const colonCount=(str.match(/:/g)||[]).length;if(colonCount>1){if(net.isIPv6(str)){return{host:str,port:defaultPort}}throw new Error(`Invalid host:port - bracket an IPv6 address with a port: [${str}]:<port> (got: ${hostPort})`)}const colonIndex=str.lastIndexOf(":");if(colonIndex===-1){return{host:str,port:defaultPort}}const host=str.substring(0,colonIndex);const portStr=str.substring(colonIndex+1);const port=parseInt(portStr,10);if(!isValidPort(port)){throw new Error(`Invalid port: ${portStr}`)}return{host,port}}function sanitizeKey(deviceId){return deviceId.replace(/\./g,"_").replace(/:/g,"__")}function escapeShell(str){return str.replace(/[\\$`"]/g,"\\$&")}function quoteShellArg(str){return`'${String(str).replace(/'/g,`'\\''`)}'`}function assertValidFlags(flags){if(!Array.isArray(flags)||!flags.every(flag=>typeof flag==="string"&&flag.length>0&&!/\s/.test(flag))){let described;try{described=JSON.stringify(flags)}catch{described=String(flags)}throw new Error(`Invalid flags: ${described} (must be an array of non-empty, whitespace-free strings)`)}return flags}const MAX_IPV6=(1n<<128n)-1n;function ipv6ToBigInt(address){if(typeof address!=="string"||!net.isIPv6(address)||address.includes("%")){throw new Error(`Invalid IPv6 address: ${String(address)}`)}let text=address;const lastColon=text.lastIndexOf(":");if(text.indexOf(".",lastColon)!==-1){const tail2=text.slice(lastColon+1);if(!net.isIPv4(tail2)){throw new Error(`Invalid IPv6 address: ${address}`)}const octets=tail2.split(".").map(Number);const high=(octets[0]<<8|octets[1]).toString(16);const low=(octets[2]<<8|octets[3]).toString(16);text=`${text.slice(0,lastColon+1)}${high}:${low}`}const halves=text.split("::");if(halves.length>2){throw new Error(`Invalid IPv6 address: ${address}`)}const head=halves[0]?halves[0].split(":"):[];const tail=halves.length===2?halves[1]?halves[1].split(":"):[]:null;const fillCount=tail===null?0:8-head.length-tail.length;if(tail===null?head.length!==8:fillCount<0){throw new Error(`Invalid IPv6 address: ${address}`)}const groups=tail===null?head:[...head,...Array(fillCount).fill("0"),...tail];let value=0n;for(const group of groups){if(!/^[0-9a-fA-F]{1,4}$/.test(group)){throw new Error(`Invalid IPv6 address: ${address}`)}value=value<<16n|BigInt(parseInt(group,16))}return value}function bigIntToIpv6(value){if(typeof value!=="bigint"||value<0n||value>MAX_IPV6){throw new Error(`Invalid IPv6 value: ${String(value)} (must be a BigInt in 0..2**128-1)`)}const groups=[];for(let i=7n;i>=0n;i--){groups.push(Number(value>>i*16n&0xffffn))}let bestStart=-1;let bestLen=0;let curStart=-1;let curLen=0;for(let i=0;i<8;i++){if(groups[i]!==0){curStart=-1;curLen=0;continue}if(curStart===-1)curStart=i;curLen++;if(curLen>bestLen){bestLen=curLen;bestStart=curStart}}const hex=groups.map(group=>group.toString(16));if(bestLen<2){return hex.join(":")}return`${hex.slice(0,bestStart).join(":")}::${hex.slice(bestStart+bestLen).join(":")}`}function timeout(ms,message="Operation timed out"){return new Promise((_,reject)=>{setTimeout(()=>reject(new Error(message)),ms)})}function withTimeout(promise,ms,message){return Promise.race([promise,timeout(ms,message)])}export{assertValidFlags,bigIntToIpv6,delay,escapeShell,formatBytes,ipv6ToBigInt,isValidIP,isValidPort,parseBattery,parseHostPort,parseListing,parseProperties,quoteShellArg,retry,sanitizeKey,timeout,withTimeout};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cldmv/droidsock",
3
- "version": "1.2.0",
3
+ "version": "2.0.0",
4
4
  "description": "Complete Node.js implementation of the Android Debug Bridge (ADB) protocol",
5
5
  "main": "./index.cjs",
6
6
  "module": "./index.mjs",
@@ -26,7 +26,7 @@
26
26
  },
27
27
  "type": "module",
28
28
  "engines": {
29
- "node": ">=18.12"
29
+ "node": ">=20.19.0"
30
30
  },
31
31
  "scripts": {
32
32
  "build": "node build.mjs",
@@ -124,6 +124,8 @@
124
124
  "vitest": "^4.1.11"
125
125
  },
126
126
  "dependencies": {
127
- "@cldmv/slothlet": "^3.15.0"
127
+ "@cldmv/slothlet": "^3.15.0",
128
+ "@noble/curves": "^2.4.0",
129
+ "selfsigned": "^5.5.0"
128
130
  }
129
131
  }
@@ -1 +1 @@
1
- {"version":3,"file":"connection.d.mts","sourceRoot":"","sources":["../../../dist/api/connection.mjs"],"names":[],"mappings":"AAgBiN,mDAAg/F"}
1
+ {"version":3,"file":"connection.d.mts","sourceRoot":"","sources":["../../../dist/api/connection.mjs"],"names":[],"mappings":"AAgBkT,mDAAwhG"}
@@ -1,5 +1,4 @@
1
1
  export function connect(host: any, port?: number, options?: {}): Promise<any>;
2
2
  export function disconnect(host: any, port?: number): boolean;
3
- export function disconnectAll(): number;
4
- export function list(): any[];
3
+ export function remove(host: any, port?: number): Promise<boolean>;
5
4
  //# sourceMappingURL=device.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"device.d.mts","sourceRoot":"","sources":["../../../dist/api/device.mjs"],"names":[],"mappings":"AAgBoE,8EAAmzJ;AAA6F,8DAAoK;AAAA,wCAA4I;AAA7Y,8BAA6F"}
1
+ {"version":3,"file":"device.d.mts","sourceRoot":"","sources":["../../../dist/api/device.mjs"],"names":[],"mappings":"AAgBu4K,8EAA8c;AAAA,8DAA4L;AAAA,mEAAgM"}
@@ -0,0 +1,5 @@
1
+ export function disconnect(...args: any[]): number;
2
+ export function get(idOrLeaf: any): any;
3
+ export function list(): any[];
4
+ export function remove(...args: any[]): Promise<number>;
5
+ //# sourceMappingURL=devices.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"devices.d.mts","sourceRoot":"","sources":["../../../dist/api/devices.mjs"],"names":[],"mappings":"AAgB0lB,mDAA0S;AAA1hB,wCAAgP;AAA1T,8BAA0E;AAA0hB,wDAAuR"}
@@ -1,3 +1,6 @@
1
1
  export function mdns(options?: {}): Promise<any>;
2
- export function subnet(cidr: any, port?: number, options?: {}): Promise<any[]>;
2
+ export function subnet(cidr: any, port?: number, options?: {}): Promise<{
3
+ host: any;
4
+ port: any;
5
+ }[]>;
3
6
  //# sourceMappingURL=discover.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"discover.d.mts","sourceRoot":"","sources":["../../../dist/api/discover.mjs"],"names":[],"mappings":"AAgB04N,iDAAmlD;AAA17M,+EAAq/B"}
1
+ {"version":3,"file":"discover.d.mts","sourceRoot":"","sources":["../../../dist/api/discover.mjs"],"names":[],"mappings":"AAgB2qP,iDAAs5E;AAAh6P;;;KAAggC"}
@@ -1,7 +1,7 @@
1
1
  export function chmod(socket: any, streamManager: any, remotePath: any, mode: any, recursive?: boolean): Promise<any>;
2
2
  export function copy(socket: any, streamManager: any, sourcePath: any, destPath: any, recursive?: boolean): Promise<any>;
3
- export function diskUsage(socket: any, streamManager: any, path?: string): Promise<any>;
4
- export function find(socket: any, streamManager: any, path: any, pattern: any, options?: {}): Promise<any>;
3
+ export function diskUsage(socket: any, streamManager: any, path2?: string): Promise<any>;
4
+ export function find(socket: any, streamManager: any, path2: any, pattern: any, options?: {}): Promise<any>;
5
5
  export function list(socket: any, streamManager: any, remotePath: any): Promise<{
6
6
  name: any;
7
7
  permissions: any;
@@ -43,10 +43,43 @@ export function listSync(___socket: any, streamManager: any, remotePath: any): P
43
43
  isFile: boolean;
44
44
  isSymlink: boolean;
45
45
  }[]>;
46
+ export function listV2(___socket: any, streamManager: any, remotePath: any): Promise<{
47
+ name: any;
48
+ mode: any;
49
+ size: any;
50
+ atime: any;
51
+ mtime: any;
52
+ ctime: any;
53
+ uid: any;
54
+ gid: any;
55
+ nlink: any;
56
+ dev: any;
57
+ ino: any;
58
+ isDirectory: boolean;
59
+ isFile: boolean;
60
+ isSymlink: boolean;
61
+ }[]>;
46
62
  export function mkdir(socket: any, streamManager: any, remotePath: any, mode?: number): Promise<any>;
47
63
  export function move(socket: any, streamManager: any, sourcePath: any, destPath: any): Promise<any>;
48
64
  export function pull(___socket: any, streamManager: any, remotePath: any, localPath: any, options?: {}): Promise<void>;
65
+ export function pullV2(___socket: any, streamManager: any, remotePath: any, localPath: any, options?: {}): Promise<void>;
49
66
  export function push(___socket: any, streamManager: any, localPath: any, remotePath: any, options?: {}): Promise<void>;
67
+ export function pushV2(___socket: any, streamManager: any, localPath: any, remotePath: any, options?: {}): Promise<void>;
50
68
  export function remove(socket: any, streamManager: any, remotePath: any, recursive?: boolean): Promise<any>;
51
69
  export function stat(socket: any, streamManager: any, remotePath: any): Promise<any>;
70
+ export function statV2(___socket: any, streamManager: any, remotePath: any): Promise<{
71
+ mode: any;
72
+ size: any;
73
+ atime: any;
74
+ mtime: any;
75
+ ctime: any;
76
+ uid: any;
77
+ gid: any;
78
+ nlink: any;
79
+ dev: any;
80
+ ino: any;
81
+ isDirectory: boolean;
82
+ isFile: boolean;
83
+ isSymlink: boolean;
84
+ }>;
52
85
  //# sourceMappingURL=files.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../../../dist/api/files.mjs"],"names":[],"mappings":"AAgB8yO,sHAA2Q;AAAvgB,yHAA4P;AAA2Q,wFAAmK;AAAA,2GAA4mB;AAA5yE;;;;;;;;;;;;;;;;;;;KAAgO;AAAxZ;;;;;;;;;;;KAAwL;AAAxV;;;;;;;;KAAgK;AAAuiB,qGAAmQ;AAA6N,oGAAuM;AAA12F,uHAAkyB;AAAlwD,uHAAg+B;AAAs8E,4GAA6N;AAA/mB,qFAA+I"}
1
+ {"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../../../dist/api/files.mjs"],"names":[],"mappings":"AAgByugB,sHAA2Q;AAAvgB,yHAA4P;AAA2Q,yFAAqK;AAAA,4GAA8mB;AAAhoG;;;;;;;;;;;;;;;;;;;KAAgO;AAAxZ;;;;;;;;;;;KAAwL;AAAlqC;;;;;;;;KAAgK;AAAA;;;;;;;;;;;;;;;KAA00B;AAAu3C,qGAAmQ;AAA6N,oGAAuM;AAApxM,uHAAkyB;AAAA,yHAAgxD;AAAj3K,uHAAg+B;AAAA,yHAA+1D;AAAg3L,4GAA6N;AAA/7C,qFAA+I;AAAA;;;;;;;;;;;;;;GAAg1B"}
@@ -1,2 +1,3 @@
1
1
  export function classic(socket: any, streamManager: any, localPath: any, options?: {}): Promise<any>;
2
+ export function streaming(___socket: any, streamManager: any, localPath: any, options?: {}): Promise<any>;
2
3
  //# sourceMappingURL=install.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"install.d.mts","sourceRoot":"","sources":["../../../dist/api/install.mjs"],"names":[],"mappings":"AAgBsE,qGAA2b"}
1
+ {"version":3,"file":"install.d.mts","sourceRoot":"","sources":["../../../dist/api/install.mjs"],"names":[],"mappings":"AAgBkL,qGAA2b;AAAA,0GAAm1C"}
@@ -0,0 +1,2 @@
1
+ export function pair(host: any, port: any, pairingCode: any, options?: {}): Promise<any>;
2
+ //# sourceMappingURL=pairing.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pairing.d.mts","sourceRoot":"","sources":["../../../dist/api/pairing.mjs"],"names":[],"mappings":"AAgBwyK,yFAA67E"}
@@ -0,0 +1,6 @@
1
+ export function start(___socket: any, streamManager: any, devicePort: any, hostPort: any, options?: {}): Promise<{
2
+ devicePort: any;
3
+ hostPort: any;
4
+ close(): Promise<void>;
5
+ }>;
6
+ //# sourceMappingURL=reverse.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reverse.d.mts","sourceRoot":"","sources":["../../../dist/api/reverse.mjs"],"names":[],"mappings":"AAgB6jB;;;;GAA85F"}
@@ -1 +1 @@
1
- {"version":3,"file":"shell.d.mts","sourceRoot":"","sources":["../../../dist/api/shell.mjs"],"names":[],"mappings":";IAgBoyH,0EAAqG;IAAK,4DAA+E;IAAS,6EAAoI;IAAU,iEAAoG;IAAmB,0EAA4G;IAAY,mEAA2F;IAAY,sFAAwI;IAAQ;;MAAiG;IAAK;;MAAoG;IAAU,2EAAqG;IAAW,uGAAyL;IAAS,kFAAoH;IAAY,gGAAsL;IAAc,uFAAmH;;AAA7+K,mGAA+vF;AAAod;;;EAAohB;AAAx+B;;EAAod"}
1
+ {"version":3,"file":"shell.d.mts","sourceRoot":"","sources":["../../../dist/api/shell.mjs"],"names":[],"mappings":";IAgB41H,0EAAkH;IAAK,4DAA+E;IAAS,6EAAiJ;IAAU,iEAAoG;IAAmB,0EAA4G;IAAY,mEAA2F;IAAY,sFAAqJ;IAAQ;;MAAiG;IAAK;;MAAoG;IAAU,2EAAoH;IAAW,uGAAuM;IAAS,kFAAmI;IAAY,gGAA8O;IAAc,uFAAkI;;AAAvoL,mGAA+vF;AAAod;;;EAAohB;AAAx+B;;EAAod"}
@@ -1,7 +1,9 @@
1
1
  export function create(socket: any): {
2
2
  socket: any;
3
3
  streams: Map<any, any>;
4
- nextStreamId: number;
4
+ on: (...args: any[]) => any;
5
+ once: (...args: any[]) => any;
6
+ off: (...args: any[]) => any;
5
7
  openStream(destination: any): Promise<any>;
6
8
  handlePacket(data: any): void;
7
9
  closeStream(streamId: any): void;
@@ -1 +1 @@
1
- {"version":3,"file":"stream.d.mts","sourceRoot":"","sources":["../../../dist/api/stream.mjs"],"names":[],"mappings":"AAgB8Y;;;;;;;EAAm1C"}
1
+ {"version":3,"file":"stream.d.mts","sourceRoot":"","sources":["../../../dist/api/stream.mjs"],"names":[],"mappings":"AAgB8Y;;;;;;;;;EAAszD"}
@@ -1,11 +1,14 @@
1
+ export function assertValidFlags(flags: any): any[];
2
+ export function bigIntToIpv6(value: any): string;
1
3
  export function delay(ms: any): Promise<any>;
2
4
  export function escapeShell(str: any): any;
3
5
  export function formatBytes(bytes: any, decimals?: number): string;
6
+ export function ipv6ToBigInt(address: any): bigint;
4
7
  export function isValidIP(ip: any): any;
5
8
  export function isValidPort(port: any): boolean;
6
9
  export function parseBattery(batteryOutput: any): {};
7
10
  export function parseHostPort(hostPort: any, defaultPort?: number): {
8
- host: any;
11
+ host: string;
9
12
  port: number;
10
13
  };
11
14
  export function parseListing(lsOutput: any): {
@@ -23,6 +26,7 @@ export function parseListing(lsOutput: any): {
23
26
  export function parseProperties(propOutput: any): {};
24
27
  export function quoteShellArg(str: any): string;
25
28
  export function retry(fn: any, options?: {}): Promise<any>;
29
+ export function sanitizeKey(deviceId: any): any;
26
30
  export function timeout(ms: any, message?: string): Promise<any>;
27
31
  export function withTimeout(promise: any, ms: any, message: any): Promise<any>;
28
32
  //# sourceMappingURL=utils.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../../dist/api/utils.mjs"],"names":[],"mappings":"AAgBq4C,6CAAuE;AAA8mC,2CAAgE;AAAjgD,mEAA4Q;AAAqkB,wCAAyL;AAAA,gDAA+E;AAAh5C,qDAAuT;AAAylC;;;EAAwW;AAAh1E;;;;;;;;;;;IAAwlB;AAAl0B,qDAA0O;AAAg5E,gDAA2E;AAAzvC,2DAA8f;AAA2vB,iEAAmI;AAAA,+EAA4F"}
1
+ {"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../../dist/api/utils.mjs"],"names":[],"mappings":"AAgBgqH,oDAA6U;AAAmsC,iDAAqoB;AAAt5I,6CAAuE;AAA+iE,2CAAgE;AAAl8E,mEAA4Q;AAA2mF,mDAAsqC;AAA5sG,wCAAyL;AAAA,gDAA+E;AAAh5C,qDAAuT;AAAylC;;;EAAotC;AAA5rG;;;;;;;;;;;IAAwlB;AAAl0B,qDAA0O;AAAi1G,gDAA2E;AAA1rE,2DAA8f;AAA49C,gDAAqF;AAAgyE,iEAAmI;AAAA,+EAA4F"}