@dittolive/ditto 4.11.2-rc.1 → 4.12.0-experimental-untangle.0

package/react-native/android/dittoffi/src/dittoffi.h

@@ -175,66 +175,7 @@ void
  *
  *  The C interface of `TransportHandle` is thread-safe (`Send + Sync`).
  */
-typedef struct TransportHandle_AwdlPlatformEvent TransportHandle_AwdlPlatformEvent_t;
-
-/** \brief
- *  Generic enum used by crate and platforms to indicate a connection status
- */
-typedef enum ConnectState {
-    /** <No documentation available> */
-    CONNECT_STATE_DISCONNECTED,
-    /** <No documentation available> */
-    CONNECT_STATE_CONNECTED,
-    /** <No documentation available> */
-    CONNECT_STATE_CONNECTING,
-    /** <No documentation available> */
-    CONNECT_STATE_DISCONNECTING,
-} ConnectState_t;
-
-/** \brief
- *  The platform advises Rust that a peer has changed its current connection
- *  status
- */
-void
-/* fn */ awdl_client_connect_state_changed (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    char const * announce,
-    ConnectState_t state);
-
-/** \brief
- *  The platform advises Rust that a complete message has been received from a
- *  remote peer
- */
-void
-/* fn */ awdl_client_data_available (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    char const * announce);
-
-/** \brief
- *  The platform advises Rust that a peer has been identified. We know only its
- *  announce string.
- */
-void
-/* fn */ awdl_client_platform_peer_appeared (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    char const * announce);
-
-/** \brief
- *  The platform advises Rust that a peer has disappeared.
- */
-void
-/* fn */ awdl_client_platform_peer_disappeared (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    char const * announce);
-
-/** \brief
- *  The platform advises Rust that a given peer is now clear to queue up a new
- *  message whenever one is ready to go
- */
-void
-/* fn */ awdl_client_ready_to_send (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    char const * announce);
+typedef struct TransportHandle_BlePlatformEvent TransportHandle_BlePlatformEvent_t;
 
 /** \brief
  *  Generic enum used by crate and platforms to indicate online-ness.
@@ -318,96 +259,6 @@ typedef enum TransportCondition {
     TRANSPORT_CONDITION_TEMPORARILY_UNAVAILABLE,
 } TransportCondition_t;
 
-/** \brief
- *  The platform advises Rust that searching status changed
- */
-void
-/* fn */ awdl_client_scanning_state_changed (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t condition);
-
-/** \brief
- *  The platform advises Rust that advertising status changed
- */
-void
-/* fn */ awdl_server_advertising_state_changed (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t condition);
-
-/** \brief
- *  The platform advises Rust that a peer has changed its current connection
- *  status
- */
-void
-/* fn */ awdl_server_connect_state_changed (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    int64_t platform_id,
-    ConnectState_t state);
-
-/** \brief
- *  The platform advises Rust that a complete message has been received from a
- *  remote peer
- */
-void
-/* fn */ awdl_server_data_available (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    int64_t platform_id);
-
-/** \brief
- *  The platform advises Rust that a peer has been identified. We know only its
- *  announce string.
- */
-void
-/* fn */ awdl_server_platform_peer_appeared (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    int64_t platform_id);
-
-/** \brief
- *  The platform advises Rust that a peer has disappeared.
- */
-void
-/* fn */ awdl_server_platform_peer_disappeared (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    int64_t platform_id);
-
-/** \brief
- *  The platform advises Rust that a given peer is now clear to queue up a new
- *  message whenever one is ready to go
- */
-void
-/* fn */ awdl_server_ready_to_send (
-    TransportHandle_AwdlPlatformEvent_t const * handle,
-    int64_t platform_id);
-
-/** \brief
- *  An opaque handle for each installed transport, heap-allocated and owned by
- *  the SDK.
- *
- *  A pointer to this handle is used to send platform events over FFI. In the
- *  future this handle will be the SDK's only point of control over the
- *  transport once created. In particular, a transport will be removed by
- *  freeing the handle. The concept of online and offline will be eliminated.
- *  (i.e., if you don't want a transport, remove it.)
- *
- *  For now, the `Peer` object holds the transports and provides an API based on
- *  a numeric id assigned to each transport instance. Until that is removed, the
- *  id still exists and the SDK can request it from the opaque handle over FFI.
- *
- *  For each transport type, define an `extern "C"` function to free that
- *  specific monomorphisation of the `TransportHandle` using `Box::from_raw`,
- *  plus a function to retrieve the transport id, which will be removed later.
- *
- *  Safety: The SDK owns the `TransportHandle`. It is responsible for ensuring
- *  that it does not use the pointer to the `TransportHandle` after freeing it
- *  with its respective function. In Rust we will assume it is okay to unsafely
- *  dereference a handle.
- *
- *  The C interface of `TransportHandle` is thread-safe (`Send + Sync`).
- */
-typedef struct TransportHandle_BlePlatformEvent TransportHandle_BlePlatformEvent_t;
-
 /** <No documentation available> */
 void
 /* fn */ ble_advertising_state_changed (
@@ -459,6 +310,20 @@ void
     TransportHandle_BlePlatformEvent_t const * handle,
     uint8_16_array_t const * central_uuid);
 
