bun-ffi

# Bun FFI Bun's FFI allows calling native C/C++ libraries from JavaScript. ## Quick Start ```typescript import { dlopen, suffix, FFIType } from "bun:ffi"; // Load library const lib = dlopen(`libc.${suffix}`, { printf: { args: [FFIType.cstring], returns: FFIType.int, }, }); // Call function lib.symbols.printf("Hello from C!\n"); ``` ## Loading Libraries ### Platform-Specific Paths ```typescript import { dlopen, suffix } from "bun:ffi"; // suffix is: "dylib" (macOS), "so" (Linux), "dll" (Windows) // System library const libc = dlopen(`libc.${suffix}`, { ... }); // Custom library const myLib = dlopen(`./libmylib.${suffix}`, { ... }); // Absolute path const sqlite = dlopen("/usr/lib/libsqlite3.so", { ... }); ``` ### Cross-Platform Loading ```typescript function getLibPath(name: string): string { const platform = process.platform; const paths = { darwin: `/usr/local/lib/lib${name}.dylib`, linux: `/usr/lib/lib${name}.so`, win32: `C:\\Windows\\System32\\${name}.dll`, }; return paths[platform] || paths.linux; } const lib = dlopen(getLibPath("mylib"), { ... }); ``` ## FFI Types ```typescript import { FFIType } from "bun:ffi"; const types = { // Integers i8: FFIType.i8, // int8_t i16: FFIType.i16, // int16_t i32: FFIType.i32, // int32_t / int i64: FFIType.i64, // int64_t / long long // Unsigned integers u8: FFIType.u8, // uint8_t u16: FFIType.u16, // uint16_t u32: FFIType.u32, //...