rayforce-sys 1.0.0

Raw FFI bindings to the RayforceDB v2 core (librayforce)
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

/* bindgen entry point for rayforce-sys.
 *
 * Pulls in the public v2 API, then hand-declares the handful of internal
 * core symbols the safe crate needs (all present in librayforce.a but not in
 * the public header — see PLAN.md). Signatures copied verbatim from the core
 * sources: src/lang/eval.h, src/lang/internal.h, src/store/serde.h. */

#include <rayforce.h>

#ifdef __cplusplus
extern "C" {
#endif

/* src/lang/eval.h — evaluate an already-compiled AST object */
ray_t* ray_eval(ray_t* obj);

/* src/lang/internal.h — query builtins (variadic arg-array form) */
ray_t* ray_update_fn(ray_t** args, int64_t n);
ray_t* ray_insert_fn(ray_t** args, int64_t n);
ray_t* ray_upsert_fn(ray_t** args, int64_t n);

/* src/lang/internal.h — CSV + on-disk table I/O */
ray_t* ray_read_csv_fn(ray_t** args, int64_t n);
ray_t* ray_write_csv_fn(ray_t** args, int64_t n);
ray_t* ray_set_splayed_fn(ray_t** args, int64_t n);
ray_t* ray_get_splayed_fn(ray_t** args, int64_t n);
ray_t* ray_get_parted_fn(ray_t** args, int64_t n);

/* src/ops/ops.h — materialize a lazy DAG result (no-op for non-lazy inputs;
 * consumes the lazy reference on success). RAY_LAZY (104) is the deferred type
 * returned by ray_eval and graph-aware builtins. */
ray_t* ray_lazy_materialize(ray_t* val);

/* src/store/serde.h — serialize / deserialize to a U8 vector with IPC header */
ray_t* ray_ser(ray_t* obj);
ray_t* ray_de(ray_t* bytes);

/* src/core/runtime.c — last per-VM error message (set alongside a RAY_ERROR) */
const char* ray_error_msg(void);

/* src/core/poll.h + runtime.h — the IPC client requires a poll object on the
 * runtime before connecting (ray_poll_t is opaque; use void*). */
void* ray_poll_create(void);
void* ray_runtime_get_poll(void);
void  ray_runtime_set_poll(void* poll);

#ifdef __cplusplus
}
#endif