feat: add extras parameter to Kotlin presence wrappers

Update RealtimePresence interface and RealtimePresenceAdapter to accept
MessageExtras on enter, update, leave and their *Client variants,
matching the new Java overloads. The extras parameter defaults to null
so existing callers are unaffected.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: AndyTWF

pubsub-adapter/src/main/kotlin/com/ably/pubsub/RealtimePresence.kt

@@ -4,6 +4,7 @@ import com.ably.Subscription
 import io.ably.lib.realtime.ChannelState
 import io.ably.lib.realtime.CompletionListener
 import io.ably.lib.realtime.Presence.PresenceListener
+import io.ably.lib.types.MessageExtras
 import io.ably.lib.types.PresenceMessage
 import java.util.*
 
@@ -71,59 +72,63 @@ public interface RealtimePresence : Presence {
   public fun subscribe(actions: EnumSet<PresenceMessage.Action>, listener: PresenceListener): Subscription
 
   /**
-   * Enters the presence set for the channel, optionally passing a data payload.
+   * Enters the presence set for the channel, optionally passing a data payload and extras.
    * A clientId is required to be present on a channel.
    * An optional callback may be provided to notify of the success or failure of the operation.
    *
    * Spec: RTP8
    *
    * @param data The payload associated with the presence member.
+   * @param extras The extras associated with the presence member.
    * @param listener A callback to notify of the success or failure of the operation.
    * This listener is invoked on a background thread.
    */
-  public fun enter(data: Any? = null, listener: CompletionListener? = null)
+  public fun enter(data: Any? = null, extras: MessageExtras? = null, listener: CompletionListener? = null)
 
   /**
-   * Updates the data payload for a presence member.
+   * Updates the data payload for a presence member, optionally passing extras.
    * If called before entering the presence set, this is treated as an [PresenceMessage.Action.enter] event.
    * An optional callback may be provided to notify of the success or failure of the operation.
    *
    * Spec: RTP9
    *
    * @param data The payload associated with the presence member.
+   * @param extras The extras associated with the presence member.
    * @param listener A callback to notify of the success or failure of the operation.
    * This listener is invoked on a background thread.
    */
-  public fun update(data: Any? = null, listener: CompletionListener? = null)
+  public fun update(data: Any? = null, extras: MessageExtras? = null, listener: CompletionListener? = null)
 
   /**
-   * Leaves the presence set for the channel.
+   * Leaves the presence set for the channel, optionally passing extras.
    * A client must have previously entered the presence set before they can leave it.
    *
    * Spec: RTP10
    *
    * @param data The payload associated with the presence member.
+   * @param extras The extras associated with the presence member.
    * @param listener a listener to notify of the success or failure of the operation.
    * This listener is invoked on a background thread.
    */
-  public fun leave(data: Any? = null, listener: CompletionListener? = null)
+  public fun leave(data: Any? = null, extras: MessageExtras? = null, listener: CompletionListener? = null)
 
   /**
-   * Enters the presence set of the channel for a given clientId.
+   * Enters the presence set of the channel for a given clientId, optionally passing extras.
    * Enables a single client to update presence on behalf of any number of clients using a single connection.
    * The library must have been instantiated with an API key or a token bound to a wildcard clientId.
    *
    * Spec: RTP4, RTP14, RTP15
    *
    * @param clientId The ID of the client to enter into the presence set.
    * @param data The payload associated with the presence member.
+   * @param extras The extras associated with the presence member.
    * @param listener A callback to notify of the success or failure of the operation.
    * This listener is invoked on a background thread.
    */
-  public fun enterClient(clientId: String, data: Any? = null, listener: CompletionListener? = null)
+  public fun enterClient(clientId: String, data: Any? = null, extras: MessageExtras? = null, listener: CompletionListener? = null)
 
   /**
-   * Updates the data payload for a presence member using a given clientId.
+   * Updates the data payload for a presence member using a given clientId, optionally passing extras.
    * Enables a single client to update presence on behalf of any number of clients using a single connection.
    * The library must have been instantiated with an API key or a token bound to a wildcard clientId.
    * An optional callback may be provided to notify of the success or failure of the operation.
@@ -132,22 +137,24 @@ public interface RealtimePresence : Presence {
    *
    * @param clientId The ID of the client to update in the presence set.
    * @param data The payload to update for the presence member.
+   * @param extras The extras associated with the presence member.
    * @param listener A callback to notify of the success or failure of the operation.
    * This listener is invoked on a background thread.
    */
-  public fun updateClient(clientId: String, data: Any? = null, listener: CompletionListener? = null)
+  public fun updateClient(clientId: String, data: Any? = null, extras: MessageExtras? = null, listener: CompletionListener? = null)
 
   /**
-   * Leaves the presence set of the channel for a given clientId.
+   * Leaves the presence set of the channel for a given clientId, optionally passing extras.
    * Enables a single client to update presence on behalf of any number of clients using a single connection.
    * The library must have been instantiated with an API key or a token bound to a wildcard clientId.
    *
    * Spec: RTP15
    *
    * @param clientId The ID of the client to leave the presence set for.
    * @param data The payload associated with the presence member.
+   * @param extras The extras associated with the presence member.
    * @param listener A callback to notify of the success or failure of the operation.
    * This listener is invoked on a background thread.
    */
-  public fun leaveClient(clientId: String?, data: Any? = null, listener: CompletionListener? = null)
+  public fun leaveClient(clientId: String?, data: Any? = null, extras: MessageExtras? = null, listener: CompletionListener? = null)
 }

