@absolutejs/absolute 0.20.0-beta.22 → 0.20.0-beta.23

package/dist/cli/index.js

@@ -6763,7 +6763,7 @@ var init_syncSchema = __esm(() => {
 import { readFileSync as readFileSync12 } from "fs";
 import { extname as extname5, join as join20, relative as relative11, resolve as resolve16 } from "path";
 import ts4 from "typescript";
-var DEVICES_PACKAGE = "@absolutejs/devices", CAPACITOR_ADAPTER = "@absolutejs/devices-capacitor", SOURCE_GLOB, IGNORED_DIRECTORIES, IDENTIFIER_PATTERN, CAPACITOR_MODULE_PATTERN, CAPACITOR_PACKAGE_PATTERN, ANDROID_PERMISSION_PATTERN, IOS_USAGE_DESCRIPTIONS, object2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value), readJson = (path) => {
+var DEVICES_PACKAGE = "@absolutejs/devices", CAPACITOR_ADAPTER = "@absolutejs/devices-capacitor", SOURCE_GLOB, IGNORED_DIRECTORIES, IDENTIFIER_PATTERN, CAPACITOR_MODULE_PATTERN, CAPACITOR_PACKAGE_PATTERN, ANDROID_PERMISSION_PATTERN, IOS_USAGE_DESCRIPTIONS, IOS_PRIVACY_ACCESSED_API_REASONS, IOS_PRIVACY_ACCESSED_APIS, object2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value), readJson = (path) => {
   const value = JSON.parse(readFileSync12(path, "utf8"));
   if (!object2(value))
     throw new TypeError(`${path} must contain an object.`);
@@ -6781,15 +6781,37 @@ var DEVICES_PACKAGE = "@absolutejs/devices", CAPACITOR_ADAPTER = "@absolutejs/de
   if (!Array.isArray(permissions) || !permissions.every((permission) => typeof permission === "string" && ANDROID_PERMISSION_PATTERN.test(permission)))
     throw new TypeError(`${field}.permissions must contain Android permission names.`);
   return [...permissions];
-}, iosUsageDescriptions = (value, field) => {
+}, iosPrivacyAccessedApis = (value, field) => {
   if (value === undefined)
     return;
   if (!object2(value))
     throw new TypeError(`${field} must be an object.`);
-  const { usageDescriptions } = value;
-  if (!Array.isArray(usageDescriptions) || !usageDescriptions.every((purpose) => typeof purpose === "string" && IOS_USAGE_DESCRIPTIONS.has(purpose)))
+  const privacy = {};
+  for (const api of IOS_PRIVACY_ACCESSED_APIS) {
+    const reasons = value[api];
+    if (reasons === undefined)
+      continue;
+    const supported = IOS_PRIVACY_ACCESSED_API_REASONS[api];
+    if (!Array.isArray(reasons) || reasons.length === 0 || !reasons.every((reason) => typeof reason === "string" && supported.has(reason)))
+      throw new TypeError(`${field} contains an unsupported API or reason.`);
+    privacy[api] = [...reasons];
+  }
+  if (Object.keys(value).some((api) => !IOS_PRIVACY_ACCESSED_APIS.some((known) => known === api)))
+    throw new TypeError(`${field} contains an unsupported API or reason.`);
+  return privacy;
+}, iosNativeRequirements = (value, field) => {
+  if (value === undefined)
+    return;
+  if (!object2(value))
+    throw new TypeError(`${field} must be an object.`);
+  const { privacyAccessedApis, usageDescriptions } = value;
+  if (usageDescriptions !== undefined && (!Array.isArray(usageDescriptions) || !usageDescriptions.every((purpose) => typeof purpose === "string" && IOS_USAGE_DESCRIPTIONS.has(purpose))))
     throw new TypeError(`${field}.usageDescriptions contains an unsupported purpose.`);
-  return [...usageDescriptions];
+  const privacy = iosPrivacyAccessedApis(privacyAccessedApis, `${field}.privacyAccessedApis`);
+  return {
+    ...privacy === undefined ? {} : { privacyAccessedApis: privacy },
+    ...usageDescriptions === undefined ? {} : { usageDescriptions: [...usageDescriptions] }
+  };
 }, parseProvider = (name, value) => {
   if (!IDENTIFIER_PATTERN.test(name))
     throw new TypeError("Device capability names must be identifiers.");
@@ -6810,10 +6832,10 @@ var DEVICES_PACKAGE = "@absolutejs/devices", CAPACITOR_ADAPTER = "@absolutejs/de
       throw new TypeError(`${name}.native must be an object.`);
     const { android, ios } = nativeMetadata;
     const permissions = androidPermissions(android, `${name}.native.android`);
-    const usageDescriptions = iosUsageDescriptions(ios, `${name}.native.ios`);
+    const iosRequirements = iosNativeRequirements(ios, `${name}.native.ios`);
     native = {
       ...permissions === undefined ? {} : { android: { permissions } },
-      ...usageDescriptions === undefined ? {} : { ios: { usageDescriptions } }
+      ...iosRequirements === undefined ? {} : { ios: iosRequirements }
     };
   }
   return {
@@ -6822,14 +6844,32 @@ var DEVICES_PACKAGE = "@absolutejs/devices", CAPACITOR_ADAPTER = "@absolutejs/de
     ...native === undefined ? {} : { native },
     packages: [...value.packages]
   };
-}, absoluteDeviceNativeRequirements = (plan) => ({
-  androidPermissions: [
-    ...new Set(plan.capabilities.flatMap((name) => plan.providers[name]?.native?.android?.permissions ?? []))
-  ].sort(),
-  iosUsageDescriptions: [
-    ...new Set(plan.capabilities.flatMap((name) => plan.providers[name]?.native?.ios?.usageDescriptions ?? []))
-  ].sort()
-}), loadAbsoluteDeviceCapabilityProviders = (projectRoot) => {
+}, absoluteDeviceNativeRequirements = (plan) => {
+  const privacy = plan.capabilities.reduce((requirements, name) => {
+    for (const api of IOS_PRIVACY_ACCESSED_APIS) {
+      const reasons = plan.providers[name]?.native?.ios?.privacyAccessedApis?.[api] ?? [];
+      if (reasons.length === 0)
+        continue;
+      const current = requirements[api] ?? new Set;
+      for (const reason of reasons)
+        current.add(reason);
+      requirements[api] = current;
+    }
+    return requirements;
+  }, {});
+  return {
+    androidPermissions: [
+      ...new Set(plan.capabilities.flatMap((name) => plan.providers[name]?.native?.android?.permissions ?? []))
+    ].sort(),
+    iosPrivacyAccessedApis: IOS_PRIVACY_ACCESSED_APIS.flatMap((api) => {
+      const reasons = privacy[api];
+      return reasons ? [{ api, reasons: [...reasons].sort() }] : [];
+    }),
+    iosUsageDescriptions: [
+      ...new Set(plan.capabilities.flatMap((name) => plan.providers[name]?.native?.ios?.usageDescriptions ?? []))
+    ].sort()
+  };
+}, loadAbsoluteDeviceCapabilityProviders = (projectRoot) => {
   const path = join20(resolve16(projectRoot), "node_modules", CAPACITOR_ADAPTER, "package.json");
   const manifest = readJson(path);
   const { absolutejs } = manifest;
@@ -6953,6 +6993,12 @@ var init_deviceCapabilities = __esm(() => {
     "photo-library",
     "photo-library-add"
   ]);
+  IOS_PRIVACY_ACCESSED_API_REASONS = {
+    NSPrivacyAccessedAPICategoryFileTimestamp: new Set(["C617.1"])
+  };
+  IOS_PRIVACY_ACCESSED_APIS = [
+    "NSPrivacyAccessedAPICategoryFileTimestamp"
+  ];
 });
 
 // src/mobile/buildPipeline.ts