+/** \brief
+ *  Generic enum used by crate and platforms to indicate a connection status
+ */
+typedef enum ConnectState {
+    /** <No documentation available> */
+    CONNECT_STATE_DISCONNECTED,
+    /** <No documentation available> */
+    CONNECT_STATE_CONNECTED,
+    /** <No documentation available> */
+    CONNECT_STATE_CONNECTING,
+    /** <No documentation available> */
+    CONNECT_STATE_DISCONNECTING,
+} ConnectState_t;
+
 /** <No documentation available> */
 void
 /* fn */ ble_connection_state_changed (
@@ -539,6 +404,21 @@ void
 /** <No documentation available> */
 typedef struct CDitto CDitto_t;
 
+
+#include <stdbool.h>
+
+/** \brief
+ *  Rust-level representation of the result of a send operation, converted from
+ *  a bitfield
+ */
+typedef struct SendResult {
+    /** <No documentation available> */
+    bool accepted;
+
+    /** <No documentation available> */
+    bool wait_for_ready;
+} SendResult_t;
+
 /** \brief
  *  `&'lt mut [T]` but with a guaranteed `#[repr(C)]` layout.
  *
@@ -570,71 +450,6 @@ typedef struct slice_mut_uint8 {
     size_t len;
 } slice_mut_uint8_t;
 
-/** <No documentation available> */
-typedef struct AwdlClientCallbacks {
-    /** <No documentation available> */
-    void (*start_searching)(void *, char const *, char const *);
-
-    /** <No documentation available> */
-    void (*stop_searching)(void *);
-
-    /** <No documentation available> */
-    void (*request_connect)(void *, char const *);
-
-    /** <No documentation available> */
-    void (*request_disconnect)(void *, char const *);
-
-    /** <No documentation available> */
-    int32_t (*send_data)(void *, char const *, slice_ref_uint8_t);
-
-    /** <No documentation available> */
-    int32_t (*read_data)(void *, char const *, slice_mut_uint8_t);
-} AwdlClientCallbacks_t;
-
-/** <No documentation available> */
-typedef struct AwdlServerCallbacks {
-    /** <No documentation available> */
-    void (*start_advertising)(void *, char const *, char const *);
-
-    /** <No documentation available> */
-    void (*stop_advertising)(void *);
-
-    /** <No documentation available> */
-    void (*request_disconnect)(void *, int64_t);
-
-    /** <No documentation available> */
-    int32_t (*send_data)(void *, int64_t, slice_ref_uint8_t);
-
-    /** <No documentation available> */
-    int32_t (*read_data)(void *, int64_t, slice_mut_uint8_t);
-} AwdlServerCallbacks_t;
-
-/** <No documentation available> */
-TransportHandle_AwdlPlatformEvent_t *
-/* fn */ ditto_add_awdl_transport (
-    CDitto_t const * ditto,
-    AwdlClientCallbacks_t client_callbacks,
-    void * client_ctx,
-    AwdlServerCallbacks_t server_callbacks,
-    void * server_ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
-
-#include <stdbool.h>
-
-/** \brief
- *  Rust-level representation of the result of a send operation, converted from
- *  a bitfield
- */
-typedef struct SendResult {
-    /** <No documentation available> */
-    bool accepted;
-
-    /** <No documentation available> */
-    bool wait_for_ready;
-} SendResult_t;
-
 /** <No documentation available> */
 typedef struct BleClientCallbacks {
     /** <No documentation available> */
@@ -694,64 +509,6 @@ TransportHandle_BlePlatformEvent_t *
     void (*retain)(void *),
     void (*release)(void *));
 
-/** <No documentation available> */
-typedef struct MdnsClientCallbacks {
-    /** <No documentation available> */
-    void (*start_searching)(void *, char const *);
-
-    /** <No documentation available> */
-    void (*stop_searching)(void *);
-
-    /** <No documentation available> */
-    void (*resolve_service)(void *, slice_ref_uint8_t);
-} MdnsClientCallbacks_t;
-
-/** <No documentation available> */
-typedef struct MdnsServerCallbacks {
-    /** <No documentation available> */
-    void (*start_advertising)(void *, char const *, char const *, uint16_t);
-
-    /** <No documentation available> */
-    void (*stop_advertising)(void *);
-} MdnsServerCallbacks_t;
-
-/** \brief
- *  An opaque handle for each installed transport, heap-allocated and owned by
- *  the SDK.
- *
- *  A pointer to this handle is used to send platform events over FFI. In the
- *  future this handle will be the SDK's only point of control over the
- *  transport once created. In particular, a transport will be removed by
- *  freeing the handle. The concept of online and offline will be eliminated.
- *  (i.e., if you don't want a transport, remove it.)
- *
- *  For now, the `Peer` object holds the transports and provides an API based on
- *  a numeric id assigned to each transport instance. Until that is removed, the
- *  id still exists and the SDK can request it from the opaque handle over FFI.
- *
- *  For each transport type, define an `extern "C"` function to free that
- *  specific monomorphisation of the `TransportHandle` using `Box::from_raw`,
- *  plus a function to retrieve the transport id, which will be removed later.
- *
- *  Safety: The SDK owns the `TransportHandle`. It is responsible for ensuring
- *  that it does not use the pointer to the `TransportHandle` after freeing it
- *  with its respective function. In Rust we will assume it is okay to unsafely
- *  dereference a handle.
- *
- *  The C interface of `TransportHandle` is thread-safe (`Send + Sync`).
- */
-typedef struct TransportHandle_MdnsPlatformEvent TransportHandle_MdnsPlatformEvent_t;
-
-/** <No documentation available> */
-TransportHandle_MdnsPlatformEvent_t *
-/* fn */ ditto_add_mdns_discovery (
-    CDitto_t const * ditto,
-    MdnsClientCallbacks_t client_callbacks,
-    MdnsServerCallbacks_t server_callbacks,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
 /** \brief
  *  The direction to sort the results of a query.
  */
@@ -1010,17 +767,6 @@ void
     CDitto_t const * ditto,
     CLoginProvider_t * login_provider);
 
-/** \brief
- *  The SDK requests to drop its handle to the AWDL Transport
- *
- *  At some point dropping this events channel will effectively shut down and
- *  remove the Transport. At time of writing, the Transport is still owned
- *  within Peer.
- */
-void
-/* fn */ ditto_awdl_transport_free_handle (
-    TransportHandle_AwdlPlatformEvent_t * handle);
-
 /** \brief
  *  The SDK requests to drop its handle to the BLE Transport
  *
@@ -2443,17 +2189,6 @@ CDitto_t *
     CIdentityConfig_t * identity_config,
     HistoryTracking_t history_tracking);
 
-/** \brief
- *  The SDK requests to drop its handle to the mDNS transport
- *
- *  At some point dropping this events channel will effectively shut down and
- *  remove the Transport. At time of writing, the Transport is still owned
- *  within Peer.
- */
-void
-/* fn */ ditto_mdns_transport_free_handle (
-    TransportHandle_MdnsPlatformEvent_t * handle);
-
 /** <No documentation available> */
 typedef struct CAttachment {
     /** <No documentation available> */
@@ -2799,10 +2534,6 @@ typedef enum DittoSdkTransportsError {
     DITTO_SDK_TRANSPORTS_ERROR_MISSING_BLUETOOTH_INFO_PLIST_ENTRY = 3,
     /** <No documentation available> */
     DITTO_SDK_TRANSPORTS_ERROR_MISSING_BLUETOOTH_U_I_BACKGROUND_MODES_INFO_PLIST_ENTRY = 4,
-    /** <No documentation available> */
-    DITTO_SDK_TRANSPORTS_ERROR_MISSING_LOCAL_NETWORK_INFO_PLIST_ENTRY = 5,
-    /** <No documentation available> */
-    DITTO_SDK_TRANSPORTS_ERROR_MISSING_BONJOUR_SERVICES_INFO_PLIST_ENTRY = 6,
 } DittoSdkTransportsError_t;
 
 /** <No documentation available> */
@@ -3299,6 +3030,13 @@ int32_t
     CDitto_t const * _ditto,
     CWriteTransaction_t * transaction);
 
+/** \brief
+ *  Default DittoConfig id value, used by SDKs to synthesize a (rough) DittoConfig after being
+ *  built by a legacy constructor.
+ */
+char const *
+/* fn */ dittoffi_DEFAULT_DATABASE_ID (void);
+
 /** \brief
  *  This is not meant to be part of the SDK surface: it's a shared secret that SDKs use when
  *  constructing a "login provider" for development (fka "online playground").
@@ -3587,6 +3325,16 @@ dittoffi_result_dittoffi_differ_ptr_t
 /* fn */ dittoffi_differ_new_with_identity_key_paths_throws (
     slice_ref_char_const_ptr_t identity_key_paths);
 
+/** \brief
+ *  Getter for `absolute_persistence_directory`, which is the *actual* data directory used by
+ *  Ditto (it will differ from config.persistence_directory when the latter is *relative* or *nil*.)
+ *
+ *  The resulting string has to be freed with `::ditto_c_string_free`
+ */
+char *
+/* fn */ dittoffi_ditto_absolute_persistence_directory (
+    CDitto_t const * ditto);
+
 /** \brief
  *  Internal helper function to do integration testing of stacktrace generation in the SDKs.
  */
@@ -3600,6 +3348,13 @@ slice_boxed_uint8_t
 /* fn */ dittoffi_ditto_config (
     CDitto_t const * ditto);
 
+/** \brief
+ *  Returns a sensible *default* `DittoConfig` serialized as CBOR, according to the
+ *  DittoConfig.schema.json schema.
+ */
+slice_boxed_uint8_t
+/* fn */ dittoffi_ditto_config_default (void);
+
 /** <No documentation available> */
 typedef struct dittoffi_result_uint64 {
     /** \brief
@@ -3701,6 +3456,9 @@ typedef BoxDynFnMut1_void_dittoffi_result_CDitto_ptr_t continuation_dittoffi_res
  *  * `config_cbor` - `DittoConfig` serialized as CBOR, according to the DittoConfig.schema.json
  *  schema
  *
+ *  * `default_root_directory` - If the config.persistence_directory is nil or relative, this will
+ *  be used as the parent of the actual persistence directory.
+ *
  *  Nothing interesting happens in this function: it simply calls `Ditto::new` after creating a
  *  `TaskRuntime`.
  *
@@ -3710,6 +3468,7 @@ void
 /* fn */ dittoffi_ditto_open_async_throws (
     slice_ref_uint8_t config_cbor,
     TransportConfigMode_t transport_config_mode,
+    char const * default_root_directory,
     continuation_dittoffi_result_CDitto_ptr_t continuation);
 
 /** \brief
@@ -3718,6 +3477,9 @@ void
  *  * `config_cbor` - `DittoConfig` serialized as CBOR, according to the DittoConfig.schema.json
  *  schema
  *
+ *  * `default_root_directory` - If the config.persistence_directory is nil or relative, this will
+ *  be used as the parent of the actual persistence directory.
+ *
  *  Nothing interesting happens in this function: it simply calls *and blocks on* `Ditto::new` after
  *  creating a `TaskRuntime`.
  *
@@ -3726,7 +3488,8 @@ void
 dittoffi_result_CDitto_ptr_t
 /* fn */ dittoffi_ditto_open_throws (
     slice_ref_uint8_t config_cbor,
-    TransportConfigMode_t transport_config_mode);
+    TransportConfigMode_t transport_config_mode,
+    char const * default_root_directory);
 
 /** \brief
  *  `Box<dyn 'static + Send + FnMut(A1) -> Ret>`
@@ -3912,6 +3675,10 @@ typedef enum dittoffi_error_code {
      *  Activation (via setting a valid license token) is unnecessary for the active identity type.
      */
     DITTOFFI_ERROR_CODE_ACTIVATION_UNNECESSARY,
+    /** \brief
+     *  The operation failed because an authentication expiration handler has not yet been set.
+     */
+    DITTOFFI_ERROR_CODE_AUTHENTICATION_EXPIRATION_HANDLER_MISSING,
     /** \brief
      *  Invalid input provided for base64 decoding.
      */
@@ -3940,7 +3707,7 @@ typedef enum dittoffi_error_code {
      *  Failed to compile the given query.
      *
      *  For more information on Ditto's query language see:
-     *  <https://docs.ditto.live/dql-guide>
+     *  <https://ditto.com/link/dql-guide>
      */
     DITTOFFI_ERROR_CODE_DQL_QUERY_COMPILATION,
     /** \brief
@@ -4030,6 +3797,10 @@ typedef enum dittoffi_error_code {
      *  Invalid TransportConfig.
      */
     DITTOFFI_ERROR_CODE_VALIDATION_INVALID_TRANSPORT_CONFIG,
+    /** \brief
+     *  Invalid DittoConfig.
+     */
+    DITTOFFI_ERROR_CODE_VALIDATION_INVALID_DITTO_CONFIG,
     /** \brief
      *  The value was not a map.
      */
@@ -4039,7 +3810,6 @@ typedef enum dittoffi_error_code {
      */
     DITTOFFI_ERROR_CODE_VALIDATION_SIZE_LIMIT_EXCEEDED,
     /** \brief
-     *  Attempted to use a Ditto feature after closing Ditto.
      *  An unknown error occurred.
      */
     DITTOFFI_ERROR_CODE_UNKNOWN,
@@ -4152,6 +3922,49 @@ char *
 /* fn */ dittoffi_panic_stack_trace_string (
     dittoffi_panic_t const * panic);
 
+/** \brief
+ *  Returns the current presence graph as a JSON string in a UTF-8 encoded byte array.
+ */
+slice_boxed_uint8_t
+/* fn */ dittoffi_presence_graph (
+    CDitto_t const * ditto);
+
+/** \brief
+ *  An opaque handle to a presence observer.
+ *
+ *  - Use [`dittoffi_presence_register_observer_throws`] to create a new observer.
+ *  - Use [`dittoffi_presence_observer_cancel`] to cancel an observer.
+ */
+typedef struct dittoffi_presence_observer dittoffi_presence_observer_t;
+
+/** \brief
+ *  Cancels the presence observer.
+ */
+void
+/* fn */ dittoffi_presence_observer_cancel (
+    dittoffi_presence_observer_t const * observer);
+
+/** \brief
+ *  Free a boxed `FfiPresenceObserver`.
+ */
+void
+/* fn */ dittoffi_presence_observer_free (
+    dittoffi_presence_observer_t * observer);
+
+/** \brief
+ *  Returns the ID of the presence observer.
+ */
+slice_boxed_uint8_t
+/* fn */ dittoffi_presence_observer_id (
+    dittoffi_presence_observer_t const * observer);
+
+/** \brief
+ *  Checks whether the presence observer is cancelled.
+ */
+bool
+/* fn */ dittoffi_presence_observer_is_cancelled (
+    dittoffi_presence_observer_t const * observer);
+
 /** \brief
  *  Getter for the `peer_metadata` as a JSON (string / UTF-8 data).
  */
@@ -4159,6 +3972,47 @@ slice_boxed_uint8_t
 /* fn */ dittoffi_presence_peer_metadata_json (
     CDitto_t const * ditto);
 
+/** \brief
+ *  `Box<dyn 'static + Send + FnMut(A1) -> Ret>`
+ */
+typedef struct BoxDynFnMut1_void_slice_boxed_uint8 {
+    /** <No documentation available> */
+    void * env_ptr;
+
+    /** <No documentation available> */
+    void (*call)(void *, slice_boxed_uint8_t);
+
+    /** <No documentation available> */
+    void (*free)(void *);
+} BoxDynFnMut1_void_slice_boxed_uint8_t;
+
+/** <No documentation available> */
+typedef struct dittoffi_result_dittoffi_presence_observer_ptr {
+    /** \brief
+     *  Non-`NULL` pointer to opaque object on error, `NULL` otherwise.
+     */
+    dittoffi_error_t * error;
+
+    /** \brief
+     *  When no error occurred, the success value payload can be retrieved here.
+     *
+     *  Otherwise, the value is to be ignored.
+     */
+    dittoffi_presence_observer_t * success;
+} dittoffi_result_dittoffi_presence_observer_ptr_t;
+
+/** \brief
+ *  Registers a new [`FfiPresenceObserver`].
+ *
+ *  This will call the provided callback whenever the presence graph changes.
+ *
+ *  To cancel the observer, use [`dittoffi_presence_observer_cancel`].
+ */
+dittoffi_result_dittoffi_presence_observer_ptr_t
+/* fn */ dittoffi_presence_register_observer_throws (
+    CDitto_t const * ditto,
+    BoxDynFnMut1_void_slice_boxed_uint8_t callback);
+
 /** <No documentation available> */
 typedef struct Erased Erased_t;
 
@@ -4200,6 +4054,12 @@ void
  *  The `peer_info` is expected to represent the UTF-8 bytes of a serialized JSON instead of CBOR.
  */
 dittoffi_result_void_t
+/* fn */ dittoffi_presence_set_peer_metadata_json_throws (
+    CDitto_t const * ditto,
+    slice_ref_uint8_t peer_info);
+
+/** <No documentation available> */
+dittoffi_result_void_t
 /* fn */ dittoffi_presence_try_set_peer_metadata_json (
     CDitto_t const * ditto,
     slice_ref_uint8_t peer_info);
@@ -4207,11 +4067,32 @@ dittoffi_result_void_t
 /** <No documentation available> */
 typedef struct dittoffi_query_result dittoffi_query_result_t;
 
+/** \brief
+ *  Returns the commit ID for this query result, or zero if there is none.
+ *
+ *  SDK implementations should generally call [`dittoffi_query_result_has_commit_id()`] first, and
+ *  return the appropriate language specific "no value" value if that function returns false.
+ */
+uint64_t
+/* fn */ dittoffi_query_result_commit_id (
+    dittoffi_query_result_t const * result);
+
 /** <No documentation available> */
 void
 /* fn */ dittoffi_query_result_free (
     dittoffi_query_result_t * result);
 
+/** \brief
+ *  Indicates whether this query result has a commit ID.
+ *
+ *  SDK implementations should generally call this function before calling
+ *  [`dittoffi_query_result_commit_id()`], and return the appropriate language specific
+ *  "no value" value if this function returns false.
+ */
+bool
+/* fn */ dittoffi_query_result_has_commit_id (
+    dittoffi_query_result_t const * result);
+
 /** <No documentation available> */
 dittoffi_query_result_item_t *
 /* fn */ dittoffi_query_result_item_at (
@@ -5133,68 +5014,6 @@ dittoffi_result_void_t
     CDitto_t const * ditto,
     char const * license);
 
-/** \brief
- *  The platform advises Rust that the status of publishing our service has
- *  changed.
- */
-void
-/* fn */ mdns_advertising_state_changed (
-    TransportHandle_MdnsPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t condition);
-
-/** \brief
- *  The platform advises Rust that a peer has been identified.
- */
-void
-/* fn */ mdns_platform_peer_appeared (
-    TransportHandle_MdnsPlatformEvent_t const * handle,
-    char const * announce_string);
-
-/** \brief
- *  The platform advises Rust that a peer's service has disappeared from mDNS.
- */
-void
-/* fn */ mdns_platform_peer_disappeared (
-    TransportHandle_MdnsPlatformEvent_t const * handle,
-    char const * announce_string);
-
-/** \brief
- *  The platform advises Rust that the status of searching for services has
- *  changed.
- */
-void
-/* fn */ mdns_scanning_state_changed (
-    TransportHandle_MdnsPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t condition);
-
-/** \brief
- *  The platform advises Rust that the TCP listener will need to be restarted.
- */
-void
-/* fn */ mdns_server_invalidate_listener (
-    TransportHandle_MdnsPlatformEvent_t const * handle);
-
-/** \brief
- *  The platform advises Rust that we failed to resolve a peer's hostname and
- *  port
- */
-void
-/* fn */ mdns_service_did_not_resolve (
-    TransportHandle_MdnsPlatformEvent_t const * handle,
-    char const * announce_string);
-
-/** \brief
- *  The platform advises Rust that we have resolved a peer's hostname and port
- */
-void
-/* fn */ mdns_service_did_resolve (
-    TransportHandle_MdnsPlatformEvent_t const * handle,
-    char const * announce_string,
-    char const * hostname,
-    uint16_t port);
-
 
 #ifdef __cplusplus
 } /* extern \"C\" */