Changes

Storage

• Make the default value for Storage.Config.resumable#cache null to prevent a NullPointerException in testing enviroments. (If it's set to null, the default cache implementation will be used)
• Fix BucketApi#createSignedUploadUrl returning an invalid url
• Fix BucketApi#createSignedUrl not correctly adding transformation parameters
• Fix BucketApi#createSignedUrl returning an invalid url
• Fix BucketListFilter#sortBy not working correctly
• Add missing destinationBucket parameter to BucketApi#copy and BucketApi#move by @jan-tennert in #562

Auth

• Move enableLifecycleCallbacks to the common source set (still only used on Android) by @jan-tennert in #561
• Add AuthConfig#minimalSettings (useful for servers or testing, disabling session storage and uses only in-memory caches) by @jan-tennert in #561

Realtime

• Remove the suspend modifier for RealtimeChannel#postgresListDataFlow by @jan-tennert in #563
• When a postgres flow is closed, the joining payload will now be correctly cleaned by @jan-tennert in #563

Changes

Core

• Update Kotlin to 2.0.0-RC1

Postgrest

• Add referenced table parameter to or and and by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/551
• Fix nested or blocks working incorrectly
• Auto remove line breaks and white spaces when unquoted on Columns.Raw by @iruizmar in https://github.com/supabase-community/supabase-kt/pull/544
• Add support for using GET when calling database functions by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/538
  There is now a method parameter which takes in a RpcMethod. This can either be POST, HEAD or GET. The head parameter has been removed.

Realtime

• Stabilize new flow presence and postgres methods by @jan-tennert in #535

Auth

• Stabilize linking identities and signing in anonymously by @jan-tennert in #535
• Rename Auth#modifyUser to Auth#updateUser by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/534
• Return full a full UserInfo on sign up by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/528
  The signUpWith method will now return a UserInfo object for the Email, Phone and IDToken instead of separate Result objects.
• Allow customizing the custom tab intent on Android by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/529

New Contributors

• @iruizmar made their first contribution in https://github.com/supabase-community/supabase-kt/pull/544

Changes

Core

• Update Kotlin to 2.0.0-RC1

Postgrest

• Add referenced table parameter to or and and by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/551
• Fix nested or blocks working incorrectly

Changes

Postgrest

• Auto remove line breaks and white spaces when unquoted on Columns.Raw by @iruizmar in https://github.com/supabase-community/supabase-kt/pull/544

New Contributors

• @iruizmar made their first contribution in https://github.com/supabase-community/supabase-kt/pull/544

Changes

Realtime

• Stabilize new flow presence and postgres methods by @jan-tennert in #535

Auth

• Stabilize linking identities and signing in anonymously by @jan-tennert in #535
• Rename Auth#modifyUser to Auth#updateUser by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/534

Postgrest

• Add support for using GET when calling database functions by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/538
  There is now a method parameter which takes in a RpcMethod. This can either be POST, HEAD or GET. The head parameter has been removed.

Note

There is now a Slack channel for supabase-kt!

Changes

Auth

• Return full a full UserInfo on sign up by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/528
  The signUpWith method will now return a UserInfo object for the Email, Phone and IDToken instead of separate Result objects.
• Allow customizing the custom tab intent on Android by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/529

Note

There is now a Slack channel for supabase-kt!

Changes

Compose Auth

• Fix iOS Native Apple Sign-In Digest error by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/527
  Nonce hashing is now done by Krypto.

Changes

Add wasm-js support for compose-auth, compose-auth-ui and apollo-graphql.

Auth

• Migrate HTTP Callback Servers to use Ktor 3.0.0

Note

• You have to add this repository: https://maven.pkg.jetbrains.space/kotlin/p/wasm/experimental
• You have to use a 3.0.0 Ktor Client Engine version, otherwise there will be a build error. Supabase-kt uses 3.0.0-wasm2.

Changes

Core

• Ignore exception thrown by missing Json property by default by @hieuwu in https://github.com/supabase-community/supabase-kt/pull/510

