@frida/injest 0.1.0

package/dist/host/run.d.ts

@@ -0,0 +1,50 @@
+import type { Script, Session } from "frida";
+export declare function toProjectRelative(file: string | undefined): string | undefined;
+export type TestStatus = "passed" | "failed" | "timeout" | "crashed" | "skipped" | "incomplete";
+export interface TestError {
+    name: string;
+    message: string;
+    stack?: string;
+    expected?: string;
+    actual?: string;
+}
+export interface TestResult {
+    index: number;
+    id?: string;
+    name: string;
+    durationMs: number;
+    status: TestStatus;
+    file?: string;
+    line?: number;
+    error?: TestError;
+}
+export type Reporter = "pretty" | "json";
+export interface TestMeta {
+    id?: string;
+    name?: string;
+    file?: string;
+    line?: number;
+}
+export interface RunOptions {
+    timeoutMs: number;
+    grep?: string;
+    reporter?: Reporter;
+    only?: number[];
+    metaByIndex?: Map<number, TestMeta>;
+    onResume?: () => Promise<void>;
+}
+export declare function runSuite(script: Script, session: Session, opts: RunOptions): Promise<TestResult[]>;
+export declare function reportResult(r: TestResult, reporter: Reporter): void;
+export interface OutputRecord {
+    level: string;
+    text: string;
+    name?: string;
+    file?: string;
+    line?: number;
+}
+export declare function reportOutput(o: OutputRecord, reporter: Reporter): void;
+export declare function summarize(results: TestResult[], reporter?: Reporter): {
+    passed: number;
+    failed: number;
+};
+//# sourceMappingURL=run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/host/run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI9E;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;AAEhG,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CA4KvB;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAGpE;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAwBtE;AAuDD,wBAAgB,SAAS,CACvB,OAAO,EAAE,UAAU,EAAE,EACrB,QAAQ,GAAE,QAAmB,GAC5B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA6BpC"}

package/dist/host/run.js

