@skrillex1224/android-toolkit 1.0.3 → 1.0.6

package/README.md

@@ -16,7 +16,7 @@ await Launch.run(async ({ ctx, kit }) => {
   await ApifyKit.runStep('输入并发送', ctx, async () => {
     await DeviceInput.click(ctx, { id: 'input_text' });
     await DeviceInput.fill(ctx, { id: 'input_text' }, ctx.query);
-    await DeviceInput.pressEnter(ctx);
+    await DeviceInput.click(ctx, { id: 'action_send' });
   });
   await Mutation.waitForStable(ctx, { id: 'message_list' });
   const screenshotBase64 = await Share.captureScreen(ctx);
@@ -35,7 +35,7 @@ await Launch.run(async ({ ctx, kit }) => {
 | `DeviceInput` | View-tree-backed click/fill/press/scroll APIs using ADB input. |
 | `Mutation` | Playwright-like stable wait semantics over matched ViewNode subtrees. |
 | `Share` | Sprite screenshot and clipboard share-link polling. |
-| `Frida` | Public `querySQLite()` and `health()` only. |
+| `DeviceSQLite` | Root ADB-backed private SQLite snapshot queries. |
 | `Constants` | Native-useful actor metadata and codes. |
 | `Errors` | `CrawlerError` and error serialization. |
 
@@ -46,9 +46,8 @@ The toolkit does not install or discover runtime tools.
 Required environment:
 
 - `ANDROID_TOOLKIT_ADB_PATH`
-- `ANDROID_TOOLKIT_FRIDA_PATH`
 
-Device initialization, Appium Settings, UnicodeIME, and frida-server provisioning belong
+Device initialization, Appium Settings, UnicodeIME, and root ADB access belong
 to manager/cluster runtime. Runtime checks fail clearly when prerequisites are missing.
 
 ## Boundaries
@@ -58,14 +57,14 @@ Included:
 - ADB command execution, app launch, key input, screenshot, activity checks.
 - View-tree parsing with a real XML parser.
 - View selector operations: `id`, `text`, `textContains`, `contentDesc`.
-- Internal Frida script execution only where the toolkit owns the behavior, such as
-  SQLite queries or clipboard probing inside `Share`.
+- Root ADB-backed SQLite queries through `DeviceSQLite.query()` only.
 
 Excluded:
 
-- Public generic Frida script execution.
+- Public generic process injection or app hook execution.
+- App hook clipboard helpers.
 - WebView event recorder.
-- Frida UI traversal/click helpers.
+- App hook UI traversal/click helpers.
 - Package name and activity truth. Backend/runtime input owns those values.
 - Actor-specific DB schemas, message parsing, product parsing, and success criteria.
 

package/browser.d.ts

@@ -29,3 +29,15 @@ export namespace Errors {
         }): CrawlerError;
     }
 }
+
+export interface BrowserAndroidToolkit {
+    Constants: typeof Constants;
+    Errors: typeof Errors;
+}
+
+export function useAndroidToolKit(): BrowserAndroidToolkit;
+export namespace useAndroidToolKit {
+    const Mode: {
+        default: 'default';
+    };
+}

package/dist/browser.js

@@ -8,6 +8,7 @@ var __export = (target, all) => {
 var constants_exports = {};
 __export(constants_exports, {
   ActorInfo: () => ActorInfo,
+  AppiumSettings: () => AppiumSettings,
   Code: () => Code,
   Status: () => Status,
   UnicodeIme: () => UnicodeIme
@@ -24,7 +25,7 @@ var Code = Object.freeze({
   ContentUnavailable: 30010003,
   SourceExtractionFailed: 30010004,
   AutomationFailed: 30010005,
-  FridaUnavailable: 30010008,
+  DataAccessUnavailable: 30010008,
   AppNotInstalled: 30010009
 });
 var Status = Object.freeze({
@@ -34,7 +35,12 @@ var Status = Object.freeze({
 var UnicodeIme = Object.freeze({
   packageName: "io.appium.settings",
   component: "io.appium.settings/.UnicodeIME",
-  inputTextAction: "ADB_INPUT_TEXT"
+  inputAction: "ADB_INPUT_TEXT"
+});
+var AppiumSettings = Object.freeze({
+  packageName: "io.appium.settings",
+  clipboardReceiver: "io.appium.settings/.receivers.ClipboardReceiver",
+  clipboardGetAction: "io.appium.settings.clipboard.get"
 });
 var normalizeShare = (share) => {
   const source = share && typeof share === "object" ? share : {};
@@ -100,8 +106,19 @@ function serializeError(error) {
     context: error.context || void 0
   };
 }
+
+// entrys/browser.js
+var ToolkitMode = Object.freeze({
+  default: "default"
+});
+var useAndroidToolKit = () => {
+  return {
+    Constants: constants_exports,
+    Errors: errors_exports
+  };
+};
+useAndroidToolKit.Mode = ToolkitMode;
 export {
-  constants_exports as Constants,
-  errors_exports as Errors
+  useAndroidToolKit
 };
 //# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/constants.js", "../src/errors.js"],
-  "sourcesContent": ["export const Code = Object.freeze({\n    Success: 0,\n    UnknownError: -1,\n    NotLogin: 30000001,\n    Timeout: 30000003,\n    InitialTimeout: 30000004,\n    OverallTimeout: 30000005,\n    InvalidRequest: 30010001,\n    AdbUnavailable: 30010002,\n    ContentUnavailable: 30010003,\n    SourceExtractionFailed: 30010004,\n    AutomationFailed: 30010005,\n    FridaUnavailable: 30010008,\n    AppNotInstalled: 30010009,\n});\n\nexport const Status = Object.freeze({\n    Success: 'SUCCESS',\n    Failed: 'FAILED',\n});\n\nexport const UnicodeIme = Object.freeze({\n    packageName: 'io.appium.settings',\n    component: 'io.appium.settings/.UnicodeIME',\n    inputTextAction: 'ADB_INPUT_TEXT',\n});\n\nconst normalizeShare = (share) => {\n    const source = share && typeof share === 'object' ? share : {};\n    return {\n        mode: 'clipboard',\n        prefix: String(source.prefix || '').trim(),\n        xurl: Array.isArray(source.xurl) ? source.xurl : [],\n    };\n};\n\nconst createActorInfo = (info) => {\n    const key = String(info.key || '').trim();\n    return Object.freeze({\n        key,\n        name: String(info.name || key),\n        icon: String(info.icon || `https://static.heartbitai.com/general/actors/${key}.png`),\n        share: Object.freeze(normalizeShare(info.share)),\n    });\n};\n\nexport const ActorInfo = Object.freeze({\n    'doubao.android': createActorInfo({\n        key: 'doubao.android',\n        name: '\u8C46\u5305 Android',\n        share: {\n            prefix: 'https://www.doubao.com/thread/',\n            xurl: [],\n        },\n    }),\n});\n", "import { Code } from './constants.js';\n\nexport class CrawlerError extends Error {\n    constructor(input = {}, options = {}) {\n        const payload = typeof input === 'string' ? { message: input } : input;\n        super(payload.message || 'Android crawler error', options);\n        this.name = 'CrawlerError';\n        this.code = payload.code || Code.UnknownError;\n        this.context = payload.context || {};\n    }\n\n    static isCrawlerError(error) {\n        return error instanceof CrawlerError || error?.name === 'CrawlerError';\n    }\n\n    static from(error, fallback = {}) {\n        if (CrawlerError.isCrawlerError(error)) return error;\n        return new CrawlerError({\n            message: error?.message || String(error),\n            code: fallback.code || Code.UnknownError,\n            context: fallback.context || {},\n        });\n    }\n}\n\nexport function serializeError(error) {\n    if (!error) return { message: '' };\n    return {\n        name: error.name || 'Error',\n        message: error.message || String(error),\n        stack: error.stack || '',\n        code: error.code || '',\n        context: error.context || undefined,\n    };\n}\n"],
-  "mappings": ";;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,IAAM,OAAO,OAAO,OAAO;AAAA,EAC9B,SAAS;AAAA,EACT,cAAc;AAAA,EACd,UAAU;AAAA,EACV,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,oBAAoB;AAAA,EACpB,wBAAwB;AAAA,EACxB,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAiB;AACrB,CAAC;AAEM,IAAM,SAAS,OAAO,OAAO;AAAA,EAChC,SAAS;AAAA,EACT,QAAQ;AACZ,CAAC;AAEM,IAAM,aAAa,OAAO,OAAO;AAAA,EACpC,aAAa;AAAA,EACb,WAAW;AAAA,EACX,iBAAiB;AACrB,CAAC;AAED,IAAM,iBAAiB,CAAC,UAAU;AAC9B,QAAM,SAAS,SAAS,OAAO,UAAU,WAAW,QAAQ,CAAC;AAC7D,SAAO;AAAA,IACH,MAAM;AAAA,IACN,QAAQ,OAAO,OAAO,UAAU,EAAE,EAAE,KAAK;AAAA,IACzC,MAAM,MAAM,QAAQ,OAAO,IAAI,IAAI,OAAO,OAAO,CAAC;AAAA,EACtD;AACJ;AAEA,IAAM,kBAAkB,CAAC,SAAS;AAC9B,QAAM,MAAM,OAAO,KAAK,OAAO,EAAE,EAAE,KAAK;AACxC,SAAO,OAAO,OAAO;AAAA,IACjB;AAAA,IACA,MAAM,OAAO,KAAK,QAAQ,GAAG;AAAA,IAC7B,MAAM,OAAO,KAAK,QAAQ,gDAAgD,GAAG,MAAM;AAAA,IACnF,OAAO,OAAO,OAAO,eAAe,KAAK,KAAK,CAAC;AAAA,EACnD,CAAC;AACL;AAEO,IAAM,YAAY,OAAO,OAAO;AAAA,EACnC,kBAAkB,gBAAgB;AAAA,IAC9B,KAAK;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,MACH,QAAQ;AAAA,MACR,MAAM,CAAC;AAAA,IACX;AAAA,EACJ,CAAC;AACL,CAAC;;;ACvDD;AAAA;AAAA;AAAA;AAAA;AAEO,IAAM,eAAN,MAAM,sBAAqB,MAAM;AAAA,EACpC,YAAY,QAAQ,CAAC,GAAG,UAAU,CAAC,GAAG;AAClC,UAAM,UAAU,OAAO,UAAU,WAAW,EAAE,SAAS,MAAM,IAAI;AACjE,UAAM,QAAQ,WAAW,yBAAyB,OAAO;AACzD,SAAK,OAAO;AACZ,SAAK,OAAO,QAAQ,QAAQ,KAAK;AACjC,SAAK,UAAU,QAAQ,WAAW,CAAC;AAAA,EACvC;AAAA,EAEA,OAAO,eAAe,OAAO;AACzB,WAAO,iBAAiB,kBAAgB,+BAAO,UAAS;AAAA,EAC5D;AAAA,EAEA,OAAO,KAAK,OAAO,WAAW,CAAC,GAAG;AAC9B,QAAI,cAAa,eAAe,KAAK,EAAG,QAAO;AAC/C,WAAO,IAAI,cAAa;AAAA,MACpB,UAAS,+BAAO,YAAW,OAAO,KAAK;AAAA,MACvC,MAAM,SAAS,QAAQ,KAAK;AAAA,MAC5B,SAAS,SAAS,WAAW,CAAC;AAAA,IAClC,CAAC;AAAA,EACL;AACJ;AAEO,SAAS,eAAe,OAAO;AAClC,MAAI,CAAC,MAAO,QAAO,EAAE,SAAS,GAAG;AACjC,SAAO;AAAA,IACH,MAAM,MAAM,QAAQ;AAAA,IACpB,SAAS,MAAM,WAAW,OAAO,KAAK;AAAA,IACtC,OAAO,MAAM,SAAS;AAAA,IACtB,MAAM,MAAM,QAAQ;AAAA,IACpB,SAAS,MAAM,WAAW;AAAA,EAC9B;AACJ;",
+  "sources": ["../src/constants.js", "../src/errors.js", "../entrys/browser.js"],
+  "sourcesContent": ["export const Code = Object.freeze({\n    Success: 0,\n    UnknownError: -1,\n    NotLogin: 30000001,\n    Timeout: 30000003,\n    InitialTimeout: 30000004,\n    OverallTimeout: 30000005,\n    InvalidRequest: 30010001,\n    AdbUnavailable: 30010002,\n    ContentUnavailable: 30010003,\n    SourceExtractionFailed: 30010004,\n    AutomationFailed: 30010005,\n    DataAccessUnavailable: 30010008,\n    AppNotInstalled: 30010009,\n});\n\nexport const Status = Object.freeze({\n    Success: 'SUCCESS',\n    Failed: 'FAILED',\n});\n\nexport const UnicodeIme = Object.freeze({\n    packageName: 'io.appium.settings',\n    component: 'io.appium.settings/.UnicodeIME',\n    inputAction: 'ADB_INPUT_TEXT',\n});\n\nexport const AppiumSettings = Object.freeze({\n    packageName: 'io.appium.settings',\n    clipboardReceiver: 'io.appium.settings/.receivers.ClipboardReceiver',\n    clipboardGetAction: 'io.appium.settings.clipboard.get',\n});\n\nconst normalizeShare = (share) => {\n    const source = share && typeof share === 'object' ? share : {};\n    return {\n        mode: 'clipboard',\n        prefix: String(source.prefix || '').trim(),\n        xurl: Array.isArray(source.xurl) ? source.xurl : [],\n    };\n};\n\nconst createActorInfo = (info) => {\n    const key = String(info.key || '').trim();\n    return Object.freeze({\n        key,\n        name: String(info.name || key),\n        icon: String(info.icon || `https://static.heartbitai.com/general/actors/${key}.png`),\n        share: Object.freeze(normalizeShare(info.share)),\n    });\n};\n\nexport const ActorInfo = Object.freeze({\n    'doubao.android': createActorInfo({\n        key: 'doubao.android',\n        name: '\u8C46\u5305 Android',\n        share: {\n            prefix: 'https://www.doubao.com/thread/',\n            xurl: [],\n        },\n    }),\n});\n", "import { Code } from './constants.js';\n\nexport class CrawlerError extends Error {\n    constructor(input = {}, options = {}) {\n        const payload = typeof input === 'string' ? { message: input } : input;\n        super(payload.message || 'Android crawler error', options);\n        this.name = 'CrawlerError';\n        this.code = payload.code || Code.UnknownError;\n        this.context = payload.context || {};\n    }\n\n    static isCrawlerError(error) {\n        return error instanceof CrawlerError || error?.name === 'CrawlerError';\n    }\n\n    static from(error, fallback = {}) {\n        if (CrawlerError.isCrawlerError(error)) return error;\n        return new CrawlerError({\n            message: error?.message || String(error),\n            code: fallback.code || Code.UnknownError,\n            context: fallback.context || {},\n        });\n    }\n}\n\nexport function serializeError(error) {\n    if (!error) return { message: '' };\n    return {\n        name: error.name || 'Error',\n        message: error.message || String(error),\n        stack: error.stack || '',\n        code: error.code || '',\n        context: error.context || undefined,\n    };\n}\n", "import * as Constants from '../src/constants.js';\nimport * as Errors from '../src/errors.js';\n\nconst ToolkitMode = Object.freeze({\n    default: 'default',\n});\n\nexport const useAndroidToolKit = () => {\n    return {\n        Constants,\n        Errors,\n    };\n};\n\nuseAndroidToolKit.Mode = ToolkitMode;\n"],
+  "mappings": "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",
   "names": []
 }