Add placeholder for spec's #publish method

Based on [1] at cb11ba8. Implementation deferred to #47.

[1] ably/specification#353

Author: lawrence-forooghian

Sources/AblyLiveObjects/Internal/CoreSDK.swift

@@ -5,7 +5,8 @@ internal import AblyPlugin
 ///
 /// This provides us with a mockable interface to ably-cocoa, and it also allows internal components and their tests not to need to worry about some of the boring details of how we bridge Swift types to AblyPlugin's Objective-C API (i.e. boxing).
 internal protocol CoreSDK: AnyObject, Sendable {
-    func sendObject(objectMessages: [OutboundObjectMessage]) async throws(InternalError)
+    /// Implements the internal `#publish` method of RTO15.
+    func publish(objectMessages: [OutboundObjectMessage]) async throws(InternalError)
 
     /// Returns the current state of the Realtime channel that this wraps.
     var channelState: ARTRealtimeChannelState { get }
@@ -28,7 +29,8 @@ internal final class DefaultCoreSDK: CoreSDK {
 
     // MARK: - CoreSDK conformance
 
-    internal func sendObject(objectMessages: [OutboundObjectMessage]) async throws(InternalError) {
+    internal func publish(objectMessages: [OutboundObjectMessage]) async throws(InternalError) {
+        // TODO: Implement the full spec of RTO15 (https://github.com/ably/ably-cocoa-liveobjects-plugin/issues/47)
         try await DefaultInternalPlugin.sendObject(
             objectMessages: objectMessages,
             channel: channel,

Sources/AblyLiveObjects/Internal/InternalDefaultRealtimeObjects.swift

@@ -206,8 +206,8 @@ internal final class InternalDefaultRealtimeObjects: Sendable, LiveMapObjectPool
     // MARK: - Sending `OBJECT` ProtocolMessage
 
     // This is currently exposed so that we can try calling it from the tests in the early days of the SDK to check that we can send an OBJECT ProtocolMessage. We'll probably make it private later on.
-    internal func testsOnly_sendObject(objectMessages: [OutboundObjectMessage], coreSDK: CoreSDK) async throws(InternalError) {
-        try await coreSDK.sendObject(objectMessages: objectMessages)
+    internal func testsOnly_publish(objectMessages: [OutboundObjectMessage], coreSDK: CoreSDK) async throws(InternalError) {
+        try await coreSDK.publish(objectMessages: objectMessages)
     }
 
     // MARK: - Testing

Sources/AblyLiveObjects/Public/Public Proxy Objects/PublicDefaultRealtimeObjects.swift

@@ -75,8 +75,8 @@ internal final class PublicDefaultRealtimeObjects: RealtimeObjects {
         proxied.testsOnly_receivedObjectProtocolMessages
     }
 
-    internal func testsOnly_sendObject(objectMessages: [OutboundObjectMessage]) async throws(InternalError) {
-        try await proxied.testsOnly_sendObject(objectMessages: objectMessages, coreSDK: coreSDK)
+    internal func testsOnly_publish(objectMessages: [OutboundObjectMessage]) async throws(InternalError) {
+        try await proxied.testsOnly_publish(objectMessages: objectMessages, coreSDK: coreSDK)
     }
 
     internal var testsOnly_receivedObjectSyncProtocolMessages: AsyncStream<[InboundObjectMessage]> {

Tests/AblyLiveObjectsTests/AblyLiveObjectsTests.swift

@@ -90,7 +90,7 @@ struct AblyLiveObjectsTests {
         // (This objectId comes from copying that which was given in an expected value in an error message from Realtime)
         let realtimeCreatedMapObjectID = "map:iC4Nq8EbTSEmw-_tDJdVV8HfiBvJGpZmO_WbGbh0_-4@\(currentAblyTimestamp)"
 
-        try await channel.testsOnly_nonTypeErasedObjects.testsOnly_sendObject(objectMessages: [
+        try await channel.testsOnly_nonTypeErasedObjects.testsOnly_publish(objectMessages: [
             OutboundObjectMessage(
                 operation: .init(
                     action: .known(.mapCreate),
@@ -110,7 +110,7 @@ struct AblyLiveObjectsTests {
         // 7. Now, send an invalid OBJECT ProtocolMessage to check that ably-cocoa correctly reports on its NACK.
         let invalidObjectThrownError = try await #require(throws: ARTErrorInfo.self) {
             do throws(InternalError) {
-                try await channel.testsOnly_nonTypeErasedObjects.testsOnly_sendObject(objectMessages: [
+                try await channel.testsOnly_nonTypeErasedObjects.testsOnly_publish(objectMessages: [
                     .init(),
                 ])
             } catch {

Tests/AblyLiveObjectsTests/Mocks/MockCoreSDK.swift

@@ -11,7 +11,7 @@ final class MockCoreSDK: CoreSDK {
         _channelState = channelState
     }
 
-    func sendObject(objectMessages _: [AblyLiveObjects.OutboundObjectMessage]) async throws(AblyLiveObjects.InternalError) {
+    func publish(objectMessages _: [AblyLiveObjects.OutboundObjectMessage]) async throws(AblyLiveObjects.InternalError) {
         protocolRequirementNotImplemented()
     }