@@ -0,0 +1,270 @@
+import { isAbsolute, relative, resolve } from "node:path";
+export function toProjectRelative(file) {
+    if (!file)
+        return file;
+    const cwd = process.cwd();
+    return relative(cwd, isAbsolute(file) ? file : resolve(cwd, file));
+}
+export async function runSuite(script, session, opts) {
+    const results = [];
+    let names = [];
+    let total = 0;
+    let current = -1;
+    let currentFile;
+    let currentLine;
+    let timer;
+    let done = false;
+    let settle;
+    const finished = new Promise((res) => {
+        settle = res;
+    });
+    const finish = () => {
+        if (done)
+            return;
+        done = true;
+        if (timer)
+            clearTimeout(timer);
+        settle();
+    };
+    const reporter = opts.reporter ?? "pretty";
+    const record = (r) => {
+        results[r.index] = r;
+        reportResult(r, reporter);
+    };
+    const metaOf = (testIndex) => (typeof testIndex === "number" ? opts.metaByIndex?.get(testIndex) : undefined) ?? {};
+    const fillRemaining = (from, status) => {
+        for (let i = from; i < total; i++) {
+            if (!results[i]) {
+                record({ index: i, name: names[i] ?? `#${i}`, durationMs: 0, status });
+            }
+        }
+    };
+    const onTimeout = (index, timeoutMs) => {
+        record({
+            index,
+            name: names[index] ?? `#${index}`,
+            durationMs: timeoutMs,
+            status: "timeout",
+            error: { name: "TimeoutError", message: `exceeded ${timeoutMs}ms` },
+        });
+        fillRemaining(index + 1, "incomplete");
+        // The agent thread is wedged; force-detach so we don't hang.
+        session.detach().catch(() => { });
+        finish();
+    };
+    // abnormal end: never let un-run tests look passed — mark them incomplete (which counts as failure)
+    const abort = (reason, crashCurrent) => {
+        if (crashCurrent && current >= 0) {
+            record({
+                index: current,
+                name: names[current] ?? `#${current}`,
+                durationMs: 0,
+                status: "crashed",
+                error: { name: "CrashError", message: reason },
+            });
+        }
+        fillRemaining(0, "incomplete");
+        if (!results.some(Boolean)) {
+            record({
+                index: 0,
+                name: "(suite did not run)",
+                durationMs: 0,
+                status: "incomplete",
+                error: { name: "AbortError", message: reason },
+            });
+        }
+        finish();
+    };
+    script.message.connect((message) => {
+        if (message.type === "error") {
+            console.error("[agent error]", message.stack ?? message.description);
+            return;
+        }
+        if (message.type !== "send")
+            return;
+        const p = message.payload;
+        if (!p || typeof p !== "object" || typeof p.ft !== "string")
+            return;
+        switch (p.ft) {
+            case "plan":
+                total = Number(p.total) || 0;
+                names = Array.isArray(p.names) ? p.names : [];
+                break;
+            case "resume":
+                Promise.resolve(opts.onResume?.())
+                    .catch(() => { })
+                    .then(() => script.post({ type: "ft:resume-ack" }));
+                break;
+            case "start": {
+                current = Number(p.index);
+                const meta = metaOf(p.testIndex);
+                currentFile = meta.file;
+                currentLine = meta.line;
+                if (timer)
+                    clearTimeout(timer);
+                const perTestTimeout = typeof p.timeout === "number" && p.timeout > 0 ? p.timeout : opts.timeoutMs;
+                const index = Number(p.index);
+                timer = setTimeout(() => onTimeout(index, perTestTimeout), perTestTimeout);
+                break;
+            }
+            case "result": {
+                if (timer)
+                    clearTimeout(timer);
+                const index = Number(p.index);
+                const meta = metaOf(p.testIndex);
+                const name = String(p.name);
+                if (meta.name !== undefined && meta.name !== name) {
+                    console.error(`[injest] selection drift at index ${Number(p.testIndex)}: ` +
+                        `expected "${meta.name}", agent ran "${name}"`);
+                }
+                record({
+                    index,
+                    id: meta.id,
+                    name,
+                    durationMs: Number(p.durationMs) || 0,
+                    status: p.skipped ? "skipped" : p.passed ? "passed" : "failed",
+                    file: meta.file,
+                    line: meta.line,
+                    error: p.error,
+                });
+                current = -1;
+                currentFile = undefined;
+                currentLine = undefined;
+                break;
+            }
+            case "done":
+                finish();
+                break;
+        }
+    });
+    script.logHandler = (level, text) => {
+        if (done)
+            return;
+        reportOutput({
+            level: String(level),
+            text,
+            name: current >= 0 ? names[current] : undefined,
+            file: current >= 0 ? currentFile : undefined,
+            line: current >= 0 ? currentLine : undefined,
+        }, reporter);
+    };
+    session.detached.connect((reason) => {
+        if (done)
+            return; // our own teardown
+        // detach before "done" means the target died mid-run
+        abort(`target detached: ${reason}`, true);
+    });
+    const api = script.exports;
+    api.run({ grep: opts.grep, only: opts.only }).catch((err) => {
+        if (done)
+            return;
+        const message = err instanceof Error ? err.message : String(err);
+        console.error("[injest] run() failed:", message);
+        abort(`run() failed: ${message}`, false);
+    });
+    await finished;
+    fillRemaining(0, "skipped");
+    return results.slice(0, Math.max(total, results.length));
+}
+export function reportResult(r, reporter) {
+    if (reporter === "json")
+        emitJson(r);
+    else
+        printResult(r);
+}
+export function reportOutput(o, reporter) {
+    if (reporter === "json") {
+        process.stdout.write(JSON.stringify({
+            type: "output",
+            level: o.level,
+            text: o.text,
+            name: o.name,
+            file: o.file,
+            line: o.line,
+        }) + "\n");
+        return;
+    }
+    // pretty: indent under the running test (logs arrive before its result line)
+    const prefix = "    │ ";
+    process.stdout.write(prefix +
+        o.text
+            .replace(/\n$/, "")
+            .split("\n")
+            .join("\n" + prefix) +
+        "\n");
+}
+function printResult(r) {
+    const ms = `(${r.durationMs}ms)`;
+    if (r.status === "passed") {
+        console.log(`  ✓ ${r.name} ${ms}`);
+        return;
+    }
+    if (r.status === "skipped") {
+        const why = r.error ? `: ${r.error.message}` : "";
+        console.log(`  - ${r.name} (skipped${why})`);
+        return;
+    }
+    const tag = r.status === "failed" ? "" : ` [${r.status}]`;
+    console.log(`  ✗ ${r.name} ${ms}${tag}`);
+    if (r.error) {
+        console.log(`      ${r.error.name}: ${r.error.message}`);
+        if (r.error.expected !== undefined || r.error.actual !== undefined) {
+            console.log(`        expected: ${indentMultiline(r.error.expected)}`);
+            console.log(`        actual:   ${indentMultiline(r.error.actual)}`);
+        }
+        if (r.error.stack) {
+            const frames = r.error.stack
+                .split("\n")
+                .map((l) => l.trim())
+                .filter((l) => l.startsWith("at") && !isRunnerFrame(l))
+                .slice(0, 3);
+            for (const f of frames)
+                console.log(`        ${f}`);
+        }
+    }
+}
+function isRunnerFrame(frame) {
+    return /agent\/(runtime|expect)\.|[/\\]entry\.|\.injest/.test(frame);
+}
+function indentMultiline(value) {
+    return (value ?? "").split("\n").join("\n                  ");
+}
+function emitJson(r) {
+    process.stdout.write(JSON.stringify({
+        type: "test",
+        id: r.id,
+        name: r.name,
+        status: r.status,
+        durationMs: r.durationMs,
+        file: r.file,
+        line: r.line,
+        error: r.error,
+    }) + "\n");
+}
+export function summarize(results, reporter = "pretty") {
+    const count = (s) => results.filter((r) => r.status === s).length;
+    const passed = count("passed");
+    const failed = count("failed") + count("timeout") + count("crashed") + count("incomplete");
+    if (reporter === "json") {
+        process.stdout.write(JSON.stringify({
+            type: "end",
+            passed,
+            failed,
+            skipped: count("skipped"),
+            total: results.length,
+        }) + "\n");
+        return { passed, failed };
+    }
+    const parts = [
+        `${passed} passed`,
+        `${count("failed")} failed`,
+        `${count("timeout")} timeout`,
+        `${count("crashed")} crashed`,
+        `${count("incomplete")} incomplete`,
+        `${count("skipped")} skipped`,
+        `${results.length} total`,
+    ];
+    console.log(`\n${parts.join(", ")}`);
+    return { passed, failed };
+}
+//# sourceMappingURL=run.js.map