@@ -16469,7 +16515,7 @@ var init_nativeDeepLinks = () => {};
 // src/mobile/nativeDeviceCapabilities.ts
 import { readFile as readFile12, rename as rename9, writeFile as writeFile10 } from "fs/promises";
 import { join as join47 } from "path";
-var START_MARKER2 = "<!-- absolutejs:device-capabilities:start -->", END_MARKER2 = "<!-- absolutejs:device-capabilities:end -->", NOT_FOUND2 = -1, escapeXml2 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;"), writeChangedFile2 = async (path, source) => {
+var START_MARKER2 = "<!-- absolutejs:device-capabilities:start -->", END_MARKER2 = "<!-- absolutejs:device-capabilities:end -->", NOT_FOUND2 = -1, IOS_PRIVACY_FILE_REFERENCE = "A85D0C000000000000000001", IOS_PRIVACY_BUILD_FILE = "A85D0C000000000000000002", escapeXml2 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;"), writeChangedFile2 = async (path, source) => {
   const current = await readFile12(path, "utf8");
   if (current === source)
     return false;
@@ -16477,6 +16523,14 @@ var START_MARKER2 = "<!-- absolutejs:device-capabilities:start -->", END_MARKER2
   await writeFile10(temporary, source, { flag: "wx" });
   await rename9(temporary, path);
   return true;
