@dittolive/ditto 4.8.2 → 4.9.0-alpha.1

package/react-native/dittoffi/dittoffi.h

@@ -1,4872 +0,0 @@
-/*! \file */
-/*******************************************
- *                                         *
- *  File auto-generated by `::safer_ffi`.  *
- *                                         *
- *  Do not manually edit this file.        *
- *                                         *
- *******************************************/
-
-#ifndef __RUST_DITTOFFI__
-#define __RUST_DITTOFFI__
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/** <No documentation available> */
-#define DITTOFFI_PRESENCE_PEER_METADATA_MAX_SIZE_IN_BYTES ((uint32_t) 4096)
-
-
-#include <stddef.h>
-#include <stdint.h>
-
-/** \brief
- *  This enum contains all the Ditto types exposed publicly. The IDs **MUST**
- *  not be modified otherwise this would break the type conversions.
- *
- *  CHECKME: When merging with Russell's work on explicit types, this enum may
- *  be duplicated.
- */
-typedef enum DittoCrdtType {
-    /** <No documentation available> */
-    DITTO_CRDT_TYPE_COUNTER = 0,
-    /** <No documentation available> */
-    DITTO_CRDT_TYPE_REGISTER = 1,
-    /** <No documentation available> */
-    DITTO_CRDT_TYPE_ATTACHMENT = 2,
-    /** <No documentation available> */
-    DITTO_CRDT_TYPE_RGA = 3,
-    /** <No documentation available> */
-    DITTO_CRDT_TYPE_R_W_MAP = 4,
-    /** <No documentation available> */
-    DITTO_CRDT_TYPE_ST_COUNTER = 5,
-    /** <No documentation available> */
-    DITTO_CRDT_TYPE_A_W_SET = 6,
-} DittoCrdtType_t;
-
-/** \brief
- *  A short-lived FFI object to let an SDK handle an authentication request
- *  in an async manner.
- */
-typedef struct CAuthServerAuthRequest CAuthServerAuthRequest_t;
-
-/** <No documentation available> */
-void
-/* fn */ auth_server_auth_submit_with_error (
-    CAuthServerAuthRequest_t * req,
-    uint32_t _error_code);
-
-/** \brief
- *  `&'lt [T]` but with a guaranteed `#[repr(C)]` layout.
- *
- *  # C layout (for some given type T)
- *
- *  ```c
- *  typedef struct {
- *  // Cannot be NULL
- *  T * ptr;
- *  size_t len;
- *  } slice_T;
- *  ```
- *
- *  # Nullable pointer?
- *
- *  If you want to support the above typedef, but where the `ptr` field is
- *  allowed to be `NULL` (with the contents of `len` then being undefined)
- *  use the `Option< slice_ptr<_> >` type.
- */
-typedef struct slice_ref_uint8 {
-    /** \brief
-     *  Pointer to the first element (if any).
-     */
-    uint8_t const * ptr;
-
-    /** \brief
-     *  Element count
-     */
-    size_t len;
-} slice_ref_uint8_t;
-
-/** <No documentation available> */
-void
-/* fn */ auth_server_auth_submit_with_success (
-    CAuthServerAuthRequest_t * req,
-    slice_ref_uint8_t success_cbor);
-
-/** <No documentation available> */
-typedef struct CAuthServerRefreshRequest CAuthServerRefreshRequest_t;
-
-/** <No documentation available> */
-void
-/* fn */ auth_server_refresh_submit_with_error (
-    CAuthServerRefreshRequest_t * req,
-    uint32_t _error_code);
-
-/** <No documentation available> */
-void
-/* fn */ auth_server_refresh_submit_with_success (
-    CAuthServerRefreshRequest_t * req,
-    slice_ref_uint8_t success_cbor);
-
-/** \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_AwdlClientPlatformEvent TransportHandle_AwdlClientPlatformEvent_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_AwdlClientPlatformEvent_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_AwdlClientPlatformEvent_t const * handle,
-    char const * announce);
-
-/** \brief
- *  The SDK requests to drop its handle to the AWDL Client 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 */ awdl_client_free_handle (
-    TransportHandle_AwdlClientPlatformEvent_t * handle);
-
-/** \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_AwdlClientPlatformEvent_t const * handle,
-    char const * announce);
-
-/** \brief
- *  The platform advises Rust that a peer has disappeared.
- */
-void
-/* fn */ awdl_client_platform_peer_disappeared (
-    TransportHandle_AwdlClientPlatformEvent_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_AwdlClientPlatformEvent_t const * handle,
-    char const * announce);
-
-/** \brief
- *  Generic enum used by crate and platforms to indicate online-ness.
- *
- *  In other words, is something active or not? Not everything will use the
- *  transitional states.
- */
-typedef enum OnlineState {
-    /** <No documentation available> */
-    ONLINE_STATE_OFFLINE,
-    /** <No documentation available> */
-    ONLINE_STATE_ONLINE,
-    /** <No documentation available> */
-    ONLINE_STATE_GOING_ONLINE,
-    /** <No documentation available> */
-    ONLINE_STATE_GOING_OFFLINE,
-} OnlineState_t;
-
-/** \brief
- *  A code reported by platforms/transports to indicate specific health
- *  conditions
- */
-typedef enum TransportCondition {
-    /** \brief
-     *  A default state. Only use this for transient conditions, e.g., we are
-     *  waiting for a platform to finish starting up. If everything is just
-     *  quiet, use `Ok`.
-     */
-    TRANSPORT_CONDITION_UNKNOWN,
-    /** \brief
-     *  No known problems.
-     */
-    TRANSPORT_CONDITION_OK,
-    /** \brief
-     *  Catch-all failure, particularly for unexpected/internal faults. If
-     *  possible, add a new case that the customer will be able to
-     *  interpret.
-     */
-    TRANSPORT_CONDITION_GENERIC_FAILURE,
-    /** \brief
-     *  App is in background.
-     */
-    TRANSPORT_CONDITION_APP_IN_BACKGROUND,
-    /** \brief
-     *  We are not able to publish or discover with the mDNS daemon.
-     */
-    TRANSPORT_CONDITION_MDNS_FAILURE,
-    /** \brief
-     *  We cannot bind to a port.
-     */
-    TRANSPORT_CONDITION_TCP_LISTEN_FAILURE,
-    /** \brief
-     *  No app permission to act as a BLE Central.
-     */
-    TRANSPORT_CONDITION_NO_BLE_CENTRAL_PERMISSION,
-    /** \brief
-     *  No app permission to act as a BLE Peripheral.
-     */
-    TRANSPORT_CONDITION_NO_BLE_PERIPHERAL_PERMISSION,
-    /** \brief
-     *  This Transport targets a particular peer and we can't reach them right
-     *  now.
-     */
-    TRANSPORT_CONDITION_CANNOT_ESTABLISH_CONNECTION,
-    /** \brief
-     *  The device has Bluetooth disabled at the OS level.
-     */
-    TRANSPORT_CONDITION_BLE_DISABLED,
-    /** \brief
-     *  The device has no Bluetooth hardware.
-     */
-    TRANSPORT_CONDITION_NO_BLE_HARDWARE,
-    /** \brief
-     *  The device has Wifi disabled at the OS level.
-     */
-    TRANSPORT_CONDITION_WIFI_DISABLED,
-    /** \brief
-     *  The platform has suspended briefly for internal reasons. Peers are
-     *  reset.
-     */
-    TRANSPORT_CONDITION_TEMPORARILY_UNAVAILABLE,
-} TransportCondition_t;
-
-/** \brief
- *  The platform advises Rust that searching status changed
- */
-void
-/* fn */ awdl_client_scanning_state_changed (
-    TransportHandle_AwdlClientPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t condition);
-
-/** \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_AwdlServerPlatformEvent TransportHandle_AwdlServerPlatformEvent_t;
-
-/** \brief
- *  The platform advises Rust that advertising status changed
- */
-void
-/* fn */ awdl_server_advertising_state_changed (
-    TransportHandle_AwdlServerPlatformEvent_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_AwdlServerPlatformEvent_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_AwdlServerPlatformEvent_t const * handle,
-    int64_t platform_id);
-
-/** \brief
- *  The SDK requests to drop its handle to the AWDL Server 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 */ awdl_server_free_handle (
-    TransportHandle_AwdlServerPlatformEvent_t * handle);
-
-/** \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_AwdlServerPlatformEvent_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_AwdlServerPlatformEvent_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_AwdlServerPlatformEvent_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_BleClientPlatformEvent TransportHandle_BleClientPlatformEvent_t;
-
-typedef struct {
-    uint8_t idx[16];
-} uint8_16_array_t;
-
-/** <No documentation available> */
-void
-/* fn */ ble_advertisement_heard (
-    TransportHandle_BleClientPlatformEvent_t const * handle,
-    uint8_16_array_t const * peripheral_uuid,
-    slice_ref_uint8_t local_name,
-    float rssi);
-
-/** \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_BleServerPlatformEvent TransportHandle_BleServerPlatformEvent_t;
-
-/** <No documentation available> */
-void
-/* fn */ ble_advertising_state_changed (
-    TransportHandle_BleServerPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t result);
-
-/** <No documentation available> */
-void
-/* fn */ ble_central_finished_connecting (
-    TransportHandle_BleServerPlatformEvent_t const * handle,
-    uint8_16_array_t const * uuid,
-    slice_ref_uint8_t announce,
-    int32_t l2cap_available,
-    uint32_t mtu);
-
-/** <No documentation available> */
-void
-/* fn */ ble_central_l2cap_data_available (
-    TransportHandle_BleServerPlatformEvent_t const * handle,
-    uint8_16_array_t const * uuid);
-
-/** <No documentation available> */
-void
-/* fn */ ble_central_l2cap_ready_to_send (
-    TransportHandle_BleServerPlatformEvent_t const * handle,
-    uint8_16_array_t const * uuid);
-
-/** <No documentation available> */
-void
-/* fn */ ble_central_mtu_updated (
-    TransportHandle_BleServerPlatformEvent_t const * handle,
-    uint8_16_array_t const * uuid,
-    uint32_t mtu);
-
-/** <No documentation available> */
-void
-/* fn */ ble_central_ready_to_send (
-    TransportHandle_BleServerPlatformEvent_t const * handle,
-    uint8_16_array_t const * uuid);
-
-/** <No documentation available> */
-void
-/* fn */ ble_central_unsubscribed (
-    TransportHandle_BleServerPlatformEvent_t const * handle,
-    uint8_16_array_t const * central_uuid);
-
-/** \brief
- *  The SDK requests to drop its handle to the BLE Client 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 */ ble_client_free_handle (
-    TransportHandle_BleClientPlatformEvent_t * handle);
-
-/** <No documentation available> */
-void
-/* fn */ ble_connection_state_changed (
-    TransportHandle_BleClientPlatformEvent_t const * handle,
-    uint8_16_array_t const * peripheral_uuid,
-    ConnectState_t state,
-    int32_t l2cap_available,
-    uint32_t mtu);
-
-/** <No documentation available> */
-void
-/* fn */ ble_peripheral_l2cap_data_available (
-    TransportHandle_BleClientPlatformEvent_t const * handle,
-    uint8_16_array_t const * uuid);
-
-/** <No documentation available> */
-void
-/* fn */ ble_peripheral_l2cap_ready_to_send (
-    TransportHandle_BleClientPlatformEvent_t const * handle,
-    uint8_16_array_t const * uuid);
-
-/** <No documentation available> */
-void
-/* fn */ ble_peripheral_mtu_updated (
-    TransportHandle_BleClientPlatformEvent_t const * handle,
-    uint8_16_array_t const * uuid,
-    uint32_t mtu);
-
-/** <No documentation available> */
-void
-/* fn */ ble_peripheral_ready_to_send (
-    TransportHandle_BleClientPlatformEvent_t const * handle,
-    uint8_16_array_t const * uuid);
-
-/** \brief
- *  When receiving data from a Bluetooth LE peer, such as a characteristic
- *  write, indicates what sort of data it is.
- */
-typedef enum BleDataType {
-    /** \brief
-     *  The data _should_ contain the remote peer's announce string.
-     *  Used during handshake.
-     */
-    BLE_DATA_TYPE_ANNOUNCE = 0,
-    /** \brief
-     *  Data message
-     */
-    BLE_DATA_TYPE_MESH_DATA = 1,
-    /** \brief
-     *  Control message
-     */
-    BLE_DATA_TYPE_CONTROL = 2,
-} BleDataType_t;
-
-/** <No documentation available> */
-void
-/* fn */ ble_received_from_central (
-    TransportHandle_BleServerPlatformEvent_t const * handle,
-    uint8_16_array_t const * central_uuid,
-    BleDataType_t data_type,
-    slice_ref_uint8_t data);
-
-/** <No documentation available> */
-void
-/* fn */ ble_received_from_peripheral (
-    TransportHandle_BleClientPlatformEvent_t const * handle,
-    uint8_16_array_t const * peripheral_uuid,
-    BleDataType_t data_type,
-    slice_ref_uint8_t data);
-
-/** <No documentation available> */
-void
-/* fn */ ble_scanning_state_changed (
-    TransportHandle_BleClientPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t result);
-
-/** \brief
- *  The SDK requests to drop its handle to the BLE Server 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 */ ble_server_free_handle (
-    TransportHandle_BleServerPlatformEvent_t * handle);
-
-/** <No documentation available> */
-typedef struct CDitto CDitto_t;
-
-/** \brief
- *  `&'lt mut [T]` but with a guaranteed `#[repr(C)]` layout.
- *
- *  # C layout (for some given type T)
- *
- *  ```c
- *  typedef struct {
- *  // Cannot be NULL
- *  T * ptr;
- *  size_t len;
- *  } slice_T;
- *  ```
- *
- *  # Nullable pointer?
- *
- *  If you want to support the above typedef, but where the `ptr` field is
- *  allowed to be `NULL` (with the contents of `len` then being undefined)
- *  use the `Option< slice_ptr<_> >` type.
- */
-typedef struct slice_mut_uint8 {
-    /** \brief
-     *  Pointer to the first element (if any).
-     */
-    uint8_t * ptr;
-
-    /** \brief
-     *  Element count
-     */
-    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> */
-TransportHandle_AwdlClientPlatformEvent_t *
-/* fn */ ditto_add_awdl_client_transport (
-    CDitto_t const * ditto,
-    AwdlClientCallbacks_t callbacks,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
-/** <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_AwdlServerPlatformEvent_t *
-/* fn */ ditto_add_awdl_server_transport (
-    CDitto_t const * ditto,
-    AwdlServerCallbacks_t callbacks,
-    void * 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> */
-    void (*start_scanning)(void *, uint8_16_array_t const *, slice_ref_uint8_t);
-
-    /** <No documentation available> */
-    void (*stop_scanning)(void *);
-
-    /** <No documentation available> */
-    OnlineState_t (*scanning_state)(void *);
-
-    /** <No documentation available> */
-    void (*connect_peripheral)(void *, uint8_16_array_t const *);
-
-    /** <No documentation available> */
-    void (*disconnect_peripheral)(void *, uint8_16_array_t const *);
-
-    /** <No documentation available> */
-    SendResult_t (*write_to_peripheral)(void *, BleDataType_t, uint8_16_array_t const *, slice_ref_uint8_t);
-
-    /** <No documentation available> */
-    bool (*app_is_in_foreground)(void *);
-
-    /** <No documentation available> */
-    int32_t (*read_l2cap_from_peripheral)(void *, uint8_16_array_t const *, slice_mut_uint8_t);
-
-    /** <No documentation available> */
-    int32_t (*send_l2cap_to_peripheral)(void *, uint8_16_array_t const *, slice_ref_uint8_t);
-} BleClientCallbacks_t;
-
-/** <No documentation available> */
-TransportHandle_BleClientPlatformEvent_t *
-/* fn */ ditto_add_ble_client_transport (
-    CDitto_t const * ditto,
-    BleClientCallbacks_t callbacks,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
-/** <No documentation available> */
-typedef struct BleServerCallbacks {
-    /** <No documentation available> */
-    void (*start_advertising)(void *, uint8_16_array_t const *, slice_ref_uint8_t);
-
-    /** <No documentation available> */
-    void (*stop_advertising)(void *);
-
-    /** <No documentation available> */
-    OnlineState_t (*advertising_state)(void *);
-
-    /** <No documentation available> */
-    SendResult_t (*notify_to_central)(void *, BleDataType_t, uint8_16_array_t const *, slice_ref_uint8_t);
-
-    /** <No documentation available> */
-    bool (*app_is_in_foreground)(void *);
-
-    /** <No documentation available> */
-    int32_t (*read_l2cap_from_central)(void *, uint8_16_array_t const *, slice_mut_uint8_t);
-
-    /** <No documentation available> */
-    int32_t (*send_l2cap_to_central)(void *, uint8_16_array_t const *, slice_ref_uint8_t);
-} BleServerCallbacks_t;
-
-/** <No documentation available> */
-TransportHandle_BleServerPlatformEvent_t *
-/* fn */ ditto_add_ble_server_transport (
-    CDitto_t const * ditto,
-    BleServerCallbacks_t callbacks,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
-/** \brief
- *  Requested reliability level for a message to be transmitted to another peer.
- *
- *  Related to Link's
- *  [`StreamReliability`](`::ditto_link::protocol::StreamReliability`).
- */
-typedef enum ReliabilityMode {
-    /** \brief
-     *  No guarantees of successful delivery, ordering, or once-only delivery
-     */
-    RELIABILITY_MODE_UNRELIABLE,
-    /** \brief
-     *  Messages will be delivered at most once, in the same order that they are sent,
-     *  but there may be gaps.
-     */
-    RELIABILITY_MODE_UNRELIABLE_SEQUENCED,
-    /** \brief
-     *  Every message will be delivered in order or else the connection fails
-     */
-    RELIABILITY_MODE_RELIABLE,
-} ReliabilityMode_t;
-
-/** \brief
- *  FFI version of CompletionReason
- */
-typedef enum BusCompletionReason {
-    /** <No documentation available> */
-    BUS_COMPLETION_REASON_CLOSED_BY_REMOTE,
-    /** <No documentation available> */
-    BUS_COMPLETION_REASON_CLOSED_BY_LOCAL,
-} BusCompletionReason_t;
-
-/** \brief
- *  FFI mapping of SingleSendError results
- */
-typedef enum BusSingleSendResult {
-    /** <No documentation available> */
-    BUS_SINGLE_SEND_RESULT_OK,
-    /** <No documentation available> */
-    BUS_SINGLE_SEND_RESULT_PAYLOAD_TOO_LARGE,
-    /** <No documentation available> */
-    BUS_SINGLE_SEND_RESULT_QUEUE_FULL,
-    /** <No documentation available> */
-    BUS_SINGLE_SEND_RESULT_STREAM_FAILED,
-} BusSingleSendResult_t;
-
-/** <No documentation available> */
-typedef struct BusCallbacks {
-    /** <No documentation available> */
-    void (*new_incoming_stream)(void *, uint64_t, slice_ref_uint8_t, ReliabilityMode_t, uint64_t);
-
-    /** <No documentation available> */
-    void (*stream_open_succeeded)(void *, uint64_t, ReliabilityMode_t, uint64_t);
-
-    /** <No documentation available> */
-    void (*stream_open_failed)(void *, uint64_t);
-
-    /** <No documentation available> */
-    void (*stream_send_completed)(void *, uint64_t, uint32_t, uint64_t);
-
-    /** <No documentation available> */
-    void (*stream_closed)(void *, uint64_t, BusCompletionReason_t);
-
-    /** <No documentation available> */
-    void (*stream_incoming_message)(void *, uint64_t, slice_ref_uint8_t);
-
-    /** <No documentation available> */
-    void (*stream_remote_ack)(void *, uint64_t, uint64_t);
-
-    /** <No documentation available> */
-    void (*single_message_received)(void *, uint64_t, slice_ref_uint8_t, slice_ref_uint8_t);
-
-    /** <No documentation available> */
-    void (*finished_sending_single_message)(void *, uint64_t, ReliabilityMode_t, BusSingleSendResult_t);
-} BusCallbacks_t;
-
-/** <No documentation available> */
-void
-/* fn */ ditto_add_bus (
-    CDitto_t const * ditto,
-    BusCallbacks_t callbacks,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
-/** <No documentation available> */
-TransportHandle_BleClientPlatformEvent_t *
-/* fn */ ditto_add_internal_ble_client_transport (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-TransportHandle_BleServerPlatformEvent_t *
-/* fn */ ditto_add_internal_ble_server_transport (
-    CDitto_t const * ditto);
-
-/** \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_MdnsClientPlatformEvent TransportHandle_MdnsClientPlatformEvent_t;
-
-/** <No documentation available> */
-TransportHandle_MdnsClientPlatformEvent_t *
-/* fn */ ditto_add_internal_mdns_client_transport (
-    CDitto_t const * ditto);
-
-/** \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_MdnsServerPlatformEvent TransportHandle_MdnsServerPlatformEvent_t;
-
-/** <No documentation available> */
-TransportHandle_MdnsServerPlatformEvent_t *
-/* fn */ ditto_add_internal_mdns_server_transport (
-    CDitto_t const * ditto);
-
-/** <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> */
-TransportHandle_MdnsClientPlatformEvent_t *
-/* fn */ ditto_add_mdns_client_transport (
-    CDitto_t const * ditto,
-    MdnsClientCallbacks_t callbacks,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
-/** <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;
-
-/** <No documentation available> */
-TransportHandle_MdnsServerPlatformEvent_t *
-/* fn */ ditto_add_mdns_server_transport (
-    CDitto_t const * ditto,
-    MdnsServerCallbacks_t callbacks,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
-/** <No documentation available> */
-void
-/* fn */ ditto_add_multicast_transport (
-    CDitto_t const * ditto);
-
-/** \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_StaticTcpClientPlatformEvent TransportHandle_StaticTcpClientPlatformEvent_t;
-
-/** <No documentation available> */
-TransportHandle_StaticTcpClientPlatformEvent_t *
-/* fn */ ditto_add_static_tcp_client (
-    CDitto_t const * ditto,
-    char const * address);
-
-/** \brief
- *  The direction to sort the results of a query.
- */
-typedef enum QuerySortDirection {
-    /** <No documentation available> */
-    QUERY_SORT_DIRECTION_ASCENDING = 1,
-    /** <No documentation available> */
-    QUERY_SORT_DIRECTION_DESCENDING,
-} QuerySortDirection_t;
-
-/** \brief
- *  OrderBy Parameter
- */
-typedef struct COrderByParam {
-    /** <No documentation available> */
-    char const * query_c_str;
-
-    /** <No documentation available> */
-    QuerySortDirection_t direction;
-} COrderByParam_t;
-
-/** \brief
- *  `&'lt [T]` but with a guaranteed `#[repr(C)]` layout.
- *
- *  # C layout (for some given type T)
- *
- *  ```c
- *  typedef struct {
- *  // Cannot be NULL
- *  T * ptr;
- *  size_t len;
- *  } slice_T;
- *  ```
- *
- *  # Nullable pointer?
- *
- *  If you want to support the above typedef, but where the `ptr` field is
- *  allowed to be `NULL` (with the contents of `len` then being undefined)
- *  use the `Option< slice_ptr<_> >` type.
- */
-typedef struct slice_ref_COrderByParam {
-    /** \brief
-     *  Pointer to the first element (if any).
-     */
-    COrderByParam_t const * ptr;
-
-    /** \brief
-     *  Element count
-     */
-    size_t len;
-} slice_ref_COrderByParam_t;
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_add_subscription (
-    CDitto_t const * ditto,
-    char const * collection,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by,
-    int32_t limit,
-    uint32_t offset);
-
-/** <No documentation available> */
-typedef struct LegacySubscriptionHandle LegacySubscriptionHandle_t;
-
-/** <No documentation available> */
-typedef struct LegacySubscriptionHandleResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    LegacySubscriptionHandle_t * handle;
-} LegacySubscriptionHandleResult_t;
-
-/** \brief
- *  Helper function for GC-sensitive SDKs to ensure proper unregistering of the subscription in the
- *  future.
- *
- *  Indeed, the state contained in the `LegacySubscriptionHandle` is otherwise difficult for the
- *  SDK to keep alive once "finalizing the world" has started: some of this state (such as some of
- *  the individual items of `order_by`) may have been disposed of already, which makes it impossible
- *  to then properly call `ditto_remove_subscription()`.
- */
-LegacySubscriptionHandleResult_t
-/* fn */ ditto_add_subscription_with_easier_unregistering (
-    CDitto_t const * ditto,
-    char const * collection,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_bys,
-    int32_t limit,
-    uint32_t offset);
-
-/** \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_WebsocketClientPlatformEvent TransportHandle_WebsocketClientPlatformEvent_t;
-
-/** <No documentation available> */
-TransportHandle_WebsocketClientPlatformEvent_t *
-/* fn */ ditto_add_websocket_client (
-    CDitto_t const * ditto,
-    char const * address,
-    uint32_t routing_hint);
-
-/** <No documentation available> */
-typedef struct WifiAwareClientCallbacks {
-    /** <No documentation available> */
-    void (*start_searching)(void *, char const *, char const *);
-
-    /** <No documentation available> */
-    void (*stop_searching)(void *);
-
-    /** <No documentation available> */
-    void (*create_network)(void *, char const *);
-
-    /** <No documentation available> */
-    void (*update_peer)(void *, char const *, ConnectState_t);
-} WifiAwareClientCallbacks_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_WifiAwareClientPlatformEvent TransportHandle_WifiAwareClientPlatformEvent_t;
-
-/** <No documentation available> */
-TransportHandle_WifiAwareClientPlatformEvent_t *
-/* fn */ ditto_add_wifi_aware_client_transport (
-    CDitto_t const * ditto,
-    WifiAwareClientCallbacks_t callbacks,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
-/** <No documentation available> */
-typedef struct WifiAwareServerCallbacks {
-    /** <No documentation available> */
-    void (*start_advertising)(void *, char const *, char const *, uint16_t);
-
-    /** <No documentation available> */
-    void (*stop_advertising)(void *);
-
-    /** <No documentation available> */
-    void (*update_peer)(void *, char const *, ConnectState_t);
-} WifiAwareServerCallbacks_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_WifiAwareServerPlatformEvent TransportHandle_WifiAwareServerPlatformEvent_t;
-
-/** <No documentation available> */
-TransportHandle_WifiAwareServerPlatformEvent_t *
-/* fn */ ditto_add_wifi_aware_server_advertiser (
-    CDitto_t const * ditto,
-    WifiAwareServerCallbacks_t callbacks,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *));
-
-/** <No documentation available> */
-char *
-/* fn */ ditto_auth_client_get_app_id (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-uint64_t
-/* fn */ ditto_auth_client_get_site_id (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_auth_client_is_web_valid (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_auth_client_is_x509_valid (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_auth_client_login_with_credentials (
-    CDitto_t * ditto,
-    char const * username,
-    char const * password,
-    char const * provider);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_auth_client_login_with_token (
-    CDitto_t * ditto,
-    char const * token,
-    char const * provider);
-
-/** <No documentation available> */
-typedef struct BoxedCharPtrResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    char * c_string;
-} BoxedCharPtrResult_t;
-
-/** <No documentation available> */
-BoxedCharPtrResult_t
-/* fn */ ditto_auth_client_login_with_token_and_feedback (
-    CDitto_t const * ditto,
-    char const * token,
-    char const * provider);
-
-/** \brief
- *  Trigger an explicit logout and purge of any cached credentials
- */
-int32_t
-/* fn */ ditto_auth_client_logout (
-    CDitto_t const * ditto);
-
-/** \brief
- *  An `SdkLoginProvider` that sends the notifications over FFI
- */
-typedef struct CLoginProvider CLoginProvider_t;
-
-/** \brief
- *  Create a LoginProvider. Ownership passes to the SDK.
- *
- *  This cannot be freed directly - it should be passed in when creating an
- *  AuthClient.
- */
-CLoginProvider_t *
-/* fn */ ditto_auth_client_make_login_provider (
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*expiring_cb)(void *, uint32_t));
-
-/** \brief
- *  Set a validity listener.
- */
-void
-/* fn */ ditto_auth_client_set_validity_listener (
-    CDitto_t const * ditto,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*validity_update_cb)(void *, int32_t, int32_t));
-
-/** <No documentation available> */
-char *
-/* fn */ ditto_auth_client_user_id (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_auth_login_provider_free (
-    CLoginProvider_t * login_provider);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_auth_set_login_provider (
-    CDitto_t const * ditto,
-    CLoginProvider_t * login_provider);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_bus_close_stream (
-    CDitto_t const * ditto,
-    uint64_t stream_id);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_bus_enqueue_stream_message (
-    CDitto_t const * ditto,
-    uint64_t stream_id,
-    slice_ref_uint8_t message);
-
-/** <No documentation available> */
-typedef enum BusStreamEnqueueReadiness {
-    /** <No documentation available> */
-    BUS_STREAM_ENQUEUE_READINESS_READY,
-    /** <No documentation available> */
-    BUS_STREAM_ENQUEUE_READINESS_NOT_READY,
-    /** <No documentation available> */
-    BUS_STREAM_ENQUEUE_READINESS_ERROR,
-} BusStreamEnqueueReadiness_t;
-
-/** <No documentation available> */
-BusStreamEnqueueReadiness_t
-/* fn */ ditto_bus_is_stream_ready_to_enqueue (
-    CDitto_t const * ditto,
-    uint64_t stream_id);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_bus_open_stream (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t destination,
-    ReliabilityMode_t reliability_mode,
-    uint64_t open_ctx);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_bus_send_single_message (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t destination,
-    uint64_t send_ctx,
-    ReliabilityMode_t reliability_mode,
-    slice_ref_uint8_t message);
-
-/** \brief
- *  [`Box`][`rust::Box`]`<[T]>` (fat pointer to a slice),
- *  but with a guaranteed `#[repr(C)]` layout.
- *
- *  # C layout (for some given type T)
- *
- *  ```c
- *  typedef struct {
- *  // Cannot be NULL
- *  T * ptr;
- *  size_t len;
- *  } slice_T;
- *  ```
- *
- *  # Nullable pointer?
- *
- *  If you want to support the above typedef, but where the `ptr` field is
- *  allowed to be `NULL` (with the contents of `len` then being undefined)
- *  use the `Option< slice_ptr<_> >` type.
- */
-typedef struct slice_boxed_uint8 {
-    /** \brief
-     *  Pointer to the first element (if any).
-     */
-    uint8_t * ptr;
-
-    /** \brief
-     *  Element count
-     */
-    size_t len;
-} slice_boxed_uint8_t;
-
-/** \brief
- *  Releases a byte array value returned by DittoStore.
- *
- *  DittoStore manages its own memory allocations and it is not safe to release
- *  such values with C's `free()`. That's why the structures it returns provide
- *  their own associated `free` function.
- *
- *  It should be used for values returned by functions like
- *  `ditto_document_cbor`.
- */
-void
-/* fn */ ditto_c_bytes_free (
-    slice_boxed_uint8_t bytes);
-
-/** \brief
- *  Releases `char *` value returned by DittoStore.
- *
- *  DittoStore manages its own memory allocations and it is not safe to release
- *  such values with C's `free()`. That's why the structures it returns provide
- *  their own associated `free` function and this is one we need for `char *`.
- *
- *  It should be used for values returned by functions like
- *  `ditto_document_id_query_compatible`.
- */
-void
-/* fn */ ditto_c_string_free (
-    char * s);
-
-/** \brief
- *  Empty error callback
- *  (useful for passing to `err_cb` functions to ignore errors; use with
- *  caution)
- */
-void
-/* fn */ ditto_callback_err_nop (
-    int32_t _code,
-    char const * _err,
-    void * _data);
-
-/** \brief
- *  Empty callback (useful for passing to `free` functions)
- */
-void
-/* fn */ ditto_callback_nop (
-    void const * _data);
-
-/** <No documentation available> */
-typedef struct DittoCancellable DittoCancellable_t;
-
-/** <No documentation available> */
-void
-/* fn */ ditto_cancel (
-    DittoCancellable_t * _cancelable);
-
-/** \brief
- *  Cancels a resolve callback registered by ditto_resolve_attachment.
- *
- *  Returns following error codes:
- *
- *  * `0` -- no error
- *  * `1` -- an error
- *  * `2` -- invalid id
- *  * `3` -- token never issued
- *
- *  In case of a non-zero return value, error message can be retrieved using
- *  `ditto_error_message` function.
- */
-uint32_t
-/* fn */ ditto_cancel_resolve_attachment (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t id,
-    uint64_t cancel_token);
-
-/** \brief
- *  The `PathAccessorType` enum allows you to specify (usually from the SDK side
- *  of the FFI) what sort of type you’re trying to access. So for some of the
- *  cases in the enum, e.g. `String`, `Bool`, etc, it’s quite straightforward
- *  what you’re asking for. For something like `Int` it’s a little more complex
- *  in that if the value at the path you’ve provided is an integer _or_ a float
- *  (with no fractional part to it) then it’ll return an integer to you. For
- *  `Array` or `Object` it’ll give you back an array or an object (respectively)
- *  if either the value at the path provided is a `Register` containing an
- *  array/object or if the value at the path provided is an `RGA`/`RWMap`,
- *  respectively.
- *
- *  There are then the explicit type accessor type cases in that enum, e.g.
- *  `Counter`, `Register`, etc which will only return a value if the “active”
- *  value (most recently updated) at the provided path is a CRDT of the
- *  specified type, otherwise `None` will be returned.
- */
-typedef enum PathAccessorType {
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_STRING,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_NUMBER,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_INT,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_U_INT,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_FLOAT,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_DOUBLE,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_BOOL,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_NULL,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_OBJECT,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_ARRAY,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_ANY,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_COUNTER,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_REGISTER,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_ATTACHMENT,
-    /** <No documentation available> */
-    PATH_ACCESSOR_TYPE_R_W_MAP,
-} PathAccessorType_t;
-
-/** <No documentation available> */
-typedef struct CBORPathResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    slice_boxed_uint8_t cbor;
-} CBORPathResult_t;
-
-/** \brief
- *  Gets the CBOR value at the path in the provided CBOR and returns it if the
- *  value found matches the type requested, otherwise `None` will be returned in
- *  the result.
- *
- *  If CBOR is returned in the result then the bytes have to be released with
- *  `::ditto_c_bytes_free`.
- */
-CBORPathResult_t
-/* fn */ ditto_cbor_get_cbor_with_path_type (
-    slice_ref_uint8_t cbor,
-    char const * path,
-    PathAccessorType_t path_type);
-
-/** \brief
- *  Represents the error code as returned by various FFI functions. It's a
- *  simple integer for now, the codes are specified by each FFI function
- *  individually (for now, we plan to introduce a proper error type in the near
- *  future).
- *  Beware that all errors are not captured here. It is encouraged to use this enum
- *  instead of explicit `status_code` -mostly 0 and 1-.
- */
-typedef enum DittoErrorCode {
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_OK = 0,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_UNKNOWN = 1,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_NOT_IMPLEMENTED = 2,
-    /** \brief
-     *  Fatal case that ought to never happen.
-     */
-    DITTO_ERROR_CODE_UNREACHABLE = 2989,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_FAILED_TO_ACQUIRE_LOCK_FILE = 16777217,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_INVALID_PASSPHRASE = 33554433,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_EXTRANEOUS_PASSPHRASE_GIVEN = 33554434,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_PASSPHRASE_NOT_GIVEN = 33554435,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_ALREADY_ENCRYPTED = 33554436,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_ENCRYPTION_FAILED = 33554437,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_CANNOT_BE_ENCRYPTED = 33554438,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_NOT_INITIALIZED = 33554439,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_SORT_FAILED = 50331649,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_DQL_FAILED_TO_COMPILE_QUERY = 50331650,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_DQL_UNSUPPORTED = 50331651,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_DQL_EXECUTION_FAILED = 50331652,
-    /** <No documentation available> */
-    DITTO_ERROR_CODE_PARAMETER_QUERY_FAILED = 50331653,
-} DittoErrorCode_t;
-
-/** \brief
- *  Changes the passphrase and re-encrypts all data. This can take a while,
- *  progress is reported via the progress callback. Returns a progress token
- *  or 0 if a _synchronous_ error occured, in which case the `error_code` out
- *  parameter is set (see error code table below).
- *
- *  Note that errors can also occur while the operation is in progress. Those
- *  are typically IO errors and are reported via the progress callback.
- *  The combination of `passphrase` and `newPassphrase` have the following
- *  effects:
- *
- *  - `passphrase = NULL` & `newPassphrase = NULL` -> No-op if not encrypted, otherwise error code
- *  3.
- *
- *  - `passphrase = "123"` & `newPassphrase = "123"` -> No-op if encrypted and password is correct,
- *  error code 2 if not encrypted, and error code 1 if encrypted but `passphrase` invalid.
- *
- *  - `passphrase = NULL` & `newPassphrase = "123"` -> Add encryption. No-op if already encrypted
- *  and passphrase matches, error code 4 if already encrypted but passphrase does not match.
- *
- *  - `passphrase = "123"` & `newPassphrase = NULL` -> Remove encryption. No op
- *  - if not encrypted.
- *
- *  - `passphrase = "123"` & `newPassphrase = "456"` -> Re-encrypt. Error code 1 if passphrase
- *  invalid.
- */
-DittoCancellable_t *
-/* fn */ ditto_change_passphrase (
-    char const * _working_dir,
-    char const * _old_passphrase,
-    char const * _new_passphrase,
-    void * _ctx,
-    void (*_c_cb)(void *),
-    DittoErrorCode_t * _error_code);
-
-/** \brief
- *  Deregister any presence callback, releasing the receiver on the SDK side.
- */
-void
-/* fn */ ditto_clear_presence_callback (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Deregister v1 presence callback, releasing the receiver on the SDK side.
- */
-void
-/* fn */ ditto_clear_presence_v1_callback (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Deregister v2 presence callback, releasing the receiver on the SDK side.
- */
-void
-/* fn */ ditto_clear_presence_v2_callback (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Deregister v3 presence callback, releasing the receiver on the SDK side.
- */
-void
-/* fn */ ditto_clear_presence_v3_callback (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_collection (
-    CDitto_t const * ditto,
-    char const * name);
-
-/** \brief
- *  Write transaction synchronous API.
- */
-typedef struct CWriteTransaction CWriteTransaction_t;
-
-/** <No documentation available> */
-typedef struct BoolResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    bool bool_value;
-} BoolResult_t;
-
-/** \brief
- *  Evict a document from the collection, using the provided write transaction.
- *
- *  `was_evicted` is set to indicate whether the document was removed
- *  successfully.
- *
- *  * [js only] Returns -1 in case of outstanding non-`await`ed transaction operation.
- */
-BoolResult_t
-/* fn */ ditto_collection_evict (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    slice_ref_uint8_t id);
-
-/** \brief
- *  `&'lt [T]` but with a guaranteed `#[repr(C)]` layout.
- *
- *  # C layout (for some given type T)
- *
- *  ```c
- *  typedef struct {
- *  // Cannot be NULL
- *  T * ptr;
- *  size_t len;
- *  } slice_T;
- *  ```
- *
- *  # Nullable pointer?
- *
- *  If you want to support the above typedef, but where the `ptr` field is
- *  allowed to be `NULL` (with the contents of `len` then being undefined)
- *  use the `Option< slice_ptr<_> >` type.
- */
-typedef struct slice_ref_slice_boxed_uint8 {
-    /** \brief
-     *  Pointer to the first element (if any).
-     */
-    slice_boxed_uint8_t const * ptr;
-
-    /** \brief
-     *  Element count
-     */
-    size_t len;
-} slice_ref_slice_boxed_uint8_t;
-
-/** \brief
- *  Same as [`Vec<T>`][`rust::Vec`], but with guaranteed `#[repr(C)]` layout
- */
-typedef struct Vec_slice_boxed_uint8 {
-    /** <No documentation available> */
-    slice_boxed_uint8_t * ptr;
-
-    /** <No documentation available> */
-    size_t len;
-
-    /** <No documentation available> */
-    size_t cap;
-} Vec_slice_boxed_uint8_t;
-
-/** <No documentation available> */
-typedef struct DocIdsResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    Vec_slice_boxed_uint8_t ids;
-} DocIdsResult_t;
-
-/** \brief
- *  Evict several documents from the collection, using the provided write transaction.
- *
- *  Returns the list of successfully evicted document ids.
- *
- *  * [js only] Returns -1 in case of outstanding non-`await`ed transaction operation.
- */
-DocIdsResult_t
-/* fn */ ditto_collection_evict_by_ids (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    slice_ref_slice_boxed_uint8_t ids);
-
-/** \brief
- *  Evict all documents returned by the specified query from a collection.
- *
- *  `out_ids` is set to the list of IDs of all documents successfully evicted.
- *
- *  [js only] Returns -2 in case of outstanding non-awaited transaction operation.
- */
-DocIdsResult_t
-/* fn */ ditto_collection_evict_query_str (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by_params,
-    int32_t limit,
-    uint32_t offset);
-
-/** \brief
- *  Database document consisting of an associate `DocumentId` and
- *  `ditto_crdt::Document` pair. Within the `store` crate the association of
- *  these two elements are maintained together within this single structure,
- *  while these elements may be stored separately in upstream or downstream
- *  crates. This type corresponds to the `Record` type in the `replication`
- *  crate, rather than a literal document.
- */
-typedef struct CDocument CDocument_t;
-
-/** \brief
- *  Same as [`Vec<T>`][`rust::Vec`], but with guaranteed `#[repr(C)]` layout
- */
-typedef struct Vec_CDocument_ptr {
-    /** <No documentation available> */
-    CDocument_t * * ptr;
-
-    /** <No documentation available> */
-    size_t len;
-
-    /** <No documentation available> */
-    size_t cap;
-} Vec_CDocument_ptr_t;
-
-/** <No documentation available> */
-typedef struct DocumentsResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    Vec_CDocument_ptr_t documents;
-} DocumentsResult_t;
-
-/** \brief
- *  Execute the specified query.
- *
- *  `out_documents` is set to the list of all documents successfully retrieved
- *  from the collection.
- *
- *  [js only] Returns -2 in case of outstanding non-awaited transaction operation.
- */
-DocumentsResult_t
-/* fn */ ditto_collection_exec_query_str (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * txn,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by_params,
-    int32_t limit,
-    uint32_t offset);
-
-/** \brief
- *  Read transaction synchronous API.
- */
-typedef struct CReadTransaction CReadTransaction_t;
-
-/** <No documentation available> */
-typedef struct DocumentsIdsResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    Vec_CDocument_ptr_t documents;
-
-    /** <No documentation available> */
-    Vec_slice_boxed_uint8_t ids;
-} DocumentsIdsResult_t;
-
-/** \brief
- *  [js only] Returns `-1` in case of outstanding non-`awaited` transaction operation.
- */
-DocumentsIdsResult_t
-/* fn */ ditto_collection_find_by_ids (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    slice_ref_slice_boxed_uint8_t ids,
-    CReadTransaction_t * transaction);
-
-/** <No documentation available> */
-typedef struct DocumentResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    CDocument_t * document;
-} DocumentResult_t;
-
-/** \brief
- *  [js only] Returns `-1` in case of outstanding non-`awaited` transaction operation.
- */
-DocumentResult_t
-/* fn */ ditto_collection_get (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    slice_ref_uint8_t id,
-    CReadTransaction_t * transaction);
-
-/** <No documentation available> */
-typedef enum WriteStrategyRs {
-    /** \brief
-     *  Create or merge with existing data
-     */
-    WRITE_STRATEGY_RS_MERGE,
-    /** \brief
-     *  Only insert if no document already exists with the same document ID
-     */
-    WRITE_STRATEGY_RS_INSERT_IF_ABSENT,
-    /** \brief
-     *  Insert as default data, only if no document already exists with the same
-     *  document ID
-     */
-    WRITE_STRATEGY_RS_INSERT_DEFAULT_IF_ABSENT,
-    /** \brief
-     *  This works as follows:
-     *  - If the document does not exist, it is created with the given value
-     *  - If the document exists, the value is compared to the document's current value, any
-     *  differing leaf's values in the Document are updated to match the given value. Nothing is
-     *  removed.
-     */
-    WRITE_STRATEGY_RS_UPDATE_DIFFERENT_VALUES,
-} WriteStrategyRs_t;
-
-/** <No documentation available> */
-typedef struct DocIdResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    slice_boxed_uint8_t id;
-} DocIdResult_t;
-
-/** \brief
- *  Inserts a document into the store.
- *
- *  If an ID is provided explicitly via the `doc_id` parameter then that will be
- *  used as the document's ID. If an ID is provided implicitly via the
- *  document's value (`doc_cbor`) then that will be used as the document's ID,
- *  assuming no explicit ID was provided. If neither an explicit nor an implicit
- *  document ID was provided then a new document ID will be generated and used
- *  as the new document's ID.
- *
- *  Return codes:
- *
- *  * `0` -- success
- *  * `1` -- improper CBOR provided for the document value
- *  * `2` -- invalid CBOR for the document value (i.e. the CBOR could be parsed but it represented a
- *  non-`Object` value)
- *  * `3` -- unable to create document ID from value at `_id` key in document's value (`doc_cbor`
- *  argument)
- *  * `4` -- (js only) concurrent database operation (missing `await`?)
- */
-DocIdResult_t
-/* fn */ ditto_collection_insert_value (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    slice_ref_uint8_t doc_cbor,
-    WriteStrategyRs_t write_strategy,
-    char const * log_hint,
-    CWriteTransaction_t * txn);
-
-/** \brief
- *  Remove a document from the collection, using the provided write transaction.
- *
- *  `was_removed` is set to indicate whether the document was removed
- *  successfully.
- *
- *  * [js only] Returns -1 in case of outstanding non-`await`ed transaction operation.
- */
-BoolResult_t
-/* fn */ ditto_collection_remove (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    slice_ref_uint8_t id);
-
-/** \brief
- *  Remove documents from the collection, using the provided write transaction.
- *
- *  Return the list of successfully removed DocumentId
- *
- *  Will return an error if the number of keys is greater than 1024.
- *  * [js only] Returns -1 in case of outstanding non-`await`ed transaction operation.
- */
-DocIdsResult_t
-/* fn */ ditto_collection_remove_by_ids (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    slice_ref_slice_boxed_uint8_t ids);
-
-/** \brief
- *  Remove all documents returned by the specified query from a collection.
- *
- *  `out_ids` is set to the list of IDs of all documents successfully removed.
- *
- *  [js only] Returns -2 in case of outstanding non-awaited transaction operation.
- */
-DocIdsResult_t
-/* fn */ ditto_collection_remove_query_str (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by_params,
-    int32_t limit,
-    uint32_t offset);
-
-/** \brief
- *  [js only] Returns -1 in case of outstanding non-awaited transaction operation.
- */
-int32_t
-/* fn */ ditto_collection_update (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    CDocument_t * document);
-
-/** \brief
- *  Update multiple documents in a collection, using the provided write
- *  transaction.
- *
- *  # Return Values
- *
- *  - Returns `0` if all links were successfully updated in all documents.
- *  - Returns `-1` if one or more documents' links fail to all update
- *  successfully, but all documents themselves are successfully updated. Note
- *  that in the event of an attachment failing to update, updates are still
- *  attempted on the rest of the attachments and the rest of the documents.
- *  - If a document fails to update, the appropriate error code is returned for
- *  the cause of the failure. Note that if a document fails to update, no more
- *  document updates are attempted.
- */
-int32_t
-/* fn */ ditto_collection_update_multiple (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    Vec_CDocument_ptr_t documents);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_disable_sync_with_v3 (
-    CDitto_t const * ditto);
-
-/** \brief
- *  List of components using the file storage system
- */
-/** \remark Has the same ABI as `uint8_t` **/
-#ifdef DOXYGEN
-typedef
-#endif
-enum FsComponent {
-    /** <No documentation available> */
-    FS_COMPONENT_ROOT = 0,
-    /** <No documentation available> */
-    FS_COMPONENT_STORE,
-    /** <No documentation available> */
-    FS_COMPONENT_AUTH,
-    /** <No documentation available> */
-    FS_COMPONENT_REPLICATION,
-    /** <No documentation available> */
-    FS_COMPONENT_ATTACHMENT,
-}
-#ifndef DOXYGEN
-; typedef uint8_t
-#endif
-FsComponent_t;
-
-/** \brief
- *  Get a cbor repr of the disk usage
- */
-slice_boxed_uint8_t
-/* fn */ ditto_disk_usage (
-    CDitto_t const * ditto,
-    FsComponent_t path);
-
-/** \brief
- *  Document's CBOR
- */
-slice_boxed_uint8_t
-/* fn */ ditto_document_cbor (
-    CDocument_t const * document);
-
-/** \brief
- *  Releases the document
- */
-void
-/* fn */ ditto_document_free (
-    CDocument_t * document);
-
-/** \brief
- *  Gets the CBOR value at the path in the provided document and returns it if
- *  the value found matches the type requested, otherwise `None` will be
- *  returned in the result.
- *
- *  To understand how this is intended to be used it might be instructive to see
- *  how things work in the DittoDocumentPath of the Swift SDK, for example:
- *  <https://github.com/getditto/ditto/blob/v2/cocoa/DittoSwift/Store/DittoDocumentPath.swift#L63-L277>
- *
- *  where the valueAtPathInDocumentWithType implementation looks like this:
- *  <https://github.com/getditto/ditto/blob/259cfa64dd2c6b36ffee2e97514695ccbfff6755/cocoa/DittoSwift/Store/Internal/ValueAtPath.swift#L42-L49>
- *
- *  Note: all the of the values returned by
- *  `ditto_document_get_cbor_with_path_type` are untyped (i.e. there’s never an
- *  object with `_value` and `_ditto_internal_type_jkb12973t4b` keys being
- *  returned). For example, if you request a value at a path with a
- *  `PathAccessorType` of `Counter` and there is indeed a counter at that path
- *  then the value (as CBOR) that will be returned will be the `f64`/`double`
- *  representation of the counter’s value, on its own.
- *
- *  If CBOR is returned in the result then the bytes have to be released with
- *  `::ditto_c_bytes_free`.
- */
-CBORPathResult_t
-/* fn */ ditto_document_get_cbor_with_path_type (
-    CDocument_t const * document,
-    char const * pointer,
-    PathAccessorType_t path_type);
-
-/** \brief
- *  Document's ID
- *
- *  The resulting bytes have to be freed with `::ditto_c_bytes_free`
- */
-slice_boxed_uint8_t
-/* fn */ ditto_document_id (
-    CDocument_t const * document);
-
-/** \brief
- *  Defines how string primitives should be encoded. This is relevant if a
- *  document ID was created from a string. There are occasions when we want the
- *  stringified representation of the document ID do include quotes around the
- *  string, for example when creating a query like `_id == "abc"`. However,
- *  there are also times when we want to return the string as just a string, for
- *  example when we're injecting a document ID into a document's value before
- *  then serializing the document and sending those bytes across the FFI
- *  boundary.
- */
-typedef enum StringPrimitiveFormat {
-    /** <No documentation available> */
-    STRING_PRIMITIVE_FORMAT_WITH_QUOTES,
-    /** <No documentation available> */
-    STRING_PRIMITIVE_FORMAT_WITHOUT_QUOTES,
-} StringPrimitiveFormat_t;
-
-/** \brief
- *  Convert a document ID from CBOR bytes into a Ditto query language compatible
- *  string.
- *
- *  The resulting string has to be freed with `::ditto_c_string_free`
- */
-char *
-/* fn */ ditto_document_id_query_compatible (
-    slice_ref_uint8_t id,
-    StringPrimitiveFormat_t string_primitive_format);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_document_increment_counter (
-    CDocument_t * document,
-    char const * pointer,
-    double amount);
-
-/** \brief
- *  Removes a value from a document. Only object properties can be removed. If the
- *  `pointer` points to an array index, the removal will fail. To update an array
- *  within a register, see `ditto_document_update`.
- *
- *  # Arguments
- *
- *  * `document` - A pointer to the document which was previously returned from a query.
- *  * `pointer` - A JMESPath _pointer_ to a property within `document` which is to be removed.
- *
- *  # Returns
- *
- *  `0` if the remove was successful or non-zero to indicate failure. To
- *  retrieve an error message in the case of failure, call
- *  `ditto_error_message()`.
- */
-int32_t
-/* fn */ ditto_document_remove (
-    CDocument_t * document,
-    char const * pointer);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_document_set_cbor (
-    CDocument_t * document,
-    char const * pointer,
-    slice_ref_uint8_t cbor);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_document_set_cbor_with_timestamp (
-    CDocument_t * document,
-    char const * pointer,
-    slice_ref_uint8_t cbor,
-    uint32_t _timestamp);
-
-/** \brief
- *  Updates the document with values taken from provided CBOR data.
- *
- *  Returns following error codes:
- *
- *  * `0` -- no error
- *  * `1` -- invalid CBOR data
- *  * `2` -- CBOR data was not a map
- *  * `3` -- update error
- *  * `4` -- `_id` key provided
- *  * `5` -- invalid value
- *
- *  In case of a non-zero return value, error message can be retrieved using
- *  `::ditto_error_message` function.
- */
-int32_t
-/* fn */ ditto_document_update (
-    CDocument_t * document,
-    slice_ref_uint8_t cbor);
-
-/** \brief
- *  `&'lt [T]` but with a guaranteed `#[repr(C)]` layout.
- *
- *  # C layout (for some given type T)
- *
- *  ```c
- *  typedef struct {
- *  // Cannot be NULL
- *  T * ptr;
- *  size_t len;
- *  } slice_T;
- *  ```
- *
- *  # Nullable pointer?
- *
- *  If you want to support the above typedef, but where the `ptr` field is
- *  allowed to be `NULL` (with the contents of `len` then being undefined)
- *  use the `Option< slice_ptr<_> >` type.
- */
-typedef struct slice_ref_CDocument_ptr {
-    /** \brief
-     *  Pointer to the first element (if any).
-     */
-    CDocument_t * const * ptr;
-
-    /** \brief
-     *  Element count
-     */
-    size_t len;
-} slice_ref_CDocument_ptr_t;
-
-/** <No documentation available> */
-typedef struct U64Result {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    uint64_t u64;
-} U64Result_t;
-
-/** <No documentation available> */
-U64Result_t
-/* fn */ ditto_documents_hash (
-    slice_ref_CDocument_ptr_t documents);
-
-/** <No documentation available> */
-BoxedCharPtrResult_t
-/* fn */ ditto_documents_hash_mnemonic (
-    slice_ref_CDocument_ptr_t documents);
-
-/** \brief
- *  Retrieves last thread-local error message (used by some synchronous APIs)
- *  and removes it. Subsequent call to this function (if nothing else has
- *  happened) will always return `NULL`.
- *
- *  Returns `NULL` if there was no error. A non-null result MUST be freed using
- *  `ditto_c_string_free`.
- */
-char *
-/* fn */ ditto_error_message (void);
-
-/** \brief
- *  Retrieves last thread-local error message (used by some synchronous APIs)
- *  and retains ownership of it.
- *
- *  Returns `NULL` if there was no error. A non-null result MUST be freed using
- *  `ditto_c_string_free`.
- */
-char *
-/* fn */ ditto_error_message_peek (void);
-
-/** <No documentation available> */
-typedef struct CIdentityConfig CIdentityConfig_t;
-
-/** \brief
- *  Whether or not history tracking is enabled.
- */
-typedef enum HistoryTracking {
-    /** <No documentation available> */
-    HISTORY_TRACKING_ENABLED,
-    /** <No documentation available> */
-    HISTORY_TRACKING_DISABLED,
-} HistoryTracking_t;
-
-/** \brief
- *  Same as `ditto_make()`, only takes an additional `passphrase` and an out
- *  `error_code` parameter.
- *
- *  Returns the Ditto pointer on success. On failure, returns `NULL` and sets the
- *  out `error_code` parameter (1 or 2 possible here, plus IO errors).
- */
-CDitto_t *
-/* fn */ ditto_experimental_make_with_passphrase (
-    char const * working_dir,
-    CIdentityConfig_t * identity_config,
-    HistoryTracking_t history_tracking,
-    char const * passphrase,
-    DittoErrorCode_t * error_code);
-
-/** \brief
- *  Frees the `Ditto` object.
- *
- *  It is expected that `ditto_shutdown` will have been called before this is called.
- */
-void
-/* fn */ ditto_free (
-    CDitto_t * ditto);
-
-/** \brief
- *  A shared read-only reference to an existing Attachment.
- */
-typedef struct AttachmentHandle AttachmentHandle_t;
-
-/** <No documentation available> */
-void
-/* fn */ ditto_free_attachment_handle (
-    AttachmentHandle_t * handle);
-
-/** \brief
- *  Frees a `Vec_CDocument_ptr_t`, used in `c_cb_params`.
- *
- *  \remark This functions frees both the backing buffer allocation and each
- *  individual `Document` pointer. If ownership has been taken of the latter,
- *  then you must ensure the `len` field of the struct is zeroed before calling
- *  this function.
- */
-void
-/* fn */ ditto_free_documents (
-    Vec_CDocument_ptr_t documents);
-
-/** \brief
- *  [`Box`][`rust::Box`]`<[T]>` (fat pointer to a slice),
- *  but with a guaranteed `#[repr(C)]` layout.
- *
- *  # C layout (for some given type T)
- *
- *  ```c
- *  typedef struct {
- *  // Cannot be NULL
- *  T * ptr;
- *  size_t len;
- *  } slice_T;
- *  ```
- *
- *  # Nullable pointer?
- *
- *  If you want to support the above typedef, but where the `ptr` field is
- *  allowed to be `NULL` (with the contents of `len` then being undefined)
- *  use the `Option< slice_ptr<_> >` type.
- */
-typedef struct slice_boxed_size {
-    /** \brief
-     *  Pointer to the first element (if any).
-     */
-    size_t * ptr;
-
-    /** \brief
-     *  Element count
-     */
-    size_t len;
-} slice_boxed_size_t;
-
-/** \brief
- *  Frees a `slice_box_size_t`, used in `c_cb_params`.
- */
-void
-/* fn */ ditto_free_indices (
-    slice_boxed_size_t indices);
-
-/** <No documentation available> */
-typedef struct AttachmentHandleResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    AttachmentHandle_t * handle;
-} AttachmentHandleResult_t;
-
-/** <No documentation available> */
-AttachmentHandleResult_t
-/* fn */ ditto_get_attachment_status (
-    CDitto_t * ditto,
-    slice_ref_uint8_t id);
-
-/** \brief
- *  Same as [`Vec<T>`][`rust::Vec`], but with guaranteed `#[repr(C)]` layout
- */
-typedef struct Vec_char_ptr {
-    /** <No documentation available> */
-    char * * ptr;
-
-    /** <No documentation available> */
-    size_t len;
-
-    /** <No documentation available> */
-    size_t cap;
-} Vec_char_ptr_t;
-
-/** <No documentation available> */
-typedef struct CollectionNamesResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    Vec_char_ptr_t names;
-} CollectionNamesResult_t;
-
-/** <No documentation available> */
-CollectionNamesResult_t
-/* fn */ ditto_get_collection_names (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-typedef struct AttachmentDataResult {
-    /** <No documentation available> */
-    int8_t status;
-
-    /** <No documentation available> */
-    slice_boxed_uint8_t data;
-} AttachmentDataResult_t;
-
-/** <No documentation available> */
-AttachmentDataResult_t
-/* fn */ ditto_get_complete_attachment_data (
-    CDitto_t const * ditto,
-    AttachmentHandle_t const * handle);
-
-/** <No documentation available> */
-char *
-/* fn */ ditto_get_complete_attachment_path (
-    CDitto_t const * ditto,
-    AttachmentHandle_t const * handle);
-
-/** \brief
- *  Returns a human-readable SDK version string, including platform information.
- *  While useful when logging, its exact format or contents ought not to be
- *  relied on.
- *
- *  The returned string must be freed.
- */
-char *
-/* fn */ ditto_get_sdk_version (void);
-
-/** <No documentation available> */
-typedef struct IdentityConfigResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    CIdentityConfig_t * identity_config;
-} IdentityConfigResult_t;
-
-/** <No documentation available> */
-IdentityConfigResult_t
-/* fn */ ditto_identity_config_make_manual (
-    char const * manual_identity_str);
-
-/** <No documentation available> */
-IdentityConfigResult_t
-/* fn */ ditto_identity_config_make_manual_v0 (
-    char const * config_cbor_b64);
-
-/** <No documentation available> */
-IdentityConfigResult_t
-/* fn */ ditto_identity_config_make_offline_playground (
-    char const * app_id,
-    uint64_t site_id);
-
-/** <No documentation available> */
-IdentityConfigResult_t
-/* fn */ ditto_identity_config_make_online_playground (
-    char const * app_id,
-    char const * shared_token,
-    char const * base_url);
-
-/** <No documentation available> */
-IdentityConfigResult_t
-/* fn */ ditto_identity_config_make_online_with_authentication (
-    char const * app_id,
-    char const * base_url);
-
-/** <No documentation available> */
-IdentityConfigResult_t
-/* fn */ ditto_identity_config_make_shared_key (
-    char const * app_id,
-    char const * key_der_b64,
-    uint64_t site_id);
-
-/** <No documentation available> */
-typedef enum Platform {
-    /** <No documentation available> */
-    PLATFORM_WINDOWS,
-    /** <No documentation available> */
-    PLATFORM_MAC,
-    /** <No documentation available> */
-    PLATFORM_IOS,
-    /** <No documentation available> */
-    PLATFORM_TVOS,
-    /** <No documentation available> */
-    PLATFORM_ANDROID,
-    /** <No documentation available> */
-    PLATFORM_LINUX,
-    /** <No documentation available> */
-    PLATFORM_WEB,
-    /** <No documentation available> */
-    PLATFORM_UNKNOWN,
-} Platform_t;
-
-/** <No documentation available> */
-typedef enum Language {
-    /** <No documentation available> */
-    LANGUAGE_SWIFT,
-    /** <No documentation available> */
-    LANGUAGE_OBJECTIVE_C,
-    /** <No documentation available> */
-    LANGUAGE_C_PLUS_PLUS,
-    /** <No documentation available> */
-    LANGUAGE_C_SHARP,
-    /** <No documentation available> */
-    LANGUAGE_JAVA_SCRIPT,
-    /** <No documentation available> */
-    LANGUAGE_UNKNOWN,
-    /** <No documentation available> */
-    LANGUAGE_RUST,
-    /** <No documentation available> */
-    LANGUAGE_J_V_M_BASED,
-} Language_t;
-
-/** <No documentation available> */
-void
-/* fn */ ditto_init_sdk_version (
-    Platform_t platform,
-    Language_t language,
-    char const * sdk_semver);
-
-typedef struct {
-    uint8_t idx[8];
-} uint8_8_array_t;
-
-/** \brief
- *  Construct a new Timeseries Event from the following parts:
- *  * `timestamp` - u64 Unix epoch seconds as 8 big endian bytes
- *  * `nanos` - Number of nanoseconds offset into the current second
- *  * `ts_name` - The name of the timeseries
- *  * `cbor` - The cbor content for the event
- *  * `txn` - An optional write transaction. If one is provided then it will not be committed. If
- *  one is not provided then one will be obtained and it will be committed.
- *
- *  Return codes:
- *  * `0` -- success
- *  * `1` -- invalid CBOR
- *  * `2` -- `cbor` is not an object
- *  * `3` -- (js only) concurrent database operation (missing `await`?)
- */
-int32_t
-/* fn */ ditto_insert_timeseries_event (
-    CDitto_t const * ditto,
-    uint8_8_array_t timestamp,
-    uint32_t nanos,
-    char const * ts_name,
-    slice_ref_uint8_t cbor,
-    CWriteTransaction_t * txn);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_invalidate_tcp_listeners (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Returns `true` if Ditto data at that path is encrypted, otherwise
- *  returns `false`
- */
-bool
-/* fn */ ditto_is_encrypted (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Describes how a live query callback's availability should be treated.
- *
- *  If `Always` is specified then as soon as a transaction is committed that
- *  impacts the live query the consumer-provided callback will be called with
- *  the relevant update information. This can be temporarily delayed if there's
- *  a lot of activity leading to the event receivers lagging or if groups of
- *  transactions are coalesced into a single live query update.
- *
- *  If `WhenSignalled` is specified then the consumer-provided live query
- *  callback will only be called when there is a transaction committed that
- *  impacts the live query *and* the consumer has signalled that they are ready
- *  to receive a new live query event (via the callback).
- */
-typedef enum LiveQueryAvailability {
-    /** <No documentation available> */
-    LIVE_QUERY_AVAILABILITY_ALWAYS,
-    /** <No documentation available> */
-    LIVE_QUERY_AVAILABILITY_WHEN_SIGNALLED,
-} LiveQueryAvailability_t;
-
-/** <No documentation available> */
-typedef struct c_cb_params {
-    /** \brief
-     *  Must be freed with `ditto_free_documents`.
-     */
-    Vec_CDocument_ptr_t documents;
-
-    /** <No documentation available> */
-    bool is_initial;
-
-    /** \brief
-     *  Must be freed with `ditto_free_documents`.
-     */
-    Vec_CDocument_ptr_t old_documents;
-
-    /** \brief
-     *  Must be freed using `ditto_free_indices`.
-     */
-    slice_boxed_size_t insertions;
-
-    /** \brief
-     *  Must be freed using `ditto_free_indices`.
-     */
-    slice_boxed_size_t deletions;
-
-    /** \brief
-     *  Must be freed using `ditto_free_indices`.
-     */
-    slice_boxed_size_t updates;
-
-    /** \brief
-     *  Must be freed using `ditto_free_indices`.
-     */
-    slice_boxed_size_t moves;
-} c_cb_params_t;
-
-/** <No documentation available> */
-typedef struct I64Result {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    int64_t i64;
-} I64Result_t;
-
-/** \brief
- *  Convenience function for `ditto_live_query_register`, so as not to require
- *  pre-compiling the query.
- */
-I64Result_t
-/* fn */ ditto_live_query_register_str (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by,
-    int32_t limit,
-    uint32_t offset,
-    LiveQueryAvailability_t lq_availability,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*c_cb)(void *, c_cb_params_t));
-
-/** <No documentation available> */
-void
-/* fn */ ditto_live_query_signal_available_next (
-    CDitto_t const * ditto,
-    int64_t id);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_live_query_start (
-    CDitto_t const * ditto,
-    int64_t id);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_live_query_stop (
-    CDitto_t const * ditto,
-    int64_t id);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_live_query_webhook_generate_new_api_secret (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-DocIdResult_t
-/* fn */ ditto_live_query_webhook_register_str (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    char const * query,
-    slice_ref_COrderByParam_t order_by,
-    int32_t limit,
-    uint32_t offset,
-    char const * url);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_live_query_webhook_start_all (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_live_query_webhook_start_by_id (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t doc_id);
-
-/** <No documentation available> */
-typedef enum CLogLevel {
-    /** <No documentation available> */
-    C_LOG_LEVEL_ERROR = 1,
-    /** <No documentation available> */
-    C_LOG_LEVEL_WARNING,
-    /** <No documentation available> */
-    C_LOG_LEVEL_INFO,
-    /** <No documentation available> */
-    C_LOG_LEVEL_DEBUG,
-    /** <No documentation available> */
-    C_LOG_LEVEL_VERBOSE,
-} CLogLevel_t;
-
-/** \brief
- *  Log function called over FFI such that logging can be grouped into a single
- *  logging mechanism.
- */
-void
-/* fn */ ditto_log (
-    CLogLevel_t level,
-    char const * msg);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_logger_emoji_headings_enabled (
-    bool enabled);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_logger_emoji_headings_enabled_get (void);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_logger_enabled (
-    bool enabled);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_logger_enabled_get (void);
-
-/** \brief
- *  Initializes and registers the global Ditto logger.
- *
- *  This function shouldn't *need* to be called because all of the logging-related FFI calls
- *  *should* start with a call that ensures that the logger is initialized. However, it also
- *  shouldn't hurt to call this.
- */
-void
-/* fn */ ditto_logger_init (void);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_logger_minimum_log_level (
-    CLogLevel_t log_level);
-
-/** <No documentation available> */
-CLogLevel_t
-/* fn */ ditto_logger_minimum_log_level_get (void);
-
-/** \brief
- *  Registers a custom logging callback to be called whenever Ditto wants to
- *  issue a log (on _top_ of emitting the log to the console).
- *
- *  Care should be taken not to perform any Ditto operations within this
- *  callback, since those could emit new ditto logs, leading to a recursive
- *  situation. More specifically, this should not be fed `ditto_log`.
- *
- *  A `NULL` may be fed to provide no callback (thus unregistering any
- *  previously registered one).
- */
-void
-/* fn */ ditto_logger_set_custom_log_cb (
-    void (*custom_log_cb)(CLogLevel_t, char const *));
-
-/** \brief
- *  Registers a file path where logs will be written to, whenever Ditto wants
- *  to issue a log (on _top_ of emitting the log to the console).
- *
- *  The path, if any, must be within an already existing directory.
- *
- *  A `NULL` may be fed to provide no file (thus unregistering any previously
- *  registered one).
- *
- *  Returns `0` on success, and `-1` otherwise (and the thread local error
- *  message is set accordingly).
- */
-int8_t
-/* fn */ ditto_logger_set_log_file (
-    char const * log_file);
-
-/** \brief
- *  Make a Ditto object as an opaque pointer. The Ditto object creates the Tokio
- *  runtime and starts internal threads. The return value is a raw pointer whose
- *  only use is to supply as an argument to other ditto_* functions. The Ditto
- *  object must be stopped and freed with ditto_free().
- */
-CDitto_t *
-/* fn */ ditto_make (
-    char const * working_dir,
-    CIdentityConfig_t * identity_config,
-    HistoryTracking_t history_tracking);
-
-/** <No documentation available> */
-typedef struct CAttachment {
-    /** <No documentation available> */
-    slice_boxed_uint8_t id;
-
-    /** <No documentation available> */
-    uint64_t len;
-
-    /** <No documentation available> */
-    AttachmentHandle_t * handle;
-} CAttachment_t;
-
-/** \brief
- *  Creates new Attachment from a blob of bytes link it to the given Document.
- *
- *  Returns following error codes:
- *
- *  * `0` -- no error
- *  * `1` -- an error
- *
- *  In case of a non-zero return value, error message can be retrieved using
- *  `ditto_error_message` function.
- */
-uint32_t
-/* fn */ ditto_new_attachment_from_bytes (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t bytes,
-    CAttachment_t * out_attachment);
-
-/** \brief
- *  Describes how an attachment file should be handled by our Rust code.
- *
- *  In most cases copying the file will be desirable but with the Android SDK,
- *  for example, we sometimes want to create a tempfile from an InputStream
- *  associated with the attachment file and then move that tempfile rather than
- *  copy it, so as to not make unnecessary copies.
- */
-typedef enum AttachmentFileOperation {
-    /** <No documentation available> */
-    ATTACHMENT_FILE_OPERATION_COPY = 1,
-    /** <No documentation available> */
-    ATTACHMENT_FILE_OPERATION_MOVE,
-} AttachmentFileOperation_t;
-
-/** \brief
- *  Creates new Attachment from a file and link it to the given Document.
- *
- *  Returns following error codes:
- *
- *  * `0` -- no error
- *  * `1` -- an error
- *  * `2` -- file not found
- *  * `3` -- permission denied
- *
- *  In case of a non-zero return value, error message can be retrieved using
- *  `ditto_error_message` function.
- */
-uint32_t
-/* fn */ ditto_new_attachment_from_file (
-    CDitto_t const * ditto,
-    char const * source_path,
-    AttachmentFileOperation_t file_operation,
-    CAttachment_t * out_attachment);
-
-/** \brief
- *  Allow to free the Vector without dropping the Documents
- */
-void
-/* fn */ ditto_only_vec_documents_free (
-    Vec_CDocument_ptr_t docs);
-
-/** \brief
- *  Request data showing who we are connected to in a user-friendly way.
- */
-char *
-/* fn */ ditto_presence_v1 (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Request data showing who we are connected to in a user-friendly way.
- */
-char *
-/* fn */ ditto_presence_v2 (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Request data showing who we are connected to in a user-friendly way.
- */
-char *
-/* fn */ ditto_presence_v3 (
-    CDitto_t const * ditto);
-
-/** \brief
- *  `&'lt [T]` but with a guaranteed `#[repr(C)]` layout.
- *
- *  # C layout (for some given type T)
- *
- *  ```c
- *  typedef struct {
- *  // Cannot be NULL
- *  T * ptr;
- *  size_t len;
- *  } slice_T;
- *  ```
- *
- *  # Nullable pointer?
- *
- *  If you want to support the above typedef, but where the `ptr` field is
- *  allowed to be `NULL` (with the contents of `len` then being undefined)
- *  use the `Option< slice_ptr<_> >` type.
- */
-typedef struct slice_ref_char_const_ptr {
-    /** \brief
-     *  Pointer to the first element (if any).
-     */
-    char const * const * ptr;
-
-    /** \brief
-     *  Element count
-     */
-    size_t len;
-} slice_ref_char_const_ptr_t;
-
-/** <No documentation available> */
-U64Result_t
-/* fn */ ditto_queries_hash (
-    CDitto_t const * ditto,
-    slice_ref_char_const_ptr_t coll_names,
-    slice_ref_char_const_ptr_t queries);
-
-/** <No documentation available> */
-BoxedCharPtrResult_t
-/* fn */ ditto_queries_hash_mnemonic (
-    CDitto_t const * ditto,
-    slice_ref_char_const_ptr_t coll_names,
-    slice_ref_char_const_ptr_t queries);
-
-/** <No documentation available> */
-typedef struct CReadTransactionResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    CReadTransaction_t * txn;
-} CReadTransactionResult_t;
-
-/** <No documentation available> */
-CReadTransactionResult_t
-/* fn */ ditto_read_transaction (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_read_transaction_free (
-    CReadTransaction_t * transaction);
-
-/** \brief
- *  Holder of the disk usage callback
- *  Drop this to stop the callback
- */
-typedef struct DiskUsageObserver DiskUsageObserver_t;
-
-/** \brief
- *  Register a function that will be called every time
- *  the given path directory or file is updated.
- *  Return a handle that should be given to ditto_release_disk_usage_callback
- *  to drop the callback
- */
-DiskUsageObserver_t *
-/* fn */ ditto_register_disk_usage_callback (
-    CDitto_t const * ditto,
-    FsComponent_t component,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*c_cb)(void *, slice_ref_uint8_t));
-
-/** \brief
- *  Register a server that can authenticate client requests for an identity.
- *
- *  Its route will be included in the HTTP server transport, if configured.
- */
-int32_t
-/* fn */ ditto_register_local_auth_server (
-    CDitto_t * ditto,
-    char const * signing_key_pem,
-    slice_ref_char_const_ptr_t verifying_keys_pem,
-    char const * ca_key_pem,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*auth_cb)(void *, CAuthServerAuthRequest_t *, slice_ref_uint8_t),
-    void (*refresh_cb)(void *, CAuthServerRefreshRequest_t *, slice_ref_uint8_t));
-
-/** \brief
- *  Register a function that will be called every time the connection state
- *  of remote peers changes.
- */
-void
-/* fn */ ditto_register_presence_callback_v3 (
-    CDitto_t const * ditto,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*c_cb)(void *, char const *));
-
-/** \brief
- *  Register a function that will be called every time the connection state
- *  of remote peers changes.
- *  REMOVE THIS IN V4
- */
-void
-/* fn */ ditto_register_presence_v1_callback (
-    CDitto_t const * ditto,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*c_cb)(void *, char const *));
-
-/** \brief
- *  Register a function that will be called every time the connection state
- *  of remote peers changes.
- *  REMOVE THIS IN V4
- */
-void
-/* fn */ ditto_register_presence_v2_callback (
-    CDitto_t const * ditto,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*c_cb)(void *, char const *));
-
-/** \brief
- *  User-friendly categories describing where condition events arose
- */
-typedef enum ConditionSource {
-    /** <No documentation available> */
-    CONDITION_SOURCE_BLUETOOTH,
-    /** <No documentation available> */
-    CONDITION_SOURCE_TCP,
-    /** <No documentation available> */
-    CONDITION_SOURCE_AWDL,
-    /** <No documentation available> */
-    CONDITION_SOURCE_MDNS,
-    /** <No documentation available> */
-    CONDITION_SOURCE_WIFI_AWARE,
-} ConditionSource_t;
-
-/** \brief
- *  Register a function that will be called every time a transport changes
- *  condition.
- *
- *  This should drive UI indicators to indicate overall connectivity via methods
- *  such as BLE, WiFi, or an internet-based server on a dedicated
- *  WsConnectTransport.
- */
-void
-/* fn */ ditto_register_transport_condition_changed_callback (
-    CDitto_t const * ditto,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*c_cb)(void *, ConditionSource_t, TransportCondition_t));
-
-/** \brief
- *  Release the disk usage observer obtained from `ditto_register_disk_usage_callback`
- */
-void
-/* fn */ ditto_release_disk_usage_callback (
-    DiskUsageObserver_t * _handle);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_remove_multicast_transport (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_remove_subscription (
-    CDitto_t const * ditto,
-    char const * collection,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by,
-    int32_t limit,
-    uint32_t offset);
-
-/** <No documentation available> */
-typedef struct CancelTokenResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    int64_t cancel_token;
-} CancelTokenResult_t;
-
-/** \brief
- *  Register a new callback to resolve the attachment.
- *
- *  The callback status could be:
- *  * `0` -- complete, with a handle that can be used in ditto_get_complete_attachment_path
- *  * `1` -- progress, with additional info about bytes downloaded and total bytes to download
- *  * `2` -- deleted, as the attachment ceased to exist in the doc database
- *
- *  A cancel token with value `0` represents nil/invalid. This means either an error
- *  occured, or the token has already been fetched or deleted. Note that in this case
- *  the `on_complete_cb` and `on_deleted_cb` callbacks _may_ be called synchronously
- *  even before this function completes.
- *
- *  Returns following error codes:
- *
- *  * `0` -- no error
- *  * `1` -- an error
- *  * `2` -- invalid id
- *  * `3` -- attachment not found
- *
- *  In case of a non-zero status code, error message can be retrieved using
- *  `ditto_error_message` function.
- */
-CancelTokenResult_t
-/* fn */ ditto_resolve_attachment (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t id,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*on_complete_cb)(void *, AttachmentHandle_t *),
-    void (*on_progress_cb)(void *, uint64_t, uint64_t),
-    void (*on_deleted_cb)(void *));
-
-/** <No documentation available> */
-uint32_t
-/* fn */ ditto_run_garbage_collection (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_android_is_inited (void);
-
-/** <No documentation available> */
-char *
-/* fn */ ditto_sdk_transports_android_missing_permissions (void);
-
-/** <No documentation available> */
-void *
-/* fn */ ditto_sdk_transports_android_missing_permissions_jni_array (void);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_sdk_transports_android_shutdown (void);
-
-/** <No documentation available> */
-typedef enum DittoSdkTransportsError {
-    /** <No documentation available> */
-    DITTO_SDK_TRANSPORTS_ERROR_NONE = 0,
-    /** <No documentation available> */
-    DITTO_SDK_TRANSPORTS_ERROR_GENERIC = 1,
-    /** <No documentation available> */
-    DITTO_SDK_TRANSPORTS_ERROR_UNAVAILABLE = 2,
-    /** <No documentation available> */
-    DITTO_SDK_TRANSPORTS_ERROR_MISSING_BLUETOOTH_INFO_PLIST_ENTRY = 3,
-} DittoSdkTransportsError_t;
-
-/** <No documentation available> */
-void *
-/* fn */ ditto_sdk_transports_awdl_create (
-    CDitto_t const * ditto,
-    DittoSdkTransportsError_t * out_error);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_awdl_destroy (
-    void * awdl,
-    DittoSdkTransportsError_t * out_error);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_awdl_is_available (
-    CDitto_t const * _ditto);
-
-/** <No documentation available> */
-void *
-/* fn */ ditto_sdk_transports_ble_create (
-    CDitto_t const * ditto,
-    DittoSdkTransportsError_t * out_error);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_ble_destroy (
-    void * ble,
-    DittoSdkTransportsError_t * out_error);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_ble_is_available (
-    CDitto_t const * _ditto);
-
-/** <No documentation available> */
-char *
-/* fn */ ditto_sdk_transports_error_description (
-    DittoSdkTransportsError_t error);
-
-/** \brief
- *  Frees the output of `ditto_sdk_transports_error_new`.
- */
-void
-/* fn */ ditto_sdk_transports_error_free (
-    DittoSdkTransportsError_t * it);
-
-/** \brief
- *  Obtain a fresh heap-allocated pointer to a (dummy) `DittoSdkTransportsError`.
- *
- *  This is useful for languages with no access to inline/stack allocations and/or unable
- *  to produce pointers themselves.
- */
-DittoSdkTransportsError_t *
-/* fn */ ditto_sdk_transports_error_new (void);
-
-/** \brief
- *  Obtain the value of a pointer to `DittoSdkTransportsError`
- */
-DittoSdkTransportsError_t
-/* fn */ ditto_sdk_transports_error_value (
-    DittoSdkTransportsError_t const * it);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_init (
-    DittoSdkTransportsError_t * out_error);
-
-/** <No documentation available> */
-void *
-/* fn */ ditto_sdk_transports_lan_create (
-    CDitto_t const * ditto,
-    DittoSdkTransportsError_t * out_error);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_lan_destroy (
-    void * lan,
-    DittoSdkTransportsError_t * out_error);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_lan_is_available (
-    CDitto_t const * _ditto);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_set_android_context (
-    void * env,
-    void * context);
-
-/** <No documentation available> */
-void *
-/* fn */ ditto_sdk_transports_wifi_aware_create (
-    CDitto_t const * ditto,
-    DittoSdkTransportsError_t * out_error);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_wifi_aware_destroy (
-    void * wifi_aware,
-    DittoSdkTransportsError_t * out_error);
-
-/** <No documentation available> */
-bool
-/* fn */ ditto_sdk_transports_wifi_aware_is_available (
-    CDitto_t const * _ditto);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_set_connect_retry_interval (
-    CDitto_t const * ditto,
-    uint32_t retry_interval_millis);
-
-/** <No documentation available> */
-char *
-/* fn */ ditto_set_device_name (
-    CDitto_t const * ditto,
-    char const * device_name);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_set_max_outgoing_ble_peers (
-    CDitto_t const * ditto,
-    uint32_t count);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_set_static_tcp_clients (
-    CDitto_t const * ditto,
-    slice_ref_char_const_ptr_t list_of_servers);
-
-/** \brief
- *  configure tcp clients, updates and maintains list of active Websocket peer clients only
- */
-void
-/* fn */ ditto_set_static_websocket_clients (
-    CDitto_t const * ditto,
-    slice_ref_char_const_ptr_t list_of_servers,
-    uint32_t routing_hint);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_set_sync_group (
-    CDitto_t const * ditto,
-    uint32_t sync_group);
-
-/** \brief
- *  Shut down Ditto.
- *
- *  All of the `Peer`'s subsystems are told to shut down, which includes, but is not limited to, the
- *  following happening:
- *  - all advertisers shut down
- *  - all servers stopped
- *  - all TCP listeners stopped
- *  - outbound replication stopped
- *
- *  All of the live queries associated with the Ditto instance are also stopped. Any file lock
- *  handles are dropped once any long-running tasks have had a chance to complete.
- */
-void
-/* fn */ ditto_shutdown (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Indicates whether small peer info feature is currently enabled.
- *
- *  `true` if enabled, and `false` if currently disabled. Small peer info
- *  consists of information scraped into a system collection at repeated
- *  interval.
- *
- *  Note: whether the background ingestion process is enabled or not is a
- *  separate decision to whether this information is allowed to sync to other
- *  peers (including the big peer). This is controlled by [`SyncScope`]s. For
- *  the FFI function to get the current sync scope, see
- *  [`ditto_small_peer_info_get_sync_scope`]. By default, the small peer info
- *  document will sync to the big peer.
- *
- *  [`SyncScope`]: DittoSmallPeerInfoSyncScope
- */
-bool
-/* fn */ ditto_small_peer_info_get_is_enabled (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Gets the JSON metadata being used in the small peer info document.
- *
- *  The metadata is free-form, user-provided JSON data that is inserted into
- *  the small peer info system doc at each collection interval. The data has no
- *  schema so it is returned as a c_string. We validated the incoming data with
- *  our constraints, and we do not modify this data, so the same constraints
- *  hold. The validation constraints are:
- *  1. The size of the metadata does not exceed [`SMALL_PEER_INFO_METADATA_SIZE_BYTES_MAX`]
- *  2. The metadata can be parsed as a JSON string and its max depth does not exceed
- *  [`SMALL_PEER_INFO_METADATA_DEPTH_MAX`]
- *  3. The metadata represents a JSON object that can be deserialized into a Map<String, Value>
- *
- *  An empty JSON object string is returned if the data has not been set.
- *
- *  This does not return the metadata from persistent storage. It only returns
- *  the data that has been set to be used by the collector
- *  (via [`ditto_small_peer_info_set_metadata`]) at each collector
- */
-char *
-/* fn */ ditto_small_peer_info_get_metadata (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Which peers to replicate the `__small_peer_info` collection to.
- *
- *  The syncing behavior is dictated by internal [`SyncScope`]s.
- *
- *  By default, the small peer info will sync with the big peer, as dictated by
- *  the default `BigPeerOnly` scope.
- *
- *  NOTE: Currently SDKs can only set [`BigPeerOnly`] or [`LocalPeerOnly`] sync
- *  scopes. [`AllPeers`] and [`SmallPeersOnly`] sync scopes are currently
- *  unsupported. Support for `AllPeers` and `SmallPeersOnly` will be added in
- *  the future, but for that we will need an API for users to subscribe to the
- *  small peer info of other peers.
- *
- *  [`SyncScope`]: ::ditto_store::sync_scope::SyncScope
- *  [`BigPeerOnly`]: ::ditto_store::sync_scope::SyncScope::BigPeerOnly
- *  [`LocalPeerOnly`]: ::ditto_store::sync_scope::SyncScope::LocalPeerOnly
- *  [`AllPeers`]: ::ditto_store::sync_scope::SyncScope::AllPeers
- *  [`SmallPeersOnly`]: ::ditto_store::sync_scope::SyncScope::SmallPeersOnly
- */
-typedef enum DittoSmallPeerInfoSyncScope {
-    /** <No documentation available> */
-    DITTO_SMALL_PEER_INFO_SYNC_SCOPE_BIG_PEER_ONLY,
-    /** <No documentation available> */
-    DITTO_SMALL_PEER_INFO_SYNC_SCOPE_LOCAL_PEER_ONLY,
-} DittoSmallPeerInfoSyncScope_t;
-
-/** \brief
- *  Gets the sync scope for the Small Peer Info collection.
- *
- *  A collection's [SyncScope] determines which "kind" of peers it will
- *  replicate to. The collection does not need to exist locally for this
- *  function to succeed. If no custom sync scope has been set or if the
- *  collection does not exist, the returned scope will be the default
- *  [`LocalPeerOnly`]. Currently, only [`BigPeerOnly`] and [`LocalPeerOnly`] are
- *  supported for small peer info; see [`DittoSmallPeerInfoSyncScope`] for
- *  details.
- *
- *  # Return Values
- *
- *  - Always returns a sync scope - either the custom override set by the user, or the default
- *  scope.
- *
- *  The function currently has no error conditions.
- *
- *  [`SyncScope`]: DittoSmallPeerInfoSyncScope
- *  [`BigPeerOnly`]: DittoSmallPeerInfoSyncScope::BigPeerOnly
- *  [`LocalPeerOnly`]: DittoSmallPeerInfoSyncScope::LocalPeerOnly
- */
-DittoSmallPeerInfoSyncScope_t
-/* fn */ ditto_small_peer_info_get_sync_scope (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Enables or disables the small peer info feature.
- *
- *  Small peer info consists of information scraped into a system collection at
- *  repeated intervals.
- *
- *  Note: whether the background ingestion process is enabled or not is a
- *  separate decision to whether this information is allowed to sync to other
- *  peers (including the big peer). This is controlled by [`SyncScope`]s. For
- *  the FFI function to set sync scopes, see
- *  [`ditto_small_peer_info_set_sync_scope`]. By default, the small peer info
- *  document will sync to the big peer.
- *
- *  [`SyncScope`]: DittoSmallPeerInfoSyncScope
- */
-void
-/* fn */ ditto_small_peer_info_set_enabled (
-    CDitto_t const * ditto,
-    bool set_enabled);
-
-/** \brief
- *  Sets the JSON metadata to be used in the small peer info document.
- *
- *  The metadata is free-form, user-provided JSON data that is inserted into
- *  the small peer info system doc at each collection interval. The data has no
- *  schema and is provided as a char_p, so data validation must be performed
- *  here. We validate:
- *  1. The size of the metadata does not exceed [`SMALL_PEER_INFO_METADATA_SIZE_BYTES_MAX`]
- *  2. The metadata can be parsed as a JSON string and its max depth does not exceed
- *  [`SMALL_PEER_INFO_METADATA_DEPTH_MAX`]
- *  3. The metadata represents a JSON object that can be deserialized into a Map<String, Value>
- *
- *  # Return Values
- *
- *  - Returns `0` if the input passes validation and is successfully set to be
- *  used in the small peer info document.
- *  - Returns `-1` in case the observability subsystem is unavailable (which
- *  should never be the case for the small peer).
- *  - Returns `1` if the amount of data is too large according to our
- *  self-imposed limits.
- *  - Returns `2` if the amount of JSON data is too nested according to our
- *  self-imposed limits, or if the data cannot be parsed to determine the depth.
- *  - Returns `3` if the data cannot be parsed as a Map<String, Value>
- */
-int32_t
-/* fn */ ditto_small_peer_info_set_metadata (
-    CDitto_t const * ditto,
-    char const * metadata);
-
-/** \brief
- *  Set the sync scope for the Small Peer Info collection.
- *
- *  A collection's [SyncScope] determines which "kind" of peers it will
- *  replicate to. This function can be used even if the Small Peer Info
- *  collection does not yet exist. Currently, only [`BigPeerOnly`] and
- *  [`LocalPeerOnly`] sync scopes are supported for small peer info; see
- *  [`DittoSmallPeerInfoSyncScope`] for details.
- *
- *  The function currently has no error conditions.
- *
- *  [`SyncScope`]: DittoSmallPeerInfoSyncScope
- *  [`BigPeerOnly`]: DittoSmallPeerInfoSyncScope::BigPeerOnly
- *  [`LocalPeerOnly`]: DittoSmallPeerInfoSyncScope::LocalPeerOnly
- */
-void
-/* fn */ ditto_small_peer_info_set_sync_scope (
-    CDitto_t const * ditto,
-    DittoSmallPeerInfoSyncScope_t scope);
-
-/** \brief
- *  Sets the transport config data contained in the small peer info.
- *
- *  Important note: This is not configuration data used to configure the SDK
- *  (yet) - it's simply another info field inserted into the small peer info
- *  document.
- *
- *  It's assumed that CBOR deserialization will succeed. If it fails then we'll
- *  panic. This is because this isn't something that should happen any time
- *  other than at (our (Ditto's)) development time.
- */
-void
-/* fn */ ditto_small_peer_info_set_transport_config_data (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t cbor);
-
-/** \brief
- *  Whether or not to offer a WebSocket sync server on the HTTP server.
- */
-typedef enum WebSocketMode {
-    /** <No documentation available> */
-    WEB_SOCKET_MODE_ENABLED,
-    /** <No documentation available> */
-    WEB_SOCKET_MODE_DISABLED,
-} WebSocketMode_t;
-
-/** \brief
- *  Start the WebSocket server
- *
- *  * `bind` - optional bind string of the form "ip:port"
- *  * `static_path` - optional absolute path to content on disk that should be served from `/`
- *  * `enable_websocket` - whether to enable a WebSocket server at the reserved path `/_ditto/ws`
- *  * `tls_cert_path` - path to this server's TLS certificate file, or null if not using TLS
- *  * `tls_key_path` - path to this server's TLS private key file, or null if not using TLS
- */
-int32_t
-/* fn */ ditto_start_http_server (
-    CDitto_t const * ditto,
-    char const * bind,
-    char const * static_path,
-    WebSocketMode_t enable_websocket,
-    char const * tls_cert_path,
-    char const * tls_key_path);
-
-/** \brief
- *  Start the WebSocket server
- */
-int32_t
-/* fn */ ditto_start_tcp_server (
-    CDitto_t const * ditto,
-    char const * bind);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_stop_http_server (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-int32_t
-/* fn */ ditto_stop_tcp_server (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Listen address of `tcp_listen_transport`.
- *
- *  Must be called after `transport_go_online()`.
- *  The return value must be freed with `ditto_c_string_free()`.
- */
-char *
-/* fn */ ditto_tcp_server_listen_addr (
-    CDitto_t const * ditto);
-
-/** \brief
- *  Request bulk status information about the transports. Intended mostly for
- *  statistical or debugging purposes.
- */
-char *
-/* fn */ ditto_transports_diagnostics (
-    CDitto_t const * ditto);
-
-/** \brief
- *  The whole point
- */
-int32_t
-/* fn */ ditto_unregister_and_free_legacy_subscription (
-    CDitto_t const * ditto,
-    LegacySubscriptionHandle_t * handle);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_unregister_local_auth_server (
-    CDitto_t * ditto);
-
-/** <No documentation available> */
-uint32_t
-/* fn */ ditto_validate_document_id (
-    slice_ref_uint8_t cbor,
-    slice_boxed_uint8_t * out_cbor);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_vec_char_ptr_free (
-    Vec_char_ptr_t char_p);
-
-/** <No documentation available> */
-void
-/* fn */ ditto_vec_slice_boxed_uint8_t_free (
-    Vec_slice_boxed_uint8_t slice_boxed);
-
-/** \brief
- *  Same as [`Vec<T>`][`rust::Vec`], but with guaranteed `#[repr(C)]` layout
- */
-typedef struct Vec_size {
-    /** <No documentation available> */
-    size_t * ptr;
-
-    /** <No documentation available> */
-    size_t len;
-
-    /** <No documentation available> */
-    size_t cap;
-} Vec_size_t;
-
-/** <No documentation available> */
-void
-/* fn */ ditto_vec_usizes_free (
-    Vec_size_t usizes);
-
-/** <No documentation available> */
-typedef enum LicenseVerificationResult {
-    /** <No documentation available> */
-    LICENSE_VERIFICATION_RESULT_LICENSE_OK = 0,
-    /** <No documentation available> */
-    LICENSE_VERIFICATION_RESULT_VERIFICATION_FAILED = -1,
-    /** <No documentation available> */
-    LICENSE_VERIFICATION_RESULT_LICENSE_EXPIRED = -2,
-    /** <No documentation available> */
-    LICENSE_VERIFICATION_RESULT_UNSUPPORTED_FUTURE_VERSION = -3,
-} LicenseVerificationResult_t;
-
-/** \brief
- *  Verify a base64 encoded license string
- *
- *  # Parameters
- *  - `license`: A base64 encoded license string. This should be the output of
- *  `ditto_licenser::license_mgr::generate()`.
- *  - `out_error_msg`: An optional error message out parameter which will be written to if the
- *  license verification. This error message is simplified and appropriate to show directly to an
- *  SDK user.
- */
-LicenseVerificationResult_t
-/* fn */ ditto_verify_license (
-    char const * license,
-    char * * out_err_msg);
-
-/** \brief
- *  The SDK requests to drop its handle to the WifiAware discovery 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_wifi_aware_client_free_handle (
-    TransportHandle_WifiAwareClientPlatformEvent_t * handle);
-
-/** \brief
- *  The platform advises Rust that we have resolved a peer's hostname and port
- */
-void
-/* fn */ ditto_wifi_aware_client_network_did_create (
-    TransportHandle_WifiAwareClientPlatformEvent_t const * handle,
-    char const * announce_string,
-    char const * hostname,
-    uint16_t port);
-
-/** \brief
- *  The platform advises Rust that a peer has been identified.
- */
-void
-/* fn */ ditto_wifi_aware_client_peer_appeared (
-    TransportHandle_WifiAwareClientPlatformEvent_t const * handle,
-    char const * announce_string);
-
-/** \brief
- *  The platform advises Rust that we failed to resolve a peer's hostname and
- *  port
- */
-void
-/* fn */ ditto_wifi_aware_client_peer_did_not_connect (
-    TransportHandle_WifiAwareClientPlatformEvent_t const * handle,
-    char const * announce_string);
-
-/** \brief
- *  The platform advises Rust that a peer's service has disappeared from WifiAware.
- */
-void
-/* fn */ ditto_wifi_aware_client_peer_disappeared (
-    TransportHandle_WifiAwareClientPlatformEvent_t const * handle,
-    char const * announce_string);
-
-/** \brief
- *  The platform advises Rust that the status of searching for services has
- *  changed.
- */
-void
-/* fn */ ditto_wifi_aware_client_scanning_state_changed (
-    TransportHandle_WifiAwareClientPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t condition);
-
-/** \brief
- *  The platform advises Rust that the status of publishing our service has
- *  changed.
- */
-void
-/* fn */ ditto_wifi_aware_server_advertising_state_changed (
-    TransportHandle_WifiAwareServerPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t condition);
-
-/** \brief
- *  The SDK requests to drop its handle to the WifiAware advertising service.
- *
- *  Ideally this should remove the advertiser automatically.
- *  At time of writing now this must be done manually through Peer.
- */
-void
-/* fn */ ditto_wifi_aware_server_free_handle (
-    TransportHandle_WifiAwareServerPlatformEvent_t * handle);
-
-/** <No documentation available> */
-typedef struct CWriteTransactionResult {
-    /** <No documentation available> */
-    int32_t status_code;
-
-    /** <No documentation available> */
-    CWriteTransaction_t * txn;
-} CWriteTransactionResult_t;
-
-/** <No documentation available> */
-CWriteTransactionResult_t
-/* fn */ ditto_write_transaction (
-    CDitto_t const * ditto,
-    char const * log_hint);
-
-/** \brief
- *  Sets some arbitrary metadata on a write transaction.
- *
- *  This is currently only useful and relevant if history tracking is enabled in
- *  the store that the write transaction relates to. If history tracking is
- *  enabled and metadata is set on a write transaction then the document
- *  inserted into the `__history` collection will have (at least) the provided
- *  metadata stored under the `meta` key of the document.
- *
- *  Return codes:
- *
- *  * `0` -- success
- *  * `1` -- invalid metadata CBOR
- *  * `-1` -- valid metadata CBOR but the CBOR does not represent an object
- *  * `-2` -- [js only] missing `await`s
- */
-int32_t
-/* fn */ ditto_write_transaction_add_metadata (
-    CWriteTransaction_t * transaction,
-    slice_ref_uint8_t metadata_cbor);
-
-/** \brief
- *  Commits the given txn.
- *
- *  [js only]: returns -1 on failure, in case of missing `await`s.
- */
-int32_t
-/* fn */ ditto_write_transaction_commit (
-    CDitto_t const * ditto,
-    CWriteTransaction_t * transaction);
-
-/** \brief
- *  Frees the txn handle, *falling back* to a rollback, which requires
- *  `async`-in-drop. Only useful as a safeguard for RAII-with-proper-ownership
- *  languages, _i.e._, the Rust SDK.
- *
- *  For other languages, favor using `ditto_write_transaction_rollback`
- */
-void
-/* fn */ ditto_write_transaction_free (
-    CWriteTransaction_t * transaction);
-
-/** \brief
- *  For SDKs using the batched/scoped write-txn APIs, if an error occurs
- *  mid-operation (_e.g._, customer callback throwing an exception), then the
- *  txn must not be committed, but it ought to be disposed of, _via_ a rollback.
- *
- *  [js only]: returns -1 on failure, in case of missing `await`s.
- */
-int32_t
-/* fn */ ditto_write_transaction_rollback (
-    CDitto_t const * _ditto,
-    CWriteTransaction_t * transaction);
-
-/** \brief
- *  To be used when base64 encoding or decoding.
- *
- *  When encoding, specifies whether to produce padded or unpadded output. When decoding, specifies
- *  whether or not to accept a padded input string.
- */
-typedef enum Base64PaddingMode {
-    /** <No documentation available> */
-    BASE64_PADDING_MODE_PADDED = 1,
-    /** <No documentation available> */
-    BASE64_PADDING_MODE_UNPADDED,
-} Base64PaddingMode_t;
-
-/** \brief
- *  Encodes a slice of bytes as a URL-safe base64 string. The caller can specify whether or not they
- *  want the output to be padded.
- *
- *  The returned string needs to be freed by the caller using `ditto_c_string_free`.
- */
-char *
-/* fn */ dittoffi_base64_encode (
-    slice_ref_uint8_t bytes,
-    Base64PaddingMode_t padding_mode);
-
-/** <No documentation available> */
-BoolResult_t
-/* fn */ dittoffi_check_doc_cbor_against_provided_cbor (
-    slice_ref_uint8_t document_cbor,
-    slice_ref_uint8_t provided_cbor);
-
-/** \brief
- *  Opaque type encapsulating the different args provided to the `.on_connecting()`
- *  callback in a future-proof fashion.
- *
- *  This is the lowest-level "wrapped" callback, i.e. the most convenient set of types for
- *  passing across the FFI barrier.
- *
- *  Typically, SDKs will have a wrapping method that does the (de)serialization to/from CBOR
- *  to create a more user-friendly function signature for `connecting_peer`.
- */
-typedef struct dittoffi_connection_request dittoffi_connection_request_t;
-
-/** <No documentation available> */
-typedef enum dittoffi_connection_request_authorization {
-    /** <No documentation available> */
-    DITTOFFI_CONNECTION_REQUEST_AUTHORIZATION_DENY,
-    /** <No documentation available> */
-    DITTOFFI_CONNECTION_REQUEST_AUTHORIZATION_ALLOW,
-} dittoffi_connection_request_authorization_t;
-
-/** \brief
- *  Answer/output of the `connection_request_handler`, communicated through the `connection_request`
- *  object.
- *  `true` allows the connection, `false` rejects it.
- */
-void
-/* fn */ dittoffi_connection_request_authorize (
-    dittoffi_connection_request_t const * r,
-    dittoffi_connection_request_authorization_t authorized);
-
-/** \brief
- *  A simplified [`ConnectionType`] exposed to the SDKs
- */
-typedef enum dittoffi_connection_type {
-    /** <No documentation available> */
-    DITTOFFI_CONNECTION_TYPE_BLUETOOTH,
-    /** <No documentation available> */
-    DITTOFFI_CONNECTION_TYPE_ACCESS_POINT,
-    /** <No documentation available> */
-    DITTOFFI_CONNECTION_TYPE_P2_P_WI_FI,
-    /** <No documentation available> */
-    DITTOFFI_CONNECTION_TYPE_WEB_SOCKET,
-} dittoffi_connection_type_t;
-
-/** \brief
- *  The connection type being used to connect with the connecting peer.
- */
-dittoffi_connection_type_t
-/* fn */ dittoffi_connection_request_connection_type (
-    dittoffi_connection_request_t const * r);
-
-/** <No documentation available> */
-void
-/* fn */ dittoffi_connection_request_free (
-    dittoffi_connection_request_t * __arg_0);
-
-/** \brief
- *  Getter for the `identity_service` as a JSON (string / UTF-8 data).
- */
-slice_ref_uint8_t
-/* fn */ dittoffi_connection_request_identity_service_metadata_json (
-    dittoffi_connection_request_t const * r);
-
-/** \brief
- *  The connecting peer's (pub) key (empty for legacy peers), hex-encoded as a string
- */
-char *
-/* fn */ dittoffi_connection_request_peer_key_string (
-    dittoffi_connection_request_t const * r);
-
-/** \brief
- *  Getter for the `peer_metadata` as a JSON (string / UTF-8 data).
- */
-slice_ref_uint8_t
-/* fn */ dittoffi_connection_request_peer_metadata_json (
-    dittoffi_connection_request_t const * r);
-
-/** \brief
- *  Generates 32 random bytes and returns them as a base64 (URL safe and padded) encoded string.
- *
- *  The returned string needs to be freed using `ditto_c_string_free`.
- *
- *  Note: This is currently only being used by the JS SDK. Any other usage of this function is
- *  likely indicative of a deficiency in the API being provided to SDKs.
- */
-char *
-/* fn */ dittoffi_crypto_generate_secure_random_token (void);
-
-/** <No documentation available> */
-slice_boxed_uint8_t
-/* fn */ dittoffi_ditto_default_transport_config_with_all_p2p_enabled (void);
-
-/** <No documentation available> */
-slice_boxed_uint8_t
-/* fn */ dittoffi_ditto_effective_transport_config (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-void
-/* fn */ dittoffi_ditto_stop_sync (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-slice_boxed_uint8_t
-/* fn */ dittoffi_ditto_transport_config (
-    CDitto_t const * ditto);
-
-/** \brief
- *  The ditto error type, opaque.
- */
-typedef struct dittoffi_error dittoffi_error_t;
-
-/** <No documentation available> */
-typedef struct dittoffi_result_CDitto_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.
-     */
-    CDitto_t * success;
-} dittoffi_result_CDitto_ptr_t;
-
-/** \brief
- *  Same as `ditto_make`, but properly fallible (but not yet `async`).
- */
-dittoffi_result_CDitto_ptr_t
-/* fn */ dittoffi_ditto_try_new_blocking (
-    char const * working_dir,
-    CIdentityConfig_t * identity_config,
-    HistoryTracking_t history_tracking,
-    char const * experimental_passphrase);
-
-/** <No documentation available> */
-typedef struct dittoffi_result_void {
-    /** \brief
-     *  Non-`NULL` pointer to opaque object on error, `NULL` otherwise.
-     */
-    dittoffi_error_t * error;
-} dittoffi_result_void_t;
-
-/** \brief
- *  Set the transport config, start/stop transports as needed.
- *
- *  * `transport_config_cbor` - `TransportConfig` serialized into cbor format.
- *  Returns error on failure to deserialize `transport_config_cbor`
- */
-dittoffi_result_void_t
-/* fn */ dittoffi_ditto_try_set_transport_config (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t transport_config_cbor);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_ditto_try_start_sync (
-    CDitto_t const * ditto);
-
-/** \brief
- *  The error codes for `ditto_error_t`
- */
-typedef enum dittoffi_error_code {
-    /** \brief
-     *  The license signature failed verification. This could be due to incorrectly
-     *  encoded/truncated data or could indicate tampering.
-     */
-    DITTOFFI_ERROR_CODE_ACTIVATION_LICENSE_TOKEN_INVALID,
-    /** \brief
-     *  The license is valid but expired.
-     */
-    DITTOFFI_ERROR_CODE_ACTIVATION_LICENSE_TOKEN_EXPIRED,
-    /** \brief
-     *  The provided license data was from a future version of Ditto and is incompatible with this
-     *  version.
-     */
-    DITTOFFI_ERROR_CODE_ACTIVATION_LICENSE_UNSUPPORTED_FUTURE_VERSION,
-    /** \brief
-     *  The operation failed because the Ditto instance is not yet activated.
-     */
-    DITTOFFI_ERROR_CODE_ACTIVATION_NOT_ACTIVATED,
-    /** \brief
-     *  Invalid CBOR-encoded input.
-     */
-    DITTOFFI_ERROR_CODE_CBOR_INVALID,
-    /** \brief
-     *  Unsupported CBOR type.
-     */
-    DITTOFFI_ERROR_CODE_CBOR_UNSUPPORTED,
-    /** \brief
-     *  Found an invalid document id.
-     */
-    DITTOFFI_ERROR_CODE_STORE_DOCUMENT_ID,
-    /** \brief
-     *  The requested document could not be found.
-     */
-    DITTOFFI_ERROR_CODE_STORE_DOCUMENT_NOT_FOUND,
-    /** <No documentation available> */
-    DITTOFFI_ERROR_CODE_STORE_DATABASE,
-    /** <No documentation available> */
-    DITTOFFI_ERROR_CODE_STORE_QUERY,
-    /** \brief
-     *  A query to alter or retrieve a system parameter (ALTER SYSTEM or SHOW) failed.
-     */
-    DITTOFFI_ERROR_CODE_PARAMETER_QUERY,
-    /** <No documentation available> */
-    DITTOFFI_ERROR_CODE_CRDT,
-    /** \brief
-     *  Javascript only. Missing `await` on outstanding store operation.
-     */
-    DITTOFFI_ERROR_CODE_JS_FLOATING_STORE_OPERATION,
-    /** \brief
-     *  Failed to compile the given query.
-     *
-     *  For more information on Ditto's query language see:
-     *  <https://docs.ditto.live/dql-guide>
-     */
-    DITTOFFI_ERROR_CODE_DQL_QUERY_COMPILATION,
-    /** \brief
-     *  Dql query execution failed in flight.
-     */
-    DITTOFFI_ERROR_CODE_DQL_EVALUATION_ERROR,
-    /** \brief
-     *  Invalid CBOR-encoded query arguments.
-     */
-    DITTOFFI_ERROR_CODE_DQL_INVALID_QUERY_ARGS,
-    /** \brief
-     *  Unsupported features were used in a DQL statement or query.
-     */
-    DITTOFFI_ERROR_CODE_DQL_UNSUPPORTED,
-    /** \brief
-     *  Error from the transport layer
-     */
-    DITTOFFI_ERROR_CODE_TRANSPORT,
-    /** \brief
-     *  Exceeded a depth limit.
-     */
-    DITTOFFI_ERROR_CODE_VALIDATION_DEPTH_LIMIT_EXCEEDED,
-    /** \brief
-     *  The value was not a map.
-     */
-    DITTOFFI_ERROR_CODE_VALIDATION_NOT_A_MAP,
-    /** \brief
-     *  Exceeded the size limit.
-     */
-    DITTOFFI_ERROR_CODE_VALIDATION_SIZE_LIMIT_EXCEEDED,
-    /** \brief
-     *  Invalid JSON provided.
-     */
-    DITTOFFI_ERROR_CODE_VALIDATION_INVALID_JSON,
-    /** \brief
-     *  Invalid CBOR provided.
-     */
-    DITTOFFI_ERROR_CODE_VALIDATION_INVALID_CBOR,
-    /** \brief
-     *  Invalid input provided for base64 decoding.
-     */
-    DITTOFFI_ERROR_CODE_BASE64_INVALID,
-    /** \brief
-     *  Outstanding usage of ditto's working directory detected when trying to instantiate a new
-     *  `Ditto`, which would have led to concurrent usage of the backing database files.
-     */
-    DITTOFFI_ERROR_CODE_LOCKED_DITTO_WORKING_DIRECTORY,
-    /** \brief
-     *  An I/O operation failed because the specified entity (such as a file) was not found.
-     */
-    DITTOFFI_ERROR_CODE_IO_NOT_FOUND,
-    /** \brief
-     *  An I/O operation failed because the necessary privileges to complete it were not present.
-     */
-    DITTOFFI_ERROR_CODE_IO_PERMISSION_DENIED,
-    /** \brief
-     *  An I/O operation failed because the specified entity (such as a file) already exists.
-     */
-    DITTOFFI_ERROR_CODE_IO_ALREADY_EXISTS,
-    /** \brief
-     *  An I/O operation failed.
-     */
-    DITTOFFI_ERROR_CODE_IO_OPERATION_FAILED,
-    /** \brief
-     *  Feature is not (yet?) supported (on this platform?).
-     *
-     *  See the documentation of the feature for more info.
-     */
-    DITTOFFI_ERROR_CODE_UNSUPPORTED,
-    /** \brief
-     *  An unknown error occurred.
-     */
-    DITTOFFI_ERROR_CODE_UNKNOWN,
-    /** \brief
-     *  Some not-yet-categorized error occurred.
-     */
-    DITTOFFI_ERROR_CODE_INTERNAL,
-} dittoffi_error_code_t;
-
-/** <No documentation available> */
-dittoffi_error_code_t
-/* fn */ dittoffi_error_code (
-    dittoffi_error_t const * error);
-
-/** <No documentation available> */
-char *
-/* fn */ dittoffi_error_description (
-    dittoffi_error_t const * error);
-
-/** <No documentation available> */
-void
-/* fn */ dittoffi_error_free (
-    dittoffi_error_t * error);
-
-/** \brief
- *  Returns a human-readable SDK version string, restricted to the SemVer
- *  "number" (including the pre-release specifier, if any).
- *
- *  The returned string must be freed.
- */
-char *
-/* fn */ dittoffi_get_sdk_semver (void);
-
-/** <No documentation available> */
-typedef struct dittoffi_result_uint64 {
-    /** \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.
-     */
-    uint64_t success;
-} dittoffi_result_uint64_t;
-
-/** \brief
- *  `Box<dyn 'static + Send + FnMut(A1) -> Ret>`
- */
-typedef struct BoxDynFnMut1_void_dittoffi_result_uint64 {
-    /** <No documentation available> */
-    void * env_ptr;
-
-    /** <No documentation available> */
-    void (*call)(void *, dittoffi_result_uint64_t);
-
-    /** <No documentation available> */
-    void (*free)(void *);
-} BoxDynFnMut1_void_dittoffi_result_uint64_t;
-
-/** \brief
- *  Export previously collected on-disk logs to a single file at the specified path.
- *
- *  Returns one of the following errors on failure:
- *
- *  - [`FfiError::IoNotFound`]
- *  - [`FfiError::IoPermissionDenied`]
- *  - [`FfiError::IoAlreadyExists`]
- *  - [`FfiError::IoOperationFailed`]
- *  - [`FfiError::Unsupported`]
- *  - [`FfiError::Unknown`]
- */
-void
-/* fn */ dittoffi_logger_try_export_to_file_async (
-    char const * dest_path,
-    BoxDynFnMut1_void_dittoffi_result_uint64_t completion);
-
-/** \brief
- *  Getter for the `peer_metadata` as a JSON (string / UTF-8 data).
- */
-slice_boxed_uint8_t
-/* fn */ dittoffi_presence_peer_metadata_json (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-typedef struct Erased Erased_t;
-
-/** <No documentation available> */
-typedef struct FfiConnectionRequestHandlerVTable {
-    /** <No documentation available> */
-    void (*release_vptr)(Erased_t *);
-
-    /** <No documentation available> */
-    Erased_t * (*retain_vptr)(Erased_t const *);
-
-    /** <No documentation available> */
-    void (*on_connecting)(Erased_t const *, dittoffi_connection_request_t *);
-} FfiConnectionRequestHandlerVTable_t;
-
-/** <No documentation available> */
-typedef struct VirtualPtr__Erased_ptr_FfiConnectionRequestHandlerVTable {
-    /** <No documentation available> */
-    Erased_t * ptr;
-
-    /** <No documentation available> */
-    FfiConnectionRequestHandlerVTable_t vtable;
-} VirtualPtr__Erased_ptr_FfiConnectionRequestHandlerVTable_t;
-
-/** \brief
- *  Register a function that will be called every time a peer connection attempt is made.
- *  The function can return true to continue connecting, and false to reject the connection,
- *  based on the supplied metadata about the peer.
- */
-void
-/* fn */ dittoffi_presence_set_connection_request_handler (
-    CDitto_t const * ditto,
-    VirtualPtr__Erased_ptr_FfiConnectionRequestHandlerVTable_t ffi_handler);
-
-/** \brief
- *  Sets the signed peer info / peer metadata to which the `on_connecting` /
- *  `connectionRequestHandler` callback shall have access.
- *
- *  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_try_set_peer_metadata_json (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t peer_info);
-
-/** <No documentation available> */
-typedef struct dittoffi_query_result dittoffi_query_result_t;
-
-/** <No documentation available> */
-void
-/* fn */ dittoffi_query_result_free (
-    dittoffi_query_result_t * result);
-
-/** <No documentation available> */
-typedef struct dittoffi_query_result_item dittoffi_query_result_item_t;
-
-/** <No documentation available> */
-dittoffi_query_result_item_t *
-/* fn */ dittoffi_query_result_item_at (
-    dittoffi_query_result_t const * result,
-    size_t idx);
-
-/** <No documentation available> */
-slice_boxed_uint8_t
-/* fn */ dittoffi_query_result_item_cbor (
-    dittoffi_query_result_item_t const * item);
-
-/** <No documentation available> */
-size_t
-/* fn */ dittoffi_query_result_item_count (
-    dittoffi_query_result_t const * result);
-
-/** <No documentation available> */
-void
-/* fn */ dittoffi_query_result_item_free (
-    dittoffi_query_result_item_t * item);
-
-/** <No documentation available> */
-char *
-/* fn */ dittoffi_query_result_item_json (
-    dittoffi_query_result_item_t const * item);
-
-/** <No documentation available> */
-slice_boxed_uint8_t
-/* fn */ dittoffi_query_result_mutated_document_id_at (
-    dittoffi_query_result_t const * result,
-    size_t idx);
-
-/** <No documentation available> */
-size_t
-/* fn */ dittoffi_query_result_mutated_document_id_count (
-    dittoffi_query_result_t const * result);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_add_subscription (
-    CDitto_t const * ditto,
-    char const * collection,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by,
-    int32_t limit,
-    uint32_t offset);
-
-/** \brief
- *  Adds a DQL sync subscription.
- *
- *  Only `SELECT` statements are supported here.
- *
- *  Returns no meaningful value but for the resulting potential `.error`.
- */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_add_sync_subscription (
-    CDitto_t const * ditto,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor);
-
-/** <No documentation available> */
-typedef struct dittoffi_result_slice_boxed_uint8 {
-    /** \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.
-     */
-    slice_boxed_uint8_t success;
-} dittoffi_result_slice_boxed_uint8_t;
-
-/** \brief
- *  Decodes a URL-safe base64-encoded string. The caller can specify whether or not they want to
- *  allow padded input. By default, both padded and unpadded input is accepted.
- *
- *  In the success case, the returned bytes need to be freed by the caller using
- *  `ditto_c_bytes_free`.
- *
- *  Throws `FfiError::Base64Invalid` if:
- *  - the input string is not a valid base64-encoded string, or
- *  - the desired padding mode is specified as `Unpadded` and the input string is padded.
- */
-dittoffi_result_slice_boxed_uint8_t
-/* fn */ dittoffi_try_base64_decode (
-    char const * str,
-    Base64PaddingMode_t padding_mode);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_collection (
-    CDitto_t const * ditto,
-    char const * name);
-
-/** <No documentation available> */
-typedef struct dittoffi_result_bool {
-    /** \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.
-     */
-    bool success;
-} dittoffi_result_bool_t;
-
-/** <No documentation available> */
-dittoffi_result_bool_t
-/* fn */ dittoffi_try_collection_evict (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    slice_ref_uint8_t id);
-
-/** <No documentation available> */
-typedef struct dittoffi_result_Vec_slice_boxed_uint8 {
-    /** \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.
-     */
-    Vec_slice_boxed_uint8_t success;
-} dittoffi_result_Vec_slice_boxed_uint8_t;
-
-/** <No documentation available> */
-dittoffi_result_Vec_slice_boxed_uint8_t
-/* fn */ dittoffi_try_collection_evict_by_ids (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    slice_ref_slice_boxed_uint8_t ids);
-
-/** <No documentation available> */
-dittoffi_result_Vec_slice_boxed_uint8_t
-/* fn */ dittoffi_try_collection_evict_query_str (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by_params,
-    int32_t limit,
-    uint32_t offset);
-
-/** <No documentation available> */
-typedef struct docs_and_ids {
-    /** <No documentation available> */
-    Vec_CDocument_ptr_t documents;
-
-    /** <No documentation available> */
-    Vec_slice_boxed_uint8_t ids;
-} docs_and_ids_t;
-
-/** <No documentation available> */
-typedef struct dittoffi_result_docs_and_ids {
-    /** \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.
-     */
-    docs_and_ids_t success;
-} dittoffi_result_docs_and_ids_t;
-
-/** <No documentation available> */
-dittoffi_result_docs_and_ids_t
-/* fn */ dittoffi_try_collection_find_by_ids (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    slice_ref_slice_boxed_uint8_t ids,
-    CReadTransaction_t * transaction);
-
-/** <No documentation available> */
-typedef struct dittoffi_result_CDocument_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.
-     */
-    CDocument_t * success;
-} dittoffi_result_CDocument_ptr_t;
-
-/** \brief
- *  [js only] Returns `-1` in case of outstanding non-`awaited` transaction operation.
- */
-dittoffi_result_CDocument_ptr_t
-/* fn */ dittoffi_try_collection_get (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    slice_ref_uint8_t id,
-    CReadTransaction_t * transaction);
-
-/** <No documentation available> */
-dittoffi_result_slice_boxed_uint8_t
-/* fn */ dittoffi_try_collection_insert_value (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    slice_ref_uint8_t doc_cbor,
-    WriteStrategyRs_t write_strategy,
-    char const * log_hint,
-    CWriteTransaction_t * txn);
-
-/** <No documentation available> */
-dittoffi_result_bool_t
-/* fn */ dittoffi_try_collection_remove (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    slice_ref_uint8_t id);
-
-/** <No documentation available> */
-dittoffi_result_Vec_slice_boxed_uint8_t
-/* fn */ dittoffi_try_collection_remove_by_ids (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    slice_ref_slice_boxed_uint8_t ids);
-
-/** <No documentation available> */
-dittoffi_result_Vec_slice_boxed_uint8_t
-/* fn */ dittoffi_try_collection_remove_query_str (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by_params,
-    int32_t limit,
-    uint32_t offset);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_collection_update (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    CDocument_t * document);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_collection_update_multiple (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    CWriteTransaction_t * transaction,
-    Vec_CDocument_ptr_t documents);
-
-/** <No documentation available> */
-dittoffi_result_slice_boxed_uint8_t
-/* fn */ dittoffi_try_document_get_cbor_with_path_type (
-    CDocument_t const * document,
-    char const * pointer,
-    PathAccessorType_t path_type);
-
-/** <No documentation available> */
-typedef struct dittoffi_result_dittoffi_query_result_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_query_result_t * success;
-} dittoffi_result_dittoffi_query_result_ptr_t;
-
-/** \brief
- *  Execute specified DQL statement
- *
- *  Returns a QueryResult, which contains vector of QueryResultItems.
- *
- *  This is replacement for the old FFI, which was returning documents.
- */
-dittoffi_result_dittoffi_query_result_ptr_t
-/* fn */ dittoffi_try_exec_statement (
-    CDitto_t const * ditto,
-    CWriteTransaction_t * txn,
-    char const * statement,
-    slice_ref_uint8_t args_cbor);
-
-/** <No documentation available> */
-typedef struct ChangeHandlerWithQueryResult {
-    /** \brief
-     *  Must be freed with `dittoffi_query_result_free`.
-     */
-    dittoffi_query_result_t * query_result;
-} ChangeHandlerWithQueryResult_t;
-
-/** <No documentation available> */
-typedef struct dittoffi_result_int64 {
-    /** \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.
-     */
-    int64_t success;
-} dittoffi_result_int64_t;
-
-/** <No documentation available> */
-dittoffi_result_int64_t
-/* fn */ dittoffi_try_experimental_register_change_observer_str (
-    CDitto_t const * ditto,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    LiveQueryAvailability_t lq_availability,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*c_cb)(void *, ChangeHandlerWithQueryResult_t));
-
-/** <No documentation available> */
-typedef struct dittoffi_result_Vec_char_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.
-     */
-    Vec_char_ptr_t success;
-} dittoffi_result_Vec_char_ptr_t;
-
-/** <No documentation available> */
-dittoffi_result_Vec_char_ptr_t
-/* fn */ dittoffi_try_get_collection_names (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_live_query_start (
-    CDitto_t const * ditto,
-    int64_t id);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_live_query_webhook_generate_new_api_secret (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-dittoffi_result_slice_boxed_uint8_t
-/* fn */ dittoffi_try_live_query_webhook_register_str (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    char const * query,
-    slice_ref_COrderByParam_t order_by,
-    int32_t limit,
-    uint32_t offset,
-    char const * url);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_live_query_webhook_start_all (
-    CDitto_t const * ditto);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_live_query_webhook_start_by_id (
-    CDitto_t const * ditto,
-    slice_ref_uint8_t doc_id);
-
-/** <No documentation available> */
-dittoffi_result_uint64_t
-/* fn */ dittoffi_try_queries_hash (
-    CDitto_t const * ditto,
-    slice_ref_char_const_ptr_t coll_names,
-    slice_ref_char_const_ptr_t queries);
-
-/** <No documentation available> */
-typedef struct dittoffi_result_char_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.
-     */
-    char * success;
-} dittoffi_result_char_ptr_t;
-
-/** <No documentation available> */
-dittoffi_result_char_ptr_t
-/* fn */ dittoffi_try_queries_hash_mnemonic (
-    CDitto_t const * ditto,
-    slice_ref_char_const_ptr_t coll_names,
-    slice_ref_char_const_ptr_t queries);
-
-/** <No documentation available> */
-dittoffi_result_int64_t
-/* fn */ dittoffi_try_register_store_observer (
-    CDitto_t const * ditto,
-    char const * coll_name,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by,
-    int32_t limit,
-    uint32_t offset,
-    LiveQueryAvailability_t lq_availability,
-    void * ctx,
-    void (*retain)(void *),
-    void (*release)(void *),
-    void (*c_cb)(void *, c_cb_params_t));
-
-/** <No documentation available> */
-dittoffi_result_slice_boxed_uint8_t
-/* fn */ dittoffi_try_register_store_observer_webhook (
-    CDitto_t const * ditto,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    char const * url);
-
-/** <No documentation available> */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_remove_subscription (
-    CDitto_t const * ditto,
-    char const * collection,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor,
-    slice_ref_COrderByParam_t order_by,
-    int32_t limit,
-    uint32_t offset);
-
-/** \brief
- *  Removes a DQL sync subscription.
- *
- *  The arguments should be identical to the ones used during adding the subscription.
- *  Returns no meaningful value but for the resulting potential `.error`.
- */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_remove_sync_subscription (
-    CDitto_t const * ditto,
-    char const * query,
-    slice_ref_uint8_t query_args_cbor);
-
-/** \brief
- *  Verify a base64 encoded license string.
- *
- *  # Parameters
- *  - `license`: A base64 encoded license string. This should be the output of
- *  `ditto_licenser::license_mgr::generate()`.
- */
-dittoffi_result_void_t
-/* fn */ dittoffi_try_verify_license (
-    char const * license);
-
-/** <No documentation available> */
-void
-/* fn */ free_c_string_vec (
-    Vec_char_ptr_t * strings);
-
-/** \brief
- *  The platform advises Rust that the status of publishing our service has
- *  changed.
- */
-void
-/* fn */ mdns_advertising_state_changed (
-    TransportHandle_MdnsServerPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t condition);
-
-/** \brief
- *  The SDK requests to drop its handle to the mDNS discovery 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 */ mdns_client_free_handle (
-    TransportHandle_MdnsClientPlatformEvent_t * handle);
-
-/** \brief
- *  The platform advises Rust that a peer has been identified.
- */
-void
-/* fn */ mdns_platform_peer_appeared (
-    TransportHandle_MdnsClientPlatformEvent_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_MdnsClientPlatformEvent_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_MdnsClientPlatformEvent_t const * handle,
-    OnlineState_t state,
-    TransportCondition_t condition);
-
-/** \brief
- *  The SDK requests to drop its handle to the mDNS advertising service.
- *
- *  Ideally this should remove the advertiser automatically.
- *  At time of writing now this must be done manually through Peer.
- */
-void
-/* fn */ mdns_server_free_handle (
-    TransportHandle_MdnsServerPlatformEvent_t * handle);
-
-/** \brief
- *  The platform advises Rust that the TCP listener will need to be restarted.
- */
-void
-/* fn */ mdns_server_invalidate_listener (
-    TransportHandle_MdnsServerPlatformEvent_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_MdnsClientPlatformEvent_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_MdnsClientPlatformEvent_t const * handle,
-    char const * announce_string,
-    char const * hostname,
-    uint16_t port);
-
-/** <No documentation available> */
-Vec_char_ptr_t *
-/* fn */ new_c_string_vec (void);
-
-/** \brief
- *  The SDK requests to drop its handle to this TCP Client transport
- */
-void
-/* fn */ static_tcp_client_free_handle (
-    TransportHandle_StaticTcpClientPlatformEvent_t * handle);
-
-/** \brief
- *  The SDK requests to drop its handle to this WebSocket Client transport
- */
-void
-/* fn */ websocket_client_free_handle (
-    TransportHandle_WebsocketClientPlatformEvent_t * handle);
-
-
-#ifdef __cplusplus
-} /* extern \"C\" */
-#endif
-
-#endif /* __RUST_DITTOFFI__ */