v1.0.0

1.0.0 (2026-10-03)

⚠ BREAKING CHANGES

• files: buildDownloadUrl, buildMp4DownloadUrl,
  buildAudioStreamUrl, buildOriginalStreamUrl, both buildStreamUrl
  overloads, and buildHlsStreamUrl replace accessToken: String with
  downloadToken: AccountDownloadToken.

• docs(security): keep the persist and share warning for media URLs

• docs(security): leave SECURITY.md as on main

Features

• account: add the cross-client privacy control settings (#44) (134351f)
• account: expose is_sub_account on AccountInfo (#61) (620c536)
• add account sort setting patch (63ba189)
• add app-driven sdk entities (0861d83)
• add kotlin cursor continuation flows (e9171a0)
• add kotlin transfers surface (bba1c2a)
• add kotlin two-factor auth flows (6a28d50)
• add operation-aware sdk errors (0912d0b)
• add remaining Swift parity endpoints (1cec23e)
• add type-aware stream url helpers (5ebdc98)
• auth: add the device-code linking orchestrator (#45) (1ae96ef)
• bootstrap kotlin sdk (de556ce)
• expand Kotlin SDK Swift parity (1e4dff7)
• expose kotlin subtitle and trash metadata (b732cd4)
• files: add getDownloadUrl for API-issued download URLs (#55) (c7a7b0e)
• files: add maxSubtitleCount to HLS stream URLs (#58) (fc17f5f)
• files: add multipart upload with a torrent-only option (#63) (ebc9dfc)
• files: build media URLs with the account download token (#69) (2e5491f)
• files: expose PutioCredentialUrl.of for consumer-owned media URLs (#50) (b1bf419)
• files: expose the original stream URL builder (#52) (2c61413)
• files: request child video metadata on list (#42) (cec5ceb)
• files: resolve playback sources (#33) (a041668)
• return kotlin history pagination state (417aab7)
• sharing: add cloneSharedFiles and getCloneInfo (#65) (e6de13b)
• sharing: add sharing and public-links namespace (#56) (b933825)
• tighten types and add live tests (a5b5d55)
• use SOPS for live-test secrets (#18) (0a59dc6)

Bug Fixes

• auth: harden credential redaction and cancellation (#29) (49a5f34)
• config: expose app-scoped values generically (#30) (1d30240)
• distinguish cursor continuation failures (#32) (5ffba6a)
• errors: decode put.io's error_message and expose it on PutioApiException (#64) (10fa469)
• files: reject non-OK file response envelopes (#41) (f11b21b)
• files: validate delete result envelopes (#38) (1d56386)
• files: validate move result envelopes (#39) (9f882a0)
• history: match event types as the API sends them (#51) (d9a2965)
• kotlin-sdk: validate config update keys (#4) (a5b5ec0)
• make live trash cleanup permanent (#19) (6344527)
• preserve ok response metadata (aea2bfe)
• trash: validate response envelopes and acknowledgements (#40) (87b9666)