bun-types 1.1.28-canary.20240917T140517 → 1.1.28-canary.20240919T140511

package/ffi.d.ts

@@ -337,6 +337,9 @@ declare module "bun:ffi" {
 		 */
 		u64_fast = 16,
 		function = 17,
+
+		napi_env = 18,
+		napi_value = 19,
 	}
 
 	type Pointer = number & { __pointer__: null };
@@ -372,6 +375,8 @@ declare module "bun:ffi" {
 		[FFIType.i64_fast]: number | bigint;
 		[FFIType.u64_fast]: number | bigint;
 		[FFIType.function]: Pointer | JSCallback; // cannot be null
+		[FFIType.napi_env]: unknown;
+		[FFIType.napi_value]: unknown;
 	}
 	interface FFITypeToReturnsType {
 		[FFIType.char]: number;
@@ -404,6 +409,8 @@ declare module "bun:ffi" {
 		[FFIType.i64_fast]: number | bigint;
 		[FFIType.u64_fast]: number | bigint;
 		[FFIType.function]: Pointer | null;
+		[FFIType.napi_env]: unknown;
+		[FFIType.napi_value]: unknown;
 	}
 	interface FFITypeStringToType {
 		["char"]: FFIType.char;
@@ -436,6 +443,8 @@ declare module "bun:ffi" {
 		["function"]: FFIType.pointer; // for now
 		["usize"]: FFIType.uint64_t; // for now
 		["callback"]: FFIType.pointer; // for now
+		["napi_env"]: never;
+		["napi_value"]: unknown;
 	}
 
 	type FFITypeOrString = FFIType | keyof FFITypeStringToType;
@@ -659,6 +668,54 @@ declare module "bun:ffi" {
 		 * Map of symbols to load where the key is the symbol name and the value is the {@link FFIFunction}
 		 */
 		symbols: Fns;
+
+		/**
+		 * Map of symbols to define where the key is the symbol name and the value is the symbol value
+		 *
+		 * Equivalent to `-D` option in gcc/clang.
+		 *
+		 * @example
+		 * ```js
+		 * import { cc } from "bun:ffi";
+		 * const {symbols: {hello}} = cc({
+		 *   source: hello,
+		 *   define: {
+		 *     "NDEBUG": "1",
+		 *   },
+		 *   symbols: {
+		 *     hello: {
+		 *       returns: "cstring",
+		 *       args: [],
+		 *     },
+		 *   },
+		 * });
+		 * ```
+		 */
+		define?: Record<string, string>;
+
+		/**
+		 * Flags to pass to the compiler. Note: we do not make gurantees about which specific version of the compiler is used.
+		 *
+		 * @default "-std=c11 -Wl,--export-all-symbols -g -O2"
+		 *
+		 * This is useful for passing macOS frameworks to link against. Or if there are other options you want to pass to the compiler.
+		 *
+		 * @example
+		 * ```js
+		 * import { cc } from "bun:ffi";
+		 * const {symbols: {hello}} = cc({
+		 *   source: hello,
+		 *   flags: ["-framework CoreFoundation", "-framework Security"],
+		 *   symbols: {
+		 *     hello: {
+		 *       returns: "cstring",
+		 *       args: [],
+		 *     },
+		 *   },
+		 * });
+		 * ```
+		 */
+		flags?: string | string[];
 	}): Library<Fns>;
 
 	/**

package/package.json

@@ -1,5 +1,5 @@
 {
-	"version": "1.1.28-canary.20240917T140517",
+	"version": "1.1.28-canary.20240919T140511",
 	"name": "bun-types",
 	"license": "MIT",
 	"main": "",