Files
rea/src/adb/AdbDirectoryListing.ts
T
morluto 3bdc8730bd fix(adb): preserve directory identities and share byte capture
Use Android 8-compatible batched find/stat with NUL-framed names and raw symlink targets. Preserve malformed or invalid UTF-8 records as partial evidence with exact source bytes. List hidden direct children without synthetic navigation entries.

Share process byte capture with UTF-8 callers and screenshots, removing duplicate timeout and cancellation supervision. Verified 35 focused process, ADB, CLI and MCP tests; compatibility checked against AOSP Oreo sources. Live Android device/emulator verification was not run.
2026-10-12 13:06:51 +08:00

109 lines
3.2 KiB
TypeScript

import { isUtf8 } from "node:buffer";
interface AdbDirectoryEntry {
readonly name: string;
readonly kind: "directory" | "file" | "symlink" | "other";
readonly permissions: string | null;
readonly owner: string | null;
readonly group: string | null;
readonly bytes: number | null;
readonly date: string | null;
readonly link_target: string | null;
}
/**
* List direct children with Android 8 Toybox's batched `find -exec` and
* `stat -c` support. Names and link targets are NUL-framed; neither is ever
* inserted into a line-oriented metadata record or command substitution.
*/
export const ADB_DIRECTORY_BATCH_SCRIPT = String.raw`metadata=$(stat -c '%A|%U|%G|%s|%y' "$@") || exit
printf '%s\n' "$metadata" | {
while IFS= read -r metadata; do
[ "$#" -gt 0 ] || exit 1
path=$1
shift
printf '%s\000%s\000' "$metadata" "${"${path##*/}"}"
case "$metadata" in
l*) readlink -n "$path" || exit 1 ;;
esac
printf '\000'
done
[ "$#" -eq 0 ]
}`;
const METADATA =
/^([bcdlps-][rwxstST-]{9})\|([^|\n]+)\|([^|\n]+)\|(\d+)\|([^|\n]+)$/u;
const parseEntry = (
metadata: string,
name: string,
linkTarget: string,
): AdbDirectoryEntry | null => {
const match = METADATA.exec(metadata);
if (match === null || name === "" || name.includes("/")) return null;
const permissions = match[1]!;
const bytes = Number(match[4]!);
if (!Number.isSafeInteger(bytes)) return null;
const isSymlink = permissions.startsWith("l");
if (isSymlink ? linkTarget === "" : linkTarget !== "") return null;
return {
name,
kind: permissions.startsWith("d")
? "directory"
: isSymlink
? "symlink"
: permissions.startsWith("-")
? "file"
: "other",
permissions,
owner: match[2]!,
group: match[3]!,
bytes,
date: match[5]!,
link_target: isSymlink ? linkTarget : null,
};
};
/** Parse metadata/name/target NUL triples from `ADB_DIRECTORY_BATCH_SCRIPT`. */
export const parseAdbDirectoryListing = (
stdout: Buffer,
): {
entries: readonly AdbDirectoryEntry[];
unparsedLines: readonly string[];
} => {
const entries: AdbDirectoryEntry[] = [];
const unparsedLines: string[] = [];
let offset = 0;
while (offset < stdout.length) {
const metadataEnd = stdout.indexOf(0, offset);
const nameEnd = metadataEnd < 0 ? -1 : stdout.indexOf(0, metadataEnd + 1);
const targetEnd = nameEnd < 0 ? -1 : stdout.indexOf(0, nameEnd + 1);
if (targetEnd < 0) {
unparsedLines.push(describeUnparsedRecord(stdout.subarray(offset)));
break;
}
const rawRecord = stdout.subarray(offset, targetEnd + 1);
if (!isUtf8(rawRecord)) {
unparsedLines.push(describeUnparsedRecord(rawRecord));
} else {
const entry = parseEntry(
stdout.toString("utf8", offset, metadataEnd),
stdout.toString("utf8", metadataEnd + 1, nameEnd),
stdout.toString("utf8", nameEnd + 1, targetEnd),
);
if (entry === null) unparsedLines.push(rawRecord.toString("utf8"));
else entries.push(entry);
}
offset = targetEnd + 1;
}
return { entries, unparsedLines };
};
const describeUnparsedRecord = (record: Buffer): string =>
isUtf8(record)
? record.toString("utf8")
: `Invalid UTF-8 directory record (hex): ${record.toString("hex")}`;