deepadb 1.0.0

package/build/bridge/local-bridge.js

@@ -0,0 +1,345 @@
+/**
+ * Local Bridge — On-device execution without ADB.
+ *
+ * Drop-in replacement for AdbBridge when DeepADB runs directly on the Android
+ * device (e.g., inside Termux). All commands execute locally via sh/su instead
+ * of routing through adb over USB.
+ *
+ * Extends AdbBridge so it is type-compatible with the entire tool suite —
+ * no tool module changes required. The override of exec() is the single
+ * interception point; shell() and rootShell() flow through it automatically.
+ *
+ * Environment detection: see config.ts isOnDevice().
+ */
+import { execFile, spawn } from "child_process";
+import { AdbBridge, AdbError } from "./adb-bridge.js";
+import { config } from "../config/config.js";
+import { shellEscape } from "../middleware/sanitize.js";
+export class LocalBridge extends AdbBridge {
+    localLogger;
+    deviceInfoCache = null;
+    /**
+     * Cached root availability. null = not yet checked, true/false = checked.
+     * Probed lazily on first command that needs elevation.
+     */
+    rootAvailable = null;
+    /**
+     * Android system commands that require shell-user (uid=2000) or root privileges.
+     * In ADB mode, all shell commands run as uid=2000 automatically.
+     * In on-device mode (Termux app user), these need su elevation.
+     *
+     * SECURITY: This is a FROZEN allowlist — hardcoded and immutable.
+     * Not configurable via environment variables or runtime API.
+     * Only commands explicitly listed here get routed through su.
+     */
+    static ELEVATED_COMMANDS = Object.freeze(new Set([
+        "settings", // Requires INTERACT_ACROSS_USERS permission
+        "dumpsys", // Requires DUMP permission
+        "am", // Requires activity manager permissions (force-stop, broadcast)
+        "input", // Requires INJECT_EVENTS permission
+        "screencap", // Requires framebuffer access + system linker context on Android 16
+        "screenrecord", // Requires framebuffer access + system linker context
+        "uiautomator", // Requires instrumentation privileges + system linker context
+        "app_process", // Used by uiautomator — requires system linker context
+        "getenforce", // Requires SELinux status read access
+        "setenforce", // Requires SELinux policy write access
+        "cmd", // Generic binder command — most subcommands need shell user
+        "pm", // Package manager — install, dump, grant need shell-level access
+        "wm", // Window manager — display size/density need shell user
+        "svc", // Service control — wifi, data, power need shell user
+        "ip", // Network route/addr queries require netlink socket access
+        "ifconfig", // Network interface info requires similar privileges to ip
+    ]));
+    constructor(logger) {
+        super(logger);
+        this.localLogger = logger;
+    }
+    /** Quote a string for safe use as a shell argument (wraps in single quotes with escaping). */
+    shellQuote(str) {
+        return `'${shellEscape(str)}'`;
+    }
+    /**
+     * Check if root (su) is available. Result is cached after first probe.
+     * Uses a fast, side-effect-free check: `su -c id`.
+     */
+    async checkRootAvailable() {
+        if (this.rootAvailable !== null)
+            return this.rootAvailable;
+        try {
+            const result = await this.execLocal("su -c id", { timeout: 5000, ignoreExitCode: true });
+            this.rootAvailable = result.stdout.includes("uid=0");
+            if (this.rootAvailable) {
+                this.localLogger.info("LocalBridge: root (su) available — privileged commands will be elevated");
+            }
+            else {
+                this.localLogger.info("LocalBridge: root (su) not available — running in unprivileged mode");
+            }
+        }
+        catch {
+            this.rootAvailable = false;
+            this.localLogger.info("LocalBridge: root (su) probe failed — running in unprivileged mode");
+        }
+        return this.rootAvailable;
+    }
+    /**
+     * Wrap a command in `su -c '...'` for privilege elevation.
+     * Uses shellEscape() to safely handle single quotes in the inner command.
+     * This is the same escaping path used by AdbBridge.rootShell().
+     */
+    elevate(command) {
+        return `su -c '${shellEscape(command)}'`;
+    }
+    /**
+     * Android filesystem paths that require elevated access in on-device mode.
+     * Commands referencing these paths need su to bypass scoped storage restrictions.
+     * In ADB mode (uid=2000), these paths are accessible by default.
+     */
+    static RESTRICTED_PATH_PATTERNS = /\/sdcard\b|\/storage\b|\/system\//;
+    /**
+     * Check if a shell command needs privilege elevation.
+     * Two criteria (either triggers elevation):
+     * 1. Command name is in the frozen ELEVATED_COMMANDS allowlist (system tools)
+     * 2. Command references restricted filesystem paths (scoped storage bypass)
+     *
+     * Security note: all commands reaching this point have already been validated
+     * by validateShellArg/shellEscape at the tool layer. The su -c '...' wrapper
+     * uses shellEscape() to prevent injection within the single-quote context.
+     */
+    commandNeedsElevation(command) {
+        // Check command name against system tool allowlist
+        const firstToken = command.trimStart().split(/\s+/)[0] ?? "";
+        // Handle absolute paths: "/system/bin/am" → "am"
+        const cmdName = firstToken.includes("/") ? firstToken.split("/").pop() ?? "" : firstToken;
+        if (LocalBridge.ELEVATED_COMMANDS.has(cmdName))
+            return true;
+        // Check if command references restricted paths that need scoped storage bypass
+        if (LocalBridge.RESTRICTED_PATH_PATTERNS.test(command))
+            return true;
+        return false;
+    }
+    /**
+     * Execute an "ADB command" locally by translating the subcommand.
+     * This is the single interception point — shell(), rootShell(), and all
+     * tool calls to exec() flow through here.
+     */
+    async exec(args, options = {}) {
+        const subcommand = args[0];
+        const hasRoot = await this.checkRootAvailable();
+        switch (subcommand) {
+            case "shell":
+                // args = ["shell", "<command>"] — execute the command directly
+                // If the command requires system-level privileges and root is available,
+                // route through su to match ADB mode behavior (which runs as uid=2000).
+                {
+                    const command = args.slice(1).join(" ");
+                    if (hasRoot && this.commandNeedsElevation(command)) {
+                        return this.execLocal(this.elevate(command), options);
+                    }
+                    return this.execLocal(command, options);
+                }
+            case "devices":
+                return this.syntheticDeviceList();
+            case "version":
+                return this.makeResult("DeepADB Local Bridge (on-device mode)");
+            case "push":
+                // Local → device path. Elevate to write to restricted paths like /sdcard/.
+                {
+                    const pushCmd = `cp -f ${this.shellQuote(args[1])} ${this.shellQuote(args[2])}`;
+                    return this.execLocal(hasRoot ? this.elevate(pushCmd) : pushCmd, options);
+                }
+            case "pull":
+                // Device → local path. Use su-cat with redirect so the LOCAL file is
+                // owned by the Termux user (not root), enabling Node.js to read it back.
+                // The > redirect is evaluated by the outer sh (uid=Termux), so the
+                // created file inherits the Termux user's ownership.
+                if (hasRoot) {
+                    const pullCmd = `su -c 'cat ${shellEscape(args[1])}' > ${this.shellQuote(args[2])}`;
+                    return this.execLocal(pullCmd, options);
+                }
+                return this.execLocal(`cp -f ${this.shellQuote(args[1])} ${this.shellQuote(args[2])}`, options);
+            case "install":
+                // args = ["install", ...flags, path] → pm install
+                // Flags are hardcoded (-r, -d), only the last arg (APK path) needs quoting
+                {
+                    const installCmd = `pm install ${args.slice(1, -1).join(" ")} ${this.shellQuote(args[args.length - 1])}`;
+                    return this.execLocal(hasRoot ? this.elevate(installCmd) : installCmd, options);
+                }
+            case "install-multiple":
+                // args = ["install-multiple", ...flags, ...paths] → pm install-multiple
+                // Flags are hardcoded (-r, -d), paths need quoting
+                {
+                    const imArgs = args.slice(1);
+                    const flags = imArgs.filter(a => a.startsWith("-"));
+                    const paths = imArgs.filter(a => !a.startsWith("-"));
+                    const imCmd = `pm install-multiple ${flags.join(" ")} ${paths.map(p => this.shellQuote(p)).join(" ")}`;
+                    return this.execLocal(hasRoot ? this.elevate(imCmd) : imCmd, options);
+                }
+            case "uninstall":
+                // args = ["uninstall", ...flags, package] → pm uninstall
+                // Package name is validated by validateShellArg before reaching here
+                {
+                    const uninstallCmd = `pm uninstall ${args.slice(1).join(" ")}`;
+                    return this.execLocal(hasRoot ? this.elevate(uninstallCmd) : uninstallCmd, options);
+                }
+            case "logcat":
+                // args = ["logcat", ...flags] → direct logcat
+                return this.execLocal(`logcat ${args.slice(1).join(" ")}`, options);
+            case "reboot":
+                {
+                    const rebootCmd = `reboot ${args.slice(1).join(" ")}`.trim();
+                    return this.execLocal(hasRoot ? this.elevate(rebootCmd) : rebootCmd, options);
+                }
+            case "forward":
+            case "reverse":
+                if (args.includes("--list")) {
+                    return this.makeResult(""); // Empty list — no ADB server
+                }
+                return this.makeResult(`${subcommand}: not available in on-device mode (no ADB server)`);
+            case "connect":
+            case "disconnect":
+            case "pair":
+            case "tcpip":
+            case "emu":
+                return this.makeResult(`${subcommand}: not applicable in on-device mode (already local)`);
+            case "bugreport":
+                // ADB mode: "adb bugreport <localPath>" runs bugreportz on-device and pulls to localPath.
+                // On-device: bugreportz doesn't accept an output path — it generates a zip at an
+                // internal location and prints "OK:<path>" on stdout. We run it, parse the output
+                // path, then copy the zip to the requested destination.
+                {
+                    const destPath = args[1]; // The local path the tool expects the zip at
+                    const bugreportCmd = "bugreportz";
+                    const bzResult = await this.execLocal(hasRoot ? this.elevate(bugreportCmd) : bugreportCmd, { ...options, ignoreExitCode: true });
+                    const okMatch = bzResult.stdout.match(/OK:(.+)/);
+                    if (okMatch && destPath) {
+                        const generatedPath = okMatch[1].trim();
+                        const cpCmd = `cp -f ${this.shellQuote(generatedPath)} ${this.shellQuote(destPath)}`;
+                        const rmCmd = `rm -f ${this.shellQuote(generatedPath)}`;
+                        await this.execLocal(hasRoot ? this.elevate(cpCmd) : cpCmd, { ignoreExitCode: true });
+                        await this.execLocal(hasRoot ? this.elevate(rmCmd) : rmCmd, { ignoreExitCode: true });
+                    }
+                    return bzResult;
+                }
+            default:
+                // Unknown subcommand — attempt direct execution
+                this.localLogger.warn(`LocalBridge: unknown ADB subcommand "${subcommand}", executing as shell`);
+                return this.execLocal(args.join(" "), options);
+        }
+    }
+    /** Execute a command directly on the local device via sh. */
+    execLocal(command, options = {}) {
+        const timeout = options.timeout || config.commandTimeout;
+        this.localLogger.debug(`local: sh -c ${command.substring(0, 200)}`);
+        return new Promise((resolve, reject) => {
+            const execOptions = {
+                timeout,
+                maxBuffer: config.maxOutputSize * 2,
+                env: { ...process.env, PATH: `${process.env.PATH}:/system/bin:/vendor/bin` },
+            };
+            execFile("sh", ["-c", command], execOptions, (error, stdout, stderr) => {
+                const bufferExceeded = error?.code === "ERR_CHILD_PROCESS_STDIO_MAXBUFFER"
+                    || error?.message?.includes("maxBuffer") === true;
+                const timedOut = error?.killed === true && !bufferExceeded;
+                const exitCode = error?.code != null
+                    ? (typeof error.code === "number" ? error.code : 1)
+                    : 0;
+                const result = {
+                    stdout: stdout?.toString() ?? "",
+                    stderr: stderr?.toString() ?? "",
+                    exitCode,
+                    timedOut,
+                    bufferExceeded,
+                    device: "local",
+                };
+                if (timedOut) {
+                    reject(new AdbError(`Command timed out after ${timeout}ms: ${command.substring(0, 100)}`, result));
+                    return;
+                }
+                if (bufferExceeded) {
+                    resolve(result);
+                    return;
+                }
+                if (exitCode !== 0 && !options.ignoreExitCode) {
+                    reject(new AdbError(`Command failed (exit ${exitCode}): ${result.stderr || result.stdout}`.trim(), result));
+                    return;
+                }
+                resolve(result);
+            });
+        });
+    }
+    /**
+     * Synthesize an `adb devices -l` response for DeviceManager.
+     * Reads device properties once and caches them.
+     */
+    async syntheticDeviceList() {
+        if (!this.deviceInfoCache) {
+            try {
+                const [modelRes, productRes] = await Promise.allSettled([
+                    this.execLocal("getprop ro.product.model", { ignoreExitCode: true, timeout: 3000 }),
+                    this.execLocal("getprop ro.product.device", { ignoreExitCode: true, timeout: 3000 }),
+                ]);
+                const model = modelRes.status === "fulfilled" ? modelRes.value.stdout.trim().replace(/\s+/g, "_") : "Android";
+                const product = productRes.status === "fulfilled" ? productRes.value.stdout.trim() : "unknown";
+                this.deviceInfoCache = `List of devices attached\nlocal          device product:${product} model:${model} transport_id:0\n`;
+            }
+            catch {
+                this.deviceInfoCache = "List of devices attached\nlocal          device product:unknown model:Android transport_id:0\n";
+            }
+        }
+        return this.makeResult(this.deviceInfoCache);
+    }
+    /** Create a successful AdbResult from a string. */
+    makeResult(stdout) {
+        return {
+            stdout,
+            stderr: "",
+            exitCode: 0,
+            timedOut: false,
+            bufferExceeded: false,
+            device: "local",
+        };
+    }
+    /** Always reachable — we are the device. */
+    async ping() {
+        return true;
+    }
+    /** Return local version info. */
+    async version() {
+        try {
+            const result = await this.execLocal("getprop ro.build.version.release", { timeout: 3000 });
+            return `DeepADB Local Bridge — Android ${result.stdout.trim()}`;
+        }
+        catch {
+            return "DeepADB Local Bridge — on-device mode";
+        }
+    }
+    /**
+     * Spawn a long-running streaming command locally.
+     * In ADB mode the args are ["logcat", ...flags] prefixed with "adb -s serial".
+     * Here we strip the ADB layer and spawn the command directly.
+     */
+    spawnStreaming(args, _device) {
+        // args[0] is the ADB subcommand (logcat, shell, etc.)
+        // For logcat: args = ["logcat", "-b", "radio", "-v", "time"]
+        // For shell: args = ["shell", "logcat", ...]
+        const subcommand = args[0];
+        let cmd;
+        let cmdArgs;
+        if (subcommand === "shell") {
+            // "shell", "logcat", ...flags → spawn "logcat" with flags
+            cmd = args[1];
+            cmdArgs = args.slice(2);
+        }
+        else {
+            // "logcat", ...flags → spawn directly
+            cmd = subcommand;
+            cmdArgs = args.slice(1);
+        }
+        this.localLogger.debug(`spawn local: ${cmd} ${cmdArgs.join(" ")}`);
+        return spawn(cmd, cmdArgs, {
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env, PATH: `${process.env.PATH}:/system/bin:/vendor/bin` },
+        });
+    }
+}
+//# sourceMappingURL=local-bridge.js.map

