client_like.h

Go to the documentation of this file.

 
#pragma once
 
#include "session/capture.h"
#include "session/display.h"
#include "session/keyboard_handler.h"
#include "session/render.h"
#include <ascii-chat/asciichat_errno.h>
#include <stdbool.h>
 
typedef struct terminal_fd_reader_s terminal_fd_reader_t;
/* discovery_session is defined in src/discovery/session.h as an opaque type
   Discovery mode should include that header and cast to/from void * */
 
typedef enum session_client_like_kind {
  SESSION_CLIENT_LIKE_KIND_MIRROR = 0,
  SESSION_CLIENT_LIKE_KIND_CLIENT,
  SESSION_CLIENT_LIKE_KIND_DISCOVERY,
} session_client_like_kind_t;
 
/* ============================================================================
 * Callback Types
 * ============================================================================ */

typedef asciichat_error_t (*session_client_like_run_fn)(session_capture_ctx_t *capture, session_display_ctx_t *display,
                                                        void *user_data);
 
/* ============================================================================
 * Configuration Structure
 * ============================================================================ */

typedef struct session_client_like_config {
  /* ================================================================ */
  /* Required                                                           */
  /* ================================================================ */

  session_client_like_run_fn run_fn;

  asciichat_error_t (*prepare_fn)(void *user_data);

  void *run_user_data;
 
  /* ================================================================ */
  /* Networking (NULL for mirror mode)                                  */
  /* ================================================================ */

  session_client_like_kind_t kind;

  void *discovery;
 
  /* ================================================================ */
  /* Exit Condition                                                     */
  /* ================================================================ */

  bool (*custom_should_exit)(void *user_data);

  void *exit_user_data;
 
  /* ================================================================ */
  /* Reconnection Logic (for client/discovery retry loops)             */
  /* ================================================================ */

  int max_reconnect_attempts;

  bool (*should_reconnect_callback)(asciichat_error_t last_error, int attempt_number, void *user_data);

  void *reconnect_user_data;

  unsigned int reconnect_delay_ms;
 
  /* ================================================================ */
  /* Keyboard Handler                                                   */
  /* ================================================================ */

  session_keyboard_handler_fn keyboard_handler;
 
  /* ================================================================ */
  /* Terminal Behavior                                                  */
  /* ================================================================ */

  bool print_newline_on_tty_exit;
} session_client_like_config_t;
 
/* ============================================================================
 * Entry Point
 * ============================================================================ */
bool (*session_client_like_get_render_should_exit(void))(void *);

terminal_fd_reader_t *session_client_like_get_stdin_reader(void);

asciichat_error_t session_client_like_run(const session_client_like_config_t *config);