frida 16.2.0 → 16.2.2

package/BSDmakefile

@@ -0,0 +1,6 @@
+all: .DEFAULT
+
+.DEFAULT:
+	@gmake ${.MAKEFLAGS} ${.TARGETS}
+
+.PHONY: all

package/Makefile

@@ -0,0 +1,16 @@
+PYTHON ?= $(shell which python3 >/dev/null && echo python3 || echo python)
+
+all $(MAKECMDGOALS):
+	@$(PYTHON) \
+		-c "import sys; sys.path.insert(0, sys.argv[1]); from releng.meson_make import main; main()" \
+		"$(shell pwd)" \
+		./build \
+		$(MAKECMDGOALS)
+
+git-submodules:
+	@if [ ! -f releng/meson/meson.py ]; then \
+		git submodule update --init --recursive --depth 1; \
+	fi
+-include git-submodules
+
+.PHONY: all $(MAKECMDGOALS)

package/README.md

@@ -15,13 +15,22 @@ Node.js bindings for [Frida](https://frida.re).
 Install from binary:
 
 ```sh
-npm install
+$ npm install frida
 ```
 
 Install from source:
 
 ```sh
-FRIDA=/absolute/path/to/fully/compiled/frida/repo npm install
+$ make
+$ npm install
+```
+
+Build for Electron:
+
+```sh
+$ ./configure --with-runtime=electron --with-target=27.0.0
+$ make
+$ npm install
 ```
 
 ## Examples
@@ -37,20 +46,14 @@ FRIDA=/absolute/path/to/fully/compiled/frida/repo npm install
 
 ## Developing
 
-The [prebuild](https://github.com/mafintosh/prebuild) tool is used to handle
-building from source and packaging.
-
 To recompile only the C++ files that have changed, first run the
-"Install from source" step above, then simply run:
-
-```sh
-make -C build
-```
+"Install from source" step above, then simply run `make` again.
 
 ### Packaging
 
 ```sh
-npm run prebuild
+$ ./configure --with-runtime=electron --with-target=27.0.0
+$ make prebuild
 ```
 
 [npm-link]: https://www.npmjs.com/package/frida

package/configure

@@ -0,0 +1,18 @@
+#!/bin/sh
+
+[ -z "$PYTHON" ] && PYTHON=$(which python3 >/dev/null && echo python3 || echo python)
+
+cd $(dirname $0)
+
+srcroot=$(pwd)
+
+if [ ! -f releng/meson/meson.py ]; then
+  git submodule update --init --recursive --depth 1 || exit $?
+fi
+
+cd - >/dev/null
+
+exec "$PYTHON" \
+    -c "import sys; sys.path.insert(0, sys.argv[1]); from releng.meson_configure import main; main()" \
+    "$srcroot" \
+    "$@"

package/configure.bat

@@ -0,0 +1,22 @@
+@setlocal
+@echo off
+rem:: Based on: https://github.com/microsoft/terminal/issues/217#issuecomment-737594785
+goto :_start_
+
+:set_real_dp0
+set dp0=%~dp0
+set "dp0=%dp0:~0,-1%"
+goto :eof
+
+:_start_
+call :set_real_dp0
+
+if not exist "%dp0%\releng\meson\meson.py" (
+  pushd "%dp0%" & git submodule update --init --recursive --depth 1 & popd
+  if %errorlevel% neq 0 exit /b %errorlevel%
+)
+
+endlocal & goto #_undefined_# 2>nul || title %COMSPEC% & python ^
+    -c "import sys; sys.path.insert(0, sys.argv[1]); from releng.meson_configure import main; main()" ^
+    "%dp0%" ^
+    %*

package/dist/native.js

@@ -6,14 +6,6 @@ exports.binding = bindings({
     bindings: "frida_binding",
     try: [
         ["module_root", "build", "bindings"],
-        ["module_root", "build", "Debug", "bindings"],
-        ["module_root", "build", "Release", "bindings"],
-        ["module_root", "out", "Debug", "bindings"],
-        ["module_root", "Debug", "bindings"],
-        ["module_root", "out", "Release", "bindings"],
-        ["module_root", "Release", "bindings"],
-        ["module_root", "build", "default", "bindings"],
-        ["module_root", "compiled", "version", "platform", "arch", "bindings"],
         [process.cwd(), "bindings"],
     ]
 });

package/lib/application.ts

@@ -0,0 +1,98 @@
+import { Icon } from "./icon";
+import { SystemParameters } from "./system_parameters";
+
+export interface Application {
+    identifier: string;
+    name: string;
+    pid: number;
+    parameters: ApplicationParameters;
+}
+
+/**
+ * Application parameters typically obtained through `enumerateApplications({ scope })`,
+ * where `scope` is either `Scope.Metadata` or `Scope.Full`. The default of `Scope.Minimal`
+ * means no parameters will be included.
+ */
+export interface ApplicationParameters {
+    /**
+     * Version. Exposes `CFBundleShortVersionString` on Apple OSes, `versionName` on Android.
+     */
+    version?: string;
+
+    /**
+     * Build stamp. Exposes `CFBundleVersion` on Apple OSes, `versionCode` on Android.
+     */
+    build?: string;
+
+    /**
+     * Filesystem path of application. On Apple OSes this is where the bundle is.
+     */
+    path?: string;
+
+    /**
+     * Apple storage container locations.
+     */
+    containers?: {
+        /**
+         * Data container location.
+         */
+        data?: string;
+
+        /**
+         * App group container locations.
+         */
+        [name: string]: string | undefined;
+    }
+
+    /**
+     * Android source APKs. Exposes `publicSourceDir` followed by `splitPublicSourceDirs`.
+     */
+    sources?: string[];
+
+    /**
+     * Android data directory location.
+     */
+    dataDir?: string;
+
+    /**
+     * Android target SDK.
+     */
+    targetSdk?: number;
+
+    /**
+     * Whether the application is debuggable. Applicable on e.g. iOS and Android.
+     */
+    debuggable?: boolean;
+
+    /**
+     * If application is running, whether it is currently frontmost.
+     */
+    frontmost?: boolean;
+
+    /**
+     * If application is running, name of user that it is running as.
+     */
+    user?: string;
+
+    /**
+      * If application is running, PID of its parent process.
+      */
+    ppid?: number;
+
+    /**
+      * If application is running, when it was started.
+      */
+    started?: Date;
+
+    /**
+     * One or more icons. Only included when `scope` is set to `Scope.Full`.
+     */
+    icons?: Icon[];
+
+    /**
+     * System parameters, available for applications accessed through a portal.
+     */
+    system?: SystemParameters;
+
+    [name: string]: any;
+}

package/lib/authentication.ts

@@ -0,0 +1,3 @@
+export interface AuthenticatedSessionInfo {
+    [key: string]: any;
+}

package/lib/build.py

@@ -0,0 +1,50 @@
+from pathlib import Path
+import shutil
+import subprocess
+import sys
+
+
+def main(argv: list[str]):
+    outdir, privdir, npm, package_json, package_lock_json, tsconfig, \
+        *sources = [Path(s) for s in argv[1:]]
+
+    try:
+        privdir.mkdir(exist_ok=True)
+        for asset in [package_json, package_lock_json, tsconfig]:
+            shutil.copy(asset, privdir)
+
+        libdir = privdir / "lib"
+        if libdir.exists():
+            shutil.rmtree(libdir)
+        libdir.mkdir()
+        for asset in sources:
+            shutil.copy(asset, libdir)
+
+        distdir = privdir / "dist"
+        if distdir.exists():
+            shutil.rmtree(distdir)
+
+        run_kwargs = {
+            "stdout": subprocess.PIPE,
+            "stderr": subprocess.STDOUT,
+            "encoding": "utf-8",
+            "check": True,
+        }
+        subprocess.run([npm, "install", "--ignore-scripts"],
+                       cwd=privdir,
+                       **run_kwargs)
+        subprocess.run([npm, "run", "build"],
+                       cwd=privdir,
+                       **run_kwargs)
+
+        for asset in sources:
+            for ext in [".js", ".d.ts"]:
+                shutil.copy(distdir / (asset.stem + ext), outdir)
+    except subprocess.CalledProcessError as e:
+        print(e, file=sys.stderr)
+        print("Output:\n\t| " + "\n\t| ".join(e.output.strip().split("\n")), file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main(sys.argv)

package/lib/bus.ts

@@ -0,0 +1,30 @@
+import { Cancellable } from "./cancellable";
+import { Signals, Signal } from "./signals";
+
+import { inspect } from "util";
+
+export class Bus {
+    detached: Signal<BusDetachedHandler>;
+    message: Signal<BusMessageHandler>;
+
+    constructor(private impl: any) {
+        const signals: Signals = impl.signals;
+        this.detached = new Signal<BusDetachedHandler>(signals, "detached");
+        this.message = new Signal<BusMessageHandler>(signals, "message");
+    }
+
+    attach(cancellable?: Cancellable): Promise<void> {
+        return this.impl.attach(cancellable);
+    }
+
+    post(message: any, data: Buffer | null = null): void {
+        this.impl.post(message, data);
+    }
+
+    [inspect.custom](depth, options) {
+        return "Bus {}";
+    }
+}
+
+export type BusDetachedHandler = () => void;
+export type BusMessageHandler = (message: any, data: Buffer | null) => void;

package/lib/cancellable.ts

@@ -0,0 +1,33 @@
+import { binding } from "./native";
+import { Signal } from "./signals";
+
+import { inspect } from "util";
+
+export class Cancellable {
+    private impl = new binding.Cancellable();
+
+    cancelled: Signal<CancelledHandler>;
+
+    constructor() {
+        const { signals } = this.impl;
+        this.cancelled = new Signal<CancelledHandler>(signals, "cancelled");
+    }
+
+    get isCancelled(): boolean {
+        return this.impl.isCancelled;
+    }
+
+    throwIfCancelled(): void {
+        this.impl.throwIfCancelled();
+    }
+
+    cancel(): void {
+        return this.impl.cancel();
+    }
+
+    [inspect.custom]() {
+        return "Cancellable {}";
+    }
+}
+
+export type CancelledHandler = () => void;

package/lib/child.ts

@@ -0,0 +1,15 @@
+export interface Child {
+    pid: number;
+    parentPid: number;
+    origin: ChildOrigin;
+    identifier: string | null;
+    path: string | null;
+    argv: string[] | null;
+    envp: { [name: string]: string } | null;
+}
+
+export enum ChildOrigin {
+    Fork = "fork",
+    Exec = "exec",
+    Spawn = "spawn"
+}

package/lib/crash.ts

@@ -0,0 +1,11 @@
+export interface Crash {
+    pid: number;
+    processName: string;
+    summary: string;
+    report: string;
+    parameters: CrashParameters;
+}
+
+export interface CrashParameters {
+    [name: string]: string | number | boolean;
+}