package/build/bridge/local-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-bridge.js","sourceRoot":"","sources":["../../src/bridge/local-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAmB,KAAK,EAAgB,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,SAAS,EAA6B,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,OAAO,WAAY,SAAQ,SAAS;IAChC,WAAW,CAAS;IACpB,eAAe,GAAkB,IAAI,CAAC;IAE9C;;;OAGG;IACK,aAAa,GAAmB,IAAI,CAAC;IAE7C;;;;;;;;OAQG;IACK,MAAM,CAAU,iBAAiB,GAAwB,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;QACrF,UAAU,EAAO,4CAA4C;QAC7D,SAAS,EAAQ,2BAA2B;QAC5C,IAAI,EAAa,gEAAgE;QACjF,OAAO,EAAU,oCAAoC;QACrD,WAAW,EAAM,oEAAoE;QACrF,cAAc,EAAG,sDAAsD;QACvE,aAAa,EAAI,8DAA8D;QAC/E,aAAa,EAAI,uDAAuD;QACxE,YAAY,EAAK,sCAAsC;QACvD,YAAY,EAAK,uCAAuC;QACxD,KAAK,EAAY,4DAA4D;QAC7E,IAAI,EAAa,iEAAiE;QAClF,IAAI,EAAa,wDAAwD;QACzE,KAAK,EAAY,sDAAsD;QACvE,IAAI,EAAa,2DAA2D;QAC5E,UAAU,EAAO,2DAA2D;KAC7E,CAAC,CAAC,CAAC;IAEJ,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;IAC5B,CAAC;IAED,8FAA8F;IACtF,UAAU,CAAC,GAAW;QAC5B,OAAO,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;IACjC,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,kBAAkB;QAC9B,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,aAAa,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;YACnG,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;YAC3B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACK,OAAO,CAAC,OAAe;QAC7B,OAAO,UAAU,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAU,wBAAwB,GAAG,mCAAmC,CAAC;IAEvF;;;;;;;;;OASG;IACK,qBAAqB,CAAC,OAAe;QAC3C,mDAAmD;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7D,iDAAiD;QACjD,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QAC1F,IAAI,WAAW,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5D,+EAA+E;QAC/E,IAAI,WAAW,CAAC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACM,KAAK,CAAC,IAAI,CAAC,IAAc,EAAE,UAA0B,EAAE;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAEhD,QAAQ,UAAU,EAAE,CAAC;YACnB,KAAK,OAAO;gBACV,+DAA+D;gBAC/D,yEAAyE;gBACzE,wEAAwE;gBACxE,CAAC;oBACC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACxC,IAAI,OAAO,IAAI,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;wBACnD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;oBACxD,CAAC;oBACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC1C,CAAC;YAEH,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAEpC,KAAK,SAAS;gBACZ,OAAO,IAAI,CAAC,UAAU,CAAC,uCAAuC,CAAC,CAAC;YAElE,KAAK,MAAM;gBACT,2EAA2E;gBAC3E,CAAC;oBACC,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC5E,CAAC;YAEH,KAAK,MAAM;gBACT,qEAAqE;gBACrE,yEAAyE;gBACzE,mEAAmE;gBACnE,qDAAqD;gBACrD,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,OAAO,GAAG,cAAc,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC1C,CAAC;gBACD,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAElG,KAAK,SAAS;gBACZ,kDAAkD;gBAClD,2EAA2E;gBAC3E,CAAC;oBACC,MAAM,UAAU,GAAG,cAAc,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzG,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAClF,CAAC;YAEH,KAAK,kBAAkB;gBACrB,wEAAwE;gBACxE,mDAAmD;gBACnD,CAAC;oBACC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;oBACpD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;oBACrD,MAAM,KAAK,GAAG,uBAAuB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBACvG,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACxE,CAAC;YAEH,KAAK,WAAW;gBACd,yDAAyD;gBACzD,qEAAqE;gBACrE,CAAC;oBACC,MAAM,YAAY,GAAG,gBAAgB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACtF,CAAC;YAEH,KAAK,QAAQ;gBACX,8CAA8C;gBAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAEtE,KAAK,QAAQ;gBACX,CAAC;oBACC,MAAM,SAAS,GAAG,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;oBAC7D,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBAChF,CAAC;YAEH,KAAK,SAAS,CAAC;YACf,KAAK,SAAS;gBACZ,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAE,6BAA6B;gBAC5D,CAAC;gBACD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,UAAU,mDAAmD,CAAC,CAAC;YAE3F,KAAK,SAAS,CAAC;YACf,KAAK,YAAY,CAAC;YAClB,KAAK,MAAM,CAAC;YACZ,KAAK,OAAO,CAAC;YACb,KAAK,KAAK;gBACR,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,UAAU,oDAAoD,CAAC,CAAC;YAE5F,KAAK,WAAW;gBACd,0FAA0F;gBAC1F,iFAAiF;gBACjF,kFAAkF;gBAClF,wDAAwD;gBACxD,CAAC;oBACC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,6CAA6C;oBACvE,MAAM,YAAY,GAAG,YAAY,CAAC;oBAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CACnC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,EACnD,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CACrC,CAAC;oBACF,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;oBACjD,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;wBACxB,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;wBACxC,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACrF,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;wBACxD,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;wBACtF,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;oBACxF,CAAC;oBACD,OAAO,QAAQ,CAAC;gBAClB,CAAC;YAEH;gBACE,gDAAgD;gBAChD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,wCAAwC,UAAU,uBAAuB,CAAC,CAAC;gBACjG,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,6DAA6D;IACrD,SAAS,CAAC,OAAe,EAAE,UAA0B,EAAE;QAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,cAAc,CAAC;QAEzD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,gBAAgB,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAEpE,OAAO,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAChD,MAAM,WAAW,GAAoB;gBACnC,OAAO;gBACP,SAAS,EAAE,MAAM,CAAC,aAAa,GAAG,CAAC;gBACnC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,0BAA0B,EAAE;aAC7E,CAAC;YAEF,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACrE,MAAM,cAAc,GAAG,KAAK,EAAE,IAAI,KAAK,mCAAmC;uBACrE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;gBACpD,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC;gBAE3D,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAI,IAAI,IAAI;oBAClC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;oBACnD,CAAC,CAAC,CAAC,CAAC;gBAEN,MAAM,MAAM,GAAc;oBACxB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAChC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAChC,QAAQ;oBACR,QAAQ;oBACR,cAAc;oBACd,MAAM,EAAE,OAAO;iBAChB,CAAC;gBAEF,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,QAAQ,CAAC,2BAA2B,OAAO,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;oBACnG,OAAO;gBACT,CAAC;gBAED,IAAI,cAAc,EAAE,CAAC;oBACnB,OAAO,CAAC,MAAM,CAAC,CAAC;oBAChB,OAAO;gBACT,CAAC;gBAED,IAAI,QAAQ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;oBAC9C,MAAM,CAAC,IAAI,QAAQ,CACjB,wBAAwB,QAAQ,MAAM,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAC7E,MAAM,CACP,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,mBAAmB;QAC/B,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;oBACtD,IAAI,CAAC,SAAS,CAAC,0BAA0B,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;oBACnF,IAAI,CAAC,SAAS,CAAC,2BAA2B,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;iBACrF,CAAC,CAAC;gBAEH,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC9G,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBAE/F,IAAI,CAAC,eAAe,GAAG,2DAA2D,OAAO,UAAU,KAAK,mBAAmB,CAAC;YAC9H,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,eAAe,GAAG,gGAAgG,CAAC;YAC1H,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED,mDAAmD;IAC3C,UAAU,CAAC,MAAc;QAC/B,OAAO;YACL,MAAM;YACN,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,KAAK;YACf,cAAc,EAAE,KAAK;YACrB,MAAM,EAAE,OAAO;SAChB,CAAC;IACJ,CAAC;IAED,4CAA4C;IACnC,KAAK,CAAC,IAAI;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iCAAiC;IACxB,KAAK,CAAC,OAAO;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,kCAAkC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3F,OAAO,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,uCAAuC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACM,cAAc,CAAC,IAAc,EAAE,OAAgB;QACtD,sDAAsD;QACtD,6DAA6D;QAC7D,6CAA6C;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3B,IAAI,GAAW,CAAC;QAChB,IAAI,OAAiB,CAAC;QAEtB,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC3B,0DAA0D;YAC1D,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACd,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,GAAG,GAAG,UAAU,CAAC;YACjB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEnE,OAAO,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE;YACzB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,0BAA0B,EAAE;SAC7E,CAAC,CAAC;IACL,CAAC"}

