appium-ios-remotexpc 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.10.0](https://github.com/appium/appium-ios-remotexpc/compare/v0.9.0...v0.10.0) (2025-10-27)
+
+### Features
+
+* **afc:** add Apple File Conduit (AFC) service implementation ([#84](https://github.com/appium/appium-ios-remotexpc/issues/84)) ([07306c6](https://github.com/appium/appium-ios-remotexpc/commit/07306c611756c206ac07fed6917c70bfc9032757))
+
 ## [0.9.0](https://github.com/appium/appium-ios-remotexpc/compare/v0.8.0...v0.9.0) (2025-10-27)
 
 ### Features

package/README.md

@@ -38,6 +38,7 @@ npm install appium-ios-remotexpc
     - System Log Service: Access device logs
     - Tunnel Service: Network tunneling to/from iOS devices
     - Diagnostic Service: Device diagnostics
+    - AFC Service: File system operations on iOS devices
 - **Pair Record Management**: Read and write device pairing records.
 - **Packet Streaming**: Stream packets between host and device for service communication.
 

package/build/src/services/index.d.ts

@@ -1,9 +1,10 @@
 import { TunnelRegistryServer, startTunnelRegistryServer } from '../lib/tunnel/tunnel-registry-server.js';
+import * as afc from './ios/afc/index.js';
 import * as diagnostics from './ios/diagnostic-service/index.js';
 import * as mobileImageMounter from './ios/mobile-image-mounter/index.js';
 import * as powerAssertion from './ios/power-assertion/index.js';
 import * as syslog from './ios/syslog-service/index.js';
 import * as tunnel from './ios/tunnel-service/index.js';
 import * as webinspector from './ios/webinspector/index.js';
-export { diagnostics, mobileImageMounter, powerAssertion, syslog, tunnel, webinspector, TunnelRegistryServer, startTunnelRegistryServer, };
+export { diagnostics, mobileImageMounter, powerAssertion, syslog, tunnel, afc, webinspector, TunnelRegistryServer, startTunnelRegistryServer, };
 //# sourceMappingURL=index.d.ts.map

package/build/src/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,WAAW,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,kBAAkB,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,cAAc,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAC;AACxD,OAAO,KAAK,YAAY,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,MAAM,EACN,MAAM,EACN,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,GAC1B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,kBAAkB,MAAM,qCAAqC,CAAC;AAC1E,OAAO,KAAK,cAAc,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAC;AACxD,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAC;AACxD,OAAO,KAAK,YAAY,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,MAAM,EACN,MAAM,EACN,GAAG,EACH,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,GAC1B,CAAC"}

package/build/src/services/index.js

@@ -1,8 +1,9 @@
 import { TunnelRegistryServer, startTunnelRegistryServer, } from '../lib/tunnel/tunnel-registry-server.js';
+import * as afc from './ios/afc/index.js';
 import * as diagnostics from './ios/diagnostic-service/index.js';
 import * as mobileImageMounter from './ios/mobile-image-mounter/index.js';
 import * as powerAssertion from './ios/power-assertion/index.js';
 import * as syslog from './ios/syslog-service/index.js';
 import * as tunnel from './ios/tunnel-service/index.js';
 import * as webinspector from './ios/webinspector/index.js';
-export { diagnostics, mobileImageMounter, powerAssertion, syslog, tunnel, webinspector, TunnelRegistryServer, startTunnelRegistryServer, };
+export { diagnostics, mobileImageMounter, powerAssertion, syslog, tunnel, afc, webinspector, TunnelRegistryServer, startTunnelRegistryServer, };

package/build/src/services/ios/afc/codec.d.ts

@@ -0,0 +1,46 @@
+import net from 'node:net';
+import { AfcError, AfcFopenMode, AfcOpcode } from './enums.js';
+export interface AfcHeader {
+    magic: Buffer;
+    entireLength: bigint;
+    thisLength: bigint;
+    packetNum: bigint;
+    operation: bigint;
+}
+export interface AfcResponse {
+    status: AfcError;
+    data: Buffer;
+    operation: AfcOpcode;
+    rawHeader: AfcHeader;
+}
+export declare function writeUInt64LE(value: bigint | number): Buffer;
+export declare function readUInt64LE(buf: Buffer, offset?: number): bigint;
+export declare function cstr(str: string): Buffer;
+export declare function encodeHeader(op: AfcOpcode, packetNum: bigint, payloadLen: number, thisLenOverride?: number): Buffer;
+export declare function readExact(socket: net.Socket, n: number, timeoutMs?: number): Promise<Buffer>;
+export declare function readAfcHeader(socket: net.Socket): Promise<AfcHeader>;
+export declare function readAfcResponse(socket: net.Socket): Promise<AfcResponse>;
+export declare function sendAfcPacket(socket: net.Socket, op: AfcOpcode, packetNum: bigint, payload?: Buffer, thisLenOverride?: number): Promise<void>;
+export declare function parseCStringArray(buf: Buffer): string[];
+export declare function parseKeyValueNullList(buf: Buffer): Record<string, string>;
+export declare function buildFopenPayload(mode: AfcFopenMode, path: string): Buffer;
+export declare function buildReadPayload(handle: bigint | number, size: bigint | number): Buffer;
+export declare function buildClosePayload(handle: bigint | number): Buffer;
+export declare function buildRemovePayload(path: string): Buffer;
+export declare function buildMkdirPayload(path: string): Buffer;
+export declare function buildStatPayload(path: string): Buffer;
+export declare function buildRenamePayload(src: string, dst: string): Buffer;
+export declare function buildLinkPayload(type: number, target: string, source: string): Buffer;
+/**
+ * Receive a single length-prefixed plist from the socket
+ */
+export declare function recvOnePlist(socket: net.Socket): Promise<any>;
+export declare function rsdHandshakeForRawService(socket: net.Socket): Promise<void>;
+export declare function nextReadChunkSize(left: bigint | number): number;
+/**
+ * Convert nanoseconds to milliseconds for Date construction
+ * @param nanoseconds - Time value in nanoseconds as a string
+ * @returns Time value in milliseconds
+ */
+export declare function nanosecondsToMilliseconds(nanoseconds: string): number;
+//# sourceMappingURL=codec.d.ts.map

package/build/src/services/ios/afc/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/afc/codec.ts"],"names":[],"mappings":"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"}

package/build/src/services/ios/afc/codec.js

@@ -0,0 +1,263 @@
+import net from 'node:net';
+import { createPlist } from '../../../lib/plist/plist-creator.js';
+import { parsePlist } from '../../../lib/plist/unified-plist-parser.js';
+import { AFCMAGIC, AFC_HEADER_SIZE, NULL_BYTE } from './constants.js';
+import { AfcError, AfcFopenMode, AfcOpcode } from './enums.js';
+export function writeUInt64LE(value) {
+    const buf = Buffer.alloc(8);
+    buf.writeBigUInt64LE(BigInt(value), 0);
+    return buf;
+}
+export function readUInt64LE(buf, offset = 0) {
+    return buf.readBigUInt64LE(offset);
+}
+export function cstr(str) {
+    const s = Buffer.from(str, 'utf8');
+    return Buffer.concat([s, NULL_BYTE]);
+}
+export function encodeHeader(op, packetNum, payloadLen, thisLenOverride) {
+    const entireLen = BigInt(AFC_HEADER_SIZE + payloadLen);
+    const thisLen = BigInt(thisLenOverride ?? AFC_HEADER_SIZE + payloadLen);
+    const header = Buffer.alloc(AFC_HEADER_SIZE);
+    // magic
+    AFCMAGIC.copy(header, 0);
+    // entire_length
+    writeUInt64LE(entireLen).copy(header, 8);
+    // this_length
+    writeUInt64LE(thisLen).copy(header, 16);
+    // packet_num
+    writeUInt64LE(packetNum).copy(header, 24);
+    // operation
+    writeUInt64LE(BigInt(op)).copy(header, 32);
+    return header;
+}
+const SOCKET_STATES = new WeakMap();
+function cleanupSocketState(socket, error) {
+    const state = SOCKET_STATES.get(socket);
+    if (!state) {
+        return;
+    }
+    // Remove all event listeners to prevent memory leaks
+    socket.removeListener('data', state.onData);
+    socket.removeListener('error', state.onError);
+    socket.removeListener('close', state.onClose);
+    socket.removeListener('end', state.onClose);
+    // Reject any pending waiters
+    const err = error || new Error('Socket closed');
+    while (state.waiters.length) {
+        const w = state.waiters.shift();
+        if (w.timer) {
+            clearTimeout(w.timer);
+        }
+        w.reject(err);
+    }
+    // Remove from WeakMap
+    SOCKET_STATES.delete(socket);
+}
+function ensureSocketState(socket) {
+    let state = SOCKET_STATES.get(socket);
+    if (state) {
+        return state;
+    }
+    state = {
+        buffer: Buffer.alloc(0),
+        waiters: [],
+        onData: (chunk) => {
+            const st = SOCKET_STATES.get(socket);
+            if (!st) {
+                return;
+            }
+            st.buffer = Buffer.concat([st.buffer, chunk]);
+            while (st.waiters.length && st.buffer.length >= st.waiters[0].n) {
+                const w = st.waiters.shift();
+                const out = st.buffer.subarray(0, w.n);
+                st.buffer = st.buffer.subarray(w.n);
+                if (w.timer) {
+                    clearTimeout(w.timer);
+                }
+                w.resolve(out);
+            }
+        },
+        onError: (err) => {
+            cleanupSocketState(socket, err);
+        },
+        onClose: () => {
+            cleanupSocketState(socket);
+        },
+    };
+    socket.on('data', state.onData);
+    socket.once('error', state.onError);
+    socket.once('close', state.onClose);
+    socket.once('end', state.onClose);
+    SOCKET_STATES.set(socket, state);
+    return state;
+}
+export async function readExact(socket, n, timeoutMs = 30000) {
+    const state = ensureSocketState(socket);
+    if (state.buffer.length >= n) {
+        const out = state.buffer.subarray(0, n);
+        state.buffer = state.buffer.subarray(n);
+        return out;
+    }
+    return await new Promise((resolve, reject) => {
+        const waiter = { n, resolve, reject };
+        state.waiters.push(waiter);
+        waiter.timer = setTimeout(() => {
+            const idx = state.waiters.indexOf(waiter);
+            if (idx >= 0) {
+                state.waiters.splice(idx, 1);
+                reject(new Error(`readExact timeout after ${timeoutMs}ms`));
+            }
+        }, timeoutMs);
+    });
+}
+export async function readAfcHeader(socket) {
+    const buf = await readExact(socket, AFC_HEADER_SIZE);
+    const magic = buf.subarray(0, 8);
+    if (!magic.equals(AFCMAGIC)) {
+        throw new Error(`Invalid AFC magic: ${magic.toString('hex')}`);
+    }
+    const entireLength = readUInt64LE(buf, 8);
+    const thisLength = readUInt64LE(buf, 16);
+    const packetNum = readUInt64LE(buf, 24);
+    const operation = readUInt64LE(buf, 32);
+    return {
+        magic,
+        entireLength,
+        thisLength,
+        packetNum,
+        operation,
+    };
+}
+export async function readAfcResponse(socket) {
+    const header = await readAfcHeader(socket);
+    const payloadLen = Number(header.entireLength - BigInt(AFC_HEADER_SIZE));
+    const payload = payloadLen > 0 ? await readExact(socket, payloadLen) : Buffer.alloc(0);
+    const op = Number(header.operation);
+    if (op === AfcOpcode.STATUS) {
+        const status = Number(readUInt64LE(payload.subarray(0, 8)));
+        return { status, data: Buffer.alloc(0), operation: op, rawHeader: header };
+    }
+    return {
+        status: AfcError.SUCCESS,
+        data: payload,
+        operation: op,
+        rawHeader: header,
+    };
+}
+export async function sendAfcPacket(socket, op, packetNum, payload = Buffer.alloc(0), thisLenOverride) {
+    const header = encodeHeader(op, packetNum, payload.length, thisLenOverride);
+    await new Promise((resolve, reject) => {
+        socket.write(header, (err) => {
+            if (err) {
+                return reject(err);
+            }
+            if (payload.length) {
+                socket.write(payload, (err2) => {
+                    if (err2) {
+                        return reject(err2);
+                    }
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+export function parseCStringArray(buf) {
+    const parts = [];
+    let start = 0;
+    for (let i = 0; i < buf.length; i++) {
+        if (buf[i] === 0x00) {
+            const slice = buf.subarray(start, i);
+            parts.push(slice.toString('utf8'));
+            start = i + 1;
+        }
+    }
+    if (start < buf.length) {
+        parts.push(buf.subarray(start).toString('utf8'));
+    }
+    while (parts.length && parts[parts.length - 1] === '') {
+        parts.pop();
+    }
+    return parts;
+}
+export function parseKeyValueNullList(buf) {
+    const arr = parseCStringArray(buf);
+    if (arr.length % 2 !== 0) {
+        throw new Error('Invalid key/value AFC list (odd number of entries)');
+    }
+    return Object.fromEntries(Array.from({ length: arr.length / 2 }, (_, i) => [
+        arr[i * 2],
+        arr[i * 2 + 1],
+    ]));
+}
+export function buildFopenPayload(mode, path) {
+    return Buffer.concat([writeUInt64LE(mode), cstr(path)]);
+}
+export function buildReadPayload(handle, size) {
+    return Buffer.concat([writeUInt64LE(handle), writeUInt64LE(BigInt(size))]);
+}
+export function buildClosePayload(handle) {
+    return writeUInt64LE(handle);
+}
+export function buildRemovePayload(path) {
+    return cstr(path);
+}
+export function buildMkdirPayload(path) {
+    return cstr(path);
+}
+export function buildStatPayload(path) {
+    return cstr(path);
+}
+export function buildRenamePayload(src, dst) {
+    return Buffer.concat([cstr(src), cstr(dst)]);
+}
+export function buildLinkPayload(type, target, source) {
+    return Buffer.concat([writeUInt64LE(type), cstr(target), cstr(source)]);
+}
+/**
+ * Receive a single length-prefixed plist from the socket
+ */
+export async function recvOnePlist(socket) {
+    const lenBuf = await readExact(socket, 4);
+    const respLen = lenBuf.readUInt32BE(0);
+    const respBody = await readExact(socket, respLen);
+    return parsePlist(respBody);
+}
+export async function rsdHandshakeForRawService(socket) {
+    const request = {
+        Label: 'appium-internal',
+        ProtocolVersion: '2',
+        Request: 'RSDCheckin',
+    };
+    const xml = createPlist(request);
+    const body = Buffer.from(xml, 'utf8');
+    const header = Buffer.alloc(4);
+    header.writeUInt32BE(body.length, 0);
+    await new Promise((resolve, reject) => {
+        socket.write(Buffer.concat([header, body]), (err) => err ? reject(err) : resolve());
+    });
+    const first = await recvOnePlist(socket);
+    if (!first || first.Request !== 'RSDCheckin') {
+        throw new Error(`Invalid RSDCheckin response: ${JSON.stringify(first)}`);
+    }
+    const second = await recvOnePlist(socket);
+    if (!second || second.Request !== 'StartService') {
+        throw new Error(`Invalid StartService response: ${JSON.stringify(second)}`);
+    }
+}
+export function nextReadChunkSize(left) {
+    const leftNum = typeof left === 'bigint' ? Number(left) : left;
+    return leftNum;
+}
+/**
+ * Convert nanoseconds to milliseconds for Date construction
+ * @param nanoseconds - Time value in nanoseconds as a string
+ * @returns Time value in milliseconds
+ */
+export function nanosecondsToMilliseconds(nanoseconds) {
+    return Number(BigInt(nanoseconds) / 1000000n);
+}

package/build/src/services/ios/afc/constants.d.ts

@@ -0,0 +1,11 @@
+import { AfcFopenMode } from './enums.js';
+/**
+ * AFC protocol constants
+ */
+export declare const AFCMAGIC: Buffer<ArrayBuffer>;
+export declare const MAXIMUM_READ_SIZE: number;
+export declare const AFC_FOPEN_TEXTUAL_MODES: Record<string, AfcFopenMode>;
+export declare const AFC_HEADER_SIZE = 40;
+export declare const AFC_WRITE_THIS_LENGTH = 48;
+export declare const NULL_BYTE: Buffer<ArrayBuffer>;
+//# sourceMappingURL=constants.d.ts.map

package/build/src/services/ios/afc/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/afc/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C;;GAEG;AAGH,eAAO,MAAM,QAAQ,qBAAmC,CAAC;AAGzD,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AAGjD,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAOhE,CAAC;AAGF,eAAO,MAAM,eAAe,KAAK,CAAC;AAGlC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,eAAO,MAAM,SAAS,qBAAmB,CAAC"}

package/build/src/services/ios/afc/constants.js

@@ -0,0 +1,22 @@
+import { AfcFopenMode } from './enums.js';
+/**
+ * AFC protocol constants
+ */
+// Magic bytes at start of every AFC header
+export const AFCMAGIC = Buffer.from('CFA6LPAA', 'ascii');
+// IO chunk sizes
+export const MAXIMUM_READ_SIZE = 4 * 1024 * 1024; // 4 MiB
+// Mapping of textual fopen modes to AFC modes
+export const AFC_FOPEN_TEXTUAL_MODES = {
+    r: AfcFopenMode.RDONLY,
+    'r+': AfcFopenMode.RW,
+    w: AfcFopenMode.WRONLY,
+    'w+': AfcFopenMode.WR,
+    a: AfcFopenMode.APPEND,
+    'a+': AfcFopenMode.RDAPPEND,
+};
+// Header size: magic (8) + entire_length (8) + this_length (8) + packet_num (8) + operation (8)
+export const AFC_HEADER_SIZE = 40;
+// Override for WRITE packets' this_length
+export const AFC_WRITE_THIS_LENGTH = 48;
+export const NULL_BYTE = Buffer.from([0]);

package/build/src/services/ios/afc/enums.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Enums for AFC protocol as defined by Apple's AFC service
+ */
+export declare enum AfcOpcode {
+    STATUS = 1,
+    DATA = 2,
+    READ_DIR = 3,
+    REMOVE_PATH = 8,
+    MAKE_DIR = 9,
+    GET_FILE_INFO = 10,
+    GET_DEVINFO = 11,
+    FILE_OPEN = 13,
+    READ = 15,
+    WRITE = 16,
+    FILE_CLOSE = 20,
+    RENAME_PATH = 24,
+    MAKE_LINK = 28
+}
+export declare enum AfcError {
+    SUCCESS = 0,
+    UNKNOWN_ERROR = 1,
+    OP_HEADER_INVALID = 2,
+    NO_RESOURCES = 3,
+    READ_ERROR = 4,
+    WRITE_ERROR = 5,
+    UNKNOWN_PACKET_TYPE = 6,
+    INVALID_ARG = 7,
+    OBJECT_NOT_FOUND = 8,
+    OBJECT_IS_DIR = 9,
+    PERM_DENIED = 10,
+    SERVICE_NOT_CONNECTED = 11,
+    OP_TIMEOUT = 12,
+    TOO_MUCH_DATA = 13,
+    END_OF_DATA = 14,
+    OP_NOT_SUPPORTED = 15,
+    OBJECT_EXISTS = 16,
+    OBJECT_BUSY = 17,
+    NO_SPACE_LEFT = 18,
+    OP_WOULD_BLOCK = 19,
+    IO_ERROR = 20,
+    OP_INTERRUPTED = 21,
+    OP_IN_PROGRESS = 22,
+    INTERNAL_ERROR = 23,
+    MUX_ERROR = 30,
+    NO_MEM = 31,
+    NOT_ENOUGH_DATA = 32,
+    DIR_NOT_EMPTY = 33
+}
+export declare enum AfcLinkType {
+    HARDLINK = 1,
+    SYMLINK = 2
+}
+export declare enum AfcFopenMode {
+    RDONLY = 1,// 'r'
+    RW = 2,// 'r+'
+    WRONLY = 3,// 'w'
+    WR = 4,// 'w+'
+    APPEND = 5,// 'a'
+    RDAPPEND = 6
+}
+export declare enum AfcFileMode {
+    S_IFDIR = "S_IFDIR",
+    S_IFREG = "S_IFREG",
+    S_IFLNK = "S_IFLNK"
+}
+//# sourceMappingURL=enums.d.ts.map

package/build/src/services/ios/afc/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/afc/enums.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IACnB,MAAM,IAAa;IACnB,IAAI,IAAa;IACjB,QAAQ,IAAa;IACrB,WAAW,IAAa;IACxB,QAAQ,IAAa;IACrB,aAAa,KAAa;IAC1B,WAAW,KAAa;IACxB,SAAS,KAAa;IACtB,IAAI,KAAa;IACjB,KAAK,KAAa;IAClB,UAAU,KAAa;IACvB,WAAW,KAAa;IACxB,SAAS,KAAa;CACvB;AAED,oBAAY,QAAQ;IAClB,OAAO,IAAI;IACX,aAAa,IAAI;IACjB,iBAAiB,IAAI;IACrB,YAAY,IAAI;IAChB,UAAU,IAAI;IACd,WAAW,IAAI;IACf,mBAAmB,IAAI;IACvB,WAAW,IAAI;IACf,gBAAgB,IAAI;IACpB,aAAa,IAAI;IACjB,WAAW,KAAK;IAChB,qBAAqB,KAAK;IAC1B,UAAU,KAAK;IACf,aAAa,KAAK;IAClB,WAAW,KAAK;IAChB,gBAAgB,KAAK;IACrB,aAAa,KAAK;IAClB,WAAW,KAAK;IAChB,aAAa,KAAK;IAClB,cAAc,KAAK;IACnB,QAAQ,KAAK;IACb,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,SAAS,KAAK;IACd,MAAM,KAAK;IACX,eAAe,KAAK;IACpB,aAAa,KAAK;CACnB;AAED,oBAAY,WAAW;IACrB,QAAQ,IAAI;IACZ,OAAO,IAAI;CACZ;AAED,oBAAY,YAAY;IACtB,MAAM,IAAa,CAAE,MAAM;IAC3B,EAAE,IAAa,CAAE,OAAO;IACxB,MAAM,IAAa,CAAE,MAAM;IAC3B,EAAE,IAAa,CAAE,OAAO;IACxB,MAAM,IAAa,CAAE,MAAM;IAC3B,QAAQ,IAAa;CACtB;AAED,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB"}

package/build/src/services/ios/afc/enums.js

@@ -0,0 +1,70 @@
+/**
+ * Enums for AFC protocol as defined by Apple's AFC service
+ */
+export var AfcOpcode;
+(function (AfcOpcode) {
+    AfcOpcode[AfcOpcode["STATUS"] = 1] = "STATUS";
+    AfcOpcode[AfcOpcode["DATA"] = 2] = "DATA";
+    AfcOpcode[AfcOpcode["READ_DIR"] = 3] = "READ_DIR";
+    AfcOpcode[AfcOpcode["REMOVE_PATH"] = 8] = "REMOVE_PATH";
+    AfcOpcode[AfcOpcode["MAKE_DIR"] = 9] = "MAKE_DIR";
+    AfcOpcode[AfcOpcode["GET_FILE_INFO"] = 10] = "GET_FILE_INFO";
+    AfcOpcode[AfcOpcode["GET_DEVINFO"] = 11] = "GET_DEVINFO";
+    AfcOpcode[AfcOpcode["FILE_OPEN"] = 13] = "FILE_OPEN";
+    AfcOpcode[AfcOpcode["READ"] = 15] = "READ";
+    AfcOpcode[AfcOpcode["WRITE"] = 16] = "WRITE";
+    AfcOpcode[AfcOpcode["FILE_CLOSE"] = 20] = "FILE_CLOSE";
+    AfcOpcode[AfcOpcode["RENAME_PATH"] = 24] = "RENAME_PATH";
+    AfcOpcode[AfcOpcode["MAKE_LINK"] = 28] = "MAKE_LINK";
+})(AfcOpcode || (AfcOpcode = {}));
+export var AfcError;
+(function (AfcError) {
+    AfcError[AfcError["SUCCESS"] = 0] = "SUCCESS";
+    AfcError[AfcError["UNKNOWN_ERROR"] = 1] = "UNKNOWN_ERROR";
+    AfcError[AfcError["OP_HEADER_INVALID"] = 2] = "OP_HEADER_INVALID";
+    AfcError[AfcError["NO_RESOURCES"] = 3] = "NO_RESOURCES";
+    AfcError[AfcError["READ_ERROR"] = 4] = "READ_ERROR";
+    AfcError[AfcError["WRITE_ERROR"] = 5] = "WRITE_ERROR";
+    AfcError[AfcError["UNKNOWN_PACKET_TYPE"] = 6] = "UNKNOWN_PACKET_TYPE";
+    AfcError[AfcError["INVALID_ARG"] = 7] = "INVALID_ARG";
+    AfcError[AfcError["OBJECT_NOT_FOUND"] = 8] = "OBJECT_NOT_FOUND";
+    AfcError[AfcError["OBJECT_IS_DIR"] = 9] = "OBJECT_IS_DIR";
+    AfcError[AfcError["PERM_DENIED"] = 10] = "PERM_DENIED";
+    AfcError[AfcError["SERVICE_NOT_CONNECTED"] = 11] = "SERVICE_NOT_CONNECTED";
+    AfcError[AfcError["OP_TIMEOUT"] = 12] = "OP_TIMEOUT";
+    AfcError[AfcError["TOO_MUCH_DATA"] = 13] = "TOO_MUCH_DATA";
+    AfcError[AfcError["END_OF_DATA"] = 14] = "END_OF_DATA";
+    AfcError[AfcError["OP_NOT_SUPPORTED"] = 15] = "OP_NOT_SUPPORTED";
+    AfcError[AfcError["OBJECT_EXISTS"] = 16] = "OBJECT_EXISTS";
+    AfcError[AfcError["OBJECT_BUSY"] = 17] = "OBJECT_BUSY";
+    AfcError[AfcError["NO_SPACE_LEFT"] = 18] = "NO_SPACE_LEFT";
+    AfcError[AfcError["OP_WOULD_BLOCK"] = 19] = "OP_WOULD_BLOCK";
+    AfcError[AfcError["IO_ERROR"] = 20] = "IO_ERROR";
+    AfcError[AfcError["OP_INTERRUPTED"] = 21] = "OP_INTERRUPTED";
+    AfcError[AfcError["OP_IN_PROGRESS"] = 22] = "OP_IN_PROGRESS";
+    AfcError[AfcError["INTERNAL_ERROR"] = 23] = "INTERNAL_ERROR";
+    AfcError[AfcError["MUX_ERROR"] = 30] = "MUX_ERROR";
+    AfcError[AfcError["NO_MEM"] = 31] = "NO_MEM";
+    AfcError[AfcError["NOT_ENOUGH_DATA"] = 32] = "NOT_ENOUGH_DATA";
+    AfcError[AfcError["DIR_NOT_EMPTY"] = 33] = "DIR_NOT_EMPTY";
+})(AfcError || (AfcError = {}));
+export var AfcLinkType;
+(function (AfcLinkType) {
+    AfcLinkType[AfcLinkType["HARDLINK"] = 1] = "HARDLINK";
+    AfcLinkType[AfcLinkType["SYMLINK"] = 2] = "SYMLINK";
+})(AfcLinkType || (AfcLinkType = {}));
+export var AfcFopenMode;
+(function (AfcFopenMode) {
+    AfcFopenMode[AfcFopenMode["RDONLY"] = 1] = "RDONLY";
+    AfcFopenMode[AfcFopenMode["RW"] = 2] = "RW";
+    AfcFopenMode[AfcFopenMode["WRONLY"] = 3] = "WRONLY";
+    AfcFopenMode[AfcFopenMode["WR"] = 4] = "WR";
+    AfcFopenMode[AfcFopenMode["APPEND"] = 5] = "APPEND";
+    AfcFopenMode[AfcFopenMode["RDAPPEND"] = 6] = "RDAPPEND";
+})(AfcFopenMode || (AfcFopenMode = {}));
+export var AfcFileMode;
+(function (AfcFileMode) {
+    AfcFileMode["S_IFDIR"] = "S_IFDIR";
+    AfcFileMode["S_IFREG"] = "S_IFREG";
+    AfcFileMode["S_IFLNK"] = "S_IFLNK";
+})(AfcFileMode || (AfcFileMode = {}));

package/build/src/services/ios/afc/index.d.ts

@@ -0,0 +1,72 @@
+import { Readable, Writable } from 'node:stream';
+import { AFC_FOPEN_TEXTUAL_MODES } from './constants.js';
+import { AfcFileMode } from './enums.js';
+export interface StatInfo {
+    st_ifmt: AfcFileMode;
+    st_size: bigint;
+    st_blocks: number;
+    st_mtime: Date;
+    st_birthtime: Date;
+    st_nlink: number;
+    LinkTarget?: string;
+    [k: string]: any;
+}
+/**
+ * AFC client over RSD (Remote XPC shim).
+ * After RSDCheckin, speaks raw AFC protocol on the same socket.
+ */
+export declare class AfcService {
+    private readonly address;
+    static readonly RSD_SERVICE_NAME = "com.apple.afc.shim.remote";
+    private socket;
+    private packetNum;
+    private silent;
+    constructor(address: [string, number], silent?: boolean);
+    /**
+     * List directory entries. Returned entries do not include '.' and '..'
+     */
+    listdir(dirPath: string): Promise<string[]>;
+    stat(filePath: string): Promise<StatInfo>;
+    isdir(filePath: string): Promise<boolean>;
+    exists(filePath: string): Promise<boolean>;
+    fopen(filePath: string, mode?: keyof typeof AFC_FOPEN_TEXTUAL_MODES): Promise<bigint>;
+    fclose(handle: bigint): Promise<void>;
+    createReadStream(handle: bigint, size: bigint): Readable;
+    createWriteStream(handle: bigint, chunkSize?: number): Writable;
+    fread(handle: bigint, size: bigint): Promise<Buffer>;
+    fwrite(handle: bigint, data: Buffer, chunkSize?: number): Promise<void>;
+    getFileContents(filePath: string): Promise<Buffer>;
+    setFileContents(filePath: string, data: Buffer): Promise<void>;
+    readToStream(filePath: string): Promise<Readable>;
+    writeFromStream(filePath: string, stream: Readable): Promise<void>;
+    pull(remoteSrc: string, localDst: string): Promise<void>;
+    rmSingle(filePath: string, force?: boolean): Promise<boolean>;
+    rm(filePath: string, force?: boolean): Promise<string[]>;
+    rename(src: string, dst: string): Promise<void>;
+    push(localSrc: string, remoteDst: string): Promise<void>;
+    walk(root: string): Promise<Array<{
+        dir: string;
+        dirs: string[];
+        files: string[];
+    }>>;
+    /**
+     * Close the underlying socket
+     */
+    close(): void;
+    /**
+     * Connect to RSD port and perform RSDCheckin.
+     * Keeps the underlying socket for raw AFC I/O.
+     */
+    private _connect;
+    private _resolvePath;
+    private _dispatch;
+    private _receive;
+    /**
+     * Send a single-operation request and parse result.
+     * Throws if status != SUCCESS.
+     * Returns response DATA buffer when applicable.
+     */
+    private _doOperation;
+}
+export default AfcService;
+//# sourceMappingURL=index.d.ts.map

package/build/src/services/ios/afc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/afc/index.ts"],"names":[],"mappings":"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"}