373 lines
12 KiB
JavaScript
373 lines
12 KiB
JavaScript
"use strict";
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.AFCProtocolWriter = exports.AFCProtocolReader = exports.AFCProtocolClient = exports.AFCError = exports.AFC_FILE_OPEN_FLAGS = exports.AFC_STATUS = exports.AFC_OPS = exports.AFC_HEADER_SIZE = exports.AFC_MAGIC = void 0;
|
|
const Debug = require("debug");
|
|
const protocol_1 = require("./protocol");
|
|
const debug = Debug('native-run:ios:lib:protocol:afc');
|
|
exports.AFC_MAGIC = 'CFA6LPAA';
|
|
exports.AFC_HEADER_SIZE = 40;
|
|
/**
|
|
* AFC Operations
|
|
*/
|
|
var AFC_OPS;
|
|
(function (AFC_OPS) {
|
|
/**
|
|
* Invalid
|
|
*/
|
|
AFC_OPS[AFC_OPS["INVALID"] = 0] = "INVALID";
|
|
/**
|
|
* Status
|
|
*/
|
|
AFC_OPS[AFC_OPS["STATUS"] = 1] = "STATUS";
|
|
/**
|
|
* Data
|
|
*/
|
|
AFC_OPS[AFC_OPS["DATA"] = 2] = "DATA";
|
|
/**
|
|
* ReadDir
|
|
*/
|
|
AFC_OPS[AFC_OPS["READ_DIR"] = 3] = "READ_DIR";
|
|
/**
|
|
* ReadFile
|
|
*/
|
|
AFC_OPS[AFC_OPS["READ_FILE"] = 4] = "READ_FILE";
|
|
/**
|
|
* WriteFile
|
|
*/
|
|
AFC_OPS[AFC_OPS["WRITE_FILE"] = 5] = "WRITE_FILE";
|
|
/**
|
|
* WritePart
|
|
*/
|
|
AFC_OPS[AFC_OPS["WRITE_PART"] = 6] = "WRITE_PART";
|
|
/**
|
|
* TruncateFile
|
|
*/
|
|
AFC_OPS[AFC_OPS["TRUNCATE"] = 7] = "TRUNCATE";
|
|
/**
|
|
* RemovePath
|
|
*/
|
|
AFC_OPS[AFC_OPS["REMOVE_PATH"] = 8] = "REMOVE_PATH";
|
|
/**
|
|
* MakeDir
|
|
*/
|
|
AFC_OPS[AFC_OPS["MAKE_DIR"] = 9] = "MAKE_DIR";
|
|
/**
|
|
* GetFileInfo
|
|
*/
|
|
AFC_OPS[AFC_OPS["GET_FILE_INFO"] = 10] = "GET_FILE_INFO";
|
|
/**
|
|
* GetDeviceInfo
|
|
*/
|
|
AFC_OPS[AFC_OPS["GET_DEVINFO"] = 11] = "GET_DEVINFO";
|
|
/**
|
|
* WriteFileAtomic (tmp file+rename)
|
|
*/
|
|
AFC_OPS[AFC_OPS["WRITE_FILE_ATOM"] = 12] = "WRITE_FILE_ATOM";
|
|
/**
|
|
* FileRefOpen
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_OPEN"] = 13] = "FILE_OPEN";
|
|
/**
|
|
* FileRefOpenResult
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_OPEN_RES"] = 14] = "FILE_OPEN_RES";
|
|
/**
|
|
* FileRefRead
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_READ"] = 15] = "FILE_READ";
|
|
/**
|
|
* FileRefWrite
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_WRITE"] = 16] = "FILE_WRITE";
|
|
/**
|
|
* FileRefSeek
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_SEEK"] = 17] = "FILE_SEEK";
|
|
/**
|
|
* FileRefTell
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_TELL"] = 18] = "FILE_TELL";
|
|
/**
|
|
* FileRefTellResult
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_TELL_RES"] = 19] = "FILE_TELL_RES";
|
|
/**
|
|
* FileRefClose
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_CLOSE"] = 20] = "FILE_CLOSE";
|
|
/**
|
|
* FileRefSetFileSize (ftruncate)
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_SET_SIZE"] = 21] = "FILE_SET_SIZE";
|
|
/**
|
|
* GetConnectionInfo
|
|
*/
|
|
AFC_OPS[AFC_OPS["GET_CON_INFO"] = 22] = "GET_CON_INFO";
|
|
/**
|
|
* SetConnectionOptions
|
|
*/
|
|
AFC_OPS[AFC_OPS["SET_CON_OPTIONS"] = 23] = "SET_CON_OPTIONS";
|
|
/**
|
|
* RenamePath
|
|
*/
|
|
AFC_OPS[AFC_OPS["RENAME_PATH"] = 24] = "RENAME_PATH";
|
|
/**
|
|
* SetFSBlockSize (0x800000)
|
|
*/
|
|
AFC_OPS[AFC_OPS["SET_FS_BS"] = 25] = "SET_FS_BS";
|
|
/**
|
|
* SetSocketBlockSize (0x800000)
|
|
*/
|
|
AFC_OPS[AFC_OPS["SET_SOCKET_BS"] = 26] = "SET_SOCKET_BS";
|
|
/**
|
|
* FileRefLock
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_LOCK"] = 27] = "FILE_LOCK";
|
|
/**
|
|
* MakeLink
|
|
*/
|
|
AFC_OPS[AFC_OPS["MAKE_LINK"] = 28] = "MAKE_LINK";
|
|
/**
|
|
* GetFileHash
|
|
*/
|
|
AFC_OPS[AFC_OPS["GET_FILE_HASH"] = 29] = "GET_FILE_HASH";
|
|
/**
|
|
* SetModTime
|
|
*/
|
|
AFC_OPS[AFC_OPS["SET_FILE_MOD_TIME"] = 30] = "SET_FILE_MOD_TIME";
|
|
/**
|
|
* GetFileHashWithRange
|
|
*/
|
|
AFC_OPS[AFC_OPS["GET_FILE_HASH_RANGE"] = 31] = "GET_FILE_HASH_RANGE";
|
|
// iOS 6+
|
|
/**
|
|
* FileRefSetImmutableHint
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_SET_IMMUTABLE_HINT"] = 32] = "FILE_SET_IMMUTABLE_HINT";
|
|
/**
|
|
* GetSizeOfPathContents
|
|
*/
|
|
AFC_OPS[AFC_OPS["GET_SIZE_OF_PATH_CONTENTS"] = 33] = "GET_SIZE_OF_PATH_CONTENTS";
|
|
/**
|
|
* RemovePathAndContents
|
|
*/
|
|
AFC_OPS[AFC_OPS["REMOVE_PATH_AND_CONTENTS"] = 34] = "REMOVE_PATH_AND_CONTENTS";
|
|
/**
|
|
* DirectoryEnumeratorRefOpen
|
|
*/
|
|
AFC_OPS[AFC_OPS["DIR_OPEN"] = 35] = "DIR_OPEN";
|
|
/**
|
|
* DirectoryEnumeratorRefOpenResult
|
|
*/
|
|
AFC_OPS[AFC_OPS["DIR_OPEN_RESULT"] = 36] = "DIR_OPEN_RESULT";
|
|
/**
|
|
* DirectoryEnumeratorRefRead
|
|
*/
|
|
AFC_OPS[AFC_OPS["DIR_READ"] = 37] = "DIR_READ";
|
|
/**
|
|
* DirectoryEnumeratorRefClose
|
|
*/
|
|
AFC_OPS[AFC_OPS["DIR_CLOSE"] = 38] = "DIR_CLOSE";
|
|
// iOS 7+
|
|
/**
|
|
* FileRefReadWithOffset
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_READ_OFFSET"] = 39] = "FILE_READ_OFFSET";
|
|
/**
|
|
* FileRefWriteWithOffset
|
|
*/
|
|
AFC_OPS[AFC_OPS["FILE_WRITE_OFFSET"] = 40] = "FILE_WRITE_OFFSET";
|
|
})(AFC_OPS = exports.AFC_OPS || (exports.AFC_OPS = {}));
|
|
/**
|
|
* Error Codes
|
|
*/
|
|
var AFC_STATUS;
|
|
(function (AFC_STATUS) {
|
|
AFC_STATUS[AFC_STATUS["SUCCESS"] = 0] = "SUCCESS";
|
|
AFC_STATUS[AFC_STATUS["UNKNOWN_ERROR"] = 1] = "UNKNOWN_ERROR";
|
|
AFC_STATUS[AFC_STATUS["OP_HEADER_INVALID"] = 2] = "OP_HEADER_INVALID";
|
|
AFC_STATUS[AFC_STATUS["NO_RESOURCES"] = 3] = "NO_RESOURCES";
|
|
AFC_STATUS[AFC_STATUS["READ_ERROR"] = 4] = "READ_ERROR";
|
|
AFC_STATUS[AFC_STATUS["WRITE_ERROR"] = 5] = "WRITE_ERROR";
|
|
AFC_STATUS[AFC_STATUS["UNKNOWN_PACKET_TYPE"] = 6] = "UNKNOWN_PACKET_TYPE";
|
|
AFC_STATUS[AFC_STATUS["INVALID_ARG"] = 7] = "INVALID_ARG";
|
|
AFC_STATUS[AFC_STATUS["OBJECT_NOT_FOUND"] = 8] = "OBJECT_NOT_FOUND";
|
|
AFC_STATUS[AFC_STATUS["OBJECT_IS_DIR"] = 9] = "OBJECT_IS_DIR";
|
|
AFC_STATUS[AFC_STATUS["PERM_DENIED"] = 10] = "PERM_DENIED";
|
|
AFC_STATUS[AFC_STATUS["SERVICE_NOT_CONNECTED"] = 11] = "SERVICE_NOT_CONNECTED";
|
|
AFC_STATUS[AFC_STATUS["OP_TIMEOUT"] = 12] = "OP_TIMEOUT";
|
|
AFC_STATUS[AFC_STATUS["TOO_MUCH_DATA"] = 13] = "TOO_MUCH_DATA";
|
|
AFC_STATUS[AFC_STATUS["END_OF_DATA"] = 14] = "END_OF_DATA";
|
|
AFC_STATUS[AFC_STATUS["OP_NOT_SUPPORTED"] = 15] = "OP_NOT_SUPPORTED";
|
|
AFC_STATUS[AFC_STATUS["OBJECT_EXISTS"] = 16] = "OBJECT_EXISTS";
|
|
AFC_STATUS[AFC_STATUS["OBJECT_BUSY"] = 17] = "OBJECT_BUSY";
|
|
AFC_STATUS[AFC_STATUS["NO_SPACE_LEFT"] = 18] = "NO_SPACE_LEFT";
|
|
AFC_STATUS[AFC_STATUS["OP_WOULD_BLOCK"] = 19] = "OP_WOULD_BLOCK";
|
|
AFC_STATUS[AFC_STATUS["IO_ERROR"] = 20] = "IO_ERROR";
|
|
AFC_STATUS[AFC_STATUS["OP_INTERRUPTED"] = 21] = "OP_INTERRUPTED";
|
|
AFC_STATUS[AFC_STATUS["OP_IN_PROGRESS"] = 22] = "OP_IN_PROGRESS";
|
|
AFC_STATUS[AFC_STATUS["INTERNAL_ERROR"] = 23] = "INTERNAL_ERROR";
|
|
AFC_STATUS[AFC_STATUS["MUX_ERROR"] = 30] = "MUX_ERROR";
|
|
AFC_STATUS[AFC_STATUS["NO_MEM"] = 31] = "NO_MEM";
|
|
AFC_STATUS[AFC_STATUS["NOT_ENOUGH_DATA"] = 32] = "NOT_ENOUGH_DATA";
|
|
AFC_STATUS[AFC_STATUS["DIR_NOT_EMPTY"] = 33] = "DIR_NOT_EMPTY";
|
|
AFC_STATUS[AFC_STATUS["FORCE_SIGNED_TYPE"] = -1] = "FORCE_SIGNED_TYPE";
|
|
})(AFC_STATUS = exports.AFC_STATUS || (exports.AFC_STATUS = {}));
|
|
var AFC_FILE_OPEN_FLAGS;
|
|
(function (AFC_FILE_OPEN_FLAGS) {
|
|
/**
|
|
* r (O_RDONLY)
|
|
*/
|
|
AFC_FILE_OPEN_FLAGS[AFC_FILE_OPEN_FLAGS["RDONLY"] = 1] = "RDONLY";
|
|
/**
|
|
* r+ (O_RDWR | O_CREAT)
|
|
*/
|
|
AFC_FILE_OPEN_FLAGS[AFC_FILE_OPEN_FLAGS["RW"] = 2] = "RW";
|
|
/**
|
|
* w (O_WRONLY | O_CREAT | O_TRUNC)
|
|
*/
|
|
AFC_FILE_OPEN_FLAGS[AFC_FILE_OPEN_FLAGS["WRONLY"] = 3] = "WRONLY";
|
|
/**
|
|
* w+ (O_RDWR | O_CREAT | O_TRUNC)
|
|
*/
|
|
AFC_FILE_OPEN_FLAGS[AFC_FILE_OPEN_FLAGS["WR"] = 4] = "WR";
|
|
/**
|
|
* a (O_WRONLY | O_APPEND | O_CREAT)
|
|
*/
|
|
AFC_FILE_OPEN_FLAGS[AFC_FILE_OPEN_FLAGS["APPEND"] = 5] = "APPEND";
|
|
/**
|
|
* a+ (O_RDWR | O_APPEND | O_CREAT)
|
|
*/
|
|
AFC_FILE_OPEN_FLAGS[AFC_FILE_OPEN_FLAGS["RDAPPEND"] = 6] = "RDAPPEND";
|
|
})(AFC_FILE_OPEN_FLAGS = exports.AFC_FILE_OPEN_FLAGS || (exports.AFC_FILE_OPEN_FLAGS = {}));
|
|
function isAFCResponse(resp) {
|
|
return AFC_OPS[resp.operation] !== undefined && resp.id !== undefined && resp.data !== undefined;
|
|
}
|
|
function isStatusResponse(resp) {
|
|
return isAFCResponse(resp) && resp.operation === AFC_OPS.STATUS;
|
|
}
|
|
function isErrorStatusResponse(resp) {
|
|
return isStatusResponse(resp) && resp.data !== AFC_STATUS.SUCCESS;
|
|
}
|
|
class AFCInternalError extends Error {
|
|
constructor(msg, requestId) {
|
|
super(msg);
|
|
this.requestId = requestId;
|
|
}
|
|
}
|
|
class AFCError extends Error {
|
|
constructor(msg, status) {
|
|
super(msg);
|
|
this.status = status;
|
|
}
|
|
}
|
|
exports.AFCError = AFCError;
|
|
class AFCProtocolClient extends protocol_1.ProtocolClient {
|
|
constructor(socket) {
|
|
super(socket, new protocol_1.ProtocolReaderFactory(AFCProtocolReader), new AFCProtocolWriter());
|
|
this.requestId = 0;
|
|
this.requestCallbacks = {};
|
|
const reader = this.readerFactory.create((resp, err) => {
|
|
if (err && err instanceof AFCInternalError) {
|
|
this.requestCallbacks[err.requestId](resp, err);
|
|
}
|
|
else if (isErrorStatusResponse(resp)) {
|
|
this.requestCallbacks[resp.id](resp, new AFCError(AFC_STATUS[resp.data], resp.data));
|
|
}
|
|
else {
|
|
this.requestCallbacks[resp.id](resp);
|
|
}
|
|
});
|
|
socket.on('data', reader.onData);
|
|
}
|
|
sendMessage(msg) {
|
|
return new Promise((resolve, reject) => {
|
|
const requestId = this.requestId++;
|
|
this.requestCallbacks[requestId] = async (resp, err) => {
|
|
if (err) {
|
|
reject(err);
|
|
return;
|
|
}
|
|
if (isAFCResponse(resp)) {
|
|
resolve(resp);
|
|
}
|
|
else {
|
|
reject(new Error('Malformed AFC response'));
|
|
}
|
|
};
|
|
this.writer.write(this.socket, { ...msg, requestId });
|
|
});
|
|
}
|
|
}
|
|
exports.AFCProtocolClient = AFCProtocolClient;
|
|
class AFCProtocolReader extends protocol_1.ProtocolReader {
|
|
constructor(callback) {
|
|
super(exports.AFC_HEADER_SIZE, callback);
|
|
}
|
|
parseHeader(data) {
|
|
const magic = data.slice(0, 8).toString('ascii');
|
|
if (magic !== exports.AFC_MAGIC) {
|
|
throw new AFCInternalError(`Invalid AFC packet received (magic != ${exports.AFC_MAGIC})`, data.readUInt32LE(24));
|
|
}
|
|
// technically these are uint64
|
|
this.header = {
|
|
magic,
|
|
totalLength: data.readUInt32LE(8),
|
|
headerLength: data.readUInt32LE(16),
|
|
requestId: data.readUInt32LE(24),
|
|
operation: data.readUInt32LE(32),
|
|
};
|
|
debug(`parse header: ${JSON.stringify(this.header)}`);
|
|
if (this.header.headerLength < exports.AFC_HEADER_SIZE) {
|
|
throw new AFCInternalError('Invalid AFC header', this.header.requestId);
|
|
}
|
|
return this.header.totalLength - exports.AFC_HEADER_SIZE;
|
|
}
|
|
parseBody(data) {
|
|
const body = {
|
|
operation: this.header.operation,
|
|
id: this.header.requestId,
|
|
data,
|
|
};
|
|
if (isStatusResponse(body)) {
|
|
const status = data.readUInt32LE(0);
|
|
debug(`${AFC_OPS[this.header.operation]} response: ${AFC_STATUS[status]}`);
|
|
body.data = status;
|
|
}
|
|
else if (data.length <= 8) {
|
|
debug(`${AFC_OPS[this.header.operation]} response: ${Array.prototype.toString.call(body)}`);
|
|
}
|
|
else {
|
|
debug(`${AFC_OPS[this.header.operation]} response length: ${data.length} bytes`);
|
|
}
|
|
return body;
|
|
}
|
|
}
|
|
exports.AFCProtocolReader = AFCProtocolReader;
|
|
class AFCProtocolWriter {
|
|
write(socket, msg) {
|
|
const { data, payload, operation, requestId } = msg;
|
|
const dataLength = data ? data.length : 0;
|
|
const payloadLength = payload ? payload.length : 0;
|
|
const header = Buffer.alloc(exports.AFC_HEADER_SIZE);
|
|
const magic = Buffer.from(exports.AFC_MAGIC);
|
|
magic.copy(header);
|
|
header.writeUInt32LE(exports.AFC_HEADER_SIZE + dataLength + payloadLength, 8);
|
|
header.writeUInt32LE(exports.AFC_HEADER_SIZE + dataLength, 16);
|
|
header.writeUInt32LE(requestId, 24);
|
|
header.writeUInt32LE(operation, 32);
|
|
socket.write(header);
|
|
socket.write(data);
|
|
if (data.length <= 8) {
|
|
debug(`socket write, header: { requestId: ${requestId}, operation: ${AFC_OPS[operation]}}, body: ${Array.prototype.toString.call(data)}`);
|
|
}
|
|
else {
|
|
debug(`socket write, header: { requestId: ${requestId}, operation: ${AFC_OPS[operation]}}, body: ${data.length} bytes`);
|
|
}
|
|
debug(`socket write, bytes written ${header.length} (header), ${data.length} (body)`);
|
|
if (payload) {
|
|
socket.write(payload);
|
|
}
|
|
}
|
|
}
|
|
exports.AFCProtocolWriter = AFCProtocolWriter;
|