📢 Overview

We’re on our way to finally release a final v2.0.0. Until then, this is another SNAPSHOT release which includes a few new properties and entities we got through Mastodon changes, a bit of cleaning up, as well as a few dependency updates.

Breaking changes

AccountMethods#registerAccount and RxAccountMethods#registerAccount now have a new dateOfBirth parameter of type LocalDate? as the last parameter. Set null here if you’re not propagating the date of birth from your UI. (see #573)
MastodonClient.Builder#build may now break in more ways than before. Previously, we gracefully failed if the endpoint to get an Instance didn’t work out for us to get a streaming API URL. Now, the whole build call fails with an InstanceRetrievalException that may wrap other exceptions that might have occurred during retrieval—JSON parsing exceptions, network call failures, … (see #562)
MastodonClient#getInstanceName and MastodonClient#getInstanceVersion are deprecated and will throw an error if used. A drop-in replacement is available and offered by your IDE: getInstance().domain and getInstance().version (see #562)

Changes

⭐ New features

Add Filter.FilterAction.BLUR by @bocops in #557
Add new user age restrictions by @PattaFeuFeu in #573
Reuse OkHttpClient built in client builder for instance request by @PattaFeuFeu in #562

🧼 Clean-up

Limit PR builds to specific types; cancel on new push by @PattaFeuFeu in #563
Remove "BigBone Contributors" section by @bocops in #574

⚒️ Dependency upgrade

📚 Library

Bump org.jetbrains.kotlinx:kotlinx-coroutines-core from 1.10.1 to 1.10.2 by @dependabot in #570

🤖 CI/Builds

Bump com.autonomousapps.dependency-analysis from 2.14.0 to 2.16.0 by @dependabot in #565
Bump mockk from 1.13.17 to 1.14.0 by @dependabot in #568
Bump org.gradle.toolchains.foojay-resolver-convention from 0.9.0 to 0.10.0 by @dependabot in #567
Bump org.junit.jupiter:junit-jupiter from 5.12.1 to 5.12.2 by @dependabot in #571
Bump org.junit.platform:junit-platform-suite-engine from 1.12.1 to 1.12.2 by @dependabot in #569

♥️ Contributors

We kindly thank the following contributors who worked on this release:

Full Changelog: v2.0.0-20250412.064501...v2.0.0-20250427.163556

Contributors

PattaFeuFeu, dependabot, and bocops

Assets 3

12 Apr 07:09

github-actions

v2.0.0-20250412.064501

3724941

v2.0.0-20250412.064501 Pre-release

Pre-release

📢 Overview

Breaking changes

MuteMethods.getMutes() now returns Pageable<MutedAccount> instead of Pageable<Account>. MutedAccount.toAccount() can be used to get account data as an Account. (see #550 for details)
Parameter order in OAuthMethods#getUserAccessTokenWithAuthorizationCodeGrant and RxOAuthMethods#getUserAccessTokenWithAuthorizationCodeGrant changed. Java users of the library will need to add a null parameter (as codeVerifier) before a non-null scope parameter if not using PKCE. (see #536 for details)
Parameter order in OAuthMethods#getOAuthUrl and RxOAuthMethods#getOAuthUrl changed. Java users of the library will need to add three parameters (state, codeChallenge, codeChallengeMethod) as null before forceLogin and languageCode if not using PKCE. (see #536 for details)

Changes

⭐ New features

Add MutedAccount entity. by @bocops in #550
Add PKCE parameters to relevant OAuth methods by @bocops in #536
Add attributionDomains to CredentialAccount by @bocops in #558
Add functionality to compare scopes by @bocops in #533

🐞 Bug fixes

560 catch invalid error response by @bocops in #561
Fix malformed fallback streaming URL by @PattaFeuFeu in #534

🧼 Clean-up

Clarify Status.filtered value being non-null by @bocops in #548
Cleanup: remove deprecated MediaAttachment.text_url by @bocops in #535
Define necessary scopes in access token for all samples. by @bocops in #547
Remove integration tests for Mastodon v3.0.0 and v4.0.2 by @PattaFeuFeu in #559