frida 16.7.13 → 16.7.15

package/dist/index.js

@@ -1,170 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDevice = exports.getUsbDevice = exports.getRemoteDevice = exports.getLocalDevice = exports.getDeviceManager = exports.enumerateDevices = exports.injectLibraryBlob = exports.injectLibraryFile = exports.attach = exports.kill = exports.resume = exports.spawn = exports.querySystemParameters = exports.Service = exports.Bus = exports.ChildOrigin = exports.Cancellable = exports.IOStream = exports.EndpointParameters = exports.PortalService = exports.PortalMembership = exports.RelayKind = exports.Relay = exports.LogLevel = exports.MessageType = exports.ScriptRuntime = exports.Script = exports.SessionDetachReason = exports.Session = exports.Realm = exports.Stdio = exports.Scope = exports.DeviceType = exports.Device = exports.DeviceManager = void 0;
-const busModule = require("./bus");
-const cancellableModule = require("./cancellable");
-const childModule = require("./child");
-const deviceManagerModule = require("./device_manager");
-const deviceModule = require("./device");
-const endpointParametersModule = require("./endpoint_parameters");
-const iostreamModule = require("./iostream");
-const portalMembershipModule = require("./portal_membership");
-const portalServiceModule = require("./portal_service");
-const relayModule = require("./relay");
-const scriptModule = require("./script");
-const serviceModule = require("./service");
-const sessionModule = require("./session");
-exports.DeviceManager = deviceManagerModule.DeviceManager;
-exports.Device = deviceModule.Device;
-exports.DeviceType = deviceModule.DeviceType;
-exports.Scope = deviceModule.Scope;
-exports.Stdio = deviceModule.Stdio;
-exports.Realm = deviceModule.Realm;
-exports.Session = sessionModule.Session;
-exports.SessionDetachReason = sessionModule.SessionDetachReason;
-exports.Script = scriptModule.Script;
-exports.ScriptRuntime = scriptModule.ScriptRuntime;
-exports.MessageType = scriptModule.MessageType;
-exports.LogLevel = scriptModule.LogLevel;
-exports.Relay = relayModule.Relay;
-exports.RelayKind = relayModule.RelayKind;
-exports.PortalMembership = portalMembershipModule.PortalMembership;
-exports.PortalService = portalServiceModule.PortalService;
-exports.EndpointParameters = endpointParametersModule.EndpointParameters;
-exports.IOStream = iostreamModule.IOStream;
-exports.Cancellable = cancellableModule.Cancellable;
-exports.ChildOrigin = childModule.ChildOrigin;
-exports.Bus = busModule.Bus;
-exports.Service = serviceModule.Service;
-let sharedDeviceManager = null;
-async function querySystemParameters(cancellable) {
-    const device = await getLocalDevice(cancellable);
-    return await device.querySystemParameters(cancellable);
-}
-exports.querySystemParameters = querySystemParameters;
-async function spawn(program, options = {}, cancellable) {
-    const device = await getLocalDevice(cancellable);
-    return await device.spawn(program, options, cancellable);
-}
-exports.spawn = spawn;
-async function resume(target, cancellable) {
-    const device = await getLocalDevice(cancellable);
-    await device.resume(target, cancellable);
-}
-exports.resume = resume;
-async function kill(target, cancellable) {
-    const device = await getLocalDevice(cancellable);
-    await device.kill(target, cancellable);
-}
-exports.kill = kill;
-async function attach(target, options = {}, cancellable) {
-    const device = await getLocalDevice(cancellable);
-    return await device.attach(target, options, cancellable);
-}
-exports.attach = attach;
-async function injectLibraryFile(target, path, entrypoint, data, cancellable) {
-    const device = await getLocalDevice(cancellable);
-    return await device.injectLibraryFile(target, path, entrypoint, data, cancellable);
-}
-exports.injectLibraryFile = injectLibraryFile;
-async function injectLibraryBlob(target, blob, entrypoint, data, cancellable) {
-    const device = await getLocalDevice(cancellable);
-    return await device.injectLibraryBlob(target, blob, entrypoint, data, cancellable);
-}
-exports.injectLibraryBlob = injectLibraryBlob;
-async function enumerateDevices(cancellable) {
-    const deviceManager = getDeviceManager();
-    return await deviceManager.enumerateDevices(cancellable);
-}
-exports.enumerateDevices = enumerateDevices;
-;
-function getDeviceManager() {
-    if (sharedDeviceManager === null) {
-        sharedDeviceManager = new deviceManagerModule.DeviceManager();
-    }
-    return sharedDeviceManager;
-}
-exports.getDeviceManager = getDeviceManager;
-function getLocalDevice(cancellable) {
-    return getMatchingDevice(device => device.type === exports.DeviceType.Local, {}, cancellable);
-}
-exports.getLocalDevice = getLocalDevice;
-function getRemoteDevice(cancellable) {
-    return getMatchingDevice(device => device.type === exports.DeviceType.Remote, {}, cancellable);
-}
-exports.getRemoteDevice = getRemoteDevice;
-function getUsbDevice(options, cancellable) {
-    return getMatchingDevice(device => device.type === exports.DeviceType.Usb, options, cancellable);
-}
-exports.getUsbDevice = getUsbDevice;
-function getDevice(id, options, cancellable) {
-    return getMatchingDevice(device => device.id === id, options, cancellable);
-}
-exports.getDevice = getDevice;
-async function getMatchingDevice(predicate, options = {}, cancellable) {
-    const device = await findMatchingDevice(predicate, cancellable);
-    if (device !== null) {
-        return device;
-    }
-    const { timeout = 0 } = options;
-    if (timeout === 0) {
-        throw new Error("Device not found");
-    }
-    const getDeviceEventually = new Promise((resolve, reject) => {
-        const deviceManager = getDeviceManager();
-        deviceManager.added.connect(onDeviceAdded);
-        const timer = (timeout !== null) ? setTimeout(onTimeout, timeout) : null;
-        if (cancellable !== undefined) {
-            cancellable.cancelled.connect(onCancel);
-            if (cancellable.isCancelled) {
-                onCancel();
-                return;
-            }
-        }
-        findMatchingDevice(predicate, cancellable)
-            .then(device => {
-            if (device !== null) {
-                onSuccess(device);
-            }
-        })
-            .catch(onError);
-        function onDeviceAdded(device) {
-            if (predicate(device)) {
-                onSuccess(device);
-            }
-        }
-        function onSuccess(device) {
-            stopMonitoring();
-            resolve(device);
-        }
-        function onError(error) {
-            stopMonitoring();
-            reject(error);
-        }
-        function onTimeout() {
-            onError(new Error("Timed out while waiting for device to appear"));
-        }
-        function onCancel() {
-            onError(new Error("Operation was cancelled"));
-        }
-        function stopMonitoring() {
-            if (cancellable !== undefined) {
-                cancellable.cancelled.disconnect(onCancel);
-            }
-            if (timer !== null) {
-                clearTimeout(timer);
-            }
-            deviceManager.added.disconnect(onDeviceAdded);
-        }
-    });
-    return await getDeviceEventually;
-}
-async function findMatchingDevice(predicate, cancellable) {
-    const deviceManager = getDeviceManager();
-    const devices = await deviceManager.enumerateDevices(cancellable);
-    const matching = devices.filter(predicate);
-    if (matching.length === 0) {
-        return null;
-    }
-    return matching[0];
-}