package/build/config/config.d.ts

@@ -0,0 +1,39 @@
+/**
+ * DeepADB Configuration
+ *
+ * Central configuration for ADB paths, timeouts, and output limits.
+ * Adjust these values based on your environment.
+ */
+export interface DeepADBConfig {
+    /** Path to the ADB binary. Auto-detected if not set. */
+    adbPath: string;
+    /** Default timeout for ADB commands in milliseconds */
+    commandTimeout: number;
+    /** Maximum output size in characters before truncation */
+    maxOutputSize: number;
+    /** Maximum logcat lines to return per snapshot */
+    maxLogcatLines: number;
+    /** Default device serial (empty = auto-select single device) */
+    defaultDevice: string;
+    /** Temp directory for binary file operations (screenshots, pulls) */
+    tempDir: string;
+    /** Device list cache TTL in milliseconds (0 = no caching) */
+    deviceCacheTtl: number;
+    /** Number of retries for transient ADB failures */
+    retryCount: number;
+    /** Base delay between retries in milliseconds (doubles each retry) */
+    retryBaseDelay: number;
+}
+/**
+ * Detect if we're running directly on an Android device (e.g., Termux).
+ * Checks for /system/build.prop which exists on all Android devices
+ * but never on Windows/macOS/Linux hosts.
+ * Can be overridden with DA_LOCAL=true or DA_LOCAL=false.
+ */
+export declare function isOnDevice(): boolean;
+export declare const config: DeepADBConfig;
+/**
+ * Validate configuration at startup. Returns warnings for non-fatal issues.
+ */
+export declare function validateConfig(): string[];
+//# sourceMappingURL=config.d.ts.map