package/dist/host/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/host/run.ts"],"names":[],"mappings":"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"}

package/dist/host/session.d.ts

@@ -0,0 +1,13 @@
+import * as frida from "frida";
+import type { Runtime, TargetConfig } from "./config.js";
+export declare function getDevice(target: TargetConfig): Promise<frida.Device>;
+export interface OpenedSession {
+    session: frida.Session;
+    /** Resume a gated spawn (idempotent); no-op for the system session. */
+    resume(): Promise<void>;
+    /** Kill the process if we spawned it, else detach. */
+    close(): Promise<void>;
+}
+export declare function openSession(device: frida.Device, target: TargetConfig): Promise<OpenedSession>;
+export declare function runtimeOption(runtime?: Runtime): frida.ScriptRuntime;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/host/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzD,wBAAsB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAM3E;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;IACvB,uEAAuE;IACvE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,sDAAsD;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,KAAK,CAAC,MAAM,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CA8BxB;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,aAAa,CASpE"}

package/dist/host/session.js

@@ -0,0 +1,55 @@
+import * as frida from "frida";
+const SYSTEM_SESSION_PID = 0;
+export async function getDevice(target) {
+    const { device } = target;
+    if (device === "local")
+        return frida.getLocalDevice();
+    if (device === "usb")
+        return frida.getUsbDevice();
+    if (typeof device === "object" && device.id)
+        return frida.getDevice(device.id);
+    throw new Error(`invalid "device" in target config: ${JSON.stringify(device)}`);
+}
+export async function openSession(device, target) {
+    const { session } = target;
+    if (session === "system") {
+        const s = await device.attach(SYSTEM_SESSION_PID);
+        return { session: s, resume: async () => { }, close: () => s.detach() };
+    }
+    if ("spawn" in session) {
+        // spawn gating: the process starts suspended so the agent can hook before any of its code runs
+        const argv = session.args ? [session.spawn, ...session.args] : undefined;
+        const pid = await device.spawn(session.spawn, argv ? { argv } : undefined);
+        const s = await device.attach(pid);
+        let resumed = false;
+        return {
+            session: s,
+            resume: async () => {
+                if (resumed)
+                    return;
+                resumed = true;
+                await device.resume(pid);
+            },
+            close: async () => {
+                try {
+                    await device.kill(pid);
+                }
+                catch {
+                    // already gone (crashed / exited)
+                }
+            },
+        };
+    }
+    throw new Error('invalid "session" in target config');
+}
+export function runtimeOption(runtime) {
+    switch (runtime) {
+        case "qjs":
+            return frida.ScriptRuntime.QJS;
+        case "v8":
+            return frida.ScriptRuntime.V8;
+        default:
+            return frida.ScriptRuntime.Default;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/host/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/host/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAoB;IAClD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC1B,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC,cAAc,EAAE,CAAC;IACtD,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC,YAAY,EAAE,CAAC;IAClD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/E,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAClF,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAoB,EACpB,MAAoB;IAEpB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAE3B,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACzE,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;QACvB,+FAA+F;QAC/F,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3E,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,KAAK,IAAI,EAAE;gBACjB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YACD,KAAK,EAAE,KAAK,IAAI,EAAE;gBAChB,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,kCAAkC;gBACpC,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAiB;IAC7C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC;QACjC,KAAK,IAAI;YACP,OAAO,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAChC;YACE,OAAO,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/host/source.d.ts

@@ -0,0 +1,14 @@
+export type Mode = "run" | "skip";
+export type Launch = "shared" | "isolated" | "suspended";
+export interface TestInfo {
+    id: string;
+    index: number;
+    name: string;
+    mode: Mode;
+    launch: Launch;
+    file?: string;
+    line?: number;
+}
+export declare function discoverTestInfo(files: string[]): TestInfo[];
+export declare function matchTestName(grep: string | undefined): (name: string) => boolean;
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/host/source.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAa5D;AAGD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAQjF"}

package/dist/host/source.js

@@ -0,0 +1,83 @@
+import { readFileSync } from "node:fs";
+import * as ts from "typescript";
+const LAUNCH_BY_MEMBER = {
+    isolated: "isolated",
+    suspended: "suspended",
+};
+function classifyTestCallee(callee) {
+    if (ts.isIdentifier(callee)) {
+        return callee.text === "test" ? { mode: "run", launch: "shared" } : null;
+    }
+    if (ts.isPropertyAccessExpression(callee) &&
+        ts.isIdentifier(callee.expression) &&
+        callee.expression.text === "test") {
+        if (callee.name.text === "skip")
+            return { mode: "skip", launch: "shared" };
+        const launch = LAUNCH_BY_MEMBER[callee.name.text];
+        if (launch)
+            return { mode: "run", launch };
+    }
+    return null;
+}
+function isDescribeCallee(callee) {
+    return ts.isIdentifier(callee) && callee.text === "describe";
+}
+function testsInFile(absoluteFile) {
+    let text;
+    try {
+        text = readFileSync(absoluteFile, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const sourceFile = ts.createSourceFile(absoluteFile, text, ts.ScriptTarget.Latest, true);
+    const out = [];
+    // mirrors the agent's suiteStack (runtime.ts) so discovered names match registered ones
+    const suiteStack = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node)) {
+            const first = node.arguments[0];
+            const label = first && ts.isStringLiteralLike(first) ? first.text : undefined;
+            if (label !== undefined && isDescribeCallee(node.expression)) {
+                suiteStack.push(label);
+                ts.forEachChild(node, visit);
+                suiteStack.pop();
+                return;
+            }
+            const kind = label !== undefined ? classifyTestCallee(node.expression) : null;
+            if (label !== undefined && kind) {
+                const line = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1;
+                out.push({ name: [...suiteStack, label].join(" › "), file: absoluteFile, line, ...kind });
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sourceFile);
+    return out;
+}
+export function discoverTestInfo(files) {
+    const discovered = files.flatMap(testsInFile);
+    const totals = new Map();
+    for (const t of discovered)
+        totals.set(t.name, (totals.get(t.name) ?? 0) + 1);
+    const seen = new Map();
+    return discovered.map((t, index) => {
+        const occurrence = (seen.get(t.name) ?? 0) + 1;
+        seen.set(t.name, occurrence);
+        const id = (totals.get(t.name) ?? 0) > 1 ? `${t.name}#${occurrence}` : t.name;
+        return { id, index, ...t };
+    });
+}
+// regex, else substring fallback — must stay in sync with the agent's makeMatcher (runtime.ts)
+export function matchTestName(grep) {
+    if (!grep)
+        return () => true;
+    try {
+        const re = new RegExp(grep);
+        return (name) => re.test(name);
+    }
+    catch {
+        return (name) => name.includes(grep);
+    }
+}
+//# sourceMappingURL=source.js.map

package/dist/host/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/host/source.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@frida/injest",
+  "version": "0.1.0",
+  "description": "A test runner for code running inside Frida's GumJS runtime.",
+  "license": "MIT",
+  "author": "Håvard Sørbø <havard@hsorbo.no>",
+  "homepage": "https://github.com/frida/injest/tree/main/packages/injest#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/frida/injest.git",
+    "directory": "packages/injest"
+  },
+  "bugs": {
+    "url": "https://github.com/frida/injest/issues"
+  },
+  "keywords": [
+    "frida",
+    "gumjs",
+    "gum",
+    "testing",
+    "test-runner",
+    "instrumentation",
+    "dynamic-analysis"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "injest": "dist/host/cli.js"
+  },
+  "main": "dist/host/index.js",
+  "types": "dist/host/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/host/index.d.ts",
+      "import": "./dist/host/index.js"
+    },
+    "./agent": {
+      "types": "./dist/agent/runtime.d.ts",
+      "import": "./dist/agent/runtime.js"
+    }
+  },
+  "files": [
+    "dist",
+    "schema",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/host/cli.js",
+    "typecheck:agent": "tsc -p tsconfig.agent.json",
+    "test": "tsx --test \"test/**/*.spec.ts\"",
+    "test:watch": "tsx --test --watch \"test/**/*.spec.ts\"",
+    "injest": "node dist/host/cli.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "deep-eql": "^5.0.2",
+    "frida": "^17.10.1",
+    "typescript": "^6.0.3"
+  },
+  "devDependencies": {
+    "@types/deep-eql": "^4.0.2",
+    "@types/frida-gum": "^19.4.0",
+    "@types/node": "^25.9.1",
+    "prettier": "^3.8.3",
+    "tsx": "^4.20.6"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}