@bryce3310687963/android-toolkit 1.0.55 → 1.0.56

package/README.md

@@ -82,6 +82,12 @@ Excluded:
 
 ## Clear App Cache
 
+`Device.writeCacheFile(ctx, { dirName, fileName, text })` writes text directly to
+`/data/data/<package>/cache/<dirName>/<fileName>` with root, sets app ownership,
+and returns the device path. Its ADB command arguments and raw command errors
+are redacted, including retries, so file contents do not enter logs or error
+reports. Callers that stage credentials must remove the temporary files after use.
+
 `Device.clearAppCache(ctx, packageName = ctx.packageName)` requires root ADB access.
 Stop the app before clearing its cache, then launch it again:
 

package/dist/index.cjs

@@ -912,9 +912,16 @@ async function adbExec(ctx, args, options = {}) {
   const startedAt = Date.now();
   try {
     const { stdout } = await execAdbWithRetry(adbPath, args, options);
-    Logger.useTemplate().adbExec({ duration: Logger.duration(startedAt), args: compactArgs(args) });
+    Logger.useTemplate().adbExec({ duration: Logger.duration(startedAt), args: options.sensitive ? "[REDACTED]" : compactArgs(args) });
     return stdout;
   } catch (error) {
+    if (options.sensitive) {
+      throw new CrawlerError({
+        message: "ADB command failed (sensitive content omitted)",
+        code: isAdbUnavailableError(error) ? Code.AdbUnavailable : Code.AutomationFailed,
+        context: { adbPath }
+      });
+    }
     if (isAdbUnavailableError(error)) {
       throw new CrawlerError({
         message: `adb_unavailable: ${error?.message || String(error)}`,
@@ -943,7 +950,8 @@ async function writeCacheFile(ctx, options = {}) {
   ].join(" && ");
   await Device.adbShell(ctx, [`su -c ${shellQuoteForRemote(command)}`], {
     timeoutMs: Number(options.timeoutMs || 1e4),
-    maxBuffer: Number(options.maxBuffer || 1024)
+    maxBuffer: Number(options.maxBuffer || 1024),
+    sensitive: true
   });
   return filePath;
 }
@@ -1267,8 +1275,8 @@ async function execAdbWithRetry(adbPath, args, options = {}) {
         label: options.label || "adb",
         attempt,
         attempts,
-        args: compactArgs(args),
-        message: error?.message || String(error)
+        args: options.sensitive ? "[REDACTED]" : compactArgs(args),
+        message: options.sensitive ? "sensitive ADB command failed" : error?.message || String(error)
       });
       await sleep(delayMs * attempt);
     }