chaser-cf 0.2.1

High-performance Cloudflare bypass library with stealth browser automation. Rust-native with C FFI bindings.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

#include <cstdarg>
#include <cstdint>
#include <cstdlib>
#include <ostream>
#include <new>

/// C-compatible configuration structure
struct ChaserConfigFFI {
  /// Maximum concurrent browser contexts
  uint32_t context_limit;
  /// Request timeout in milliseconds
  uint64_t timeout_ms;
  /// Profile: 0 = Windows, 1 = Linux, 2 = macOS
  uint32_t profile;
  /// Whether to defer browser init (0 = false, 1 = true)
  uint32_t lazy_init;
  /// Whether to run headless (0 = false, 1 = true)
  uint32_t headless;
  /// Chrome binary path (NULL for auto-detect)
  const char *chrome_path;
};

/// C-compatible proxy configuration
struct ProxyConfigFFI {
  /// Proxy host
  const char *host;
  /// Proxy port
  uint16_t port;
  /// Optional username (NULL if none)
  const char *username;
  /// Optional password (NULL if none)
  const char *password;
};

/// Callback type for async operations
///
/// # Parameters
/// - `result`: JSON-encoded result string (must be freed with `chaser_free_string`)
/// - `user_data`: The user_data pointer passed to the async function
using ChaserCallback = void(*)(const char *result, void *user_data);

extern "C" {

/// Get default configuration
ChaserConfigFFI chaser_config_default();

/// Initialize chaser-cf
///
/// # Parameters
/// - `config`: Configuration pointer (NULL for defaults)
///
/// # Returns
/// - 0 on success
/// - Non-zero error code on failure
///
/// # Safety
/// - `config` must be either NULL or a valid pointer to a `ChaserConfigFFI` struct
/// - If `config.chrome_path` is not NULL, it must be a valid null-terminated C string
int32_t chaser_init(const ChaserConfigFFI *config);

/// Shutdown chaser-cf and release resources
void chaser_shutdown();

/// Check if chaser-cf is initialized and ready
///
/// # Returns
/// - 1 if ready
/// - 0 if not ready
int32_t chaser_is_ready();

/// Solve WAF session asynchronously
///
/// # Parameters
/// - `url`: Target URL (null-terminated C string)
/// - `proxy`: Optional proxy config (NULL for no proxy)
/// - `user_data`: User context, returned in callback
/// - `callback`: Function called with JSON result
///
/// # Safety
/// - `url` must be a valid null-terminated C string
/// - `proxy` must be either NULL or a valid pointer to a `ProxyConfigFFI` struct
/// - `callback` must be a valid function pointer
void chaser_solve_waf_async(const char *url,
                            const ProxyConfigFFI *proxy,
                            void *user_data,
                            ChaserCallback callback);

/// Get page source asynchronously
///
/// # Parameters
/// - `url`: Target URL (null-terminated C string)
/// - `proxy`: Optional proxy config (NULL for no proxy)
/// - `user_data`: User context, returned in callback
/// - `callback`: Function called with JSON result
///
/// # Safety
/// - `url` must be a valid null-terminated C string
/// - `proxy` must be either NULL or a valid pointer to a `ProxyConfigFFI` struct
/// - `callback` must be a valid function pointer
void chaser_get_source_async(const char *url,
                             const ProxyConfigFFI *proxy,
                             void *user_data,
                             ChaserCallback callback);

/// Solve Turnstile (full page) asynchronously
///
/// # Parameters
/// - `url`: URL with Turnstile widget
/// - `proxy`: Optional proxy config (NULL for no proxy)
/// - `user_data`: User context, returned in callback
/// - `callback`: Function called with JSON result
///
/// # Safety
/// - `url` must be a valid null-terminated C string
/// - `proxy` must be either NULL or a valid pointer to a `ProxyConfigFFI` struct
/// - `callback` must be a valid function pointer
void chaser_solve_turnstile_async(const char *url,
                                  const ProxyConfigFFI *proxy,
                                  void *user_data,
                                  ChaserCallback callback);

/// Solve Turnstile (minimal page) asynchronously
///
/// # Parameters
/// - `url`: Origin URL for Turnstile
/// - `site_key`: Turnstile site key
/// - `proxy`: Optional proxy config (NULL for no proxy)
/// - `user_data`: User context, returned in callback
/// - `callback`: Function called with JSON result
///
/// # Safety
/// - `url` must be a valid null-terminated C string
/// - `site_key` must be a valid null-terminated C string
/// - `proxy` must be either NULL or a valid pointer to a `ProxyConfigFFI` struct
/// - `callback` must be a valid function pointer
void chaser_solve_turnstile_min_async(const char *url,
                                      const char *site_key,
                                      const ProxyConfigFFI *proxy,
                                      void *user_data,
                                      ChaserCallback callback);

/// Free a string returned by chaser-cf
///
/// Must be called on any string returned via callbacks.
///
/// # Safety
/// - `s` must be either NULL or a valid pointer previously returned by chaser-cf callbacks
/// - `s` must not be freed more than once
void chaser_free_string(char *s);

} // extern "C"