package/dist/iostream.d.ts

@@ -1,13 +0,0 @@
-/// <reference types="node" />
-/// <reference types="node" />
-import { Duplex } from "stream";
-export declare class IOStream extends Duplex {
-    private impl;
-    private pending;
-    private cancellable;
-    constructor(impl: any);
-    _destroy(error: Error | null, callback: (error: Error | null) => void): Promise<void>;
-    _read(size: number): void;
-    _write(chunk: any, encoding: BufferEncoding, callback: (error?: Error | null) => void): void;
-    private track;
-}

package/dist/iostream.js

@@ -1,73 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IOStream = void 0;
-const cancellable_1 = require("./cancellable");
-const stream_1 = require("stream");
-class IOStream extends stream_1.Duplex {
-    constructor(impl) {
-        super({});
-        this.impl = impl;
-        this.pending = new Set();
-        this.cancellable = new cancellable_1.Cancellable();
-    }
-    async _destroy(error, callback) {
-        this.cancellable.cancel();
-        for (const operation of this.pending) {
-            try {
-                await operation;
-            }
-            catch (e) {
-            }
-        }
-        try {
-            await this.impl.close();
-        }
-        catch (e) {
-        }
-        callback(error);
-    }
-    _read(size) {
-        const operation = this.impl.read(size, this.cancellable)
-            .then((data) => {
-            const isEof = data.length === 0;
-            if (isEof) {
-                this.push(null);
-                return;
-            }
-            this.push(data);
-        })
-            .catch((error) => {
-            if (this.impl.isClosed) {
-                this.push(null);
-            }
-            this.emit("error", error);
-        });
-        this.track(operation);
-    }
-    _write(chunk, encoding, callback) {
-        let data;
-        if (Buffer.isBuffer(chunk)) {
-            data = chunk;
-        }
-        else {
-            data = Buffer.from(chunk, encoding);
-        }
-        const operation = this.impl.write(data, this.cancellable)
-            .then(() => {
-            callback(null);
-        })
-            .catch((error) => {
-            callback(error);
-        });
-        this.track(operation);
-    }
-    track(operation) {
-        this.pending.add(operation);
-        operation
-            .catch(_ => { })
-            .finally(() => {
-            this.pending.delete(operation);
-        });
-    }
-}
-exports.IOStream = IOStream;