pubsub-adapter/src/main/kotlin/io/ably/lib/realtime/RealtimePresenceAdapter.kt

@@ -44,20 +44,23 @@ internal class RealtimePresenceAdapter(private val javaPresence: Presence) : Rea
     }
   }
 
-  override fun enter(data: Any?, listener: CompletionListener?) = javaPresence.enter(data, listener)
+  override fun enter(data: Any?, extras: MessageExtras?, listener: CompletionListener?) =
+    javaPresence.enter(data, extras, listener)
 
-  override fun update(data: Any?, listener: CompletionListener?) = javaPresence.update(data, listener)
+  override fun update(data: Any?, extras: MessageExtras?, listener: CompletionListener?) =
+    javaPresence.update(data, extras, listener)
 
-  override fun leave(data: Any?, listener: CompletionListener?) = javaPresence.leave(data, listener)
+  override fun leave(data: Any?, extras: MessageExtras?, listener: CompletionListener?) =
+    javaPresence.leave(data, extras, listener)
 
-  override fun enterClient(clientId: String, data: Any?, listener: CompletionListener?) =
-    javaPresence.enterClient(clientId, data, listener)
+  override fun enterClient(clientId: String, data: Any?, extras: MessageExtras?, listener: CompletionListener?) =
+    javaPresence.enterClient(clientId, data, extras, listener)
 
-  override fun updateClient(clientId: String, data: Any?, listener: CompletionListener?) =
-    javaPresence.updateClient(clientId, data, listener)
+  override fun updateClient(clientId: String, data: Any?, extras: MessageExtras?, listener: CompletionListener?) =
+    javaPresence.updateClient(clientId, data, extras, listener)
 
-  override fun leaveClient(clientId: String?, data: Any?, listener: CompletionListener?) =
-    javaPresence.leaveClient(clientId, data, listener)
+  override fun leaveClient(clientId: String?, data: Any?, extras: MessageExtras?, listener: CompletionListener?) =
+    javaPresence.leaveClient(clientId, data, extras, listener)
 
   override fun history(start: Long?, end: Long?, limit: Int, orderBy: OrderBy): PaginatedResult<PresenceMessage> =
     javaPresence.history(buildHistoryParams(start, end, limit, orderBy).toTypedArray())