From f8463acf675c8c9a8ffd98266f36ea3aefb93d50 Mon Sep 17 00:00:00 2001 From: Santo Shakil Date: Thu, 20 Aug 2026 12:16:24 +0600 Subject: [PATCH] add docstrings to the share file helpers --- mobile/lib/repositories/asset_media.repository.dart | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/mobile/lib/repositories/asset_media.repository.dart b/mobile/lib/repositories/asset_media.repository.dart index bcce9774d5..af539f2056 100644 --- a/mobile/lib/repositories/asset_media.repository.dart +++ b/mobile/lib/repositories/asset_media.repository.dart @@ -22,6 +22,8 @@ import 'package:path/path.dart' as p; import 'package:photo_manager/photo_manager.dart'; import 'package:share_plus/share_plus.dart'; +/// A file staged for the share sheet. [tempEntity] is the temp file or +/// directory to delete afterwards, null when [file] is a gallery original. typedef _ShareFile = ({File file, FileSystemEntity? tempEntity, String displayName}); final assetMediaRepositoryProvider = Provider( @@ -287,6 +289,10 @@ class AssetMediaRepository { return null; } + /// Renames downloaded files to their display name before sharing, since + /// receiving apps only see the on-disk filename. Runs once over the whole + /// batch: gallery originals cannot be renamed, so when names collide the + /// downloads give way and get an ` (n)` suffix instead. Future _resolveShareFiles(List<_ShareFile> files) async { final usedNames = { for (final shareFile in files)