package/dist/native.d.ts

@@ -1 +0,0 @@
-export declare const binding: any;

package/dist/native.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.binding = void 0;
-const bindings = require("bindings");
-exports.binding = bindings({
-    bindings: "frida_binding",
-    try: [
-        ["module_root", "build", "bindings"],
-        [process.cwd(), "bindings"],
-    ]
-});

package/dist/portal_membership.d.ts

@@ -1,6 +0,0 @@
-import { Cancellable } from "./cancellable";
-export declare class PortalMembership {
-    private impl;
-    constructor(impl: any);
-    terminate(cancellable?: Cancellable): Promise<void>;
-}

package/dist/portal_membership.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PortalMembership = void 0;
-class PortalMembership {
-    constructor(impl) {
-        this.impl = impl;
-    }
-    terminate(cancellable) {
-        return this.impl.terminate(cancellable);
-    }
-}
-exports.PortalMembership = PortalMembership;

package/dist/portal_service.d.ts

@@ -1,48 +0,0 @@
-/// <reference types="node" />
-/// <reference types="node" />
-import { Application } from "./application";
-import { AuthenticatedSessionInfo } from "./authentication";
-import { Cancellable } from "./cancellable";
-import { Device } from "./device";
-import { EndpointParameters } from "./endpoint_parameters";
-import { Signal } from "./signals";
-import { SocketAddress } from "./socket_address";
-import { inspect } from "util";
-export declare class PortalService {
-    nodeConnected: Signal<PortalNodeConnectedHandler>;
-    nodeJoined: Signal<PortalNodeJoinedHandler>;
-    nodeLeft: Signal<PortalNodeLeftHandler>;
-    nodeDisconnected: Signal<PortalNodeDisconnectedHandler>;
-    controllerConnected: Signal<PortalControllerConnectedHandler>;
-    controllerDisconnected: Signal<PortalControllerDisconnectedHandler>;
-    authenticated: Signal<PortalAuthenticatedHandler>;
-    subscribe: Signal<PortalSubscribeHandler>;
-    message: Signal<PortalMessageHandler>;
-    device: Device;
-    private impl;
-    constructor({ clusterParams, controlParams }?: PortalServiceOptions);
-    start(cancellable?: Cancellable): Promise<void>;
-    stop(cancellable?: Cancellable): Promise<void>;
-    post(connectionId: PortalConnectionId, message: any, data?: Buffer | null): void;
-    narrowcast(tag: PortalConnectionTag, message: any, data?: Buffer | null): void;
-    broadcast(message: any, data?: Buffer | null): void;
-    enumerateTags(connectionId: PortalConnectionId): Promise<PortalConnectionTag[]>;
-    tag(connectionId: PortalConnectionId, tag: PortalConnectionTag): void;
-    untag(connectionId: PortalConnectionId, tag: PortalConnectionTag): void;
-    [inspect.custom](): string;
-}
-export interface PortalServiceOptions {
-    clusterParams?: EndpointParameters;
-    controlParams?: EndpointParameters;
-}
-export type PortalConnectionId = number;
-export type PortalConnectionTag = string;
-export type PortalNodeConnectedHandler = (connectionId: PortalConnectionId, remoteAddress: SocketAddress) => void;
-export type PortalNodeJoinedHandler = (connectionId: PortalConnectionId, application: Application) => void;
-export type PortalNodeLeftHandler = (connectionId: PortalConnectionId, application: Application) => void;
-export type PortalNodeDisconnectedHandler = (connectionId: PortalConnectionId, remoteAddress: SocketAddress) => void;
-export type PortalControllerConnectedHandler = (connectionId: PortalConnectionId, remoteAddress: SocketAddress) => void;
-export type PortalControllerDisconnectedHandler = (connectionId: PortalConnectionId, remoteAddress: SocketAddress) => void;
-export type PortalAuthenticatedHandler = (connectionId: PortalConnectionId, sessionInfo: AuthenticatedSessionInfo) => void;
-export type PortalSubscribeHandler = (connectionId: PortalConnectionId) => void;
-export type PortalMessageHandler = (connectionId: PortalConnectionId, message: any, data: Buffer | null) => void;

