fix(metadata): show readable SAF file locations

2026-08-27 05:12:29 +02:00 · 2026-08-21 01:02:02 +07:00
parent cee3d75655
commit 89d39c4074
9 changed files with 348 additions and 40 deletions
@@ -0,0 +1,98 @@
+String formatSafUriForDisplay(String pathOrUri) {
+  if (pathOrUri.isEmpty || !pathOrUri.startsWith('content://')) {
+    return pathOrUri;
+  }
+
+  try {
+    final uri = Uri.parse(pathOrUri);
+    final documentId = _safDocumentId(uri);
+    if (documentId == null || documentId.isEmpty) return pathOrUri;
+
+    final separatorIndex = documentId.indexOf(':');
+    if (separatorIndex <= 0) return pathOrUri;
+
+    final volumeId = documentId.substring(0, separatorIndex);
+    final relativePath = documentId
+        .substring(separatorIndex + 1)
+        .replaceAll('\\', '/');
+
+    if (volumeId.toLowerCase() == 'primary') {
+      return relativePath.isEmpty
+          ? '/storage/emulated/0'
+          : '/storage/emulated/0/$relativePath';
+    }
+
+    // Media/document providers use opaque IDs such as audio:12345 or
+    // msf:100001. Presenting those as an SD-card path is misleading.
+    if (!_looksLikeStorageVolumeId(volumeId)) return pathOrUri;
+    return relativePath.isEmpty ? 'SD Card' : 'SD Card/$relativePath';
+  } catch (_) {
+    return pathOrUri;
+  }
+}
+
+String buildSafFileDisplayPath({
+  required String pathOrUri,
+  String? treeUri,
+  String? treeDisplayPath,
+  String? relativeDir,
+  String? fileName,
+}) {
+  if (!pathOrUri.startsWith('content://')) return pathOrUri;
+
+  final displayRoot =
+      _friendlyDisplayRoot(treeDisplayPath) ??
+      _friendlyDisplayRoot(formatSafUriForDisplay(treeUri?.trim() ?? ''));
+  final cleanRelativeDir = _cleanDisplaySegment(relativeDir);
+  final cleanFileName = _cleanDisplaySegment(fileName);
+
+  if (displayRoot != null) {
+    return [
+      displayRoot.replaceAll(RegExp(r'/+$'), ''),
+      if (cleanRelativeDir != null) cleanRelativeDir,
+      if (cleanFileName != null) cleanFileName,
+    ].join('/');
+  }
+
+  return formatSafUriForDisplay(pathOrUri);
+}
+
+String? _safDocumentId(Uri uri) {
+  final segments = uri.pathSegments;
+  for (final marker in const ['document', 'tree']) {
+    final index = segments.indexOf(marker);
+    if (index != -1 && index + 1 < segments.length) {
+      final raw = segments[index + 1];
+      try {
+        return Uri.decodeComponent(raw);
+      } catch (_) {
+        return raw;
+      }
+    }
+  }
+  return null;
+}
+
+bool _looksLikeStorageVolumeId(String value) {
+  return RegExp(
+    r'^[0-9a-f]{4}-[0-9a-f]{4}$',
+    caseSensitive: false,
+  ).hasMatch(value);
+}
+
+String? _friendlyDisplayRoot(String? value) {
+  final normalized = value?.trim().replaceAll('\\', '/');
+  if (normalized == null ||
+      normalized.isEmpty ||
+      normalized.startsWith('content://')) {
+    return null;
+  }
+  return normalized;
+}
+
+String? _cleanDisplaySegment(String? value) {
+  final normalized = value?.trim().replaceAll('\\', '/');
+  if (normalized == null || normalized.isEmpty) return null;
+  final withoutEdges = normalized.replaceAll(RegExp(r'^/+|/+$'), '');
+  return withoutEdges.isEmpty ? null : withoutEdges;
+}