Skip to content

armgit / rea

Public Imported from GitHub
0

Reverse engineer anything with agents, from app behavior down to native binaries.

2.7 KB
Raw Blame
import { ok, err, type Result } from "../domain/result.js";
import type {
  ArtifactEntry,
  ArtifactTraversalOmission,
} from "../artifacts/ArtifactReader.js";
import { DirectoryArtifactTraversalLimit } from "../artifacts/DirectoryArtifactReader.js";
import { assertArtifactReadActive } from "../artifacts/ArtifactFileOperation.js";
import { classifyAndroidStringsTable } from "../domain/apktool/apktoolResourceAnalysis.js";
import type { ApktoolWorkspace } from "./ApktoolWorkspace.js";

type TableEntryKind = ArtifactEntry["kind"] | ArtifactTraversalOmission["kind"];
interface StringsTableOmission {
  readonly path: string;
  readonly kind: Exclude<TableEntryKind, "file">;
}

interface DecodedInventory {
  count: number;
  capped: boolean;
  locales: readonly string[];
  otherStringsTables: readonly string[];
  unreadableStringsTables: readonly StringsTableOmission[];
}

/** Count files over bounded examined coverage, including omitted special entries. */
export const countDecodedFiles = async (
  workspace: ApktoolWorkspace,
  root: string,
  signal: AbortSignal | undefined,
  maximumEntries: number,
): Promise<
  Result<
    DecodedInventory,
    { readonly cause: unknown; readonly partial: DecodedInventory }
  >
> => {
  let count = 0;
  let capped = false;
  const locales: string[] = [];
  const otherStringsTables: string[] = [];
  const unreadableStringsTables: StringsTableOmission[] = [];
  const observeTable = (path: string, kind: TableEntryKind): void => {
    const match = /^res\/(values(?:-([^/]*))?)\/strings\.xml$/u.exec(path);
    if (match === null) return;
    if (kind !== "file") {
      unreadableStringsTables.push({ path, kind });
      return;
    }
    const suffix = match[2];
    if (suffix === undefined) return;
    const table = classifyAndroidStringsTable(suffix);
    if (table.kind === "locale") locales.push(table.locale);
    else otherStringsTables.push(match[1]!);
  };
  const observation = (): DecodedInventory => {
    return {
      count,
      capped,
      locales: locales.sort(),
      otherStringsTables: otherStringsTables.sort(),
      unreadableStringsTables: unreadableStringsTables.sort((a, b) =>
        a.path < b.path ? -1 : a.path > b.path ? 1 : 0,
      ),
    };
  };
  try {
    for await (const entry of workspace.entries(
      root,
      signal,
      maximumEntries,
      (omission) => observeTable(omission.path, omission.kind),
    )) {
      assertArtifactReadActive(signal);
      observeTable(entry.path, entry.kind);
      if (entry.kind === "file") count += 1;
    }
  } catch (cause) {
    if (!(cause instanceof DirectoryArtifactTraversalLimit))
      return err({ cause, partial: observation() });
    capped = true;
  }
  return ok(observation());
};