Skip to content

CHANGELOG.md

Latest commit

 

History

History
158 lines (118 loc) · 6.47 KB

CHANGELOG.md

File metadata and controls

158 lines (118 loc) · 6.47 KB

Changelog

0.12.0 — 2026-04-10

Fixed

  • Set source file modification date during upload (was always Unix epoch 1970-01-01)

0.11.1 — 2026-03-30

Added

  • /release skill for tagged releases with changelog

Fixed

  • Iterate sibling chains to prevent stack overflow in folder tree traversal

0.11.0 — 2026-03-01

Added

  • Linux support: conditional Glibc/Musl imports for cross-platform compilation
  • Linux CI job using swift:6.2-noble container
  • apt package provider (libmtp-dev) in Package.swift

Changed

  • Homebrew linker flags gated to macOS only via #if os(macOS)

0.10.0 — 2026-03-01

Changed

  • Lowered deployment target from macOS 26 to macOS 15
  • Added GitHub Actions CI workflow (build and test on macos-15 with Xcode 26)

0.9.1 — 2026-02-28

Added

  • Hashable conformance for FileInfo, DeviceCapability, StorageInfo, and ProgressAction
  • LICENSE file

Changed

  • Removed architecture section from README

0.9.0 — 2026-02-28

Fixed

  • External library usage now includes pkgConfig for correct linker resolution
  • Suppress libmtp stdout noise (device detection/open messages) via POSIX dup2 redirect to /dev/null

0.8.0 — 2026-02-28

Added

  • MTPSession public actor for dedicated USB I/O isolation (SwiftMTPAsync product)
  • SwiftMTP sync product with @MainActor Device wrapper
  • MTPCore internal shared target for types, nominal IDs, and ~Copyable wrappers

Changed

  • Split package into three targets: MTPCore (internal), SwiftMTP (sync), SwiftMTPAsync (async)
  • Device is now package access in MTPCore; public API surface is SwiftMTP.Device or SwiftMTPAsync.MTPSession
  • Device properties (name, serialNumber, batteryLevel, etc.) cached as nonisolated let at init
  • Hardware tests consolidated into SwiftMTPTests and SwiftMTPAsyncTests
  • Removed pkgConfig from system library target to eliminate prohibited -framework IOKit warnings

0.7.0 — 2026-02-28

Added

  • MTP enum namespace with initialize(), isInitialized, and detectDevices() as static members
  • Device.detect() convenience static func wrapping MTP.detectDevices()
  • MTPError.alreadyInitialized and MTPError.notInitialized cases
  • Precondition checks at entry points (MTP.detectDevices(), RawDevice.open(), Device.init(busLocation:devnum:)) throw .notInitialized if the library hasn't been set up

Changed

  • MTP.initialize() throws .alreadyInitialized on re-initialization (call-once guard via Atomic<Bool>)
  • Replaced free functions mtpInitialize(), mtpIsInitialized, mtpDetectDevices() with MTP.* static API

0.6.0 — 2026-02-28

Added

  • ProgressAction enum (.continue / .cancel) replacing Bool return from ProgressHandler for self-documenting transfer control; conforms to ExpressibleByBooleanLiteral so return true still works
  • FileReference protocol — pass FileInfo, Folder, or ObjectID directly to download, info, delete, rename, and move instead of extracting .id
  • Device.events() returning cancellable AsyncStream<Event> using LIBMTP_Read_Event_Async + poll loop
  • Dedicated Thread for event polling (does not occupy the cooperative thread pool)
  • Cooperative cancellation via Task cancellation — poll loop exits within ~500ms

Fixed

  • events() stream now retains the Device for the stream's lifetime, preventing use-after-free if the caller drops its reference

Changed

  • ProgressHandler now returns ProgressAction instead of Bool
  • readEvent() docstring updated to recommend events() as the preferred alternative

0.5.0 — 2026-02-28

Added

  • URL overloads for upload(from:) and download(_:to:) on both Device and Storage
  • Upload from URL defaults filename to url.lastPathComponent when as: is omitted
  • MTPError.notFileURL case for non-file URL diagnostics

Changed

  • URL is now the canonical parameter type for local file paths; String overloads delegate to URL versions

0.4.0 — 2026-02-28

Added

  • DeviceNumber nominal wrapper type for USB device numbers (replaces raw UInt8)
  • ObjectID.root static constant (mirrors Folder.root and StorageID.all)
  • Inline docstrings documenting implicit C contracts (memory ownership, callback lifetimes, error stack semantics, thread safety) on all ~Copyable wrappers and key functions

Changed

  • RawDevice.devnum, Device.init(devnum:), and MTPError.connectionFailed(devnum:) now use DeviceNumber instead of raw UInt8
  • README updated for current type inventory, sorting API, and thread-safety notes

0.3.0 — 2026-02-27

Added

  • FileInfo.SortOrder enum with .byName, .bySize, .byDate (ascending/descending) and .directoriesFirst
  • Sequence<FileInfo>.sorted(_:) extension for ergonomic sorting (entries.sorted(.byName))
  • BusLocation, VendorID, ProductID nominal wrapper types for USB identifiers
  • StorageInfo.usedSpace and StorageInfo.percentFull computed properties
  • Path nominal type for type-safe path resolution
  • Storage facade: download, info, delete, rename on Storage
  • upload(), makeDirectory(), and rename() now return FileInfo

Changed

  • Dropped MTP prefix from all types — module provides namespacing (e.g. MTPDevice → Device)
  • Split CTypes.swift into one file per ~Copyable wrapper
  • Split MTPTypes.swift into one file per type declaration
  • RawDevice, Device, and MTPError use nominal USB ID types throughout
  • Internal C bridge layer uses nominal ID types consistently

0.2.0 — 2026-02-26

Added

  • Event enum and readEvent() for device event listening
  • deviceDisconnected case on MTPError
  • Storage handle for device-bound storage operations
  • StorageInfo convenience overloads for storage parameter
  • defaultStorage convenience property
  • ObjectID, StorageID, Folder nominal types
  • RawDevice.open() to avoid TOCTOU rescan
  • ~Copyable wrapper types (Upload, FileHandle, FileNode, FolderTree) for C resource management

Changed

  • Methods follow Swift API Design Guidelines naming
  • ObjectID/StorageID used in all method signatures
  • Swift 6.2 tools-version with macOS 26 platform

Fixed

  • Drain error stack between rename attempts

0.1.0 — 2026-02-25

Added

  • Initial release
  • Device class with storage info, directory listing, file operations
  • Download, upload, rename, delete, move, make directory
  • resolvePath for path-based file lookup
  • Progress callbacks for transfers
  • Hardware-gated test suite