app_callbacks.h

Go to the documentation of this file.

 
#ifndef APP_CALLBACKS_H
#define APP_CALLBACKS_H
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include <ascii-chat/crypto/crypto.h>
#include <ascii-chat/platform/socket.h>
typedef struct acip_transport acip_transport_t;
 
typedef struct {
  // Exit signals
  bool (*should_exit)(void);
  void (*signal_exit)(void);
 
  // Platform timing / wait helpers
  uint64_t (*platform_get_monotonic_time_us)(void);
  void (*platform_sleep_ms)(unsigned int ms);
  void (*platform_pump_events)(void);
 
  // Server/client crypto setup
  void (*server_connection_set_ip)(const char *ip);
  void (*server_connection_set_port)(int port);
  void (*client_crypto_set_mode)(uint8_t mode);
  int (*client_crypto_init)(void);
  int (*client_crypto_handshake)(acip_transport_t *transport);
  bool (*crypto_client_is_ready)(void);
  const crypto_context_t *(*crypto_client_get_context)(void);
 
  // Audio
  void (*audio_stop_thread)(void);
} app_callbacks_t;
 
void app_callbacks_register(const app_callbacks_t *callbacks);
 
const app_callbacks_t *app_callbacks_get(void);
 
/* ============================================================================
 * Convenience Macros for Safe Callback Invocation
 * ============================================================================ */
 
#define APP_CALLBACK_VOID(callback_name)                                                                               \
  do {                                                                                                                 \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    if (__cb && __cb->callback_name) {                                                                                 \
      __cb->callback_name();                                                                                           \
    }                                                                                                                  \
  } while (0)
 
#define APP_CALLBACK_BOOL(callback_name)                                                                               \
  ({                                                                                                                   \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    (__cb && __cb->callback_name) ? __cb->callback_name() : false;                                                     \
  })
 
#define APP_CALLBACK_INT(callback_name)                                                                                \
  ({                                                                                                                   \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    (__cb && __cb->callback_name) ? __cb->callback_name() : -1;                                                        \
  })
 
#define APP_CALLBACK_UINT64(callback_name)                                                                             \
  ({                                                                                                                   \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    (__cb && __cb->callback_name) ? __cb->callback_name() : 0ULL;                                                      \
  })
 
#define APP_CALLBACK_INT_TRANSPORT(callback_name, transport)                                                           \
  ({                                                                                                                   \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    (__cb && __cb->callback_name) ? __cb->callback_name(transport) : -1;                                                  \
  })
 
#define APP_CALLBACK_VOID_UINT8(callback_name, value)                                                                  \
  do {                                                                                                                 \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    if (__cb && __cb->callback_name) {                                                                                 \
      __cb->callback_name(value);                                                                                      \
    }                                                                                                                  \
  } while (0)
 
#define APP_CALLBACK_VOID_UINT(callback_name, value)                                                                   \
  do {                                                                                                                 \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    if (__cb && __cb->callback_name) {                                                                                 \
      __cb->callback_name(value);                                                                                      \
    }                                                                                                                  \
  } while (0)
 
#define APP_CALLBACK_VOID_STR(callback_name, value)                                                                    \
  do {                                                                                                                 \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    if (__cb && __cb->callback_name) {                                                                                 \
      __cb->callback_name(value);                                                                                      \
    }                                                                                                                  \
  } while (0)
 
#define APP_CALLBACK_VOID_INT(callback_name, value)                                                                    \
  do {                                                                                                                 \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    if (__cb && __cb->callback_name) {                                                                                 \
      __cb->callback_name(value);                                                                                      \
    }                                                                                                                  \
  } while (0)
 
#define APP_CALLBACK_PTR(callback_name)                                                                                \
  ({                                                                                                                   \
    const app_callbacks_t *__cb = app_callbacks_get();                                                                 \
    (__cb && __cb->callback_name) ? __cb->callback_name() : NULL;                                                      \
  })
 
#endif