2.1.0

[jan-tennert]

Notes

The documentation has been updated accordingly.

Changes

Add iOS targets to the chat-demo by @hieuwu in #397

Realtime

• Add an option (Realtime.Config#disconnectOnNoSubscriptions) to automatically disconnect from the websocket, once there is no channel left, which defaults to true. (in Automatically disconnect from realtime websocket #416 by @jan-tennert)
• Remove the error for Realtime when a channel is already connected by @jollygreenegiant in Remove error for Realtime when a channel is already connected #430
• Provide a new (experimental) way to listen to Realtime data (built on top of the existing ones) (in Provide an easier way to listen to Realtime data #386 by @jan-tennert):

Note: For both methods, the flows automatically emit the initial data and then listen for events using the existing methods.
Listen for changes in all messages (handles inserts, updates and deletes automatically and emits the updated list)

val messageFlow: Flow<List<Message>> = channel.postgresListDataFlow<Message>( //provide your serializable type (in this case Message)
    table = "messages",
    filter = FilterOperation("id", FilterOperator.IN, listOf(1, 2, 3, 4)), //optional filter
    primaryKey = Message::id //provide the primary key for caching
)

Listen for changes on a single value

val singleMessageFlow: Flow<Message> = channel.postgresSingleDataFlow<Message>( //Automatically emits the updated message and closes on delete
    table = "messages",
    primaryKey = Message::id
) { //this is the same filter builder the Postgrest plugin uses, so you can use everything:
    Message::id eq 2
    or {
        Message::creatorId isIn listOf("1", "2", "3")
        Message::content like "%test%"
    }
}

Listen to presence changes (joins & leaves are handled automatically)

val presenceFlow: Flow<List<User>> = channel.presenceDataFlow<User>()

• Add a new method for adding a filter to postgres changes:

supabase.channel("channel").postgresChangeFlow<PostgresAction>("public") {
    //Still only one filter supported
    filter("id", FilterOperator.EQ, 2)
    //Note that some values get converted to strings e.g. the List<Int> to (1,2,3)
    filter("id", FilterOperator.IN, listOf(1, 2, 3, 4))
}

New methods:

• RealtimeChannel#postgresSingleDataFlow
• RealtimeChannel#postgresListDataFlow
• RealtimeChannel#presenceDataFlow
• RealtimeChannelBuilder#filter

GoTrue

• Add GoTrue lifecycle observers on main thread by @jollygreenegiant in Add GoTrue lifecycle observers on main thread #431

Compose Auth

• Add missing catch block in the Compose Auth CM implementation by @jan-tennert in Add missing catch block on the Compose Auth CM implementation #433
• Fix Apple Auth triggering automatically by @jan-tennert in Fix apple auth triggering automatically #443

Postgrest

• Fix nested logical operators by @jan-tennert in Fix nested logical operators #435

---

This discussion was created from the release 2.1.0.