package/dist/portal_service.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PortalService = void 0;
-const device_1 = require("./device");
-const native_1 = require("./native");
-const signals_1 = require("./signals");
-const util_1 = require("util");
-class PortalService {
-    constructor({ clusterParams = null, controlParams = null } = {}) {
-        const impl = new native_1.binding.PortalService(clusterParams, controlParams);
-        this.impl = impl;
-        this.device = new device_1.Device(impl.device);
-        const { signals } = impl;
-        this.nodeConnected = new signals_1.Signal(signals, "node-connected");
-        this.nodeJoined = new signals_1.Signal(signals, "node-joined");
-        this.nodeLeft = new signals_1.Signal(signals, "node-left");
-        this.nodeDisconnected = new signals_1.Signal(signals, "node-disconnected");
-        this.controllerConnected = new signals_1.Signal(signals, "controller-connected");
-        this.controllerDisconnected = new signals_1.Signal(signals, "controller-disconnected");
-        this.authenticated = new signals_1.Signal(signals, "authenticated");
-        this.subscribe = new signals_1.Signal(signals, "subscribe");
-        this.message = new signals_1.Signal(signals, "message");
-    }
-    start(cancellable) {
-        return this.impl.start(cancellable);
-    }
-    stop(cancellable) {
-        return this.impl.stop(cancellable);
-    }
-    post(connectionId, message, data = null) {
-        this.impl.post(connectionId, message, data);
-    }
-    narrowcast(tag, message, data = null) {
-        this.impl.narrowcast(tag, message, data);
-    }
-    broadcast(message, data = null) {
-        this.impl.broadcast(message, data);
-    }
-    enumerateTags(connectionId) {
-        return this.impl.enumerateTags(connectionId);
-    }
-    tag(connectionId, tag) {
-        this.impl.tag(connectionId, tag);
-    }
-    untag(connectionId, tag) {
-        this.impl.untag(connectionId, tag);
-    }
-    [util_1.inspect.custom]() {
-        return "PortalService {}";
-    }
-}
-exports.PortalService = PortalService;

package/dist/process.d.ts

@@ -1,47 +0,0 @@
-import { Icon } from "./icon";
-import { SystemParameters } from "./system_parameters";
-export interface Process {
-    pid: number;
-    name: string;
-    parameters: ProcessParameters;
-}
-/**
- * Process parameters typically obtained through `enumerateProcesses({ scope })`, where
- * `scope` is either `Scope.Metadata` or `Scope.Full`. The default of `Scope.Minimal`
- * means no parameters will be included.
- */
-export interface ProcessParameters {
-    /**
-     * Filesystem path of program.
-     */
-    path?: string;
-    /**
-     * Name of user that the process is running as.
-     */
-    user?: string;
-    /**
-     * Parent process ID.
-     */
-    ppid?: number;
-    /**
-     * When the process was started.
-     */
-    started?: Date;
-    /**
-     * Application IDs that have code running inside this process.
-     */
-    applications?: string[];
-    /**
-     * Whether the process is currently frontmost.
-     */
-    frontmost?: boolean;
-    /**
-     * One or more icons. Only included when `scope` is set to `Scope.Full`.
-     */
-    icons?: Icon[];
-    /**
-     * System parameters, available for processes accessed through a portal.
-     */
-    system?: SystemParameters;
-    [name: string]: any;
-}

