@yume-chan/android-bin 0.0.20 → 0.0.22

package/esm/string-format.js

@@ -0,0 +1,153 @@
+/* eslint-disable @typescript-eslint/no-unsafe-argument */
+export class ParseError extends Error {
+    #expected;
+    get expected() {
+        return this.#expected;
+    }
+    constructor(expected) {
+        super(`Expected ${expected.join(", ")}`);
+        this.#expected = expected;
+    }
+}
+export const p = {
+    literal: (value) => ({
+        parse(reader) {
+            if (!reader.value.startsWith(value, reader.position)) {
+                throw new ParseError([value.charAt(0)]);
+            }
+            reader.position += value.length;
+            return value;
+        },
+        stringify() {
+            return value;
+        },
+    }),
+    digits: () => ({
+        parse(reader) {
+            const match = reader.value.substring(reader.position).match(/^\d+/);
+            if (!match) {
+                throw new ParseError("0123456789".split(""));
+            }
+            reader.position += match[0].length;
+            return Number.parseInt(match[0], 10);
+        },
+        stringify(value) {
+            return value.toString();
+        },
+    }),
+    union: (...args) => ({
+        parse(reader) {
+            const expected = [];
+            for (const format of args) {
+                try {
+                    return format.parse(reader);
+                }
+                catch (e) {
+                    if (e instanceof ParseError) {
+                        expected.push(...e.expected);
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+            }
+            throw new ParseError(expected);
+        },
+        stringify(value) {
+            for (const format of args) {
+                try {
+                    const result = format.stringify(value);
+                    // Parse the result to make sure it is valid
+                    format.parse({ value: result, position: 0 });
+                }
+                catch (e) {
+                    // ignore
+                }
+            }
+            throw new Error("No format matches");
+        },
+    }),
+    separated: (separator, format, min = 0, max = Infinity) => ({
+        parse(reader) {
+            const result = [];
+            while (true) {
+                try {
+                    result.push(format.parse(reader));
+                    if (result.length === max) {
+                        break;
+                    }
+                }
+                catch (e) {
+                    if (result.length < min) {
+                        throw e;
+                    }
+                    else {
+                        break;
+                    }
+                }
+                if (reader.value.startsWith(separator, reader.position)) {
+                    reader.position += separator.length;
+                }
+                else if (result.length < min) {
+                    throw new ParseError([separator.charAt(0)]);
+                }
+                else {
+                    break;
+                }
+            }
+            return result;
+        },
+        stringify(value) {
+            return value.map((item) => format.stringify(item)).join(separator);
+        },
+    }),
+    repeated: (format) => ({
+        parse(reader) {
+            const result = [];
+            while (true) {
+                try {
+                    result.push(format.parse(reader));
+                }
+                catch (e) {
+                    break;
+                }
+            }
+            return result;
+        },
+        stringify(value) {
+            return value.map((item) => format.stringify(item)).join("");
+        },
+    }),
+    sequence: (...args) => ({
+        parse(reader) {
+            const result = {};
+            for (const part of args) {
+                if ("name" in part) {
+                    result[part.name] = part.format.parse(reader);
+                }
+                else {
+                    void part.parse(reader);
+                }
+            }
+            return result;
+        },
+        stringify: (value) => {
+            let result = "";
+            for (const part of args) {
+                if ("name" in part) {
+                    result += part.format.stringify(value[part.name]);
+                }
+            }
+            return result;
+        },
+    }),
+    map: (format, map, reverse) => ({
+        parse(reader) {
+            return map(format.parse(reader));
+        },
+        stringify(value) {
+            return format.stringify(reverse(value));
+        },
+    }),
+};
+//# sourceMappingURL=string-format.js.map

package/esm/string-format.js.map

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

package/esm/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function buildArguments<T>(commands: string[], options: Partial<T> | undefined, map: Partial<Record<keyof T, string>>): string[];
+export type SingleUser = number | "current";
+export type SingleUserOrAll = SingleUser | "all";
+//# sourceMappingURL=utils.d.ts.map

package/esm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,CAAC,EAC5B,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,EAC/B,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GACtC,MAAM,EAAE,CAqBV;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAC5C,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,KAAK,CAAC"}

package/esm/utils.js

@@ -0,0 +1,23 @@
+export function buildArguments(commands, options, map) {
+    const args = commands;
+    if (options) {
+        for (const [key, value] of Object.entries(options)) {
+            if (value) {
+                const option = map[key];
+                if (option) {
+                    args.push(option);
+                    switch (typeof value) {
+                        case "number":
+                            args.push(value.toString());
+                            break;
+                        case "string":
+                            args.push(value);
+                            break;
+                    }
+                }
+            }
+        }
+    }
+    return args;
+}
+//# sourceMappingURL=utils.js.map

package/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAC1B,QAAkB,EAClB,OAA+B,EAC/B,GAAqC;IAErC,MAAM,IAAI,GAAG,QAAQ,CAAC;IACtB,IAAI,OAAO,EAAE,CAAC;QACV,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,MAAM,GAAG,GAAG,CAAC,GAAc,CAAC,CAAC;gBACnC,IAAI,MAAM,EAAE,CAAC;oBACT,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAClB,QAAQ,OAAO,KAAK,EAAE,CAAC;wBACnB,KAAK,QAAQ;4BACT,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;4BAC5B,MAAM;wBACV,KAAK,QAAQ;4BACT,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;4BACjB,MAAM;oBACd,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yume-chan/android-bin",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "description": "Wrappers for Android built-in executables.",
   "keywords": [
     "adb",
@@ -25,21 +25,26 @@
   "main": "esm/index.js",
   "types": "esm/index.d.ts",
   "dependencies": {
-    "@yume-chan/adb": "^0.0.20",
-    "@yume-chan/stream-extra": "^0.0.20",
-    "@yume-chan/struct": "^0.0.20",
-    "tslib": "^2.5.2"
+    "@yume-chan/adb": "^0.0.22",
+    "@yume-chan/stream-extra": "^0.0.22",
+    "@yume-chan/struct": "^0.0.22",
+    "tslib": "^2.6.2"
   },
   "devDependencies": {
+    "@jest/globals": "^29.7.0",
     "@yume-chan/eslint-config": "^1.0.0",
     "@yume-chan/tsconfig": "^1.0.0",
-    "eslint": "^8.41.0",
-    "prettier": "^2.8.8",
-    "typescript": "^5.0.3"
+    "cross-env": "^7.0.3",
+    "eslint": "^8.55.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.2"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",
     "build:watch": "tsc -b tsconfig.build.json",
+    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --coverage",
     "lint": "eslint src/**/*.ts --fix && prettier src/**/*.ts --write --tab-width 4"
   }
 }

package/src/am.ts

@@ -0,0 +1,69 @@
+import type { Adb } from "@yume-chan/adb";
+import { AdbCommandBase } from "@yume-chan/adb";
+import { ConcatStringStream, DecodeUtf8Stream } from "@yume-chan/stream-extra";
+
+import { Cmd } from "./cmd.js";
+import type { IntentBuilder } from "./intent.js";
+import type { SingleUser } from "./utils.js";
+import { buildArguments } from "./utils.js";
+
+export interface ActivityManagerStartActivityOptions {
+    displayId?: number;
+    windowingMode?: number;
+    forceStop?: boolean;
+    user?: SingleUser;
+    intent: IntentBuilder;
+}
+
+const START_ACTIVITY_OPTIONS_MAP: Partial<
+    Record<keyof ActivityManagerStartActivityOptions, string>
+> = {
+    displayId: "--display",
+    windowingMode: "--windowingMode",
+    forceStop: "-S",
+    user: "--user",
+};
+
+export class ActivityManager extends AdbCommandBase {
+    #cmd: Cmd;
+
+    constructor(adb: Adb) {
+        super(adb);
+        this.#cmd = new Cmd(adb);
+    }
+
+    async #cmdOrSubprocess(args: string[]) {
+        if (this.#cmd.supportsCmd) {
+            args.shift();
+            return await this.#cmd.spawn(false, "activity", ...args);
+        }
+
+        return this.adb.subprocess.spawn(args);
+    }
+
+    async startActivity(options: ActivityManagerStartActivityOptions) {
+        let args = buildArguments(
+            ["am", "start-activity", "-W"],
+            options,
+            START_ACTIVITY_OPTIONS_MAP,
+        );
+
+        args = args.concat(options.intent.build());
+
+        const process = await this.#cmdOrSubprocess(args);
+
+        const output = await process.stdout
+            .pipeThrough(new DecodeUtf8Stream())
+            .pipeThrough(new ConcatStringStream())
+            .then((output) => output.trim());
+
+        for (const line of output) {
+            if (line.startsWith("Error:")) {
+                throw new Error(line.substring("Error:".length).trim());
+            }
+            if (line === "Complete") {
+                return;
+            }
+        }
+    }
+}

package/src/bu.ts

@@ -1,26 +1,80 @@
-// cspell: ignore apks
-// cspell: ignore obbs
-
 import { AdbCommandBase } from "@yume-chan/adb";
+import type { Consumable, ReadableStream } from "@yume-chan/stream-extra";
+import { ConcatStringStream, DecodeUtf8Stream } from "@yume-chan/stream-extra";
 
 export interface AdbBackupOptions {
-    apps: string[] | "all" | "all-including-system";
-    apks: boolean;
-    obbs: boolean;
-    shared: boolean;
-    widgets: boolean;
+    user: number;
+    saveSharedStorage?: boolean;
+    saveWidgets?: boolean;
+    packages: string[] | "user" | "all";
+    savePackageApk: boolean;
+    savePackageObb: boolean;
+    savePackageKeyValue: boolean;
     compress: boolean;
+}
+
+export interface AdbRestoreOptions {
     user: number;
+    file: ReadableStream<Consumable<Uint8Array>>;
 }
 
 export class AdbBackup extends AdbCommandBase {
-    backup(options: AdbBackupOptions): Promise<void> {
-        void options;
-        throw new Error("Not implemented");
+    /**
+     * User must confirm backup on device within 60 seconds.
+     */
+    async backup(
+        options: AdbBackupOptions,
+    ): Promise<ReadableStream<Uint8Array>> {
+        const args = ["bu", "backup"];
+
+        if (options.user !== undefined) {
+            args.push("--user", options.user.toString());
+        }
+
+        args.push(options.saveSharedStorage ? "--shared" : "--no-shared");
+        args.push(options.saveWidgets ? "--widgets" : "--no-widgets");
+
+        args.push(options.savePackageApk ? "--apk" : "--no-apk");
+        args.push(options.savePackageObb ? "--obb" : "--no-obb");
+        args.push(
+            options.savePackageKeyValue ? "--key-value" : "--no-key-value",
+        );
+
+        args.push(options.compress ? "--compress" : "--no-compress");
+
+        if (typeof options.packages === "string") {
+            switch (options.packages) {
+                case "user":
+                    args.push("--all", "--no-system");
+                    break;
+                case "all":
+                    args.push("--all", "--system");
+                    break;
+            }
+        } else {
+            args.push(...options.packages);
+        }
+
+        const process = await this.adb.subprocess.spawn(args);
+        return process.stdout;
     }
 
-    restore(options: AdbBackupOptions): Promise<void> {
-        void options;
-        throw new Error("Not implemented");
+    /**
+     * User must enter the password (if any) and
+     * confirm restore on device within 60 seconds.
+     */
+    async restore(options: AdbRestoreOptions): Promise<string> {
+        const args = ["bu", "restore"];
+        if (options.user !== undefined) {
+            args.push("--user", options.user.toString());
+        }
+        const process = await this.adb.subprocess.spawn(args);
+        const [output] = await Promise.all([
+            process.stdout
+                .pipeThrough(new DecodeUtf8Stream())
+                .pipeThrough(new ConcatStringStream()),
+            options.file.pipeTo(process.stdin),
+        ]);
+        return output;
     }
 }