Postgrest

• Rename filter param to request in Postgrest#rpc by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/506

Auth

• Change default value of OTP.Config#createUser to true to match docs and other client libs
• Add support for anonymous sign ins by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/497 (experimental, as untested)
• Rename phoneNumber parameter in Auth#resendPhone to phone.

Realtime

• Deprecate Realtime.Config#eventsPerSecond (yes, I know this was just introduced, but apparently all other client libs are now also deprecating it)

Changes

Compose Auth UI

• Remove print statement in Compose Auth UI by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/502

Realtime

• Fix realtime reconnecting suspending indefinitely by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/505
• Fix session status flow being collected multiple times

Changes

Core

• Reworked internal logging to support new features, including:
  • Setting the default logging level within the SupabaseClientBuilder:

    val supabase = createSupabaseClient(url, key) {
       defaultLogLevel = LogLevel.WARNING
    }
    

    Note: The default logging level is set to LogLevel.INFO
  • Changing the logging level per plugins:

    Auth.setLogLevel(LogLevel.NONE)
    

  • Overall better and more debug log messages

Auth

• Changes to SessionStatus:
  • The Authenticated now has a source property which can be Storage, SignIn, SignUp, Refresh, External, UserChanged, UserIdentitiesChanged or Unknown
  • The Authenticated now also has a isNew property which returns true if the source is either SignIn, SignUp or External
  • The NotAuthenticated status is now a data class rather than an object and has a isSignOut property
• Rename Auth#oAuthUrl to Auth#getOAuthUrl
• Changes to OAuth using Http Callback Servers:
  • Switch to Ktor for Http Callback Servers when using OAuth on Desktop targets. Signing in using an OAuth provider e.g. with signInWith(Google) will now block the current coroutine until the flow succeeds or times out.
  • Add support for using a Http Callback Server for OAuth in the Kotlin macosX64* and linuxX64 targets
    * Only used if no deeplink host & scheme or a default redirect url is provided.
  • Add AuthConfig#httpCallbackConfig() method for configuring these servers.
• Add host and scheme auth config properties to common code (will still not used by all targets)
• Add AuthConfig#defaultRedirectUrl to override the default redirect url used for requests. Defaults to null, which means that everything stays as it is; Desktop targets will use a http callback server, mobile targets deeplinks, etc.

Compose Auth

• (Android) The Credential Manager will now always be used for all Android versions
• By default, when signing out using Auth#signOut or Auth#clearSession the Google credential will now also be cleared.
  • Because sign-outs are now handled automatically, ComposeAuth#rememberSignOutWithGoogle has been removed.
• You now pass in the nonce and extraData when calling startFlow rather than in the plugin settings.
  • If no nonce parameter is specified (or not set to null manually), the library will now take care of generating a nonce and using it for authentication.
• NativeSignInState#started has been changed to NativeSignInState#status which can be Started or NotStarted
• The Apple Native Sign-In method no longer has any arguments, as they are not needed. Note: I don't think that fixes the Apple Native Sign-In problem.
• Add debug logs and log exceptions caught while trying Native Sign-In

Realtime

• Add support for realtime message throttling in #471
  There is now a new realtime config property: eventsPerSecond (default is 10), which configures a client-side rate-limit for sending broadcasts, presence updates etc. If this rate-limit is exceeded, any message within this duration will fail.
  Set to a negative number to disable.
  Check the Supabase docs for more information.

Changes

Postgrest

• Fix ordering by multiple columns by @jan-tennert in #493

Note

WASM support will be skipped again as Ktor won't be releasing a stable version supporting WASM-JS anytime soon.

Changes

Auth

• Add SessionStatus.Authenticated#isNew: This will be true if the session source is a sign in, sign up or is external. Use this to to determine whether you e.g. change the screen.

Changes

Auth

• Changes to SessionStatus:
  • The Authenticated now has a source property which can be Storage, SignIn, SignUp, Refresh, External, UserChanged, UserIdentitiesChanged or Unknown
  • The NotAuthenticated status is now a data class rather than an object and has a isSignOut property

