frida-test 0.3.2 → 0.4.0

package/README.md

@@ -1,5 +1,7 @@
 # frida-test Documentation
 
+[![Test frida-test](https://github.com/bernhste/frida-test/actions/workflows/test.yml/badge.svg)](https://github.com/bernhste/frida-test/actions/workflows/test.yml)
+
 This is a small test framework which runs on the target. It is used to unit test Frida code running on actual devices. It was originally developed to test the Frida agent code used in [frooky](https://github.com/cpholguera/frooky).
 
 The following chapters explain how to write and run tests.
@@ -10,7 +12,7 @@ The following chapters explain how to write and run tests.
 npm install --save-dev frida-test
 ```
 
-After the installation, import the type `frida-test` into you project by adding the following configuration to the `tsconfig.json`:
+After the installation, import the type `frida-test` into your project by adding the following configuration to the `tsconfig.json`:
 
 ```json
 {
@@ -42,28 +44,9 @@ describe('Classloader', () => {
 
 Tests can be nested to any depth and can be synchronous or asynchronous.
 
-### Test discovery
-
-The framework collects every file matching `*.test.ts` in the directories passed on the command line, recursively.
-
-A good practice is to create test files next to the source code file as shown here:
-
-```text
-myProject/
-├── android/
-│   ├── classLoader.ts
-│   └── classLoader.test.ts
-├── ios/
-│   ├── objcRuntime.ts
-│   └── objcRuntime.test.ts
-└── shared/
-    ├── helper.ts
-    └── helper.test.ts
-```
-
 ## Matchers
 
-`expect(actualValue)` returns a `Matcher` which we can use to test for the expected value. Use the following functions to do that:
+`expect(actualValue)` returns a `Matchers` object which we can use to test for the expected value. Use the following functions to do that:
 
 | Matcher | Description |
 | --- | --- |
@@ -76,15 +59,73 @@ myProject/
 | `.toBeUndefined()` | Value is `undefined` |
 | `.toBeGreaterThan(value)` | Numeric value is greater than `value` |
 | `.toBeLessThan(value)` | Numeric value is less than `value` |
-| `.toContain(value)` | Value (array, string, etc.) contains `value` |
-| `.toThrow(errorMatch)` | Exception thrown; optionally matches a string message or `Error` instance |
-| `.toReject(errorMatch)` | Returned promise rejects; optionally matches a string message or `Error` instance (must be `await`ed) |
-| `.toHaveBeenCalled()` | Spy target function was called at least once |
-| `.toHaveBeenCalledWith(...expected)` | Spy target function was called with expected arguments |
-| `.not.<matcher>` | Inverts the assertion result |
+| `.toContain(value)` | Array, `Set`, or string contains `value` (array/`Set` items compared with `===`) |
+| `.toContainEqual(value)` | Array or `Set` contains an item deeply equal to `value` |
+| `.toThrow(errorMatch?)` | Function throws; `errorMatch` can be a substring, a `RegExp` matched against the message, an `Error` instance (message equality only), or an `Error` class (`instanceof` check) |
+| `.toHaveBeenCalled()` | Mock/spy was called at least once |
+| `.toHaveBeenCalledTimes(count)` | Mock/spy was called exactly `count` times |
+| `.toHaveBeenCalledWith(...expected)` | Mock/spy was called (at any point) with the expected arguments |
+| `.toHaveBeenLastCalledWith(...expected)` | Mock/spy's most recent call had the expected arguments |
+| `.toHaveBeenNthCalledWith(n, ...expected)` | Mock/spy's `n`th call (1-indexed) had the expected arguments |
 
 > [!NOTE]
-> `frida-test` test itself. So for examples for all Matches and more, have a look a the `*.test.ts` located in the [test folder](./tests/)
+> `frida-test` tests itself. So for examples of all matchers and more, have a look at the `*.test.ts` files located in the [test folder](./tests/).
+
+### Modifiers
+
+| Modifier | Description |
+| --- | --- |
+| `.not` | Inverts the assertion result, e.g. `expect(2 + 2).not.toBe(5)` |
+| `.resolves` | Unwraps a resolved promise so a matcher applies to its value; the assertion must be `await`ed. The received value must actually be a `Promise` - it fails otherwise |
+| `.rejects` | Unwraps a rejected promise so a matcher applies to its reason; the assertion must be `await`ed. The received value must actually be a `Promise` - it fails otherwise |
+
+```typescript
+await expect(fetchUser(1)).resolves.toEqual({ id: 1, name: 'Ada' });
+await expect(fetchUser(-1)).rejects.toThrow('not found');
+
+// modifiers compose:
+await expect(fetchUser(1)).resolves.not.toBeNull();
+```
+
+## Mocking
+
+`frida-test` mocks and spies follow the same API shape as Jest's mock functions.
+
+- `fn(implementation?)`: creates a standalone mock function, optionally backed by `implementation`.
+- `spyOn(object, methodName)`: replaces `object[methodName]` with a mock that calls through to the original method by default, and can be restored later.
+
+Both forms return the same `Mock` type:
+
+```typescript
+const mock = fridaTest.fn((a: number, b: number) => a + b);
+mock(1, 2);
+
+expect(mock).toHaveBeenCalledWith(1, 2);
+mock.mock.calls;       // [[1, 2]]
+mock.mock.results;     // [{ type: "return", value: 3 }]
+
+mock.mockReturnValue(42);       // set a default return value
+mock.mockReturnValueOnce(99);   // ...for just the next call
+mock.mockResolvedValue(value);  // wraps value in Promise.resolve()
+mock.mockRejectedValue(error);  // wraps error in Promise.reject()
+mock.mockImplementation(impl);    // replace the implementation
+mock.mockImplementationOnce(impl); // ...for just the next call
+
+mock.mockClear();   // reset calls/results, keep the implementation
+mock.mockReset();   // reset calls/results and drop the implementation
+mock.mockRestore(); // reset like mockReset(); for spyOn(), also restores the original method
+```
+
+```typescript
+describe('Logger', () => {
+  it('should call the underlying console method', () => {
+    const spy = fridaTest.spyOn(console, 'log').mockImplementation(() => undefined);
+    logMessage('hello');
+    expect(spy).toHaveBeenCalledWith('hello');
+    spy.mockRestore();
+  });
+});
+```
 
 ### Setup and Teardown
 
@@ -169,7 +210,7 @@ frida-test -U -N org.owasp.mastestapp.MASTestApp-iOS ./tests/ios ./tests/shared
 frida-test -H 192.168.1.10:27042 --token secret -p 4926 ./tests/shared
 ```
 
-## Compile Agent
+## Compiling the Agent
 
 `frida-test` automatically bundles the test suites and compiles them together with the testing framework into a Frida agent.
 

package/bin/frida-test-compile.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import("../dist/cli-frida-test-compiler.js").catch((err) => {
+import("../dist/host/cli-frida-test-compiler.js").catch((err) => {
   console.error("Failed to load the CLI module. Make sure the project is built.");
   console.error(err);
   process.exit(1);

package/bin/frida-test.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import("../dist/cli-frida-test.js").catch((err) => {
+import("../dist/host/cli-frida-test.js").catch((err) => {
   console.error("Failed to load the CLI module. Make sure the project is built.");
   console.error(err);
   process.exit(1);

package/dist/host/bundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../src/host/bundler.ts"],"names":[],"mappings":"AAyFA,wBAAsB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,OAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DlG"}

package/dist/{bundler.js → host/bundler.js}

@@ -8,29 +8,28 @@ const IMPORT_MARKER = "/// IMPORT TESTS SUITES ///";
 const AGENT_ENTRYPOINT_FILENAME = "agentRuntime.ts";
 const AGENT_ENTRYPOINT_BASENAME = path.parse(AGENT_ENTRYPOINT_FILENAME).name;
 const AGENT_BUNDLE_FILENAME = `${AGENT_ENTRYPOINT_BASENAME}.bundle.js`;
-function getProjectRoot() {
-    const startDir = process.cwd();
+function findPackageRoot(startDir) {
     let dir = startDir;
     while (true) {
         if (existsSync(path.join(dir, "package.json")))
             return dir;
         const parent = path.dirname(dir);
         if (parent === dir)
-            return startDir;
+            return undefined;
         dir = parent;
     }
 }
+function getProjectRoot() {
+    const startDir = process.cwd();
+    return findPackageRoot(startDir) ?? startDir;
+}
 function getPackageRoot() {
-    let dir = path.dirname(fileURLToPath(import.meta.url));
-    while (true) {
-        if (existsSync(path.join(dir, "package.json")))
-            return dir;
-        const parent = path.dirname(dir);
-        if (parent === dir) {
-            throw new Error("Could not locate frida-test's own package.json.");
-        }
-        dir = parent;
+    const startDir = path.dirname(fileURLToPath(import.meta.url));
+    const root = findPackageRoot(startDir);
+    if (!root) {
+        throw new Error("Could not locate frida-test's own package.json.");
     }
+    return root;
 }
 function getAgentRuntimeSrcDir() {
     const dir = path.join(getPackageRoot(), "src", "agent-runtime");
@@ -99,7 +98,6 @@ export async function bundleAgent(testSuitePaths, keep = false) {
             return `import ${JSON.stringify(specifier)};`;
         })
             .join("\n");
-        await rm(entrypointPath, { force: true });
         await writeFile(entrypointPath, agentSource.replace(IMPORT_MARKER, importStatements), "utf8");
         await prepareTypeCheckConfig(projectRoot, workDir);
         const outfilePath = path.join(workDir, AGENT_BUNDLE_FILENAME);
@@ -115,7 +113,7 @@ export async function bundleAgent(testSuitePaths, keep = false) {
         catch (err) {
             throw new Error(`frida-compile failed for entrypoint "${entrypointPath}" with suites [${testSuitePaths.join(", ")}] (see compiler output above for details)`, { cause: err });
         }
-        logger.info(`Agent bundle sucessfully created and saved at ${outfilePath}.`);
+        logger.info(`Agent bundle successfully created and saved at ${outfilePath}.`);
         return await readFile(outfilePath, "utf8");
     }
     finally {

package/dist/host/cli-frida-test-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-frida-test-compiler.d.ts","sourceRoot":"","sources":["../../src/host/cli-frida-test-compiler.ts"],"names":[],"mappings":""}

package/dist/{cli-frida-test-compiler.js → host/cli-frida-test-compiler.js}

@@ -5,10 +5,10 @@ import { bundleAgent } from "./bundler.js";
 import { collectTestSuitePaths } from "./collector.js";
 import { logger } from "./logger.js";
 const usage = `
-  Usage: frida-test-compiler [options] <src_path>...
+  Usage: frida-test-compile [options] <src_path>...
 
   Options:
-    -o, --out <path>                Path of the output file for JSON reporter (default: disabled)
+    -o, --out <path>                Path of the output file for the compiled agent bundle (default: stdout)
     -h, --help                      Show this help message
 `;
 class CliError extends Error {

package/dist/host/cli-frida-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-frida-test.d.ts","sourceRoot":"","sources":["../../src/host/cli-frida-test.ts"],"names":[],"mappings":""}

package/dist/{cli-frida-test.js → host/cli-frida-test.js}

@@ -3,11 +3,12 @@ import { setTimeout as sleep } from "node:timers/promises";
 import { parseArgs } from "node:util";
 import { bundleAgent } from "./bundler.js";
 import { collectTestSuitePaths } from "./collector.js";
-import { resolveDevice, resolveTarget } from "./device.js";
+import { resolveDevice } from "./device.js";
 import { logger } from "./logger.js";
 import { writeRunSummaryJson } from "./reporter/json.js";
 import { printSummary } from "./reporter/summary.js";
 import { TestRunner } from "./runner.js";
+import { resolveTarget } from "./target.js";
 const usage = `
   Usage: frida-test [options] <src_path>...
 
@@ -28,7 +29,7 @@ const usage = `
     -o, --out <path>                Path of the output file for JSON reporter (default: disabled)
     -t, --timeout <s>               Abort the run after this many seconds (default: 600, 0 disables)
     -d, --delay <s>                 Start running the test suites after this many seconds (default: 0)
-    -k, --keep                      Keep the generated agent in .frida-test/agent.js
+    -k, --keep                      Keep the generated agent bundle in .frida-test-cache/
     -v, --verbose                   Enable verbose logging
     -h, --help                      Show this help message
 
@@ -106,7 +107,7 @@ async function main() {
     else if (values.usb) {
         deviceSelector = "usb";
     }
-    else if (values.host !== undefined || values.remote || hasRemoteParams) {
+    else if (values.host !== undefined || hasRemoteParams) {
         const keepaliveInterval = values["keepalive-interval"] !== undefined ? parseKeepaliveInterval(values["keepalive-interval"]) : undefined;
         deviceSelector = {
             host: values.host ?? "127.0.0.1:27042",
@@ -116,6 +117,9 @@ async function main() {
             ...(keepaliveInterval !== undefined && { keepaliveInterval }),
         };
     }
+    else if (values.remote) {
+        deviceSelector = "remote";
+    }
     else {
         deviceSelector = "local";
     }
@@ -179,7 +183,9 @@ async function main() {
         });
         let runSummary;
         try {
-            runSummary = await Promise.race([runner.runTests(), timeoutPromise]);
+            const testsPromise = runner.runTests();
+            testsPromise.catch(() => { });
+            runSummary = await Promise.race([testsPromise, timeoutPromise]);
         }
         finally {
             if (timerId)

package/dist/host/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/host/collector.ts"],"names":[],"mappings":"AA8CA,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAIjF"}

package/dist/host/collector.js

@@ -0,0 +1,40 @@
+import { readdir, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+const TEST_FILE_SUFFIX = ".test.ts";
+const EXCLUDED_DIR_NAMES = new Set(["node_modules", ".git"]);
+async function walkDirectory(dirPath) {
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    const found = await Promise.all(entries.map((entry) => {
+        if (entry.isDirectory()) {
+            return EXCLUDED_DIR_NAMES.has(entry.name) ? [] : walkDirectory(join(dirPath, entry.name));
+        }
+        if (entry.isFile() && entry.name.endsWith(TEST_FILE_SUFFIX)) {
+            return [join(dirPath, entry.name)];
+        }
+        return [];
+    }));
+    return found.flat();
+}
+async function findTestFiles(absolutePath) {
+    let fileInfo;
+    try {
+        fileInfo = await stat(absolutePath);
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new Error(`Path does not exist: ${absolutePath}`, { cause: err });
+        }
+        throw new Error(`Unable to access path "${absolutePath}": ${err.message}`, { cause: err });
+    }
+    if (fileInfo.isDirectory()) {
+        return walkDirectory(absolutePath);
+    }
+    if (absolutePath.endsWith(TEST_FILE_SUFFIX)) {
+        return [absolutePath];
+    }
+    throw new Error(`Not a *${TEST_FILE_SUFFIX} file: ${absolutePath}`);
+}
+export async function collectTestSuitePaths(srcPaths) {
+    const results = await Promise.all(srcPaths.map((p) => findTestFiles(resolve(p))));
+    return [...new Set(results.flat())].sort();
+}

package/dist/host/device.d.ts

@@ -0,0 +1,12 @@
+import type { Device } from "frida";
+export type DeviceSelector = "usb" | "local" | "remote" | {
+    id: string;
+} | {
+    host: string;
+    certificate?: string;
+    origin?: string;
+    token?: string;
+    keepaliveInterval?: number;
+};
+export declare function resolveDevice(selector?: DeviceSelector): Promise<Device>;
+//# sourceMappingURL=device.d.ts.map

package/dist/host/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/host/device.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAGpC,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,OAAO,GACP,QAAQ,GACR;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACd;IACE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEN,wBAAsB,aAAa,CAAC,QAAQ,GAAE,cAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAcvF"}

package/dist/host/device.js

@@ -0,0 +1,19 @@
+import frida from "frida";
+export async function resolveDevice(selector = "local") {
+    if (selector === "usb")
+        return frida.getUsbDevice();
+    if (selector === "local")
+        return frida.getLocalDevice();
+    if (selector === "remote")
+        return frida.getRemoteDevice();
+    if ("id" in selector)
+        return frida.getDevice(selector.id);
+    // Pass network parameters to addRemoteDevice
+    const manager = frida.getDeviceManager();
+    return manager.addRemoteDevice(selector.host, {
+        certificate: selector.certificate,
+        origin: selector.origin,
+        token: selector.token,
+        keepaliveInterval: selector.keepaliveInterval,
+    });
+}

package/dist/{logger.d.ts → host/logger.d.ts}

@@ -1,9 +1,7 @@
 export declare const logger: {
     setVerbose: (value: boolean) => void;
     info: (msg: string) => void;
-    log: (msg: string) => void;
     warn: (msg: string) => void;
     error: (msg: string) => void;
-    success: (msg: string) => void;
 };
 //# sourceMappingURL=logger.d.ts.map

package/dist/host/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/host/logger.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,MAAM;IACjB,UAAU,UAAU,OAAO;IAG3B,IAAI,QAAQ,MAAM;IAGlB,IAAI,QAAQ,MAAM;IAClB,KAAK,QAAQ,MAAM;CACpB,CAAC"}

package/dist/{logger.js → host/logger.js}

@@ -8,8 +8,6 @@ export const logger = {
         if (verbose)
             console.log(`${chalk.blue("[i]")} ${msg}`);
     },
-    log: (msg) => console.log(`${chalk.blue("[i]")} ${msg}`),
-    warn: (msg) => console.log(`${chalk.yellow("[!]")} ${msg}`),
+    warn: (msg) => console.error(`${chalk.yellow("[!]")} ${msg}`),
     error: (msg) => console.error(`${chalk.red("[!]")} ${msg}`),
-    success: (msg) => console.log(`${chalk.green("[✓]")} ${msg}`),
 };

package/dist/host/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/host/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAS7B,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAIpE;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,eAAe,EAAE,CAAC;CACtC"}

package/dist/host/protocol.js

@@ -0,0 +1,12 @@
+const AGENT_MESSAGE_TYPES = {
+    "agent-ready": true,
+    "test-suite-started": true,
+    "test-suite-finished": true,
+    "run-finished": true,
+};
+export function isAgentMessage(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const { type } = value;
+    return typeof type === "string" && Object.hasOwn(AGENT_MESSAGE_TYPES, type);
+}

package/dist/host/reporter/console.d.ts

@@ -0,0 +1,4 @@
+import { type TestStatus, type TestSuiteResult } from "../protocol.js";
+export declare const STATUS_SYMBOLS: Record<TestStatus, string>;
+export declare function printTestSuiteResult(suite: TestSuiteResult): void;
+//# sourceMappingURL=console.d.ts.map

package/dist/host/reporter/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/host/reporter/console.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAExF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAIrD,CAAC;AAuBF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CASjE"}

package/dist/{reporter → host/reporter}/console.js

@@ -1,6 +1,6 @@
 import { logger } from "../logger.js";
 import {} from "../protocol.js";
-const STATUS_SYMBOLS = {
+export const STATUS_SYMBOLS = {
     passed: "✅",
     failed: "❌",
     skipped: "➖",
@@ -23,16 +23,12 @@ function printTestResult(node, depth = 0) {
     }
 }
 export function printTestSuiteResult(suite) {
-    if (suite.status == "failed") {
-        logger.warn(`Test suite "${suite.name}" failed:`);
-    }
-    else if (suite.status == "passed") {
-        logger.success(`Test suite "${suite.name}" passed:`);
-    }
+    const symbol = STATUS_SYMBOLS[suite.status] || "?";
+    console.log(`${symbol} Test suite "${suite.name}" ${suite.status}:`);
     if (suite.testResult) {
         printTestResult(suite.testResult, 1);
     }
-    else {
-        logger.warn(`No results for test suite  "${suite.name}".`);
+    else if (suite.status !== "skipped") {
+        logger.warn(`No results for test suite "${suite.name}".`);
     }
 }

package/dist/host/reporter/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/host/reporter/json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5F"}

package/dist/host/reporter/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/host/reporter/summary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAejD,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CA+BzD"}

package/dist/{reporter → host/reporter}/summary.js

@@ -1,4 +1,5 @@
 import chalk from "chalk";
+import { STATUS_SYMBOLS } from "./console.js";
 function formatDuration(ms) {
     return ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(2)}s`;
 }
@@ -14,16 +15,16 @@ function formatCount(passed, failed, total) {
 export function printSummary(runSummary) {
     const { total, passed, failed, durationMs, testSuitesResults } = runSummary;
     const suitePassed = testSuitesResults.filter((s) => s.status === "passed").length;
-    const suiteFailed = testSuitesResults.length - suitePassed;
+    const suiteFailed = testSuitesResults.filter((s) => s.status === "failed").length;
     console.log();
     console.log("------------------------------------------------------------------------------");
     console.log();
     console.log(chalk.bold("Test Suites"));
     for (const suite of testSuitesResults) {
-        const isPassed = suite.status === "passed";
-        console.log(`  ${isPassed ? chalk.green("✓") : chalk.red("✗")} ${suite.name}`);
-        if (!isPassed && suite.testResult?.name) {
-            for (const line of suite.testResult.name.split("\n")) {
+        const symbol = STATUS_SYMBOLS[suite.status] || "?";
+        console.log(`  ${symbol} ${suite.name}`);
+        if (suite.status === "failed" && suite.testResult?.error?.message) {
+            for (const line of suite.testResult.error.message.split("\n")) {
                 console.log(chalk.red(`      ${line}`));
             }
         }

package/dist/host/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/host/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAA4B,MAAM,OAAO,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,UAAU;IAQnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,UAAU,CAAC,CAAQ;IAE3B,YACmB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAC/B;IAEJ,IAAI,YAAY,IAAI,SAAS,eAAe,EAAE,CAE7C;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAyBhC;IAEK,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CASpC;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB7B;IAED,OAAO,CAAC,SAAS;CA6BlB"}

package/dist/{runner.js → host/runner.js}

@@ -32,12 +32,12 @@ export class TestRunner {
                 this.fatalError ??= new Error("Script was destroyed unexpectedly");
             });
             await script.load();
-            this.session = session;
-            this.script = script;
-            this.initialized = true;
             if (this.target.wasSpawned) {
                 await this.device.resume(this.target.pid);
             }
+            this.session = session;
+            this.script = script;
+            this.initialized = true;
         }
         catch (error) {
             await session.detach().catch(() => { });
@@ -55,15 +55,25 @@ export class TestRunner {
         return summary;
     }
     async dispose() {
-        try {
-            await this.script?.unload();
+        if (this.script) {
+            try {
+                await this.script.unload();
+            }
+            catch (error) {
+                logger.warn(`Failed to unload script: ${error.message}`);
+            }
         }
-        finally {
-            await this.session?.detach();
-            this.script = undefined;
-            this.session = undefined;
-            this.initialized = false;
+        if (this.session) {
+            try {
+                await this.session.detach();
+            }
+            catch (error) {
+                logger.warn(`Failed to detach session: ${error.message}`);
+            }
         }
+        this.script = undefined;
+        this.session = undefined;
+        this.initialized = false;
     }
     onMessage(message, _data) {
         if (message.type === "error") {

package/dist/host/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/host/target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAW,MAAM,OAAO,CAAC;AAE7C,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;CACrB;AACD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7H,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAgEzF"}

package/dist/{target.js → host/target.js}

@@ -26,12 +26,17 @@ export async function resolveTarget(device, targetDef) {
             throw new Error("Target process name must not be empty");
         const processes = await device.enumerateProcesses();
         const needle = targetName.toLowerCase();
-        const tiers = [
-            processes.filter((p) => p.name === targetName),
-            processes.filter((p) => p.name.toLowerCase() === needle),
-            processes.filter((p) => p.name.toLowerCase().includes(needle)),
+        const tierFilters = [
+            (p) => p.name === targetName,
+            (p) => p.name.toLowerCase() === needle,
+            (p) => p.name.toLowerCase().includes(needle),
         ];
-        const matches = tiers.find((tier) => tier.length > 0) ?? [];
+        let matches = [];
+        for (const matchesTier of tierFilters) {
+            matches = processes.filter(matchesTier);
+            if (matches.length > 0)
+                break;
+        }
         if (matches.length === 0) {
             throw new Error(`No running process matching '${targetName}' was found.`);
         }
@@ -47,7 +52,7 @@ export async function resolveTarget(device, targetDef) {
         throw new Error("Target identifier must not be empty");
     const apps = await device.enumerateApplications();
     const matchedApp = apps.find((a) => a.identifier === identifier);
-    if (!matchedApp || !matchedApp.pid || matchedApp.pid === 0) {
+    if (!matchedApp || !matchedApp.pid) {
         throw new Error(`Application '${identifier}' is not currently running.`);
     }
     return { pid: matchedApp.pid, wasSpawned: false };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frida-test",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "type": "module",
   "license": "GPL-3.0-only",
   "homepage": "https://github.com/bernhste/frida-test/blob/main/README.md",
@@ -22,11 +22,11 @@
     "frida-test": "bin/frida-test.js",
     "frida-test-compile": "bin/frida-test-compile.js"
   },
-  "types": "./dist/agent-runtime/globals.d.ts",
+  "types": "./src/agent-runtime/globals.d.ts",
   "typesVersions": {
     "*": {
       "protocol.js": [
-        "./dist/protocol.d.ts"
+        "./dist/host/protocol.d.ts"
       ]
     }
   },
@@ -36,8 +36,8 @@
       "default": "./src/agent-runtime/globals.js"
     },
     "./protocol.js": {
-      "types": "./dist/protocol.d.ts",
-      "default": "./dist/protocol.js"
+      "types": "./dist/host/protocol.d.ts",
+      "default": "./dist/host/protocol.js"
     }
   },
   "files": [
@@ -49,16 +49,22 @@
     "build": "tsc -b",
     "watch": "tsc -b --watch",
     "clean": "tsc -b --clean && rimraf dist",
-    "test:android": "npm run build && npx frida-test -U -f 'com.google.android.dialer' ./tests/",
-    "prepublishOnly": "npm run clean && npm run build && npm run test:android"
+    "test:unit": "jest",
+    "test:integration:android": "npm run build && npx frida-test -U -f 'com.google.android.dialer' ./tests/integration/",
+    "prepublishOnly": "npm run clean && npm run build && npm run test:unit && npm run test:integration:android"
   },
   "dependencies": {
     "chalk": "^6.0.0",
     "frida-compile": "^19.0.5"
   },
   "devDependencies": {
+    "@jest/globals": "^30.5.2",
+    "@swc/core": "^1.16.2",
+    "@swc/jest": "^0.2.39",
     "@types/frida-gum": "^19.10.0",
-    "@types/node": "^26.4.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^26.6.2",
+    "jest": "^30.5.2",
     "rimraf": "^6.1.3",
     "typescript": "^7.0.2"
   },