saf 2.1.0

Flutter plugin that leverages Storage Access Framework (SAF) API to get access and perform the operations on files and folders.

2.1.0

• New: openFileDescriptor / closeFileDescriptor open a live file descriptor for a SAF document and expose its /proc/self/fd/<fd> path for native or path-based APIs; withFileDescriptor opens, runs your action, and always closes in a finally.
• New: thumbnail(uri, width, height, quality) returns provider-generated JPEG bytes (Uint8List?), or null when the provider has none.
• New: SafOpenFd model (fd, path).
• Example: a mini file-manager showcasing the new descriptor and thumbnail APIs.
• Fix: an aborted writeFileStream no longer deletes a pre-existing target file (overwrite/append) — only documents created by that write are cleaned up.
• Fix: copyTo/moveTo now reject copying a directory into itself or its own subtree instead of recursing until storage fills.
• Fix: releasePersistedPermission now releases directory grants taken by pickDirectory (URI-form mismatch made it a silent no-op).
• Fix: picker failures (e.g. no SAF handler on some Android TV/Go builds) no longer leave the plugin stuck rejecting all future picks.
• Fix: openReadSession no longer leaks the stream when seeking fails.
• Deprecated FileTypes (legacy 1.x, removed in 3.0.0); internal mapPlatformException is no longer exported.

2.0.1

• Documentation and presentation polish. No API or behavior changes.

2.0.0

One class for everything SAF. The new Saf class covers pickers, persisted permissions, file management, recursive walk(), byte/stream read-write with progress callbacks, and local-file bridging — one focused API, typed exceptions, no isDir parameters.

BREAKING: the legacy path-based class is renamed LegacySaf (deprecated, removal in 3.0.0). Its behavior is unchanged — existing code only needs Saf( → LegacySaf(.

• New: pickDirectory/pickFile/pickFiles with initial URI and persistable permissions; persistedPermissions() listing.
• New: list (single-cursor, fast), stat, exists, child, mkdirp, delete, rename, recursive copyTo/moveTo with progress, walk().
• New: readFileBytes/readFileStream, writeFileBytes, one-call writeFileStream, copyToLocalFile/pasteLocalFile, and copyDirToLocal (bulk-copy a granted folder into your app dir — e.g. WhatsApp .Statuses).
• New: sealed SafException hierarchy (permission / not_found / already_exists / io).
• Broad support: Dart >=3.0, Flutter >=3.10, Android minSdk 21.