package/build/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAEhB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IAEvB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IAEtB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IAEvB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IAEtB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IAEvB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IAEnB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;CACxB;AAaD;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAKpC;AAuBD,eAAO,MAAM,MAAM,EAAE,aAUpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAoBzC"}

package/build/config/config.js

@@ -0,0 +1,84 @@
+/**
+ * DeepADB Configuration
+ *
+ * Central configuration for ADB paths, timeouts, and output limits.
+ * Adjust these values based on your environment.
+ */
+import { platform } from "os";
+import { existsSync } from "fs";
+function getDefaultAdbPath() {
+    const isWindows = platform() === "win32";
+    if (isWindows) {
+        const localAppData = process.env.LOCALAPPDATA ?? "";
+        return localAppData
+            ? `${localAppData}\\Android\\Sdk\\platform-tools\\adb.exe`
+            : "adb";
+    }
+    return "adb";
+}
+/**
+ * Detect if we're running directly on an Android device (e.g., Termux).
+ * Checks for /system/build.prop which exists on all Android devices
+ * but never on Windows/macOS/Linux hosts.
+ * Can be overridden with DA_LOCAL=true or DA_LOCAL=false.
+ */
+export function isOnDevice() {
+    const override = process.env.DA_LOCAL;
+    if (override === "true" || override === "1")
+        return true;
+    if (override === "false" || override === "0")
+        return false;
+    return existsSync("/system/build.prop");
+}
+function getTempDir() {
+    // On-device (Termux): use Termux home or /data/local/tmp
+    if (isOnDevice()) {
+        const home = process.env.HOME ?? "/data/local/tmp";
+        return `${home}/.deepadb`;
+    }
+    return platform() === "win32"
+        ? `${process.env.TEMP ?? "C:\\Temp"}\\deepadb`
+        : "/tmp/deepadb";
+}
+function parseIntSafe(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed) || parsed < 0) {
+        console.error(`[DeepADB] Invalid config value "${value}", using default: ${fallback}`);
+        return fallback;
+    }
+    return parsed;
+}
+export const config = {
+    adbPath: process.env.ADB_PATH ?? getDefaultAdbPath(),
+    commandTimeout: parseIntSafe(process.env.DA_TIMEOUT, 30000),
+    maxOutputSize: parseIntSafe(process.env.DA_MAX_OUTPUT, 50000),
+    maxLogcatLines: parseIntSafe(process.env.DA_MAX_LOGCAT, 500),
+    defaultDevice: process.env.DA_DEVICE ?? "",
+    tempDir: process.env.DA_TEMP_DIR ?? getTempDir(),
+    deviceCacheTtl: parseIntSafe(process.env.DA_CACHE_TTL, 5000),
+    retryCount: parseIntSafe(process.env.DA_RETRY_COUNT, 1),
+    retryBaseDelay: parseIntSafe(process.env.DA_RETRY_DELAY, 500),
+};
+/**
+ * Validate configuration at startup. Returns warnings for non-fatal issues.
+ */
+export function validateConfig() {
+    const warnings = [];
+    // Skip ADB binary check in on-device mode (no ADB needed)
+    if (!isOnDevice()) {
+        if (config.adbPath !== "adb" && !existsSync(config.adbPath)) {
+            warnings.push(`ADB binary not found at configured path: ${config.adbPath}. Falling back to PATH lookup.`);
+            config.adbPath = "adb";
+        }
+    }
+    if (config.commandTimeout < 1000) {
+        warnings.push(`Command timeout (${config.commandTimeout}ms) is very low. Commands may fail prematurely.`);
+    }
+    if (config.maxOutputSize < 5000) {
+        warnings.push(`Max output size (${config.maxOutputSize}) is very low. Output will be heavily truncated.`);
+    }
+    return warnings;
+}
+//# sourceMappingURL=config.js.map

