#ifndef LOKINET_H
#define LOKINET_H

#include <stdbool.h>
#include <stdint.h>
#include <unistd.h>

#ifdef __cplusplus
extern "C"
{
#endif

  struct lokinet_context;

  /// allocate a new lokinet context
  struct lokinet_context*
  lokinet_context_new();

  /// load a bootstrap RC from memory
  /// return 0 on success
  /// return non zero on fail
  int
  lokinet_add_bootstrap_rc(const char*, size_t, struct lokinet_context*);

  /// free a context allocated by lokinet_context_new
  void
  lokinet_context_free(struct lokinet_context*);

  /// spawn all the threads needed for operation and start running
  /// return 0 on success
  /// return non zero on fail
  int
  lokinet_context_start(struct lokinet_context*);

  /// stop all operations on this lokinet context
  void
  lokinet_context_stop(struct lokinet_context*);

  /// get default lokinet context
  /// not to be freed by lokinet_context_free
  struct lokinet_context*
  lokinet_default();

  /// get a free()-able null terminated string that holds our .loki address
  /// returns NULL if we dont have one right now
  char*
  lokinet_address(struct lokinet_context*);

  /// the result of a lokinet stream mapping attempt
#pragma pack(1)
  struct lokinet_stream_result
  {
    /// set to zero on success otherwise the error that happened
    /// use strerror(3) to get printable string of this error
    int error;

    /// the local ip address we mapped the remote endpoint to
    /// null terminated
    char local_address[256];
    /// the local port we mapped the remote endpoint to
    int local_port;
    /// the id of the stream we created
    int stream_id;
  };
#pragma pack()

  /// connect out to a remote endpoint
  /// remoteAddr is in the form of "name:port"
  /// localAddr is either NULL for any or in the form of "ip:port" to bind to an explicit address
  void
  lokinet_outbound_stream(
      struct lokinet_stream_result* result,
      const char* remoteAddr,
      const char* localAddr,
      struct lokinet_context* context);

  /// stream accept filter determines if we should accept a stream or not
  /// return 0 to accept
  /// return -1 to explicitly reject
  /// return -2 to silently drop
  typedef int (*lokinet_stream_filter)(const char* remote, uint16_t port, void*);

  /// set stream accepter filter
  /// passes user parameter into stream filter as void *
  /// returns stream id
  int
  lokinet_inbound_stream_filter(
      lokinet_stream_filter acceptFilter, void* user, struct lokinet_context* context);

  /// simple stream acceptor
  /// simple variant of lokinet_inbound_stream_filter that maps port to localhost:port
  int
  lokinet_inbound_stream(uint16_t port, struct lokinet_context* context);

  /// close a stream by id
  void
  lokinet_close_stream(int stream_id, struct lokinet_context* context);

#ifdef __cplusplus
}
#endif
#endif