Compose Auth

• (Android) The Credential Manager will now always be used for all Android versions
• By default, when signing out using Auth#signOut or Auth#clearSession the Google credential will now also be cleared.
• You now pass in the nonce and extraData when calling startFlow rather than in the plugin settings.
• If no nonce parameter is specified (or not set to null manually), the library will now take care of generating a nonce and using it for authentication.
• NativeSignInState#started has been changed to NativeSignInState#status which can be Started or NotStarted
• The apple native sign in method no longer has any arguments, as they are not needed. Note: I don't think that fixes the Apple Native Sign in problem.

Changes

Realtime

• Fix concurrent calls on Realtime.connect() by @vinceglb in https://github.com/supabase-community/supabase-kt/pull/483

New Contributors

• @vinceglb made their first contribution in https://github.com/supabase-community/supabase-kt/pull/483

Changes

Postgrest

• (Bug fix) Remove double quotes for query modifiers by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/476

Full Changelog: https://github.com/supabase-community/supabase-kt/compare/2.1.3...2.1.4

Changes

Core

• Reworked internal logging to support new features including:
  • Setting the default logging level within the SupabaseClientBuilder:

    val supabase = createSupabaseClient(url, key) {
       defaultLogLevel = LogLevel.WARNING
    }
    

    Note: The default logging level is set to LogLevel.INFO
  • Changing the logging level per plugins:

    Auth.setLoggingLevel(LogLevel.NONE)
    

  • Overall better and more debug log messages

Auth

• Rename Auth#oAuthUrl to Auth#getOAuthUrl
• Switch to Ktor for Http Callback Servers when using OAuth on Desktop targets. Signing in using an OAuth provider e.g. with signInWith(Google) will now block the current coroutine until the flow succeeds or times out.
• Add support for using a Http Callback Server for OAuth in the Kotlin macosX64* and linuxX64 targets
  * Only used if no deeplink host & scheme or a default redirect url is provided.
• Add AuthConfig#httpCallbackConfig() method for configuring these servers.
• Add host and scheme auth config properties to common code (will still not used by all targets)
• Add AuthConfig#defaultRedirectUrl to override the default redirect url used for requests. Defaults to null, which means that everything stays as it is; Desktop targets will use a http callback server, mobile targets deeplinks, etc.

Realtime

• Add support for realtime message throttling in #471
  There is now a new realtime config property: eventsPerSecond (default is 10), which configures a client-side rate-limit for sending broadcasts, presence updates etc. If this rate-limit is exceeded, any message within this duration will fail.
  Set to a negative number to disable.
  Check the Supabase docs for more information.

Changes

Auth

• [Android]: If enableLifecycleCallbacks is set to true and the app goes to background, the sessionStatus value will get set to LoadingFromState (before it wasn't changed at all). This fixes a problem that caused other plugins to use a potentially expired session after the app goes back into foreground because the session wasn't refreshed yet.
  Note: You obviously have to handle the LoadingFromStorage status, e.g. by showing a loading screen.
  On the client side, it will be on LoadingFromStorage and then back to Authenticated once the session is definitely valid.
• Add oldStatus property to SessionStatus.Authenticated. This can be used to check if a new status emitted is just a refresh (so the oldStatus will just be Authenticated), or an actual login (e.g. oldStatus will be NotAuthenticated)

Full Changelog: https://github.com/supabase-community/supabase-kt/compare/2.1.2...2.1.3

Changes

GoTrue

• Add missing OTP type OtpType.Email.EMAIL by @jan-tennert in https://github.com/supabase-community/supabase-kt/pull/451
  and deprecate SIGNUP and MAGIC_LINK

Changes

Postgrest

• Fix regex error in Safari 16.x or lower by @MohamedRejeb in https://github.com/supabase-community/supabase-kt/pull/445

New Contributors

• @MohamedRejeb made their first contribution in https://github.com/supabase-community/supabase-kt/pull/445