package/build/config/config.js.map

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

package/build/graphql-api.d.ts

@@ -0,0 +1,36 @@
+/**
+ * GraphQL API — Composed device query endpoint.
+ *
+ * Optional HTTP endpoint serving a GraphQL API over device state.
+ * Enables clients to compose multiple device queries into a single
+ * request — for example, fetching device info, battery, signal, and
+ * installed packages in one round trip instead of 4+ MCP tool calls.
+ *
+ * Requires the `graphql` npm package as an optional peer dependency:
+ *   npm install graphql
+ *
+ * Set DA_GRAPHQL_PORT to enable. Runs independently from the MCP
+ * transport (stdio/HTTP/WebSocket).
+ *
+ * Endpoints:
+ *   POST /graphql  — GraphQL query execution
+ *   GET  /graphql  — GraphQL query via query string (for introspection tools)
+ *   GET  /health   — Health check
+ *
+ * Example query:
+ *   { devices { serial model androidVersion battery { level charging } } }
+ */
+import { AdbBridge } from "./bridge/adb-bridge.js";
+import { DeviceManager } from "./bridge/device-manager.js";
+import { Logger } from "./middleware/logger.js";
+export interface GraphQLOptions {
+    port: number;
+    host?: string;
+    version?: string;
+}
+/**
+ * Start a GraphQL API server.
+ * Requires the `graphql` npm package to be installed.
+ */
+export declare function startGraphQLApi(bridge: AdbBridge, deviceManager: DeviceManager, options: GraphQLOptions, logger: Logger): Promise<void>;
+//# sourceMappingURL=graphql-api.d.ts.map

package/build/graphql-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-api.d.ts","sourceRoot":"","sources":["../src/graphql-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2JD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAqIf"}