package/dist/process.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/relay.d.ts

@@ -1,22 +0,0 @@
-/// <reference types="node" />
-import { inspect } from "util";
-export declare class Relay {
-    private impl;
-    constructor({ address, username, password, kind }: RelayProperties);
-    get address(): string;
-    get username(): string;
-    get password(): string;
-    get kind(): RelayKind;
-    [inspect.custom](depth: any, options: any): string;
-}
-export interface RelayProperties {
-    address: string;
-    username: string;
-    password: string;
-    kind: RelayKind;
-}
-export declare enum RelayKind {
-    TurnUDP = "turn-udp",
-    TurnTCP = "turn-tcp",
-    TurnTLS = "turn-tls"
-}

package/dist/relay.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RelayKind = exports.Relay = void 0;
-const native_1 = require("./native");
-const util_1 = require("util");
-class Relay {
-    constructor({ address, username, password, kind }) {
-        this.impl = new native_1.binding.Relay(address, username, password, kind);
-    }
-    get address() {
-        return this.impl.address;
-    }
-    get username() {
-        return this.impl.username;
-    }
-    get password() {
-        return this.impl.password;
-    }
-    get kind() {
-        return this.impl.kind;
-    }
-    [util_1.inspect.custom](depth, options) {
-        return (0, util_1.inspect)(this.impl, Object.assign(Object.assign({}, options), { depth }));
-    }
-}
-exports.Relay = Relay;
-var RelayKind;
-(function (RelayKind) {
-    RelayKind["TurnUDP"] = "turn-udp";
-    RelayKind["TurnTCP"] = "turn-tcp";
-    RelayKind["TurnTLS"] = "turn-tls";
-})(RelayKind || (exports.RelayKind = RelayKind = {}));

package/dist/script.d.ts

@@ -1,70 +0,0 @@
-/// <reference types="node" />
-/// <reference types="node" />
-import { Cancellable } from "./cancellable";
-import { Signal } from "./signals";
-import { inspect } from "util";
-export declare class Script {
-    private impl;
-    destroyed: Signal<ScriptDestroyedHandler>;
-    message: Signal<ScriptMessageHandler>;
-    private exportsProxy;
-    private logHandlerImpl;
-    constructor(impl: any);
-    get isDestroyed(): boolean;
-    get exports(): ScriptExports;
-    get logHandler(): ScriptLogHandler;
-    set logHandler(handler: ScriptLogHandler);
-    get defaultLogHandler(): ScriptLogHandler;
-    load(cancellable?: Cancellable): Promise<void>;
-    unload(cancellable?: Cancellable): Promise<void>;
-    eternalize(cancellable?: Cancellable): Promise<void>;
-    post(message: any, data?: Buffer | null): void;
-    enableDebugger(options?: EnableDebuggerOptions, cancellable?: Cancellable): Promise<void>;
-    disableDebugger(cancellable?: Cancellable): Promise<void>;
-    [inspect.custom](depth: any, options: any): string;
-}
-export interface ScriptOptions {
-    name?: string;
-    snapshot?: Buffer;
-    runtime?: ScriptRuntime;
-}
-export interface SnapshotOptions {
-    warmupScript?: string;
-    runtime?: ScriptRuntime;
-}
-export declare enum ScriptRuntime {
-    Default = "default",
-    QJS = "qjs",
-    V8 = "v8"
-}
-export type ScriptDestroyedHandler = () => void;
-export type ScriptMessageHandler = (message: Message, data: Buffer | null) => void;
-export type ScriptLogHandler = (level: LogLevel, text: string) => void;
-export type Message = SendMessage | ErrorMessage;
-export declare enum MessageType {
-    Send = "send",
-    Error = "error"
-}
-export interface SendMessage {
-    type: MessageType.Send;
-    payload: any;
-}
-export interface ErrorMessage {
-    type: MessageType.Error;
-    description: string;
-    stack?: string;
-    fileName?: string;
-    lineNumber?: number;
-    columnNumber?: number;
-}
-export interface ScriptExports {
-    [name: string]: (...args: any[]) => Promise<any>;
-}
-export declare enum LogLevel {
-    Info = "info",
-    Warning = "warning",
-    Error = "error"
-}
-export interface EnableDebuggerOptions {
-    port?: number;
-}