Merge branch 'main' into accessibility-audit-service

Author: navin772

CHANGELOG.md

@@ -1,3 +1,9 @@
+## [5.14.4](https://github.com/appium/appium-ios-remotexpc/compare/v5.14.3...v5.14.4) (2026-08-12)
+
+### Bug Fixes
+
+* **afc:** make walk tolerant to untraversable directories ([#292](https://github.com/appium/appium-ios-remotexpc/issues/292)) ([ac6959b](https://github.com/appium/appium-ios-remotexpc/commit/ac6959bd413ce4b7685895d3c024c0861be17b7f))
+
 ## [5.14.3](https://github.com/appium/appium-ios-remotexpc/compare/v5.14.2...v5.14.3) (2026-08-11)
 
 ### Bug Fixes

package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-ios-remotexpc",
-  "version": "5.14.3",
+  "version": "5.14.4",
   "description": "",
   "keywords": [],
   "bugs": {

src/services/ios/afc/index.ts

@@ -479,14 +479,33 @@ export class AfcService {
     log.debug(`Successfully pushed file to '${remoteDst}'`);
   }
 
+  /**
+   * Recursively list `root` and everything below it. Untraversable directories are skipped
+   * rather than aborting the walk: the media sandbox exposes directories it refuses to read
+   * (e.g. `/PhotoData/UBF` answers GET_FILE_INFO but fails READ_DIR with PERM_DENIED).
+   */
   async walk(root: string): Promise<Array<{dir: string; dirs: string[]; files: string[]}>> {
     const out: Array<{dir: string; dirs: string[]; files: string[]}> = [];
-    const entries = await this.listdir(root);
+    let entries: string[];
+    try {
+      entries = await this.listdir(root);
+    } catch (error) {
+      log.debug(`Skipping '${root}' during walk, cannot list it:`, error);
+      return out;
+    }
     const dirs: string[] = [];
     const files: string[] = [];
     for (const e of entries) {
       const p = path.posix.join(root, e);
-      if (await this.isdir(p)) {
+      let isDir: boolean;
+      try {
+        isDir = await this.isdir(p);
+      } catch (error) {
+        // Unstattable entry: report it, but do not try to descend into it.
+        log.debug(`Cannot stat '${p}' during walk, treating it as a file:`, error);
+        isDir = false;
+      }
+      if (isDir) {
         dirs.push(e);
       } else {
         files.push(e);