+}, optionalSource = async (path) => {
+  try {
+    return await readFile12(path, "utf8");
+  } catch (error) {
+    if (typeof error === "object" && error !== null && Reflect.get(error, "code") === "ENOENT")
+      return null;
+    throw error;
+  }
 }, managed = (source, region, insertion) => {
   const start2 = source.indexOf(START_MARKER2);
   const end = source.indexOf(END_MARKER2);
@@ -16505,6 +16559,129 @@ var START_MARKER2 = "<!-- absolutejs:device-capabilities:start -->", END_MARKER2
   if (purpose === "location-always")
     return `${appName} does not track location in the background; this description supports the foreground location provider required by the native runtime.`;
   return `${appName} adds to your photo library only for photo actions you choose.`;
+}, privacyEntries = (requirements) => requirements.iosPrivacyAccessedApis.map(({ api, reasons }) => `		<dict>
+			<key>NSPrivacyAccessedAPIType</key>
+			<string>${escapeXml2(api)}</string>
+			<key>NSPrivacyAccessedAPITypeReasons</key>
+			<array>
+${reasons.map((reason) => `				<string>${escapeXml2(reason)}</string>`).join(`
+`)}
+			</array>
+		</dict>`).join(`
+`), privacyManifestSource = (source, requirements) => {
+  const entries = privacyEntries(requirements);
+  const wholeRegion = entries ? `	${START_MARKER2}
+	<key>NSPrivacyAccessedAPITypes</key>
+	<array>
+${entries}
+	</array>
+	${END_MARKER2}
+` : "";
+  if (source === null)
+    return entries ? `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+${wholeRegion}	<key>NSPrivacyCollectedDataTypes</key>
+	<array/>
+	<key>NSPrivacyTracking</key>
+	<false/>
+</dict>
+</plist>
+` : null;
+  const start2 = source.indexOf(START_MARKER2);
+  if (start2 !== NOT_FOUND2) {
+    const end = source.indexOf(END_MARKER2);
+    if (end === NOT_FOUND2)
+      throw new TypeError("AbsoluteJS device-capability ownership markers are malformed.");
+    const owned = source.slice(start2, end);
+    const ownsWholeKey = owned.includes("NSPrivacyAccessedAPITypes");
+    let region = "";
+    if (ownsWholeKey)
+      region = wholeRegion;
+    else if (entries)
+      region = `		${START_MARKER2}
+${entries}
+		${END_MARKER2}
+`;
+    return managed(source, region, source.lastIndexOf("</dict>"));
+  }
+  const key = source.indexOf("<key>NSPrivacyAccessedAPITypes</key>");
+  if (key === NOT_FOUND2)
+    return managed(source, wholeRegion, source.lastIndexOf("</dict>"));
+  if (!entries)
+    return source;
+  const array = source.indexOf("<array>", key);
+  if (array === NOT_FOUND2)
+    throw new TypeError("iOS PrivacyInfo.xcprivacy has a malformed NSPrivacyAccessedAPITypes value.");
+  const insertion = source.indexOf(`
+`, array);
+  if (insertion === NOT_FOUND2)
+    throw new TypeError("iOS PrivacyInfo.xcprivacy array is malformed.");
+  return managed(source, `		${START_MARKER2}
+${entries}
+		${END_MARKER2}
+`, insertion + 1);
+}, writeIosPrivacyManifest = async (path, current, source) => {
+  if (source === null)
+    return false;
+  if (current !== null)
+    return writeChangedFile2(path, source);
+  await writeFile10(path, source, { flag: "wx" });
+  return true;
+}, configureIosPrivacyProject = async (config, requirements) => {
+  if (requirements.iosPrivacyAccessedApis.length === 0)
+    return false;
+  const projectPath = join47(config.nativeProjectDirectory, "ios/App/App.xcodeproj/project.pbxproj");
+  const project = await readFile12(projectPath, "utf8");
+  return writeChangedFile2(projectPath, addIosPrivacyProjectReference(project));
+}, addIosPrivacyProjectReference = (source) => {
+  const fileMatch = source.match(/([A-F0-9]{24}) \/\* PrivacyInfo\.xcprivacy \*\/ = \{isa = PBXFileReference;/u);
+  const fileReference = fileMatch?.[1] ?? IOS_PRIVACY_FILE_REFERENCE;
+  const buildMatch = source.match(/([A-F0-9]{24}) \/\* PrivacyInfo\.xcprivacy in Resources \*\/ = \{isa = PBXBuildFile;/u);
+  const buildFile = buildMatch?.[1] ?? IOS_PRIVACY_BUILD_FILE;
+  if (!fileMatch && source.includes(fileReference) || !buildMatch && source.includes(buildFile))
+    throw new TypeError("AbsoluteJS iOS privacy-manifest identifiers collide.");
+  let next = source;
+  if (!buildMatch) {
+    const marker = "/* End PBXBuildFile section */";
+    const index = next.indexOf(marker);
+    if (index === NOT_FOUND2)
+      throw new TypeError("Could not find the iOS PBXBuildFile section.");
+    next = `${next.slice(0, index)}		${buildFile} /* PrivacyInfo.xcprivacy in Resources */ = {isa = PBXBuildFile; fileRef = ${fileReference} /* PrivacyInfo.xcprivacy */; };
+${next.slice(index)}`;
+  }
+  if (!fileMatch) {
+    const marker = "/* End PBXFileReference section */";
+    const index = next.indexOf(marker);
+    if (index === NOT_FOUND2)
+      throw new TypeError("Could not find the iOS PBXFileReference section.");
+    next = `${next.slice(0, index)}		${fileReference} /* PrivacyInfo.xcprivacy */ = {isa = PBXFileReference; lastKnownFileType = text.xml; path = PrivacyInfo.xcprivacy; sourceTree = "<group>"; };
+${next.slice(index)}`;
+  }
+  const groupsStart = next.indexOf("/* Begin PBXGroup section */");
+  const groupsEnd = next.indexOf("/* End PBXGroup section */");
+  const groups = next.slice(groupsStart, groupsEnd);
+  if (!groups.includes(`${fileReference} /* PrivacyInfo.xcprivacy */`)) {
+    const appGroup = groups.match(/[A-F0-9]{24} \/\* App \*\/ = \{\n\t\t\tisa = PBXGroup;\n\t\t\tchildren = \(\n/u);
+    if (!appGroup || appGroup.index === undefined)
+      throw new TypeError("Could not find the iOS App PBXGroup.");
+    const index = groupsStart + appGroup.index + appGroup[0].length;
+    next = `${next.slice(0, index)}				${fileReference} /* PrivacyInfo.xcprivacy */,
+${next.slice(index)}`;
+  }
+  const resourcesStart = next.indexOf("/* Begin PBXResourcesBuildPhase section */");
+  const resourcesEnd = next.indexOf("/* End PBXResourcesBuildPhase section */");
+  const resources = next.slice(resourcesStart, resourcesEnd);
+  if (!resources.includes(`${buildFile} /* PrivacyInfo.xcprivacy in Resources */`)) {
+    const files = resources.match(/isa = PBXResourcesBuildPhase;\n\t\t\tbuildActionMask = \d+;\n\t\t\tfiles = \(\n/u);
+    if (!files || files.index === undefined)
+      throw new TypeError("Could not find the iOS Resources build phase.");
+    const index = resourcesStart + files.index + files[0].length;
+    next = `${next.slice(0, index)}				${buildFile} /* PrivacyInfo.xcprivacy in Resources */,
+${next.slice(index)}`;
+  }
+  return next;
 }, configureIos2 = async (config, plan) => {
   const path = join47(config.nativeProjectDirectory, "ios/App/App/Info.plist");
   const source = await readFile12(path, "utf8");
@@ -16516,7 +16693,15 @@ var START_MARKER2 = "<!-- absolutejs:device-capabilities:start -->", END_MARKER2
 ${content}
 	${END_MARKER2}
 ` : "";
-  return writeChangedFile2(path, managed(source, region, source.lastIndexOf("</dict>")));
+  const infoChanged = await writeChangedFile2(path, managed(source, region, source.lastIndexOf("</dict>")));
+  const privacyPath = join47(config.nativeProjectDirectory, "ios/App/App/PrivacyInfo.xcprivacy");
+  const privacyCurrent = await optionalSource(privacyPath);
+  const privacySource = privacyManifestSource(privacyCurrent, requirements);
+  const [privacyChanged, projectChanged] = await Promise.all([
+    writeIosPrivacyManifest(privacyPath, privacyCurrent, privacySource),
+    configureIosPrivacyProject(config, requirements)
+  ]);
+  return infoChanged || privacyChanged || projectChanged;
 }, configureAndroid2 = async (config, plan) => {
   const path = join47(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
   const source = await readFile12(path, "utf8");
@@ -17706,24 +17891,25 @@ var init_iosConformance = __esm(() => {
   HMR_LINE = new RegExp(String.raw`\[hmr:ios\]\s+([^\n]*?)\s+(applied in|falling back to reload after|failed after)\s+(\d+)ms(?:; server\s+(\d+)ms, client\s+(\d+)ms)?`, "u");
 });
 
-// src/mobile/iosTestReport.ts
+// src/mobile/nativeTestReport.ts
 import { mkdir as mkdir13, readFile as readFile18, writeFile as writeFile15 } from "fs/promises";
 import { join as join51 } from "path";
-var MANUAL_CHECKS, secretPattern, bearerPattern, coordinatePattern, sanitizeIosReportText = (value) => value.replace(bearerPattern, "Bearer [REDACTED]").replace(secretPattern, "$1$2[REDACTED]").replace(coordinatePattern, "$1$2[REDACTED]").replace(/(https?:\/\/[^\s?#]+)[?#][^\s]*/giu, "$1?[REDACTED]"), markdownCell = (value) => sanitizeIosReportText(value).replaceAll("|", "\\|").replaceAll(`
-`, "<br>"), createAbsoluteIosPartnerReport = (options) => {
-  const { run } = options;
-  const evidence = run.screenshot ? `Simulator screenshot: ${run.screenshot}` : undefined;
+var secretPattern, bearerPattern, coordinatePattern, sanitizeNativeReportText = (value) => value.replace(bearerPattern, "Bearer [REDACTED]").replace(secretPattern, "$1$2[REDACTED]").replace(coordinatePattern, "$1$2[REDACTED]").replace(/(https?:\/\/[^\s?#]+)[?#][^\s]*/giu, "$1?[REDACTED]"), markdownCell = (value) => sanitizeNativeReportText(value).replaceAll("|", "\\|").replaceAll(`
+`, "<br>"), createAbsoluteNativeAutomatedChecks = (run) => {
+  const target = `${run.targetKind} ${run.targetId}`;
+  const evidence = run.screenshot ? `Screenshot: ${run.screenshot}` : undefined;
   let hmrResult = "NOT_RUN";
   if (run.hmr)
     hmrResult = run.hmr.outcome === "failed" ? "FAIL" : "PASS";
-  const automatedChecks = [
+  const routeDetails = run.routes?.length ? ` Routes: ${run.routes.join(", ")}.` : "";
+  return [
     {
-      details: `Captured macOS, Xcode, Bun, and AbsoluteJS versions for simulator ${run.udid}.`,
+      details: `Captured host, toolchain, Bun, and AbsoluteJS metadata for ${target}.`,
       id: "AUTO-SETUP-01",
       result: "PASS"
     },
     {
-      details: run.status === "pass" ? `The app was installed, launched, and connected to native HMR in ${run.durationMs}ms.` : `The automated simulator run failed after ${run.durationMs}ms: ${run.error ?? "No error detail was available."}`,
+      details: run.status === "pass" ? `The app launched and connected to native HMR in ${run.durationMs}ms.${routeDetails}` : `The automated native run failed after ${run.durationMs}ms: ${run.error ?? "No error detail was available."}`,
       ...evidence ? { evidence } : {},
       id: "AUTO-DEV-01",
       result: run.status === "pass" ? "PASS" : "FAIL"
@@ -17734,55 +17920,46 @@ var MANUAL_CHECKS, secretPattern, bearerPattern, coordinatePattern, sanitizeIosR
       result: hmrResult
     },
     {
-      details: run.screenshot ? "A simulator screenshot was captured. Visually review it before sharing this directory." : "No simulator screenshot was captured.",
+      details: run.screenshot ? "A target screenshot was captured. Visually review it before sharing this directory." : "No target screenshot was captured.",
       ...evidence ? { evidence } : {},
       id: "AUTO-ARTIFACT-01",
       result: run.screenshot ? "PASS" : "FAIL"
     }
   ];
-  const manualChecks = MANUAL_CHECKS.map(([id, details]) => ({
+}, createAbsoluteNativeTestReport = (options) => ({
+  automatedChecks: options.automatedChecks ?? createAbsoluteNativeAutomatedChecks(options.run),
+  generatedAt: options.generatedAt ?? new Date().toISOString(),
+  manualChecks: options.manualChecks.map(([id, details]) => ({
     details,
     id,
     result: "NOT_RUN"
-  }));
-  return {
-    automatedChecks,
-    generatedAt: options.generatedAt ?? new Date().toISOString(),
-    manualChecks,
-    metadata: {
-      absolutejsVersion: options.absolutejsVersion,
-      bunVersion: options.bunVersion,
-      macosVersion: options.macosVersion,
-      provider: "capacitor",
-      xcodeVersion: options.xcodeVersion
-    },
-    overallResult: run.status === "fail" ? "FAIL" : "INCOMPLETE",
-    platform: "ios",
-    reportVersion: 1,
-    run
-  };
-}, readPackageVersionForIosReport = async (packageJsonPath) => {
+  })),
+  metadata: options.metadata,
+  overallResult: options.run.status === "fail" ? "FAIL" : "INCOMPLETE",
+  platform: options.run.platform,
+  reportVersion: 1,
+  run: options.run
+}), readPackageVersionForNativeReport = async (packageJsonPath) => {
   const manifest = JSON.parse(await readFile18(packageJsonPath, "utf8"));
   if (typeof manifest !== "object" || manifest === null)
     return "unknown";
   const version2 = Reflect.get(manifest, "version");
   return typeof version2 === "string" ? version2 : "unknown";
-}, renderAbsoluteIosPartnerReport = (report) => {
+}, renderAbsoluteNativeTestReport = (report) => {
   const table = (checks) => checks.map((check2) => `| ${check2.id} | ${check2.result} | ${markdownCell(check2.details)} | ${markdownCell(check2.evidence ?? "")} |`).join(`
 `);
-  return `# AbsoluteJS iOS test report
+  const metadata = Object.entries(report.metadata).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `- ${key}: ${markdownCell(value)}`).join(`
+`);
+  return `# AbsoluteJS ${report.platform} test report
 
 - Overall result: ${report.overallResult}
 - Generated: ${report.generatedAt}
-- AbsoluteJS: ${markdownCell(report.metadata.absolutejsVersion)}
-- macOS: ${markdownCell(report.metadata.macosVersion)}
-- Xcode: ${markdownCell(report.metadata.xcodeVersion)}
-- Bun: ${markdownCell(report.metadata.bunVersion)}
 - App bundle ID: ${markdownCell(report.run.appId)}
-- Simulator UDID: ${markdownCell(report.run.udid)}
+- Target: ${report.run.targetKind} ${markdownCell(report.run.targetId)}
 - Automated run: ${report.run.status.toUpperCase()} (${report.run.durationMs}ms)
+${metadata}
 
-` + `This report is local and is never uploaded by AbsoluteJS. Before sharing its directory, visually inspect screenshots and logs. Never add passwords, signing material, tokens, cookies, private Sync data, or exact coordinates.
+This report is local and is never uploaded by AbsoluteJS. Before sharing its directory, visually inspect screenshots and logs. Never add passwords, signing material, tokens, cookies, private Sync data, or exact coordinates.
 
 ## Automated checks
 
@@ -17790,26 +17967,54 @@ var MANUAL_CHECKS, secretPattern, bearerPattern, coordinatePattern, sanitizeIosR
 | --- | --- | --- | --- |
 ${table(report.automatedChecks)}
 
-## Partner checklist
+## Manual checklist
 
-Replace each \`NOT_RUN\` with \`PASS\`, \`FAIL\`, or \`SKIPPED\` after following \`docs/IOS_MACOS_TESTING.md\`. A failure must name sanitized evidence and state actual versus expected behavior.
+Replace each \`NOT_RUN\` with \`PASS\`, \`FAIL\`, or \`SKIPPED\` after completing the platform runbook. A failure must name sanitized evidence and state actual versus expected behavior.
 
 | Test ID | Result | Observed result / timing | Evidence or failure details |
 | --- | --- | --- | --- |
 ${table(report.manualChecks)}
 `;
-}, writeAbsoluteIosPartnerReport = async (directory, report) => {
+}, writeAbsoluteNativeTestReport = async (directory, report) => {
   await mkdir13(directory, { recursive: true });
   const jsonPath = join51(directory, "report.json");
   const markdownPath = join51(directory, "report.md");
   await Promise.all([
     writeFile15(jsonPath, `${JSON.stringify(report, null, 2)}
 `),
-    writeFile15(markdownPath, renderAbsoluteIosPartnerReport(report))
+    writeFile15(markdownPath, renderAbsoluteNativeTestReport(report))
   ]);
   return { directory, jsonPath, markdownPath };
 };
+var init_nativeTestReport = __esm(() => {
+  secretPattern = /(authorization|access[_ -]?token|refresh[_ -]?token|socket[_ -]?ticket|password|cookie)(\s*[=:]\s*)([^\s,;]+)/giu;
+  bearerPattern = /bearer\s+[^\s,;]+/giu;
+  coordinatePattern = /\b(latitude|longitude|lat|lng)(\s*[=:]\s*)-?\d+(?:\.\d+)?/giu;
+});
+
+// src/mobile/iosTestReport.ts
+var MANUAL_CHECKS, readPackageVersionForIosReport, sanitizeIosReportText, writeAbsoluteIosPartnerReport, createAbsoluteIosPartnerReport = (options) => {
+  const { udid, ...run } = options.run;
+  return createAbsoluteNativeTestReport({
+    ...options.generatedAt ? { generatedAt: options.generatedAt } : {},
+    manualChecks: MANUAL_CHECKS,
+    metadata: {
+      absolutejsVersion: options.absolutejsVersion,
+      bunVersion: options.bunVersion,
+      macosVersion: options.macosVersion,
+      provider: "capacitor",
+      xcodeVersion: options.xcodeVersion
+    },
+    run: {
+      ...run,
+      platform: "ios",
+      targetId: udid,
+      targetKind: "simulator"
+    }
+  });
+};
 var init_iosTestReport = __esm(() => {
+  init_nativeTestReport();
   MANUAL_CHECKS = [
     [
       "SETUP-01",
@@ -17822,6 +18027,10 @@ var init_iosTestReport = __esm(() => {
     ["DEV-01", "Record cold and warm bun dev startup timings."],
     ["DEV-02", "Complete route traversal, HMR, relaunch, and recovery checks."],
     ["CAP-01", "Complete automatic device-capability provisioning checks."],
+    ...Array.from({ length: 8 }, (_, index) => [
+      `FILES-${String(index + 1).padStart(2, "0")}`,
+      `Complete provider-neutral Documents runbook check FILES-${String(index + 1).padStart(2, "0")}.`
+    ]),
     ...Array.from({ length: 14 }, (_, index) => [
       `LOC-${String(index + 1).padStart(2, "0")}`,
       `Complete foreground-location runbook check LOC-${String(index + 1).padStart(2, "0")} without recording exact coordinates.`
@@ -17847,9 +18056,61 @@ var init_iosTestReport = __esm(() => {
       "Review this directory for sensitive content and complete every row."
     ]
   ];
-  secretPattern = /(authorization|access[_ -]?token|refresh[_ -]?token|socket[_ -]?ticket|password|cookie)(\s*[=:]\s*)([^\s,;]+)/giu;
-  bearerPattern = /bearer\s+[^\s,;]+/giu;
-  coordinatePattern = /\b(latitude|longitude|lat|lng)(\s*[=:]\s*)-?\d+(?:\.\d+)?/giu;
+  readPackageVersionForIosReport = readPackageVersionForNativeReport;
+  sanitizeIosReportText = sanitizeNativeReportText;
+  writeAbsoluteIosPartnerReport = writeAbsoluteNativeTestReport;
+});
+
+// src/mobile/androidTestReport.ts
+var MANUAL_CHECKS2, createAbsoluteAndroidTestReport = (options) => {
+  const { serial, ...run } = options.run;
+  return createAbsoluteNativeTestReport({
+    ...options.generatedAt ? { generatedAt: options.generatedAt } : {},
+    manualChecks: MANUAL_CHECKS2,
+    metadata: {
+      absolutejsVersion: options.absolutejsVersion,
+      adbVersion: options.adbVersion,
+      bunVersion: options.bunVersion,
+      host: options.host,
+      provider: "capacitor"
+    },
+    run: {
+      ...run,
+      platform: "android",
+      targetId: serial,
+      targetKind: serial.startsWith("emulator-") ? "emulator" : "device"
+    }
+  });
+};
+var init_androidTestReport = __esm(() => {
+  init_nativeTestReport();
+  MANUAL_CHECKS2 = [
+    [
+      "SETUP-01",
+      "Confirm Android SDK, emulator/device, Bun, and package versions."
+    ],
+    ["DEV-01", "Record cold and warm native startup timings."],
+    ["DEV-02", "Complete route traversal, HMR, relaunch, and recovery checks."],
+    ["CAP-01", "Complete automatic device-capability provisioning checks."],
+    [
+      "FILES-01",
+      "Complete provider-neutral file pick, export, open, and cleanup checks."
+    ],
+    [
+      "AUTH-01",
+      "Complete system-browser sign-in, callback, restore, and sign-out checks."
+    ],
+    [
+      "SYNC-01",
+      "Complete online, offline, reconnect, isolation, and conflict checks."
+    ],
+    ["BGSYNC-01", "Complete WorkManager background Sync acceptance."],
+    ["BUILD-01", "Pass release doctor and produce a signed AAB."],
+    [
+      "REPORT-01",
+      "Review this directory for sensitive content and complete every row."
+    ]
+  ];
 });
 
 // src/mobile/releasePublisher.ts
@@ -18728,7 +18989,8 @@ Emulator setup verification:`);
   const routes = valuesAfter(args, "--route");
   if (routes.length === 0)
     routes.push(mobile.entry);
-  const artifactRoot = safeArtifactRoot(projectRoot, valueAfter(args, "--artifacts"));
+  const reportRoot = nativeReportRoot(args, projectRoot, "android");
+  const artifactRoot = reportRoot ?? safeArtifactRoot(projectRoot, valueAfter(args, "--artifacts"));
   const startedAt = performance.now();
   let session;
   try {
@@ -18767,6 +19029,30 @@ Emulator setup verification:`);
       console.log(JSON.stringify(report, null, 2));
     else
       printAndroidTestReport(report);
+    const screenshot = reportRoot ? await session.screenshot(join52(artifactRoot, "android-emulator.png")) : undefined;
+    await writeRequestedAndroidReport({
+      adb,
+      args,
+      projectRoot,
+      run: {
+        appId: mobile.appId,
+        durationMs: report.durationMs,
+        ...hmrApply ? {
+          hmr: {
+            clientMs: hmrApply.clientMs,
+            durationMs: hmrApply.duration,
+            outcome: hmrApply.outcome,
+            serverMs: hmrApply.serverMs
+          }
+        } : {},
+        hmrConnected: true,
+        port,
+        routes: checks.map(({ route }) => route),
+        ...screenshot ? { screenshot } : {},
+        serial,
+        status: "pass"
+      }
+    });
     return report;
   } catch (error) {
     const durationMs = Math.round(performance.now() - startedAt);
@@ -18785,6 +19071,22 @@ Emulator setup verification:`);
       serial,
       session
     });
+    await writeRequestedAndroidReport({
+      adb,
+      args,
+      projectRoot,
+      run: {
+        appId: mobile.appId,
+        durationMs,
+        error: sanitizeNativeReportText(error instanceof Error ? error.message : String(error)),
+        hmrConnected: false,
+        port,
+        routes,
+        ...screenshot ? { screenshot } : {},
+        serial,
+        status: "fail"
+      }
+    });
     throw new Error(`${error instanceof Error ? error.message : String(error)} Failure diagnostics: ${diagnosticPath}${screenshot ? `; screenshot: ${screenshot}` : ""}`, { cause: error });
   } finally {
     await session?.close();
@@ -18875,7 +19177,7 @@ Emulator setup verification:`);
   if (!selected)
     throw new TypeError("No ready AbsoluteJS iOS simulator was found. Start `bun dev` and wait for the iOS target to become ready.");
   return selected;
-}, requireCapturedIosCommand = (command, label) => {
+}, requireCapturedCommand = (command, label) => {
   const result = captureCommand4(command);
   if (result.exitCode !== 0)
     throw new Error(`${label} failed: ${result.stderr.trim() || result.stdout.trim() || `status ${result.exitCode}`}`);
@@ -18906,37 +19208,56 @@ Emulator setup verification:`);
     diagnosticPath,
     screenshot: screenshotResult.exitCode === 0 ? screenshot : undefined
   };
-}, iosReportRoot = (args, projectRoot) => {
+}, nativeReportRoot = (args, projectRoot, platform6) => {
   const index = args.indexOf("--report");
   if (index === NOT_FOUND3)
     return;
   const candidate = args[index + 1];
   const explicit = candidate?.startsWith("--") ? undefined : candidate;
   const timestamp = new Date().toISOString().replaceAll(":", "-");
-  return safeArtifactRoot(projectRoot, explicit ?? `.absolutejs/mobile/test-reports/ios-${timestamp}`);
-}, iosReportMetadata = async (xcrun) => {
-  const xcodebuildPath = requireCapturedIosCommand([xcrun, "--find", "xcodebuild"], "Xcode version inspection").stdout.trim();
-  const xcodeVersion = requireCapturedIosCommand([xcodebuildPath, "-version"], "Xcode version inspection").stdout.trim();
-  const macosVersion = requireCapturedIosCommand(["/usr/bin/sw_vers", "-productVersion"], "macOS version inspection").stdout.trim();
+  return safeArtifactRoot(projectRoot, explicit ?? `.absolutejs/mobile/test-reports/${platform6}-${timestamp}`);
+}, absolutejsVersionForReport = async () => {
   let absolutejsVersion = process.env.ABSOLUTE_VERSION ?? "unknown";
-  for (const candidate of [
+  const versions = await Promise.all([
     resolve41(import.meta.dir, "..", "..", "package.json"),
     resolve41(import.meta.dir, "..", "..", "..", "package.json")
-  ]) {
-    const version2 = await readPackageVersionForIosReport(candidate).catch(() => "unknown");
+  ].map((candidate) => readPackageVersionForIosReport(candidate).catch(() => "unknown")));
+  for (const version2 of versions) {
     if (version2 === "unknown")
       continue;
     absolutejsVersion = version2;
     break;
   }
+  return absolutejsVersion;
+}, writeRequestedAndroidReport = async (options) => {
+  const reportRoot = nativeReportRoot(options.args, options.projectRoot, "android");
+  if (!reportRoot)
+    return;
+  const adbVersion = requireCapturedCommand([options.adb, "version"], "ADB version inspection").stdout.trim();
+  const report = createAbsoluteAndroidTestReport({
+    absolutejsVersion: await absolutejsVersionForReport(),
+    adbVersion,
+    bunVersion: Bun.version,
+    host: `${process.platform}-${process.arch}`,
+    run: options.run
+  });
+  const paths = await writeAbsoluteNativeTestReport(reportRoot, report);
+  const print = options.args.includes("--json") ? console.error : console.log;
+  print(`Android test report: ${paths.markdownPath}`);
+  print(`Return this report directory: ${paths.directory}`);
+  return paths;
+}, iosReportMetadata = async (xcrun) => {
+  const xcodebuildPath = requireCapturedCommand([xcrun, "--find", "xcodebuild"], "Xcode version inspection").stdout.trim();
+  const xcodeVersion = requireCapturedCommand([xcodebuildPath, "-version"], "Xcode version inspection").stdout.trim();
+  const macosVersion = requireCapturedCommand(["/usr/bin/sw_vers", "-productVersion"], "macOS version inspection").stdout.trim();
   return {
-    absolutejsVersion,
+    absolutejsVersion: await absolutejsVersionForReport(),
     bunVersion: Bun.version,
     macosVersion,
     xcodeVersion
   };
 }, writeRequestedIosReport = async (options) => {
-  const reportRoot = iosReportRoot(options.args, options.projectRoot);
+  const reportRoot = nativeReportRoot(options.args, options.projectRoot, "ios");
   if (!reportRoot)
     return;
   const metadata = await iosReportMetadata(options.xcrun);
@@ -18955,11 +19276,11 @@ Emulator setup verification:`);
   const timeoutMs = androidTestTimeout(args);
   const xcrun = await requireIosXcrun();
   const simulator = selectIosSimulator(xcrun, valueAfter(args, "--udid") ?? valueAfter(args, "--serial"));
-  const reportRoot = iosReportRoot(args, projectRoot);
+  const reportRoot = nativeReportRoot(args, projectRoot, "ios");
   const artifactRoot = reportRoot ?? safeArtifactRoot(projectRoot, valueAfter(args, "--artifacts"));
   const startedAt = performance.now();
   try {
-    requireCapturedIosCommand([
+    requireCapturedCommand([
       xcrun,
       "simctl",
       "get_app_container",
@@ -18967,7 +19288,7 @@ Emulator setup verification:`);
       mobile.appId,
       "app"
     ], "iOS installed-app inspection");
-    requireCapturedIosCommand([
+    requireCapturedCommand([
       xcrun,
       "simctl",
       "launch",
@@ -18978,7 +19299,7 @@ Emulator setup verification:`);
     await waitForIosHmrClient({ https, port, timeoutMs });
     await mkdir14(artifactRoot, { recursive: true });
     const screenshot = join52(artifactRoot, "ios-simulator.png");
-    requireCapturedIosCommand([xcrun, "simctl", "io", simulator.udid, "screenshot", screenshot], "iOS simulator screenshot");
+    requireCapturedCommand([xcrun, "simctl", "io", simulator.udid, "screenshot", screenshot], "iOS simulator screenshot");
     const hmrApply = await waitForRequestedIosHmr(args, instance, timeoutMs);
     const report = {
       appId: mobile.appId,
@@ -19111,7 +19432,7 @@ Emulator setup verification:`);
     await publishIos(args.slice(2));
     return;
   }
-  throw new TypeError("Usage: absolute mobile <pair mac <name> <user@host> [--port n] [--workspace path] | remotes [--json] | unpair mac <name> | init [--no-native] [--force] | sync [ios|android] | associations [--outdir dir] [--verify] | doctor [ios|android|release] [--remote name] [--json|--fix [--yes]] | build <android|ios> [server-entry] [--outdir dir] [--web-outdir dir] [--unsigned] | publish android [server-entry] [--registry module] [--channel name] [--play-track track] [--play-status completed|draft|halted|in-progress] [--play-rollout fraction] [--play-name name] [--play-notes language=text] [--play-update-priority 0..5] [--play-hold-review] [--play-cancel-existing-review] [--outdir dir] [--web-outdir dir] [--unsigned] | publish ios [server-entry] [--registry module] [--channel name] [--testflight-group name-or-id] [--testflight-notes locale=text] [--testflight-submit-review] [--outdir dir] [--web-outdir dir] [--unsigned] | test android [--route path] [--wait-for-hmr] [--timeout ms] [--port n] [--serial id] [--artifacts dir] [--json] | test ios [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--udid id] [--artifacts dir] [--json]> [--config path]");
+  throw new TypeError("Usage: absolute mobile <pair mac <name> <user@host> [--port n] [--workspace path] | remotes [--json] | unpair mac <name> | init [--no-native] [--force] | sync [ios|android] | associations [--outdir dir] [--verify] | doctor [ios|android|release] [--remote name] [--json|--fix [--yes]] | build <android|ios> [server-entry] [--outdir dir] [--web-outdir dir] [--unsigned] | publish android [server-entry] [--registry module] [--channel name] [--play-track track] [--play-status completed|draft|halted|in-progress] [--play-rollout fraction] [--play-name name] [--play-notes language=text] [--play-update-priority 0..5] [--play-hold-review] [--play-cancel-existing-review] [--outdir dir] [--web-outdir dir] [--unsigned] | publish ios [server-entry] [--registry module] [--channel name] [--testflight-group name-or-id] [--testflight-notes locale=text] [--testflight-submit-review] [--outdir dir] [--web-outdir dir] [--unsigned] | test android [--route path] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--serial id] [--artifacts dir] [--json] | test ios [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--udid id] [--artifacts dir] [--json]> [--config path]");
 };
 var init_mobile = __esm(() => {
   init_dependencies();
@@ -19134,6 +19455,8 @@ var init_mobile = __esm(() => {
   init_iosSimulatorController();
   init_iosConformance();
   init_iosTestReport();
+  init_androidTestReport();
+  init_nativeTestReport();
   init_releasePublisher();
   init_start();
   init_utils();
@@ -19163,8 +19486,8 @@ var init_mobile = __esm(() => {
     "@capacitor/cli@8.5.0",
     "@capacitor/android@8.5.0",
     "@capacitor/ios@8.5.0",
-    "@absolutejs/devices@0.3.0",
-    "@absolutejs/devices-capacitor@0.4.0"
+    "@absolutejs/devices@0.4.0",
+    "@absolutejs/devices-capacitor@0.5.0"
   ];
   CAPACITOR_SYNC_PACKAGE_SPECS = [
     "@absolutejs/sync-capacitor@0.9.1",