@yume-chan/android-bin 0.0.12 → 0.0.15

package/.rush/temp/package-deps_build.json

@@ -1,11 +1,15 @@
 {
   "files": {
-    "libraries/android-bin/.rush/temp/shrinkwrap-deps.json": "c2eea9e95f7a91089a0529b750286ccd75726818",
+    "libraries/android-bin/.rush/temp/shrinkwrap-deps.json": "33b90fa9ac2c165d2c550be4daa30217e725766d",
+    "libraries/android-bin/CHANGELOG.json": "9b60c01d989ef7adc1d88dd37e1a775ad5c7fb9a",
+    "libraries/android-bin/CHANGELOG.md": "4acf062834c059898923e0b42d694e4412cbe985",
     "libraries/android-bin/README.md": "96d1e739d73df6dc17920182c1c5799b65652b69",
-    "libraries/android-bin/package.json": "d520445357198824728876bfd7175f94e923a1a4",
-    "libraries/android-bin/src/bug-report.ts": "f2cd3131b59f12a06b943e492274a258123ff6e1",
+    "libraries/android-bin/package.json": "4810207a9afe430efae52769919481fdabdcf8f6",
+    "libraries/android-bin/src/bu.ts": "cd4d6867127ea824c524989626268b26dde3c7de",
+    "libraries/android-bin/src/bug-report.ts": "b4d7c78eaa2abb610a88f240872d209d083b70c9",
     "libraries/android-bin/src/demo-mode.ts": "1ee4a2d1bc238a1600387fc39549241a2a6bb161",
-    "libraries/android-bin/src/index.ts": "c9c23c664f823e0dc557405cd538ea8ace80cd3e",
+    "libraries/android-bin/src/index.ts": "829476e842a0c136d900c623e14a6f341dba5651",
+    "libraries/android-bin/src/logcat.ts": "dc0cb6c8cc75891df866c0ef9a941ca1f4f690ba",
     "libraries/android-bin/src/settings.ts": "a323081296746d78ea07f473680321331ff0d46c",
     "libraries/android-bin/tsconfig.json": "39805c3201f468dc5a1a584b592970777c655bca"
   },

package/.rush/temp/package-deps_build_watch.json

@@ -1,11 +1,15 @@
 {
   "files": {
-    "libraries/android-bin/.rush/temp/shrinkwrap-deps.json": "c2eea9e95f7a91089a0529b750286ccd75726818",
+    "libraries/android-bin/.rush/temp/shrinkwrap-deps.json": "86fa479db15bdf15272048209ee971fd39dce07f",
+    "libraries/android-bin/CHANGELOG.json": "eb6e965fef89ddcbec37a446dc6bfea34ea9a900",
+    "libraries/android-bin/CHANGELOG.md": "d285b842dd4a323acabc825cb24265646269f0ea",
     "libraries/android-bin/README.md": "96d1e739d73df6dc17920182c1c5799b65652b69",
-    "libraries/android-bin/package.json": "d520445357198824728876bfd7175f94e923a1a4",
-    "libraries/android-bin/src/bug-report.ts": "f2cd3131b59f12a06b943e492274a258123ff6e1",
+    "libraries/android-bin/package.json": "b0e38dd07f64f0bbe3f74d7f3df27a85a4292250",
+    "libraries/android-bin/src/bu.ts": "cd4d6867127ea824c524989626268b26dde3c7de",
+    "libraries/android-bin/src/bug-report.ts": "b4d7c78eaa2abb610a88f240872d209d083b70c9",
     "libraries/android-bin/src/demo-mode.ts": "1ee4a2d1bc238a1600387fc39549241a2a6bb161",
-    "libraries/android-bin/src/index.ts": "c9c23c664f823e0dc557405cd538ea8ace80cd3e",
+    "libraries/android-bin/src/index.ts": "829476e842a0c136d900c623e14a6f341dba5651",
+    "libraries/android-bin/src/logcat.ts": "dc0cb6c8cc75891df866c0ef9a941ca1f4f690ba",
     "libraries/android-bin/src/settings.ts": "a323081296746d78ea07f473680321331ff0d46c",
     "libraries/android-bin/tsconfig.json": "39805c3201f468dc5a1a584b592970777c655bca"
   },

package/.rush/temp/shrinkwrap-deps.json

@@ -1,4 +1,4 @@
 {
-  "tslib@2.3.1": "sha512-77EbyPPpMz+FRFRuAFlWMtmgUWGe9UOG2Z25NqCwiIjRhOf5iKGuzSe5P2w1laq+FkRy4p+PCuVkJSGkzTEKVw==",
-  "typescript@4.7.0-dev.20220403": "sha512-1kTFg2+08XMrBmgDDQVNxSmDWcVstTcNT+rt9JC9Z511ewqUYe45IpWSVdS/xSSTei3N5grakAVbSAhZO0HloA=="
+  "tslib@2.4.0": "sha512-d6xOpEDfsi2CZVlPQzGeux8XMwLT9hssAsaPYExaQMuYskwb+x1x7J371tWlbBdWHroy99KnVB6qIkUbs5X3UQ==",
+  "typescript@4.7.0-beta": "sha512-m+CNL8lzHyHDxYYDTI+pm5hw5/bufYVGan2bokPyJY/y9C/4W/PCWMtYZ0vV9fLXbEL57elMeoaz9Evxs8UQ+A=="
 }

package/CHANGELOG.json

@@ -1,6 +1,33 @@
 {
   "name": "@yume-chan/android-bin",
   "entries": [
+    {
+      "version": "0.0.15",
+      "tag": "@yume-chan/android-bin_v0.0.15",
+      "date": "Mon, 02 May 2022 04:18:01 GMT",
+      "comments": {}
+    },
+    {
+      "version": "0.0.14",
+      "tag": "@yume-chan/android-bin_v0.0.14",
+      "date": "Sat, 30 Apr 2022 14:05:48 GMT",
+      "comments": {}
+    },
+    {
+      "version": "0.0.13",
+      "tag": "@yume-chan/android-bin_v0.0.13",
+      "date": "Thu, 28 Apr 2022 01:23:53 GMT",
+      "comments": {
+        "none": [
+          {
+            "comment": "Add support for bugreport/bugreportz"
+          },
+          {
+            "comment": "Add basic support for logcat"
+          }
+        ]
+      }
+    },
     {
       "version": "0.0.12",
       "tag": "@yume-chan/android-bin_v0.0.12",

package/CHANGELOG.md

@@ -1,6 +1,24 @@
 # Change Log - @yume-chan/android-bin
 
-This log was last generated on Sun, 03 Apr 2022 11:18:47 GMT and should not be manually modified.
+This log was last generated on Mon, 02 May 2022 04:18:01 GMT and should not be manually modified.
+
+## 0.0.15
+Mon, 02 May 2022 04:18:01 GMT
+
+_Version update only_
+
+## 0.0.14
+Sat, 30 Apr 2022 14:05:48 GMT
+
+_Version update only_
+
+## 0.0.13
+Thu, 28 Apr 2022 01:23:53 GMT
+
+### Updates
+
+- Add support for bugreport/bugreportz
+- Add basic support for logcat
 
 ## 0.0.12
 Sun, 03 Apr 2022 11:18:47 GMT

package/android-bin.build.log

@@ -1,2 +1,2 @@
-Invoking: build-ts-package 
+Invoking: build-ts-package --incremental 
 

package/esm/bu.d.ts

@@ -0,0 +1,15 @@
+import { AdbCommandBase } from "@yume-chan/adb";
+export interface AdbBackupOptions {
+    apps: string[] | 'all' | 'all-including-system';
+    apks: boolean;
+    obbs: boolean;
+    shared: boolean;
+    widgets: boolean;
+    compress: boolean;
+    user: number;
+}
+export declare class AdbBackup extends AdbCommandBase {
+    backup(options: AdbBackupOptions): Promise<void>;
+    restore(options: AdbBackupOptions): Promise<void>;
+}
+//# sourceMappingURL=bu.d.ts.map

package/esm/bu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bu.d.ts","sourceRoot":"","sources":["../src/bu.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,sBAAsB,CAAC;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,SAAU,SAAQ,cAAc;IACnC,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAGhD,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAE1D"}

package/esm/bu.js

@@ -0,0 +1,10 @@
+// cspell: ignore apks
+// cspell: ignore obbs
+import { AdbCommandBase } from "@yume-chan/adb";
+export class AdbBackup extends AdbCommandBase {
+    async backup(options) {
+    }
+    async restore(options) {
+    }
+}
+//# sourceMappingURL=bu.js.map

package/esm/bu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bu.js","sourceRoot":"","sources":["../src/bu.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,sBAAsB;AAEtB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAYhD,MAAM,OAAO,SAAU,SAAQ,cAAc;IACzC,KAAK,CAAC,MAAM,CAAC,OAAyB;IACtC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAyB;IACvC,CAAC;CACJ"}

package/esm/bug-report.d.ts

@@ -1,7 +1,9 @@
 import { AdbCommandBase, ReadableStream } from "@yume-chan/adb";
-export interface BugReportVersion {
+export interface BugReportZVersion {
     major: number;
     minor: number;
+    supportProgress: boolean;
+    supportStream: boolean;
 }
 export declare class BugReportZ extends AdbCommandBase {
     static VERSION_REGEX: RegExp;
@@ -14,21 +16,22 @@ export declare class BugReportZ extends AdbCommandBase {
      *
      * @returns a `BugReportVersion` object, or `undefined` if `bugreportz` is not available.
      */
-    version(): Promise<BugReportVersion | undefined>;
-    supportStream(version: BugReportVersion): boolean;
-    stream(): ReadableStream<Uint8Array>;
-    supportProgress(version: BugReportVersion): boolean;
+    version(): Promise<BugReportZVersion | undefined>;
+    supportProgress(major: number, minor: number): boolean;
     /**
      * Create a zipped bugreport file.
      *
-     * Compare to `stream`, this method will write the output on device. You can pull it using sync protocol.
+     * Compare to `stream`, this method will write the output to a file on device.
+     * You can pull it later using sync protocol.
      *
-     * @param onProgress Progress callback. Only specify this if `supportsProgress()` returns `true`.
+     * @param onProgress Progress callback. Only specify this if `supportsProgress` is `true`.
      * @returns The path of the bugreport file.
      */
     generate(onProgress?: (progress: string, total: string) => void): Promise<string>;
+    supportStream(major: number, minor: number): boolean;
+    stream(): ReadableStream<Uint8Array>;
 }
 export declare class BugReport extends AdbCommandBase {
-    generate(): ReadableStream<string>;
+    generate(): ReadableStream<Uint8Array>;
 }
 //# sourceMappingURL=bug-report.d.ts.map

package/esm/bug-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bug-report.d.ts","sourceRoot":"","sources":["../src/bug-report.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAgD,cAAc,EAAuD,MAAM,gBAAgB,CAAC;AAEnK,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,UAAW,SAAQ,cAAc;IAC1C,OAAc,aAAa,SAAkB;IAE7C,OAAc,WAAW,SAAgB;IAEzC,OAAc,cAAc,SAAyB;IAErD,OAAc,QAAQ,SAAa;IAEnC,OAAc,UAAU,SAAe;IAEvC;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAsBtD,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAIjD,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;IAYpC,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IAI1D;;;;;;;OAOG;IACU,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAmDjG;AAED,qBAAa,SAAU,SAAQ,cAAc;IAClC,QAAQ,IAAI,cAAc,CAAC,MAAM,CAAC;CAY5C"}
+{"version":3,"file":"bug-report.d.ts","sourceRoot":"","sources":["../src/bug-report.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAoE,cAAc,EAAuD,MAAM,gBAAgB,CAAC;AAEvL,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IAEd,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,UAAW,SAAQ,cAAc;IAC1C,OAAc,aAAa,SAAkB;IAE7C,OAAc,WAAW,SAAgB;IAEzC,OAAc,cAAc,SAAyB;IAErD,OAAc,QAAQ,SAAa;IAEnC,OAAc,UAAU,SAAe;IAEvC;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IA2BvD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAI7D;;;;;;;;OAQG;IACU,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAmDvF,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAIpD,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;CAoB9C;AAGD,qBAAa,SAAU,SAAQ,cAAc;IAClC,QAAQ,IAAI,cAAc,CAAC,UAAU,CAAC;CAMhD"}

package/esm/bug-report.js

@@ -1,6 +1,6 @@
 // cspell: ignore bugreport
 // cspell: ignore bugreportz
-import { AdbCommandBase, AdbShellSubprocessProtocol, DecodeUtf8Stream, SplitLineStream, WrapReadableStream, WritableStream } from "@yume-chan/adb";
+import { AdbCommandBase, AdbSubprocessShellProtocol, DecodeUtf8Stream, PushReadableStream, SplitLineStream, WrapReadableStream, WritableStream } from "@yume-chan/adb";
 export class BugReportZ extends AdbCommandBase {
     static VERSION_REGEX = /(\d+)\.(\d+)/;
     static BEGIN_REGEX = /BEGIN:(.*)/;
@@ -14,7 +14,7 @@ export class BugReportZ extends AdbCommandBase {
      */
     async version() {
         // bugreportz requires shell protocol
-        if (!AdbShellSubprocessProtocol.isSupported(this.adb)) {
+        if (!AdbSubprocessShellProtocol.isSupported(this.adb)) {
             return undefined;
         }
         const { stderr, exitCode } = await this.adb.subprocess.spawnAndWait(['bugreportz', '-v']);
@@ -25,34 +25,25 @@ export class BugReportZ extends AdbCommandBase {
         if (!match) {
             return undefined;
         }
+        const major = parseInt(match[1], 10);
+        const minor = parseInt(match[2], 10);
         return {
-            major: parseInt(match[1], 10),
-            minor: parseInt(match[2], 10),
+            major,
+            minor,
+            supportProgress: this.supportProgress(major, minor),
+            supportStream: this.supportStream(major, minor),
         };
     }
-    supportStream(version) {
-        return version.major > 1 || version.minor >= 2;
-    }
-    stream() {
-        return new WrapReadableStream({
-            start: async () => {
-                const process = await this.adb.subprocess.spawn(['bugreportz', '-s']);
-                return {
-                    readable: process.stdout,
-                    state: undefined,
-                };
-            },
-        });
-    }
-    supportProgress(version) {
-        return version.major > 1 || version.minor >= 1;
+    supportProgress(major, minor) {
+        return major > 1 || minor >= 1;
     }
     /**
      * Create a zipped bugreport file.
      *
-     * Compare to `stream`, this method will write the output on device. You can pull it using sync protocol.
+     * Compare to `stream`, this method will write the output to a file on device.
+     * You can pull it later using sync protocol.
      *
-     * @param onProgress Progress callback. Only specify this if `supportsProgress()` returns `true`.
+     * @param onProgress Progress callback. Only specify this if `supportsProgress` is `true`.
      * @returns The path of the bugreport file.
      */
     async generate(onProgress) {
@@ -67,7 +58,7 @@ export class BugReportZ extends AdbCommandBase {
             .pipeThrough(new SplitLineStream())
             .pipeTo(new WritableStream({
             write(line) {
-                // (Not 100% sure) `BEGIN:` and `PROGRESS:` only appear when `-p` is specified.
+                // `BEGIN:` and `PROGRESS:` only appear when `-p` is specified.
                 let match = line.match(BugReportZ.PROGRESS_REGEX);
                 if (match) {
                     onProgress?.(match[1], match[2]);
@@ -97,18 +88,36 @@ export class BugReportZ extends AdbCommandBase {
         // Design choice: we don't automatically pull the file to avoid more dependency on `@yume-chan/adb`
         return filename;
     }
+    supportStream(major, minor) {
+        return major > 1 || minor >= 2;
+    }
+    stream() {
+        return new PushReadableStream(async (controller) => {
+            const process = await this.adb.subprocess.spawn(['bugreportz', '-s']);
+            process.stdout
+                .pipeTo(new WritableStream({
+                async write(chunk) {
+                    await controller.enqueue(chunk);
+                },
+            }));
+            process.stderr
+                .pipeThrough(new DecodeUtf8Stream())
+                .pipeTo(new WritableStream({
+                async write(chunk) {
+                    controller.error(new Error(chunk));
+                }
+            }));
+            await process.exit;
+            controller.close();
+        });
+    }
 }
+// https://cs.android.com/android/platform/superproject/+/master:frameworks/native/cmds/bugreport/bugreport.cpp;drc=9b73bf07d73dbab5b792632e1e233edbad77f5fd;bpv=0;bpt=0
 export class BugReport extends AdbCommandBase {
     generate() {
-        return new WrapReadableStream({
-            start: async () => {
-                const process = await this.adb.subprocess.spawn(['bugreport']);
-                return {
-                    readable: process.stdout
-                        .pipeThrough(new DecodeUtf8Stream()),
-                    state: undefined,
-                };
-            }
+        return new WrapReadableStream(async () => {
+            const process = await this.adb.subprocess.spawn(['bugreport']);
+            return process.stdout;
         });
     }
 }

package/esm/bug-report.js.map

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

package/esm/index.d.ts

@@ -1,4 +1,5 @@
 export * from './bug-report.js';
 export * from './demo-mode.js';
+export * from './logcat.js';
 export * from './settings.js';
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/esm/index.js

@@ -1,4 +1,6 @@
+// cspell: ignore logcat
 export * from './bug-report.js';
 export * from './demo-mode.js';
+export * from './logcat.js';
 export * from './settings.js';
 //# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAExB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/esm/logcat.d.ts

@@ -0,0 +1,65 @@
+import { AdbCommandBase, ReadableStream } from "@yume-chan/adb";
+import Struct, { StructAsyncDeserializeStream } from "@yume-chan/struct";
+export declare enum LogId {
+    All = -1,
+    Main = 0,
+    Radio = 1,
+    Events = 2,
+    System = 3,
+    Crash = 4,
+    Stats = 5,
+    Security = 6,
+    Kernel = 7
+}
+export declare enum LogPriority {
+    Unknown = 0,
+    Default = 1,
+    Verbose = 2,
+    Info = 3,
+    Warn = 4,
+    Error = 5,
+    Fatal = 6,
+    Silent = 7
+}
+export interface LogcatOptions {
+    pid?: number;
+    ids?: LogId[];
+}
+export declare const LoggerEntry: Struct<{
+    payloadSize: number;
+    headerSize: number;
+    pid: number;
+    tid: number;
+    second: number;
+    nanoseconds: number;
+    logId: number;
+    uid: number;
+}, never, {
+    readonly timestamp: bigint;
+}, undefined>;
+export declare type LoggerEntry = typeof LoggerEntry['TDeserializeResult'];
+export interface LogMessage extends LoggerEntry {
+    priority: LogPriority;
+    payload: Uint8Array;
+}
+export declare function deserializeLogMessage(stream: StructAsyncDeserializeStream): Promise<LogMessage>;
+export interface LogSize {
+    id: LogId;
+    size: number;
+    readable?: number;
+    consumed: number;
+    maxEntrySize: number;
+    maxPayloadSize: number;
+}
+export declare class Logcat extends AdbCommandBase {
+    static logIdToName(id: LogId): string;
+    static logNameToId(name: string): LogId;
+    static joinLogId(ids: LogId[]): string;
+    static parseSize(value: number, multiplier: string): number;
+    static readonly LOG_SIZE_REGEX_10: RegExp;
+    static readonly LOG_SIZE_REGEX_11: RegExp;
+    getLogSize(ids?: LogId[]): Promise<LogSize[]>;
+    clear(ids?: LogId[]): Promise<void>;
+    binary(options?: LogcatOptions): ReadableStream<LogMessage>;
+}
+//# sourceMappingURL=logcat.d.ts.map

package/esm/logcat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logcat.d.ts","sourceRoot":"","sources":["../src/logcat.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAA8D,cAAc,EAAmC,MAAM,gBAAgB,CAAC;AAC7J,OAAO,MAAM,EAAE,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAMzE,oBAAY,KAAK;IACb,GAAG,KAAK;IACR,IAAI,IAAA;IACJ,KAAK,IAAA;IACL,MAAM,IAAA;IACN,MAAM,IAAA;IACN,KAAK,IAAA;IACL,KAAK,IAAA;IACL,QAAQ,IAAA;IACR,MAAM,IAAA;CACT;AAED,oBAAY,WAAW;IACnB,OAAO,IAAA;IACP,OAAO,IAAA;IACP,OAAO,IAAA;IACP,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,KAAK,IAAA;IACL,KAAK,IAAA;IACL,MAAM,IAAA;CACT;AAED,MAAM,WAAW,aAAa;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAKD,eAAO,MAAM,WAAW;;;;;;;;;;;aAcd,CAAC;AAEX,oBAAY,WAAW,GAAG,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;AAEnE,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC3C,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;CACvB;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC,UAAU,CAAC,CAMrG;AAED,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,MAAO,SAAQ,cAAc;WACxB,WAAW,CAAC,EAAE,EAAE,KAAK,GAAG,MAAM;WAI9B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;WAKhC,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,MAAM;WAI/B,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAOlE,gBAAuB,iBAAiB,SAAyG;IAIjJ,gBAAuB,iBAAiB,SAA8H;IAEzJ,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAyC7C,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE;IAQzB,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC;CA8BrE"}

package/esm/logcat.js

@@ -0,0 +1,149 @@
+// cspell: ignore logcat
+import { AdbCommandBase, BufferedStream, BufferedStreamEndedError, DecodeUtf8Stream, ReadableStream, SplitLineStream, WritableStream } from "@yume-chan/adb";
+import Struct from "@yume-chan/struct";
+// `adb logcat` is an alias to `adb shell logcat`
+// so instead of adding to core library, it's implemented here
+// https://cs.android.com/android/platform/superproject/+/master:system/logging/liblog/include/android/log.h;l=141;drc=82b5738732161dbaafb2e2f25cce19cd26b9157d
+export var LogId;
+(function (LogId) {
+    LogId[LogId["All"] = -1] = "All";
+    LogId[LogId["Main"] = 0] = "Main";
+    LogId[LogId["Radio"] = 1] = "Radio";
+    LogId[LogId["Events"] = 2] = "Events";
+    LogId[LogId["System"] = 3] = "System";
+    LogId[LogId["Crash"] = 4] = "Crash";
+    LogId[LogId["Stats"] = 5] = "Stats";
+    LogId[LogId["Security"] = 6] = "Security";
+    LogId[LogId["Kernel"] = 7] = "Kernel";
+})(LogId || (LogId = {}));
+export var LogPriority;
+(function (LogPriority) {
+    LogPriority[LogPriority["Unknown"] = 0] = "Unknown";
+    LogPriority[LogPriority["Default"] = 1] = "Default";
+    LogPriority[LogPriority["Verbose"] = 2] = "Verbose";
+    LogPriority[LogPriority["Info"] = 3] = "Info";
+    LogPriority[LogPriority["Warn"] = 4] = "Warn";
+    LogPriority[LogPriority["Error"] = 5] = "Error";
+    LogPriority[LogPriority["Fatal"] = 6] = "Fatal";
+    LogPriority[LogPriority["Silent"] = 7] = "Silent";
+})(LogPriority || (LogPriority = {}));
+const NANOSECONDS_PER_SECOND = BigInt(1e9);
+// https://cs.android.com/android/platform/superproject/+/master:system/logging/liblog/include/log/log_read.h;l=39;drc=82b5738732161dbaafb2e2f25cce19cd26b9157d
+export const LoggerEntry = new Struct({ littleEndian: true })
+    .uint16('payloadSize')
+    .uint16('headerSize')
+    .int32('pid')
+    .uint32('tid')
+    .uint32('second')
+    .uint32('nanoseconds')
+    .uint32('logId')
+    .uint32('uid')
+    .extra({
+    get timestamp() {
+        return BigInt(this.second) * NANOSECONDS_PER_SECOND + BigInt(this.nanoseconds);
+    },
+});
+export async function deserializeLogMessage(stream) {
+    const entry = await LoggerEntry.deserialize(stream);
+    await stream.read(entry.headerSize - LoggerEntry.size);
+    const priority = (await stream.read(1))[0];
+    const payload = await stream.read(entry.payloadSize - 1);
+    return { ...entry, priority, payload };
+}
+export class Logcat extends AdbCommandBase {
+    static logIdToName(id) {
+        return LogId[id];
+    }
+    static logNameToId(name) {
+        const key = name[0].toUpperCase() + name.substring(1);
+        return LogId[key];
+    }
+    static joinLogId(ids) {
+        return ids.map(id => Logcat.logIdToName(id)).join(',');
+    }
+    static parseSize(value, multiplier) {
+        const MULTIPLIERS = ['', 'Ki', 'Mi', 'Gi'];
+        return value * 1024 ** (MULTIPLIERS.indexOf(multiplier) || 0);
+    }
+    // TODO: logcat: Support output format before Android 10
+    // ref https://android-review.googlesource.com/c/platform/system/core/+/748128
+    static LOG_SIZE_REGEX_10 = /(.*): ring buffer is (.*) (.*)B \((.*) (.*)B consumed\), max entry is (.*) B, max payload is (.*) B/;
+    // Android 11 added `readable` part
+    // ref https://android-review.googlesource.com/c/platform/system/core/+/1390940
+    static LOG_SIZE_REGEX_11 = /(.*): ring buffer is (.*) (.*)B \((.*) (.*)B consumed, (.*) (.*)B readable\), max entry is (.*) B, max payload is (.*) B/;
+    async getLogSize(ids) {
+        const { stdout } = await this.adb.subprocess.spawn([
+            'logcat',
+            '-g',
+            ...(ids ? ['-b', Logcat.joinLogId(ids)] : [])
+        ]);
+        const result = [];
+        await stdout
+            .pipeThrough(new DecodeUtf8Stream())
+            .pipeThrough(new SplitLineStream())
+            .pipeTo(new WritableStream({
+            write(chunk) {
+                let match = chunk.match(Logcat.LOG_SIZE_REGEX_11);
+                if (match) {
+                    result.push({
+                        id: Logcat.logNameToId(match[1]),
+                        size: Logcat.parseSize(Number.parseInt(match[2], 10), match[3]),
+                        readable: Logcat.parseSize(Number.parseInt(match[6], 10), match[7]),
+                        consumed: Logcat.parseSize(Number.parseInt(match[4], 10), match[5]),
+                        maxEntrySize: parseInt(match[8], 10),
+                        maxPayloadSize: parseInt(match[9], 10),
+                    });
+                }
+                match = chunk.match(Logcat.LOG_SIZE_REGEX_10);
+                if (match) {
+                    result.push({
+                        id: Logcat.logNameToId(match[1]),
+                        size: Logcat.parseSize(Number.parseInt(match[2], 10), match[3]),
+                        consumed: Logcat.parseSize(Number.parseInt(match[4], 10), match[5]),
+                        maxEntrySize: parseInt(match[6], 10),
+                        maxPayloadSize: parseInt(match[7], 10),
+                    });
+                }
+            },
+        }));
+        return result;
+    }
+    async clear(ids) {
+        await this.adb.subprocess.spawnAndWait([
+            'logcat',
+            '-c',
+            ...(ids ? ['-b', Logcat.joinLogId(ids)] : []),
+        ]);
+    }
+    binary(options) {
+        let bufferedStream;
+        return new ReadableStream({
+            start: async () => {
+                const { stdout } = await this.adb.subprocess.spawn([
+                    'logcat',
+                    '-B',
+                    ...(options?.pid ? ['--pid', options.pid.toString()] : []),
+                    ...(options?.ids ? ['-b', Logcat.joinLogId(options.ids)] : [])
+                ]);
+                bufferedStream = new BufferedStream(stdout);
+            },
+            async pull(controller) {
+                try {
+                    const entry = await deserializeLogMessage(bufferedStream);
+                    controller.enqueue(entry);
+                }
+                catch (e) {
+                    if (e instanceof BufferedStreamEndedError) {
+                        controller.close();
+                        return;
+                    }
+                    throw e;
+                }
+            },
+            cancel() {
+                bufferedStream.close();
+            },
+        });
+    }
+}
+//# sourceMappingURL=logcat.js.map

package/esm/logcat.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yume-chan/android-bin",
-  "version": "0.0.12",
+  "version": "0.0.15",
   "description": "Wrappers for Android built-in executables.",
   "keywords": [
     "adb",
@@ -25,11 +25,12 @@
   "main": "esm/index.js",
   "types": "esm/index.d.ts",
   "devDependencies": {
-    "typescript": "next",
+    "typescript": "4.7.0-beta",
     "@yume-chan/ts-package-builder": "^1.0.0"
   },
   "dependencies": {
-    "@yume-chan/adb": "^0.0.12",
+    "@yume-chan/adb": "^0.0.15",
+    "@yume-chan/struct": "^0.0.15",
     "tslib": "^2.3.1"
   },
   "scripts": {

package/src/bu.ts

@@ -0,0 +1,22 @@
+// cspell: ignore apks
+// cspell: ignore obbs
+
+import { AdbCommandBase } from "@yume-chan/adb";
+
+export interface AdbBackupOptions {
+    apps: string[] | 'all' | 'all-including-system';
+    apks: boolean;
+    obbs: boolean;
+    shared: boolean;
+    widgets: boolean;
+    compress: boolean;
+    user: number;
+}
+
+export class AdbBackup extends AdbCommandBase {
+    async backup(options: AdbBackupOptions): Promise<void> {
+    }
+
+    async restore(options: AdbBackupOptions): Promise<void> {
+    }
+}

package/src/bug-report.ts

@@ -1,11 +1,14 @@
 // cspell: ignore bugreport
 // cspell: ignore bugreportz
 
-import { AdbCommandBase, AdbShellSubprocessProtocol, DecodeUtf8Stream, ReadableStream, SplitLineStream, WrapReadableStream, WritableStream } from "@yume-chan/adb";
+import { AdbCommandBase, AdbSubprocessShellProtocol, DecodeUtf8Stream, PushReadableStream, ReadableStream, SplitLineStream, WrapReadableStream, WritableStream } from "@yume-chan/adb";
 
-export interface BugReportVersion {
+export interface BugReportZVersion {
     major: number;
     minor: number;
+
+    supportProgress: boolean;
+    supportStream: boolean;
 }
 
 export class BugReportZ extends AdbCommandBase {
@@ -24,9 +27,9 @@ export class BugReportZ extends AdbCommandBase {
      *
      * @returns a `BugReportVersion` object, or `undefined` if `bugreportz` is not available.
      */
-    public async version(): Promise<BugReportVersion | undefined> {
+    public async version(): Promise<BugReportZVersion | undefined> {
         // bugreportz requires shell protocol
-        if (!AdbShellSubprocessProtocol.isSupported(this.adb)) {
+        if (!AdbSubprocessShellProtocol.isSupported(this.adb)) {
             return undefined;
         }
 
@@ -40,38 +43,28 @@ export class BugReportZ extends AdbCommandBase {
             return undefined;
         }
 
+        const major = parseInt(match[1]!, 10);
+        const minor = parseInt(match[2]!, 10);
         return {
-            major: parseInt(match[1]!, 10),
-            minor: parseInt(match[2]!, 10),
-        };
-    }
-
-    public supportStream(version: BugReportVersion): boolean {
-        return version.major > 1 || version.minor >= 2;
-    }
+            major,
+            minor,
 
-    public stream(): ReadableStream<Uint8Array> {
-        return new WrapReadableStream<Uint8Array, ReadableStream<Uint8Array>, undefined>({
-            start: async () => {
-                const process = await this.adb.subprocess.spawn(['bugreportz', '-s']);
-                return {
-                    readable: process.stdout,
-                    state: undefined,
-                };
-            },
-        });
+            supportProgress: this.supportProgress(major, minor),
+            supportStream: this.supportStream(major, minor),
+        };
     }
 
-    public supportProgress(version: BugReportVersion): boolean {
-        return version.major > 1 || version.minor >= 1;
+    public supportProgress(major: number, minor: number): boolean {
+        return major > 1 || minor >= 1;
     }
 
     /**
      * Create a zipped bugreport file.
      *
-     * Compare to `stream`, this method will write the output on device. You can pull it using sync protocol.
+     * Compare to `stream`, this method will write the output to a file on device.
+     * You can pull it later using sync protocol.
      *
-     * @param onProgress Progress callback. Only specify this if `supportsProgress()` returns `true`.
+     * @param onProgress Progress callback. Only specify this if `supportsProgress` is `true`.
      * @returns The path of the bugreport file.
      */
     public async generate(onProgress?: (progress: string, total: string) => void): Promise<string> {
@@ -88,7 +81,7 @@ export class BugReportZ extends AdbCommandBase {
             .pipeThrough(new SplitLineStream())
             .pipeTo(new WritableStream<string>({
                 write(line) {
-                    // (Not 100% sure) `BEGIN:` and `PROGRESS:` only appear when `-p` is specified.
+                    // `BEGIN:` and `PROGRESS:` only appear when `-p` is specified.
                     let match = line.match(BugReportZ.PROGRESS_REGEX);
                     if (match) {
                         onProgress?.(match[1]!, match[2]!);
@@ -109,7 +102,6 @@ export class BugReportZ extends AdbCommandBase {
                         // Don't report error now
                         // We want to gather all output.
                         error = match[1];
-
                     }
                 }
             }));
@@ -125,19 +117,39 @@ export class BugReportZ extends AdbCommandBase {
         // Design choice: we don't automatically pull the file to avoid more dependency on `@yume-chan/adb`
         return filename;
     }
+
+    public supportStream(major: number, minor: number): boolean {
+        return major > 1 || minor >= 2;
+    }
+
+    public stream(): ReadableStream<Uint8Array> {
+        return new PushReadableStream(async (controller) => {
+            const process = await this.adb.subprocess.spawn(['bugreportz', '-s']);
+            process.stdout
+                .pipeTo(new WritableStream({
+                    async write(chunk) {
+                        await controller.enqueue(chunk);
+                    },
+                }));
+            process.stderr
+                .pipeThrough(new DecodeUtf8Stream())
+                .pipeTo(new WritableStream({
+                    async write(chunk) {
+                        controller.error(new Error(chunk));
+                    }
+                }));
+            await process.exit;
+            controller.close();
+        });
+    }
 }
 
+// https://cs.android.com/android/platform/superproject/+/master:frameworks/native/cmds/bugreport/bugreport.cpp;drc=9b73bf07d73dbab5b792632e1e233edbad77f5fd;bpv=0;bpt=0
 export class BugReport extends AdbCommandBase {
-    public generate(): ReadableStream<string> {
-        return new WrapReadableStream<string, ReadableStream<string>, undefined>({
-            start: async () => {
-                const process = await this.adb.subprocess.spawn(['bugreport']);
-                return {
-                    readable: process.stdout
-                        .pipeThrough(new DecodeUtf8Stream()),
-                    state: undefined,
-                };
-            }
+    public generate(): ReadableStream<Uint8Array> {
+        return new WrapReadableStream(async () => {
+            const process = await this.adb.subprocess.spawn(['bugreport']);
+            return process.stdout;
         });
     }
 }

package/src/index.ts

@@ -1,3 +1,6 @@
+// cspell: ignore logcat
+
 export * from './bug-report.js';
 export * from './demo-mode.js';
+export * from './logcat.js';
 export * from './settings.js';

package/src/logcat.ts

@@ -0,0 +1,187 @@
+// cspell: ignore logcat
+
+import { AdbCommandBase, BufferedStream, BufferedStreamEndedError, DecodeUtf8Stream, ReadableStream, SplitLineStream, WritableStream } from "@yume-chan/adb";
+import Struct, { StructAsyncDeserializeStream } from "@yume-chan/struct";
+
+// `adb logcat` is an alias to `adb shell logcat`
+// so instead of adding to core library, it's implemented here
+
+// https://cs.android.com/android/platform/superproject/+/master:system/logging/liblog/include/android/log.h;l=141;drc=82b5738732161dbaafb2e2f25cce19cd26b9157d
+export enum LogId {
+    All = -1,
+    Main,
+    Radio,
+    Events,
+    System,
+    Crash,
+    Stats,
+    Security,
+    Kernel,
+}
+
+export enum LogPriority {
+    Unknown,
+    Default,
+    Verbose,
+    Info,
+    Warn,
+    Error,
+    Fatal,
+    Silent,
+}
+
+export interface LogcatOptions {
+    pid?: number;
+    ids?: LogId[];
+}
+
+const NANOSECONDS_PER_SECOND = BigInt(1e9);
+
+// https://cs.android.com/android/platform/superproject/+/master:system/logging/liblog/include/log/log_read.h;l=39;drc=82b5738732161dbaafb2e2f25cce19cd26b9157d
+export const LoggerEntry =
+    new Struct({ littleEndian: true })
+        .uint16('payloadSize')
+        .uint16('headerSize')
+        .int32('pid')
+        .uint32('tid')
+        .uint32('second')
+        .uint32('nanoseconds')
+        .uint32('logId')
+        .uint32('uid')
+        .extra({
+            get timestamp() {
+                return BigInt(this.second) * NANOSECONDS_PER_SECOND + BigInt(this.nanoseconds);
+            },
+        });
+
+export type LoggerEntry = typeof LoggerEntry['TDeserializeResult'];
+
+export interface LogMessage extends LoggerEntry {
+    priority: LogPriority;
+    payload: Uint8Array;
+}
+
+export async function deserializeLogMessage(stream: StructAsyncDeserializeStream): Promise<LogMessage> {
+    const entry = await LoggerEntry.deserialize(stream);
+    await stream.read(entry.headerSize - LoggerEntry.size);
+    const priority = (await stream.read(1))[0] as LogPriority;
+    const payload = await stream.read(entry.payloadSize - 1);
+    return { ...entry, priority, payload };
+}
+
+export interface LogSize {
+    id: LogId;
+    size: number;
+    readable?: number;
+    consumed: number;
+    maxEntrySize: number;
+    maxPayloadSize: number;
+}
+
+export class Logcat extends AdbCommandBase {
+    public static logIdToName(id: LogId): string {
+        return LogId[id]!;
+    }
+
+    public static logNameToId(name: string): LogId {
+        const key = name[0]!.toUpperCase() + name.substring(1);
+        return (LogId as any)[key];
+    }
+
+    public static joinLogId(ids: LogId[]): string {
+        return ids.map(id => Logcat.logIdToName(id)).join(',');
+    }
+
+    public static parseSize(value: number, multiplier: string): number {
+        const MULTIPLIERS = ['', 'Ki', 'Mi', 'Gi'];
+        return value * 1024 ** (MULTIPLIERS.indexOf(multiplier) || 0);
+    }
+
+    // TODO: logcat: Support output format before Android 10
+    // ref https://android-review.googlesource.com/c/platform/system/core/+/748128
+    public static readonly LOG_SIZE_REGEX_10 = /(.*): ring buffer is (.*) (.*)B \((.*) (.*)B consumed\), max entry is (.*) B, max payload is (.*) B/;
+
+    // Android 11 added `readable` part
+    // ref https://android-review.googlesource.com/c/platform/system/core/+/1390940
+    public static readonly LOG_SIZE_REGEX_11 = /(.*): ring buffer is (.*) (.*)B \((.*) (.*)B consumed, (.*) (.*)B readable\), max entry is (.*) B, max payload is (.*) B/;
+
+    public async getLogSize(ids?: LogId[]): Promise<LogSize[]> {
+        const { stdout } = await this.adb.subprocess.spawn([
+            'logcat',
+            '-g',
+            ...(ids ? ['-b', Logcat.joinLogId(ids)] : [])
+        ]);
+
+        const result: LogSize[] = [];
+        await stdout
+            .pipeThrough(new DecodeUtf8Stream())
+            .pipeThrough(new SplitLineStream())
+            .pipeTo(new WritableStream({
+                write(chunk) {
+                    let match = chunk.match(Logcat.LOG_SIZE_REGEX_11);
+                    if (match) {
+                        result.push({
+                            id: Logcat.logNameToId(match[1]!),
+                            size: Logcat.parseSize(Number.parseInt(match[2]!, 10), match[3]!),
+                            readable: Logcat.parseSize(Number.parseInt(match[6]!, 10), match[7]!),
+                            consumed: Logcat.parseSize(Number.parseInt(match[4]!, 10), match[5]!),
+                            maxEntrySize: parseInt(match[8]!, 10),
+                            maxPayloadSize: parseInt(match[9]!, 10),
+                        });
+                    }
+
+                    match = chunk.match(Logcat.LOG_SIZE_REGEX_10);
+                    if (match) {
+                        result.push({
+                            id: Logcat.logNameToId(match[1]!),
+                            size: Logcat.parseSize(Number.parseInt(match[2]!, 10), match[3]!),
+                            consumed: Logcat.parseSize(Number.parseInt(match[4]!, 10), match[5]!),
+                            maxEntrySize: parseInt(match[6]!, 10),
+                            maxPayloadSize: parseInt(match[7]!, 10),
+                        });
+                    }
+                },
+            }));
+
+        return result;
+    }
+
+    public async clear(ids?: LogId[]) {
+        await this.adb.subprocess.spawnAndWait([
+            'logcat',
+            '-c',
+            ...(ids ? ['-b', Logcat.joinLogId(ids)] : []),
+        ]);
+    }
+
+    public binary(options?: LogcatOptions): ReadableStream<LogMessage> {
+        let bufferedStream: BufferedStream;
+        return new ReadableStream({
+            start: async () => {
+                const { stdout } = await this.adb.subprocess.spawn([
+                    'logcat',
+                    '-B',
+                    ...(options?.pid ? ['--pid', options.pid.toString()] : []),
+                    ...(options?.ids ? ['-b', Logcat.joinLogId(options.ids)] : [])
+                ]);
+                bufferedStream = new BufferedStream(stdout);
+            },
+            async pull(controller) {
+                try {
+                    const entry = await deserializeLogMessage(bufferedStream);
+                    controller.enqueue(entry);
+                } catch (e) {
+                    if (e instanceof BufferedStreamEndedError) {
+                        controller.close();
+                        return;
+                    }
+
+                    throw e;
+                }
+            },
+            cancel() {
+                bufferedStream.close();
+            },
+        });
+    }
+}