#pragma once

#include "message.h"

#ifdef __cplusplus

extern "C" {

#endif

// decorate_message() - decorate a message with payload

//

//  parameters:

//      msg (inout)     message to decorate

//      payload (in)    payload to send

//      size (in)       size of payload

//

//  returns:

//      PEP_STATUS_OK and result on success or an error on failure

//

//  caveat:

//      on success (and only then) payload goes to the ownership of the msg

//      the ownership of the msg remains with the caller

PEP_STATUS decorate_message(

        message *msg,

        char *payload,

        size_t size

    );

// prepare_message() - prepare a sync message with payload

//

//  parameters:

//      me (in)         identity to use for the sender

//      partner (in)    identity to use for the receiver

//      payload (in)    payload to send

//      size (in)       size of payload

//      result (out)    message with payload

//

//  returns:

//      PEP_STATUS_OK and result on success or an error on failure

//

//  caveat:

//      on success (and only then) payload goes to the ownership of the result

//      the ownership of the result goes to the caller

PEP_STATUS prepare_message(

        const pEp_identity *me,

        const pEp_identity *partner,

        char *payload,

        size_t size,

        message **result

    );

#ifdef __cplusplus

}

#endif